药材谷平台 · 第三批融合验收报告

2026-10-06 · 治理层建全链(C 类 5 模块) · 端到端六环全通 · 回归零破坏
本批聚焦王先生点名的「调度、监控、角色权限、日志、总看」中的治理空白:调度(C1)、实例监控(C2)、Agent审计(C3)、角色权限(C4)、产物归档(C5)。 五模块此前全站零实现(真空白),本批为建全链——不是补面,是从数据层到页面完整落地。 纪律:① 只加不减,未触碰任何现有代码行;② C3 复用 operate_log 底座零新建数据文件;③ C5 金融产物一律拒收(死命令②)。
5
本批新增模块
30+
新增接口
5
新增页面
5/5
开关拦截通过
13/13
回归接口直通
0
回归破坏

一、五模块清单与实测证据

类模块路由文件前缀 定位能力实测证据
C1任务调度中心agent_dispatch/api/admin/agent_dispatch全站任务派发总台任务建单→派发→执行→完成状态机 + 调度器负载 + 终态上链✅ 非法流转「已完成→执行中」被拒 400;链校验 verified=true
C2实例监控中心agent_instance/api/admin/agent_instanceAgent 实例运行态监控实例注册/心跳/亚健康降级/下线 + 主机真实指标✅ 心跳超 2 分钟自动降级亚健康、超 6 分钟离线;事件流留痕
C3Agent任务审计agent_audit/api/admin/agent_audit按 Agent 维度切面审计复用 operate_log 底座 + 风险分级 + 任务链追溯 + 指纹导出✅ 零新建数据文件,与 A1 日志审计中心同源不同面
C4角色权限中心agent_role/api/admin/agent_roleRBAC 功能权限底座权限点(20)→角色(5内置)→用户绑定→权限校验,角色变更上链✅ 角色创建/更新均生成链哈希;内置角色禁删;不为空角色解绑
C5产物归档中心artifact_archive/api/admin/artifact_archive任务产物归档与指纹校验登记→内容指纹→上链→按任务追溯→指纹比对防篡改✅ 金融口径产物「小额贷款台账」被拒 400(死命令②)

二、端到端六环链路(逐环验证)

模块链路(六环)状态
C1 任务调度页面(任务调度中心.html) → /api/admin/agent_dispatch/* → data/agent_dispatch.json → chain(prev_hash串联) → write_operate_log → module_agent_dispatch全通
C2 实例监控页面(实例监控中心.html) → /api/admin/agent_instance/* → data/agent_instance.json → events事件流 → write_operate_log → module_agent_instance全通
C3 Agent审计页面(Agent任务审计.html) → /api/admin/agent_audit/* → 操作日志/operate_log.jsonl(复用底座·零新建) → 指纹指纹 → write_operate_log → module_agent_audit全通
C4 角色权限页面(角色权限中心.html) → /api/admin/agent_role/* → data/agent_role.json(RBAC四表) → chain(变更上链) → write_operate_log → module_agent_role全通
C5 产物归档页面(产物归档中心.html) → /api/admin/artifact_archive/* → data/artifact_archive.json → content_fp+chain → write_operate_log → module_artifact_archive全通
六环口径:页面 → 接口(/api/前缀) → 数据层(JSON落盘) → 上链(chain_hash/prev_hash) → 日志(write_operate_log) → 开关(module_switches)。 缺任一环即为「半截链路」,是来回修 bug 的根因。本批 5 模块六环全通。

三、第六环必测 · 总控开关拦截

开关键模块关闭后查询恢复后查询结果
module_agent_dispatch任务调度中心关闭后 400恢复后 200✅
module_agent_instance实例监控中心关闭后 400恢复后 200✅
module_agent_auditAgent任务审计关闭后 400恢复后 200✅
module_agent_role角色权限中心关闭后 400恢复后 200✅
module_artifact_archive产物归档中心关闭后 400恢复后 200✅
验证方式:关闭 module_xxx → 调该模块 /overview → 应返回 400【模块维护中】 → 恢复开关 → 应返回 200。 5/5 全部通过,证明「一键停服不停机」治理能力对新增模块同样生效。

四、基准面演进(融合前 → 第一批 → 第二批 → 第三批)

资产项融合前第一批后第二批后第三批后累计增量
路由文件53576267+14
数据文件84859094+10
页面198202207212+14
模块前缀75798489+14
总控开关481318+14

五、老接口回归抽查(13 项全直通)

接口路径HTTP说明
/api/trade/trade_order_list200撮合订单清单(B4 结算订单可查)
/api/trade/market_list200行情列表
/api/system_dict/list200系统字典
/api/message/list200消息中心
/api/admin/log_query/list200A1 日志审计
/api/admin/ops_monitor/server/overview200A2 运维监控
/api/admin/total_board/overview200A3 总控看板
/api/admin/global_config/switch/list200A4 全局配置(18 开关)
/api/admin/mall_cart/list200B4 购物车
/api/admin/logistics_trans/waybill/list200B5 物流
/api/admin/goods_publish/list200B3 商品发布
/api/admin/address_book/list200B1 地址簿
/api/admin/user_setting/profile200B2 个人设置
挂载方式为 main.py 末尾追加(只加不减),未修改任何现有 include_router 行,故老接口零破坏。

六、页面交付(点击直达)

页面地址
任务调度中心http://127.0.0.1:80/任务调度中心.html
实例监控中心http://127.0.0.1:80/实例监控中心.html
Agent任务审计http://127.0.0.1:80/Agent任务审计.html
角色权限中心http://127.0.0.1:80/角色权限中心.html
产物归档中心http://127.0.0.1:80/产物归档中心.html

七、纪律与口径核对

铁律 / 死命令状态说明
① 只加我们没有的,已有的一律不动遵守5 路由全为新建文件;main.py 末尾追加 10 行;未改动任何现有代码
② 保留我方前缀风格与命名遵守统一 /api/admin/<模块>/* 前缀;暗夜黑 #F4F3F0 + 香槟金 #A8894F 页面风格
死命令① 八八六十四卦一律去掉未引入本批 5 模块零卦象内容、零引用
死命令② 金融板块一律不碰已加固C5 内置金融词黑名单,命中即 400 拒收;C4 仅功能权限、无支付密码
定位口径:撮合交易争取信息费遵守C1 任务类型含「撮合跟进」;不涉及资金收付
万境时空 / 万镜时空隔离隔离本批零引入跨项目内容

八、下一批候选

类候选现状说明
Dshort_video 短视频待激活需先定内容方向与上架规范
Dad_slot 广告位待激活需先定计费口径(属信息费,不属金融)
Dplant_base 种植基地档案待激活与现 agri_warn 预警可打通
清理存量 13 处卦象等王先生点头含上游 _build_compass.py(死命令①)
清理92 文件金融口径等王先生点头死命令②,已连续多批建议