Code Studio — DSH Web UI 文件修改监视器 · 代码工作台

A file-change monitor & code editor inside the DeepSeek Harness Web UI. Watch agent edits land as line-by-line diffs in real time, right beside your conversation — then open, edit and save any workspace file without leaving the browser.

在 DeepSeek Harness 的 Web 界面里，实时监视 Agent 对文件的每一次修改：改动落盘的瞬间，逐行 Diff（+ 新增 / − 删除 / ~ 修改）自动浮现在你的会话旁；内置语法高亮编辑器，随时查看和修改工作区文件。不用离开 DSH，Agent 改了哪里、改了什么、想还原就还原。

核心价值

🔭 实时文件修改监视：基于会话工具事件直推，Agent 每次 write / edit 完成立即推送 Diff —— 不依赖文件系统轮询，不漏报、不延迟。
🗂 多工作区覆盖 + 切换器：自动监视所有会话的工作区目录，「文件」页签顶部可随时切换工作区根目录（按会话记忆）。
🔒 按会话隔离：每个 Code Studio 只响应当前会话的修改，切换会话互不干扰；未查看变更数徽标按会话分别计数。
🧠 会话状态记忆：变更列表、打开的标签、面板宽度、过滤条件、工作区选择按会话分别保留（本地持久化）。
↩️ 一键还原（Revert）：每个变更条目带「还原」按钮 —— 撤销 Agent 在本会话内对该文件的全部修改（还原点取自 Agent 首次写入前的内容快照；新建文件还原为删除；检测到外部修改会提示冲突）。
🕘 修改历史时间线：每个文件的 Agent / 用户 / 还原事件按时间倒序回放，任意版本可展开查看 Diff。
💬 发送到会话：把当前打开的文件内容一键发给当前会话的 Agent（不可用时自动退化为复制到剪贴板）。
📝 语法高亮编辑器：类编辑器体验，行号、光标、滚动同步；Ctrl+S 保存，Ctrl+D 查看 Diff。
⚡ 大文件虚拟滚动 + 增量渲染：Diff 视图窗口化渲染 + 差异过大截断提示；变更统计按事件序号缓存，重复渲染不再重算 Diff（见 v0.2.16 实测）。
🔁 SSE 断线自愈：事件带序号 + 服务端环形缓冲，断线重连自动补发丢失的变更（Last-Event-ID）。
🔍 变更过滤搜索：按路径关键词 + 文件类型（代码/文档/配置/其他）过滤变更列表。
⌨️ 键盘快捷键：Ctrl+Alt+C 开关面板，Alt+↓/↑ 在变更之间跳转。
📐 可拖拽面板：宽度自由调整并记住；UI 与 DSH 主题完全一致（--dsw-alias-* 令牌）。

安装

dsh plugin --profile web add @windypro-rourou/dsh-code-studio
# 或使用 GitHub 源
dsh plugin --profile web add github:WindyPro-rourou/dsh-code-studio

重启 dsh web 后，左侧边栏出现 Code Studio 入口。

兼容性

验证版本：DSH 0.2.0-rc.2（含 0.2 桌面端），并向下兼容 DSH ≥ 0.1.1-rc.2。
依赖的 API：webServer.register、session/event（tool/call / tool/result）、sessions.list()、客户端 slots（shell.overlay + conversation.session.header.utilities）—— 在 0.2 中均保持兼容。
0.2 插件兼容性预检：0.2 会拒绝 peerDependencies 中 @deepseek-ai/dsh-* 不满足当前运行时版本、且未在 profiles/<profile>/compatibility.json 里逐条“接受风险”的插件。本插件不再声明 0.1 时代的 @deepseek-ai/dsh-client-runtime / dsh-client-connection（0.2 已不存在这两个包），因此无需任何风险豁免即可加载。

0.2 桌面端适配（v0.2.9 → v0.2.12）

面板形态：保持覆盖型浮层侧栏（shell.overlay，浮在对话右缘、拖左缘调宽、✕ 关闭、Ctrl+Alt+C 开关）—— 与 0.1.x 完全一致。0.2 的 sidebar.right.pane.tab 会把面板变成右栏页签（桌面端上还会另开一个面板窗口），已经试过并回退（见 v0.2.12）。
变更引擎与 UI 解耦：面板实例挂在 shell.overlay；SSE 变更流由 startChangeFeed() 引用计数共享，面板关闭时事件流照跑，头部胶囊照常计数。
工作区按会话解析 + 随盘适配：/root、/tree、/workspaces 从当前会话的 header.cwd 解析（0.2 的项目目录绑定在会话上），并套用便携版的「同盘换盘符」规则（launcher/fix-workspace-paths.mjs 的 mapPath()），换盘符后工作区文件照样显示；会话目录彻底不存在时回退到最新存在的索引工作区并在界面说明。
0.2 桌面端是 data-windows-titlebar 布局，左侧栏入口仍用原有的 DOM 注入方式（与 Logcat / 嘉立创 EDA 一致，实测工作正常）。

使用

打开 Code Studio：对话头部（会话标题右侧工具栏，和宿主的「打开方式」按钮同一排）常驻一枚变更胶囊 —— 显示当前会话 N 个文件已变更 +A −D，点主体开关右侧面板、点 ⌄ 展开变更文件清单并直接跳到某个文件的 Diff；也可用侧边栏入口或 Ctrl+Alt+C。面板可拖左缘调宽。
让 Agent 修改代码 —— 面板自动浮现该文件的逐行 Diff：行号前 +（绿）/ −（红）/ ~（黄），未改动大段自动折叠；面板关闭时侧边栏入口显示未查看变更数徽标。
对不满意的修改点「还原」，一键回到 Agent 动手前；点「历史」回放该文件的每一次改动。
「文件」页签：切换工作区、浏览文件树、打开文件直接编辑保存（Ctrl+S），或「发送到会话」让 Agent 接着改。
变更多了？顶部搜索框 + 类型筛选快速定位；Alt+↓/↑ 在变更间跳转。

技术说明

