平台运营指南
面向平台运营，不是普通用户。 日常操作：审核供给、配置商业参数、处理争议、查看痕迹、监控异常。
日常入口
| 页面 | 路径 | 用途 |
|---|---|---|
| 运营总览 | /console/overview | 今天待处理的事 |
| 履约与痕迹 | /console/insight | 按任务查看履约、托管、事件流、因果链 |
| 策略设置 | /console/policies | 赔付比例、上限、SLA、费率、担保范围 |
| 商户审核 | /console/merchant-onboarding | 商户能力开通审核 |
| Agent 与供给 | /console/agents、/console/profiles | Agent 状态、能力声明、上架 |
| 订单 / 客户 / 账务 | /console/orders、/console/customers、/console/accounting | 业务数据 |
| 集成 | /console/integrations | 商户 ERP / CRM 连接器 |
| 运行与验证 | /console/runtime、/console/verification | 运行状态与交付校验 |
审核 Agent 上架
draft → testing → active审核要点：
| 项 | 检查 |
|---|---|
| 能力声明 | 是否与真实能力一致 |
| 输入输出 | 是否符合平台能力契约 |
| 端点 | 是否可访问、能否正常响应 |
| 承诺 | 响应时间与准确率是否合理 |
| 定价 | 是否在合理区间 |
| 资质 | 需要持牌 / 认证的业务，是否具备 |
上架后：
active状态进入匹配池；- 修改输入输出契约需要先升能力版本；
- 异常时可
suspend，已推送任务继续。
认领审核
企业认领已有 Agent 时，走 /claim/:agentId 提交申请。运营在待审列表里：
- 核对主体资料与归属证明；
- 通过后 Agent 过户到该组织；
- 旧的归属关系清空，避免两边都能管理。
审核商户能力
商户要正式接单、收款，需要开通四项能力：
- 订单；
- 履约；
- 托管；
- 支付。
运营在 /console/merchant-onboarding 查看待审：
| 检查项 | 说明 |
|---|---|
| 企业资料 | 主体是否真实、是否与 Agent 归属一致 |
| 结算信息 | 账户后四位是否完整（平台不存全量账号） |
| 能力范围 | 申请的能力是否与业务匹配 |
| 风险信号 | 是否有异常历史、投诉或争议记录 |
通过后，能力写入 Agent 的商户档案，后续下单 / 支付门禁据此判断。
配置商业参数
/console/policies 或 PUT /api/sys/policy-settings。
| 场景 | 配置 |
|---|---|
| 提高缺件赔付 | compensation.schedule.missing_items |
| 限制单笔风险 | compensation.capAmount |
| 加快争议处理 | dispute.slaHours |
| 超时自动放款 | dispute.onTimeout = release |
| 只担保按时交付 | guarantee.scope = process |
| 收取平台服务费 | settlement.platformFeeBps |
| 启用单步审批 | run.toolApprovalThreshold |
| 多级审批 | run.requiredApprovers |
注意事项：
- 修改对下一笔结算生效，不回溯；
- 版本冲突返回 409，刷新后重试；
- 每次修改都有审计记录；
- 默认值是假设基线，变更前应与商务 / 法务确认。
详见 策略设置。
处理争议
/console/insight?taskId=...
├─ 查看交付与验收
├─ 查看争议事由与证据
├─ 判断责任
└─ 录入裁定
└─ 系统按条款计算赔付并生成结算指令如果事由没有对应条款，系统返回 409，不会猜测比例。此时需要：
- 确认争议分类；
- 补充条款或给出明确金额；
- 重新裁定。
查看痕迹
/console/insight 提供四个视图：
| 视图 | 内容 |
|---|---|
| 履约事实 | 交付、验收、争议、处置 |
| 托管状态 | 状态、金额、结算指令 |
| 事件流 | 原始状态事件 |
| 因果链 | 谁触发了谁 |
该页面刻意只读，避免运营修改事实。
监控
| 指标 | 来源 |
|---|---|
| API 错误率 | Nginx / 应用日志 |
| Agent 在线率 | /api/gateway/agents/status |
| 任务失败率 | 任务状态 |
| 争议超时 | slaDueAt 扫描 |
| 状态一致性 | verify() |
建议告警：
- 5xx 比例突增；
- Agent 长时间离线；
- 争议超时未处理；
- MongoDB 副本集状态异常；
- 磁盘 / 事件集合增长。
常用命令
bash
# 查看服务
pm2 status
pm2 logs hushwork --lines 100
# 数据库
node scripts/mongo-promote-replset.js
mongosh --eval 'rs.status().ok'
# 整条业务是否还活着
npm run case:reference -- --commit
# 录入一单（手工通道）
npm run fulfillment:record -- --input=my-order.json发布节奏
- 变更前备份数据库；
- 预发环境验证；
- 生产
pm2 reload； - 检查
/api/a2a/agent-card； - 观察 15 分钟日志；
- 如 API 变更，更新文档：
bash
npm run docs:api
npm run docs:build
npm run docs:deploy