前言¶
在 DeepSeek Harness（DSH）裏做智能體或工作流時，對話往往要落到真實文件：改一版 DOCX、合併 PDF、補一張表裏的公式。若只靠模型口述或手工切到桌面 Office，預覽與「指着這一段改」的閉環很難接上。dsh-office-kit 把 Word、PDF、PPTX、XLSX 的創建、讀取與編輯收進插件，並配合輸入框 / 菜單、引用 Chip 和側邊欄預覽，把文檔技能和會話綁在同一界面裏。
這是什麼¶
dsh-office-kit 是面向 DSH 的插件，npm 包名爲 dsh-office-kit，簡介爲「Office documents, PDF, presentations, and spreadsheets for DeepSeek Harness」。社區目錄頁維護者爲 Tranquillitatis-Lab（SkillHub 目錄）；源碼與說明見 GitHub 倉庫（README 中亦引用相關實現與 npm 發佈）。它不提供 Google Docs 等在線協作，專注本機文件與 DSH 會話內的預覽、標註與修改請求。
核心功能¶
以下能力均來自項目 README 與能力說明，按文檔類型歸納。
四類文檔技能¶
- Word（
/documents）：創建、讀取、編輯 DOCX；支持表格、圖片、公式、頁眉頁腳。 - PDF（
/pdf）：創建、讀取、編輯 PDF；支持合併、旋轉、刪頁與元數據。 - 演示文稿（
/presentations）：創建、讀取、編輯 PPTX；支持項目符號、表格、圖表與圖片。 - 電子表格（
/spreadsheets）：創建、讀取、編輯 XLSX；支持公式、樣式、圖表、凍結窗格與重算。
會話與預覽¶
- Chip 引用：在輸入框用
/插入對應菜單項，用自然語言描述創建、讀取或修改任務。 - 側邊欄標註：在 PDF、DOC/DOCX、PPTX、XLSX 預覽中吸附段落或框選區域，批量提交修改要求；註釋可通過 Chip 鏈接回會話，PDF 標註可附選區截圖。
- 渲染校驗：DOCX/PPTX/XLSX 經 DSH 自帶的 LibreOffice Kit 柵格化（Windows/macOS 原生引擎，Linux 走 WASM）；PDF 使用 PyMuPDF。缺字會在報告裏點名。SVG/PDF 素材可用
ensure_raster_image.py轉 PNG 後嵌入。 - 活體表格（Windows）：
excel-live-control通過 COM 驅動已打開的 Excel / WPS，支持讀區、寫值、樣式、圖表、重算、保存。
完整支持項與限制見倉庫內 CAPABILITY.md。
安裝與啓用¶
在 DSH 官方插件列表中安裝 dsh-office-kit，或使用命令行：
dsh plugin add dsh-office-kit
安裝後：
- 打開 設置 → 插件，啓用該插件。
- 確認 DSH 版本不低於
0.2.1-rc.2。 - 準備 Python
3.10–3.13（README 寫明插件側可不預裝，缺失時會自動安裝；Windows 在缺少兼容 Python 時會自動安裝，macOS / Linux 優先使用系統已有解釋器）。
可選：通過環境變量 DSH_OFFICE_PYTHON 指定 Python 解釋器（見 README「配置與限制」）。
插件以當前 DSH 進程權限訪問本機文件；安裝前建議閱讀源碼與 MIT 許可證（package.json 中 license 字段爲 MIT）。
典型用法¶
通過菜單處理文檔¶
- 在輸入框鍵入
/，選擇 文檔、PDF 文檔、演示文稿 或 電子表格。 - 回車插入 Chip，描述創建、讀取或修改任務。
- 打開生成的文件，在側邊欄預覽結果。
在預覽中請求修改¶
- 打開 PDF 或 DOC/DOCX，在工具欄點 請求修改。
- 懸停吸附段落，或拖動框選，輸入要求並添加註釋。
- 懸停底部 註釋數量 查看列表，點 發送；取消 可清空本批。
操作習慣（README 原文）：
- Esc：先取消當前選區，再按一次退出標註模式。
- 附件：PDF 附選區截圖；DOC/DOCX 僅發送文字與定位信息。
- 草稿：已有輸入時會先合入草稿，由你確認發送；暫存註釋在刷新後不保留。
倉庫 public/samples/ 下提供 Word、PDF、演示文稿、電子表格示例文件，便於對照能力邊界。
適用場景與注意¶
適合：需要在 DSH 會話中直接產出或迭代本地 Office 文件、希望預覽裏「指哪改哪」的開發者與用戶；Windows 上若要與已打開的 Excel/WPS 聯動，可使用 excel-live-control。
注意：
- 標註範圍：側邊欄段落吸附與修改請求主要針對 PDF、DOC/DOCX；掃描版 PDF 可框選截圖，不提供 OCR。
- 平臺：活體表格依賴 Windows COM；Linux 上 Office 預覽走 WASM 路徑，行爲以 README 與
CAPABILITY.md爲準。 - 遠程與雲文檔：不支持 Google Docs / Slides / Sheets 或遠程編輯。
- 生態：DSH 奉行「一切皆插件」；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係，本文安裝命令以 README 原文爲準，勿自行拼接
github:owner/repo形式。
結尾¶
dsh-office-kit 把四類本地辦公文檔和 PDF 的操作、預覽、標註收回 DSH，減少「對話在外、文件在手」的割裂。查閱條目與星標等信息可見 SkillHub：dsh-office-kit；細節與示例見 GitHub：Tranquillitatis-Lab/dsh-office-kit。