Host（lib/index.js）：监听 session/event 工具事件（tool/call ↔ tool/result 配对），在 tool/call 阶段抓取还原点快照、在 tool/result 阶段即时读取并推送 before/after；递归文件监视 + mtime 轮询兜底；SSE 事件带自增 id 并保留 200 条环形缓冲用于 Last-Event-ID 断线补发；/api/code-studio/* REST + SSE（含 /revert、/workspaces、/history）。
Client（lib/client.js）：浏览器 bundle，仅依赖 react；LCS 行级 Diff 引擎（大文件自动退化贪心算法）、窗口化虚拟滚动、语法高亮、按会话状态管理、未读徽标。UI 走宿主设计系统 —— 优先复用宿主暴露的 @deepseek-ai/dsh-client-ui-primitives（Button / Pill / Menu / Tooltip / 图标）并统一使用 --dsw-alias-*、--dsh-scrollbar-* 主题变量；该 UI 包不可用时自动降级为内置 token 化标记，功能不受影响。
自测：node scripts/selftest.mjs（host 逻辑 26 项断言）、node scripts/apply-toolargs.mjs（工具参数回归）、node scripts/smoke-client.mjs（浏览器 bundle 冒烟 + 头部胶囊插槽断言）。

已知限制

单文件 > 512KB 不读取内容（防浏览器卡顿）；>100KB 的历史事件内容会截断保存（SSE 推送仍为全量）。
编辑器对 >3000 行的文件关闭语法着色（纯文本显示，文件栏会标注），以保证按键时的编辑流畅度。
通过 bash/pwsh 等非文件工具写入的变更依赖文件监视兜底（仍会捕获，可能有少量延迟），且仅显示 Agent 声明过的文件。
还原点保存在内存中，服务重启后丢失（新会话的 Agent 修改会重新建立还原点）。

v0.2.18 — 逐项审计：修 21 处缺陷，宿主热路径快 330 倍

这一版没有新功能，只做一件事：把插件从头到尾审一遍，把能找到的真实缺陷全修掉，每一项都配测试。21 处 = 宿主 4 + 语法高亮 2 + 词级 Diff 3 + 客户端 12。

宿主端（`lib/index.js`）

每个 session 事件都在同步读写文件系统（最严重）：apply() 订阅了 session/event，而该事件在流式输出时每来一段就触发一次；处理函数里每次都调用 pathExists + realpathSync 去解析该会话的项目目录。实测 260 µs/事件——按 50 事件/秒算，主线程每秒被阻塞 13 ms。现在按"已解析过的路径"记忆化，未命中的路径最多每 5 秒重探一次（配置项 rootRecheckMs）。实测 0.79 µs/事件（330×），2000 个事件从 520 ms 降到 1.6 ms。
写文件不建父目录：保存到一个尚不存在的子目录会直接失败。现在先 mkdir -p。
历史截断把标记塞进了内容里：超 100KB 的历史版本会被拼上 …[history 截断]，于是这段标记本身变成了"一行改动"，历史 Diff 里出现一行根本不存在的文本。改为按大小截断 + truncated: true 标记，由界面说明"仅保存前 100KB"。
超限请求体被报成 invalid-body：现在区分 413 body-too-large 与 400 invalid-body；readBody 也不再假设 req.destroy 一定存在。

语法高亮（两个死代码 bug）

CSS 的十六进制颜色整行被当成注释：正则里 #[^\n]*（注释）排在十六进制颜色之前，于是 color: #fff; 从 # 开始全部标成注释，颜色分支永远走不到。现在按语言分两套正则：# 注释型（py/sh/yml/…）与颜色型（js/css/html/…）。
函数名高亮从未生效：判定写的是 tok.endsWith("(")，但标识符正则并不吃括号，所以这个分支永远为假。改为看标识符后面是否紧跟 (（允许空格）。

词级 Diff

默认（折叠）视图里没有词级高亮：buildBlocks 给每个改动行单独开一个块，于是"修改"的旧行/新行被拆到两个块里，永远配不成对——只有点开省略行（展开模式）才看得到。现在把连续的改动行归入同一块，两种布局都有词级高亮，块数也从 4000 降到个位数。
词级高亮会吃掉语法着色：词级分支原本用裸 seg() 渲染，整行失去颜色。新增 markedLine()：先分词，再按命中区间切分 token，标记嵌在着色 token 内部——颜色和词级标记兼得。
一处改两个词时，中间的词也被标成改动：wordSeg 只做首尾裁剪。改为对词做真正的 LCS，只标真正变化的词；纯空白永远不标（高亮一个空格是噪音）。

客户端

Esc 层级：原来在帮助浮层或查找栏打开时按 Esc 会把整个面板关掉。现在逐层退出（帮助 → 聚焦中的输入框 → 面板）。
快捷键作用域：面板关闭时 ? 会切换看不见的帮助状态、Alt+↑/↓ 也被吞掉。现在除 Ctrl+Alt+C 外都只在面板打开时生效。
会话状态保存不全：快照里存了页签/宽度/筛选/工作区，但保存 effect 的依赖只列了 4 项——只改页签或拖宽度不会触发保存，刷新即丢。依赖已补齐。
把整个文件塞进 localStorage：编辑器缓冲随快照一起持久化，一个 500KB 文件就能吃掉配额（而写入失败是静默的）。超过 64KB 只记住"打开位置"，恢复时从磁盘重读。
可访问性：页签、变更行、文件树节点原本都是不可聚焦的 div（纯鼠标操作）。现在分别是 button[role=tab]、button.cs-chg-main、button.cs-node；帮助浮层为 role=dialog aria-modal；连接状态 aria-live；输入框、开关按钮、复选框都有 aria-label；aria-expanded/aria-pressed 正确反映状态。
重复保存：连按 Ctrl+S 会并发写同一个缓冲，现在有在途保护。
撤销粒度：原来每次按键都压栈，Ctrl+Z 一次退一个字符。现在 400ms 内的连打合并为一步。
其它：viewDiff 补上 50 条上限；"发送到会话"超过 200KB 截断并说明；拖拽宽度同时写入 cs.panelWidth；文件树加"刷新"按钮（目录缓存导致新建文件不出现）；文件读取失败给出中文说明（含 512KB 上限）。

测试

新增 client-units.mjs（分词器 / 持久化裁剪 / Esc 层级 / 快捷键作用域）、worddiff-test.mjs（词级标记的位置——渲染签名测试只能看文本，看不到标记落在哪个词上）、perf-host.mjs（宿主每事件成本基准）。selftest 增加 7 项（建父目录、两种 413、根目录记忆化但不永久缓存负面结果）。三个新测试同样做了变异检验：调换 wordSeg 参数、标记空白、去掉词级 Diff、把负缓存改成永久缓存，都会报错。

v0.2.17 — 修复 3 个真实 bug + 视图层窗口化

问题（先测量再动手）：v0.2.16 解决了"每次渲染重算 Diff"，但两个视图仍在全量物化：

Diff 视图为 302 个 DOM 节点创建了 40159 个元素——先把整个差异（最多 3 万行）造成 React 元素，再 slice 出可见的 30 行。
编辑器为 5000 行文件建了 15044 个 DOM 节点（行号列 + 高亮层各一份），每次按键全量重建——这是打字卡顿的主因。

实测（node scripts/perf-view.mjs 5000 4000，同一 harness 跑改动前 / 后）：

视图	指标	改动前	改动后
编辑器 5000 行	元素 / DOM 节点	20046 / 15044	528 / 406
编辑器 5000 行	重渲染	10.1 ms	1.5 ms
Diff 4000 行	元素 / DOM 节点	40159 / 302	339 / 302
Diff 4000 行	重渲染	14.5 ms	2.3 ms

Diff 只物化可见窗口：行布局改成"区段表"（每块贡献几行、从第几行开始），用二分查找定位；每个 op 恰好占一行，所以任意一行都能单独渲染。所有行等高（18px），spacer 顶住滚动高度，输出与旧实现逐节点一致。
编辑器只物化可见窗口：行号列与高亮层各自用上下 spacer 撑住全文高度，滚动时按 requestAnimationFrame 之外的自然事件重算窗口（窗口没变就不 setState），文本区与高亮层仍由原生 scrollTop 对齐。

修复的 3 个 bug（都写了驱动真实事件流的回归测试）：

新建文件的基线被覆盖：existing.before === null 时回退到事件自带的 before，于是本会话新建的文件在第二次写入后变成"普通修改"——"新建"标记消失，且「还原」会把文件恢复成中间版本而不是删除。改为保留首次基线（含 null）。
Agent 改动会抢走页签：SSE 每来一条事件都对所有订阅者触发 reveal，面板因此 setTab("changes") 并重置展开项——你正在编辑文件时会被踢回变更列表，正在看的 diff 也会被折叠。现在区分用户深链（点头部菜单，仍然切页签）与自动揭示（仅在"已在变更页签且没有手动展开任何文件"时填充）。
每条事件都多一次全量重渲染：SSE 每帧都会重申 ok/已连接，setConn 无条件 emitFeed()。现在状态与文案都没变就不通知。

回归保证（4 个新测试，全部做了变异检验）：

scripts/render-equivalence.mjs：从 git 取出旧版 bundle，与工作副本在同一 harness下渲染同一场景，逐节点比较渲染树 —— 10 个场景 × 2 种布局（折叠 / 展开）× 4 个滚动位置，共 80 次渲染、998 行 Diff、60 个词级标记。它自己也被变异检验过：把 wordSeg 参数顺序调换、spacer 高度改错、窗口起点偏移、区段查找 off-by-one，4 个变异全部报错。
scripts/editor-window.mjs：断言行号连续、两层 spacer 高度之和精确等于全文高度（5000 × 18.6px）、窗口内文本与内容对位、宿主节点数有界；去掉底部 spacer 会被抓出。
scripts/feed-behavior.mjs：用假 EventSource 真的推两条事件，断言新建文件基线保持 null；断言自动揭示不改页签而用户深链会；断言重复的 setConn 不产生通知。三个 bug 各自回退都会被抓出。
scripts/smoke-client.mjs 追加 10 条结构断言（窗口化必须存在、全量物化器不得复活、编辑器不得再全量渲染行号）。

诚实说明：render-equivalence.mjs 第一版是假通过的——它在展开函数组件时没有重置 hook 上下文，导致 DiffRows 的状态注入全部失效，"2 种布局 × 5 个滚动位置"其实是同一份折叠视图跑了 10 遍，也因此放过了 wordSeg 参数错位这个真 bug。现在测试会在没有任何词级标记时直接失败，避免再次在盲区上报告全绿。

v0.2.16 — 性能与交互优化（有实测数据）

问题：面板每次渲染都会重新做一遍全量行级 Diff。fileStats() 走的是 O(n·m) 的 LCS 动态规划，却被三类地方在每次 render 里各调一次：筛选行的 +N/−M 汇总、变更行的每行统计、以及"按增删排序"的比较器（比较器里每次比较都调两次）。结果是：改一个筛选框字符、拖一次面板宽度、来一条 SSE 事件，都要把整个变更集重算一遍。

实测（node scripts/perf-panel.mjs 400 120，同一套 harness 跑改动前 / 改动后；"diffs" = 该次渲染真正执行的行级 Diff 次数）：

指标（400 文件 · 每个 120 行）	改动前	改动后
增量渲染中位数	270.7 ms	2.0 ms
单次重渲染的 diff 次数	800	0
按增删排序后重渲染	807.8 ms / 2396 diffs	3.4 ms / 0 diffs
首屏渲染（含一次全量统计）	395.6 ms / 800 diffs	78.3 ms / 400 diffs
单次全量统计（局部改动场景）	173.0 ms（0.43 ms/文件）	69.2 ms（0.17 ms/文件）

Diff 首尾裁剪：lineDiff 先剥掉两侧完全相同的公共头/尾再跑 DP。公共前后缀必然属于某个 LCS，所以对齐质量不变，只是把矩阵从 O(n·m) 缩到 O(k·k)（k = 真正改动的行数）。3000 行文件改中间 12 行：0.4–0.6 ms 得到精确最小差异，而旧实现在这个规模会退化成贪婪对齐（非最小）。
统计缓存：每条 SSE 事件带单调 seq，于是 (路径, seq) 唯一确定内容 —— 按它缓存每文件的 +N/−M。重渲染从"每文件一次 Diff"变成"每行一次 Map 查询"；600+ 条上限后整体清空，长会话不会无限增长。
排序去重：按增删排序改为先装饰一次权重再排序，从 O(n log n) 次 Diff 降为 O(n) 次。
渲染只算一次：汇总与每行统计共用同一份 shownStats（原来同一次渲染里算两遍）。
拖拽合帧：面板宽度拖拽原是每个 pointer 事件触发一次全列表重渲染，现按 requestAnimationFrame 合并为一帧一次。
编辑器大文件保护：超过 3000 行自动关闭语法着色（纯文本显示，文件栏标注"纯文本"），逐行 tokenize 在每次按键都会跑满整个文件，这是编辑大文件卡顿的主因；Diff 视图的窗口化渲染保持不变。
交互细节：打开行的 2px 强调竖轨（与文件树/ Diff 行同一语言，长列表滚动后仍知道在看哪个文件）、行内 +N/−M 固定宽度 + 等宽数字（数字变化时操作按钮不再左右跳动）、Diff 行 hover 不再抹掉语义底色（未改动行才用中性底色，改动行改为提升文字对比度）、列表与 Diff 区加 overscroll-behavior:contain（滚到底不再带动背后的会话滚动）、scrollbar-gutter:stable（滚动条出现时列表不横跳）、.cs-chg 加 contain:layout style。
回归保证：新增 scripts/difftest.mjs（属性测试）—— 4000+ 随机小样本 + 边界形状 + 大型真实改动，断言 操作列表能精确还原两版内容、行号连续正确、adds/dels 计数与旧实现完全一致（允许"同样最小但另一个"的对齐，因重复行处的并列选择本就任意），并断言 fileStats 与旧计数一致；scripts/perf-panel.mjs 则改成确定性 CI 门禁（不看耗时，只看 diff 次数：全量统计必须恰好每文件一次、任何重渲染必须为 0），smoke 另加 12 条结构断言（含一条真实的 React hooks 顺序测试：plain 开关不得改变 Highlighted 的 hook 数量）。

v0.2.15 — 极简化重绘（minimalist-ui 技能）

设计判读：把 v0.2.14 的"精密仪表"再往**极简编辑风（Premium Utilitarian Minimalism）**推一格。技能原生语境是浅色文档界面，此处为深色工具面板，故只迁移其可迁移规则：阴影≈0（1px 发丝线负责分隔）、色彩极度稀缺（只剩语义）、幽灵按钮 + 单一实心 CTA、4/8px 圆角锁、kbd 微组件、"看不见的"动效（cubic-bezier(0.16,1,0.3,1)，:active 缩放）。

顶栏合并：标题 + 分段页签 + ✕ 同住一条栏（省一整条 bar）；去掉品牌圆点与"就绪/N 变更"胶囊。
删汇总条：+N/−M 与"N 个文件"并进筛选行右侧元信息（再省一条 bar，垂直空间全部让给 Diff 列表）。
状态栏降噪：只留连接点 + 连接文案 + kbd 快捷键 + ?；"变更 N 文件 / 会话号 / 就绪"全部撤下（别处已有）。
表面归零：面板阴影移除（只留 1px 左缘发丝线）、去光晕环、空态图标去框、帮助浮层去高斯模糊。
按钮幽灵化：全部无边框（hover 才现底色），仅"保存"实心；圆角锁收紧为 4/8px（药丸只保留给语义圆点/未读徽标）。
色彩再校准：Diff 底色浓度下调（9/8/8%），竖轨改 70% 透明度；语法高亮整体再压一度。
回归保证：smoke 新增 10 条结构性断言（页签必须住在顶栏、汇总条不得复活、面板不得出现 box-shadow、按钮必须无边框、圆角锁与动效曲线不得丢失等），加上原有设计钩子与文案规则断言。

v0.2.14 — UI 全面重绘（design-taste 技能）

设计判读：这是对开发者工具面板（变更流 + 行级 Diff + 迷你编辑器）的保真式重绘，受众是长期在深色 IDE 外壳里的开发者，语言取「精密仪表」而非着陆页美学。技能 Section 13 明确把「代码编辑器 / 密集产品 UI」列为不适用，因此只取其中适用项：字体层级、间距节奏、色彩校准、状态工艺、动效克制。 Dials：DESIGN_VARIANCE 4（工具面板要层级不要混乱）/ MOTION_INTENSITY 3（140–180ms，自带 reduced-motion 开关）/ VISUAL_DENSITY 6（diff 天生密集，但重排节奏）。

设计令牌：样式表顶部建立本地令牌层（--cs-accent/--cs-line/--cs-ink1-4/--cs-s1-2/--cs-recess/--cs-ok|warn|err/--cs-row/--cs-ease），全部以宿主 --dsw-alias-* 为源、并带兜底值 —— 无宿主令牌时也能独立渲染。单一强调色（宿主品牌色），状态色去饱和。
形状锁：圆角只用 6 / 10 / full 三档（控件 / 容器 / 药丸与圆点），全表一致；阴影只留面板一层，且带蓝黑底色而非纯黑。
变更列表重排：行从「卡片套卡片」改为扁平行 + 发丝分隔（提升密度与档次）；增量数字改 tabular-nums、为 0 时不显示噪声 −0；行内操作收成 3 个 22px 图标按钮（✓ 已审 / ↩ 还原 / ◷ 历史，hover 浮现），把文件名从「client.…」抢救回来。
Diff 视图：18px 行高（--cs-row 与虚拟滚动的 ROW_H 同步）、按语义色给出左侧竖轨、行号 tabular-nums、单词级高亮改为色块（去掉删除线的噪音）。
编辑器：文件条拆成路径条 + 工具栏两行（原先 7 个按钮把路径挤成 0 宽）、未保存状态变成 chip；查找栏、语法高亮配色统一到低饱和调色板。
状态工艺：新增组合式空态（图标 + 标题 + 提示 + kbd 芯片）、骨架屏（编辑器/读取中）、错误态（内联说明）；Esc 关面板、忙碌状态点脉冲；工具栏/底栏补齐 hover / active / focus-visible 三态与 WCAG AA 对比。
图标：面板无构建步骤、无图标依赖，故仅有的几个字形按同一 16px / 1.5px 描边网格手绘（并在样式表里注释说明这是诚实降级）；替换掉原先的文件树 emoji。
副产物：node scripts/preview-ui.mjs 用极简 React shim + 真实组件把面板渲染成静态 HTML（写入 preview/，已 gitignore），配合无头 Edge 截图即可离线评审 UI。三个自测脚本全绿：host 46 项断言 + 客户端冒烟（新增"样式系统钩子不得丢失""文案不得含 em-dash/emoji"断言）。

v0.2.13 — 适配便携版「随盘」特性

同盘换盘符改写：DSH 把工作区路径绝对存进会话头与 storages/workspace.json，而整个便携包可以换盘符。现在插件的 /root、/tree、/workspaces 与会话监听都走 mapPortablePath() —— 与 launcher/fix-workspace-paths.mjs 完全同一条规则：路径存在就用原路径；否则把同样的路径（去掉盘符）重新锚到 DSH 自己所在盘（DSH_HOME 的盘符），且只有那个目录真的存在时才改。
工作区索引接入：/workspaces 合并 DSH 自己的便携索引 storages/workspace.json（按 updatedAt 新的在前，含"目录不存在"标记），所以换盘后不会只剩一个空目录。
会话目录彻底不存在时兜底：记录指向别的电脑/已删除目录的会话，不再给你一个空树 —— 自动回退到最新的、真实存在的工作区，并在界面上说明（/root 返回 recorded / remapped / sessionMissing / exists）。
界面提示：「文件」页签顶部会显示「随盘：盘符已改变，路径按同盘规则改写到 …（记录的是 …）」，或「该会话记录的项目目录不存在，已回退到 …；换盘符后请运行「整理工作区分组.cmd」」，工作区下拉里不存在的目录也会标注。
实测（本机 130 份会话头 / 22 条工作区索引）：当前盘符已是 F:，改写成 no-op（正确）；9 份属于别的电脑的会话如实标注、绝不臆造路径。

v0.2.12 — 回退：面板仍是覆盖型浮层侧栏

回退 v0.2.9~v0.2.11 的插槽改造：面板重新挂回 shell.overlay（浮在对话右缘的覆盖型侧栏，拖左缘调宽、✕ 关闭），左侧栏入口恢复原有的 DOM 注入 —— 与 0.1.x 一致。
原因：0.2 的 sidebar.right.pane.tab / main 会把它变成右栏页签或中央面板（桌面端上还会另开一个面板窗口），都不是这个面板该有的形态。
保留：包声明适配（去掉 0.2 已不存在的 peer / dsh.client.inject，无需风险豁免）、工作区按会话解析、✕ 关闭按钮、引用计数共享的 SSE 变更流、窄宽度下自适应的状态栏、切会话重解析工作区。
修「关不掉」：0.2 桌面端（Windows）把窗口标题栏画成页面里的固定层，而 shell.overlay 是 inset:0 的绝对层（连 data-windows-titlebar 那 40px 标题栏带一起覆盖）—— 面板顶行正好压在窗口控制按钮底下，✕ 被挡住点不到（窗口越窄越明显，看起来甚至像"面板跑到独立窗口里了"）。现在面板在标题栏模式下按宿主自己的 --dsh-windows-titlebar-height 让到标题栏下方，✕ 也提到上层；并且 Esc 随时关闭面板（✕ / Ctrl+Alt+C / 头部胶囊同样有效）。

v0.2.11 — 右侧边栏页签（已回退，见 v0.2.12）

改成官方右侧边栏页签（和「文件 / 终端 / 浏览器」同一种面板）：注册页签类型（ctx.sidebarRightTabs.register({ id, kind, title })）+ sidebar.right.pane.tab 主体 + sidebar.right.pane.tab.title 标题芯片；不再注册左侧 sidebar.panellist 入口，也不再占用中央 main 面板。
打开/隐藏走宿主自己的机制：头部胶囊 / Ctrl+Alt+C → ctx.sidebarRight.openTab("code-studio")（自动展开列），面板里的 ✕ 隐藏侧边栏 → ctx.layout.closeRightbar() —— 与对话头部那个右侧栏按钮同一条路径，另有宿主自带的收起按钮可用。
变更引擎与面板解耦：面板本体渲染在页签里，shell.overlay 只挂一个无界面 feed 入口（引用计数共享同一个 SSE 流）—— 页签关闭时头部胶囊照样计数，两者也不再有挂载顺序耦合。

v0.2.10 — 工作区按会话解析 · 面板隐藏按钮

修 bug（0.2 桌面端）：「文件」页签的工作区曾经取宿主进程的 cwd —— 在桌面端就是应用自己的 profile 目录（…\profiles\desktop，里面只有 compatibility.json / cordis.yml）。0.2 的项目目录是按会话（工作区）绑定的：现在 /root、/tree、/workspaces 都从当前会话的 header.cwd 解析（优先级 config.root → DSH_WORKSPACE → 当前会话目录 → 进程 cwd），客户端切会话时自动重解析，工作区下拉也会列出各活动会话的项目目录。
修 bug：宿主面板形态下补回 ✕ 隐藏按钮（点击 = layout.selectPanel(null) 回到对话；Ctrl+Alt+C 同效）。

v0.2.9 — 0.2 桌面端适配（官方插槽 + 兼容性预检）

侧边栏入口从 DOM 注入改为官方 sidebar.panellist 插槽；新增 main 键位面板，点侧边栏行切到 Code Studio 中央面板（0.1.x 自动回退浮层模式）。
面板实例常驻 shell.overlay，UI 用 portal 进宿主容器 —— 未选中时变更流仍在跑。
包声明去掉 0.2 已不存在的 @deepseek-ai/dsh-client-runtime / dsh-client-connection peer 与 dsh.client.inject，0.2 无需风险豁免即可加载。
0.2 下不再自动抢占中央面板；未查看变更用头部胶囊圆点 + 侧边栏行圆点提示。

v0.2.8 — 头部变更胶囊 · DSH 设计系统

变更提示从右下角浮窗（会压住输入框/发送工具条）迁移到对话头部工具栏：新增 conversation.session.header.utilities 插槽胶囊，N 个文件已变更 +A −D，主体开关面板、⌄ 打开变更文件清单（点选直达该文件 Diff）。
面板关闭时不再渲染任何浮动元素；未读变更靠头部胶囊圆点 + 侧边栏徽标表达。
UI 全面对齐 DSH 设计系统：复用宿主 UI 组件库、统一主题变量、宿主同款滚动条/焦点环/过渡。

v0.2.3 — 交互增强

行内单词级 Diff 高亮 + 变更上下文行 + 变更统计总览
Diff 一键跳转到编辑器对应行；批量还原/清除；标记已审阅
编辑器撤销/重做、退出未保存提醒、查找替换
变更列表排序（最新/名称/改动量）、快捷键帮助弹层

Code Studio — DSH Web UI 文件修改监视器 · 代码工作台

A file-change monitor & code editor inside the DeepSeek Harness Web UI. Watch agent edits land as line-by-line diffs in real time, right beside your conversation — then open, edit and save any workspace file without leaving the browser.

核心价值

🔭 实时文件修改监视：基于会话工具事件直推，Agent 每次 write / edit 完成立即推送 Diff —— 不依赖文件系统轮询，不漏报、不延迟。
🗂 多工作区覆盖 + 切换器：自动监视所有会话的工作区目录，「文件」页签顶部可随时切换工作区根目录（按会话记忆）。
🔒 按会话隔离：每个 Code Studio 只响应当前会话的修改，切换会话互不干扰；未查看变更数徽标按会话分别计数。
🧠 会话状态记忆：变更列表、打开的标签、面板宽度、过滤条件、工作区选择按会话分别保留（本地持久化）。
↩️ 一键还原（Revert）：每个变更条目带「还原」按钮 —— 撤销 Agent 在本会话内对该文件的全部修改（还原点取自 Agent 首次写入前的内容快照；新建文件还原为删除；检测到外部修改会提示冲突）。
🕘 修改历史时间线：每个文件的 Agent / 用户 / 还原事件按时间倒序回放，任意版本可展开查看 Diff。
💬 发送到会话：把当前打开的文件内容一键发给当前会话的 Agent（不可用时自动退化为复制到剪贴板）。
📝 语法高亮编辑器：类编辑器体验，行号、光标、滚动同步；Ctrl+S 保存，Ctrl+D 查看 Diff。
⚡ 大文件虚拟滚动 + 增量渲染：Diff 视图窗口化渲染 + 差异过大截断提示；变更统计按事件序号缓存，重复渲染不再重算 Diff（见 v0.2.16 实测）。
🔁 SSE 断线自愈：事件带序号 + 服务端环形缓冲，断线重连自动补发丢失的变更（Last-Event-ID）。
🔍 变更过滤搜索：按路径关键词 + 文件类型（代码/文档/配置/其他）过滤变更列表。
⌨️ 键盘快捷键：Ctrl+Alt+C 开关面板，Alt+↓/↑ 在变更之间跳转。
📐 可拖拽面板：宽度自由调整并记住；UI 与 DSH 主题完全一致（--dsw-alias-* 令牌）。

安装

dsh plugin --profile web add @windypro-rourou/dsh-code-studio
# 或使用 GitHub 源
dsh plugin --profile web add github:WindyPro-rourou/dsh-code-studio

重启 dsh web 后，左侧边栏出现 Code Studio 入口。

兼容性

验证版本：DSH 0.2.0-rc.2（含 0.2 桌面端），并向下兼容 DSH ≥ 0.1.1-rc.2。
依赖的 API：webServer.register、session/event（tool/call / tool/result）、sessions.list()、客户端 slots（shell.overlay + conversation.session.header.utilities）—— 在 0.2 中均保持兼容。
0.2 插件兼容性预检：0.2 会拒绝 peerDependencies 中 @deepseek-ai/dsh-* 不满足当前运行时版本、且未在 profiles/<profile>/compatibility.json 里逐条“接受风险”的插件。本插件不再声明 0.1 时代的 @deepseek-ai/dsh-client-runtime / dsh-client-connection（0.2 已不存在这两个包），因此无需任何风险豁免即可加载。

0.2 桌面端适配（v0.2.9 → v0.2.12）

面板形态：保持覆盖型浮层侧栏（shell.overlay，浮在对话右缘、拖左缘调宽、✕ 关闭、Ctrl+Alt+C 开关）—— 与 0.1.x 完全一致。0.2 的 sidebar.right.pane.tab 会把面板变成右栏页签（桌面端上还会另开一个面板窗口），已经试过并回退（见 v0.2.12）。
变更引擎与 UI 解耦：面板实例挂在 shell.overlay；SSE 变更流由 startChangeFeed() 引用计数共享，面板关闭时事件流照跑，头部胶囊照常计数。
工作区按会话解析 + 随盘适配：/root、/tree、/workspaces 从当前会话的 header.cwd 解析（0.2 的项目目录绑定在会话上），并套用便携版的「同盘换盘符」规则（launcher/fix-workspace-paths.mjs 的 mapPath()），换盘符后工作区文件照样显示；会话目录彻底不存在时回退到最新存在的索引工作区并在界面说明。
0.2 桌面端是 data-windows-titlebar 布局，左侧栏入口仍用原有的 DOM 注入方式（与 Logcat / 嘉立创 EDA 一致，实测工作正常）。

使用

打开 Code Studio：对话头部（会话标题右侧工具栏，和宿主的「打开方式」按钮同一排）常驻一枚变更胶囊 —— 显示当前会话 N 个文件已变更 +A −D，点主体开关右侧面板、点 ⌄ 展开变更文件清单并直接跳到某个文件的 Diff；也可用侧边栏入口或 Ctrl+Alt+C。面板可拖左缘调宽。
让 Agent 修改代码 —— 面板自动浮现该文件的逐行 Diff：行号前 +（绿）/ −（红）/ ~（黄），未改动大段自动折叠；面板关闭时侧边栏入口显示未查看变更数徽标。
对不满意的修改点「还原」，一键回到 Agent 动手前；点「历史」回放该文件的每一次改动。
「文件」页签：切换工作区、浏览文件树、打开文件直接编辑保存（Ctrl+S），或「发送到会话」让 Agent 接着改。
变更多了？顶部搜索框 + 类型筛选快速定位；Alt+↓/↑ 在变更间跳转。

技术说明

Host（lib/index.js）：监听 session/event 工具事件（tool/call ↔ tool/result 配对），在 tool/call 阶段抓取还原点快照、在 tool/result 阶段即时读取并推送 before/after；递归文件监视 + mtime 轮询兜底；SSE 事件带自增 id 并保留 200 条环形缓冲用于 Last-Event-ID 断线补发；/api/code-studio/* REST + SSE（含 /revert、/workspaces、/history）。
Client（lib/client.js）：浏览器 bundle，仅依赖 react；LCS 行级 Diff 引擎（大文件自动退化贪心算法）、窗口化虚拟滚动、语法高亮、按会话状态管理、未读徽标。UI 走宿主设计系统 —— 优先复用宿主暴露的 @deepseek-ai/dsh-client-ui-primitives（Button / Pill / Menu / Tooltip / 图标）并统一使用 --dsw-alias-*、--dsh-scrollbar-* 主题变量；该 UI 包不可用时自动降级为内置 token 化标记，功能不受影响。
自测：node scripts/selftest.mjs（host 逻辑 26 项断言）、node scripts/apply-toolargs.mjs（工具参数回归）、node scripts/smoke-client.mjs（浏览器 bundle 冒烟 + 头部胶囊插槽断言）。

已知限制

单文件 > 512KB 不读取内容（防浏览器卡顿）；>100KB 的历史事件内容会截断保存（SSE 推送仍为全量）。
编辑器对 >3000 行的文件关闭语法着色（纯文本显示，文件栏会标注），以保证按键时的编辑流畅度。
通过 bash/pwsh 等非文件工具写入的变更依赖文件监视兜底（仍会捕获，可能有少量延迟），且仅显示 Agent 声明过的文件。
还原点保存在内存中，服务重启后丢失（新会话的 Agent 修改会重新建立还原点）。

v0.2.18 — 逐项审计：修 21 处缺陷，宿主热路径快 330 倍

宿主端（`lib/index.js`）

每个 session 事件都在同步读写文件系统（最严重）：apply() 订阅了 session/event，而该事件在流式输出时每来一段就触发一次；处理函数里每次都调用 pathExists + realpathSync 去解析该会话的项目目录。实测 260 µs/事件——按 50 事件/秒算，主线程每秒被阻塞 13 ms。现在按"已解析过的路径"记忆化，未命中的路径最多每 5 秒重探一次（配置项 rootRecheckMs）。实测 0.79 µs/事件（330×），2000 个事件从 520 ms 降到 1.6 ms。
写文件不建父目录：保存到一个尚不存在的子目录会直接失败。现在先 mkdir -p。
历史截断把标记塞进了内容里：超 100KB 的历史版本会被拼上 …[history 截断]，于是这段标记本身变成了"一行改动"，历史 Diff 里出现一行根本不存在的文本。改为按大小截断 + truncated: true 标记，由界面说明"仅保存前 100KB"。
超限请求体被报成 invalid-body：现在区分 413 body-too-large 与 400 invalid-body；readBody 也不再假设 req.destroy 一定存在。

语法高亮（两个死代码 bug）

CSS 的十六进制颜色整行被当成注释：正则里 #[^\n]*（注释）排在十六进制颜色之前，于是 color: #fff; 从 # 开始全部标成注释，颜色分支永远走不到。现在按语言分两套正则：# 注释型（py/sh/yml/…）与颜色型（js/css/html/…）。
函数名高亮从未生效：判定写的是 tok.endsWith("(")，但标识符正则并不吃括号，所以这个分支永远为假。改为看标识符后面是否紧跟 (（允许空格）。

词级 Diff

默认（折叠）视图里没有词级高亮：buildBlocks 给每个改动行单独开一个块，于是"修改"的旧行/新行被拆到两个块里，永远配不成对——只有点开省略行（展开模式）才看得到。现在把连续的改动行归入同一块，两种布局都有词级高亮，块数也从 4000 降到个位数。
词级高亮会吃掉语法着色：词级分支原本用裸 seg() 渲染，整行失去颜色。新增 markedLine()：先分词，再按命中区间切分 token，标记嵌在着色 token 内部——颜色和词级标记兼得。
一处改两个词时，中间的词也被标成改动：wordSeg 只做首尾裁剪。改为对词做真正的 LCS，只标真正变化的词；纯空白永远不标（高亮一个空格是噪音）。

客户端

Esc 层级：原来在帮助浮层或查找栏打开时按 Esc 会把整个面板关掉。现在逐层退出（帮助 → 聚焦中的输入框 → 面板）。
快捷键作用域：面板关闭时 ? 会切换看不见的帮助状态、Alt+↑/↓ 也被吞掉。现在除 Ctrl+Alt+C 外都只在面板打开时生效。
会话状态保存不全：快照里存了页签/宽度/筛选/工作区，但保存 effect 的依赖只列了 4 项——只改页签或拖宽度不会触发保存，刷新即丢。依赖已补齐。
把整个文件塞进 localStorage：编辑器缓冲随快照一起持久化，一个 500KB 文件就能吃掉配额（而写入失败是静默的）。超过 64KB 只记住"打开位置"，恢复时从磁盘重读。
可访问性：页签、变更行、文件树节点原本都是不可聚焦的 div（纯鼠标操作）。现在分别是 button[role=tab]、button.cs-chg-main、button.cs-node；帮助浮层为 role=dialog aria-modal；连接状态 aria-live；输入框、开关按钮、复选框都有 aria-label；aria-expanded/aria-pressed 正确反映状态。
重复保存：连按 Ctrl+S 会并发写同一个缓冲，现在有在途保护。
撤销粒度：原来每次按键都压栈，Ctrl+Z 一次退一个字符。现在 400ms 内的连打合并为一步。
其它：viewDiff 补上 50 条上限；"发送到会话"超过 200KB 截断并说明；拖拽宽度同时写入 cs.panelWidth；文件树加"刷新"按钮（目录缓存导致新建文件不出现）；文件读取失败给出中文说明（含 512KB 上限）。

测试

v0.2.17 — 修复 3 个真实 bug + 视图层窗口化

问题（先测量再动手）：v0.2.16 解决了"每次渲染重算 Diff"，但两个视图仍在全量物化：

Diff 视图为 302 个 DOM 节点创建了 40159 个元素——先把整个差异（最多 3 万行）造成 React 元素，再 slice 出可见的 30 行。
编辑器为 5000 行文件建了 15044 个 DOM 节点（行号列 + 高亮层各一份），每次按键全量重建——这是打字卡顿的主因。

实测（node scripts/perf-view.mjs 5000 4000，同一 harness 跑改动前 / 后）：

视图	指标	改动前	改动后
编辑器 5000 行	元素 / DOM 节点	20046 / 15044	528 / 406
编辑器 5000 行	重渲染	10.1 ms	1.5 ms
Diff 4000 行	元素 / DOM 节点	40159 / 302	339 / 302
Diff 4000 行	重渲染	14.5 ms	2.3 ms

Diff 只物化可见窗口：行布局改成"区段表"（每块贡献几行、从第几行开始），用二分查找定位；每个 op 恰好占一行，所以任意一行都能单独渲染。所有行等高（18px），spacer 顶住滚动高度，输出与旧实现逐节点一致。
编辑器只物化可见窗口：行号列与高亮层各自用上下 spacer 撑住全文高度，滚动时按 requestAnimationFrame 之外的自然事件重算窗口（窗口没变就不 setState），文本区与高亮层仍由原生 scrollTop 对齐。

修复的 3 个 bug（都写了驱动真实事件流的回归测试）：

新建文件的基线被覆盖：existing.before === null 时回退到事件自带的 before，于是本会话新建的文件在第二次写入后变成"普通修改"——"新建"标记消失，且「还原」会把文件恢复成中间版本而不是删除。改为保留首次基线（含 null）。
Agent 改动会抢走页签：SSE 每来一条事件都对所有订阅者触发 reveal，面板因此 setTab("changes") 并重置展开项——你正在编辑文件时会被踢回变更列表，正在看的 diff 也会被折叠。现在区分用户深链（点头部菜单，仍然切页签）与自动揭示（仅在"已在变更页签且没有手动展开任何文件"时填充）。
每条事件都多一次全量重渲染：SSE 每帧都会重申 ok/已连接，setConn 无条件 emitFeed()。现在状态与文案都没变就不通知。

回归保证（4 个新测试，全部做了变异检验）：

scripts/render-equivalence.mjs：从 git 取出旧版 bundle，与工作副本在同一 harness下渲染同一场景，逐节点比较渲染树 —— 10 个场景 × 2 种布局（折叠 / 展开）× 4 个滚动位置，共 80 次渲染、998 行 Diff、60 个词级标记。它自己也被变异检验过：把 wordSeg 参数顺序调换、spacer 高度改错、窗口起点偏移、区段查找 off-by-one，4 个变异全部报错。
scripts/editor-window.mjs：断言行号连续、两层 spacer 高度之和精确等于全文高度（5000 × 18.6px）、窗口内文本与内容对位、宿主节点数有界；去掉底部 spacer 会被抓出。
scripts/feed-behavior.mjs：用假 EventSource 真的推两条事件，断言新建文件基线保持 null；断言自动揭示不改页签而用户深链会；断言重复的 setConn 不产生通知。三个 bug 各自回退都会被抓出。
scripts/smoke-client.mjs 追加 10 条结构断言（窗口化必须存在、全量物化器不得复活、编辑器不得再全量渲染行号）。

v0.2.16 — 性能与交互优化（有实测数据）

实测（node scripts/perf-panel.mjs 400 120，同一套 harness 跑改动前 / 改动后；"diffs" = 该次渲染真正执行的行级 Diff 次数）：

指标（400 文件 · 每个 120 行）	改动前	改动后
增量渲染中位数	270.7 ms	2.0 ms
单次重渲染的 diff 次数	800	0
按增删排序后重渲染	807.8 ms / 2396 diffs	3.4 ms / 0 diffs
首屏渲染（含一次全量统计）	395.6 ms / 800 diffs	78.3 ms / 400 diffs
单次全量统计（局部改动场景）	173.0 ms（0.43 ms/文件）	69.2 ms（0.17 ms/文件）

Diff 首尾裁剪：lineDiff 先剥掉两侧完全相同的公共头/尾再跑 DP。公共前后缀必然属于某个 LCS，所以对齐质量不变，只是把矩阵从 O(n·m) 缩到 O(k·k)（k = 真正改动的行数）。3000 行文件改中间 12 行：0.4–0.6 ms 得到精确最小差异，而旧实现在这个规模会退化成贪婪对齐（非最小）。
统计缓存：每条 SSE 事件带单调 seq，于是 (路径, seq) 唯一确定内容 —— 按它缓存每文件的 +N/−M。重渲染从"每文件一次 Diff"变成"每行一次 Map 查询"；600+ 条上限后整体清空，长会话不会无限增长。
排序去重：按增删排序改为先装饰一次权重再排序，从 O(n log n) 次 Diff 降为 O(n) 次。
渲染只算一次：汇总与每行统计共用同一份 shownStats（原来同一次渲染里算两遍）。
拖拽合帧：面板宽度拖拽原是每个 pointer 事件触发一次全列表重渲染，现按 requestAnimationFrame 合并为一帧一次。
编辑器大文件保护：超过 3000 行自动关闭语法着色（纯文本显示，文件栏标注"纯文本"），逐行 tokenize 在每次按键都会跑满整个文件，这是编辑大文件卡顿的主因；Diff 视图的窗口化渲染保持不变。
交互细节：打开行的 2px 强调竖轨（与文件树/ Diff 行同一语言，长列表滚动后仍知道在看哪个文件）、行内 +N/−M 固定宽度 + 等宽数字（数字变化时操作按钮不再左右跳动）、Diff 行 hover 不再抹掉语义底色（未改动行才用中性底色，改动行改为提升文字对比度）、列表与 Diff 区加 overscroll-behavior:contain（滚到底不再带动背后的会话滚动）、scrollbar-gutter:stable（滚动条出现时列表不横跳）、.cs-chg 加 contain:layout style。
回归保证：新增 scripts/difftest.mjs（属性测试）—— 4000+ 随机小样本 + 边界形状 + 大型真实改动，断言 操作列表能精确还原两版内容、行号连续正确、adds/dels 计数与旧实现完全一致（允许"同样最小但另一个"的对齐，因重复行处的并列选择本就任意），并断言 fileStats 与旧计数一致；scripts/perf-panel.mjs 则改成确定性 CI 门禁（不看耗时，只看 diff 次数：全量统计必须恰好每文件一次、任何重渲染必须为 0），smoke 另加 12 条结构断言（含一条真实的 React hooks 顺序测试：plain 开关不得改变 Highlighted 的 hook 数量）。

v0.2.15 — 极简化重绘（minimalist-ui 技能）

顶栏合并：标题 + 分段页签 + ✕ 同住一条栏（省一整条 bar）；去掉品牌圆点与"就绪/N 变更"胶囊。
删汇总条：+N/−M 与"N 个文件"并进筛选行右侧元信息（再省一条 bar，垂直空间全部让给 Diff 列表）。
状态栏降噪：只留连接点 + 连接文案 + kbd 快捷键 + ?；"变更 N 文件 / 会话号 / 就绪"全部撤下（别处已有）。
表面归零：面板阴影移除（只留 1px 左缘发丝线）、去光晕环、空态图标去框、帮助浮层去高斯模糊。
按钮幽灵化：全部无边框（hover 才现底色），仅"保存"实心；圆角锁收紧为 4/8px（药丸只保留给语义圆点/未读徽标）。
色彩再校准：Diff 底色浓度下调（9/8/8%），竖轨改 70% 透明度；语法高亮整体再压一度。
回归保证：smoke 新增 10 条结构性断言（页签必须住在顶栏、汇总条不得复活、面板不得出现 box-shadow、按钮必须无边框、圆角锁与动效曲线不得丢失等），加上原有设计钩子与文案规则断言。

v0.2.14 — UI 全面重绘（design-taste 技能）

设计令牌：样式表顶部建立本地令牌层（--cs-accent/--cs-line/--cs-ink1-4/--cs-s1-2/--cs-recess/--cs-ok|warn|err/--cs-row/--cs-ease），全部以宿主 --dsw-alias-* 为源、并带兜底值 —— 无宿主令牌时也能独立渲染。单一强调色（宿主品牌色），状态色去饱和。
形状锁：圆角只用 6 / 10 / full 三档（控件 / 容器 / 药丸与圆点），全表一致；阴影只留面板一层，且带蓝黑底色而非纯黑。
变更列表重排：行从「卡片套卡片」改为扁平行 + 发丝分隔（提升密度与档次）；增量数字改 tabular-nums、为 0 时不显示噪声 −0；行内操作收成 3 个 22px 图标按钮（✓ 已审 / ↩ 还原 / ◷ 历史，hover 浮现），把文件名从「client.…」抢救回来。
Diff 视图：18px 行高（--cs-row 与虚拟滚动的 ROW_H 同步）、按语义色给出左侧竖轨、行号 tabular-nums、单词级高亮改为色块（去掉删除线的噪音）。
编辑器：文件条拆成路径条 + 工具栏两行（原先 7 个按钮把路径挤成 0 宽）、未保存状态变成 chip；查找栏、语法高亮配色统一到低饱和调色板。
状态工艺：新增组合式空态（图标 + 标题 + 提示 + kbd 芯片）、骨架屏（编辑器/读取中）、错误态（内联说明）；Esc 关面板、忙碌状态点脉冲；工具栏/底栏补齐 hover / active / focus-visible 三态与 WCAG AA 对比。
图标：面板无构建步骤、无图标依赖，故仅有的几个字形按同一 16px / 1.5px 描边网格手绘（并在样式表里注释说明这是诚实降级）；替换掉原先的文件树 emoji。
副产物：node scripts/preview-ui.mjs 用极简 React shim + 真实组件把面板渲染成静态 HTML（写入 preview/，已 gitignore），配合无头 Edge 截图即可离线评审 UI。三个自测脚本全绿：host 46 项断言 + 客户端冒烟（新增"样式系统钩子不得丢失""文案不得含 em-dash/emoji"断言）。

v0.2.13 — 适配便携版「随盘」特性

同盘换盘符改写：DSH 把工作区路径绝对存进会话头与 storages/workspace.json，而整个便携包可以换盘符。现在插件的 /root、/tree、/workspaces 与会话监听都走 mapPortablePath() —— 与 launcher/fix-workspace-paths.mjs 完全同一条规则：路径存在就用原路径；否则把同样的路径（去掉盘符）重新锚到 DSH 自己所在盘（DSH_HOME 的盘符），且只有那个目录真的存在时才改。
工作区索引接入：/workspaces 合并 DSH 自己的便携索引 storages/workspace.json（按 updatedAt 新的在前，含"目录不存在"标记），所以换盘后不会只剩一个空目录。
会话目录彻底不存在时兜底：记录指向别的电脑/已删除目录的会话，不再给你一个空树 —— 自动回退到最新的、真实存在的工作区，并在界面上说明（/root 返回 recorded / remapped / sessionMissing / exists）。
界面提示：「文件」页签顶部会显示「随盘：盘符已改变，路径按同盘规则改写到 …（记录的是 …）」，或「该会话记录的项目目录不存在，已回退到 …；换盘符后请运行「整理工作区分组.cmd」」，工作区下拉里不存在的目录也会标注。
实测（本机 130 份会话头 / 22 条工作区索引）：当前盘符已是 F:，改写成 no-op（正确）；9 份属于别的电脑的会话如实标注、绝不臆造路径。

v0.2.12 — 回退：面板仍是覆盖型浮层侧栏

回退 v0.2.9~v0.2.11 的插槽改造：面板重新挂回 shell.overlay（浮在对话右缘的覆盖型侧栏，拖左缘调宽、✕ 关闭），左侧栏入口恢复原有的 DOM 注入 —— 与 0.1.x 一致。
原因：0.2 的 sidebar.right.pane.tab / main 会把它变成右栏页签或中央面板（桌面端上还会另开一个面板窗口），都不是这个面板该有的形态。
保留：包声明适配（去掉 0.2 已不存在的 peer / dsh.client.inject，无需风险豁免）、工作区按会话解析、✕ 关闭按钮、引用计数共享的 SSE 变更流、窄宽度下自适应的状态栏、切会话重解析工作区。
修「关不掉」：0.2 桌面端（Windows）把窗口标题栏画成页面里的固定层，而 shell.overlay 是 inset:0 的绝对层（连 data-windows-titlebar 那 40px 标题栏带一起覆盖）—— 面板顶行正好压在窗口控制按钮底下，✕ 被挡住点不到（窗口越窄越明显，看起来甚至像"面板跑到独立窗口里了"）。现在面板在标题栏模式下按宿主自己的 --dsh-windows-titlebar-height 让到标题栏下方，✕ 也提到上层；并且 Esc 随时关闭面板（✕ / Ctrl+Alt+C / 头部胶囊同样有效）。

v0.2.11 — 右侧边栏页签（已回退，见 v0.2.12）

改成官方右侧边栏页签（和「文件 / 终端 / 浏览器」同一种面板）：注册页签类型（ctx.sidebarRightTabs.register({ id, kind, title })）+ sidebar.right.pane.tab 主体 + sidebar.right.pane.tab.title 标题芯片；不再注册左侧 sidebar.panellist 入口，也不再占用中央 main 面板。
打开/隐藏走宿主自己的机制：头部胶囊 / Ctrl+Alt+C → ctx.sidebarRight.openTab("code-studio")（自动展开列），面板里的 ✕ 隐藏侧边栏 → ctx.layout.closeRightbar() —— 与对话头部那个右侧栏按钮同一条路径，另有宿主自带的收起按钮可用。
变更引擎与面板解耦：面板本体渲染在页签里，shell.overlay 只挂一个无界面 feed 入口（引用计数共享同一个 SSE 流）—— 页签关闭时头部胶囊照样计数，两者也不再有挂载顺序耦合。

v0.2.10 — 工作区按会话解析 · 面板隐藏按钮

修 bug（0.2 桌面端）：「文件」页签的工作区曾经取宿主进程的 cwd —— 在桌面端就是应用自己的 profile 目录（…\profiles\desktop，里面只有 compatibility.json / cordis.yml）。0.2 的项目目录是按会话（工作区）绑定的：现在 /root、/tree、/workspaces 都从当前会话的 header.cwd 解析（优先级 config.root → DSH_WORKSPACE → 当前会话目录 → 进程 cwd），客户端切会话时自动重解析，工作区下拉也会列出各活动会话的项目目录。
修 bug：宿主面板形态下补回 ✕ 隐藏按钮（点击 = layout.selectPanel(null) 回到对话；Ctrl+Alt+C 同效）。

v0.2.9 — 0.2 桌面端适配（官方插槽 + 兼容性预检）

侧边栏入口从 DOM 注入改为官方 sidebar.panellist 插槽；新增 main 键位面板，点侧边栏行切到 Code Studio 中央面板（0.1.x 自动回退浮层模式）。
面板实例常驻 shell.overlay，UI 用 portal 进宿主容器 —— 未选中时变更流仍在跑。
包声明去掉 0.2 已不存在的 @deepseek-ai/dsh-client-runtime / dsh-client-connection peer 与 dsh.client.inject，0.2 无需风险豁免即可加载。
0.2 下不再自动抢占中央面板；未查看变更用头部胶囊圆点 + 侧边栏行圆点提示。

v0.2.8 — 头部变更胶囊 · DSH 设计系统

变更提示从右下角浮窗（会压住输入框/发送工具条）迁移到对话头部工具栏：新增 conversation.session.header.utilities 插槽胶囊，N 个文件已变更 +A −D，主体开关面板、⌄ 打开变更文件清单（点选直达该文件 Diff）。
面板关闭时不再渲染任何浮动元素；未读变更靠头部胶囊圆点 + 侧边栏徽标表达。
UI 全面对齐 DSH 设计系统：复用宿主 UI 组件库、统一主题变量、宿主同款滚动条/焦点环/过渡。

v0.2.3 — 交互增强

行内单词级 Diff 高亮 + 变更上下文行 + 变更统计总览
Diff 一键跳转到编辑器对应行；批量还原/清除；标记已审阅
编辑器撤销/重做、退出未保存提醒、查找替换
变更列表排序（最新/名称/改动量）、快捷键帮助弹层

WindyPro-rourou/dsh-code-studio

Code Studio — DSH Web UI 文件修改监视器 · 代码工作台

核心价值

安装

兼容性

0.2 桌面端适配（v0.2.9 → v0.2.12）

使用

技术说明

已知限制

v0.2.18 — 逐项审计：修 21 处缺陷，宿主热路径快 330 倍

宿主端（lib/index.js）

语法高亮（两个死代码 bug）

词级 Diff

客户端

测试

v0.2.17 — 修复 3 个真实 bug + 视图层窗口化

v0.2.16 — 性能与交互优化（有实测数据）

v0.2.15 — 极简化重绘（minimalist-ui 技能）

v0.2.14 — UI 全面重绘（design-taste 技能）

v0.2.13 — 适配便携版「随盘」特性

v0.2.12 — 回退：面板仍是覆盖型浮层侧栏

v0.2.11 — 右侧边栏页签（已回退，见 v0.2.12）

v0.2.10 — 工作区按会话解析 · 面板隐藏按钮

v0.2.9 — 0.2 桌面端适配（官方插槽 + 兼容性预检）

v0.2.8 — 头部变更胶囊 · DSH 设计系统

v0.2.3 — 交互增强

Community comments

WindyPro-rourou/dsh-code-studio

Code Studio — DSH Web UI 文件修改监视器 · 代码工作台

核心价值

安装

兼容性

0.2 桌面端适配（v0.2.9 → v0.2.12）

使用

技术说明

已知限制

v0.2.18 — 逐项审计：修 21 处缺陷，宿主热路径快 330 倍

宿主端（lib/index.js）

语法高亮（两个死代码 bug）

词级 Diff

客户端

测试

v0.2.17 — 修复 3 个真实 bug + 视图层窗口化

v0.2.16 — 性能与交互优化（有实测数据）

v0.2.15 — 极简化重绘（minimalist-ui 技能）

v0.2.14 — UI 全面重绘（design-taste 技能）

v0.2.13 — 适配便携版「随盘」特性

v0.2.12 — 回退：面板仍是覆盖型浮层侧栏

v0.2.11 — 右侧边栏页签（已回退，见 v0.2.12）

v0.2.10 — 工作区按会话解析 · 面板隐藏按钮

v0.2.9 — 0.2 桌面端适配（官方插槽 + 兼容性预检）

v0.2.8 — 头部变更胶囊 · DSH 设计系统

v0.2.3 — 交互增强

Community comments

宿主端（`lib/index.js`）

宿主端（`lib/index.js`）