前言¶

在 DeepSeek Harness（DSH）裏對話時，思路、參考圖、腦圖和附件往往散落在聊天窗口或本機文件夾裏。想把「當前選中的畫布內容」帶進 Composer，或讓智能體直接讀寫一塊可編輯白板，通常還要自己搭 MCP、切工具。MOKI Canvas for DSH 把可編輯的無限畫布放進 DSH 側工作區，並支持與對話的雙向協作：你在畫布上整理，智能體可通過插件註冊的工具inspect、創建和更新內容；你選中元素後，可一鍵把文本引用和截圖加入當前草稿，由你決定是否發送。

下面按定位、能力、安裝與用法說明該插件。事實以 GitHub 倉庫 README 爲準；社區目錄頁見 SkillHub 插件頁。

這是什麼¶

MOKI Canvas for DSH（包名 dsh-moki-canvas，當前資料版本 1.5.2）由維護者 JKZeng-cell 發佈，分類爲 客戶端 插件。它將 local-first 的無限畫布集成到 DSH：便籤、文本、形狀、手繪、貝塞爾路徑、思維導圖，以及圖片、音視頻、PDF、鏈接等素材可在同一塊板子上編排；界面跟隨 DSH 淺色或深色主題。插件在 DSH 側欄與工作區注入入口，無需單獨爲畫布再建一套 MCP 服務即可與智能體協作。

核心功能¶

畫布與思維導圖¶

• 繪製與排版： 便籤、文本、形狀、箭頭、手繪、貝塞爾路徑、對齊、分組、縮放與迷你地圖。
• 思維導圖： 編輯節點文字與寬度、拖拽分支、摺疊展開；用 Tab 或 Enter 增節點。資料寫明 DSH 可一次批量添加最多 200 個節點並保留層級。

素材與項目組織¶

• 就近引用： 從工具欄或拖放添加圖片、文件、鏈接、音頻、視頻；在頁面素材列表中搜索、定位、重命名與預覽。
• 多頁與版本： 多頁面與頁面組、可編輯畫板、版本歷史、.moki 導入導出及圖片導出。
• 內置導覽： 隨包提供六頁可編輯介紹板（露營短片主題），用於熟悉工具、思維導圖節點與離線媒體示例。

與 DSH 的雙向協作¶

• 智能體側： 畫布工具自動註冊；可請智能體檢查、創建、更新、排版或導出內容。
• 用戶側： 在畫布上選中內容時，Composer 旁出現提示；點擊 Add to chat 將選中內容的文本引用與截圖加入當前草稿，不會自動發送消息，你已輸入的文字會保留。

支持的導入（DSH 插件 v1.5.2）¶

拖放文件、粘貼圖片或 URL，或從工具欄添加素材。常見類型包括：PNG/JPEG/WebP/GIF 等圖片；MP4/WebM 等視頻（播放依賴 DSH 內嵌瀏覽器與編解碼）；MP3/WAV 等音頻；PDF 分頁預覽；.txt、.md、.json、.csv 等文本（素材對話框內預覽上限 5 MB）；Office、壓縮包等以文件卡片存儲，需用 Open 打開原文件；HTTP(S) 鏈接與直鏈圖片；.moki、.moki-board、.moki.json 等 MOKI 畫板文件可導入可編輯內容。Markdown/JSON/CSV 等在材料對話框中按源碼展示；普通 .json 爲文本附件，MOKI 畫板走專用導入器。

安裝與啓用¶

README 寫明在 DeepSeek Harness 0.2.2-rc.1、Windows x64 上測試過；其他系統與 DSH 版本未在該發行版中驗證。畫布 UI 與內置導覽以中文爲主，側欄入口與選區控件提供英文標籤。許可證爲 MIT（見 package.json）。

通過對話安裝（推薦）¶

在具備插件管理能力的 DSH 對話中，將下列整段提示覆制到 Composer 併發送：

Please install and enable MOKI Canvas for DSH v1.5.2.

Project: https://github.com/JKZeng-cell/moki-canvas-for-dsh
Read the project's installation instructions, then use plugin_manager in the current DSH environment:
First call list_bundles. If this version is installed, confirm it is enabled or enable it with set_bundle; do not reinstall it.
If it is not installed, call install_bundle with enabled=true and this prebuilt package as the target:
https://github.com/JKZeng-cell/moki-canvas-for-dsh/releases/download/v1.5.2/dsh-moki-canvas-1.5.2.tgz

After installation, check the version and enabled state of dsh-moki-canvas and explain how to open it from the sidebar or side workspace.
If the result is restart-required, tell me to restart DSH. Preserve existing boards, attachments, and other plugins.

這一步會調用當前環境中的 plugin_manager。若工具不可用，可選用帶插件管理的預設（如 Creator），或在側欄 Plugins 頁填寫同一預構建包 URL。安裝後覈對 dsh-moki-canvas 的版本、啓用狀態及是否需要重啓 DSH。

手動安裝¶

1. 從 Releases v1.5.2 下載 dsh-moki-canvas-1.5.2.tgz。
2. Desktop 用戶可通過應用菜單 Manage dsh Command… 安裝或修復捆綁命令；新開終端執行 dsh --version 確認與 Desktop 一致後，從應用或托盤菜單完全退出 DSH（僅關窗口可能仍在運行）。
3. 在下載包所在目錄執行：

dsh plugin --profile desktop add ./dsh-moki-canvas-1.5.2.tgz
dsh plugin --profile desktop list dsh-moki-canvas --depth 0

4. 重新打開 DSH。在左側邊欄 Automation tasks 下方選擇 MOKI Canvas，在聊天旁打開畫布；也可在新標籤頁中選擇 MOKI Canvas。

典型用法¶

1. 旁路打開畫布： 在對話側邊打開 MOKI Canvas，與 Composer、側工作區同屏使用。
2. 選區進對話： 在畫布右側選中內容，待 Composer 旁出現選區提示後點擊 Add to chat；草稿中會帶上文本引用與截圖，再輸入你的指令後自行發送。
3. 交給智能體改板： 直接說明要檢查、新建節點、調整排版或導出；畫布工具已註冊，無需額外配置 MCP。
4. 導入與沉澱： 拖放 .moki 畫板或各類媒體；用多頁、頁面組與素材列表管理項目；需要時用 .moki 或圖片導出備份。

適用場景與注意¶

適合： 需要在 DSH 內做頭腦風暴、項目牆、素材牆的用戶；希望畫板內容與對話上下文可控同步（選區進草稿、智能體改板）的智能體工作流。

注意：

• 插件以當前 DSH 進程權限 運行，安裝前應閱讀源碼與 MIT 許可證，並確認預構建包來源爲上述 GitHub Releases。
• 社區目錄 SkillHub 爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；DSH 本身遵循「一切皆插件」的擴展方式。
• 視頻與音頻播放取決於 DSH 內嵌瀏覽器與本地編解碼能力；部分 Office 附件在材料對話框中無內聯預覽，需用 Open 打開原文件。

結尾¶

MOKI Canvas for DSH 把本地優先的無限畫布和思維導圖嵌進 DSH 側工作區，並在選區與智能體工具兩層上實現可控的雙向協作。要進一步查看截圖、導入表與安裝細節，請參閱項目 README 與發行說明。

• 社區目錄：https://www.skillhub.cn/plugins/JKZeng-cell/moki-canvas-for-dsh
• GitHub：https://github.com/JKZeng-cell/moki-canvas-for-dsh