前言¶
用 DeepSeek Harness（DSH）和模型对话时，长回答里往往只有一两句或某一行代码需要拆开讲。常见做法是复制片段到主输入框再追问，或在同一条线程里继续聊——主对话会变长，原始回答也可能被后续消息「淹没」。dsh-dian-du（点读笔 / Reading Pen）是维护者 2404376192 发布的客户端类 DSH 插件：在 AI 回答里点选段落或代码行，在右侧 Sidebar 的「点读」标签里提问，解释只出现在右栏，左侧 transcript 不改动、不追加主会话消息。
这是什么¶
点读笔是面向 DSH Web/Desktop 客户端的 reading-pen 插件。一句话定位：点一下回答里的句子或代码行，在右侧独立栏让 AI 解释。仓库：github.com/2404376192/dsh-dian-du；社区目录页：skillhub.cn/plugins/2404376192/dsh-dian-du。许可 MIT；package.json 中版本为 0.1.0。
核心功能¶
下面介绍 README 中已写明的能力，均可在安装后自行验证。
点选范围
- 正文：点击段落、标题、列表项或引用即可选中。
- 代码块：点击具体一行，只选该行。
两种高亮
- 蓝色：当前选中。
- 琥珀色：曾经在此问过问题的痕迹（「查过 N 处」可统计并一键清空）。
右侧栏，不盖对话
- 选中后自动展开 DSH 右侧 Sidebar 的「点读」标签；主对话区域变窄，不被浮层遮挡。
- 右栏底部「我的提问」输入框回车发送；解释流式出现在同一栏。
- 轻按一次
Ctrl，或Ctrl+ 点击任意位置，可快速清空相关状态。
模型与主对话一致
- 解释请求走 Host 的
ctx.llm.stream，provider、model、reasoning effort 跟随当前对话，兜底 reasoning effort 为high。 - 浏览器端不接触 API key；解释不写进主对话会话日志。
环境与依赖¶
- DSH
>= 0.2.0-rc.1，且使用带 Web/Desktop 客户端的配置（插件注册右侧 Sidebar 标签与 Host 命令/dian-du）。 - 已配置可用的模型 provider（与主聊天相同的服务）。
安装与启用¶
按你使用的 profile 选一条命令执行；命令来自仓库 README，勿自行拼接其它 add 形式。
桌面端：
dsh plugin --profile desktop add github:2404376192/dsh-dian-du
CLI / web profile：
dsh plugin --profile web add github:2404376192/dsh-dian-du
安装后完全退出 DSH 再重新打开——客户端 bundle 仅在启动时扫描，热更新不会加载新插件。
验证：打开右侧 Sidebar，应出现「点读」标签；页脚会显示插件版本。
典型用法¶
- 在左侧对话里，点一下没看懂的句子，或代码块里的一行。
- 右栏「点读」展开，「已选内容」显示刚才的片段。
- 在「我的提问」里写问题，回车。
- 在右栏阅读解释；左侧原始回答保持不变。
注意：主界面底部的 composer 属于主对话，在那里发送的内容会在左侧得到回复。若希望解释始终只在右栏，请使用右栏输入框。
实现要点（便于排查）¶
| 部分 | 作用 |
|---|---|
client.js |
点选、高亮、右栏 UI；注册 sidebar.right.pane.tab，另有 shell.overlay 兜底 |
index.js |
Host：注册 /dian-du，调用 LLM |
| 调用链 | 面板 → ctx.remote.session.create（独立点读会话）→ ctx.remote.commands.execute('/dian-du …') → 右栏渲染 |
cordis.patch.yml |
bundle 补丁；可覆盖 provider、model、reasoningEffort |
已知限制¶
- 更新插件或改 client bundle 后，须完全重启 DSH。
- 痕迹与选中按「消息节点 + 位置」绑定；若该条回答被重新生成，旧痕迹无法挂到新内容上。
适用场景与安装前注意¶
适合：读长文回答、读生成代码时需要「就地」追问，又不想污染主线程的开发者或日常 DSH 用户。
DSH 生态是「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。插件以当前 DSH 进程权限运行，安装前建议浏览仓库源码与 MIT 许可证，确认符合你的安全与合规要求。目录页星标等元数据以社区页为准（当前为 0）。
链接¶
- 目录页：https://www.skillhub.cn/plugins/2404376192/dsh-dian-du
- GitHub：https://github.com/2404376192/dsh-dian-du
点读笔把「局部不懂」从主对话里拆到右侧栏，主 transcript 保持只读式阅读体验；装完记得完全重启 DSH 再在 Sidebar 里找「点读」即可上手。
