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 / 幻方无官方从属关系。