dsh-file-edit

本项目全部代码由 DeepSeek-V4-Pro 与 DeepSeek-V4-Flash 生成。

⚠️ 测试版声明：本插件目前处于测试阶段（含实验性的文件编辑、撤销/重做与自动保存功能），可能存在未知缺陷。请谨慎使用，重要文件与重要会话数据请提前备份。

适配 DSH 版本：本插件在 DSH（deepseek-harness）0.1.0-rc.5 上开发与实测；其他版本未验证。

DSH WebUI 工作区文件插件，核心功能有两块：

1. 工作区文件浏览与编辑：文件树浏览、多标签打开、语法高亮、Markdown 渲染，并可在浏览器里直接编辑文件内容；
2. Diff 视图：对发生变化的文件展示行级 diff，可逐块或整文件接受/拒绝，拒绝后可撤销。

功能

• 工作区侧边栏（替换原生浏览器）：项目文件夹两层展开——会话历史（点开会话 / 新建会话；按最近活动时间倒序排列、每行右侧显示「2 min / 1 hr / 1 day」式相对时间标签）与项目文件树（双击/单击打开、手动 ⟳ 刷新、文件集合变化自动刷新；文件夹在上、文件在下，各自按字母排序）。
• Git 版本控制着色（VCS Annotations）：项目文件树基于 Git 状态显示彩色字母徽标——M 已修改（黄）/ U 未跟踪（绿）/ A 已新增（绿）/ D 已删除（红）/ R 已重命名（蓝），文件夹聚合显示其内部最强的状态；被 .gitignore 排除的文件与文件夹显示为灰色，且不参与 8000 条目扫描预算（仍照常进入 DIFF 审阅）。徽标即时刷新：agent 改文件、插件拒绝/撤销拒绝、本地保存后立即重查；agent 执行 git add/commit/checkout/reset/... 等命令也即时刷新；外部终端/编辑器造成的变更（含外部 git commit）在「项目文件」展开期间每 20 秒自动重查一次（展开区块时也会立即重查），故徽标最多落后 20 秒。
• 顶栏「文件」标签：与「对话/轨迹」并排；内容区是浏览器式标签条（切换 / ✕ 关闭 / ✕ 全部 / 拖拽排序 / 未保存编辑的白色圆点）。
• 修改文件列表（输入框上方）：会话中经 agent 工具通道（write/edit/shell/pwsh）产生的修改/新增/删除，带 +/− 统计、逐文件接受/拒绝、全部接受/拒绝、撤销上次拒绝。
• 内联 Diff：红/绿行级 diff、24 语言语法高亮、块级/文件级接受与拒绝、跳转控件、大文件只读预览、二进制还原。
• Sticky Scroll（粘性滚动）：代码视图滚动时，当前作用域的定义行（类/函数/结构体/接口/标题等，覆盖全部 24 种语法高亮语言）固定在头部，显示嵌套作用域链（如 类 › 方法）；点击链上任意一级即跳转定位到该定义行。
• 基线制审阅：接受 = 当前内容成为新基线；拒绝 = 把基线写回磁盘（新增文件拒绝 = 删除文件）；拒绝可撤销（单层）。
• 完整的文件编辑：文件视图内直接输入/删除、Enter 换行（行首 Backspace / 行尾 Delete 合并行）、Ctrl+C/V 复制粘贴（跨行复制/多行粘贴）、Tab / Shift+Tab 缩进与反缩进、↑↓ 跨行移动插入点、Esc 还原当前行。
• 独立撤销/重做：Ctrl+Z / Ctrl+Y / Ctrl+Shift+Z 使用插件自己的撤销栈（与网页其他区域完全隔离），只撤销用户的编辑、绝不撤销 AI 的 DIFF；撤销后新编辑会按 Word 惯例抛弃重做分支；AI 修改/删除文件、拒绝/撤销拒绝还原文件时自动重置该文件的编辑记录。
• 编辑记录持久化：按（工作区, 文件路径）存于浏览器 localStorage——关闭并重开标签、切换 SESSION、重启 DSH 服务后都能继续撤销/重做。
• 保存时点：Ctrl+S 主动保存；切换会话 / 关闭文件标签时弹窗确认（保存 / 不保存 / 取消）；AI 编辑文件后自动保存（用户编辑与 AI 修改冲突的部分保留 AI 版本并提示）；保存后标签上的白点消失。
• 文件内编辑语义：用户编辑折入基线、不打扰 agent 的待审 hunks（hunk 区域内的用户编辑仍计入该 hunk）；空文件可直接输入首行。
• Markdown 渲染视图：.md/.markdown 无待审修改时直接渲染（GFM 表格、围栏代码高亮、无行数上限）。
• 即时更新：agent 改/增/删文件后约 1.5s 内主动出现在界面（会话运行中自适应快轮询 + 长轮询唤醒双通道），无需手动刷新。

