编辑器对话侧栏 swording-k/dsh-vscode

DeepSeek Harness for VS Code

非官方社区扩展，与 DeepSeek 官方无隶属关系。
DeepSeek Harness 本体是 MIT 协议的开源项目（deepseek-ai/deepseek-harness）。

非官方社区扩展，与 DeepSeek 官方无隶属关系。DeepSeek Harness 本体是 MIT 协议的开源项目。

落地页： https://swording-k.github.io/dsh-vscode/

Install / 安装

从 GitHub 安装（现已可用）： 到 Releases 下载 dsh-vscode-<version>.vsix，然后在命令面板（macOS 上按 Cmd+Shift+P）运行 Extensions: Install from VSIX…。

从 Marketplace 安装： 在扩展视图里搜索 DeepSeek Harness。

What it does / 它做什么

把 DeepSeek Harness 放进编辑器：左侧启动器列出当前文件夹的对话；一点就在编辑器旁边打开完整 GUI，直接读写你的源码树。

用 VS Code 管理 DeepSeek Harness 对话：左侧启动器列出当前文件夹的历史对话，一点就在编辑器右侧打开完整 GUI，直接读写你的项目文件。

Entry points / 入口（四个入口）

| 位置 | 作用 |
| 左侧边栏（活动栏） | 鲸鱼图标 → 启动器，含文件夹名、会话列表和新建对话按钮 |
| 次级侧边栏（右侧） | 同一个启动器，放在原生右侧槽位（VS Code ≥ 1.94） |
| 编辑器标题栏（右上角） | 鲸鱼按钮 → 为当前文件夹新建对话 |
| 状态栏（右下角） | DSH → 打开启动器 |
| 命令面板 | DSH: Open Panel、DSH: New Conversation、DSH: Refresh Conversations |

Prerequisites / 先决条件

- Node.js ≥ 22
- DeepSeek Harness：npm i -g @deepseek-ai/dsh 扩展默认调用 PATH 上的 dsh 可执行文件；设置了 dshHarness.repoPath 时改用该仓库检出。
- API key：在环境变量里设置 DEEPSEEK_API_KEY，或使用 ~/.dsh/.credentials.yaml。
GUI 内置的 Account 设置支持首次启动时输入 key。

Usage / 使用

1. 点击左侧边栏的 DeepSeek Harness 图标（或用上面任一入口）。
2. 启动器显示你的 VS Code 文件夹及其对话；点击 + New Conversation，或选一个已保存的对话。完整 DSH GUI 会在右侧打开，直接读写你的工作区文件。
3. 首次使用时服务器自动启动；主题跟随 VS Code 配色方案（想手动控制就关掉 dshHarness.syncTheme）。

Settings / 设置

| 设置 | 默认值 | 说明 |
| dshHarness.repoPath | "" | 可选，指向 deepseek-harness 源码检出（留空则用 PATH 上的 dsh） |
| dshHarness.command | dsh | repoPath 为空时使用的可执行文件（如 dsh、pnpm dsh） |
| dshHarness.port | 3080 | dsh web 服务器端口 |
| dshHarness.autoStart | true | 服务器未运行时自动启动 |
| dshHarness.syncTheme | true | 让 DSH 配色方案跟随 VS Code 主题 |

Publishing / 发布

扩展自带一个配套的 dsh-plugin-deep-link 客户端插件，放在 plugin/ 目录下。在标准 dsh 安装中，它会通过 dsh plugin --profile web add … 自动装进 web 配置档。源码检出已经包含 deep-link 补丁，不需要再装。

发布到 Marketplace 之前：

1. 创建发布者：VS Code Marketplace → 创建发布者。
2. 生成 Personal Access Token（Azure DevOps → Marketplace 范围 → Manage）。
3. 登录：npx @vscode/vsce login <publisher-id>。
4. 把 package.json 里的 publisher 换成你的发布者 id。
5. 把 package.json 里占位的 repository.url 换成你真实的 GitHub 仓库 URL。
6. 运行 npm run package（产出 .vsix），再运行 npx @vscode/vsce publish。

已知限制

- 通过 #session=<id> 定位会话依赖 dsh-plugin-deep-link 插件。标准 @deepseek-ai/dsh 用户会自动装上；custom 分支上的源码检出用户已经打好补丁。两者都没有时，GUI 正常打开，你在 GUI 侧边栏里选会话——多点一下。
- VS Code 1.94 之前的版本不显示次级侧边栏槽位。
- 暂不支持多根工作区（只对齐第一个文件夹）。

开发

npm install
npm run compile # tsc → out/
npm run package # produces .vsix

服务器日志显示在 Output 面板的 DeepSeek Harness Server 下。