BossAgents治理原生三层协同设计方案
核心原则
用户/智能体只做业务操作，治理在SCSAI服务端自动发生。应用层只展示结果，不触发治理。
用户输入 "帮我把这个BOM改一下参数"
↓
对话框 → 解析意图 → 调用SCSAI API（业务操作）
↓
SCSAI服务端 → 执行业务操作 → OnAfterUpdate Method自动触发
↓
治理逻辑 → 校验完整性 → 计算质量分 → 写入GovernanceLog → 建立Relationship
↓
返回结果 → 包含治理信息（质量分变化、修复了什么）
↓
对话框展示 → "已完成修改，质量分从72提升到95，修复了3个缺失字段"
一、业务界面层改造
1.1 角色定位变化
| 原来（错误） | 现在（正确） |
|-------------|-------------|
| 用户点击"修复"按钮 → 调用治理API | 用户点击"修改参数"按钮 → 调用SCSAI业务API → 治理自动发生 |
| 界面需要触发治理动作 | 界面只展示治理结果，不触发治理 |
| 治理是独立的Tab/功能模块 | 治理信息融合在每个业务Tab中 |
1.2 BOM详情页改造
不动：不单独建"资产信息"Tab、"治理历史"Tab。
正确做法：把资产信息融合在基础信息Tab，治理历史融合在变更记录Tab。
┌─ 基础信息 Tab ──────────────────────────────────────┐
│ │
│ ┌─ 业务属性 ─────────┐ ┌─ 资产属性 ───────────┐ │
│ │ 编号: BOM-001 │ │ 💰 估值: ¥47.2万 │ │
│ │ 名称: XX产品BOM │ │ 📊 质量: 95分(A级) │ │
│ │ 版本: 2.3 │ │ ✅ 治理: 已治理 │ │
│ │ 状态: 已发布 │ │ 责任人: 张三 │ │
│ └────────────────────┘ └────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────┘
┌─ 变更记录 Tab ──────────────────────────────────────┐
│ │
│ ┌─ 业务变更 ─────────┐ ┌─ 治理动作 ───────────┐ │
│ │ 2024-06-15 ECO-123 │ │ 巡检 发现缺失规格 │ │
│ │ 2024-05-20 ECO-098 │ │ 修复 补全规格 │ │
│ │ 2024-04-10 ECO-076 │ │ 优化 参数调优 │ │
│ └────────────────────┘ └────────────────────────┘ │
│ │
│ 说明：业务变更和治理动作在同一个时间线展示 │
│ │
└──────────────────────────────────────────────────────┘
1.3 数据来源
不再调用单独的治理API，直接调用SCSAI API：
// 查询Part完整数据（业务属性 + 资产属性）
const aml = `<AML>
<Item type="Part" action="get"
select="id,name,item_number,state,classification,asset_class,valuation,quality_score,governance_status,last_inspection"
id="${partId}">
</Item>
</AML>`;
// 查询治理历史（通过Relationship）
const logAml = `<AML>
<Item type="Part" action="get" id="${partId}">
<Relationships>
<Item type="Part Governance Log" action="get"
select="action_type,operator_name,timestamp,diff_summary,impact_quality,impact_value"/>
</Relationships>
</Item>
</AML>`;
1.4 操作触发
点击"修复"按钮 → 不调用治理API，调用SCSAI业务API：
// 点击"修复" → 实际是"编辑并补全字段"
const aml = `<AML>
<Item type="Part" action="edit" id="${partId}">
<description>${补全后的描述}</description>
<weight>${补全后的重量}</weight>
<!-- 补全其他缺失字段 -->
</Item>
</AML>`;
// SCSAI执行edit → OnAfterUpdate Method自动触发 → 治理自动发生
二、对话框改造
2.1 角色定位
对话框是用户的主要操作入口，用户说一句话 → 系统执行业务操作 → 治理自动发生 → 返回结果包含治理信息。
2.2 对话流程设计
用户: "帮我把这个BOM的参数改一下"
系统解析:
意图: 编辑BOM参数
对象: BOM-001
参数: ???（需要澄清）
系统: "请问要修改哪些参数？当前参数如下："
- 参数A: 100
- 参数B: 50
- 参数C: 缺失
用户: "把参数A改成150，补全参数C"
系统执行:
1. 调用SCSAI API编辑BOM
AML: <Item type="BOM" action="edit">
<parameter_a>150</parameter_a>
<parameter_c>补全的值</parameter_c>
</Item>
2. SCSAI执行edit
3. OnAfterUpdate Method自动触发
- 校验完整性: 发现参数D也缺失 → 自动补全
- 计算质量分: 从72 → 95
- 写入GovernanceLog: action_type=repair
- 建立Relationship
4. SCSAI返回结果（含治理信息）
系统回复: "已完成修改。"
✓ 参数A已更新为150
✓ 参数C已补全
✓ 自动补全了参数D（发现缺失）
✓ 质量评分从72提升到95
✓ 估值增加¥5,200
✓ 治理日志已记录
2.3 对话界面展示
┌─ 对话记录 ─────────────────────────────────────────┐
│ │
│ 用户: 帮我把这个BOM的参数改一下 │
│ │
│ 系统: 请问要修改哪些参数？当前参数如下： │
│ - 参数A: 100 │
│ - 参数B: 50 │
│ - 参数C: 缺失 ⚠️ │
│ │
│ 用户: 把参数A改成150，补全参数C │
│ │
│ 系统: ✓ 已完成修改 │
│ ┌─ 执行结果 ─────────────────────────────┐ │
│ │ · 参数A已更新为150 │ │
│ │ · 参数C已补全 │ │
│ │ · 自动补全了参数D（发现缺失） │ │
│ └─────────────────────────────────────────┘ │
│ ┌─ 治理结果 ─────────────────────────────┐ │
│ │ 📊 质量评分: 72 → 95 (+23) │ │
│ │ 💰 估值: ¥42万 → ¥47.2万 (+¥5.2万) │ │
│ │ ✅ 治理状态: pending → governed │ │
│ │ 📋 治理日志: repair动作已记录 │ │
│ └─────────────────────────────────────────┘ │
│ │
└────────────────────────────────────────────────────┘
2.4 对话后端逻辑
async function handleConversation(userInput, context) {
// 1. 解析意图
const intent = await parseIntent(userInput);
// 2. 获取当前对象数据
const currentData = await queryARAS(context.objectId);
// 3. 构建AML（业务操作）
const aml = buildAML(intent, currentData);
// 4. 调用SCSAI API执行操作
const result = await sendAML(aml);
// 5. 解析返回结果（含治理信息）
const newData = result.items[0];
const qualityChange = newData.quality_score - currentData.quality_score;
const valueChange = newData.valuation - currentData.valuation;
// 6. 构建回复消息
const reply = `已完成修改。
✓ 参数已更新
📊 质量评分: ${currentData.quality_score} → ${newData.quality_score} (+${qualityChange})
💰 估值: ¥${currentData.valuation} → ¥${newData.valuation} (+¥${valueChange})
✅ 治理状态: ${newData.governance_status}`;
return reply;
}
三、智能体（数字员工）层改造
3.1 角色定位
数字员工执行业务操作，不需要单独调用治理API。治理在SCSAI服务端自动发生。
3.2 数字员工执行流程
数字员工任务: "优化BOM-001的参数"
执行步骤:
1. 查询BOM-001当前数据 → 从SCSAI获取
2. 分析哪些参数需要优化 → 本地AI分析
3. 构建AML（编辑操作） → 本地构建
4. 调用SCSAI API → sendAML(aml)
5. SCSAI执行edit → OnAfterUpdate Method自动触发
- 治理逻辑自动执行
- 质量分自动更新
- GovernanceLog自动写入
6. 解析返回结果 → 包含治理信息
7. 更新任务板 → 显示资产贡献
任务板展示:
✓ 优化了3个参数
📊 质量评分: 72 → 95 (+23)
💰 估值: +¥5.2万
📋 治理日志: optimize动作已记录
3.3 数字员工任务板改造
┌─ 工艺数字员工 · 任务执行 ──────────────────────────┐
│ │
│ 任务: 优化BOM-001的参数 │
│ │
│ 步骤1: 查询BOM当前数据 │
│ ✓ 获取到BOM-001完整数据 │
│ │
│ 步骤2: 分析优化点 │
│ ✓ 发现参数A偏高，建议降低 │
│ ✓ 发现参数B偏低，建议提高 │
│ │
│ 步骤3: 执行优化（调用SCSAI API） │
│ ✓ 参数A已优化: 100 → 80 │
│ ✓ 参数B已优化: 50 → 60 │
│ ┌─ 资产贡献 ───────────────────────────────┐ │
│ │ 📊 质量评分: 72 → 95 (+23) │ │
│ │ 💰 估值: ¥42万 → ¥47.2万 (+¥5.2万) │ │
│ │ 📋 治理动作: optimize已记录 │ │
│ └───────────────────────────────────────────┘ │
│ │
│ 步骤4: 生成优化报告 │
│ ✓ 报告已生成，可查看 │
│ │
│ ──────────────────────────────────────────────── │
│ 本次任务资产贡献: │
│ 💰 价值提升: +¥5.2万 │
│ 📊 质量提升: +23分 │
│ 📋 治理记录: 2条 │
│ │
└────────────────────────────────────────────────────┘
3.4 多数字员工协同
共享治理结果，GovernanceLog累积记录：
┌─ 多数字员工协同 ──────────────────────────────────┐
│ │
│ 用户: "帮我检查这个BOM并优化" │
│ │
│ 巡检数字员工: │
│ → 扫描BOM-001 │
│ → 发现缺失字段 │
│ → SCSAI Method自动写入GovernanceLog │
│ → 返回: 发现3个缺失字段 │
│ │
│ 修复数字员工: │
│ → 调用SCSAI API补全字段 │
│ → SCSAI Method自动触发治理 │
│ → 返回: 已修复，质量+15分 │
│ │
│ 优化数字员工: │
│ → 调用SCSAI API优化参数 │
│ → SCSAI Method自动触发治理 │
│ → 返回: 已优化，质量+8分 │
│ │
│ ──────────────────────────────────────────────── │
│ 协同结果: │
│ 📊 质量评分: 72 → 95 (+23) │
│ 💰 估值: +¥5.2万 │
│ 📋 治理记录: 3条（巡检+修复+优化） │
│ │
└────────────────────────────────────────────────────┘
3.5 绩效统计维度扩展
| 维度 | 原来 | 现在 |
|------|------|------|
| 能力定义 | 识别/创建/修复/优化/比对/生成 | 不变，执行时治理自动发生 |
| 任务记录 | 记录执行步骤 | 记录执行步骤 + 资产贡献 |
| 绩效统计 | 任务完成数 | 任务完成数 + 资产贡献总额 |
四、三层协同完整流程
┌──────────────────────────────────────────────────────────────┐
│ 用户视角 │
├──────────────────────────────────────────────────────────────┤
│ │
│ 用户打开BOM详情页 │
│ → 看到: 业务信息 + 资产信息（融合展示） │
│ → 看到: 变更记录 + 治理历史（融合展示） │
│ │
│ 用户输入对话 "帮我把这个BOM改一下参数" │
│ → 对话框解析意图 │
│ → 调用SCSAI API │
│ → SCSAI Method自动触发治理 │
│ → 返回: 执行结果 + 治理结果 │
│ │
│ 用户点击"优化"按钮 │
│ → 调用SCSAI API │
│ → SCSAI Method自动触发治理 │
│ → 页面刷新，展示新的质量分和估值 │
│ │
└──────────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────────┐
│ 智能体（数字员工） │
├──────────────────────────────────────────────────────────────┤
│ │
│ 数字员工执行任务 │
│ → 调用SCSAI业务API │
│ → SCSAI Method自动触发治理 │
│ → 任务板展示: 执行步骤 + 资产贡献 │
│ │
│ 数字员工协同 │
│ → 多个员工依次调用SCSAI API │
│ → SCSAI Method每次都自动触发治理 │
│ → GovernanceLog累积记录 │
│ │
└──────────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────────┐
│ SCSAI服务端 │
├──────────────────────────────────────────────────────────────┤
│ │
│ 接收AML请求 │
│ → 执行业务操作（edit/add/delete） │
│ → 触发OnAfterUpdate Method │
│ → 校验完整性 │
│ → 计算质量评分 │
│ → 更新资产属性 │
│ → 写入GovernanceLog │
│ → 建立Relationship │
│ → 返回结果（含治理信息） │
│ │
└──────────────────────────────────────────────────────────────┘
五、关键改造清单
| 层级 | 改造点 | 原来做法 | 正确做法 |
|------|--------|---------|---------|
| 业务界面 | BOM详情页 | 资产信息单独Tab | 融合在基础信息Tab |
| 业务界面 | 变更记录Tab | 只展示ECO | 展示ECO + GovernanceLog |
| 业务界面 | 能力按钮 | 调用治理API | 调用SCSAI业务API，治理自动发生 |
| 对话框 | 意图解析 | 解析后调用治理API | 解析后调用SCSAI业务API |
| 对话框 | 结果展示 | 只展示执行结果 | 展示执行结果 + 治理结果 |
| 数字员工 | 任务执行 | 执行后调用治理API | 执行SCSAI业务API，治理自动发生 |
| 数字员工 | 任务板 | 展示执行步骤 | 展示执行步骤 + 资产贡献 |
| 数字员工 | 绩效统计 | 任务完成数 | 任务完成数 + 资产贡献总额 |
六、现状与下一步
6.1 当前实施状态（Phase 3 已完成）
| 层级 | 状态 | 说明 |
|---|---|---|
| SCSAI治理引擎 | ✅ 完成 | OnGovernanceTrigger + BatchGovernance、资产属性、GovernanceLog |
| 服务端Dashboard API | ✅ 完成 | /api/dashboard/asset-overview + today-governance |
| BOM详情页改造 | ✅ 完成 | 资产属性融合基础信息Tab、治理日志融合变更记录Tab、冗余代码清理 |
| Dashboard首页 | ✅ 完成 | 资产总览4卡片 + 今日治理动态 |
| 对话框治理结果 | ✅ 完成 | Part/BOM修复操作返回治理影响 |
| 数字员工资产贡献 | ✅ 完成 | 任务日志展示质量/价值变化 |
6.2 后续增强方向
- 多数字员工协同聚合 — 多员工协作任务的结果中汇总总资产贡献
- 对话框意图直连SCSAI — AI解析用户意图后直接构建SCSAI业务AML，而非走
/api/ai-agent/execute中间层 - 绩效统计扩展 — 数字员工绩效面板增加"资产贡献总额"维度
6.3 验证闭环
SCSAI中修改Part字段 → OnAfterUpdate → 质量分自动更新 → GovernanceLog自动生成
↓
前端BOM详情页实时看到质量分变化 Dashboard今日动态同步出现该条记录
↓ ↓
对话框执行修改操作时返回治理变化对比 数字员工日志展示资产贡献
附录：相关文件
| 文件 | 说明 |
|------|------|
| server/scripts/phase3-governance-setup.js | SCSAI数据模型自动配置脚本 |
| server/scripts/phase3-verify.js | 验证脚本 |
| server/scripts/methods/OnGovernanceTrigger.cs | OnAfterUpdate触发Method |
| server/scripts/methods/BatchGovernance.cs | 批量治理Method |
| server.js | 治理Dashboard API端点 |
| src/components/BomDetailModal.vue | 资产/治理融合展示 |
| src/views/Dashboard.vue | 资产总览/治理动态 |
| src/views/AiWorkbench.vue | 对话框治理结果回复 |
| src/views/DigitalStaff.vue | 数字员工资产贡献 |
| docs/治理原生架构重构-实施总结-v1.md | Phase 3实施总结 |
