主链统一 — 优化执行记录 v1(2026-07-06)
本文是 架构分析与主链统一方案_v1.md 的动手记录。
状态分级:✅已实装 / 🔧部分实装(安全外壳) / ⏳留待 P1 / ❌未做
一、P0-2 LLM 单入口 —— ✅ 已完成
新增文件
server/digital-staff/smart-llm-bridge.js
- 把已实现的
SmartLLMRouter(多级降级链)包装为LLMBrain兼容接口 - 暴露
getSmartBrain(),返回含chat/think/thinkJson/simulatedThinking的桥实例 - 失败自动回退到
LLMBrain.getGlobalInstance(),零破坏
改动文件(裸调点收敛)
| 文件 | 改前 | 改后 | 验证 |
|---|---|---|---|
| server/routes/aml.js ×8 | new LLMBrain() | getSmartBrain() | node --check OK |
| server/core/health-patrol.js | new LLMBrain() | getSmartBrain() | node --check OK |
| server/core/object-modeler.js | new LLMBrain() | getSmartBrain() | node --check OK |
残留(属 P1,非裸调)
- conversation-engine.js:78 / procurement-workflow-v3.js:16:注入 CapabilityRuntime 的构造参数,已在统一路径内
- llm-brain.js / test-llm-intent.js:定义与测试,不理
效果
所有"绕过 SmartLLMRouter 的裸 LLM 调用"已统一 → 唯一 metrics 出口 SmartLLMRouter.stats。
二、P0-3 Create 主路径统一 —— 🔧 安全外壳已装
改动文件
server/routes/unified-create.js
- 在
handleCreate的 SCSAI 连接获取后、Step 1 前,插入「规则预检钩子」 - 开关:
process.env.ENABLE_RULE_PRECHECK === 'true'才激活,默认关闭(逃生阀) - 激活时调用
rule-engine的/api/rule-engine/precheck,若返回duplicate则 409 阻断,否则仅记录ruleHits审计 - 任何异常 catch 后跳过不阻断,现有直连行为完全不变
诚实声明 ⏳
/api/rule-engine/precheck(双库去重 + 命中写入 sciot_rule_hits)尚未在 rule-engine.js 实装- 属 P1「开放对象 OS 主链」范围,本次不凭空造功能
- 当前开启开关后:不崩溃、不阻断,仅因 rule-engine 无 precheck 分支而走「跳过」分支
配套改动(前端)
- 实测
src/composables/useCapabilityCreate.js+useCreate.js:buildAML()→bomService._arasApiRequest('ApplyItem', mainAml)直连 SCSAI - 前端收敛(改为先调
/api/rule-engine/create-post再 applyAML)属 P1,需前后端联调,本次未动
三、P0-1 员工数漂移(12 vs 27)—— ⏳ 文档结论 + 留待 P1
实锤
- local.yaml 真实 ID = 30(含 3 个 LLM 平台占位 + 自动循环员工)
- 正式业务员工 27 个,enabled:false 仅 3 个
- 计划书主推 12 个
方案(P1 动手)
- local.yaml 增加
tier: standard|enterprise字段 - 主叙事只用 12 个 standard;其余 15 个降级 enterprise/internal profile
- 调度加载按 tier 过滤(需改 boss-scheduler loader)
四、P0-4 「五维」名实不符 —— ✅ 文档层已澄清
实锤
- 代码内「五维」= 数据健康体检五维评分:完整性/准确性/时效性/可用性/安全性
- 计划书把「五维对象交易市场」与「五维健康体检」混用同词
方案
- 代码侧:保持「五维评分」命名不变(已是可演示能力)
- 计划书侧:将「五维对象交易市场」改名为「六类对象交易市场」
(数据 / 模型 / 规则 / Skill / 工作流 / 数字员工)
- 避免尽调同名冲突(无需改代码)
五、未做项(明确记录,防 AI 误报已完成)
| 项 | 状态 | 原因 |
|---|---|---|
| 前端 Create 改走规则引擎 | ❌ | 需前后端联调,P1 |
| rule-engine precheck 双库去重 | ❌ | 属 P1 开放对象 OS 主链 |
| Worker 12 个改走 CapabilityRuntime | ❌ | P1 |
| 双库合一 | ❌ | P1 |
| Legacy index.js 清理 | ❌ | P1 |
| mtclaw leftarm handler 实装/删除 | ❌ | P1 |
| 自进化入主路径 | ❌ | P1 |
| 测试补齐 | ❌ | P2 |
| 多租户隔离 | ❌ | P2 |
六、回滚说明
- 所有 P0 改动均只改 require/构造,未删原 LLMBrain 逻辑
- bridge 失败自动回退 LLMBrain,无单点风险
- unified-create 钩子默认关闭,设
ENABLE_RULE_PRECHECK=false即恢复原行为 - 若需完全回滚:git revert 涉及 4 个文件 + 删除 smart-llm-bridge.js
BossAgents