前言¶

在 DeepSeek Harness（DSH）对话中，AI 输出常包含大量术语或难以理解的段落。通常的建议是“直接问模型”，但这要求用户先知道要问什么，且答案往往再次使用相同的行话。

该插件移除了这个中间步骤：选择困惑的文本，点击一次，即可在阅读位置获得通俗解释。 无需提示工程，无需切换标签页，无需 API Key。

安装¶

使用官方命令安装插件：

dsh plugin --profile web add github:HEArtattaCK2332/dsh-text-explain

安装后，重启 Web 配置文件以加载新插件层。

核心功能¶

• 语境感知：选择文本时，插件会抓取该段落所属的整条消息作为上下文。例如，模型能通过看到上下文理解代词“它”的具体指代。
• 讲给谁听：提供 Plain（通俗）、General（通用）、Pro（专业）三档解释深度。切换深度会立即重新解释当前问题，从生活化类比转变为专业术语。
• 新建为对话：点击“✦ 新建为对话”后，插件会将选中文本、原消息上下文及当前对话历史打包成交接文档，放入新会话。新会话会回复“背景已了解，等你开口”，不再生成摘要或追问。
• Markdown 渲染：支持渲染表格、链接、引用、代码块等，基于 React 手写渲染器，自带 XSS 防护。
• 联网与本地读取：提供“🌐 联网”与“📄 读文件”开关，允许模型调用 web_search、web_fetch、search_files 或 read_file 获取外部信息或读取本地文档。

使用步骤¶

1. 在任意对话消息中选择文本。弹出菜单会自动携带整条消息作为上下文。
2. 点击 AI 解释 获取解释，或点击 追问 对选定内容提问。
3. 阅读流式输出的回答。输入后续问题按回车继续当前线程；点击 ✕ 关闭窗口。
4. 在弹出菜单底部切换 讲给谁听 的深度，这会立即重新解释当前问题。
5. 在提问前，根据需要开启 🌐 联网 或 📄 读文件 开关。
6. 当对话值得继续时，点击 ✦ 新建为对话，将当前讨论转移至新会话。

设置与配置¶

• 配置文件位置：插件设置位于 <DSH_HOME>/text-explain/settings.json（默认 ~/.dsh）。
• 保存机制：设置页面的点击仅编辑草稿，必须点击 保存 才会将配置写入磁盘。未保存的修改不会生效。
• 默认设置：可在设置页配置默认解释深度、新对话落地的工作区以及联网/读文件开关的初始状态。

技术细节与生态¶

• 模型依赖：默认使用 deepseek-official 或 deepseek-v4-flash，不单独存储 API Key。
• 无构建步骤：依赖库极少，无构建过程，代码轻量。
• OpenAI 兼容协议：插件作为后端支持 OpenAI chat-completions 协议。可作为其他应用的后端（如 Obsidian 插件、浏览器扩展）。
• 浏览器扩展：插件同时提供了浏览器扩展版本，不依赖 DSH 主程序即可使用。支持三种深度档位。

注意事项¶

• 插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证（MIT）。
• 设置文件路径为 settings.json（注意后缀）。