dsh-file-manager：DeepSeek Harness Web 的文件管理与编辑视图

前言¶

DeepSeek Harness（DSH）采用插件化架构，旨在通过外部组件扩展功能。在 Web Session 中，开发者往往需要跳转外部编辑器来查看或修改代码。dsh-file-manager 插件在 Web Session 的 conversation.view 中新增了 File 视图，集成 Monaco 编辑器，为 Web 环境提供了工作区文件树、文本查看与编辑、语法高亮等能力，严格限制在当前 Session 的权威工作目录中运行。

dsh-file-manager¶

dsh-file-manager 是由 starstorm-ai 维护的一个 DeepSeek Harness Web 插件。它通过 Monaco 编辑器为 Web Session 提供文件管理与编辑视图，不修改 DSH 源码或替换 provider，安装到任意兼容 DSH 的 Web Profile 后即可使用。

核心功能¶

文件浏览与管理
- 文件树逐层加载、目录优先排序并支持键盘导航。
- 紧凑文件栏与轨迹筛选栏，支持多文件 Tab 切换。
- 每个 Tab 独立保留未保存内容、光标、选区和滚动位置。
代码编辑与高亮
- 支持多种语言的语法高亮：TypeScript/JavaScript、JSON、HTML、CSS、Markdown、YAML、Shell、Python、Go、Rust、Java、C/C++。
- Monaco 样式与 worker 在构建期内联，运行时不访问 CDN，保证加载速度。
安全与冲突处理
- 所有浏览与编辑严格限制在当前 Session 的权威 cwd 中。
- 保存使用读取版本令牌和原子 replaceIfVersion，防止静默覆盖 Agent、Git 或外部编辑器已经修改的文件。
- 对二进制、无效 UTF-8、超限、权限、路径和版本冲突有稳定错误码与 UI 状态。

安装与启用¶

在安装前，请确保环境满足以下要求：
* Node.js ^22.19.0 或 >=24.0.0
* pnpm 11.7.0

通过命令行安装插件：

dsh plugin --profile web add dsh-file-manager

安装成功后，在 Web Session 中切换到 File 视图即可使用。

典型用法¶

插件安装后，开发者可以直接在 DSH Web 中查看和编辑本地文件。

在终端生成可安装的 .tgz 包（用于验证或离线安装）：

    pnpm pack

使用生成的包安装（确保已停止正在运行的 Web 进程）：

    dsh plugin --profile web add .\dsh-file-manager-0.1.0.tgz

在 Web Session 中切换到 File 视图，浏览文件树并编辑代码。

适用场景与注意¶

适用场景：适合需要在 DeepSeek Harness Web 环境中直接查看代码、编辑代码片段或进行简单文件管理的场景。
版本限制：V1 暂不包含新建、删除、重命名、二进制预览、全局搜索和工作区级 LSP。
权限与安全：所有操作严格限制在当前 Session 的权威 cwd 中，避免对系统其他目录造成影响。
更新提示：如果使用 pnpm dev:install 安装，执行安装命令后必须重启 Web 进程才能看到新内容。

总结¶

dsh-file-manager 通过内联 Monaco 资源和原子保存机制，在保证性能的同时提供了安全的文件编辑体验，适合集成到 DSH 工作流中。更多细节请参考 GitHub 仓库或 SkillHub 目录。