前言¶

在 DSH Web 里对助手回复做选区标注、按编号让模型逐条回应，已经是 dsh-annotation 一类插件的常见用法。标注多了之后，模型在回复里会写出 Annotation 1:、Annotation 2: 等标签；若只能悬停看摘要、不能一键回到对话里被标的那段原文，核对上下文就要反复滚动查找。维护者 HuaLQIn 在 upstream dsh-annotation（omdsh-dev，MIT）基础上 fork 了 dsh-annotation-jump（当前资料中的版本为 1.5.0，基线 upstream 1.4.11），在保留选区标注与编号回复流程的前提下，增加「点击回复中的 Annotation N 芯片 → 跳回对应段落、短暂高亮」的能力。下面介绍它是什么、能做什么，以及如何安装与使用时需要注意的点。

这是什么¶

dsh-annotation-jump 是 DSH 的客户端 bundle 插件：浏览器端注入 UI 与交互，Node 侧为空实现，不修改 DSH 核心文件。仓库：https://github.com/HuaLQIn/dsh-annotation-jump；社区目录页：https://www.skillhub.cn/plugins/HuaLQIn/dsh-annotation-jump（独立社区站点，与 DeepSeek / 幻方无官方从属关系）。

Fork 说明见仓库 README：本仓库不是原作者 omdsh-dev 背书的分支；与 upstream 共有的问题应到 upstream 反馈，仅与本 fork 1.5.0「芯片跳转」相关的 issue 可在本仓库提交。npm 包名仍沿用 @changfenhuang/dsh-annotation，目的是替换安装时不破坏既有依赖名；因此 dsh plugin add @changfenhuang/dsh-annotation 或 npm install @changfenhuang/dsh-annotation 安装的是 npm 上的 upstream 1.4.x，不会带上本 fork 的跳转能力。

核心功能¶

除 upstream 已有的选区标注能力外，资料中明确写明的 1.5.0 增量如下：

• 在助手回复里点击 Annotation N 芯片，可跳回对话中被标注的原文段落。
• 定位基于文本锚点，刷新页面后仍可恢复跳转关系。
• 跳转时使用平滑滚动，并对目标段落做短暂高亮；若找不到对应段落，会给出明确提示。

upstream 侧（本 fork 一并保留、README 已核实）的主要能力包括：

本 fork 在「回复芯片」之上增加了点击跳转 + 高亮；悬停查看摘要的行为仍保留。

安装与启用¶

本 fork 未发布到 npm，须从 Git 仓库安装。<your-profile> 取你实际运行的 profile：web 为浏览器构建，desktop 为桌面应用。

dsh plugin --profile <your-profile> add git+https://github.com/HuaLQIn/dsh-annotation-jump.git

安装后需按 DSH 文档重启 Web 服务（README 中「Restarting the web service」一节；资料截断处未展开具体命令，以仓库 README 为准）。

环境要求（来自 package.json / README）：

• Node.js 20 或更新
• 提供 cordis 4.x 的 DSH 构建（peerDependencies: ^4.0.0-rc.7 || ^4.0.1）

卸载（包名仍是 @changfenhuang/dsh-annotation）：

dsh plugin --profile <your-profile> remove @changfenhuang/dsh-annotation

卸载后同样需重启 Web 服务。标注状态保存在浏览器 localStorage、键名以 dsh.annotation. 开头；卸载不会自动清空，可在浏览器控制台手动删除这些键。

与 upstream 不可并存：因包名相同，本 fork 与 npm 上的 @changfenhuang/dsh-annotation 会互相覆盖，请勿同时安装两套。

若曾使用旧包名 @omdsh-dev/dsh-annotation，需先 remove 旧包；在本 fork 场景下第二步应使用上面的 git+https://… 安装命令，而不是 add @changfenhuang/dsh-annotation（后者会拉 upstream）。

典型用法¶

交互流程与 upstream 一致，跳转发生在模型回复之后：

1. 在助手回复中选中一段文字，点工具栏 Annotate，填写备注或留空保存。
2. 重复上述步骤可累积多条标注；输入框旁出现 Annotations ×N，悬停可查看或删除单条。
3. 在输入框写好问题后按 Enter：模型收到完整标注块（编号 + 段落 + 备注）与你的问题；你的消息气泡里只显示问题与芯片。
4. 模型按 Annotation 1: … Annotation N: 回复时，每条标签为芯片；在本 fork 中点击芯片即可跳回对话里对应被标段落并短暂高亮；找不到时会明确报错。

侧边栏文件场景：在已支持的工作区文件预览中选中文本，同样 annotate → Enter 发送；模型侧引用含路径，重载后打开原文件可恢复标记。

适用场景与注意¶

适合：需要在 DSH Web 里对长回复或多轮标注做结构化追问，并在模型按编号回答后快速回到原文核对的开发者或日常使用者；与工作区 Markdown / 代码片段标注一并使用时，路径会进入模型上下文。

务必注意：

• 插件以当前 DSH 进程及浏览器环境运行；安装前请自行查看仓库源码与 MIT 许可证（upstream 版权归属见 README / CREDITS.md）。
• 勿与 npm 版 @changfenhuang/dsh-annotation 混装；需要跳转能力时必须使用 README 中的 git 安装命令。
• 社区目录与 GitHub 星标等元数据会变动；撰写时 GitHub 显示 1 star，分类为客户端，以页面为准。

结尾¶

dsh-annotation-jump 在 dsh-annotation 的选区标注与编号回复流程上，补上「点回复芯片回跳原文」这一环，适合标注密集、需要对照原文读模型逐条回答的场景。安装与 issue 分流规则以 fork README 为准。

• 目录页：https://www.skillhub.cn/plugins/HuaLQIn/dsh-annotation-jump
• GitHub：https://github.com/HuaLQIn/dsh-annotation-jump