划词追问 Dengzi555/dsh-quotalk

dsh-quotalk

为 DeepSeek Harness Desktop 增加划词菜单：添加到对话 / 在侧边聊天中提问。

选中文字后，菜单出现在选区旁边。需要在原对话里继续聊，就把引用添加到主输入框；需要单独解释或举例，就在 DSH 原生右侧页签里追问。主回答继续留在眼前。

交互参考 Codex 的划词工具，使用 DSH 的公开插件接口独立实现，没有使用 Codex 内部组件。本版从 deepseek-quotalk 的上下文处理代码适配，原网页版项目保持不变。

当前功能

- 添加到对话：以引用格式插入主输入框，不自动发送，不替换原有草稿或引用芯片。输入框发生变化时会拒绝过期插入，提示重新划词。
- 在侧边聊天中提问：打开原生右侧“追问”页签，引用上方折叠显示，直接输入问题或点击“解释一下 / 举个例子”。
- 流式回复：直接调用 Harness 的模型服务，不新开 DeepSeek 网页，不切换窗口。收到模型完成标记后立即结束回答状态。
- 上下文范围：仅当前回答、最近 2 轮、最近 4 轮、当前会话已加载的全部对话。过长内容会截取。
- 独立追问：不同选词各自保留本次运行中的问答；切换选词不会将上一条回答写进新选词中。重复选中同一段可继续聊。
- 阅读操作：Enter 发送、Shift + Enter 换行、中文输入法保护、停止回复、侧边聊天内回到最新。回答过程中可编辑下一条问题，当前回答结束或停止后再发送。
- 原生布局：跟随 DSH 的主题和右侧栏布局；关闭、宽度调整和窄屏展示使用 DSH 自己的页签控件。没有桌宠、动画素材、独立悬浮聊天窗和额外主题开关。

插件复用当前会话选择的模型；如果模型选择投影不可用，会使用该会话最近一次完整回答的模型。是否免费取决于你在 DSH 中使用的模型和额度。 本版不调用免费网页版账号额度，不需要向插件另填 API Key。

从 GitHub 安装

在已经安装好 DSH 命令的终端执行（desktop 为官方桌面端 profile）：

dsh plugin --profile desktop add github:Dengzi555/dsh-quotalk

安装后按提示重启 DSH Desktop，并在插件管理中确认已启用。插件已经提交构建产物，安装时无需编译。

若终端找不到 dsh，在官方桌面端的“应用 → 管理 dsh 命令…”中安装命令，再重新打开终端。

从本地目录安装

适配基准：官方 DeepSeek Harness dsh-v0.2.0-rc.2，与你本机运行时的版本一致。已按该版本的右侧页签、输入框插入、会话快照和 LLM 流接口核对实现。

1. 将整个 dsh-quotalk 文件夹放到固定位置。根目录应包含 package.json、cordis.patch.yml、lib/ 等。
2. 在 DSH Desktop 的插件管理中安装这个本地插件包目录。如果桌面发行版提供“本地目录/本地包来源”入口，选择或填写本文件夹的绝对路径。不同发行版的入口可能不同。
3. 若桌面端没有本地目录安装入口，可在已经能运行 dsh 的终端执行：

dsh plugin --profile desktop add "C:\你的固定目录\dsh-quotalk"

desktop 应是你桌面端实际使用的 profile；其他桌面发行版请按自身配置替换。若终端提示找不到 dsh，请使用该发行版提供的 CLI 入口或插件管理界面。
4. 确认插件包及其中 dsh-quotalk 插件已启用，按客户端提示重启 DSH Desktop。
5. 打开正常工作的主对话，选择模型并完成一次回答。选中回答中至少两个字符，即可看到两个操作按钮。

交付包含 lib/client.js 构建产物，安装前无需 npm install 或编译，也没有依赖安装脚本。这不是浏览器扩展，不使用 Edge/Chrome 的“加载解压缩的扩展”。 安装后不要移动或删除插件目录。

本地目录安装不会修改原网页版 deepseek-quotalk 项目；两份插件独立维护。

上下文与数据

只读取当前 DSH 会话中已加载的用户文字和助手文字，不读取其他会话、整个工作区、文件内容、工具结果或模型思考。未加载的历史不属于“全部”。若会话结构无法识别，只保留选中段落，不假装关联了完整对话。

所选引用、上下文和侧边问答会随请求发送给你在 DSH 中选择的模型提供方。插件自己不读取密钥，不提供工具，不执行命令，不向主对话追加消息；“添加到对话”仅按用户点击插入草稿。

追问历史保存在插件内存中，关闭侧边页签后重新划词可恢复本次运行的内容；刷新或重启后清空。切换主会话会停止旧会话正在进行的插件请求，避免把新主会话上下文混入旧追问。

服务端接口仅允许本机同源 DSH 页面访问，并使用每次运行生成的请求校验令牌；不支持远程域名、反向代理地址或 file:// 桌面包装。目标是官方 Desktop 的本机服务模式。

开发与验证

需要 Node.js 20 或更高版本：

npm run build
npm test

- src/selection.js：选区菜单与监听清理。
- src/sidebar.js：紧凑的原生右侧页签内容。
- src/store.js：每个会话、每条引用的追问隔离，以及主输入框插入。
- src/bridge.js：公开会话快照、模型选择与流式客户端。
- src/core.js：原项目复用的上下文长度限制与追问提示组装。
- lib/index.js：Host 插件，调用 ctx.llm.stream，处理取消与流式完成。
- scripts/build.mjs：无需第三方依赖，将源码组装为 DSH ModuleLoader 格式。

React 由 DSH 提供。包中没有浏览器 manifest、动画视频、安装 ZIP、node_modules 或原网页版安装截图。

21 项自动测试覆盖了官方接口形状的样例、模拟划词与 React 元素、上下文、模型选择、流式结束、引用插入和错误。用户已在本机 DSH Desktop 安装，并确认可以使用。此反馈与自动测试不代表已覆盖所有桌面发行版及模型；不同版本的插件 API 变化可能需要进一步适配。

若没有划词菜单，先检查包与插件是否已启用、Host/Client 激活是否报错及 DSH 版本。若侧边栏不回答，先确认主对话使用同一模型可以正常回答。

许可与参考

代码与文档采用 MIT License，来源说明见 NOTICE.md。

官方接口参考：DeepSeek Harness RC.2、右侧页签注册接口、输入框插入接口、LLM 流接口。