为 DeepSeek Harness 提供类 VSCode 编码体验:基于 Monaco 的中央文件编辑器(文件页签、Ctrl+P 快速打开、状态栏),并对 Agent 的 edit/write 结果进行交互式差异审查(逐处采纳/拒绝、回滚、归档),状态跨重启持久化。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-vscode-mode
# Release 预构建包
dsh plugin --profile web add "https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.1.36/dsh-vscode-mode-0.1.36.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
DSH 上的类 VSCode 编码体验:Monaco 文件编辑器 + Agent 差异审查 + LSP 智能。 由
@dsh-external/dsh-edit-review重构而来。

- 📝 同屏编辑:DSH 0.1.5+ 官方右侧 Sidebar,AI 对话与文件编辑同屏
- 🔍 差异审查:Keep / Undo / 回滚 / 归档,状态持久化重启不丢。同工作区内所有对话共享待审列表、统计与决定,来源对话仅用于追溯;不同工作区隔离。当前页操作后刷新,其他已打开页面通过约 5 秒轮询同步(后台页面恢复可见后刷新)。写操作仍要求本端活跃会话和原有权限。
- 🧠 LSP 智能:转到定义 / 查找引用 / Peek 多结果选择 / 智能补全(注释索引)/ 签名帮助
- 🐞 断点调试:DAP 桥通用化,行内断点、
.dsh/launch.json、四段调试面板 - ⌨️ 命令面板:
Ctrl+Shift+P,19 条命令开箱即用,可编程扩展
安装:npm i dsh-vscode-mode(需 DSH 0.1.5+,装完重启 DSH)→ 详见安装。
能力速览
| 场景 | 你能得到什么 |
|---|---|
| 同屏编码 | 中央对话 + 右侧 Monaco,官方 Sidebar 多标签 / 分栏 / 浮出 / 全屏 |
| 审改动 | 行内红绿差异、累计基线待审、Keep / Undo / 回滚 / 归档,重启不丢 |
| 懂代码 | LSP:定义 / 引用 / Peek / 补全 / 签名帮助,按文件语言自动选后端 |
| 调问题 | DAP:断点、调用堆栈、变量、监视、调试控制台 REPL(Lua attach / .NET) |
| 管文件 | 活动栏 + 资源管理器 + 右键菜单 + 工作区搜索 + SVN 状态徽标 + 远程下载 |
| 看文档 | Markdown 预览、PDF 注释编辑、Excel 基础编辑与只读数据预览 |
目录
特性
1. 侧边栏文件编辑(推荐形态)
检测到 DSH 0.1.5+ 官方右侧 Sidebar(ctx.sidebarRightTabs / ctx.sidebarRight)时,
编辑器注册为官方侧边栏 Tab,AI 对话(中央)与文件编辑(右侧)同屏,支持官方
多标签 / 分栏 / 浮出 / 全屏,打开路由即开即展开,官方引导页提供入口。
- 形态优先级:官方 Sidebar > dsh-better-sidebar (桥已归档,仅作旧版回退)> 中央文件编辑页签(零新依赖完整可用); 编辑器顶部与设置页「兼容性」子 Tab 给出对应引导。
- 文件链接(DSH 0.1.5+):聊天 / 文件树链接经官方
ctx.sidebarRight.openResource直达右侧栏;「文件链接使用工具」为 自动 / VSCodeMode 时以 extension 档认领dsh-resource://file/**(Monaco 打开,含行号定位),为「官方侧边栏」档时走 官方文本查看器;畸形地址自动回落官方查看器。 - 文件页签:脏点 / 关闭 / 「+」打开 / 右键菜单 / 固定(📌 排最前、隐藏 ×、 随工作区持久化;固定 = 保护,批量关闭永不误关固定页签)。
- 页签数量上限(通用设置
maxOpenEditors,默认 10,0 = 不限制):超限时自动 关闭最久未使用的页签;固定页签与当前活动页签受保护,脏页签在关闭前静默落盘。 - 页签栏滚轮横滚:页签栏溢出(出现水平滚动条)时,鼠标滚轮(含触控板纵向手势)
直接横向滚动页签栏;不溢出时不接管,
Shift+滚轮沿用浏览器原生横滚。 - 页签右键菜单(对齐 VS Code):添加到对话 / 关闭·关闭其他·关闭右侧·关闭已
保存·全部关闭(
Ctrl+F4关当前)/ 复制路径·复制相对路径 / 在文件资源管理器 (视图)中显示。关闭前未保存页签静默落盘;浏览器无法实现的条目(向右拆分 / 新窗口)不提供。 - 工作区搜索填充:编辑器有选中时执行「工作区搜索」(当前键位见官方快捷键目录), 选中文本自动填入搜索框并立即搜索(多行选区取首行;填入后全选,便于直接改写)。
- Markdown 预览(v0.5.3):打开
.md/.markdown后,工具栏「预览」按钮、Ctrl+Shift+V或命令栏「切换 Markdown 预览」切入 GFM 渲染(标题/列表/表格/代码块/ 引用/KaTeX),「以源码打开」切回编辑。渲染走官方MarkdownText原语,零新增依赖、 自动跟随 DSH 主题;旧版 DSH 缺该原语时降级为纯文本预览。活动文件不是 Markdown 时 不吞Ctrl+Shift+V(保留「粘贴为纯文本」)。 - DSH 计划模式接入:工作区
plans/、DSH.dsh/plans/下的 Markdown 计划文件, 以及成功生成且以# 计划:/# 计划:标题显式关联的 Markdown,默认以预览打开; 指定行号的链接仍进入源码定位,普通 Markdown 的既有打开方式不变。 当前会话成功写入/修改计划文件、提交完整计划后自动打开预览;刷新、历史翻页、重连和 切换会话不会重播旧计划。官方「打开计划」及待审批计划同样转入文件编辑器的只读计划 页签(最多保留 32 份,退出编辑器后不持久化虚拟正文),不写磁盘、不接入 LSP/SVN/保存; 审批仍使用对话中的官方控件。打开失败可点击「在官方计划查看器打开」,不影响原审批。 缺少官方 Sidebar/计划服务的旧版 DSH 保留原查看器;自动生成检测需要 Session 事件源。 - Monaco Editor:语法高亮 / 行号 /
Ctrl+F/Ctrl+G/Ctrl+S/ 700ms 防抖自动保存;顶部工具栏显示 路径 / 语言 / Ln,Col / 保存状态,提供 差异 / 侧边栏 / 刷新入口。 - 导航历史:后退 / 前进跨文件恢复焦点位置(工具栏
←/→、Alt+←/→、Ctrl+Alt+-/Ctrl+Shift+-、鼠标侧键 XButton 均可触发);后退后新导航 自动清空前进栈。
Univer Office 可选联动(开发中)
安装并启用兼容的 dsh-univer-office 时,.xlsx、.docx、.pptx 可进入副本导入流程,.univer 在文件页签内展示 Viewer;CSV/TSV 通过右键「使用 Univer 编辑副本」显式进入。未启用或接口不兼容时不显示联动入口,既有 Excel 基础编辑与其他 Office 打开方式保持不变。不会自动安装、启用或升级 Univer。
- 完成当前会话的 Viewer 安全确认后,Office 打开会自动在工作区
.dsh/cache/dsh-vscode-mode/univer/v1/中创建容器和 draft,不再要求输入副本路径。相同源内容复用已有缓存及编辑;源文件变化时保留旧缓存并提示,可显式「导入源文件新版本」,不自动覆盖或合入。失败记录保留,不盲目重放未知导入。 - 「设置 → VSCodeMode → 通用 → Univer 工作区缓存」显示当前工作区的受管理条目、体积和状态,可勾选并二次确认清理。缓存可能含唯一未导出的编辑,删除不可恢复;导入/其他进程操作中、版本变化、未知文件或运行中 Gateway 潜在占用均跳过,不自动停服务。只读不能清理。不会删除源文件、手动副本或自建
.univer。 - 缓存不参与自动TTL/容量清扫。建议按项目需要忽略上述专属目录,插件不会自行修改 Git/SVN 忽略规则。旧版本生成在源文件旁的副本不自动迁移。
- Viewer 仅适合可信单用户环境。Univer 0.4.0 上游代理不提供完整的逐会话/工作区隔离;安全确认不改变沙箱权限,URL 参数不是权限凭据。只读或无法确定策略的会话不加载 Viewer。会话切换或刷新后重新确认。
.univer不作为文本读写,Ctrl+S 不会导出或合入;已有 Excel 未导出编辑不自动迁移。关闭页签不代表合入、丢弃或撤销上游连接权限。- 变更总览单独展示本会话已发现的 Univer 草稿,不扫描全工作区,不参与代码批量采纳/撤销。预览和语义审阅复用 Univer,确认/丢弃由用户在其界面操作。
- 当前适配目标为 Univer Office 0.4.0;依赖其可选 Host 服务结构和浏览器状态接口。会话
cd后超出初始作用域不支持内嵌;缺少能力、鉴权失败和服务停止会分别提示,不直连 Gateway 绕过。
Excel 基础编辑(v0.21.0)
.xlsx在文件编辑器中打开,支持多工作表、文本/数值/布尔值/日期、基础样式、行高列宽与合并单元格;公式限普通引用及SUM/AVERAGE/MIN/MAX/COUNT。- 只导出副本,不写原件:使用「基础 · 导出副本」发起浏览器下载;
Ctrl+S、自动保存和批量关闭均不会将 Excel 当文本写回。下载不表示浏览器已保存成功,也不会清除编辑脏标记。 - 「高级 · Excel / WPS」通过官方 Host 打开原件;未导出编辑不会自动带入高级应用。存在编辑时先询问打开原件、导出或取消。
- 宏格式
.xlsm、旧格式.xls/.xlsb不进入基础编辑。含图表、透视表、保护、复杂公式或其他未支持结构的.xlsx仅提供只读数据预览,禁止编辑和导出;损坏、加密或超预算文件拒绝解析。 - 编辑在当前页面的会话/文件范围保留,切换会话或视图不自动丢弃;关闭脏文件必须明确放弃,外部修改/删除不覆盖编辑。不承诺刷新、崩溃或 DSH 重启后的恢复,离开前请导出并确认下载。
- 资源上限:压缩文件 20MiB、单部件解压 32MiB、累计解压 100MiB、50 张工作表、200000 个已用单元格;不支持的导出编辑会报错,而不是静默剥离。
2. 命令栏与指令系统(v0.2.0)
Ctrl+Shift+P(或 F1)唤出 VS Code 式命令面板:输入即过滤(中文 / 分类 /
命令 id 均可命中),↑↓ 选择、Enter 执行、Esc 关闭,每行显示 命令名 /
分类 / 当前键位;需要打开文件的命令在空编辑器时自动隐藏。
- 单一数据源:命令目录(
ui/commandCatalog)驱动命令栏和官方快捷键目录; 键位查看/改绑统一走 DSH 官方快捷键配置(设置 → VSCodeMode → 通用 → 「打开官方快捷键配置」,或Ctrl+/),插件不再自建录键界面,绑定由官方服务持久化。 旧版 DSH 没有该服务时继续使用原有窗口按键派发,旧keybindings设置仍可生效。 - 开放注册表:
window.__edrvCommands__暴露register()注册命令;插件 不再提供独立的运行时键位注册,改用 DSH 官方 shortcuts 配置。 - 开箱 20 条命令:保存 / 快速打开 / 在文件浏览器中打开 / 显示所有命令 / 切换侧边栏 / 工作区搜索 / 切换 Markdown 预览 / 后退·前进 / 上下页签 / 关闭当前页签 / 上下编辑行 / 转到定义 / 查找引用 / 触发 AI 补全 / 配置代码片段 / 插入代码片段 / 选中内容加为引用。
3. 代码片段(v0.3.0,VS Code 兼容)
支持 .code-snippets:Ctrl+Shift+P →「代码片段:配置代码片段」打开居中浮窗
(现有片段文件列表 + 新建入口),在 Monaco 中按普通文件编辑(JSON 高亮 /
保存即生效 / 支持 scope 字段)。
- 两处片段库:全局
~/.dsh/snippets/(所有项目)+ 项目<工作区>/.dsh/snippets/(随仓库共享);文件名即生效语言 (lua.code-snippets→ 仅 lua,global.code-snippets→ 全语言), 新建时可选生效语言。 - IntelliSense 补全:编辑
.lua等文件时prefix自动列出(片段图标 +body预览,Tab/Enter展开,$1/${2:默认值}占位符与$TM_*变量可用);也可「插入代码片段」按语言筛选插入光标处。 - RPC:
snippets.list/read/save/remove/entries;保存后自动刷新补全缓存。
4. 快捷引用(v0.3.0)
选中内容后 Ctrl+U 把选中行范围加为引用(送入对话上下文,等价 VS Code 的
「Add Selection to Chat」);无编辑器 / 无选中时该键位不吞键,正常输入不受影响。
(v0.3.1 修复可用性判定:改用与输入实现无关的 .edrv-editor-row .monaco-editor
判据,替换被 Monaco EditContext 输入通道取代的 textarea.inputarea 探测。)
- 插入点跟随输入框光标(
caretSpan();无光标信息回落文档末尾,选中区域插在 选区右边界而不替换),修复「连续添加多个引用时既有 chip 被销毁并重复为纯文本」。 - 通道被拒时降级为就地纯文本(保留既有 chip 与正确分隔空格);两条通道都不可用 则不写任何内容并提示重试。
5. LSP 智能(编辑器内)
F12 / 右键「转到定义」、Shift+F12「查找所有引用」、Ctrl+点击 引用导航、
Ctrl+hover 可导航标识符下划线提示。v0.4.2 起统一委托完整 Monaco 原生命令:
多结果弹 Peek 让用户选,单结果直跳,取不到定义自动降级「转到引用」。
- 智能补全:输入
./:/(/[自动弹出候选(Ctrl+Space手动触发)。 EmmyLua 的注释索引(---@class/---@field/---@type)会被解析为真实的成员列表, 即对---@class标注的实例打p.能列出注解声明的字段/方法;候选项带类型图标、 弃用标记与片段展开(${1:占位})。文档走completionItem/resolve惰性拉取,列表响应保持轻量。 - 关键字与注解类型补全(v0.11.0):LSP 服务器没有返回候选时补齐 Lua 保留字
(
local/function…,luaReservedWords);---@type/---@param等注释内的基础类型 (number/string…)即使在运行中quickSuggestions.comments='off'也会自动弹出; 是否请求补全候选按适配器能力位裁决(completionCap)。 - 成员回退补全(v0.11.0):EmmyLua 没给出成员列表时按当前作用域推导可用成员
(
memberScope),补全不再空白。 - 签名帮助:函数实参处(输入
(/,)显示参数签名并按当前实参高亮; 多签名可切换。 - 定义查找带降级链(definition → declaration → 引用推导);参数 / 局部变量
(
this、pTarget这类)同样能跳到声明。 - 相关踩坑与修复见 常见问题 第 1–4 条。
6. 差异审查(核心能力)
Host 优先采集官方 workspaceChanges 的轮次净差异;旧版逐工具记录保留兼容,
同一路径有官方记录时不重复计数。客户端复用现有差异列表、角标和编辑器操作条,
不增加独立审查栏。
- 编辑器未打开 → 差异角标和总览;打开文件后 → 文件内增删区域、↑↓ 定位与 Keep / Undo。无法唯一映射到当前内容的历史块仍可查看,但不会标在猜测的位置。
- 官方原始摘要及 hunks、审查决定分别保存到插件工作区 SQLite 数据库;跨轮次 pending 保留。手动保存、文件失配和列表容量限制均不表示已审;旧旁车仅供迁移。
- Keep 只改变审查状态,不写文件;支持整条记录或单块处理,尚有 pending 块时 文件仍在待审列表。文件级动作不暗中处理同路径的其他轮次。
- Undo 需要与官方差异一致的独立原始字节证据。写回校验当前内容、文件版本及 操作日志,保留 BOM、行尾和末尾换行;脏缓冲、版本竞争或内容冲突时拒绝覆盖, 不把失败当作成功已审。没有受控删除能力的新建文件等场景不强行启用。
- 历史记录不会从当前文件倒推虚构基线;缺证据时仍可看差异和 Keep,但 Undo 禁用
并说明原因。新证据采集限本会话可观测的
edit/write,不承诺覆盖 shell、 外部编辑器或旧 Host 启动前的修改。升级 Host 后需要重启才能启用新回调。
v0.20.1 已完成重启后真实 GUI 的文件/块级审查与安全拒绝验收。Keep All / Undo All 已接入全部分页;批量 Undo 不是跨文件原子事务,遇冲突停止,已完成项不会自动恢复。
6.1 累计基线待审(对齐 dsh-diff-approval)
在保留现有面板的前提下,把待审内核换成累计基线投影:行为参考
dsh-diff-approval(基线
a661a7a31583057c8ba8bbeb73721a9b3ee0c57e,MIT,Copyright (c) 2026 Wu Zhiwei),
只借用语义与内核,不引入它的界面资产(Markdown 预览、并排视图、字体子集、悬浮卡片)。
- 一条目一文件:每路径只有一条待审条目,
oldText是最早基线、newText是最新内容。 同文件多次写入按更新时间折叠,基线取较早来源、内容取较晚来源,sessionIds取并集; 于是 A→B→C 显示 A→C,A→B→A 折叠归零(严格字节相等,不做 BOM/换行归一化)。 - 创建身份:
earlierVersion: 'none'表示基线是"文件不存在"。写入推进基线即结束创建 身份(转为'file'),此后再 Revert 是写回而不是删除。 - 判定粒度:块、行区间、文件、全部。Keep 只推进投影、零写盘;Revert 才写回文件, 新建条目整条 Revert 等于删除该文件。块身份由当前差异现场推导,不依赖落库状态。
- 判定安全:Revert 先按
stat → read → stat确认内容和版本一致,再走replaceIfVersion并写后读回;缺失重建使用createIfAbsent。新建文件回退通过 providerdeleteFile传递版本、取消信号和会话沙箱策略,旧 Host 缺能力时安全拒绝, 不回落宿主直删。读回失败不按缺失处理、不提交决定。内容与投影不一致、 条目已解决、行区间歧义时拒绝并给出原因码(revision-mismatch/diverged/settled/unknown-block/no-block/ambiguous-block)。 - 撤销/重做:判定入
pending_history(游标模型,撤销后重做回到同一状态), 幂等由operationId保证;决策栈跨重启保留(上游只在面板打开期间保留)。 - 差异来源:对
edit/write/str_replace_editor环绕工具执行读取真实前后字节;apply_patch通过可选官方解析器枚举全部源/移动目标,再逐目标独立取证。结果中的before:null不作为新建依据;部分成功只记录实际观测到的变化,unknown/畸形结果提供诊断。 缺少 raw byte 能力、二进制、无可信基线或超限时不伪造可撤记录。UTF-8 BOM 和行尾按字节保留。 可另外从版本库导入基线改动(git / svn / Perforce)。 dsh-ops 写工具同样环绕采集:ops_edit_file/ops_write_file/ops_remove按arguments.path取证,ops_copy/ops_move追加arguments.to(源删除 + 目标新增各一条);ops_replace目标执行前未知, 先按字面量pattern在替换作用域(path,glob 相对该作用域)内预读候选,最多 16 个文件, 执行后用回执items对齐——回执完成却没预读到的路径只记采集诊断,绝不伪造基线;dryRun预览不预读也不出条目。ops_bash等非声明式写盘不在实时采集范围(git 工作区仍由官方每轮 快照展示;非 git 工作区可手动从版本库导入基线)。 - 差异精度:行差异先裁公共前后缀,再按两侧唯一出现的相同行做锚点递归切分,
只在足够小的窗口内做 LCS;千行文件上的少量/分散改动按真实位置成块,不再因
单元格上限整段替换。只有窗口内确实没有可匹配行时才整段替换并标
coarse; 同时修正多 hunk 的oldStart/newStart行号(此前每块会多偏移一个上下文长度)。 - 采集诊断:进程内按工作区最多 50 条、全局最多 500 条;会话/插件释放后清理,Host 重启不保留。 它不替代官方持久化采集完整性记录,也不绕过写回内容和 provider 原子版本守卫。
- 采集作用域:写前冻结当前
workingDirectory、provider 与目标;写后读回完成才释放 同目标占用,卸载后不上报。只修正新采集,不自动搬迁历史目录归属错误的记录。 - 外部改动:已入列路径被外部改写时,新内容被吸收为最新待审内容并标记分歧,
基线保持不动;文件缺失/读不到时条目转为
missing,不再参与写回。 - 判定入口:差异直接画在编辑器里,块级 Keep/Undo 用行内药丸;文件级 Keep/Undo 在差异栏上。详情面板与批注(含「让 AI 应答」)已移除——判定与保持/撤销只走这两处。
与上游的有意偏差:
| 项 | 上游 | 本插件 | 原因 |
|---|---|---|---|
| 条目键 | 全局裸路径 | 工作区 + 路径 | 多工作区同名文件不能互相覆盖 |
| 文本存储 | 内存/全量 JSON | SQLite,有大小上限 | 大文件不拖垮 Host,超大只按时间戳比较 |
| Revert 写回 | 无条件写 | 稳定快照 + provider 版本守卫 + 写后读回 | 原子守卫依赖 provider 契约,缺版本拒绝写入 |
| 撤销栈 | 仅面板打开期间 | 持久化到 SQLite | 重启后仍可撤销上次决定 |
| 界面 | 自带整套 UI | 复用现有面板 | 保留本插件视觉与交互 |
| Perforce | 支持 | 支持,但只有假 shell 单测 | 本机无 p4 客户端,无法真机验证 |
| 新建文件 Revert | 删除文件 | provider 受控删除,内容与版本双检查 | 继承沙箱策略;旧 Host 缺删除能力时拒绝 |
数据与迁移:新增 pending_* 表,SCHEMA_VERSION 递增并用 PRAGMA table_info 判缺列后
ALTER TABLE,既有 review_* 事实表一概不动;首次改动前写 .before-pending.bak 备份;
路径被待审投影接管后,旧 sidecar 写入口(edrv.accept / edrv.reject / edrv.decideBatch
/ edrv.missingDecide 等)直接拒绝,避免双权威。
7. Monaco 离线分发
assets/vendor/monaco AMD 构建随包发布,经 /edrv/vendor/* 前缀路由全离线可用。
版本锁定 monaco-editor@0.42.0-dev-20230906(commit e7d7a5b0),用
node scripts/vendor-monaco.mjs [--force] 从 npm registry 复现铺入
(版本 + commit 双重断言,防静默换错构建)。
- v0.4.0 起为官方完整构建(
referencesController/peekView/gotoSymbol齐备),修复「查找引用完全没反应」;本地化只保留英文基线 + 简体中文 (KEEP_NLS),sourceMappingURL铺入时剥离(官方指向未分发的min-maps/); 构建后 vendor 约 10.3MB(替换前 21.5MB)。
8. PDF 浏览与编辑(v0.1.55)
打开 .pdf 在编辑区页签内直接浏览(连续滚动 / 翻页 / 缩放 / 文本选择,
cmaps 支持中文渲染);工具条进入注释编辑:✎ 文本框 / 🖌 画笔 / 🖍 高亮,
Ctrl+S 或 💾 保存把批注写回原文件(pdfDocument.saveDocument() →
edrv.saveBinary base64 回写,工作区边界 + 32MB 上限约束)。
- 引擎离线 vendor 于
assets/vendor/pdfjs(build + viewer + cmaps + standard_fonts,约 5MB),经/edrv/vendor/pdfjs/*分发;升级用node scripts/vendor-pdfjs.mjs [版本]。 - 借鉴开源 pdf.js(Apache-2.0)。
- 能力边界:注释级编辑(开源方案不支持无损改写既有正文文字);加密 PDF 暂不支持。
9. 文件管理侧边栏(类 VSCode 活动栏 + 面板)
编辑器内嵌活动栏 + 可拖拽调宽面板区;首期「资源管理器」= 懒加载目录树
(展开实时读取、点文件打开、差异角标、活动文件高亮、edrv:refresh / 手动 ⟳,
可通过命令栏切换显隐并持久化),侧栏形态默认收起以节省面板宽度。
- 拖拽调宽下限 = 最小宽度(默认 300,设置 → VSCodeMode → 通用「编辑器」 可调 180–560),拖拽低于最小宽度自动收起。
- 面板经注册表装配(
ctx.provide('edrvSidebarPanels')),新增面板只加一条注册, 不改编辑器布局。 - 资源管理器右键菜单(v0.7.0,对齐 CodeBuddy 参考图,区分文件 / 文件夹 / 根空白区):
- 文件:打开方式…(已注册打开器中选择)| 在文件资源管理器中显示 | 添加引用 到对话 | 剪切·复制 | 复制路径·复制相对路径 | 重命名…·删除 | SVN 组。
- 文件夹:新建文件…·新建文件夹(名称支持
a/b.c嵌套)| 在文件资源管理器 中显示 | 添加引用到对话·在文件夹中查找…(搜索面板带目录过滤)| 剪切·复制· 粘贴(剪贴板空时灰显)| 复制路径·复制相对路径 | 重命名…·永久删除 | SVN 组。 - 根空白区 = 文件夹菜单去掉全部「仅非根」项;参考图中本架构无法实现的条目 (在集成终端中打开 / 运行测试 / Build 等)不显示。
- 下载到本机(仅远程访问时出现,落在「复制相对路径」与「重命名」之间):
文件直接下载原文件;文件夹与根空白区弹出确认框,按需懒加载展开目录树、
逐级勾选文件后逐个下载(不打包,勾选几个就下几个)。点下载后先选保存文件夹
(Chrome/Edge 安全上下文下用目录选择器;Firefox/Safari 或非 https 回落浏览器
默认下载目录并提示),文件按工作区相对路径写入。判定口径与页面的
远程通道一致(
channelPrefix()非空),本机回环页面不显示。 - 文件管理写操作走
edrv.fsCreateFile / fsCreateDir / fsRename / fsDelete / fsCopy / fsMove(工作区边界 + 同名拒绝 + 名称校验),删除带确认;重命名 / 移动 / 删除与开着的页签自动同步(路径改写 / 关签)。剪切·复制·粘贴为应用内 文件剪贴板(浏览器无系统文件剪贴板,语义对齐 VS Code)。
10. 规则管理(v0.1.49 / v0.1.50,参考 Codebuddy)
活动栏「规则」面板,管理 Cursor / Codebuddy 式 .mdc 规则文件:「用户规则」
(当前 DSH_HOME/rules/,兼容系统用户主目录下的 ~/.dsh/rules/)与「项目规则」
(<工作区>/.dsh/rules/,随仓库共享)双 Tab。DSH_HOME 未设置时默认
~/.dsh,两个用户目录相同则只读取一次。两处同名规则以当前 DSH_HOME/rules/
为准(即使已停用也遮蔽旧规则);删除当前版本后旧目录版本会重新生效。
新建写当前目录,编辑 / 启停 / 删除旧规则在旧目录原地进行,不自动搬迁;
操作旧规则可能影响其他仍使用该目录的 DSH 安装。
- 每条规则显示 文件名 / 相对路径 / 类型徽标(总是 =
alwaysApply、自动 =globs、手动 = 仅索引)/ 描述;右侧常驻 编辑 / 删除 与滑动启用开关 (只改写 frontmatterenabled行,即时生效无需重启)。 - 新建 / 编辑提供面包屑头部 + 类型下拉与描述 / globs 控件,与原始
.mdc文本域双向同步(控件改写 frontmatter,文本域回读控件;enabled与其余键 原样保留)。 - 启用的规则经 host
systemPrompt.section(order 400)注入每次装配:用户规则 全局注入,项目规则按会话工作区注入(单条 16KB / 单域 64KB 截断预算;旧版 DSH 无该服务时自动降级为纯管理 UI)。RPC:rules.list/read/save/remove/toggle。
11. MCP 可视化管理(设置 → VSCodeMode)
子 Tab「我的 MCP」(profile 全局)+「项目 MCP」(各项目根 .mcp.json,
对齐 Claude Code / Cursor,随仓库共享):支持 stdio / streamable-http 的新增、
刷新、启停、删除和运行状态查看。
- 项目作用域(v0.13.0):工具、资源与服务器指令均按 agent 所属工作区隔离; 跨工作区子会话不会因继承父 scope 而获得外项目 MCP。全局 MCP 保持全局可用。
- 实例与状态:每个活动 agent、每个启用项目服务各有一个插件实例;没有活动
agent 时只保存配置(
configured、实例数 0)。instanceCount是挂载实例数,unverified表示没有公开连接状态证据,不能把 fiber ACTIVE 当成已连接。 零工具可能是合法的纯资源服务器。 - 配置保护:reconcile 尊重
disabled;读取/解析错误保留最后有效连接, 不把不可读文件当成空配置。保存保留未知字段和未改动的脱敏凭据。
完整配置、迁移与排错见随包 MCP 技能。
12. 插件自带技能组(v0.3.3)
一组 SKILL.md 随包分发并注册进 DSH 技能系统(自定义 skill provider,
ctx.skills.registerProvider)——装了本插件即可用,无需手工放到
~/.dsh/skills。当前收录 dsh-vscodemode-mcp(MCP 配置与使用指南:
两种作用域 / .mcp.json 写法 / mcp.* RPC / 命名与冲突 / 工作区隔离 /
故障排查表)。装载状态见 设置 → VSCodeMode →「兼容性」→「插件技能组」;
编辑 SKILL.md 即时生效(fs.watch → invalidate)。
- 命名硬约束:技能名必须 kebab-case(
/^[a-z0-9]+(?:-[a-z0-9]+)*$/), 下划线非法(@deepseek-ai/dsh-skill直接拒绝);本插件另加前缀白名单 (不以dsh-vscodemode-开头跳过并告警,避免污染全局技能命名空间)。 - frontmatter:
name(必填,kebab-case + 前缀)/description(必填, 模型靠它判断何时加载)/whenToUse(可选)/disable-model-invocation(true = 不进模型目录,仅人工显式调用)/user-invocable(false = 禁止 人工显式调用);不接受遗留写法disableModelInvocation/modelInvocable/userInvocable。 - 装载与降级:
ctx.inject(['skills'])惰性获取(不写进inject数组), skills 服务缺失时插件其余功能不受影响;服务缺失 / 无registerProvider/ 名冲突 → warn 跳过,不抛错、不影响装配;监听不可用时降级「改动需重载插件」。 - 为什么自研 provider:开发形态(junction 安装)下官方
@deepseek-ai/dsh-skill-filesystem按 realpath 解析 import 会ERR_MODULE_NOT_FOUND(walk 不到 profile 的 node_modules),且每实例会 多拉 chokidar watcher;自研零新依赖、开发 / 正式形态行为一致、可单测。
13. 会话性能管理(设置 → VSCodeMode →「性能优化」)
DSH 启动回放 ~/.dsh/sessions 全部会话(V8 展开约 10×,可能 OOM)。该子页
提供四项治理手段:
- 盘点:全工作区会话体积 / 活跃度 / 新旧一览(
edrv.perf.inventory)。 - 移出归档(可逆):巨型 / 旧会话移到
~/.dsh/sessions-archive(同卷 rename +.manifest.json),免重启即从下次启动回放剔除;支持恢复 / 清除(movePlan / moveOut / restore / purgeArchive)。活跃会话一律拒绝移出。 - 压缩调优:一键把更低
compaction-basic(0.6 / 0.12)与tool-result-pruner(4096)阈值写入 profilecordis.patch.yml(标记块 + 备份.bak-<ts>,可撤销, 重启生效);⚠️ 压缩只追加事件、不重写已持久化日志——存量瘦身靠 「移出到归档」。 - 会话体积指示器:对话 header
edrv-perf-size≥1MB 显示、≥2MB 琥珀、 ≥8MB 红,引导「一次任务一个短会话」。 - 治理原则:存量靠归档、增量靠压缩调优 + 短会话习惯 + 体积指示器;packChunks (chunk 打包存储)为 DSH 默认开启,无需再配置。
14. 外部改动自动同步(v0.4.4)
磁盘文件被外部改动(其他编辑器 / Unity / 脚本 / agent 工具 / 同步盘)后自动 跟进,不必手点 ⟳:
- 观测:客户端每 1.5s 把已打开页签路径批量交给 host
edrv.versions(一次请求多条fs.stat,标签页隐藏时整轮跳过),与本地版本基线比对; 文件树对应目录同步失效,客户端按edrv:file-changed事件去抖强制重列。 - 判定:版本变化后必须再比一次内容(版本令牌含
ctime,格式化工具 / 同步盘的「同字节重写」也会让它变化);内容一致 → 只推进基线(不重载); 内容不同且缓冲干净 → 自动刷入并提示「已同步外部修改」;内容不同且有 未保存编辑 → 绝不覆盖,编辑区提示条三选一(重新加载 / 覆盖磁盘 / 保留本地)+ 状态栏「⚠ 外部已修改」;文件被删 → 提示「已被外部删除」, 缓冲保留。 - 保存护栏:保存带回上次读取的版本令牌,host 用
replaceIfVersion守卫 写入——磁盘被外部改过时拒绝保存并提示「文件已被外部修改」,由用户显式 选择重新加载或用编辑器内容覆盖;冲突未处理期间自动保存被抑制。 - 老 host(无该 RPC)自动降级为无同步、无护栏,不报错。
15. 系统集成(v0.1.53;v0.13.0 更新打开链路)
设置 → VSCodeMode → 通用 →「系统集成」卡片提供文件管理器右键菜单与 Unity 外部脚本编辑器。两者现在共用按 profile 隔离的本机私有 OPEN 请求/ACK 通道, 无需向 launcher 或 Unity 提供 Host Cookie,也不依赖固定 HTTP 端口。
① 文件管理器右键菜单
- Windows 提供文件、目录、目录空白处三类入口;Linux 提供 Nautilus 脚本与 Dolphin 服务菜单;macOS 提供 Finder Automator 快速操作配方。
- 注册和移除必须由用户在设置页显式操作。插件 reload/更新只升级已注册的 launcher 文件及配置,保留所选 profile;不会自动重注册或撤销系统菜单。 卸载插件前如需清理菜单,请先点「移除注册」。
- Windows 优先使用编译后的 C# launcher,缺少编译器时回退 PowerShell;
POSIX 使用 Bash launcher。三个入口统一调用随包
dsh-open.mjsproducer, 从配置读取所选 profile、私有收件箱和运行程序。 - 已打开的客户端可以领取请求并就地打开。需要唤起时,Desktop 使用官方
dsh://open入口,Web 使用用户选定的完整应用地址(含实际端口和部署子路径)。 唤起窗口或领取请求本身不代表打开成功。
打开与回执规则
| 阶段 | 行为 |
|---|---|
| 投递 | producer 将带请求 id、目标 profile、路径和可选行列的 OPEN 请求写入当前用户私有队列 |
| 领取 | 客户端领取带 lease 的请求,按工作区/会话路由到文件编辑器 |
| 确认 | 只有目标路径对应的实际 Monaco model 或预览内容成功就绪,才提交匹配请求与 lease 的成功 ACK |
| 失败/超时 | 返回失败或未确认;不会把一个已展开的空页签视为成功 |
请求按 profile 与请求身份匹配,队列内容受类型、大小、时效和本机权限检查约束;
producer 只承担「打开」请求,不是通用 RPC 代理。旧 edrvOpen/edrvPaths URL
参数仍作为兼容入口保留,已不是 launcher 和 Unity 的当前主链。
文件与目录仍按现有工作区路由:工作区内文件进入相应会话;无会话时可创建会话; 目录根据是否位于已注册工作区内选择复用或新建。选择取消会结束该请求。行列定位 与真正加载的目标文件绑定,避免切换文件时把其他 model 的内容当成完成证据。
② Unity 外部脚本编辑器(内嵌包 com.dsh.editor 0.3.1)
- 在设置卡片中选择 Unity 项目,执行安装/更新,将随包 UPM 目录复制到
<项目>/Packages/com.dsh.editor;无需修改项目 manifest。 - 首次安装会自动准备当前 profile 的独立 bridge,并写入本机项目提示
<项目>/UserSettings/dsh-editor.ini;无需先注册系统右键菜单。 - 在 Unity Preferences → External Tools 选择「DSH 文件编辑」。双击文本脚本、 Console 报错行列或使用打开项目入口,会通过统一 producer 等待 ACK。
- Unity 的「DSH 桥接配置」可填写绝对路径覆盖自动选择。优先级为:UI 显式覆盖 → 项目 UserSettings 提示 → 提示缺失时的旧 shell 配置回退;损坏提示会报错, 不会静默切换到另一个 profile。
UserSettings 提示包含本机 profile 路径,不适合作为团队共享配置。换机器或切换 profile 后应重新安装/更新桥接,或在 Unity UI 中显式指定对应 bridge 配置。
Unity 包保留文本/代码扩展名白名单与用户自定义扩展;Prefab、场景等资产仍交还 Unity 原生处理,不生成 csproj。Unity API 与 EditorPrefs 在主线程使用;后台任务 负责 producer 与 IO。安装目标已有同名目录但不是本包时拒绝覆盖,卸载仅删除该包目录。
- 管理 RPC:
edrv.integration.status/register/unregister、edrv.unity.list/add/remove/install。 - 保存文件仍遵循当前会话沙箱策略;外部打开成功不扩大文件写入权限。
- 当前验证边界:Windows 官方 Desktop 已完成隔离启动与侧栏挂载等检查;Unity 仅有 C# 编译桩与 9 项 hint 探针,尚未执行真实 Unity EditMode。Linux/macOS 尚无本轮现场验证。具体完成项与待验收项见 0.13 发布说明。
16. SVN 集成(v0.5.0)
底座是 svn CLI(跨平台,自动探测 svn --version / 工作副本根),
TortoiseSVN(TortoiseProc.exe)仅作 Windows 过渡增强:自研能力覆盖后对应官方项自动隐藏。
- 状态与变更:侧栏「SVN」面板列出工作副本变更(
svn status --xml --no-ignore), 按状态着色与字母徽标、changelist 分组、未版本控制 / 忽略项开关、行内右键动作; 文件树行尾同步显示状态徽标。 - 动作:更新、刷新变更、与基线比较、加入版本控制、还原(破坏性动作均带确认)、 清理工作副本(默认只清锁);未覆盖的项回落 TortoiseSVN。
- 页面内非模态浮窗(v0.15.4):SVN 更新、日志、统计、补丁、目录对比及智能整理窗口与文件编辑共用浮窗外壳,可拖动标题栏移动、拖动右下角调整大小、点击置顶;窗口外仍可操作 DSH。文件对比独立浮出,不再替换主编辑区,打开其他文件时保留对比;关闭来源于更新窗口的对比时回到同一更新任务。确认与区间选择仍使用模态弹窗,日志快捷键只在日志窗口内处理。
- 更新窗口(v0.11.0):
SVN 更新打开插件内窗口——实时逐文件列表与动作着色(A/U/D/G/C/E/R)、 完成汇总(版本号 / 计数 / 耗时 / 截断告警)、按右键目标限定路径作用域(只更新该子目录)、 命令栏 / 文件树 / 页签 / 编辑区右键四入口一致、可取消;运行中任务按工作副本根去重且刷新或 重开弹窗时重挂附着同一任务(不重复启动);被中断的 svn 操作锁住工作副本时识别E155037并给出「执行清理」引导(调svn.cleanup,不自动重跑更新)。 - 日志弹窗视觉(v0.11.0):信息层级、修订序列签名元素、动作语义色归位重做, 过滤 / 排序 / 多选 / 键盘 / 右键 / 拖拽行为不变。
- 日志弹窗(对标 TortoiseSVN Revision Log Dialog):过滤语法(空格=AND /
-排除 /+纳入 /!取反 /"短语"/ 正则)、From-To 日期区间、列头排序 + 复位、 上中下三段布局(列表 / 提交信息 / 变更路径,边界可拖拽)、Actions 徽标、 受影响路径灰显或隐藏、Copy from 列、右键菜单、F5/↑↓键盘、 多选(Ctrl / Shift)与「比较两个修订」、Stop on copy、Show Range 区间、 Include merged revisions(-g,合并进来的修订灰字缩进)、 Show All(上限 5000 条,超出用区间取)、Statistics 统计窗(期间 / 按作者 / 按日期)、 工作副本版号行加粗。 - 并排差异:
与上一版本比较(cat -r REVvsREV-1)、比较两个修订(-r M:N方向按选中顺序)、与工作副本比较、某版本 ↔ 工作区,均复用同一差异视图。 - 诊断日志:统一日志器 +
edrv.dlog.*RPC + 命令栏「查看诊断日志」, 排查白屏 / 加载失败时先看它。 - RPC:
svn.status / changes / diffBase / revert / add / log / diffRev / diffPair / diffWorking / wcRev / cleanup / update / tortoise;更新窗口新增svn.updateStart / updatePoll / updateCancel / updateActive(svn.update保留兼容)。
说明:
plans/(含对标蓝图与实测结论)为本地开发资料,不入库。
17. 断点调试(DAP,v0.6.0)
编辑器内断点调试(DAP 桥通用化:适配器由扩展清单 contributes.debuggers 驱动,
不限定语言;Lua 链路复用已装 emmylua 扩展适配器,零游戏侧改动):
- 断点:编辑器行首点击(或
F9)切换断点,红点/灰点(禁用)持久化跨刷新保留; 鼠标悬停在行首/行号区时显示半透明预览红点并切换为手型光标(对齐 VS Code 的 breakpoint hint); 侧栏「调试」面板断点列表支持启停复选框 / 删除 / 点击跳转(VS Code 断点视图形态)。 - 断点右键菜单与编辑浮层(逐条对齐 CodeBuddy / VS Code 内核,文案取自官方中文语言包):
空行 →
添加断点/添加条件断点.../添加记录点.../添加触发的断点...; 已有断点 →删除 断点(Delete)/编辑 断点…/禁用断点(记录点场景名词自动切换为「记录点」); 暂停中额外追加运行到行。「编辑断点…」打开整宽行内浮层(View Zone:横跨整个编辑区、 把下方内容推开,并高亮目标行):左侧「模式下拉」(表达式/命中次数/日志消息/等待断点)+ 右侧单行输入框,切换模式时各模式内容独立记忆;Enter确认、Escape取消 (提示写在输入框占位里)。 - 启动:编辑区右上浮动工具条选择配置(读取工作区
.dsh/launch.json——插件专属文件, 与 VS Code 的.vscode/launch.json互不干扰,旧共用文件首次读取时自动迁移过来;类型可用性由 扩展清单裁决:未发现适配器/入口缺失的类型在下拉置灰并给原因)→F5启动/继续。emmylua_attach按进程名自动附加(复刻 VS Code 扩展的进程枚举语义:窗口标题/进程名包含匹配, 多候选时工具条切进程选择器明确选择)。 - 命中暂停:断点命中自动打开对应文件并高亮停帧行;适配器上报 chunkname 由插件工作区
索引反向映射为工作区文件(
findFileReq反向请求应答)。 - 四段调试面板(活动栏「调试」):调用堆栈(点击跳转)/ 变量(懒展开树,Variables + ENV)/ 监视(表达式持久化,暂停态求值)/ 断点 + 底部调试控制台(REPL 输入表达式即时求值)。
- 实现:host 半 DAP 桥(
src/dap/*)spawn 扩展清单声明的 DAP 适配器(runtime: node跑 js 入口 / 无 runtime 直启原生 exe,清单args随行),事件经缓冲 + 400ms 活跃轮询上抛;断点先落 host,适配器就绪(initialized)后全量下发,并按适配器能力位 发送configurationDone收尾握手(emmylua 未声明该能力 → 不发,行为不变)。.dsh/launch.json配置全量透传给适配器(未识别字段原样保留,${workspaceFolder}/${cwd}已替换;${command:...}为 VS Code 命令占位,启动时明确报错而非假解析)。 命中行解析用 Monaco 官方getTargetAtClientPoint(手算需扣padding-top,实测易错行)。 - 回执与多线程:断点回执消费适配器真实响应(可能挪行/判不可验证),未验证断点渲染 空心红圈(对齐 VS Code);栈帧 id 用适配器原生值(emmylua 保持栈下标私有语义), stopped 事件携带的真实 threadId 贯穿调用栈/单步/暂停(多线程适配器必需,emmylua 恒 1 不变); 断点按适配器声明语言过滤下发,杜绝跨语言串发。
- 能力边界:
emmylua_attach仅 Windows(适配器原生限制);适配器自动探测~/.vscode/extensions、~/.vscode-server/extensions与插件扩展目录~/.dsh/dsh-vscode-mode/extensions(与 LSP 探测根一致);求值/查看变量需处于暂停态。运行到行= 临时断点 + 继续(命中/手动继续后自动清理,不污染用户断点表);添加触发的断点...当前适配器不支持 → 点击给出明确提示(不做静默失败的假功能)。
18. 界面状态记忆(v0.14.0,跨重启)
DSH 每次启动监听随机端口,http://127.0.0.1:<port> 就是浏览器 origin,只写
localStorage 的界面状态换一次启动就全丢。本版把界面状态镜像到 DSH home,重启后
自动恢复。
- 记忆项:打开的页签与活动页签(含固定态)、每个文件的光标与滚动位置(Monaco
saveViewState())、侧栏开关/宽度/面板、资源管理器展开与工作区折叠、官方编辑 Tab 激活态、Markdown 预览态(按文件)、导航历史(前进/后退)、规则分页、搜索面板、 SVN 过滤与折叠、调试面板监视与折叠、DAP 四段分栏高度、断点(按适配器语言)。 - 存储位置:
DSH_HOME/dsh-vscode-mode/cache/workspace/<hashOf(cwd)>/ui.v1.json(工作区私有)与cache/user/ui-globals.v1.json(跨工作区共享,如工作区折叠)。 写前合并,同一文件内多工作区/多键互不覆盖;单键超 64 KB 分片上传。 - 不镜像:目录条目缓存(
edrv.cache.entries.v2.*,体积大且可重建);临时弹窗、 未落盘的编辑缓冲不恢复。 - 恢复语义:启动时取回镜像回填
localStorage,本地已有值一律保留(不覆盖 当前 origin 的真实状态);回填完成后广播edrv:ui-state-ready,晚到的界面组件据此 重跑恢复。取回失败按 8×800ms 有界重试,重试耗尽则退回纯localStorage(行为与 0.14.0 之前一致),不阻断插件加载、不拖慢启动(slot 注册前最多等 600ms)。 - 自检:设置页「兼容性」与 RPC
edrv.compat可查看运行时报告;镜像读写的时间线记在DSH_HOME/dsh-vscode-mode/logs/debug.<hashOf(cwd)>.log(无会话期诊断落在debug.<hashOf('ui-state')>.log)。
19. 远程访问兼容(经第三方远程访问插件访问)
宿主 /edrv/* 的准入是 connection.requestRejection(),Host 围栏优先于登录态:
只认 loopback、监听 bind IP 与 trustedHosts。远程设备访问时 Host 不符即 403,
与是否已经登录无关(401 才是登录失效)。第三方远程访问插件
(@linxin666/dsh-remote-web-ui 等)把 /api/、/sidebar/、/git/、/pet/ 改写到它的
/remote 通道,/edrv/ 不在白名单内,所以文件管理器 RPC 与 Monaco 静态资源全部直连
宿主被拒。
本插件按「通道前缀」适配(src/shared/remoteChannel.ts):
- 判定:远程通道在
<head>解析期安装座位对象__DSH_REMOTE_CHANNEL_BOOT__; 存在即认为本页经远程通道访问,前缀取/remote,否则为空串。 - 覆盖:
/edrv/rpc(业务 RPC 与二进制预览)、Monaco 的loader.js/ AMD 模块 /editor.main.css/ codicon 字体 / 语言 Worker(随paths.vs继承)、pdf.js 的 worker 与 cmaps、/edrv/assets/*图片全部走transportUrl(),appUrl()继续负责 应用 base 与桌面dsh-app://协议,不硬编码主机或端口。 - 为什么不是
/api/edrv:远程插件的补丁只改 fetch / EventSource / WebSocket 与<img|script|iframe>.src,<link rel=stylesheet>、CSSurl()、new Worker、 ESMimport都不经过补丁;服务端/remote/<内部路径>才是覆盖全资源类型的正式通道。 - 安全与兼容:不新增路由、不改
admitRoute、不公开任何静态资源;/remote门禁 仍要求已配对设备(其设备 cookie 同源携带),转发到回环后本插件的权限校验照常执行; 本地与桌面入口保持/edrv/*原样,未装远程插件时行为不变。
20. 模板语言高亮与语言映射审计(v0.30.0)
- 模板语言注册(
src/client/monaco/templateLanguages.ts):随包 Monaco 只有 handlebars / mustache / pug / twig / liquid / razor / freemarker2;本插件额外注册 EJS / Eta(ejs)、ERB(erb)、Nunjucks(nunjucks)、Jinja2 (jinja)、Laravel Blade(blade)、Haml(haml)、Slim(slim)。 每个语言带 Monarch 词法(HTML 骨架 + 分隔符内代码段)与注释/括号/自动闭合配置; 注册在editor.main加载完成的同一回调里、任何createModel之前,幂等且单语言失败 不影响其他语言。只做词法分色,不提供语义服务。 - 语言映射三级解析(
langOf):点文件名(.eslintrc/.gitconfig/.env*…)→ 复合后缀(.blade.php、.d.ts)→ 末段扩展名;全程小写归一,未知回落 plaintext。 - 审计测试(
tests/langMap.test.ts):解析随包editor.main.js的语言贡献表, 断言映射值真实存在、自定义 id 不与内置冲突、覆盖官方映射必须显式登记。 升级 Monaco 后该测试会给出差集,避免「静默丢色」。
21. 搜索面板全局替换(v0.30.0)
搜索框右侧 ⇄ 展开替换行(设置 → 通用「搜索替换」开关,默认开):
- 全部替换:先
dryRun预览命中数与文件数 → 确认弹窗 → 逐文件写入; 结果分组头的 ✎ 只替换该文件的命中。 - 语义与搜索一致:大小写 / 全词 / 正则(支持
$1)/ 包含 / 排除; 字面量模式下$原样输出;可匹配空串的模式(如a*)直接拒绝。 - 保真:按行替换,CRLF 与 BOM 原样保留,只改写命中行。
- 安全:执行前经
edrv:flush-all让所有编辑器落盘(3s 上限,超时中止); 逐文件replaceIfVersion守卫,写盘瞬间被改动的文件记为该文件失败并继续; 单次 ≤200 文件、单文件 ≤8MB,二进制/非普通文件跳过。
22. 会话引用接入(v0.30.0)
设置 → 通用「引用接入」开关(默认开),三条通道都只在官方对话输入区生效:
- 拖文件进来:资源管理器文件行拖进输入框 → 引用 chip(内部 MIME
text/x-edrv-path); - 复制选区:编辑器里跨行(或整行单行)复制 → 剪贴板写入
@相对路径 Lx-Ly, 粘贴回输入框落成 chip;半行选区仍按普通文本复制; - 粘贴文件:从系统文件管理器复制项目内文件后粘进输入框 → 按文件名解析成引用; 图片仍走 DSH 原生附件。
路径解析走 host edrv.resolveRef(绝对路径 → 相对路径 → 文件名检索),多义时提示候选、
不瞎插;解析失败回退纯文本,不吞内容。旧版 DSH 或未打开会话时整体静默不生效。
安装
官方 dsh plugin 方式,三选一。下面以 web profile 为例;Desktop 或其他命名
profile 请替换为实际目标,不要把示例目录当成当前运行 profile。
升级须知:近期版本的修复要点、验收缺口与回退边界见更新日志; 从 0.14.2 或更旧版本升级还须阅读0.14.3 数据迁移与回退说明。
# ① Git 安装(clone + prepare 构建;推荐打固定 tag)
dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.30.0
# ② npm 注册表(发布到 npm 后)
dsh plugin --profile web add dsh-vscode-mode@0.30.0
# ③ GitHub Release tgz 直装(Release asset 可用后)
dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.30.0/dsh-vscode-mode-0.30.0.tgz
DSH 版本政策(0.17.0 起):六项 DSH peer 仍统一声明为
*,另以engines.dsh: ">=0.1.0-rc.1 <0.3.0-0"显式声明支持的 DSH 运行时区间——engines.dsh一旦声明就单独决定兼容性(官方实现:An own engines.dsh range decides alone and peerDependencies are ignored),不满足时安装会被直接拒绝。 该区间接受 0.1.0-rc.1 起的全部 0.1.x / 0.2.x,拒绝 0.3.0 及以后的主版本; DSH 自身以includePrerelease求值,故 alpha、rc 与正式版同等对待。 运行时仍按实际能力检查;允许安装不代表该版本已通过全功能验收。 已发布包仍以其实际声明为准;npm 安装前应确认注册表中版本可查询。 替换已有包后需重启目标 DSH Host 并强制刷新原页面;仅刷新不会更新 Host。 从 0.14.2 或更旧版本升级时,首次访问工作区会执行 0.14.3 引入的 SQLite 活跃记录迁移。
dsh plugin ...是 pnpm 转发器:git 安装会克隆仓库、执行该包prepare脚本 (tsdown 双面构建)后安装,再按dsh.bundle声明自动加入 profile 的 bundles 层。若 pnpm 提示构建脚本需批准,把 key 加到~/.dsh/profiles/<profile>/pnpm-workspace.yaml的allowBuilds后重跑。
安装即生效,无需任何手动配置:本包自带的 cordis.patch.yml 是标准 bundle
自挂载补丁(- insert: { id: dsh-vscode-mode, name: dsh-vscode-mode }),加入
bundles 层后重启 DSH 即自动把插件行挂进 loader 树。不要再往 profile 用户层
cordis.patch.yml 手写 insert(旧的非标准做法,会与本 bundle 行撞同一 id,
触发 duplicate loader entry id 启动失败)。
自定义配置(如图标目录 imageDir)用 id 定向覆盖合并到 bundle 行上,
而不是再 insert 一次:
# ~/.dsh/profiles/<profile>/cordis.patch.yml(用户层,应用顺序在 bundle 层之后)
- id: dsh-vscode-mode
config:
imageDir: C:/Users/me/Pictures # 可选,默认读插件包内 assets/
迁移提示:若你之前按旧版指引在 profile 用户层手写过
insert(id 恰为dsh-vscode-mode),升级后请把那一段insert改成上面的 id 定向覆盖 (或直接删除),避免与本 bundle 行重复装配。
- 更新:
dsh plugin --profile web update dsh-vscode-mode - 卸载:
dsh plugin --profile web remove dsh-vscode-mode
使用指南
打开文件
- 文件树:资源管理器面板点击打开;文件链接(DSH 0.1.5+):聊天 / 文件树 里的文件链接直达右侧栏编辑器(含行号定位)。
- 快速打开:执行插件 QuickOpen 命令(键位见「设置 → 快捷键」)——
↑↓选择、Enter打开高亮项、Esc关闭,鼠标悬停与高亮同步;Ctrl+P由官方文件切换使用。 - 差异入口:对话输入框上方 dock 的「差异 N 个文件 · 查看下一个」按钮。
快捷键速查
以下是桌面端常见默认键位;Web / Linux 的浏览器或系统保留键可能不绑定。
实际生效键位以 DSH 官方快捷键配置为准:设置 → VSCodeMode → 通用 →「打开官方
快捷键配置」(或 Ctrl+/)。插件命令与官方命令同表展示、由官方统一校验冲突;
旧版 DSH 无官方 shortcuts 时沿用原有键位。
| 快捷键 | 功能 |
|---|---|
Ctrl+Alt+P(桌面)/ Ctrl+Alt+Shift+P(Web Windows/macOS) |
插件快速打开文件(QuickOpen);Ctrl+P 由 DSH 官方文件切换使用 |
Ctrl+Shift+P / F1 |
命令面板 |
Ctrl+U |
选中内容加为引用(Add Selection to Chat) |
Ctrl+S |
保存(另有 700ms 防抖自动保存) |
Ctrl+F / Ctrl+G |
查找 / 跳转行 |
F12 / Shift+F12 |
转到定义 / 查找所有引用 |
Ctrl+点击 / Ctrl+hover |
引用导航 / 可导航标识符提示 |
| 自定义键位 | 切换文件管理侧边栏(Ctrl+B 与 DSH 自身侧栏命令冲突,插件默认不绑定) |
| 以当前官方目录为准(Web 采用平台允许的组合) | 工作区搜索(有选中则填入搜索框);不保证所有平台都使用 Ctrl+Shift+F |
Ctrl+Shift+V |
切换 Markdown 预览(仅活动文件为 .md 时生效) |
Ctrl+F4 |
关闭当前页签 |
Alt+← / Alt+→ |
后退 / 前进(跨文件恢复焦点位置) |
Ctrl+Alt+- / Ctrl+Shift+- |
后退 / 前进(同导航历史) |
| 鼠标侧键 XButton | 后退 / 前进 |
Tab / Enter(补全中) |
展开代码片段 |
F9 |
调试:切换光标行断点 |
F5 |
调试:启动 / 继续 |
F10 / F11 / Shift+F11 |
调试:单步跳过 / 步入 / 步出(暂停态) |
Shift+F5 |
调试:停止 |
差异审查流程
- agent 执行
edit/write后,对话输入框上方出现差异 dock。 - 点击「差异 N 个文件 · 查看下一个」打开侧栏编辑器并聚焦差异;编辑器打开后 dock 变为完整操作条:Keep(采纳)/ Undo(拒绝)/ 跳转 / 回滚 / 归档对比。
- 每条差异处理完成立即归档;DiffLauncher 全局总览支持按批次浏览 + 回滚;
状态持久化到
.dsh-edit-review.json,重启不丢。
引用、片段与 LSP
- 快捷引用:选中内容
Ctrl+U(或页签右键 / 文件树右键),插入点跟随输入框 光标,送入对话上下文。 - 代码片段:
Ctrl+Shift+P→「配置代码片段」编辑.code-snippets;编辑代码 时prefix自动 IntelliSense 补全,Tab/Enter展开。 - LSP:
F12转到定义(多结果弹 Peek 选择)、Shift+F12查找引用、Ctrl+点击导航;取不到定义自动降级「转到引用」。补全随输入./:/(/[自动弹出(Ctrl+Space手动触发,Tab/Enter采纳),函数实参处显示签名帮助。
配置
键位配置统一走 DSH 官方快捷键:设置 → VSCodeMode → 通用 →「打开官方快捷键配置」
(等价 Ctrl+/;官方入口不可用时按钮就地给出手动打开方式)。录键、冲突校验、
按平台默认值、恢复默认都在官方弹窗内完成,插件不再自建录键页面。键位持久化由官方
服务负责(Desktop:userData/keybindings.json;Web:localStorage 的
dsh.keybindings.v1)。旧版插件 keybindings 配置的单候选自定义值按当前平台
一次性尝试迁入官方存储;旧配置始终保留供其他平台及人工恢复,多候选、冲突、
不支持或未绑定的旧值不会被部分迁入或删除。
v0.13.0 在 0.12 官方接管的基础上修正真实 normalized 绑定与物理 Control/Meta
的转换;首次打开命令面板/QuickOpen 等入口按当前会话 scope 路由,不要求编辑器先挂载。
Web 工作区搜索使用官方当前平台允许的三修饰符组合,最终显示与冲突判断以官方目录为准。
v0.13.1 起插件不再自建录键界面(原独立「快捷键」设置页与共享录制模块已移除),
改由通用页的「打开官方快捷键配置」入口直达官方弹窗。
设置 →「VSCodeMode」页:
| 分区 | 说明 |
|---|---|
| 通用 | 编辑器宽度(180–560)等 / 系统集成卡片 / 文件链接使用工具 / 开发形态开关 / 官方快捷键配置入口 |
| 我的 MCP / 项目 MCP | MCP 服务器可视化管理(stdio / streamable-http) |
| 性能优化 | 会话盘点 / 移出归档 / 压缩调优 / 侧车摘要指引 |
| 兼容性 | 兼容性报告(外部插件探测、路由 / 重复装配护栏)、插件技能组装载状态、旧版形态引导 |
截图
以下截图取自 v0.23.5 的真实运行界面(DSH Web GUI + dsh-vscode-mode 右侧栏)。
同屏工作台

AI 对话(中央)与 Monaco 文件编辑器(右侧官方 Sidebar)同屏;页签带差异角标, 底部原生 dock 汇总「差异 N 个文件」并提供 Keep All / Undo All。编辑器打开时 面板区可收起(
Ctrl+B切换,图标列常显),把宽度全部让给代码。
命令面板

Ctrl+Shift+P打开命令面板,命令按类别分组并支持模糊搜索;命令既可来自扩展清单 注册,也可由插件通过edrv.executeCommand编程调用。
差异审查

资源管理器展开工作区文件树(带差异角标),编辑器用行内红绿高亮展示 Agent 改动, 底部 dock 可逐文件切换、Keep / Undo,并提示当前记录还有几个待审文件。
开发
构建(自足,无需 DSH 源码 checkout)
pnpm install # 安装 devDeps(typescript/tsdown/@types/node/@types/react/react/vitest)
pnpm build # tsdown 双面:lib/index.js(host esm)+ lib/client.js(client cjs)
pnpm typecheck # tsc --noEmit
pnpm test # vitest 纯函数用例
npm pack # 产物 tgz(含 lib/assets/src/cordis.patch.yml)
scripts/build.sh 被 dev_build_plugin 等注入工具调用(本地标准构建)。
prepare 脚本 = 构建,git 安装 / npm publish 都会自动执行。
开发形态(devForm)
开发形态 = 当前运行 profile 以 link: 依赖和链接入口指向源码目录。设置 → 通用
可查看和切换形态;切换成功后需要重启 DSH 才能加载新的 Host 代码。
- 定位当前 profile:优先使用官方
profileContext.dir;旧宿主仅在依赖本插件的 profile 候选唯一时回退。服务信息无效或候选有歧义时拒绝切换,不猜测web目录。 - 失败恢复:写入前备份 manifest、lockfile 和原安装入口;安装失败时恢复原内容 与链接身份。若恢复本身失败,会保留备份位置供处理,不能宣称已经恢复成功。
- 开发目录校验:要求绝对路径、正确包身份,且不位于被替换的 profile
node_modules内;移除链接只处理链接本身,不递归删除源码。 - 运行程序:有官方
profileContext.packageManager时使用它提供的程序、参数和 显式环境(含 Desktop 自带运行方式);旧宿主再回退 PATH。
程序化调用继续使用插件已有 RPC,但须经当前已鉴权应用的同源通道;未携带有效
Host 身份的裸 HTTP/curl 请求不再是支持的接入方式。请求地址应保留应用子路径,
Desktop 应沿用当前 dsh-app: 应用上下文,不拼接固定 localhost 端口。
| 方法 | args |
行为 |
|---|---|---|
vscode.devFormGet |
{} |
读取当前形态,兼容性报告也包含 devForm |
vscode.devFormSet |
{ "enabled": true, "path": "<源码绝对路径>" } |
开启开发形态;按返回的 restart 重启 |
vscode.devFormSet |
{ "enabled": false } |
切回当前插件版本的正式依赖;按返回的 restart 重启 |
源码结构
src/
├── index.ts Host 入口:name/inject/apply(薄装配,含兼容性报告启动日志)
├── shared/ ★ 双面契约(禁 node/react):types/rpc/compat/mcp + remoteChannel(远程通道前缀)
├── compat.ts ★ Host 兼容层:外部插件探测、路由/重复装配护栏、兼容性报告
├── devForm.ts Host 开发形态管理:link:/junction 切换(RPC vscode.devForm*)
├── model.ts Host 纯域逻辑(可单测):normalize/markDecision/summary/批次/归档
├── store.ts Host 存储层:sidecar 读写合并 + 归档持久化 + stale 检测
├── workspace.ts Host 工作区文件扫描(TTL 缓存)+ 快速打开搜索
├── revert.ts Host 回滚/删除(fs + subprocess,fs.contains 边界校验)
├── registry.ts Host 每工作区记录桶注册表
├── tree.ts Host 目录树纯函数(normalizeRel/toTreeEntries,可单测)
├── rules.ts Host 规则管理:.mdc 解析/开关改写/注入渲染 + systemPrompt 装配
├── skills.ts Host 技能组:SKILL.md 解析/扫描 + skill provider 注册(可单测)
├── fileVersions.ts Host 文件新鲜度观察:批查版本令牌 + 失效目录树索引(可单测)
├── rpc.ts Host RPC 分发表(类型化 handler 表替代巨型 switch)
├── routes.ts Host webServer 路由(/edrv/rpc、/edrv/assets/*、/edrv/vendor/*)
└── client/
├── index.ts Client 入口:slot 注册;官方/betterSidebar/中央页签三形态互斥分流
├── compat.ts ★ 设置桥四级降级+晚到重试(configForms→webUiSettings→settingsScope)、slot 安全注册
├── officialSidebar.ts ★ 官方右侧 Sidebar 桥(DSH 0.1.5+,唯一维护面)
├── sidebarBridge.ts betterSidebar 桥(归档,仅旧版回退)
├── rpc.ts / events.ts / watchDecision.ts(外部改动同步纯逻辑)
├── state/ records.ts(摘要/计数/空差异)+ regions.ts(差异区域/行裁剪)
├── monaco/ loader.ts(AMD 加载/语言映射)+ diffRender.ts(差异自绘渲染)
├── pdf/ pdfLoader.ts + pdfPanel.ts(PDFViewer 接线/注释/保存回写)
├── pdfPreview.ts / imagePreview.ts / diffDock.ts(纯函数,可单测)
├── sidebar/ ★ 面板系统:registry.ts + SidebarView.ts + panels/(文件树/搜索/规则)
├── styles/editor.css 编辑区样式(tsdown CSS-inline 注入)
└── ui/ EditorView / OfficialSideTab / QuickOpen / DiffBox /
ConversationDiffDock / DiffLauncher / DiffBadge / McpSettings
随包目录(package.json 的 files):lib/(构建产物)、assets/(Monaco /
pdf.js vendor + 图标 + launcher)、skills/(插件技能组)、src/(随包发布,
便于阅读实现)、unity/(内嵌 UPM 包)、cordis.patch.yml。
架构要点
- 捕获:Host 监听
tools/result,对edit/write取result.value+result.meta.diffs落记录。 - 持久化:工作区旁车
.dsh-edit-review.json(version 2,按 cwd 分桶,写前 合并,v1 自动迁移);归档.dsh-edit-review-archive.json(按 path+batch 合并批次,含每 hunk 决策与 before)。 - RPC 与资源路由:
/edrv接口先经官方connection.requestRejection(req)校验 Host 身份,认证能力缺失时拒绝请求。RPC 校验方法、JSON content-type、 envelope 和对象参数,同时检查 Content-Length 与实际读取字节上限;响应不缓存。 Client 按应用 document base 解析 RPC、资源与 vendor URL,保留反向代理子路径, 支持 HTTP(S) 和 Desktop 的dsh-app:来源。 - 批次 / 融合 / 归档:每次新 edit/write 递增文件 batch,早于最新批次的未归档 差异自动"融合"归档;每条差异处理完成立即单条归档;DiffLauncher「归档」页按 批次浏览 + 回滚。
- Client 挂点:官方右侧 Sidebar Tab(DSH 0.1.5+:类型定义 id
dsh-vscode-mode、 kindedrvEditor,正文挂 keyed slotsidebar.right.pane.tab;优先级最高)> betterSidebar Tabedrv-editor(归档,仅旧版回退)>conversation.view页签 (idedrv-editor)+conversation.session.header.utilities(idedrv-diff-badge)conversation.input.dock(idedrv-diff-dock,唯一差异栏)。内部路由 / slot / 事件 / CSS 前缀沿用edrv-*(防回归),包身份dsh-vscode-mode。
- 兼容层(
src/compat.ts+src/client/compat.ts):运行时探测@deepseek-ai/dsh-mcp-client、设置桥(configForms0.1.7+ →webUiSettings→settingsScope,含 15×2s 晚到有界重试)、/edrv路由前缀冲突与本插件重复装配(duplicate loader entry)护栏;@deepseek-ai/dsh-settings/schemastery动态加载(缺失时插件仍可加载, 设置持久化降级)。「VSCodeMode」设置页 →「兼容性」子 Tab 或 RPCedrv.compat可查看完整报告。 - 扩展缝:新能力 =
shared/rpc.ts加方法 +src/rpc.ts加 handler +client/加组件,其余模块零改动;monaco/*是可复用的编辑器服务(资源树 / 对比 / 诊断面板共用);edrvSidebarPanels注册表承载后续面板(搜索 / 差异 / 时间线),edrv.listDir为通用目录树 API。 - Host 模块来源:动态加载优先锚定运行中 DSH 的入口安装树;已解析模块的执行
错误不会被旧开发依赖副本掩盖。本轮官方 Host 审计与现场基线是
0.1.7-rc.2, 依赖声明、源码能力探测和现场验证是不同层次,详见 版本适配矩阵。 - 子进程环境与回收:LSP/DAP 等共用环境清理,按变量名排除父环境中的
KEY/PASSWORD/SECRET/TOKEN 与
DSH_*隐式信息;用户显式配置的环境仍会传递。 Windows 使用进程树终止,POSIX 使用独立进程组;回收是 best effort,不能保证 清除主动脱离进程组或受系统权限限制的后代进程。 - 代码更新生效:Host 改动需要重启 DSH;Client 需要重建产物并刷新原应用页面。 只有对应开发构建 watcher 和 HMR 接收端同时工作时,才可依赖自动更新。
CI(GitHub Actions)
.github/workflows/ci.yml:push/PR → install → typecheck → test → build →npm pack校验 + 上传 tgz。.github/workflows/release.yml:打v*tag → 同上构建 → GitHub Release (附 tgz)→ 用 Trusted Publishing(OIDC) 发布 npm,不再依赖仓库 secretNPM_TOKEN。前提:npm 包设置里已配置 trusted publisher (Lenonss/DSH_VsCodeMode/release.yml,且允许npm publish); 配置未生效时 publish 步骤以 ENEEDAUTH 失败,GitHub Release 仍照常生成。
开发期注入(超级模组注入器,可选)
- 热装配:
dev_install_package {dir: packages/dsh-edit-review} - 更新:
dev_reload_package {packageName: "dsh-vscode-mode"} - 卸载:
dev_uninject_plugin {match: "dsh-vscode-mode"}(生产环境用dsh plugin remove)
常见问题
1. LSP 一直显示未启动 / 重启后定义与引用失效(v0.3.4 修复)
根因:host 侧文档跟踪(tracker)与服务器注册表(manager)是两套独立结构——
「重新检测 / 保存配置 / 运行时重装」只摘除 manager 条目、保留 tracker 计数,
此后 tracker.open() 对已打开文档恒返回 false,该语言永久不可用直到重启
宿主。修复三处:① sync 在 manager 缺条目时自愈补建(计数不重复增,
见 resolveServer);② 重置类操作同时清 tracker(tracker.reset(root,lang)
与 manager 同范围成对调用);③ 设置页状态改为反映真实运行相位(原先
edrv.lsp.detect 硬编码 idle,卡片恒显「未启动」)。另收尾宿主退出时残留的
LSP 子进程(原先 ctx.effect 清理不覆盖进程退出)。
2. 引用查找完全没反应,无任何报错(v0.4.0 修复)
根因:离线 Monaco 是被裁剪的构建,缺 gotoSymbol / peekView 贡献模块,
editor.action.referenceSearch.trigger 等动作在运行时不存在,Ctrl+点击 与
Shift+F12 走原生 Peek 的路径静默失败。修复:换官方完整构建(
referencesController / peekView / gotoSymbol 齐备,见特性 7),
静默失败同步改为状态栏明确提示。
3. 差异文件里引用 / 定义 / hover 全空;行内差异标记不显示(v0.4.1 修复)
根因:路径形态不一致——差异记录 rec.path 取自工具参数 file_path
(绝对路径),而 LSP 文档键与 server.sync() 拼 file:// URI 的口径都是
工作区相对路径,不归一化时绝对路径会被拼成 <root>/<root>/Assets/... 畸形
URI,服务器视其为不存在的文档。实测同一文件:相对路径 references=3 / symbols=37,绝对路径 0 / 0。修复:新增 toWorkspacePath()(src/lsp/uri.ts)
并在 edrv.lsp.* 入口统一归一化(放入口而非 server 内,否则同一文件会因
形态不同产生两条 tracker 记录、引用计数翻倍),server.sync 另加防御性兜底。
行内差异标记改为经 relativeOf 归一后比较。
4. Ctrl+点击多结果直接跳走、不给选择(v0.4.2 修复)
根因:插件自研的 Ctrl+点击路径在「0 条其它引用」时降级为「查定义 → 跳
defs[0]」,遇到有多个定义但无其它引用的标识符(实测 IsReady 有 2 个
定义)就硬跳第一个;且与原生 gotoDefinitionAtPosition 互相竞争。修复:统一
委托原生——Ctrl+点击 / F12 / Shift+F12 全部走 Monaco 原生命令
(editor.action.revealDefinition / editor.action.referenceSearch.trigger),
多结果弹 Peek 让用户选,取不到定义按 alternativeDefinitionCommand 自动降级
「转到引用」;自研鼠标监听(bindLspEditor)与相关死代码已删除。
5. 冲突差异可看不可点,按钮置灰(v0.4.3 修复)
根因:pending hunk 的 newText 已被后续修改覆盖(定位失败)时 host 标记
conflict 并保留供复核,但单文件 Keep / Undo 原先只认「可定位」差异,而全局
Keep All / Undo All 却是亮的。修复:单文件 Keep / Undo 覆盖冲突差异——Keep
记账后归档;Undo 对已不在文件中的差异不改动文件、直接按不采纳归档(状态栏提示
「其中 N 处已不存在于文件,未改动」)。
6. 快捷引用 / 部分命令被静默隐藏(v0.3.1 修复)
根因:编辑器可用性探测选择器 textarea.inputarea 被 Monaco 的 EditContext
输入通道取代(有该 API 的浏览器下 Monaco 不再创建 textarea),导致本命令与其它
12 条 needsModel 命令被静默隐藏、按键被放行。修复:改用与输入实现无关的判据
.edrv-editor-row .monaco-editor。
7. 技能被忽略(日志「缺少合法 frontmatter」)
根因与约定:skills/ 根目录不要放裸 .md 说明文档(如 README.md)——扁平
.md 会被当作单文件技能解析,缺 frontmatter 时产生告警;约定文档放 docs/。
技能名必须 kebab-case + dsh-vscodemode- 前缀(下划线非法),frontmatter 用
官方字段名(见特性 12)。
8. 远程访问时文件管理器报「DSH 拒绝了当前页面的访问」、编辑器报「Monaco loader 加载失败」
根因:宿主的 /edrv/* 路由准入走 connection.requestRejection(),其中 Host 围栏
(isTrustedApiRequest)先于任何登录态校验——只放行 loopback / 监听 bind IP /
声明过的 trustedHosts。手机、平板或隧道域名访问时 Host 既不是 loopback 也不在
白名单,因此登录态再有效也一律 403(401 才是登录失效)。远程访问插件
(@linxin666/dsh-remote-web-ui)只把 /api/、/sidebar/、/git/、/pet/ 改写到
它自己的 /remote 通道,/edrv/ 不在其中,于是 RPC、Monaco 的 loader/AMD 模块/CSS/
字体/Worker、pdf.js、预览图片全部直连宿主被拒。
修复(纯客户端,宿主路由与鉴权零改动):远程通道在 <head> 解析期会
安装 window.__DSH_REMOTE_CHANNEL_BOOT__ 座位对象;检测到它时,插件把所有内部地址
(/edrv/rpc、/edrv/vendor/*、/edrv/assets/*)统一前缀成 /remote/edrv/...,
由远程插件的服务端 catch-all 代理回环转发——该代理带同源设备 cookie 并换用进程内凭据
重发到 127.0.0.1,于是我们的 Host 围栏与登录校验照常执行且通过;任何子资源类型
(<link>、CSS url()、new Worker、ESM import)都覆盖,不依赖主线程 fetch 补丁。
本地页面、桌面 dsh-app://、未装远程插件时前缀为空,行为与之前完全一致。
- 未做也不建议:把所有
/edrv/硬改成/api/edrv/(补丁不覆盖link.href/Worker/模块 import,会留下半成品);公开 vendor 路由;要求手工配trustedHosts。 - 诊断:加载失败会先 HEAD 探测真实状态码再给结论——403 指「宿主拒绝了当前页面」、 401 指登录态失效、404 指资源缺失、0 指请求没到宿主;远程通道 403 若是设备未配对, 会直接提示「远程访问设备尚未配对」。
更新日志
完整变更见 GitHub Releases。
| 版本 | 要点 |
|---|---|
| v0.30.0 | 模板语言高亮(EJS/ERB/Nunjucks/Jinja2/Blade/Haml/Slim)+ 语言映射审计;搜索面板全局替换(预览确认、落盘前置、逐文件版本守卫、CRLF/BOM 保真);会话引用接入(拖文件/复制行引用/粘贴文件,多义不瞎插);设置新增「交互」开关 |
| v0.29.2 | 设置界面优化:轻量分组、字段说明与控件对齐、官方输入原语及状态提示;MCP 加载/失败不再遮挡其他分类 |
| v0.29.1 | 待审行差异引擎精准化:唯一行锚点切分 + 小窗口 LCS,千行文件不再整段替换;修正多 hunk 行号偏移 |
| v0.29.0 | Excel 引擎与编解码改为按需分块(根包 930 KB,打开表格才加载 11.4 MB 引擎);调试 hover / 侧栏拖拽 / 快捷菜单测量性能优化;官方文件侧栏 CSS 运行时兼容 |
| v0.28.0 | dsh-ops 写工具纳入待审差异采集:ops_edit_file / ops_write_file / ops_remove / ops_copy / ops_move 可查看差异、Keep、Undo;ops_replace 按候选预读 + 回执对齐尽力采集 |
| v0.27.2 | 当前编辑文件 Tab 自动滚入可见区域;分组独立定位,适配宽度变化,不抢编辑焦点 |
| v0.27.1 | 修复仅 LF/CRLF 或 BOM 差异造成的空待审与差异栏残留;统一累计待审路径路由并过滤已归档历史记录 |
| v0.27.0 | DSH alpha.3 官方菜单/Forge 导航/设置图标与能力诊断;多目标 patch 字节采集;回滚版本与会话策略守卫;工作区共享差异基线;隐藏轮询门控与导航隔离 |
| v0.26.0 | Keep All 改为单次批量(不再因单条过期/冷端条目整批中止,2N+1 次往返降到 2 次);差异审查旧通道遗留清理:待审接管的旧记录自动结案、守卫改会话作用域、失败原因不再被通用文案吞掉 |
| v0.25.1 | 下载到本机支持选择保存文件夹(目录选择器),按工作区相对路径写入 |
| v0.25.0 | 资源管理器右键「下载到本机」:远程访问时把工作区文件拉回浏览器所在机器 |
| v0.24.0 | 经第三方远程访问插件时,文件管理器与 Monaco 恢复可用;加载失败提示按状态区分 |
| v0.23.5 | 同一文件不再算成两条差异;新建文件按整文件新增渲染 |
| v0.23.4 | 计划卡「查看全文」直通编辑器,不再闪一下再关 |
| v0.23.3 | 已删除文件的差异条目不再卡死;重启后不再成串「采集不完整」 |
| v0.23.2 | 桌面端 Keep 点了没反应的问题修复 |
| v0.23.1 | Keep All / Undo All 在待审超过一页时不再中止 |
| v0.23.0 | 快捷菜单:可拖动悬浮按钮 + 自定义菜单树 |
v0.30.0:新增模板语言高亮(EJS/Eta、ERB、Nunjucks、Jinja2、Blade、Haml、Slim 注册进 Monaco,注册时机固定在
editor.main回调内);langOf改为点文件 → 复合后缀 → 末段扩展名 三级解析(.blade.php、.eslintrc、.gitconfig、.env*不再落纯文本);新增tests/langMap.test.ts解析随包 Monaco 语言表做映射审计。搜索面板新增「全局替换」: dryRun 预览 → 确认弹窗 → 逐文件replaceIfVersion写入,按行替换保留 CRLF/BOM, 拒绝空匹配正则,写盘前经edrv:flush-all落盘已打开页签(3s 上限)。新增会话引用接入: 资源管理器拖文件、编辑器跨行/整行复制@路径 Lx-Ly、粘贴系统文件三条通道落成引用 chip, host 新增edrv.resolveRef三级路径解析;设置新增refIntake/searchReplace开关。 兼容性报告增加三条探针;新增docs/pitfalls.md与docs/gui-acceptance.md。 真机 GUI 未验收,详见 0.30.0 发布说明。v0.29.2:设置页移除重复标题与厚重灰底,统一分组、间距、焦点与窄容器布局; 编辑器字段分离名称、帮助与控件,并关联可访问标签;文件打开与安装更新独立分组。 AI、系统集成采用官方 UI 原语和可访问状态提示,语言服务器二级导航与顶层分类区分; MCP 读取中或失败仅影响 MCP 分类,不再阻塞通用等页面。保留配置键、自动/显式保存及危险操作确认。 已完成当前 Web 六分类浅色约 550px 冒烟;深色及 360/900px 未实测。
v0.29.1:待审差异引擎重写——新增
src/pending/lineDiff.ts:先裁窗口公共前后缀,再按两侧 唯一出现的相同行做锚点、按最长递增链切分,只在小窗口内做 LCS;单窗口 100 万单元格、单次差异 1200 万单元格(约 80 ms)与深度 64 三层预算兜底。千行文件上的少量/分散改动不再因单元格上限 整段替换,只有真正无锚点的区域才标coarse。同版修正buildHunks每块重复计入head导致的多 hunk 行号偏移(块 ID、行区间选块、删除行 gutter),并新增 9 例精准性/行号/重建/ 性能测试。验证:typecheck 0;全量 304 文件 3861 通过 / 22 跳过 +node --test9/9; 真实归档历史 20 个旧触发状态 20/20 精准(最坏 6,094,517 单元格从整段替换变为 -0/+76); Web 3080 真机重载前后对比:旧 hostcoarse=true/+1141/−1140/1 hunk → 新 hostcoarse=false/+2/−1/2 hunks;构建 host 1,101,565 B、根 client 930,057 B,产物校验通过。 见 0.29.1 发布说明。v0.29.0:Excel 引擎与编解码按需分块——根包不再内联 Univer / ExcelJS / fflate / saxes,打开表格才加载
client.excel.js(引擎面板)与client.excelcodec.js(解码/导出);ExcelHost负责加载与重试,mountExcel复用同一引擎节点(切换文件不重建),codecLoader单例懒加载,lazyPanel扩展为通用loadChunk。构建新增两个 chunk entry 并启用 minify,check-client-artifacts增加逐 chunk 契约与根包 3 MB 预算 / 引擎下限,防止引擎被重新内联。同版性能修复:调试 hover 树的 MutationObserver 只处理本批次受影响 hover 并跳过 Monaco 展示层;侧栏拖拽宽度改为 rAF 合并绘制、pointerup 一次性提交;快捷菜单测量收敛到quickMeasure;官方文件侧栏 CSS 以运行时补丁兼容(不改安装包)。验证:typecheck 0 error;全量 303 文件 3852 通过 / 22 跳过 +node --test9/9;构建 host 1,093,961 B、根 client 930,057 B(v0.28.0 为 23,431,817 B)、client.excel.js 11,371,696 B、client.excelcodec.js 1,002,902 B,产物校验通过;Web 3080 真机冒烟:打开 xlsx 渲染 Univer 面板(canvas ×3)、侧栏拖拽 452→560 px、console 无本插件新增错误(host-bridge 404 来自 dsh-notify-me)。快捷菜单入口与调试 hover 树未做真机冒烟(入口未显示、需 DAP 会话),缺口保留。见 0.29.0 发布说明。v0.28.0:把 dsh-ops 的写工具接进累计待审通道——
ops_edit_file/ops_write_file/ops_remove/ops_copy/ops_move执行前冻结写前基线、执行后读回真实内容,面板可查看差异、Keep 与 Undo;ops_replace以替换作用域为搜索根按字面量预读候选(最多 16 个文件)、执行后用回执对齐,未预读到的文件只记缺口不伪造基线;dryRun预览不采集。候选搜索直接走searchRipgrepContent,不抢占用户的同根搜索。ops_bash内的写盘、PTC 内联工具与非 git 工作区仍未覆盖:git 侧由官方快照列出但无字节证据,非 git 侧可走版本库导入 RPC 兜底。类型检查 0 error;全量 301 文件 3835 通过 / 22 跳过 +node --test9/9;构建双面通过。Host 改动需重启 DSH 才生效,本次未安装、未重启,真实面板 Keep/Undo 冒烟缺口经维护者接受。参见 0.28.0 发布说明。v0.27.2:活动文件与计划预览 Tab 按编辑分组独立保持可见;打开、切换、关闭页签及编辑区尺寸变化后做最小横向定位,已可见时不滚动,不抢键盘焦点、不带动正文。保留手动横滚,超宽 Tab 显示名称起始部分。当前 GUI 未加载新 bundle,真实交互验收缺口已由用户接受;发布不自动安装或重启。参见 0.27.2 发布说明。
v0.27.1:净零判定复用差异生成器的逻辑行口径,消除仅 LF/CRLF 或 BOM 不同造成的「无差异块但仍计入待审」;保留真实文本与末尾换行增删,不改原始快照和磁盘文件。累计待审详情与工具栏统一身份解析,避免误走历史改动栏;汇总与批量列表排除已归档记录。客户端空文本差异收敛保留现有能力、脏缓冲和忙状态守卫。Web Host 重启后实测三个空待审归零、差异栏消失,三个游戏文件 SHA256 不变。参见 0.27.1 发布说明。
v0.27.0:接入 DSH 0.2.2-alpha.3 官方共享菜单(树/页签、键盘入口、陈旧目标守卫、旧 Host 回退)、Forge 面板/本地变更导航(缺能力隐藏,不接管 PR 快照)、设置图标与能力诊断;apply_patch 多目标采集采用独立原始字节前后像,保留 BOM/行尾,不把结果 before:null 当作文件缺失。回滚使用 provider 原子版本与内容守卫,删除无直接文件系统兜底,修复累计待审入口漏传会话沙箱策略;差异按工作区共享基线及接管登记。展示轮询隐藏门控与单飞合并,LSP 旧会话结果隔离,导航补列及 owner/session 守卫。实机 write/edit → GUI Undo → 磁盘读回已通过。已知缺口:Undo 后当前已结算文件可能仍显示“待审”和超出总数的序号;真实 apply_patch 工具、Forge 已启用环境、真实后台请求与多会话完整矩阵尚未实测。缺口经维护者接受发布;不宣称完整端到端验收或 Console 零错误。
v0.26.0:Keep All 从「逐条预检 + 逐条决策」改为一次批量,并且不再被单条基线问题整批阻断。原因有两层:一是往返次数与数据量——原实现先取一次快照,再为每条待审记录调一次
edrv.review.detail(每条带完整 diff 过桥)与一次edrv.review.decide,一次 Keep All 等于2N + 1次 RPC;待审投影侧每条 detail/decide 内部又先loadEntries(cwd)把整表 old_text/new_text 全文读进内存再线性查找,N 条即 O(N²) 全文读。二是「一票否决」——预检期任一条处于冷端(会话在另一端活跃)、revision/seq 漂移、settled、oversized、有尚待核对的 Undo,或执行期任一条 decide 失败,整批立刻中止、其余一条不动。现新增宿主 RPCedrv.review.keepAll(只做 Keep):一次BEGIN IMMEDIATE内逐条 CAS,写入条件取库内当前 revision而非客户端快照值,因此快照漂移不再等于失败;operationId = sha256(batchId|id|seq)保证同批重放幂等;不能保留的条目(冷端待审、已结案、preparedUndo、超限文本)只写进skipped并附原因,段级异常只写result.error,另一段照常完成;超过 2000 条与原分页上限一致地拒绝。待审投影侧新增store.keepAll:一次loadEntries+ 逐条decide(Keep 零写盘)+persist.saveDecisions单事务带 revision CAS 落库,落库冲突只把该条移入 skipped;saveEntry/saveBlocks/pushHistory抽出upsertEntry/writeBlocks/insertHistory共用,单条路径行为不变。客户端新增src/client/reviewKeepAll.ts:guard → 快照(校验失败自动重试一次,自愈分页漂移)→ 一次批量 → 再 guard,正常仅 2 次 RPC。界面:状态栏「Keep All:已保留 X / Y,跳过 Z 条」,跳过明细用轻提示列前 3 条(display:原因)并汇总余量,跳过不算错误、条目仍留在列表可逐条处理;确认弹窗补一句跳过说明并保留「不改写文件」语义。Undo All 完全不变(仍逐条预检能力、遇冲突立即停止、精确报告已完成项),因为它会改写磁盘。验证:typecheck 0 error;定向单测 8 文件 67 例全过(reviewKeepAll新增 7、reviewDb12、pendingStore20、reviewRpc10 及reviewBatch/reviewAllConfirm/reviewFeed/reviewFlow);新用例覆盖一次快照+一次批量、漂移重试一次、guard 先于快照、过期 revision 仍接受、同批重放幂等、preparedUndo 只挡自己、冷端官方照常完成而待审只 skip、空列表与超 2000 条拒绝。同版另一组修复针对差异审查的旧通道遗留问题(用户实报「Keep 了为什么还要被拦」与「1 处差异处理失败」):①被待审累计基线接管的路径,其旧 sidecar 记录由 host 自动结案(retireCovered,归档原因「已由待审累计基线接管,旧工具记录不再单独决策」),编辑器与差异列表不再渲染这些「看得见、点不动」的旧 hunk;②legacyBlocked守卫改为会话作用域——只有本会话可见的待审接管才拦旧写入口,别的会话持有接管时本会话放行,消除「拦得住、看不见」的死锁;③客户端不再用「1 处差异处理失败(可能已被后续修改影响)」覆盖 host 真实原因,按error原样展示,会话未激活时改为「Keep/Undo 没有执行(记录未改动),在会话里发一条
…
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-git-graph★ 10525
输入框上方提供 Git 分支选择器,并把分支泳道与提交历史画成图谱,沿着时间线找到任意变更。作者已将其退役并改用官方 workspace-changes 插件;已发布的 npm 包仍可安装,但不再开发。
Akimiya-z/codex-guard#dsh★ 132
在 DeepSeek Harness 内做提交前的 Pull Request 卫生检查:扫描当前改动中的 TODO 残留、硬编码密钥与非规范提交信息。
xbzbing/dsh-git-panel★ 58
DSH Web GUI 里的 IDE 风格 Git 面板:常驻标签页含三栏总览(分支/标签列表、可搜索的提交历史图、含变更文件树与提交信息的提交详情)与变更记录页(统计条、带逐文件暂存/取消/丢弃的未提交列表、含 amend 的提交框);并排差异带懒加载 highlight.js 语法高亮、块间上下文按需展开与词级行内高亮,图片文件以变更前/后双图对照;另在输入框提供 zsh 风格分支标记。所有 git 命令以 argv 数组经宿主 subprocess 执行、cwd 锁定仓库根。
Cerbur/clutch-dsh#clutch-dsh-worktree★ 46
为 DSH Web UI 增加按 Git Worktree 组织 Session 的视角,同时继续由 DSH 管理原始 Project 和 Session 数据。
DamonKoy/dsh-web-ui#dsh-git-graph★ 35
dsh web GUI 会话头部栏的 Git 分支选择器与提交图。
PerryLink/dsh-github★ 32
官方级 GitHub CI 集成:composite action.yml、轮询 PR 评审机器人(幂等行内评论 + status-check 门禁)以及 PR/issue 工具,所有写入走人工审批门。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。