更新日志（0.1.1）

0.1.1 相对 0.1.0 的变化见下。0.1.0 的基本功能（写作、文献库、阅读与笔记、导出成稿等）都还在。测试期间，升级后可能需要重新建立文献库，升级前请先用设置「高级」页的「导出文献库备份」留一份。

这一版的改动#

数据更可靠

• 关窗与草稿不丢字。 关闭窗口、关闭文献库标签、切换工作区时，只有最后一份草稿确实存上了才放行；收尾存盘不会再被 10 秒的强制关闭抢先。已经被永久删除的笔记如果还有未保存的草稿，可以另存为一条新笔记，选「取消」时草稿真的留着。关闭阅读器前会先把还没写入的批注保存完。
• 撤销不会误删别处新加的内容。 撤销一次新建或导入时，如果那条文献、笔记或附件底下后来又挂上了别的笔记、附件或批注，整笔撤销会被判为过期而拒绝，不会连带删掉它们。撤销删除时也在写库的同一个事务里重新核对一遍。
• 导出文献库备份的数据库和附件取自同一时刻。 备份里的数据库副本与附件文件不再可能一个新一个旧。
• 同步追平与历史还原。 本机落后于保留期起点时，附件按文件版本做三方比较追平，不会拿本机冻结的旧文件盖掉远端的新版；保留期起点之前的旧版本，按那一刻的状态还原。
• 文献库里的几处判断。 判重时 ISBN 只对图书起作用；「最近阅读」里可以只清除所选附件自己的阅读时间；全库的自动标签入口按文献、笔记、附件、批注四种分别判断是否存在；全文索引还没准备好时，已保存搜索的右键菜单照常出现；把带颜色的标签改名成已有的带颜色标签时，保留已有标签的颜色。
• 样式与全文查找。 安装样式遇到同名文件已被别的样式占用时，换一个文件名，不再覆盖别人的文件；「查找全文」的自动查找与手动查找各用各的请求和取消状态，互不影响。

新功能

