侧栏编码助手 Jabofish/deepseek-harness-vscode

JaboDSH

JaboDSH 把本地或远程 DeepSeek Harness（DSH）会话带进编辑器。在代码旁查看流式回复、思考、工具、审批和会话历史。

JaboDSH 是由社区独立维护的 DeepSeek Harness 客户端。

可以做什么

- 在工作区中创建、切换、恢复和归档会话；支持恢复的运行时可在归档通知中直接撤销。
- 将会话导出为 Markdown、JSON 或 ZIP 归档，导出对话框会记住选择的格式。
- 发送文本、图片和受支持的文件，用 @ 引用文件或会话。
- 跟进工具进度、回答问题与审批，并通过 VS Code 打开生成的文件。
- 选择当前 DSH 运行时提供的模型、Provider、权限和 Agent 选项。
- 在满足前提时使用本地 Prompt 模板、检查点、变更视图和任务中心。
- 使用接近 DSH 原版的聚焦布局，按需展开过程详情，并使用紧凑输入栏。在 设置 → 常规 → 会话布局 中可以选择聚焦或经典布局；选择保存在本地。
- 在侧边栏旁打开独立导航的编辑器会话标签，窗口重载后恢复各自的会话。
- 简洁对话视图保留最近活动及进行中或失败的工作，通过 显示全部活动 展开早期记录。
- 在 设置 → 模型 → 模型计费 中按需启用会话费用估算，查看输入、输出和缓存分项，选择参考模型或填写自定义单价。中文显示人民币，英文显示美元；汇率刷新失败时沿用已保存的报价。

支持的 DSH 版本见兼容说明，各项功能见功能清单。

可选的编辑器集成让 DSH 读取未保存文本、选区和诊断，使用语言服务，并执行可撤销编辑。在 设置 → 常规 → 编辑器集成 → 安装并启用配套插件 中安装；同一页面可以切换只读模式、停用集成或撤销编辑。

安装与开始使用

从 Visual Studio Marketplace 安装 JaboDSH，或执行 code --install-extension Jabofish.jabodsh。

手动安装时，从最新 GitHub Release下载与 Extension Host 操作系统和架构匹配的 VSIX，再执行 Extensions: Install from VSIX...；也提供 universal 包。

从旧扩展切换

JaboDSH 接替 Direwolf.deepseek-harness-client（DeepSeek Harness Companion for VS Code）。安装前先停用或卸载旧扩展，避免两者注册相同的命令和视图；如需使用旧版的本地模板或检查点，请保留旧扩展数据。

现有 dsh.* 设置和命令 ID 继续使用，DSH 会话数据仍保存在运行时中。VS Code 会将 JaboDSH 视为独立扩展，私有扩展存储、已保存的编辑器标签和 Webview 偏好不会自动迁移。请重新打开会话、重新授权外部连接，并在启用编辑器配套插件前检查其状态。旧扩展保存的全局模板和检查点仍留在其私有存储中。

开始会话

1. 打开 JaboDSH 视图。
2. 如果缺少 DSH，使用引导安装、选择现有可执行文件，或复制视图显示的精确安装命令。安装器会显示 npm 输出并验证安装版本；npm 警告本身不会导致安装失败。
3. 选择或创建工作区，开始会话并发送任务。

输入框为空时，按 ↑ 可调出本对话已发送的上一条提示，↑/↓ 在历史提示之间前后切换；开始编辑后即退出历史浏览。

JaboDSH 的 Chat 视图默认注册在辅助侧边栏（VS Code 默认布局中位于编辑器右侧）。如果你以前移动过视图，VS Code 可能保留已有布局；可在命令面板运行 JaboDSH: Move View to Secondary Side Bar，选择 Chat 视图和 New Secondary Side Bar Entry，或右键视图标题使用 Move View。

打开编辑器聊天标签后，侧边栏仍可使用。会话列表会记住排序和工作区分组方式，重载后继续使用。通过视图标题栏的会话按钮切换或新建会话；原生标题栏在宽度足够时显示完整操作，变窄后逐步将低频操作收进“更多”，优先保留会话和设置。

标题栏的 Open Web UI 默认使用 VS Code 内置浏览器。若要使用系统浏览器，在 VS Code 设置中将 dsh.webUi.browser 改为 external。

