Vai al contenuto principale
W

dsh-code-studio

windypro-rourou/dsh-code-studio

Monitor delle modifiche ai file ed editor di codice per l’interfaccia Web di DSH. Le modifiche dell’agente appaiono accanto alla conversazione come diff riga per riga in tempo reale, con editor con evidenziazione della sintassi, ripristino con un clic, cronologia delle modifiche, selettore dello spazio di lavoro e isolamento per sessione.

Installazione

dsh plugin --profile web add github:windypro-rourou/dsh-code-studio

README

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 一致,实测工作正常)。

使用

  1. 打开 Code Studio:对话头部(会话标题右侧工具栏,和宿主的「打开方式」按钮同一排)常驻一枚变更胶囊 —— 显示当前会话 N 个文件已变更 +A −D,点主体开关右侧面板、点 ⌄ 展开变更文件清单并直接跳到某个文件的 Diff;也可用侧边栏入口或 Ctrl+Alt+C。面板可拖左缘调宽。
  2. 让 Agent 修改代码 —— 面板自动浮现该文件的逐行 Diff:行号前 +(绿)/ −(红)/ ~(黄),未改动大段自动折叠;面板关闭时侧边栏入口显示未查看变更数徽标。
  3. 对不满意的修改点「还原」,一键回到 Agent 动手前;点「历史」回放该文件的每一次改动。
  4. 「文件」页签:切换工作区、浏览文件树、打开文件直接编辑保存(Ctrl+S),或「发送到会话」让 Agent 接着改。
  5. 变更多了?顶部搜索框 + 类型筛选快速定位;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 / 15044528 / 406
编辑器 5000 行重渲染10.1 ms1.5 ms
Diff 4000 行元素 / DOM 节点40159 / 302339 / 302
Diff 4000 行重渲染14.5 ms2.3 ms
  • Diff 只物化可见窗口:行布局改成"区段表"(每块贡献几行、从第几行开始),用二分查找定位;每个 op 恰好占一行,所以任意一行都能单独渲染。所有行等高(18px),spacer 顶住滚动高度,输出与旧实现逐节点一致。
  • 编辑器只物化可见窗口:行号列与高亮层各自用上下 spacer 撑住全文高度,滚动时按 requestAnimationFrame 之外的自然事件重算窗口(窗口没变就不 setState),文本区与高亮层仍由原生 scrollTop 对齐。

修复的 3 个 bug(都写了驱动真实事件流的回归测试):

  1. 新建文件的基线被覆盖:existing.before === null 时回退到事件自带的 before,于是本会话新建的文件在第二次写入后变成"普通修改"——"新建"标记消失,且「还原」会把文件恢复成中间版本而不是删除。改为保留首次基线(含 null)。
  2. Agent 改动会抢走页签:SSE 每来一条事件都对所有订阅者触发 reveal,面板因此 setTab("changes") 并重置展开项——你正在编辑文件时会被踢回变更列表,正在看的 diff 也会被折叠。现在区分用户深链(点头部菜单,仍然切页签)与自动揭示(仅在"已在变更页签且没有手动展开任何文件"时填充)。
  3. 每条事件都多一次全量重渲染: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 ms2.0 ms
单次重渲染的 diff 次数8000
按增删排序后重渲染807.8 ms / 2396 diffs3.4 ms / 0 diffs
首屏渲染(含一次全量统计)395.6 ms / 800 diffs78.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 一键跳转到编辑器对应行;批量还原/清除;标记已审阅
  • 编辑器撤销/重做、退出未保存提醒、查找替换
  • 变更列表排序(最新/名称/改动量)、快捷键帮助弹层

Plugin correlati