BossAgents 项目落地现状与技术推进指南

文档性质: 核心技术交付文档

适用对象: 研发团队、项目管理、数字化转型决策者

当前版本: v1.0 (2026-05-22)

一、 核心现状评估 (Current Status)

项目已跨越“原型搭建”阶段，正式进入“架构标准化”与“数字员工实战”阶段。

1.1 架构层：Vite + Vue 3 迁移完成

• 现状: 核心代码已从 7000+ 行的 index-vue.html 迁移至 Vite + Vue 3 SFC 架构。
• 已解决:
• 解决了 Vite 环境下静态资源路径解析导致的 404 错误。
• 修复了 dist/ 目录在 Node.js 服务端托管的稳定性。
• 待优化: 仍有约 40% 的业务函数残留在 app.js 中，需继续按模块拆分至 src/views/。

1.2 稳定性：底层脚本与初始化加固

• Sciot 报错修复: 针对 Uncaught TypeError: Cannot set properties of undefined (setting 'evalMethod')，已通过 IIFE 封装逻辑 修复了 SCSAI/sciot_methods.js。现在系统支持“自愈式”初始化，不再受脚本加载顺序干扰。
• AI 唤醒逻辑: 引入了 systemReady 检查机制。服务器启动后会优先加载 7700+ 条 AML 规则知识库，确保 AI 接口在“脑干”就绪后再对外提供服务，解决了“系统繁忙”的初始化断层。

1.3 数字员工：首个 Agent 落地

• 库存巡检员 (Inventory-Alert Agent):
• 路径: server/agents/inventory-alert-agent.js
• 逻辑: 实现了“感知（库存低于安全线）-> 上报（写入 risk_alerts）-> 看板展示（Dashboard 同步）”的完整闭环。
• 调度: 已集成至 config.yaml 的 Cron 任务中。

二、 后续开发关键文档清单

研发团队必须严格遵守以下文档定义的标准进行后续推进：

2.1 顶层蓝图：BOSSAGENTS_IMPLEMENTATION_PLAN.md

• 核心价值: 规划了 14 周的落地路径，涵盖了对标阿里 QoderWake 的“岗位化”转型策略。
• 研发指导: 明确了“记忆、技能、策略、验证、工作流”五维度架构。

2.2 路由分发标准：server.js

• API 协议:
• 业务聚合接口: /api/boss/dashboard (老板决策核心)
• 实时风险流: /api/boss/risks
• AI 对话接口: /api/ai/agent/chat (支持双路径兼容)
• 注意: 后续新增 API 必须在 handleRequest 的顶层分发逻辑中统一注册。

2.3 功能开关手册：config.yaml

• 配置项:
• cron.enabled: 控制数字员工后台扫描任务。
• features.digital_staff: 控制前端 AI 面板的显示与隐藏。

三、 后续推进的关键动作 (Critical Actions)

1. 知识库向量化 (Phase 2 核心)

• 目标: 将 7700+ AML 规则转化为向量索引，实现“语义级规则校验”。
• 工具: 建议使用 BAAI/bge-large-zh 嵌入模型。

2. 飞书/钉钉互动卡片 (Phase 4 核心)

• 目标: 实现“消息即审批”。
• 任务: 将 risk_alerts 表的变动实时推送到飞书 Webhook，并承载审批回调。

3. 执行证据包 (Audit Logic)

• 目标: 参照 QoderWake，在 Auto-Fixer 执行修复后自动生成 audit_log 和变更 Diff。
• 逻辑: 封装 database.js 的写操作，强制关联 AI 的决策 ID。

四、 开发者自测 checklist

• [ ] 运行 node server.js，日志是否出现 ✅ BossAgents 数字员工已全员上岗！？
• [ ] 访问 Dashboard，老板决策中心的“BOM 成本健康度”是否能显示实时风险数？
• [ ] 触发库存预警，/api/boss/risks 接口是否能返回对应的 supply 类型风险项？

编写者: Accio AI Assistant

归档日期: 2026-05-22