在 VS Code 设置中将 dsh.completionCue 设为 notification（通知）或 bell（短提示音），可在 VS Code 失去焦点、实时回复成功结束并渲染后提醒；默认 off（关闭）。通知使用 VS Code 通知界面；桌面弹窗和声音的实际投递受编辑器、浏览器及操作系统设置影响。

选择 在编辑器区打开 或执行 JaboDSH: Open Chat in Editor Area（/moveto:editor）打开标签，/moveto:sidebar 可移回侧边栏。也可拖动已打开的编辑器标签分栏。手动排序时，拖到下方某行会放在该行之后，拖到上方某行会放在该行之前。顺序由 DSH 保存，当前空白会话保持置顶。

点击对话标题可通过下拉菜单选择其他会话：侧边栏直接切换当前对话，编辑器内则打开或显示所选会话自己的标签。支持方向键、Enter 和 Escape。打开会话或新建会话后，键盘焦点会进入该会话的输入框，可以立即输入。

打开浮层会话列表后可直接输入关键词，只有一条匹配会话时按 Enter 打开；再次打开会选中上次的关键词，直接输入即可替换。

要直接拖拽会话分栏，可执行 JaboDSH: Open Drag Sessions，在资源管理器中打开 JaboDSH Sessions，将会话行拖到编辑器边缘即可分栏打开。运行该命令后才会显示资源管理器中的会话列表。

auto 会先尝试上次成功的本机连接，再发现运行中的实例，最后按需启动 DSH。也可以通过服务地址或端口列表指定要连接的实例。

| 连接模式 | 行为 |
| auto | 连接正在运行的 DSH；没有候选可连接时才启动扩展持有的实例。 |
| attach-only | 只发现和连接，绝不启动 DSH。 |
| new-isolated | 启动一个专用、由扩展持有的 DSH。 |
| custom | 只探测用户给定且经过校验的单个 HTTP(S) 端点。 |

常规设置页可以检查上游包版本并安装已验证的精确版本。更新全局包不会停止外部 DSH。

在 Windows 上，安装器会先在独立目录验证新版 CLI，再切换全局包和启动入口。遇到文件占用时，查看安装输出，关闭列出的应用后重试。切换失败会恢复旧版；中断的安装会在下次尝试时恢复。更新期间请预留同时存放新旧版本的临时空间。

连接外部实例

1. 选择 custom，将 dsh.connection.serverUrl 设为服务端 HTTP(S) 地址，不带路径、查询参数或凭据。
2. 将 dsh.connection.runtimeVersion 设为服务端实际运行的受支持精确版本。
3. 执行 JaboDSH: Authorize External Connection，在原生密码框输入启动 token；无需认证的实例可留空，然后连接。

HTTPS 要求可信证书。远程 HTTP 必须确认明文传输，DNS 地址变化后需重新授权。服务端也需接受配置的主机地址；支持时可用 DSH 的 --trusted-host host:port 允许代理地址。远程连接不授予本地工作区文件或本地检查器访问权限。

凭据按执行环境和完整 origin 存入 VS Code SecretStorage。更换环境或 origin 后需要重新授权；使用 JaboDSH: Clear External Connection Credentials 清除当前执行环境的授权。

远程工作区

在 Remote SSH、WSL、Dev Containers 和 Remote Tunnels 下，把扩展和 DSH 安装在工作区所在的一端。发现、安装、进程启动、环回连接和文件操作都使用该 Extension Host 的环境；只装在本机桌面的 DSH 不属于远端工作区。

远程窗口选择附件时保留所选文件系统的 URI。桌面客户端的 Inspector 操作先通过 VS Code 转发已验证的 Worker，再打开或复制 DevTools 链接；浏览器客户端不提供原生 DevTools。容器重建需要配置容器内的运行时安装及 DSH 数据持久化。

隐私与支持

遇到连接或界面问题时，执行 JaboDSH: Show Redacted Diagnostics，并按支持说明提交反馈。附上诊断和截图前，请检查其中是否仍有私人内容。安全漏洞请通过安全报告渠道提交。

开发者文档从文档索引开始；贡献入口提供 English guide 和中文指南，并共用测试指南与 Agent 规范。版本更新见扩展更新日志。项目使用 MIT 许可。