IDE Workbench
IDE Workbench
把 JetBrains 式 IDE 工作区搬进 DeepSeek Harness 的右侧栏。
Project / Commit / Git / Terminal 四个工具窗围绕插件自带的编辑器，与聊天同屏协作——文件、代码行、提交和终端都留在对话旁边，不用来回切换窗口。
简体中文 · English
IDE Workbench 概览：Commit 面板、编辑器中的 Diff 与 Git 日志同屏
为什么是 IDE Workbench？
DSH 的对话很适合“边聊边改”，但真正改代码时还是要在聊天、终端、文件管理器和 IDE 之间来回跳。IDE Workbench 把一整套 JetBrains 风格的工作区放进 DSH 的右侧栏，并且始终和当前会话在一起：
- 与聊天同屏：聊天里的文件链接直接在工作台打开并定位到行；反过来，在项目树或编辑器里右键 发送到聊天框，就会在聊天输入框里插入
@路径 引用——选中代码时连同行号和代码一起带上。
- IDEA 手感：
Alt+1 / Alt+0 / Alt+9 / Alt+F12 切换工具窗；单击预览、双击固定标签；Alt+Insert 新建、F2 重命名、Ctrl+K 聚焦提交、Ctrl+Shift+K 推送。
- 真实仓库与终端：Git 全部走系统 CLI（凭证管理器、hooks、git config 原样生效）；终端是真实 PTY；文件读写经过路径围栏，保存保留原编码与换行符。
- 跟随 DSH：只用宿主的主题令牌，明暗/皮肤自动跟随；右侧栏原生 tab、会话连续性、设置页；DSH Desktop 与 Web profile 都能安装。
功能一览
| 界面 | 功能 |
|---|
| Project 工具窗 | Project 工具窗。 惰性加载的文件树，JetBrains 状态色（红 = 未跟踪、绿 = 新增、蓝 = 已修改，目录递归染色）。单击选中、双击打开或展开；目录箭头单击即可展开/折叠。Ctrl/Shift 多选、拖拽移动（Ctrl = 复制）。新建文件/目录、F2 重命名、Delete 删除（优先进回收站）、F5 复制、F6 移动、Ctrl+X/C/V。【文件定位】一键跳到当前打开的文件、树内过滤与全项目文件名快速定位；右键菜单直接 发送到聊天框。 |
| CodeMirror 编辑器 | 内置编辑器。 CodeMirror 6，语法高亮；自动 / 始终可编辑 / 始终只读三档打开模式，自动档下 1 MiB 以内的文本可直接编辑（Markdown 默认进渲染预览）。Ctrl+S 原子保存并保留 UTF-8 / BOM / UTF-16 与 CRLF，脏点与“未保存”提示清晰。外部程序改动触发居中于文档区的冲突弹窗，可“从磁盘重新加载”或“覆盖磁盘”；同一文件被自己保存后不再误报。编辑器内查找/替换、光标行列与编码状态栏。 |
| Markdown 预览与大纲 | Markdown 预览。 用宿主 MarkdownText 渲染，表格、任务列表、代码卡与 DSH 聊天排版一致。默认直接进入渲染预览，“预览 / 源码 / 编辑”一键切换；文档大纲可跳转并跟随滚动高亮。打开文档不再先落到源码编辑器里。 |
| 全项目查找 | 全项目查找与快速打开。 Ctrl+Shift+R 全项目搜索（浏览器形态请用备用键 Ctrl+Alt+F），Aa / 全词 / 正则三个开关全部可用。结果按文件分组并显示命中数、耗时；点击命中直接在编辑器中定位到行。Ctrl+P / Ctrl+Shift+N 按文件名快速打开全项目文件。 |
| Commit 工具窗 | Commit 工具窗。 Changes / Unversioned 两组，勾选即纳入本次提交且列表不跳动；变更列表（Changelist）、按目录分组。Change View（工作区 / 上次修订 / 最新提交）+ 跳转到源码 + 回滚；Diff 工具栏支持行/块级暂存。提交、提交并推送、Amend、最近提交消息、可选 pre-commit 命令（测试 / 优化导入 / 清理）。 |
| 统一 Diff | Diff。 并排 / 统一两种布局，单词级高亮，未变更块可折叠。与工作区、上次修订、任意提交或两个提交（Ctrl+点击）比较；可直接暂存/丢弃单个 hunk。HTML/二进制文件走 DSH 侧栏或系统默认程序预览。 |
| Git 历史与详情抽屉 | Git 历史。 分页提交表 + 泳道式 commit graph；按分支 / 作者 / 消息 / 路径过滤。单击选中、双击（或 Enter）打开右侧详情抽屉：元信息、完整消息、变更文件，点文件看逐文件 Diff。复制 SHA、检出、回退、两提交 Compare；从项目树可对指定路径定向查看历史。 |
| 终端 | Terminal。 真实 PTY（WebSocket + xterm.js），支持多会话、重命名、关闭；shell profiles（PowerShell / Git Bash / cmd / …）。停靠 ↔ 全屏、面板缩放后自动按新宽度重排，并向 PTY 发送 resize。选中即复制、Ctrl+Shift+V 粘贴；工作目录跟随项目根或当前文件。 |
| 编辑器右键发送到聊天框 | 与聊天协作。 聊天里的文件链接默认在工作台打开并定位 #L24；工作区外自动降级到 DSH 自带侧栏。项目树 / 编辑器右键 发送到聊天框：文件或文件夹插入 @路径 引用；选中代码时追加行号与代码块。HTML 可在 DSH 侧栏或系统浏览器预览；不抢走聊天输入的焦点。 |
| IDE 工作台设置 | 设置与快捷键。 工具窗/命令快捷键、默认 shell、终端字号、打开模式、Markdown 预览、隐藏/忽略文件、聊天链接行为、外部 IDE 路径、git 路径与提交命令。修改后约 300 ms 自动落盘并显示“已保存”；关闭面板前不会丢失最后一次改动。设置页固定头部与关闭按钮，长表单滚动时不迷路。 |
| 代码智能 | 补全、跳转定义与查找用法。 所有语言都有本地补全（零依赖，Tab / Enter 接受，Esc 关闭）。配置了语言服务器时再加上语义补全、悬停文档与签名帮助：Ctrl+点击 或 F12 跳到定义（跨文件自动开标签并定位到列），Alt+F7 列出语义引用（不含注释与字符串里的同名出现），Alt+F8 是始终可用的文本版查找用法（每条结果都标「文本匹配」）。打开未索引的目录时会先问要不要构建索引，工作区根目录会额外警告（它通常含多个独立仓库）；内存不足则直接降级为保守版（本地补全 + 文本查找），状态栏常驻显示语义分析的状态。索引要吃多少内存按语言估算、可以配置 —— 见代码索引的内存配置。 |
安装
前置：DSH ≥ 0.1.7（DSH Desktop 0.2.x 或 Web profile 均可）。插件已发布到 npm：dsh-ide-workbench。
方式一：DSH Desktop（推荐）
- 打开 设置 → 插件。
- 点 添加插件，在「包名或地址」输入框填入
dsh-ide-workbench（可带版本号，如 dsh-ide-workbench@0.5.1）；也可以直接粘贴 Release 附件的 .tgz 地址（见方式四）。
- 安装完成后，在会话头部点 IDE 工作台按钮（或侧栏底部的常驻入口）打开。
Desktop 的 profile 由 Electron 应用独占管理，dsh plugin --profile desktop ... 会被拒绝——桌面端请走插件页安装。插件页在宿主进程里执行，装的就是 Desktop 自己那个 profile。
方式二：CLI / npm
# 安装到指定 profile（例如 web）
dsh plugin --profile web add dsh-ide-workbench
# 只装指定版本
dsh plugin --profile web add dsh-ide-workbench@0.5.1
安装后重启该 profile；如果 bundle 尚未启用，在 设置 → 插件 里打开 IDE Workbench。
方式三：Git 仓库或本地目录
# 直接从 GitHub 安装（仓库自带构建好的 dist/client.js）
dsh plugin --profile web add git+https://github.com/LiangshouX/dsh-ide-workbench.git
# 或克隆后从本地目录安装
git clone https://github.com/LiangshouX/dsh-ide-workbench.git
dsh plugin --profile web add ./dsh-ide-workbench
方式四：Release 离线包（不联网也能装）
每个 Release 都附了一个
自带 node_modules 的 npm 构建包（dsh-ide-workbench-<版本>.tgz），运行时依赖
已经打进去，装的时候不需要访问 npm registry：
# 把 <版本> 换成 Release 的 tag（如 v0.5.1）
dsh plugin --profile web add https://github.com/LiangshouX/dsh-ide-workbench/releases/download/v0.5.1/dsh-ide-workbench-0.5.1.tgz
Release 页同时提供变更说明（取自 CHANGELOG.md）与源码包
（GitHub 自动附带）。
这个 .tgz 地址也能直接填进 设置 → 插件 → 添加插件 的「包名或地址」输入框
——宿主的安装规格解析器接受以 .tgz / .tar.gz 结尾的 http(s) 地址。走 npm 名
安装更"干净"：tarball 方式会把一个非 registry 的 URL 记进 lockfile，之后再用
默认 registry 做别的包操作时，pnpm 可能报 ERR_PNPM_TARBALL_URL_MISMATCH。
安装后
- 入口有三处：会话头部按钮、新建会话行、左侧栏底部动作。
- 工作台是右侧栏的原生 tab，可以和聊天并排；在
F11 全屏与停靠之间切换。
- 第一次打开会自动选择当前 DSH 工作区；项目面板头部可切换 IDE 项目根（工作区根或一级子目录）。
快速上手
- 打开工作台：点会话头部的 IDE 图标，或按
Alt+1 直接聚焦 Project。
- 选项目：项目面板头部的下拉选择工作区根或某个一级子目录（含
.git 的子目录带 Git 徽标）。
- 开始工作：双击文件打开；
Ctrl+Shift+R 搜代码、Alt+0 提交、Alt+F12 开终端、Ctrl+K 写提交信息。
常用快捷键
| 动作 | 快捷键 |
|---|
| 切换工具窗 | Alt+1 Project · Alt+0 Commit · Alt+9 Git · Alt+F12 Terminal |
| 聚焦提交消息 / 推送 | Ctrl+K / Ctrl+Shift+K |
| 全项目查找 / 备用键 | Ctrl+Shift+R / Ctrl+Alt+F |
| 快速打开文件 | Ctrl+P 或 Ctrl+Shift+N |
| 全屏 / 停靠 | F11 |
| 隐藏全部工具窗 | Ctrl+Shift+F12 |
| 编辑器内查找 | Ctrl+F、F3 |
| 跳转定义 / 查找用法 | F12 或 Ctrl+点击 · Alt+F7（语义） · Alt+F8（文本） |
| 手动触发补全 | Ctrl+Space |
| 保存 / 关闭标签 | Ctrl+S / Ctrl+W |
| 文件操作 | Alt+Insert 新建 · F2 重命名 · F5 复制 · F6 移动 · Delete 删除 · Ctrl+Alt+Shift+C 复制路径 |
| 提交详情 | Ctrl+Alt+D |
工具窗、提交、推送、查找与快速打开快捷键可在 设置 → IDE 工作台 中重绑；F2 / F5 / F6 / Delete、Ctrl+Alt+D 与 Ctrl+Shift+F12 使用默认值（也可在设置文档中手动修改）。
工作区 vs IDE 项目根
DSH 工作区常常是容器：根本身不是 Git 仓库，一级子目录才是。项目面板头部的项目名下拉可以选择 工作区根 或任一一级子目录；选择会按工作区持久化（projectRoots），切换后 Project 树、Git/Commit 数据、新终端会话的 cwd 与保存的标签状态一并切换。当前目录不是仓库时，四个窗口都会给出“选择 Git 子项目”引导。
代码智能与索引
编辑器自带本地补全（所有语言都能用，不需要任何语言服务器）。再装上语言服务器（TypeScript / JavaScript / Python / YAML 随包提供，Java / Go / Rust / C++ 从 PATH 探测），就多出语义补全、悬停文档、签名帮助、跳转定义与语义查找引用。
- 索引不是磁盘上的文件：它就是语言服务器进程内部构建的类型信息。首次构建可能需要一两分钟，期间可以随时取消；语言服务器空闲十分钟会自动退出省内存，下次打开再重建（通常更快，因为文件还在系统页缓存里）。
- 打开未索引的目录时会先问：可以「构建索引」、只用「保守版」（本地补全 + 文本查找用法），或者取消。工作区根目录通常只是容器、下面有多个独立仓库，在那里索引会明显更慢更占内存，所以会额外警告。
- 内存不够就不启动：可用内存低于阈值时直接降级为保守版，状态栏给出需要的与可用的 MB 数值。
- 状态栏常驻显示语义分析的状态（关闭 / 未安装 / 启动中 / 索引中 / 就绪 / 保守版 / 已崩溃），索引超过一分钟会出现【取消索引】。
- 项目选择器里的 【已索引】 徽标表示“这个目录以前索引过”，不代表磁盘上有索引文件。
语言服务器不会启用 LSP 的重命名与格式化：F2 已经被“重命名文件”占用。
离线安装包不包含打包的语言服务器（体积原因），这类安装请自行把语言服务器装到 PATH 上。
代码索引的内存配置
索引占的内存由语言服务器进程决定，工作台只能估算它。配置分两个独立的数，含义完全不同：
| 数字 | 含义 | 作用 |
|---|
| 上限 | 交给语言服务器的内存天花板 | 给启动前的估算封顶；只有 TypeScript 真的把它传给服务器进程 |
| 估算 | 这类语言服务器的典型占用（不是最坏情况） | 拿它和当前可用内存比，决定能不能启动 |
启动那一刻按 需求 = min(估算, 生效上限) × 余量系数 判定：够用就直接启动；落在「紧张」区间就弹窗问你「仍然启动 / 使用基础模式」；低于硬下限（默认 256 MB）直接降级为基础模式。
配置：设置 → IDE 工作台 → 语义分析（全局上限、保守兜底下限、余量系数、硬下限，以及每个语言各自的上限与开关）；也可以直接编辑 ~/.dsh/ide-workbench/settings.json 的 lsp 段。
三个最容易踩的点：
- 全局上限只能往下调。生效值是
min(该语言的内置上限, 全局上限) —— 全局改成 4096，TypeScript 仍然是 2048。要给某个语言更多，用它自己那一行的上限（按语言的值会替换全局上限，可以更高）。
- 只有 TypeScript 的服务器真的听这个上限（
maxTsServerMemory）。jdtls / gopls / rust-analyzer / clangd / basedpyright 只把它当作估算的封顶，不限制进程本身。
- 估算是典型占用，不是最坏情况。大项目的真实占用远高于估算（TypeScript 要为整个项目建 program），估算只决定「要不要问你要不要启动」，不决定「撑不撑得住」。
大项目上第一次语义请求可能等十分钟以上（实测建 program 可超 10 分钟）：这段时间请求预算给到 10 分钟，所以第一次补全弹窗可能长时间不返回 —— 那是在建索引，状态栏显示「语义分析：索引中…」。
完整说明（生效上限的算法、三道闸门、逐字段配置表、已知局限、排查表）见 docs/prd/v5/代码索引内存配置.md。
与 DSH 的集成
- 入口：会话头部按钮、新建会话行、侧栏底部常驻动作三处均可打开，使用原生
sidebar.right.pane.tab 与聊天并排；皮肤隐藏头部工具时底部入口仍可用。
- 会话连续性：同一 DSH 工作区的会话共享一份工作台状态——切换会话（含新建）保持文件树、打开的标签与 Git 上下文；工作台在被离开的会话中可见时，进入新会话会自动重新打开。切换对话不销毁终端；切换 Session 时终端进程与编辑器撤销栈会重建。
- 聊天文件链接：用户
@ 引用与助手 Markdown 链接默认在工作台打开，展开文件树并定位到 #L24 这样的行号；工作区外的文件自动降级到 DSH 自带侧栏；在工作区内但不在当前 IDE 项目内时，先询问是否把 IDE 项目拓宽到工作区根。设置 → IDE 工作台 → 聊天文件链接可切回始终使用 DSH 侧栏。
- 发送到聊天框：在项目树或编辑器里右键，把一个或多个文件/文件夹、或选中的代码行送进聊天输入框。文件/文件夹以
@路径 形式成为引用；代码行会附带 (L起-L止) 与代码块。
- 预览降级：右键文件或标签 → 在侧栏标签中打开，用 DSH 自带预览查看；HTML 文件右上角提供“在 DSH 侧栏预览”和“用默认浏览器打开”两个浮动动作。
- 主题：仅使用
--dsw-alias-* 令牌，明暗与皮肤完全跟随宿主。
安全与数据
- Git 全部走系统 CLI（argv 数组，绝无 shell 字符串），凭证管理器、hooks 与 git config 原样生效；路径从
status --porcelain=v2 -z、diff --numstat -z 与 log 记录流解析。
- 文件读写经过路径围栏（越界 403），保存原子化并保留原编码与换行符。
- 每个 HTTP / WebSocket 路由都经过与
/api 相同的 Connection 准入围栏。
- 设置持久化在
$DSH_HOME/ide-workbench/settings.json（~/.dsh；宿主导出 DSH_PROFILE_DIR 时使用 profile 目录），含快捷键、Shell、git 路径、打开模式、UI 几何、每工作区展开目录与打开标签。
已知限制
- 项目选择器只扫描工作区一级子目录，不递归发现仓库。
- DSH 重启不恢复终端会话（PTY 随进程结束）。
- 宿主侧条图标不支持数字徽标（徽标绘制在插件自绘的 stripe 上）。
- Markdown 预览暂不把相对图片 / 链接重写为本地路径（http(s) 外链可用）。
- 不做：交互式 rebase、merge 冲突三方编辑、stash、blame、fetch/pull、分屏终端。
- 代码索引的内存：全局上限只是「所有语言的上限」，不能突破某个语言自身的内置上限
（全局改成 4096，TypeScript 仍是 2048）；要调高请用按语言的上限。只有 TypeScript 的
服务器真的按这个上限限制自己，其余语言服务器只把它当作估算的封顶。内存估算是典型
占用，大项目的真实占用远高于它。详见
代码索引的内存配置。
- 大项目上的第一次语义请求可能超过十分钟（建 program 实测耗时），这段时间请求预算
给到 10 分钟；因此第一次补全弹窗可能长时间不返回。
Ctrl+Shift+R 在纯浏览器形态（DSH Web、Chromium 内核浏览器）里是 Chromium 的硬刷新快捷键，网页侧无法拦截 → 会整页刷新、丢失编辑器缓冲区。浏览器形态请用备用键 Ctrl+Alt+F；桌面形态（DSH Desktop）不受影响。- 发送到聊天框依赖宿主向会话槽位发布的聊天输入动作；宿主未提供时会提示“暂时无法写入聊天输入框”，不会静默丢弃。代码行引用以
@文件 (Lx-Ly) + 代码块表达（@ 语法本身没有行号后缀）。
- 编辑器右键菜单只在有选中内容时接管系统菜单（提供“发送到聊天框 / 复制”），空选区保留原生菜单。
开发
npm install
npm run build # 将 src/client 打包为 dist/client.js（React 外置，xterm 内联）
npm test # 宿主 git/diff/graph + 组件 SSR + 客户端回归测试
源码结构：
src/index.js 宿主半边：围栏 HTTP API + 终端 WebSocket
src/host/git.js git CLI 适配器，status/log/numstat 解析
src/host/workspace.js 路径围栏、目录树、文件预览、shell
src/host/fileops.js 新建/重命名/复制/移动/删除（回收站）
src/host/settings-store.js JSON 设置持久化
src/client/index.jsx 客户端入口：侧栏 tab、快捷键、聊天输入桥
src/client/store.js 工作台状态机（项目、标签、搜索、Git、设置）
src/client/*.jsx 工具窗与编辑器 UI
src/client/chat-bridge.js 发送到聊天框：@ 引用与代码块
提交前请重新构建 dist/client.js 并跑完 npm test（当前 324 条测试）。
README 的截图与徽标条存放在 docs/readme/，通过 main 分支的 raw URL 引用——DSH 与 npm 的 Markdown 渲染都不解析相对图片路径，raw URL 同时兼容 GitHub、IDEA 与 Typora。顶部的 badges.svg 把 npm / 许可证 / DSH / 平台合成一张图，因为 DSH 会把独立图片渲染成块级元素，四个单独的徽章会各占一行。截图源文件在 qa-screenshots/（工作区仓库），修改后按 720px 宽导出并更新 docs/readme/。
反馈与许可
截图来自 DSH Desktop 0.2.1（Windows 11，亮色主题）；界面语言跟随 DSH 设置。示例项目为测试用 Git 沙箱。
