前言¶
在 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。
