知了商机大师 · 开放平台技能
用命令行工具 scripts/zlbx_agent.py 调用知了商机大师开放平台，覆盖对话、商机订阅、定时任务、标讯正文四类能力。
⚠️ 第一步：确认 API Key（每次启用本技能务必先做这一步）
本技能所有能力都需要一把 ZLBX_AGENT_API_KEY。加载本技能后、执行任何子命令之前，先检查环境变量里是否已配置该 Key：
echo "${ZLBX_AGENT_API_KEY:-未配置}"
若显示"未配置"（或用户尚未提供 Key）：不要直接尝试调用接口（会 401 失败），而应明确、主动地提示用户去获取 API Key，把下面这段话原样发给用户——
> 使用「知了商机大师」技能前，需要先提供一把 API Key。请点击此链接注册并创建 Key（注册即为免费用户，赠送 20 元额度，可直接体验）：
> 👉 获取地址： https://agent.zhiliaobiaoxun.com/developer?utm_source=skill
> 创建后把形如 zlbx_agent_xxx 的 Key 发给我，或自行执行 export ZLBX_AGENT_API_KEY=zlbx_agent_xxx。
拿到用户提供的 Key 后再继续。未拿到 Key 前不要调用任何子命令。
环境变量
ZLBX_AGENT_API_KEY（必填）：形如zlbx_agent_xxx，在 <https://agent.zhiliaobiaoxun.com/developer?utm_source=skill> 获取。注册即为免费用户，赠送 20 元额度，可直接体验。ZLBX_AGENT_BASE（可选）：API 基址，默认https://agent.zhiliaobiaoxun.com/openapi/v1。
工具无第三方依赖（仅用 Python 标准库），任意装有 Python 3 的环境可直接运行。
使用方式
export ZLBX_AGENT_API_KEY=zlbx_agent_xxxxx
python3 scripts/zlbx_agent.py <子命令> [参数]
所有子命令输出 JSON。异步类子命令加 --wait 会自动轮询到完成再返回结果。
对话
chat --message "帮我分析这条标讯的中标概率" [--session <对话ID>]—— 发起或继续对话（一次性完整输出）。返回含session_uid，续聊时传回。conversations [--page 1]—— 对话列表。messages --session <对话ID>—— 某对话完整内容。last-reply --session <对话ID>—— 某对话最后一次模型输出。
商机订阅
opp-trigger [--wait]—— 触发商机订阅分析（异步）。--wait轮询到完成并打印最新商机列表。opp-status --task-id <N>—— 查询运行状态。opp-list [--date YYYY-MM-DD]—— 获取最近一次商机列表。
定时任务
task-create --description "每天早上汇总昨天新发布的安防类标讯" [--schedule '{"kind":"daily","hour":8}'] [--title ...] [--no-notify]—— 创建定时任务。schedule 支持{"kind":"daily","hour","minute"}/{"kind":"weekly","weekday","hour"}/{"kind":"interval","every_hours"}，缺省每天 03:00。task-list [--status active|paused|archived]—— 任务列表。task-latest-run --task-id <N>—— 某任务最近一次执行结果。task-run --task-id <N> [--wait]—— 触发某任务立即执行（异步）。
标讯正文
bid-detail --bid-id <N> [--bid-type 1|2]—— 获取标讯正文（1招标/2中标，可省）。bid-analyze --bid-id <N> [--bid-type 1|2] [--wait]—— 触发项目分析师深度分析（异步）。bid-analysis --bid-id <N>—— 获取最近一次分析结果。
积分
balance—— 查询积分余额、会员当日剩余额度与到期时间。
说明
- 每次调用都会消耗账号积分/会员额度，与网页端一致。
- 限流：读类 60 次/分钟、写/触发类 6 次/分钟；超限返回 429。
- 遇到
401检查ZLBX_AGENT_API_KEY；402为积分不足；429稍后重试。