• 批注摘录进 Markdown。 把阅读器里的文字批注粘贴或拖进正文，写成原文加一个引用标记，一次操作、一次撤销。图像批注和墨迹批注的图片存进工作区，正文里写 ![[图片]] 加引用标记。从文献表拖笔记进正文时，整条笔记转成 Markdown，笔记里的引用换成引用标记，嵌入的图片存进工作区。
• 改名、移动后更新内部链接。 在文件列表里改名或移动文件之后，正文里指向它的内部链接随之更新。设置里有「始终更新内部链接」和「新链接格式」，没有勾选时会询问；属性（frontmatter）里整个值就是一条链接的也会更新。新增「使用 Wikilinks」开关，关闭后，输入 [[ 补全写出的是 Markdown 链接。
• 粘贴和拖入图片与文件。 在 Markdown 编辑器里粘贴或拖入图片和文件，会存进工作区并写出链接；新增设置「附件默认存放路径」。拖入文件夹不会被导入，会有提示说明。
• 从文献库拖入正文。 可以把文献、笔记、附件从文献库拖进 Markdown 正文；同时拖含文件的附件与文献、笔记时一并写出。
• 编辑器显示设置。 正文宽度（默认、较宽、全宽、自定义）、字体大小（滑块）、正文字体、等宽字体、界面字体（照 Obsidian 的做法列出本机字体，可拖动排序，本机没有的字体会标出）、行距、段间距。段间距只改实时预览里普通段落之间的空行。另有「快速调整字体大小」（Ctrl 加滚轮或双指捏合，默认关闭）。界面字体同样作用于确认窗、通知、浏览窗口工具栏、说明页、阅读器页和笔记编辑器页。
• 阅读器。 工作区里不在文献库的 PDF 和 EPUB，说明行里有「添加到文献库」，添加后接着打开库内的那份附件；独立窗口里的阅读器「添加到文献库」之后，这扇窗口换成库内附件，位置和大小不变。
• 检索元数据认不出时。 进度窗里该行末尾给出「创建上级条目…」按钮，可按标识符检索或手动录入。
• 启动时打开文献库窗口。 新增设置，三个选项：跟上次一样（默认）、总是打开、从不打开。上次把文献库收进写作窗口当标签的，启动时不再另外开一扇文献库窗口。
• 设置入口与同步页。 写作窗口左侧栏和文献库左栏的最底下各有一颗齿轮按钮，点它打开设置。同步单独成页，排在「账户」之后，「账户」页只留登录和一行同步状态；同步页分成状态、这台设备、安全、存储与历史几组，最后是可折叠的高级项，维护项收成可折叠的节，并按状态自动展开。
• 用户中心。 最后一个管理员不能在用户中心注销自己，页面会提示先另设管理员。

界面与动效

• 展开和收起有了过渡。 右栏各节、同步页各节、文档首选项的高级选项展开收起时有平滑过渡；通知卡离开时后面的卡平滑补位；引注对话框有小过渡。设置里的「动态效果」选项（开、关、跟随系统）和系统的「减弱动态效果」都会生效，运行中改变也会立刻跟上，阅读器和笔记编辑器页也一样。
• 对话框与确认窗。 确认窗、通知、浏览窗口工具栏、说明页、阅读器页和笔记编辑器页都认「动态效果」选项，也使用设置里选的界面字体。
• 设置窗的间距。 页尾的帮助按钮前不再有横线，行、组标题、高级折叠节的纵向间距统一；同步页「这台设备」标题到下一行字的距离不再多出一截，表格、横幅、按钮行之后的下一个组标题离线不小于 23.1 像素。
• 明暗切换挪到左下角。 明暗切换按钮现在在左侧栏底行、齿轮按钮的左边；顶行右端只剩标签列表、打开文献库和右栏开关，标签区宽出一格。
• 顶行按钮整理。 顶行按钮的 Tab 次序与它们从左到右的排列次序一致。

修正

• 高级搜索。 新建条件时不再列「批注作者」（个人文献库里批注没有创建者，选不出人）；已经写着该条件的已保存搜索照旧显示，可以编辑。
• 字体列表读不到。 选择字体时有时读不到本机字体列表，现在权限检查与请求按同一套判断，空列表不再缓存。
• 恢复码提示。 同步空间已经建好、恢复码尚未确认保存时，横幅不再提「取消创建」。
• Word 成稿里的 HTML。 原文里直接写的 HTML（上下标、换行、链接、表格、列表、标题等）转成成稿里对应的内容；转不了的会写进导出完成的提示。
• callout 里的图片与嵌入。 callout 整块里的图片，拖动缩放和点击嵌入都能正确写回 Markdown。
• 行内代码。 行内代码渲染出来的文字，首尾各去一个空格、换行换成空格，与 Obsidian 1.14.4 一致，成稿也一样。
• 阅读器标签重启后恢复。 关闭应用时开着的阅读器标签会记进布局，下次启动恢复，对应附件已不存在的不恢复。
• 样式预览与样式编辑器。 样式预览窗改用 citeproc 的 HTML 输出，斜体等格式能显示出来；样式编辑器在关窗和换样式之前，如果有未保存的改动会先询问。

使用须知#

• Word 里的公式。 转换器能处理的公式写成可编辑的 Word 公式，超出支持范围或转换失败的保留为图片；导出完成的提示里报两种各有几个。
• 检索元数据依据 PDF 前几页上印的 DOI 或 arXiv 号。 前几页没有印这两种编号的 PDF（旧文献的扫描件、图书、学位论文、多数中文稿件）认不出来，可以用「创建上级条目…」手动建立。
• 按 ISBN 检索时，中文书和韩文书往往查不到。 查不到时请手工录入。
• 联网服务。 撤稿名单、样式与翻译器更新会请求 Zotero 的服务（撤稿检查发送 DOI 哈希值的前几位与 PMID 的前几位，更新检查发送已装样式的清单）；开放获取全文默认问 OpenAlex。发送的内容见官网的隐私说明。
• 加密的 PDF 不显示预览。

安装与放行#

1. 下载 zip 后，先用访达双击解压（或 ditto -x -k CiteDesk-0.1.1-internal-darwin-arm64.zip 目标目录），再双击 CiteDesk.app 打开。
2. 第一次打开时，macOS 可能提示无法验证开发者并拦下应用，三种办法任选一种放行：
   • 系统设置 →「隐私与安全性」→ 滚到「安全性」，点 CiteDesk 那一行的「仍要打开」；
   • 在访达里右键（或按住 Control 点）CiteDesk.app →「打开」→ 再点「打开」；
   • 命令行：xattr -dr com.apple.quarantine /path/to/CiteDesk.app。
3. 数据放在 ~/Library/Application Support/ 下；准确位置在设置 →「高级」，「帮助」菜单里有「打开数据文件夹」。