Paper Glossary 是一个用于从既有论文来源清单构建共享 Obsidian 术语表笔记的技能。它的输入边界明确：基于 *_source_manifest.json 运行，--source-manifest 始终为必填；--raw-sections 仅用于以显式的 *_raw_sections.jsonl 覆盖清单的 raw_sections_path。该技能不会运行或修改论文阅读工作流，清单文件与原始章节文件是其唯一的论文内容边界，相关 JSON 与 CLI 约定见 references/file-contract.md。
使用方式（预览并等待，默认）
首次在某人/某设备上使用时展示已保存的配置。若配置不存在，则询问一个位于 Obsidian 库内的术语目录并完成配置，之后复用有效配置。设置过程可能创建 ~/.paper-glossary/config.json。
当请求文章链接时，必须提供显式的文章 Markdown 路径。需要校验该路径与配置的术语目录位于同一 Obsidian 库中；绝不推断文章路径。
从有效正文运行确定性提案。
执行恰好一次有依据的宿主语义评审，受 shortlist_limit 约束。该评审只能删除或重排候选，且必须保留每个被保留提案候选的确切术语字符串。
使用 plan_glossary.py --review-proposal PROPOSAL --reviewed-terms NAMES 记录评审后的候选清单；这会针对当前论文来源校验已保存的提案，并保留每个完整候选、其有序 surface_forms 与来源信息。若评审产生空的已评审候选清单，则报告 no_candidates 并停止，不展示选择器。
将评审后产物中的每个被保留术语以编号 Markdown 列表形式呈现。这是终端、Codex 与 Claude Code 的交互方式。需展示解析后的术语目录、文章 Markdown 路径（或未请求路径的说明），并说明选择将授权术语表写入/补全，以及在提供了文章时建立首次安全出现的文章链接。
需声明：在选择之前没有写入任何术语表笔记或文章 Markdown。结束响应并等待。预览期间不进行分诊、盘点、生成、链接或 lint。宽泛请求、清单、原始章节路径或文章路径均不构成选择批准。仅当宿主原生选择器能在一次交互中显示完整同一列表时才允许使用。
选择之后
仅接受紧接着的上一个编号列表中的编号、确切术语名或“全部写入”。在调用脚本前将其解析为显示的确切术语字符串；“全部写入”仅适用于该列表。无效选择会收到有效范围并再次等待。分诊需要同时提供 --reviewed-shortlist REVIEW 与解析后的确切名称传入 --terms；绝不单独使用 --terms，也不添加别名语法。
将当前 --source-manifest、可选的 --raw-sections 与已保存的 --reviewed-shortlist 传给 inventory、writer 与 linker。inventory 以保存的 --triage 产物作为其选定术语输入；writer 与 linker 也必须接收同一份已保存的 --triage。在任何术语表或文章写入之前，它们要求确切有序的术语与 surface_forms 与这一独立授权完全一致。
对选择进行分诊；其选择身份绑定每个确切选定名称与有序的、以论文为依据的形式。
从该分诊产物运行库盘点；它会重新计算完整的 提案/评审/选择 来源链，并在论文、来源、候选清单或形式不匹配时以失败关闭。
随后生成一个动作感知批次。
对配置的术语表目录运行一次 writer 调用；它会重新校验同一条来源链，并要求其有序盘点结果与已授权分诊完全匹配，然后执行整批预检，接着执行 创建/补全/复用 提交。writer 解析设备本地配置（或该设备的显式 --config-path），不接受独立的写入目标。使用 --article 时，其反向链接由解析后的文章 Markdown 词干派生；不使用文章时，仅术语表反向链接来自已校验清单的 paper_id。成功产物保留 triage_sha256、来源信息、文章上下文、有序映射及其确定性 mappings_sha256；映射摘要绑定分诊身份。
仅在提供了/请求了文章 Markdown 时，将每个成功的 writer 结果链接到其首次安全出现处。linker 会针对同一当前来源/评审校验 writer 的来源信息、上下文、摘要、笔记路径、词干与形式，并拒绝没有绑定文章路径的产物。对于仅术语表请求，跳过 link_glossary_terms.py。
对 writer 返回的、动作为 创建、补全或更新 的已变更术语表笔记文件，在一次 lint_glossary.py 调用中进行 lint，使用重复的 --input PATH 参数。不要将文章 Markdown 传给 lint_glossary.py。
报告可观察的挂钟时间与状态。宿主专属阶段单独计时。每个 CLI 会为其自身完整调用输出顶层 elapsed_ms。单次 writer 调用包含整批预检与提交。不要分别报告预检与提交的计时。
新条目会被创建；existing_thin 条目仅接收缺失的结构化字段与一个缺失的出现；existing_complete 条目仅可接收一个缺失的出现。不要覆盖现有笔记内容。existing_thin、条目操作、writer 形式与链接状态见 references/file-contract.md。
依据规则（Grounding）
anchor_only：简洁的论文用法加简要通用解释。
needs_explanation：带标签的背景解释，附置信度与论文出现。
排除仅作为参考文献的出现作为证据。论文事实保留在 occurrence 中，外部知识需标注。