选中即问 hufeide/dsh-sidebar-assistant

dsh-sidebar-assistant（选中即问）

一个侧边栏助手插件，面向 DSH（DeepSeek Harness）Web 界面。在 Web 聊天界面里选中任意文本，即可基于所选内容发起提问，模型会参考与选中文字相关的当前会话片段与选中的引用文字作答，并在浮层面板里流式显示思考过程与最终回答。

使用场景：deepseek 主对话对连续话题的理解问答，dsh-sidebar-assistant 插件生成的对话框，主要用户临时不解进行回答，这样不污染主对话内容，并且省 token 的，因为插件对话框只引用选中文字及其涉及的这段对话。当有临时发问，请在插件会话问吧。

功能特性

- 选中即问：在 Web 界面选中一段文字，点击文字下方“提问”，浮层面板自动弹出，所选文字作为引用。
- 按引用过滤历史：自动只把当前会话里文本包含选中文字的对话片段作为上下文；同时带上其对话伙伴（user↔assistant 配对保留）。未被选中文本"触及"的对话不会进入历史，最大化节省 token。
- 流式输出：回答实时逐字渲染，无需等待全部生成完毕。
- 思考过程折叠：模型的思考过程（reasoning）与最终回答分开显示；思考过程默认折叠，可点击「思考过程」展开查看。
- 严格以引用为准：模型被提示"参考当前会话历史了解上下文，不要臆测引用之外的事实"，回答只围绕选中文字展开。
- 面板可拖拽 / 可缩放：标题栏拖拽移动浮层；四角与四边拖拽调整面板大小。
- Enter 提交：输入问题后直接按 Enter 即可提问。
- 仅当前会话：历史只来自选中所处的会话，不混入其他会话。

alt text

环境要求

- Node.js ^22.19.0 或 >=24
- 已安装并可用 dsh CLI（@deepseek-ai/dsh），并存在可用的 Web 配置文件（--profile web）
- 已配置可用的 LLM Provider（插件复用 harness 的 LLM 服务，使用默认模型 deepseek-v4-flash 等）

安装

插件以 link: 方式安装到目标 profile，指向源码目录，便于本地开发调试。

1. 安装依赖

git clone https://github.com/hufeide/dsh-sidebar-assistant
cd dsh-sidebar-assistant
pnpm install

2. 构建

pnpm run build

构建产物输出到 lib/（host 逻辑为 lib/index.js，client bundle 为 lib/client.js）。

3. 安装到 DSH

⚠️ 不要执行 add dsh-sidebar-assistant —— 本插件尚未发布到 npm，那个名字在 npm registry 是 404，会被 pnpm fetch 404 拒绝。dsh plugin add 之后的参数会原样交给 pnpm，必须传「路径」而不是包名。

最省心的一行（推荐）：

pnpm run install-plugin

这条 script 内部会 build → dsh plugin --profile web add link:$PWD，把当前 checkout 用 link 语义装到 web profile，再提示你下一步。

或手动指定路径：

在本插件目录下：'.' 即当前目录
npx -p @deepseek-ai/dsh dsh plugin --profile web add .

或者从任意目录用绝对路径（最稳，避免 workspace 误识别）
npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-sidebar-assistant

等价于在 profile 目录下执行 pnpm add <path>，用 link: 语义把 checkout 软链进 profile 的 node_modules。

注意：插件 package.json 里的 name 是 dsh-sidehelper，所以安装后 profile 的依赖 key 也是 dsh-sidehelper，而不是目录名 dsh-sidebar-assistant。

安装后插件会以 link: 方式记录在 profile 的 package.json 中，源码目录的改动在重新构建后即可生效。

4. 重启 harness

停止旧进程（如有） pkill -9 -f "dsh web" 启动
dsh web

启动后打开 Web 界面，在会话中选中一段文字即可使用。

说明：由于以 link: 安装，改代码后需重新 pnpm run build 并完全重启 harness（仅刷新页面可能不生效）。

使用

