把智能体所有会变的东西收进一处可治理的配置域：十二类资产全部配置化并版本化，五角色各司其职且互相制衡，每一次发布留痕、每一条结论可回放。
智能体一旦能自己改规则，风险就从"业务风险"扩展到"治理风险"。本智能体针对的是四个会在验收后被追问的问题。
参数写死在常量里就无法按货种、按部门演进。改为十二类资产全部配置化，改动附评审记录，代码里不留业务常量。
业务专家、专员、管理员都可能碰规则。改为状态机加二人复核：任何角色与智能体的写入只产生候选，生效动作必须来自另一人的复核记录。
事后无法还原当时用了哪套规则，就没法解释"同一事件不同分"。改为版本五元组随事件与预警写入快照，按当时版本重放。
子公司之间的预警与人工判定记录必须隔离。改为按货种链与所属部门设可见域，信源与事件公开共享、判定记录隔离。
类数的唯一口径出处是《全量规划 v1.1》§11.1。前八类沿用 V1.1，后四类因图谱与插件生态而新增。每一类都要能列表、搜索、新增、编辑、启停、导入导出，并进入同一套状态机。
| 类 | 内容 | 为什么必须配置化 |
|---|---|---|
| 信源清单 | 来源域名、类型、语言、频率档、可信度档、使用授权 | 新增信源不应改代码，接入按人日计量 |
| 关键词词库 | 事件触发词、货种中英别名与变体、排除词 | 别名漏写等于漏事件，必须由业务侧自己补 |
| 节点主数据 | 港口、航道咽喉、矿区、卸港的坐标与主键 | 26 个必做节点、一期启用 22 个，增删直接影响大屏与图谱 |
| 航线主数据 | 航线几何、途经节点、基准里程与时长 | 暴露度与绕行增程的计算基准 |
| 货种主数据 | A/B/C 分级、HS 与行业编码、中英别名四路展开 | 分链风险与跨货种复用的锚点 |
| 指标口径字典 | 指标定义、单位、计算式、来源、更新频率 | 口径校验的前提，避免不同口径被拼成结论 |
| 模型参数表 | 基础严重度、强度/持续/可信度修正因子、权重 | 需求原文禁止以代码常量固化 |
| 预警阈值表 | 四级阈值、乘积口径、样本量下限 | 阈值是业务判断，需专家复核并可回滚 |
| 图谱节点与边 | 因子、事件、对象、后果、措施五段链路与边三属性 | 传导关系由专家共建，未复核即候选 |
| 措施库 | 采购、航运、合同、保险四栏应对建议与适用条件 | 预警建议必须取自库，不让模型自由发挥 |
| 插件 descriptor | 采集插件的契约、鉴权引用、配额、许可与健康度 | 采集从开发人周降为配置人日 |
| 提示词模板 | 抽取、归类、报告各任务的模板与输出契约 | 提示词是资产不是代码片段，需版本与评审 |
权限矩阵的要点不是"谁能看什么"，而是"谁不能自己把改动变成生效"。四条硬性要求逐条可在原型里用角色切换器验证。
| 角色 | 职责 | 能做什么 | 不能做什么 |
|---|---|---|---|
| 管理层领导 | 查看全局态势、做战略决策 | 只读全部态势与报告 | 不修改规则与事件 |
| 航运运营人员 | 执行航次计划、跟踪实时风险 | 本部门可见域内只读；提交规则反馈与实际影响回复 | 不改变预警判定状态 |
| 风险管理专员 | 维护规则库、审核预警准确性 | 唯一可改预警判定状态 规则编辑为草稿态 | 不自行发布生效 |
| 系统管理员 | 配置、数据源接入、权限 | 规则与参数发布生效、运维配置 | 发布仍需二人复核，不可单人闭环 |
| 业务专家 | 定义因子、传导关系与措施，复核候选项 | 可写五类资产为候选态（因子、边、阈值、词库、措施） | 不可自行发布生效 不参与预警判定 |
预警判定状态仅专员可改且该记录即标注样本；规则由专员编辑草稿、管理员发布且二人复核留痕；事件与信源公开共享而预警与判定按部门与货种链隔离；任何角色与智能体不得使未经复核的改动直接生效。
传导边中影响程度高的条目需双人复核后才参与计算，否决记录作为负样本回流，用于回答"相比上一版本变准了多少"。
治理的落点是可回放。任选一条历史预警，应能还原"来源、事件、因子、阈值、推送、人工判定"整条链，且明确标出当时用的是哪一版规则。
{lexicon, model, threshold, graph, plugin} 五元组并被当次事件与预警引用。图谱边权重与采集插件的变更同样进版本，否则无法解释同一事件得到不同分数。等保二级是客户要求的目标定级。责任边界先划清：定级备案、测评机构、机房与网络由客户侧承担，本项目只做应用层实现，报价不把测评与机房成本算进来。
按部门与货种链设可见域，预警与人工判定记录隔离；事件与信源本身是公开信息，可全员共享。
对外与内部服务间全部 TLS，不开放明文端口。
数据源密钥与模型凭据不写入代码与仓库，统一由部署环境注入，提交前执行凭据扫描。descriptor 里出现明文凭据即判门禁失败。
每条来源带使用授权标签（仅内部展示、可引用并署名、禁止再分发），导出与大屏图层据此自动裁剪。
演示与非实时数据必须可见标注"示意数据"；对外展示页支持水印，生产环境固化不可误开。
遵守 robots、单域频率上限、UA 明示与退避重试；不用搜索引擎结果页链接冒充来源。