跳到正文
dsh-market 浏览插件 GitHub EN

hufeide/dsh-sidebar-assistant

Web 界面的侧边栏助手插件,在 Web 聊天界面里选中任意文本，在浮层面板里流式显示思考过程与最终答案。

Star 数 ★ 2 分类 UI 增强 收录于 2026-08-22

安装

在 DeepSeek Harness 里通过 dsh-market 安装

dsh plugin --profile web add dshmarket

或使用命令行

dsh plugin --profile web add github:hufeide/dsh-sidebar-assistant

装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络。请先审阅源码，并尽量锁定 commit（github:owner/repo#sha）。

README

一个面向 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 协议（见仓库许可证）。

内容来自项目 README（GitHub）↗