前言¶
在 DeepSeek Harness（DSH）里写长文，常见做法是留在对话里拼 Markdown，或把内容丢到外部编辑器再拷回。对话流不利于分页、页眉页脚和打印；外部文件又不一定和当前 profile、智能体会话落在同一套数据目录。维护者 iggypcnfsky 的客户端插件 dsh-docs（npm：@iggylove/dsh-docs）把文档列表和富文本编辑器做进 Web UI 侧栏，并与智能体共用同一份持久化文档存储：可以在聊天里让 agent 起草或改稿，在面板里手工排版，打印或导出，下次会话继续编辑。
这是什么¶
dsh-docs 是 DSH 的客户端插件，在 Harness Web 界面提供类似 Google Docs 的文书处理能力：富文本、分页、表格、图片、打印、导出，以及通过 agent 工具读写文档。源码与说明见 GitHub：iggypcnfsky/dsh-docs；社区目录页：skillhub.cn/plugins/iggypcnfsky/dsh-docs。分类为客户端；许可证 MIT（© Iggy Love）。当前资料中的包版本为 1.1.0。
核心功能¶
面板与文档组织¶
- 从侧栏打开全屏文档列表与编辑器。
- 文件夹树：嵌套文件夹、重命名/删除、拖拽归档，以及 Unfiled 视图；删除文件夹时文档会移到 Unfiled，而不是随文件夹一起删掉。
编辑与版式¶
- 富文本工具栏：样式、字体与字号、粗体/斜体/下划线/删除线、上标下标、文字与高亮色、对齐、行距与段距、缩进、项目符号/编号/ checklist、格式刷、大小写等。
- 插入：链接、图片（URL 或上传）、带行列快捷操作的表格、水平线、分页符、页眉页脚、特殊字符。
- 页面设置：A4/Letter/Legal、纵向/横向、四边距、页面颜色、标尺、缩放、文档大纲、实时字数/页数统计。
- 撤销/重做、快捷键、查找替换、自动保存。
导出与打印¶
- 导出为独立 HTML、Word 兼容
.doc、Markdown 或纯文本；支持打印为 PDF。
数据与多端一致¶
- 每个文档以 JSON 形式持久化在 profile 数据目录下，上传图片有独立资源路径。
- 面板与 agent 共用同一存储；agent 的修改在保存间隔内会被已打开的面板感知。
智能体工具¶
| 工具 | 用途 |
|---|---|
docs_list |
列出文档及标题、字数、时间戳。 |
docs_read |
以纯文本读取文档，可选附带存储的 HTML。 |
docs_create |
创建 Markdown、HTML 或纯文本文档。 |
docs_update |
替换/追加/前置内容；可改标题、文件夹、页面设置、页眉页脚。 |
docs_import |
导入本地 .html、.md、.markdown、.txt，可选放入文件夹。 |
docs_folders |
列出、创建、重命名、删除文件夹（删文件夹不删文档）。 |
docs_delete |
按 id 或标题删除文档。 |
安装与启用¶
环境要求（以 README 为准）：
- DeepSeek Harness：
>=0.2.2-0且<0.3.0-0 - Node.js：20 或更新
从 GitHub Release 安装（v1.1.0 制品 URL）：
dsh plugin --profile <profile> add https://github.com/iggypcnfsky/dsh-docs/releases/download/v1.1.0/iggylove-dsh-docs-1.1.0.tgz
从 npm 安装：
dsh plugin --profile <profile> add @iggylove/dsh-docs
安装后重启 dsh web。侧栏会出现 Docs 面板。在已安装 Harness 的构建里，也可在插件页用 npm 包名安装，或使用本地 bundle 安装方式（见仓库说明）。
典型用法¶
- 按上文命令为指定
<profile>安装插件并重启 Web UI。 - 在侧栏打开 Docs，手工新建文档或整理文件夹；需要时用导出/打印完成交付。
- 在同一会话或后续会话中，让 agent 调用
docs_list/docs_read了解现有稿，docs_create或docs_update生成或修订正文；面板中继续手工调版式。 - 若有本地稿件，可由 agent 使用
docs_import导入后再编辑。
文档存储路径（README 约定）：
- 若 profile 相关变量可用：
DSH_PROFILE_DIR/data/dsh-docs - 否则默认：
~/.dsh/data/dsh-docs - 可通过环境变量
DSH_DOCS_DIR指定其他目录。
适用场景与注意¶
适合谁：需要在 DSH 内完成报告、说明文档、可打印稿件，并希望和智能体共稿的开发者；不愿在聊天窗口和外部 Word 之间来回切换时，侧栏编辑器 + agent 工具的组合更直接。
权限与安全：插件随当前 dsh 进程与 profile 运行，可读写上述数据目录及 agent 可触达的路径。安装前请自行查看 源码仓库 与 MIT 许可证，确认符合你的环境策略。社区目录站点与 DeepSeek / 幻方无官方从属关系，插件来源以维护者仓库与 npm 包为准。
版本约束：package.json 中 engines.dsh 限定在 0.2.x 预发布区间，升级 Harness 主版本前需核对是否仍满足该范围。
结尾¶
dsh-docs 把富文本文书能力嵌进 Harness Web UI，并与 agent 共用持久化存储，适合「对话起草 + 面板排版 + 导出打印」一条链路上的工作。更多元数据与安装入口见 SkillHub 目录页 与 GitHub README。
