dsh-plugin-zotero 0.7.0 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **把 Zotero 文献库映射进 DSH:用AI管理操作Zotero,读文献时让AI辅助你。**
4
4
 
5
- 本插件把 Zotero 的目录分类、条目元数据、PDF 全文、笔记与标注接入 DSH,将「检索文献 — 精读全文 — 摘录标注 — 与模型讨论 — 形成稿子」收进同一条工作流:右侧栏按分类与标签浏览文库,按标题 / 摘要筛选当前范围,双击条目即在 DSH 内打开独立阅读页,PDF 整页渲染、高亮原位叠加,同一篇文献的原文与译本附件可在页内切换;读到关键段落时可直接划词摘录,或引用该条标注、笔记乃至整篇文献,以引用胶囊写进当前会话草稿,模型随即基于原文接续完成综述、方法对比、数据提取与引文核对。
5
+ 本插件把 Zotero 的目录分类、条目元数据、PDF 全文、笔记与标注接入 DSH,将「检索文献 — 精读全文 — 摘录标注 — 与模型讨论 — 形成稿子」收进同一条工作流:右侧栏按分类与标签浏览文库,按标题 / 摘要筛选当前范围,双击条目即在 DSH 内打开独立阅读页,PDF 整页渲染、高亮原位叠加,同一篇文献的原文与译本附件可在页内切换;读到关键段落时可直接划词摘录、划词翻译,公式图表这类没法划选的内容还能框一块正文截图,也可引用该条标注、笔记乃至整篇文献,以引用胶囊写进当前会话草稿,模型随即基于原文接续完成综述、方法对比、数据提取与引文核对。
6
6
 
7
7
  模型侧同样具备完整的检索与整理能力:检索文库、精读 PDF、汇总高亮与笔记、按主题新建分类并归类,也可以把本地下载的论文导入 Zotero,读完外文文献后把译文作为附件回挂到对应条目。凡 Zotero 本地接口与集成 MCP 能提供的操作,均可由模型代劳。
8
8
 
@@ -21,10 +21,10 @@
21
21
  它能替你做的事,举几个常见例子:
22
22
 
23
23
  - **找文献**:按标题、年份、全文关键词检索,也能跨库搜高亮和批注,快速回答「我收过哪些讲 XX 的文章」;右侧栏里还能按分类、标签和标题 / 摘要逐层缩小范围。
24
- - **读文献**:双击条目就在 DSH 内开独立阅读页,PDF 整页渲染、高亮原位叠加,原文与译本附件随时切换;摘要、全文、笔记与标注都能在这里读完,写综述、做对比、提取数据都行,需要精确引用时会保留原文措辞。开启写权限后,正文里划选即选颜色落一条高亮或下划线(跨页自动按页拆条)、随手带一句评论,改色、改评论、改页码、加标签、高亮↔划线互转、删除都在同一处;笔记也能新建、编辑、删除。改动直接进 Zotero 库,不是插件里的副本。
24
+ - **读文献**:双击条目就在 DSH 内开独立阅读页,PDF 整页渲染、高亮原位叠加,原文与译本附件随时切换;摘要、全文、笔记与标注都能在这里读完,写综述、做对比、提取数据都行,需要精确引用时会保留原文措辞。外文段落划选即弹出「翻译」浮层,原文 / 译文左右对照、默认按语种自动中英互译,可拖动缩放,也能临时换成模型精翻;左上角一枚目录按钮把 PDF 书签、网页快照标题、笔记标题统一收进同一份大纲。开启写权限后,正文里划选即选颜色落一条高亮或下划线(跨页自动按页拆条)、随手带一句评论,改色、改评论、改页码、加标签、高亮↔划线互转、删除都在同一处;笔记也能新建、编辑、删除。改动直接进 Zotero 库,不是插件里的副本。
25
25
  - **整理文库**:新建、重命名、移动、删除分类,批量把条目加入或移出分类。你说一句「把这几篇归到『待读』里」,它就照做。
26
26
  - **帮你入库**:把本地下载好的论文、PDF 交给 DSH 导入 Zotero;也可以让它读完外文文献后,把译文作为附件挂回条目。
