面向 Hana 的原生 DSH 插件，以 dshana profile 程序內執行 DeepSeek Harness 任務、自動自舉 DSH 依賴與 web host，並透過內嵌的 DSHana 標籤頁暴露 DSH——無須單獨 DSH 程序，也無須管理 API Key。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-09-03
授權條款
MPL-2.0
01它能幫你完成什麼？
把 DeepSeek Harness 編碼 agent 任務作為程序內內嵌子 agent 在 Hana 內執行
DSH 任務階段顯示在內嵌的 DSHana 標籤頁，帳本與 dsh-home 鎖進插件資料目錄
想在 Hana 中跑 DeepSeek Harness 任務、又不想單獨啟動 DSH 程序或管理 DSH 憑證的 Hana 使用者
在 Hana 設定頁配置預設 DSH 任務模型並查看隨插件鎖定的 DSH 版本
DSHana 設定頁：含「預設模型」卡片（Provider/模型/思考強度三級聯動）與「DSH 版本」卡片
需要設定任務模型、追蹤隨插件捆綁的 DSH 版本的 Hana 營運者
02如何將外掛接入 DeepSeek Harness？
先決條件
- Hana 宿主應用程式——把插件 release zip 拖進 Hana 插件安裝介面（或解壓到插件目錄）即可裝載。
- 若 macOS 上 Electron 內嵌 node 跑 pnpm 簽章檢查失敗，需自備相容的 Node.js（設定 `nodejsPath`）；否則用 Electron 自帶的 node。
安裝步驟
- 01
從 GitHub Releases 下載 release zip `dsh-hanako-v<version>.zip`，拖進 Hana 插件安裝介面（或解壓到插件目錄）——拖入即完成裝載。
- 02
無須手動：插件載入（onStartUp）即自動鏈自舉——冪等檢查/安裝 DSH 依賴（版本漂移才按聲明 `pnpm install --prod`，官方源失敗自動重試 npmmirror）並自動拉起 DSH web host。
- 03
需要顯式安裝/驗證時，呼叫 `dsh_install` 工具（action=install 渲染即時 pnpm 日誌卡片；action=verify 做靜態核對）。
驗證整合成功
- 裝載後讓 Agent 跑一次最小試任務 `dsh_session(action="create", task="…", cwd="<專案沙箱目錄>")`；卡片不報 web host 錯誤即安裝成功。
03DSH 整合程度與能力邊界
原生程序內 DSH 執行階段，內嵌於 Hana 宿主——以 dshana profile 在宿主程序內執行 DSH 任務，無獨立 DSH 子程序；DSH 官方 Web UI 以 DSHana 標籤頁內嵌。
程序內 DSH 內嵌
經 dshana profile 路由的 DSH 任務請求→DSH 任務階段顯示在 DSHana 標籤頁；帳本與 dsh-home 鎖進插件資料目錄
账本与 dsh-home 锁进插件数据目录，DSH 依赖装进插件 node_modules（版本随插件声明）啟動即自動自舉
插件 onStartUp 事件→冪等安裝 DSH 依賴（pnpm install --prod）並自動拉起 DSH web host
自动拉起 DSH web host（依赖装进插件根 node_modules，版本随插件声明）依赖幂等检查/安装（已装且与插件声明版本一致 → 秒过）dsh_session 任務工具
dsh_session(action=create, task, cwd)，選用 provider/model/reasoningEffort→在 DSHana 標籤頁建立一個 DSH 任務階段
DSHana 設定頁
Hana 設定頁互動→「預設模型」卡片（Provider/模型/思考強度聯動）與「DSH 版本」卡片
04適合誰？何時不該用？
適合
- 想在 Hana 中跑 DeepSeek Harness 任務、又不想單獨啟動 DSH 程序或管理 DSH 憑證的 Hana 使用者
- 需要設定任務模型、追蹤隨插件捆綁的 DSH 版本的 Hana 營運者
不適合
- macOS 上 Electron 內嵌 node 跑 pnpm 簽章檢查可能失敗；此時把 `nodejsPath` 設為系統 node 絕對路徑（如 /opt/homebrew/bin/node）。路徑不存在時顯示警告並降級回退到自帶 node。
05相容性、維護與安全提醒
- macOS 上 Electron 內嵌 node 跑 pnpm 簽章檢查可能失敗；此時把 `nodejsPath` 設為系統 node 絕對路徑（如 /opt/homebrew/bin/node）。路徑不存在時顯示警告並降級回退到自帶 node。
- 隨插件捆綁的 DSH 版本嚴格鎖插件聲明——更新 DSH 即等於更新插件發版。
MPL-2.0 · 活躍維護中（最新發布 v0.25.0，2026-08-30）
06常見問題
dsh-hanako 如何把 DeepSeek Harness 接進 Hana？
它把 DSH 作為程序內內嵌 agent 嵌入（runProfile 在宿主程序內 boot，因此沒有獨立的 DSH 子程序）。任務走 dshana profile 執行，DSH 官方 Web UI 以 DSHana 標籤頁內嵌在 Hana 頂部。
我需要為 DSH 配置 API Key 或模型嗎？
不需要——DSH 憑證由 @dsh-hanako/provider 插件直讀 Hana 宿主 provider-catalog.json，模型跟隨宿主 models.json。預設任務模型即 DSH 預設模型（settings.yaml 的 agent-default-model），可在 DSHana 設定頁配置。
我怎麼驗證安裝是否成功？
插件裝載後，讓 Agent 跑一次最小試任務 dsh_session(action="create", task="…", cwd="<沙箱>")；卡片不報 web host 錯誤即安裝成功。
自動自舉失敗（例如 macOS 上）會怎樣？
DSHana 標籤頁是三態自舉頁（booting / action-needed / ready）。失敗時按 errorClass 給出人話指引並退避重試；需要使用者動作時（如設 nodejsPath、裝編譯工具鏈、清理磁碟、dsh 升級後重啟宿主）頁面暫停並給出明確步驟，完成後自動續跑。
我可以逐任務覆蓋模型或 provider 嗎？
可以——dsh_session 工具接受 provider / model / reasoningEffort 參數，對單次任務顯式覆蓋預設值。
07相關的 DSH 工作流程
archify
作者 tt-a1i
為編碼智慧體生成美觀可驗證的架構圖、時序圖與資料流圖，輸出自包含 HTML，支援動效與清晰匯出。
openviking
作者 volcengine
為 AI 智慧體打造的自進化上下文資料庫，統一智慧體記憶、知識 RAG 與技能。
nocobase
作者 nocobase
開源的 AI + 無程式碼應用搭建平臺：AI 在久經生產驗證的底層基礎設施與所見即所得的無程式碼介面之上工作，幫你快速構建 CRM、ERP 等業務系統，兼顧速度與可靠性。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程，從 0 到 1 系統學習智慧體工作流框架。
08資料與來源
把 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）接进 Hana，作为**进程内内嵌 agent**（runProfile 在宿主进程内 bo…
任务执行走 **dshana profile**（进程内 boot）
DSH 官方 Web UI 以 **DSHana 标签页**内嵌在 Hana 顶部
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-09-03。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。