前言¶
在 DeepSeek Harness（DSH）里看官方文档或侧边栏文件时，常会碰到要在原位置改几行代码、补一段 Markdown、或对 JSON 配置做小改的需求。若只能把内容复制到外部编辑器再贴回，上下文切换成本高，也容易和磁盘上的最新版本不同步。下面介绍的 dsh-file-editor 由维护者 wv-y 提供，归类为客户端插件，目标是在 DSH 右侧栏就地完成文本编辑、保存与预览，并与可选的 dsh-better-sidebar 文件树入口配合使用。
这是什么¶
dsh-file-editor 是面向 DSH 右侧栏的文本编辑器插件：行号、语法高亮、代码折叠、Git 改动标记、自动保存、查找替换，以及 Markdown 预览。当前 npm 包名为 dsh-file-editor，版本 1.0.0，MIT 许可证；运行要求 DSH ≥ 0.2.2-rc.1、Node ≥ 20。插件在 DSH 客户端（Web 平台）侧加载，与 DSH「一切皆插件」的扩展方式一致；社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，安装前仍建议自行查看源码与许可证。
两种使用入口¶
插件支持两条路径，可单独或同时使用：
- 官方文档预览：在预览页标题栏点「编辑」，右侧栏展开编辑面板，宽度跟随右侧栏；改完后保存回磁盘。
- dsh-better-sidebar（可选）：安装该插件后，本插件会注册 file viewer；在文件树中打开
.ts、.tsx、.js、.md、.json等文本文件时由本插件渲染。未安装 better-sidebar 时该入口不会注册，文档预览侧的编辑能力不受影响。
核心功能¶
以下能力均来自项目 README 说明：
- 编辑体验：行号；60+ 种语言的语法高亮；代码折叠。
- 保存：停手约 0.8s 自动写盘；
⌘S手动保存；切换或关闭前会刷盘。中文输入法拼写期间会暂停自动保存。 - 与磁盘同步：外部改动采用三方合并；无冲突则自动合并保存；有冲突时可选「采用磁盘版本」或「覆盖保存」。
- Git：改动色条区分新增 / 修改 / 删除；点击可查看该处 diff，并支持回滚单块改动。
- 查找与替换：
⌘F、⌘H；支持区分大小写、上一个 / 下一个、全部替换；命中行内高亮，当前项为亮黄。 - Markdown：默认进入预览；点「预览」会先保存再渲染。
安装与启用¶
在对应 profile 下执行以下其一（命令摘自官方 README）：
dsh plugin --profile <profile> add dsh-file-editor # 从 npm 安装
dsh plugin --profile <profile> add github:wv-y/dsh-file-editor # 直接从 GitHub 安装
装完后刷新页面；Desktop 用户建议用 ⌘R 硬刷新。dsh-better-sidebar 为可选依赖，仅影响文件树入口是否注册。
典型用法¶
在文档预览里改内容：打开官方文档预览 → 标题栏「编辑」→ 在右侧栏修改 → 依赖自动保存或 ⌘S 写回磁盘。
在侧边栏文件树里改源码（需 better-sidebar）：安装 dsh-better-sidebar 与本插件 → 在树中打开支持的文本后缀 → 编辑、使用 Git 色条查看 diff 或回滚局部改动 → 需要时用查找替换批量改字符串。
Markdown 写作：在编辑器中编写；需要渲染时点「预览」（会先保存）。
适用场景与注意¶
适合经常在 DSH 内改文档、配置或前端脚本的开发者，尤其是希望减少「跳出 DSH 再同步文件」的场景。
使用时请注意：插件以当前 DSH 进程的权限读写本地文件；安装与启用前请阅读仓库源码与 MIT 许可。合并冲突时务必在「采用磁盘版本」与「覆盖保存」之间按实际需求选择，避免误覆盖他人或外部工具的改动。
结尾¶
dsh-file-editor 把常用 IDE 能力收拢到 DSH 右侧栏，并与文档预览、可选文件树打通。更多元信息与分类见社区目录：SkillHub 插件页；源码与完整说明见 GitHub：wv-y/dsh-file-editor。
