前言¶
DeepSeek Harness（DSH）采用插件化架构，允许开发者扩展 Web 界面的功能。在使用 Web 环境进行开发或调试时，开发者经常需要快速查看或修改当前会话工作区的文件。dsh-right-editor 是一个面向 DSH Web 的右侧栏插件，旨在将文件浏览与编辑能力集成到界面右侧，减少开发者切换窗口或打开外部编辑器的操作成本。
该插件由 banttethai-ops 维护，遵循 MIT 协议。它通过直接在 DSH Web 界面中提供文件操作能力，实现了从浏览目录、编辑文本到查看 Office 文档的一站式体验。
核心功能¶
- 文件浏览：面板默认从当前会话工作区开始。支持目录导航、返回上级、刷新列表，以及通过路径栏输入绝对路径进行跳转。
- 文本/代码编辑：支持查看并编辑任意 UTF-8 编码的文本文件（上限 8MB）。编辑后可通过
Ctrl+S或面板上的保存按钮将修改写回原文件。 - 图片处理：支持 png、jpg、jpeg、gif、webp、bmp、svg、ico、avif 格式。提供亮度、对比度、灰度调节，以及 90° 旋转和水平/垂直翻转功能，调整后可直接保存回原文件。
- Word 文档 (docx)：支持查看与原位编辑。可以修改正文段落、表格单元格，并保留原有样式，保存后写回原文件。
- Excel 表格 (xlsx)：支持查看与原位编辑。支持切换工作表标签以及修改单元格内容，保存后写回原文件。
- PPT 演示 (pptx) 与 PDF：均为只读模式。支持逐页文本预览（PDF 为文本型 PDF 的提取预览，扫描件需配合 OCR）。
安装与启用¶
-
前置条件：
- 确保 DSH Web 正在运行（通过
dsh web命令或桌面版）。 - 安装 Node.js ≥ 20。
- 确保 DSH Web 正在运行（通过
-
Python 依赖（可选）：
若需要编辑 Word、Excel、PPT 或 PDF 文档，需安装 Python 3 及相关依赖库：
pip install python-docx openpyxl python-pptx pdfplumber
若未安装上述库，插件仍可正常浏览目录、编辑文本和图片，但无法解析 Office/PDF 文档。
- 执行安装：
在 DSH 所在环境执行以下命令：
dsh plugin --profile web add dsh-right-editor
- 加载插件：
安装完成后，需硬刷新浏览器（Windows/Linux 使用Ctrl + Shift + R，Mac 使用Cmd + Shift + R）才能在顶部标题栏右侧看到 📝 按钮。
典型用法¶
- 打开面板：在 DSH 顶部标题栏右侧点击 📝 按钮，右侧栏会展开文件浏览面板。
- 浏览文件：点击目录进入，点击 ⬆ 返回上级，或直接在路径栏输入绝对路径并回车。
- 编辑文本：打开文本文件后直接编辑，点击“💾 保存”或按
Ctrl+S。 - 编辑图片：打开图片后使用滑块调整参数，点击“💾 保存”。
- 编辑 Office 文档：点击 Word 或 Excel 文件右上角的“✏️ 编辑”按钮进入编辑态，修改后保存。
- 查看文档：PPT 和 PDF 文件仅支持只读预览，无法直接编辑。
适用场景与注意¶
- 权限范围：文件操作权限继承自当前 DSH 进程的授权策略，与用户对当前会话的权限一致。
- 安全机制：Office 和 PDF 的解析脚本通过标准输入流（stdin）传入 Python，不会将脚本落盘，避免被
Temp/inspect.py等文件干扰。 - 只读限制：PPT 和 PDF 仅提供文本预览，不支持修改。
- 风险提示：插件通过 DSH 的沙箱策略运行，建议在安装前检查源码与许可证。
结语¶
dsh-right-editor 将本地文件系统的浏览与编辑能力无缝集成到 DSH Web 界面中，适合需要频繁处理文档或配置文件的智能体开发者使用。
