dsh-sidebar-assistant
hufeide/dsh-sidebar-assistant
Web 界面的侧边栏助手插件,在 Web 聊天界面里选中任意文本，在浮层面板里流式显示思考过程与最终答案。
安装
dsh plugin --profile web add github:hufeide/dsh-sidebar-assistantREADME
dsh-sidebar-assistant（选中即问）
一个面向 DSH（DeepSeek Harness）Web 界面的侧边栏助手插件。在 Web 聊天界面里选中任意文本，即可基于所选内容发起提问，模型会参考与选中文字相关的当前会话片段与选中的引用文字作答，并在浮层面板里流式显示思考过程与最终回答。
使用场景：deepseek主对话对连续话题的理解问答，dsh-sidebar-assistant插件生成的对话框，主要用户临时不解进行回答，这样不污染主对话内容，并且省token的，因为插件对话框只引用选中文字及其涉及的这段对话。当有临时发问，请在插件会话问吧。
功能特性
- 选中即问：在 Web 界面选中一段文字，点击文字下方“提问”，浮层面板自动弹出，所选文字作为引用。
- 按引用过滤历史：自动只把当前会话里文本包含选中文字的对话片段作为上下文；同时带上其对话伙伴（user↔assistant 配对保留）。未被选中文本"触及"的对话不会进入历史，最大化节省 token。
- 流式输出：回答实时逐字渲染，无需等待全部生成完毕。
- 思考过程折叠：模型的思考过程（reasoning）与最终回答分开显示；思考过程默认折叠，可点击「思考过程」展开查看。
- 严格以引用为准：模型被提示"参考当前会话历史了解上下文，不要臆测引用之外的事实"，回答只围绕选中文字展开。
- 面板可拖拽 / 可缩放：标题栏拖拽移动浮层；四角与四边拖拽调整面板大小。
- Enter 提交：输入问题后直接按
Enter即可提问。 - 仅当前会话：历史只来自选中所处的会话，不混入其他会话。
环境要求
- Node.js
^22.19.0或>=24 - 已安装并可用
dshCLI（@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（仅刷新页面可能不生效）。
使用
- 打开 DSH Web 聊天界面，进入任意会话。
- 用鼠标选中一段文字（作为引用）。
- 浮层面板自动弹出，输入你的问题。
- 按
Enter或点击「提问」按钮提交。 - 面板中：
- 「你的问题」：展示本次问题。
- 「思考过程」：模型思考链（默认折叠，可点击展开）。
- 回答卡片：模型最终回答，流式实时显示。
- 拖动标题栏移动面板；拖动边框或四角调整大小；点右上角
×关闭。
配置
插件支持以下可选项（写入 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 协议（见仓库许可证）。