招标文件解析提取

概述

招标文件解析

使用 scripts/client.py，只调用统一任务服务，不直接调用 Agent Platform。

1. 优先检查并输入 AppKey（必须先于文件处理）：先调用 check-appkey。若返回 appkey_required（本地缺少、无效或已过期），只用简洁、可执行的自然语言说明下一步：请用户访问 获取 AppKey 页面 注册或登录获取新的 AppKey，再发送给 Skill；新用户注册即送 200 积分。收到用户提供的 AppKey 后，立即调用 configure-appkey --app-key '<用户提供的AppKey>'，再重新 check-appkey，确认 appkey_ok 后再继续。当预检因当前设备 IP 不在该 AppKey 的绑定 IP 列表内被拒时，只用简洁、可执行的自然语言说明：请用户到业务平台把当前网络 IP 加入该 AppKey 的绑定列表后重试；不得转述绑定列表内容或其他内部细节。不得在对话回复中回显 AppKey，不得自动打开网页、代为注册或使用无关网页数据。不得向用户转述接口原始响应、错误码、重试字段、请求头、配置文件或其他内部实现细节。详细安全说明见 [使用说明](references/usage.md)。在 AppKey 未就绪前，不得整理文件、不得调用 start-job。
2. 确认用户提供一份招标文件；缺失时明确要求上传，不继续后续步骤，用户上传的文件类型必须为doc/docx/pdf/markdown，如果是其他文件，拒绝并提醒用户重新上传。
3. 当 Job 返回 status=waiting_user_action 且 action_required.type=recharge 时，展示服务返回的 error.message 计费提示和充值链接，并让用户充值后回复“已充值”。用户确认后调用 resume-after-recharge --no-wait 继续原 job_id，再使用 monitor-job 查询；不得重新上传文件或重新提交 Job，不得展示 Python 堆栈、请求头或其他内部实现细节。
4. 平台域名、任务服务地址与 Agent 参数由 scripts/service_config.py 固定配置，不询问用户也不接受命令行覆盖。
5. 在 WorkBuddy 中调用 start-job 完成提交解析任务；不要调用会单次阻塞最长 2100 秒的兼容命令 run。start-job 必须在提交或找回已有任务后立即返回 job_submitted 或 job_recovered，其中包含可恢复的 job_id。客户端会记录该组材料的 job_id，后续调用先查询已记录 Job，绝不自动重新提交。普通 failed 只报告原 Job 失败；仅在用户明确要求创建新的解析任务时，才调用 start-job --new-job。当前版本暂不查询或确认用户单位及有效区域；不得要求用户提供或解释单位 ID、区域、身份上下文等内部字段。
6. 收到 start-job 输出后，必须先向用户明确展示“任务已提交/已找回”、job_id 和当前状态，再开始任何等待。随后用同一 job_id 调用 monitor-job --wait-seconds 20，读取每约 5 秒输出的 job_progress；若返回 monitor_continue，继续查询同一 Job，不得重新提交。将 message 和每项 todos 整理为自然中文进度反馈；把待办状态译为“待处理、进行中、已完成、失败或已取消”。若聊天或工具连接中断，下一轮直接用已展示的 job_id 调用 monitor-job 恢复查询。没有待办时只说明当前阶段，不得臆测解析结论。
7. monitor-job 发现 Job 成功后会下载 artifacts/ 下的全部产物，返回每个文件的绝对路径。任务仍为 queued/running 时不得把“已提交”表述为“解析完成”，也不得在未展示 job_id 的情况下结束回复。

先在 [环境接口配置](references/api.md) 中设置服务地址与 Agent。首次设置或排查 AppKey 配置时阅读 [使用说明](references/usage.md)；需要核对解析产物时阅读 [解析输出约束](references/analysis-output.md)。再执行：

python scripts/client.py check-appkey

python scripts/client.py configure-appkey --app-key '<用户提供的AppKey>'

python scripts/client.py check-appkey

python scripts/client.py start-job 
  --tender /workspace/tender.md

python scripts/client.py monitor-job 
  --job-id '<start-job 返回的 Job ID>' 
  --output-dir /workspace/artifacts 
  --wait-seconds 20

正式 Agent 由 scripts/service_config.py 中的 AGENT_ID 指定；Skill 只提交 agent_id，不提交 graph_id。