27
- - **带进对话**:右侧面板单条目引用、列表多选批量引用、阅读页划词摘录与点高亮引用、单标签或多标签引用、整分类引用,一键写进当前会话草稿(不自动发送),你再接着说要求。全部都以「引用胶囊」的形式出现,草稿里一眼看清引了哪几篇 / 哪几段,单独删掉某一条也不影响其他内容;完整文本在发送那一刻才展开给模型。
27
+ - **带进对话**:右侧面板单条目引用、列表多选批量引用、阅读页划词摘录与点高亮引用、单标签或多标签引用、整分类引用、划词翻译与正文截图,都能一键写进当前会话草稿(不自动发送),你再接着说要求。独立笔记会自动改插笔记正文,不给模型一个只剩标题的空壳。全部以「引用胶囊」的形式出现,草稿里一眼看清引了哪几篇 / 哪几段,单独删掉某一条也不影响其他内容;完整文本在发送那一刻才展开给模型,发出去之后胶囊仍留在会话历史里,悬停可预览、点开可看全文。读到公式、图表、版式这类没法划选的内容时,用左上角的**「截图加入对话」按钮**框一块正文——微信式定格框选,一张图片附件与出处说明(文献身份、页码、章节、区域文字)作为同一条消息发出。
28
28
  - **安全可控**:写能力默认全关 —— 「设置 → Zotero文献库」里的「Zotero 写权限」不开启,面板就是纯只读,模型也看不到任何写工具。开启后写操作优先走集成 MCP(在 Zotero 进程内执行,不触发本地 API 授权弹窗),标注与笔记这两类 MCP 覆盖不到的才走本地 API,需要一次性点「始终允许」授权;模型侧每一项工具都能单独开关。
29
29
 
30
30
  面板布局与 Zotero 本体一致:顶部状态栏显示连接状态并提供刷新;左侧是分类树,树下是可拖高、可折叠的标签面板;右侧列表显示当前范围(分类 / 全库 / 标签筛选后)的条目。分类树与条目列表之间的分隔条可拖动,宽度按本机记住。列表里单击条目选中、`Ctrl` / `Cmd` 点选多选,双击才在右侧栏顶层单开一个标签页看详情。阅读页就开在会话旁边的标签里,边读边摘、边问边改,不必在 Zotero 与 AI 两个窗口之间来回切换。
@@ -97,7 +97,7 @@ Zotero → **设置** → **高级** → 勾选「**允许此计算机上的其
97
97
 
98
98
  ### 第 4 步:回到 DSH 确认已经连上
99
99
 
100
- 打开 DSH 的「**设置**」,点左侧列表里的「**Zotero文献库**」。这一页就是本插件的全部设置,从上到下三块:**Zotero 写权限**、**API 设置**、**MCP 设置**。
100
+ 打开 DSH 的「**设置**」,点左侧列表里的「**Zotero文献库**」。这一页就是本插件的全部设置,从上到下四块:**Zotero 写权限**、**API 设置**、**MCP 设置**(含下方的 MCP 工具清单)、**划词翻译**。
101
101
 
