dsh-file-review：DeepSeek Harness 的文件浏览侧边栏

前言¶

DeepSeek Harness (DSH) 采用插件化架构，旨在通过扩展实现功能解耦。在使用本地开发环境或编写智能体时，应用内缺乏直接管理文件的能力，通常需要依赖外部终端或文件管理器。dsh-file-review 旨在解决这一痛点，为 Harness 提供一个可停靠、可调整大小的文件浏览侧边栏与编辑器。

插件介绍¶

dsh-file-review 是一个 DeepSeek Harness 客户端插件，由开发者 ylw-a 维护。它主要解决在 DSH 环境下无法直接浏览本地文件树、进行文件读写操作以及查看 Markdown 渲染的问题。

核心功能¶

该插件提供了一套完整的文件管理能力，具体包括：

文件树侧边栏
- 支持停靠在左或右，宽度可在 220px 到 900px 之间调整。
- 支持目录懒加载、全部展开/折叠，以及工作区搜索。
右键菜单操作
- 提供剪切、复制、粘贴、复制绝对/相对路径、重命名、删除到回收站等操作。
- 支持新建文件/文件夹、刷新、以及在 VS Code 中打开文件。
统一编辑器
- 集成 Shiki 语法高亮与直接编辑功能，实现“预览即编辑”。
- 编辑器具备防抖高亮、滚动同步以及 Ctrl/Cmd+S 保存功能。
Markdown 支持
- 默认以语法高亮的源码模式编辑。
- 支持渲染与编辑模式的切换。
自动刷新机制
- 可见目录树每约 2 秒轮询一次，仅在文件签名变化时重渲染。
- 执行写入操作时立即刷新。
双宿主模式
- 无会话时以浮动编辑器窗口显示。
- 有会话时自动切换为固定文件标签页（与对话/轨迹标签页共存）。
安全删除
- 删除文件时通过 PowerShell Microsoft.VisualBasic 发送至 Windows 回收站，非永久删除。

安装与启用¶

在安装前，请确保已安装 DeepSeek Harness 并配置了本地 web 模式。

进入插件源码目录。
构建项目：

    npm install
    npm run build

添加插件到 Harness 配置：

    dsh plugin --profile web add -w <path-to-this-package>

重启 Harness 以加载插件。

典型用法¶

文件操作：在侧边栏右键点击文件，选择“复制绝对路径”可直接获取路径供智能体调用。
代码编辑：点击文件进入编辑模式，直接修改代码，按 Ctrl/Cmd+S 保存，编辑器会自动根据 Shiki 进行语法高亮。
Markdown 预览：在 Markdown 文件中切换至“渲染”视图查看排版效果。

适用场景与注意¶

适用场景：适合需要在 DSH 环境中直接查看、修改或创建本地代码文件、配置文件或文档的开发者。
权限与依赖：插件以当前 DSH 进程权限运行，删除操作需系统允许。安装前建议检查源码与许可证。
技术细节：编辑器客户端内联了 Shiki（使用 JS 正则引擎，非 WASM），依赖 DSH 的本地 web 模式配置。构建产物 lib/ 和设计文档 docs/ 未提交至仓库。

结语¶

dsh-file-review 通过侧边栏与编辑器的结合，补齐了 DeepSeek Harness 在本地文件处理上的短板。若需进一步了解或获取源码，可访问插件目录或 GitHub 仓库。