一条命令安装（推荐）

需要本机已装 DSH（~/.dsh/profiles/web 存在）且能访问 GitHub。PowerShell 中执行：

irm https://raw.githubusercontent.com/justarook1e/dsh-file-edit/main/install.ps1 | iex

完成后：重启 DSH（加载宿主插件与挂载项），然后 Ctrl+F5 刷新页面（加载客户端 bundle）。

备选（clone 方式，凭据走 Git Credential Manager）： git clone https://github.com/justarook1e/dsh-file-edit.git "$env:TEMP\dsh-file-edit"; & "$env:TEMP\dsh-file-edit\install.ps1"

手动安装

1. 把本仓库的 package.json、host/、client/ 复制到 ~/.dsh/profiles/web/node_modules/dsh-file-edit/；

2. 在 ~/.dsh/profiles/web/cordis.patch.yml 末尾追加：

   - insert:
       - id: dsh-file-edit
         name: dsh-file-edit
   

3. 重启 DSH + Ctrl+F5 刷新页面。

install.ps1 做的正是这两步（幂等，可重复执行；-Uninstall 反向移除）。

更新

再次运行安装脚本即可（幂等，覆盖已安装的包）：

irm https://raw.githubusercontent.com/justarook1e/dsh-file-edit/main/install.ps1 | iex

或（clone 方式）：cd "$env:TEMP\dsh-file-edit"; git pull; & .\install.ps1

卸载

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/justarook1e/dsh-file-edit/main/install.ps1))) -Uninstall

或（clone 方式）：& "$env:TEMP\dsh-file-edit\install.ps1" -Uninstall

或手动删除 node_modules/dsh-file-edit/ 与 patch 里的 insert 块。重启后生效。

仓库结构

dsh-file-edit/
├── package.json          # dsh.client: {platform:'web'} + exports["./client"]
├── host/index.mjs        # 宿主插件：扫描/基线/diff/接受拒绝/RPC（POST /dsh-file-edit/api）
├── client/dist/client.js # 浏览器 bundle（__ModuleLoader__.load + factory）
└── install.ps1           # 一键安装/卸载脚本

运行期数据

• 每会话审阅状态（基线、待决定项、撤销记录）存在 ~/.dsh/dsh-file-edit-state/，由插件自动创建与维护；重启后自动恢复。
• 用户编辑历史（撤销/重做栈）存在浏览器 localStorage（key 前缀 dsh-fe-edit-v1:），按（工作区根, 相对路径）组织，与 DSH 服务端状态相互独立。
• 从旧名 dsh-files 升级时，宿主首次启动会把旧的 ~/.dsh/dsh-files-state/ 自动迁移过来，待审状态不丢。

已知限制

• 替换了原生 WorkspaceBrowser：没有搜索、分组/排序菜单、重命名/删除/归档对话框（保留了添加工作区、打开/新建会话）。
• 跳过目录：.git node_modules .venv venv __pycache__ .next .dsh .idea .vscode .cache .turbo .pytest_cache .mypy_cache .ruff_cache .eslintcache .DS_Store；树上限 8000 条目 / 16 层。被 .gitignore 排除的文件/目录（git ls-files --others --ignored --exclude-standard 判定）不占用 8000 条目预算，但仍照常进入扫描与 DIFF 审阅（修改/新增/删除照常出现在修改列表），文件树中灰显、可照常展开浏览；! 否定规则由 git 自身语义保证；非 git 工作区行为不变。注意：工作区存在大量被忽略文件时（如内嵌 Python 运行时），扫描覆盖全部条目，状态文件与树负载会相应变大。
• 大文件不做行级 diff：>512KB 或 >8000 行标为 large（≤512KB 的文本可只读预览前 4000 行）；二进制 ≤4MB 可拒绝还原。
• shell/pwsh 命令不透明，执行期间的变更会保守地全部归入审阅（无法区分同窗口内的手动操作）。
• 基线随插件重启重建（待审状态本身持久化）。

许可证

本项目以 MIT License 发布（见 LICENSE）。

客户端 bundle（client/dist/client.js）内嵌了 markdown-it v15.0.0 的浏览器 UMD 构建，其中包含 linkify-it、mdurl、uc.micro。这些依赖同样以 MIT 发布，其版权声明与完整许可证文本见 THIRD_PARTY_LICENSES.md。