dsh-plugin-h3-hip：h3-hip.c 的 DeepSeek Harness Host 插件

在 DeepSeek Harness (DSH) 生態中，Host 插件負責將外部推理引擎適配進 Harness 框架。h3-hip.c 是一個支持 MiniMax-H3 模型的引擎，通常通過 --serve 啓動並使用 v1alpha 協議進行通信。dsh-plugin-h3-hip 是對應的 Host bundle，獨立於 HIP 樹，用於解決協議對接與任務管理問題。

插件定位¶

這是一個 DeepSeek Harness Host bundle，專門用於連接 h3-hip.c 引擎。它實現了 v1alpha 協議，不依賴 HIP 樹，便於跟蹤 DSH 預覽版本的破壞性變更。

核心功能¶

h3_generate：語義化提交任務到 POST /v1/jobs，並利用 ctx.jobs 跟蹤 SSE 流。
h3-prompt skill：提供 MiniMax-H3 特有的三部分提示詞結構和參考標籤。
GET /v1/info：協議檢查，驗證 X-H3-Protocol: v1alpha 頭部，若返回 426 則提示用戶升級。
Fake daemon：提供模擬守護進程用於測試 (npm test)。

安裝與前置¶

在安裝前，請確保環境滿足以下條件：
1. h3-hip.c 版本 >= v0.12-exp，且啓動時帶 --serve 參數。
2. DSH 使用 web profile，且已掛載 tools 和 jobs（通常指 dsh-jobs-local + dsh-tool-jobs）。
3. 固定 DSH CLI 版本，預覽 API 可能會破壞兼容性。

安裝該 bundle 到 web profile：

dsh plugin --profile web add github:alexhegit/dsh-plugin-h3-hip#<40-char-sha>

典型用法¶

使用 skill 調用 h3-prompt 來撰寫提示詞。
調用 h3_generate，傳入 prompt，並可指定 preset、mode 或 geometry。
對返回的 DSH jobId 調用 job_output 或 job_kill。

開發與測試¶

項目提供了測試腳本來驗證功能。

npm test
node tests/fake-daemon.mjs --listen   # H3D_PORT=8571 stand-in

配置與注意事項¶

配置優先從環境變量讀取：H3D_BASE_URL 或 H3D_BIND + H3D_PORT（默認 http://127.0.0.1:8571）。

安全：不要將守護進程綁定到公共互聯網，DSH 是唯一的網絡入口。
許可證：MiniMax-H3 權重遵循模型社區許可證，在 IM 或公開分享前請務必審查。

生態背景¶

DSH 理念是“一切皆插件”。該插件在社區目錄有記錄，與 DeepSeek / 幻方無官方從屬關係。