1. 打开 DSH Web 聊天界面，进入任意会话。
2. 用鼠标选中一段文字（作为引用）。
3. 浮层面板自动弹出，输入你的问题。
4. 按 Enter 或点击「提问」按钮提交。
5. 面板中：
- 「你的问题」：展示本次问题。
- 「思考过程」：模型思考链（默认折叠，可点击展开）。
- 回答卡片：模型最终回答，流式实时显示。
6. 拖动标题栏移动面板；拖动边框或四角调整大小；点右上角 × 关闭。

配置

插件支持以下可选项（写入 harness 的插件配置）：

| 配置项 | 类型 | 默认值 | 说明 |
| enabled | boolean | true | 是否启用插件 |
| provider | string | '' | 指定 LLM Provider（留空则自动探测） |
| model | string | '' | 指定模型（留空则自动探测） |
| systemPrompt | string | '' | 自定义系统提示词（追加到默认提示之上） |
| personaText | string | '' | 自定义人设文本（追加到默认提示之上） |
| persistDir | string | .sidehelper | 问答记录的持久化目录 |
| maxQuotedChars | number | 4000 | 引用文字的最大字符数（超长截断） |
| placeholder | string | 输入你的问题… | 提问框占位文案 |

Provider / Model 留空时，插件会依次尝试：当前活动调用 → harness 默认会话模型（agentDefaultModel）→ 手动配置 → 自动探测首个可用 Provider。

项目结构

dsh-sidebar-assistant/
├── src/
│ ├── index.ts # 插件入口（host 导出） │ ├── host/ │ │ ├── index.ts # 导出 apply/Config 等 │ │ ├── web.ts # 插件主体：SSE 流式 ask、配置探测、持久化 │ │ ├── llm.ts # LLM 流式调用（区分 think/delta） │ │ ├── context.ts # Prompt 组装（会话历史 + 引用 + 问题） │ │ ├── config.ts # 插件 Schema 配置 │ │ ├── persistence.ts# 问答记录持久化 │ │ └── stream.ts # 流式文本累积工具 │ ├── client/ │ │ ├── index.ts # client 侧：注入、选中触发、SSE 拉取 │ │ ├── history-filter.ts # 按引用文字过滤 turn 的纯函数（命中 + 配对） │ │ ├── panel.ts # 浮层面板 UI（拖拽/缩放/流式/思考折叠） │ │ └── selection.ts # 选中文本监听 │ └── types/ │ └── index.ts # 共享类型 ├── lib/ # 构建产物 ├── cordis.patch.yml # bundle patch ├── tsdown.config.ts # client bundle 打包配置 ├── tsconfig.json # host TypeScript 配置 └── tsconfig.client.json # client TypeScript 配置

故障排查

| 现象 | 可能原因 | 处理 |
| 面板没出现 | 未选中所处会话 / 插件未生效 | 确认进入会话并选中文本；重启 harness |
| 一直「生成中…」 | 浏览器或 host 端请求挂起 | host 端已内置 30s LLM 超时、前端 65s 兜底；检查 Provider 网络/凭证 |
| host ask failed: HTTP 500 | Provider 未注册 / 凭证或端点错误 | 检查 .dsh/settings.yaml 的 provider、baseURL 与凭证；参考日志 .sidehelper/ask-error.log |
| 安装报 [ERR_PNPM_FETCH_404] ... dsh-sidebar-assistant | 把目录名当成 npm 包名在 npm registry 找了，本插件尚未发布 | 不要传包名；改用路径：add .（在插件目录下）或 add /abs/path；最稳是一键脚本：pnpm run install-plugin |
| 安装报 workspace declares no dsh.bundle | add . 让 pnpm 把 cwd 当成 workspace root，link 错对象 | 改用绝对路径：add link:/home/fei/workspace/dsh-sidebar-assistant 或 add /home/fei/workspace/dsh-sidebar-assistant；删除误加的 workspace 依赖：dsh plugin --profile web remove workspace |
| 改代码不生效 | link: 安装需重新构建 + 完整重启 | 重新 pnpm run build，并 pkill -9 -f "dsh web" 后重启 |
| 请求 /plugins/.../client.js 失败 | 缓存 / harness 未重启 | 完全重启 harness，浏览器强制刷新 |

协议

遵循 DSH 生态的 MIT 协议（见仓库许可证）。