huni-probe-agent/README.md

huni-probe-agent

信创模盒 ModelHub XC 适配智能体 · 只读探针骨架 (probe-only)。

对照官方样例 luopingyi/xc_agent_platform_demo（最小合规骨架）扩了一个零副作用探针。

用途

1. 验证平台「建仓 → Kaniko 构建 → 部署 → /health → 运行/停止」整条链路是否通。
2. 零副作用观测平台注入的 STRATEGY_ID / EXTERNAL_SERVICE_TOKEN 是否为有效凭证： 启动时用注入 token 调一次只读 GET /api/adapt/task/page，看返回 code： 0 = 凭证有效；40100 = 未登录/凭证无效。

满足的运行时契约

• 根目录 Dockerfile，EXPOSE 8080
• GET /health 返回 HTTP 200（K8s livenessProbe）
• 读取 STRATEGY_ID 与 EXTERNAL_SERVICE_TOKEN 环境变量
• 处理 SIGTERM，优雅停机（30s 窗口内退出）
• 资源占用极小，符合 requests 100m/256Mi、limits 1C/512Mi

明确不做

• 绝不提交任何验证任务（不调 task/add，不调 build-config）。
• 不打印 token 值、不落盘任何凭证；探针仅调只读 GET，仅记录 http/code/计数。

本地运行

python main.py
curl http://localhost:8080/health     # {"status":"ok"}
curl http://localhost:8080/           # 查看探针结果

上平台

推到 https://dev.modelhub.org.cn/<user>/<repo> 并保留一个真 git 标签（如 v1.0.0； 平台 Kaniko 按 refs/tags/<tag> 解析，用分支名会失败）。再在「我的适配智能体 → 新增智能体」 填 名称 / 仓库地址 / 标签 提交。