102
102
  - 正常情况**一个字都不用改**,默认值就是对的。每一项的含义见[设置项说明](#设置项说明设置--zotero文献库)。
103
103
  - 回到会话,打开右侧栏的「Zotero 文献库」:顶部状态栏显示连接状态,左边应该已经列出你在 Zotero 里的分类。看到分类树就说明整条链路通了。
@@ -170,6 +170,20 @@ Zotero → **设置** → **高级** → 勾选「**允许此计算机上的其
170
170
 
171
171
  <sub>上图为「MCP 设置」区块与下方的「MCP 工具」清单:共 25 个工具、已禁用 0 个,每行右侧的开关单独控制 AI 能不能使用该工具。</sub>
172
172
 
173
+ ### 划词翻译
174
+
175
+ 最后一块管「阅读页划选文字 → 译文浮层」。两项都是下拉,改完同样自动保存、立即生效。
176
+
177
+ | 界面上的名字 | 默认值 | 说人话 | 什么时候才需要改 |
178
+ |---|---|---|---|
179
+ | **默认翻译引擎** | `Bing 免费翻译(快)` | 免密钥、一般 1 秒内出结果,日常阅读够用 | 学术长句想要更顺的译文,换 `DeepSeek 模型精翻(占额度)`(走当前账号的 Flash 模型,1~3 秒、占额度);模型通道取不到时自动回落 Bing |
180
+ | **目标语言** | `自动(中→英 / 英→中)` | 按选区语种判向:中文原文译英文,英文及其它语种译中文简体 | 想固定译入某一门语言(简体 / 繁体中文、英、日、韩、法、德、俄) |
181
+
182
+ - 译文浮层标题栏**另有一枚引擎下拉**:换一次就用新引擎立刻重译当前选区,是本次会话的临时覆盖,不写回这里;浮层上的徽标显示本次**实际**用到的引擎(选了精翻却显示 Bing,说明已自动回落)。
183
+ - 单次翻译上限 4000 字,超限直接提示缩小选区,不静默截断;同一段文本重复翻译会命中进程内缓存。
184
+ - **隐私**:选中的文字会发给所选服务(Bing 即微软的翻译接口,DeepSeek 走你的账号模型)。涉密材料不要用划词翻译。
185
+ - <sub>对应配置字段名:`translateProvider`、`translateTarget`。</sub>
186
+
173
187
  ## 常见问题
174
188
 
175
189
  | 你看到的 | 大概率原因 | 怎么办 |
@@ -184,23 +198,32 @@ Zotero → **设置** → **高级** → 勾选「**允许此计算机上的其
184
198
  | 提示「Zotero 里这条已经变了」 | 你(或 AI)在 Zotero 里同时改了同一条 | 刷新后重试;插件宁可报错也不覆盖你的新改动 |
185
199
  | 草稿里的引用胶囊发送失败,说找不到来源 | 插件被禁用或卸载了,胶囊没人展开 | 重新启用插件,或把胶囊删掉再发 |
186
200
  | 改了设置好像没生效 | 自动保存失败(顶部有红字) | 按红字提示再改一次任意字段触发重试;仍失败就看是不是被更高优先级配置覆盖 |
201
+ | 译文浮层提示「翻译服务还没启动:请重启一次 DSH」 | 升级后宿主半(`lib/`)还是旧进程,路由表里没有翻译端点 | 完全退出并重开 DSH(**刷新页面没用**);重启前面板其余功能不受影响 |
202
+ | 设置里选了 DeepSeek,浮层徽标却显示 Bing | 模型通道不可用或调用失败,已自动回落 | 属正常降级;检查「设置 → 模型」里有没有可用通道,或直接在浮层标题栏换引擎重试 |
203
+ | 译文浮层提示「选区过长」 | 单次翻译上限 4000 字(与摘录同口径) | 缩小选区分段翻;整篇交给模型可改用条目引用 |
204
+ | 截图发送被拒,提示「当前模型不支持图片」 | 当前模型没有读图能力(如 `deepseek-v4-pro`) | 换成支持图片的模型(如 `deepseek-flash`)后重发 |
205
+ | 截图提示「会话正忙,图片未挂上」 | 草稿区正在发送 / 上传,暂时不接受新附件 | 等上一次发送结束再截一次 |
206
+ | 网页快照的「截图加入对话」一直灰着 | 正文还没渲染完、桥接脚本没加载,或组件版本过旧 | 等正文出来;提示补构建产物就重新 `pnpm build:client` 后**刷新页面**;只有提示「组件版本过旧」才需要重启 DSH |
207
+ | PDF 页面全白只剩彩色标注块,或网页快照没有高亮 | `client/` 里的运行期资产(PDF 字体 / 快照桥接脚本)丢了 | 重新执行 `pnpm build:client` 后刷新页面即可,**不用重启 DSH** |
187
208
 
188
209
  ## 特性
189
210
 
190
211
  - **右侧栏面板「Zotero 文献库」**:与 Zotero 本体同构——顶部状态栏(Zotero / 模型工具探活 + 刷新),左侧分类树与标签面板,右侧是当前范围的条目列表;条目独立成列。分类树与条目列表之间的分隔条可拖动,宽度按本机记住;**选中的分类与展开状态也按本机记住**,刷新页面或重开面板后回到上次的位置并重拉该目录的条目。
191
212
  - **分类筛选**:分类树顶部可按名称筛选目录(同 Zotero 左栏:只筛目录名,命中项与祖先保留、自动展开,不影响右侧条目搜索)。
192
- - **条目列表**:每行显示文献类型图标与作者 / 年份;读过的文献类型图标转为粉色、标题略淡,悬停补上类型名与最后阅读时间。单击选中、`Ctrl` / `Cmd` 点选多选,双击在右侧栏顶层开独立详情页,右键单行可直接插引用;头部搜索框针对当前范围(分类 / 全库 / 标签筛选后)按标题与摘要过滤,列表可分页「加载更多」,选中多条时右上角一次「引用 N」。
213
+ - **条目列表**:每行显示文献类型图标与作者 / 年份;读过的文献类型图标整体去饱和、淡化,标题同步略淡,悬停补上类型名与最后阅读时间。单击选中、`Ctrl` / `Cmd` 点选多选,双击在右侧栏顶层开独立详情页,右键单行可直接插引用;头部搜索框针对当前范围(分类 / 全库 / 标签筛选后)按标题与摘要过滤,列表可分页「加载更多」,选中多条时右上角一次「引用 N」。
193
214
  - **标签面板**:树下方独立面板,可拖高 / 折叠;标签按 Zotero 的换行胶囊排布并跟随当前目录:选中分类时只列该分类自身条目里出现过的标签(不含子目录,自动标签弱化显示),选中文库根时列出全库标签;可按名称筛选、多选,并切换「全部(AND)/ 任一(OR)」。筛选作用于当前选择的范围,列表头部会显示已选标签胶囊与「清除筛选」;切换目录会自动清除已选标签,避免旧筛选作用到新范围。已选标签可从摘要行合并成一枚「标签组」胶囊引用。
194
215
  - **条目详情独立成页**:双击条目在右侧栏顶层新开一个标签页,同一条目再次双击只回到已有页;详情页可同时开多个,切换标签页时各自的展开状态与滚动位置都保留(正文常驻挂载)。
195
- - **文档优先版面**:详情页整页显示文献本体——PDF 走 PDF.js 渲染(顶部工具栏缩放、页码、当前页在 Zotero 中打开),没有 PDF 时回退到 API 全文文本。左侧固定的 30px 工具栏不遮挡正文。选中正文即浮出划词工具条(复制 / 加入对话 / 新建标注),点正文里的高亮则弹出标注卡片(类型、原文、评论,以及「引用」与「在 Zotero 中打开」)。
216
+ - **文档优先版面**:详情页整页显示文献本体——PDF 走 PDF.js 渲染(顶部工具栏缩放、页码、当前页在 Zotero 中打开),网页快照与独立笔记按原样呈现,没有可用附件时回退到 API 全文文本;工具条中间恒显示**当前文献标题**(切到快照附件也不会变成 `Snapshot`)。左侧固定的 30px 工具栏不遮挡正文。选中正文即浮出划词工具条(复制 / 翻译 / 加入对话 / 新建标注),点正文里的高亮则弹出标注卡片(类型、原文、评论,以及「引用」与「在 Zotero 中打开」)。
196
217
  - **左上角信息面板**:点左上角 `i` 按钮弹出浮层,把文献信息 / 摘要 / 标注 / 笔记 / 附件 / 参考文献分块竖排,每块可单独折叠;点浮层外或按 `Esc` 关闭,点标注定位时自动关闭把焦点还给文档。
197
- - **文档目录**:`i` 左边的列表按钮展开 PDF 自带书签的大纲树,按层级缩进,点一条即跳到对应页(跳完自动收起);没有书签的 PDF 显示「这篇 PDF 没有目录」。Zotero 本地 API 与集成 MCP 都没有目录数据,这份大纲由插件从 PDF 文件里自己解析(上限 8 层 / 800 条)。
198
- - **笔记可读**:独立笔记(文库里的全局笔记)打开后正文直接占据文档区,跟普通条目一样阅读;子笔记在信息面板的「笔记」块里折叠呈现,正文保留 Zotero 的引用块、标注高亮、表格与外链图片。Host 侧已清洗脚本与事件属性,避免注入。「引用」把该条笔记作为一枚胶囊写进会话草稿,发送时展开成完整纯文本。
218
+ - **统一文档目录**:`i` 左边的列表按钮是**唯一一份**大纲,PDF 书签、网页快照的 h1–h6 标题、笔记与 Markdown 里的标题都收在这里,标题下方一行小字说明当前来源;按层级缩进,点一条即跳转(PDF 跳页、其余滚到锚点),**浮层不会关闭**,可以连着点几条反复导航,没有大纲时按钮置灰。Zotero 本地 API 与集成 MCP 都没有目录数据,这份大纲由插件自己解析(上限 8 层 / 800 条)。
219
+ - **笔记可读**:独立笔记(文库里的全局笔记)打开后正文直接占据文档区,跟普通条目一样阅读;子笔记在信息面板的「笔记」块里折叠呈现,正文保留 Zotero 的引用块、标注高亮、表格与外链图片。Host 侧已清洗脚本与事件属性,避免注入。「加入对话」把该条笔记作为一枚胶囊写进会话草稿,发送时展开成完整纯文本;打开的条目本身就是独立笔记时,左上角那枚「加入对话」直接插整篇正文(列表单行与批量插入同样按笔记正文分派),不会给模型一个只剩标题的空壳。
199
220
  - **标注可读**:PDF 上的高亮与划线原位叠加在页面上,点页内标注弹出卡片,可当场「引用」或跳回 Zotero 对应页;「标注」块按类型 / 颜色筛选,点条目可跨附件定位、滚动并闪烁,「引用」把该条标注作为胶囊写进会话草稿。
200
- - **多种插入方式**:单条目、列表多选批量、单标签、多标签(合并成一枚「标签组」胶囊,AND/OR 在插入那一刻定格)、整目录、全文划词摘录、单条标注与单条笔记**全部**以「引用胶囊」写进草稿——胶囊只显示短标签,发送那一刻才展开成完整引用文本,模型拿到的内容与以前一致。所有方式都只写进会话草稿(不自动发送、不抢焦点),文本携带 `itemKey` / `collectionKey` / 标签名供模型接续操作。标签类引用始终按全库范围展开,不受你当时选中哪个分类影响;摘录胶囊把 `itemKey`、标题与原文一起定格在胶囊里,重开 DSH 后仍可展开,发送时不依赖 Zotero 在线(单段上限 4000 字)。
221
+ - **划词翻译**:PDF、网页快照、纯文本与笔记正文里划选文字,浮条上「复制」与「加入对话」之间多点一下「翻译」,选区旁弹出可拖动、可缩放的译文浮层——左右双栏「原文 / 译文」对照,中间一条实色竖分割线,右栏标出实际译入语言。默认自动判向(中文原文→英文,其余→中文简体),目标语言也可在设置里固定;引擎两档:Bing 免密钥(默认)或走当前账号的 DeepSeek 精翻(占额度,模型不可用时自动回落 Bing)。设置页定默认引擎,浮层标题栏的下拉是本次会话的临时覆盖,换一次立刻重译。单次上限 4000 字,浮层里的「加入对话」插一枚 `翻译:` 胶囊,提交时展开成「原文 + 译文」。
222
+ - **多种插入方式**:单条目、列表多选批量、单标签、多标签(合并成一枚「标签组」胶囊,AND/OR 在插入那一刻定格)、整目录、全文划词摘录、单条标注、单条笔记、划词翻译与正文截图**全部**以「引用胶囊」写进草稿——胶囊只显示短标签,发送那一刻才展开成完整引用文本,模型拿到的内容与以前一致;发出去之后,会话历史里仍是一枚胶囊,悬停即可预览完整引用,点击胶囊还能打开完整面板。所有方式都只写进会话草稿(不自动发送、不抢焦点),文本携带 `itemKey` / `collectionKey` / 标签名供模型接续操作。标签类引用始终按全库范围展开,不受你当时选中哪个分类影响;摘录 / 翻译 / 截图这几类胶囊把 `itemKey`、标题与内容一起自包含地定格在编码里,重开 DSH 后仍可展开,发送时不依赖 Zotero 在线(摘录单段上限 4000 字,自包含胶囊按编码后 8000 字节夹取)。**独立笔记**(`itemType = note`)无论从列表、批量还是阅读页插入,都按条目类型自动改走笔记正文引用——笔记没有作者 / 年份 / 刊物,走单条目引用只会给模型一个标题壳。
223
+ - **正文截图加入对话**:详情左上角「加入对话」右边那枚「截图加入对话」文字按钮,点一下正文定格压暗,拖框圈出区域,只有「取消 / 加入对话」两枚按钮(`Esc` 等同取消,小于 12×12 的误点不算数)。范围固定是正文显示区,不含工具条与浮层;PDF 直接取 pdf.js 页面位图(可跨页),纯文本、独立笔记与网页快照按当前可见区重绘。插入后是**一张图片附件 + 一枚 `截图:` 胶囊**的同一条消息:图片底部烙一条以「**Zotero 截图**」开头的水印(`《标题》 · P3-4 · 章节`),即使图片被单独转发也不丢出处;提交给模型的文本含文献身份(作者 · 年份 · 刊物 · DOI,网页类条目退化为「类型 · 站点域名」)、起止页码(仅 PDF,其余整行省略)、最近章节与框选区域的文字摘要,并注明「以图片为准,文本只用于定位」。网页快照由快照内的桥接脚本回传整页交给面板重绘,中文、表格、内联图片都能还原,滚到哪儿截哪儿;正文未渲染完或桥接脚本没就绪时按钮置灰并给出原因。输出 PNG(单张 50 MB、单会话最多 20 张),**当前模型需支持读图**(`deepseek-flash` 可以,`deepseek-v4-pro` 发送时会被拒)。
201
224
  - **胶囊依赖本插件展开**:草稿里留着引用胶囊时禁用或卸载本插件,发送会失败并提示找不到引用来源,把胶囊删掉即可继续正常发送。
202
225
  - **分类只读**:不提供任何新建 / 改名 / 删除分类的按钮——整理分类是模型的活,人在面板里只管浏览与引用。
203
- - **标注与笔记可写(默认关)**:在「设置 → Zotero文献库」打开「Zotero 写权限」并授权后,阅读页划选即写高亮 / 下划线(Zotero 色板七色 + 评论一次点明),点页内高亮弹出的标注卡片可当场「添加评论 / 改评论」,「标注」块还支持改色、改页码、加标签、高亮↔划线、删除,「笔记」块支持新建 / 编辑 / 删除。所有写入都直接进 Zotero 本地库,插件不存副本;含 Zotero 引文或标注锚点的笔记只给删除、不给编辑,改正文会让锚点失联。删除是**硬删**,不进 Zotero 回收站,面板里要点两次才会真删。开关关着时上述入口一个都不出现。
226
+ - **标注与笔记可写(默认关)**:在「设置 → Zotero文献库」打开「Zotero 写权限」并授权后,阅读页划选即写高亮 / 下划线(Zotero 色板七色 + 评论一次点明),点页内高亮弹出的标注卡片可当场「添加评论 / 改评论」,「标注」块还支持改色、改页码、加标签、高亮↔划线、删除,「笔记」块支持新建 / 编辑 / 删除。所有写入都直接进 Zotero 本地库,插件不存副本;所有笔记都能编辑(编辑框里是 Zotero 存的那份原始 HTML),含 Zotero 引文或标注锚点的笔记只多一句橙色提醒:改文字没事,别动 `data-citation` / `data-annotation` 属性。删除是**硬删**,不进 Zotero 回收站,面板里要点两次才会真删。开关关着时上述入口一个都不出现。
204
227
  - **模型侧工具可逐个开关**:插件自持连接集成 MCP,把工具以 `mcp__zotero__*` 注册进 dsh,可在「设置 → Zotero文献库 → MCP 工具」里逐项启用 / 禁用。
205
228
 
206
229
  ---
@@ -269,6 +292,7 @@ src/ # 插件源码(主包,ESM / NodeNext / strict)
269
292
  ├── InfoPanel.tsx # 左上角悬浮信息面板(可分块折叠)
270
293
  ├── OutlinePanel.tsx # 左上角目录浮层(PDF 书签,点条目跳页)
271
294
  ├── viewer/ # 渲染器注册表 + PDF.js 渲染 / 文本回退 / 标注叠加与几何换算
295
+ ├── viewer/shot/ # 截图加入对话:状态机 / 定格遮罩 / 裁切水印 / PDF、DOM、iframe 三种采集适配器
272
296
  ├── AnnotationList.tsx / NoteList.tsx # 标注与笔记列表
273
297
  ├── Toast.tsx # 插入结果等轻提示
274
298
  ├── reference.ts / cite.ts # 引用胶囊的 ref 编码与提交时的文本展开