BossAgents BossAgents

从“微信发布插件”到企业级AI数字员工平台：一个产品演进的启示录

👤 BossAgents 团队 📅 2026-07-19 👁️ 阅读 42 👍 点赞 0 ☕ 187 分钟阅读

BossAgents 主平台认知地图

本文档是对 C:\www\wwwroot\bossagents 项目的结构化认知梳理。

BossAgents 是「左帮右臂」主平台（3006 端口），与 cms/workbuddy-claw-wechat-publisher（8088 端口）是 对接关系：前者是数字员工"大脑+脊柱"，后者是内容数字员工的"嘴+门面"。

来源：基于对源码（server.js、server/digital-staff/、server/boss-scheduler/、server/core/capability-runtime.js、server/boss-scheduler/profiles/local.yaml、src/router/index.js 等）与最近 git 改动的实际阅读。

一、项目定位

项目说明
名称BossAgents · 左帮右臂 — AI 驱动企业级 PLM 平台
描述SCSAI PLM BOM 管理系统 — 企业级 PLM 集成，支持 BOM 全生命周期管理、变更管理、供应商管理、数字员工平台
技术栈Vue 3 + Vite（前端 5173） + Node.js（后端 3006） + SQLite/MySQL
核心模块数据资产管理、工艺规程管理、BOM 管理、数字员工
主入口node server.js（后端 3006）/ npm run dev:vite（前端 5173）
包管理pnpm@10.22.0
与 workbuddy 的关系workbuddy 通过 /api/bossagents-proxy 代理到本平台 :3006，挂了降级 mock 真数据

一句话定位

"让每家制造企业都拥有自己的数字员工" — 面向制造业的 AI 驱动企业级 PLM 平台。

核心叙事（首页 handleHome 的六大价值维度）：

  1. 资产价值量化（86 万资产 · 1.015 亿估值）
  2. 关系网络发现（73 万关系 · 工艺→工序→工步→技术参数）
  3. 质量体检诊断（一键修复）
  4. AI 智能洞察（趋势识别 + 报告生成）
  5. 数字员工协同（11 个活跃员工 · 4300+ n8n 工作流）
  6. 业务流程追溯（工艺文件 11 万可追溯）

二、代码骨架

bossagents/
├─ server.js                # ★★★ 5269 行主服务入口（API 路由全在这）
├─ app/                     # Express 风格的 router 模块（boss/dispatch/feishu 等已迁移至此）
│   ├─ router.js
│   ├─ middleware.js
│   └
│   └  routes/  boss.js  capability.js  dispatch.js  feishu.js  messages.js
├─ core/                    # SCSAI 集成层（Vue/TS）
│   ├─ SCSAIAuthenticator.js / SCSAICoreWrapper.js / SCSAIDataService.js
│   ├─ SCSAIDependencyLoader/Manager/Resolver.js
│   ├─ SCSAIFileLoader.js / SCSAIPathMapper.js / SCSAIVuePlugin.js
│   └  RealSCSAIWrapper.js / GlobalObjectsPatch.js / Logger.js / SCSAI-config.js
│   └  auth/  EnhancedUnifiedAuthManager.ts / UnifiedAuthManager.ts
│   └  external/  XmlCompatibility.js
│   └  middleware/  UnifiedAuthMiddleware.ts
│   └  router/  UnifiedRouterManager.ts
├─ server/                  # ★★★ 后端业务模块
│   ├─ digital-staff/       # 数字员工"大脑"（详见下文）
│   ├─ boss-scheduler/      # 数字员工"脊柱"（详见下文）
│   ├─ core/                # 业务能力引擎（详见下文）
│   ├─ routes/              # 路由模块（digital-staff-routes.js 等）
│   ├─ agents/              # 决策智能体（comparison/decision/inventory-alert/quotation-parser）
│   ├─ channels/            # 渠道适配（openclaw/wechat）
│   ├─ services/            # 服务层（audit-log 等）
│   ├─ utils/               # 工具（SCSAI-client / i18n / logger）
│   ├─ shared/              # 共享（i18n）
│   ├─ config/              # 配置文件（models / item-type-registry / extraction-prompts / domain-templates）
│   ├─ data/                # SQLite DB + JSON 数据（bossagents.db / aml.db / digital-staff-*.json）
│   └  __tests__/  _deprecated/
├─ src/                     # Vue3 前端
│   ├─ router/index.js      # 580 行路由（60+ 页面）
│   ├─ views/               # 页面组件（60+ 个 .vue）
│   └  components/ composables/ services/ stores/ i18n/ utils/
├─ MTClaw/                  # MTClaw 思想加速子项目（OpenClaw 插件 + Python skills）
├─ SCIOT/                   # SCIOT 工业数据（SOLIDCAD ERP）
├─ bossagents-miniapp/      # 微信小程序前端
├─ config.yaml              # 服务端配置
├─ .env / .env.example      # 环境变量
├─ DATA_ASSET_PLATFORM_DESIGN.md / SYSTEM_STATUS_REPORT.md / VALUE_DEMO_PLAN.md  # 设计文档
└─ REFACTOR_PLAN_V2/V3/V4.md  # 重构计划

三、数字员工三大层（最关键，记牢）

BossAgents 的数字员工是 三层架构：大脑 → 脊柱 → 能力。这是和 workbuddy 那种"单个 handler 一个员工"完全不同的体系化设计。

┌──────────────────────────────────────────────────────────────┐
│              L3 业务员工层（YAML Profile 定义）               │
│   server/boss-scheduler/profiles/local.yaml                  │
│   30+ 个员工：DS-BOSS-001 ~ DS-NEWS-001                     │
│   每个员工：id/name/cron/worker/capability/llm/keywords     │
└──────────────────────────────────────────────────────────────┘
                          ↓ runOnce(staffId, intent, parameters)
┌──────────────────────────────────────────────────────────────┐
│              L2 调度层（LiteScheduler）                       │
│   server/boss-scheduler/lite-scheduler.js (2323 行)          │
│   cron 触发 + 互斥锁 + 队列 + Loop/Goal + Pipeline            │
│   分发路径：Worker / Capability / Pipeline / Loop / Generic  │
└──────────────────────────────────────────────────────────────┘
                          ↓ _runCapabilityPath
┌──────────────────────────────────────────────────────────────┐
│              L1 能力层（CapabilityRuntime）                   │
│   server/core/capability-runtime.js (2012 行)                │
│   六大能力：identify / validate / repair / optimize /         │
│             compare / generate + inspect/valuate/collect/import │
│   规则引擎优先 → LLM 降级                                     │
└──────────────────────────────────────────────────────────────┘
                          ↓
┌──────────────────────────────────────────────────────────────┐
│              L0 智能层（LLMBrain + LLMRouter）                │
│   server/digital-staff/llm-brain.js（863 行）                │
│   server/digital-staff/llm-router.js（694 行）               │
│   server/digital-staff/smart-llm-router.js（1277 行）        │
│   MTClaw 思想：Worker（小模型 ~70ms）/ Solver（大模型 ~500ms） │
│   70%+ 走 Worker，7 倍加速                                    │
└──────────────────────────────────────────────────────────────┘

3.1 L0 智能层 — server/digital-staff/

| 文件 | 行数 | 职责 |

|---|---|---|

| llm-brain.js | 863 | LLMBrain 类，单例 getGlobalInstance()。配置优先级：LLM_ > DIGITAL_STAFF_LLM_ > config > 默认。检测 MTClaw 加速（端口 18790） |

| llm-router.js | 694 | LLMRouter + InferenceServiceDetector，Worker/Solver 分工 |

| smart-llm-router.js | 1277 | SmartLLMRouter，智能调度层（熔断 / 重试 / 缓存） |

| smart-llm-bridge.js | 96 | 桥接 |

| index.js | 2712 | 旧版数字员工核心调度器（cron + SCSAI + 能力 SDK），已被 LiteScheduler 取代，保留兼容 |

| loader.js | 13 | 加载器 → 始终返回 boss-scheduler（统一架构） |

| staff-manager.js | 555 | StaffManager — 数字员工配置 CRUD（建表 digital_staff / staff_tasks / staff_execution_logs） |

| task-board.js | 321 | 任务看板 |

| config-manager.js | 249 | 配置管理 |

| keyword-matcher.js | 148 | 关键词匹配（旧版，已被 staff-router 取代） |

| conversation-engine.js | 410 | 对话引擎 |

| conversation-manager.js | 213 | 对话管理 |

| correction-learner.js | 311 | 自进化学习器 |

| ascend-npu.js | 495 | 昇腾 NPU 适配 |

| chipwise-handler.js | 506 | 芯片设计专用 handler |

| plm-brain-handler.js | 529 | PLM 文档大脑 handler |

| collaboration-scheduler.js | 276 | 协作调度 |

| collaboration-rules.yaml | — | 协作规则 |

3.2 L2 调度层 — server/boss-scheduler/

lite-scheduler.js (2323 行) — LiteScheduler 类，核心方法：

| 方法 | 行 | 职责 |

|---|---|---|

| runOnce(staffId, intent, parameters) | 2096 | 主入口：执行一次员工任务 |

| resumeStaff(staffId, resumeId, choice) | 2243 | 恢复被 ConfirmNeededError 暂停的任务 |

| _runWorker(staff, intent, parameters) | 1374 | 分发器：按员工配置选路径 |

| _dispatchWorkerPath | 874 | Worker 路径（特殊 worker） |

| _runLoopGoalPath | 907 | Loop/Goal 路径 |

| _runPipelinePath | 945 | Pipeline 路径（多能力串联） |

| _runWorkerScriptPath | 1025 | Worker 脚本路径 |

| _runCapabilityPath | 1065 | 能力路径 → 调 CapabilityRuntime |

| _runDecomposedSteps | 1245 | 分解步骤执行 |

| _runGenericPath | 1349 | 通用兜底 |

| _processStaffTasks | 1491 | 处理任务队列 |

| _runLoopAction | 1521 | Loop 动作执行 |

| _checkGoalCondition | 1808 | Goal 条件检查 |

| _executeGoalSuccess/Failure | 1874/1918 | Goal 达成/未达成动作 |

| _sendNotification / _createAlert | 1968/1987 | 通知/告警 |

| _withStaffMutex | 768 | 员工互斥锁 |

| _checkLoopCondition / _evaluateCondition | 609/640 | Loop 条件求值 |

| _getStaffContext | 670 | 员工上下文 |

| _detectLocalServicesAsync | 170 | 检测本地服务（Ollama/MTClaw） |

| _callMTClaw | 366 | 调 MTClaw |

配套文件：

| 文件 | 职责 |

|---|---|

| index.js (226 行) | 入口，导出 LiteScheduler |

| staff-registry.js | 从 YAML Profile 加载员工定义（支持 GBK 解码、禁用过滤） |

| staff-router.js (520 行) | 共享路由模块 — 统一关键词匹配 / 参数提取 / Banner 元数据，被 AiWorkbench(前端) / feishu-router / DigitalStaff 详情页三端共用 |

| task-queue.js | SQLite 队列 |

| collaboration-chain.js | 链式协作（onComplete 触发下游员工） |

| feishu-router.js | 飞书渠道路由 |

| health-self-heal.js | 自愈 |

| workers/ | 20 个 Worker 实现（见下表） |

| profiles/ | YAML 员工定义（local/asset-catalog/automation-presets/health-check/mtclaw-tools/valuation） |

20 个 Worker（server/boss-scheduler/workers/）：

| Worker 文件 | 对应员工 ID | 职责 |

|---|---|---|

| data-clerk.js | DS-BOSS-001 | 数据书记员 — 同步 SCSAI 对象到本地缓存 |

| system-health.js | DS-BOSS-002 | 系统运维师 — 巡检 DB/SCSAI/模板/规则一致性 |

| procurement.js | DS-PROC-001 | 采购助手 — 询价/比价/下单全流程 |

| content.js | DS-CONTENT-001 | 内容生成师 — 公众号文章/排版/去AI味/发布 |

| SCSAI-creator.js | DS-SCSAI-001 | SCSAI工程师 — 创建业务对象 |

| cost-optimizer.js | DS-COST-001 | 成本优化师 — BOM 成本分析 |

| data-caretaker.js | DS-OPS-001 | 数据管家 — 清理/归档/监控 |

| report-analyst.js | DS-REPORT-001 | 报告分析师 — 可视化报告 + 邮件 |

| report-i18n.js | — | 报告 i18n |

| vendor-review.js | DS-VEN-001 | 供应商管家 — 绩效评审 |

| ecr-worker.js | DS-ECR-001 | ECR审核员 — 变更审核 |

| process-worker.js | DS-PROCESS-OPT-001 | 工艺优化 — 16 步工作流 |

| biz-analyst.js | DS-BIZ-001 | 经营大脑 — 老板日报 |

| stock-manager.js | DS-STOCK-001 | 库存管家 — 水位巡检 |

| doc-worker.js | DS-DOC-001 | 文档数字员工 — 生成/问答 |

| mkt-worker.js | — | 营销 |

| pm-worker.js | — | 项目管理 |

| equip-worker.js | — | 设备 |

| auto-loop-worker.js | DS-AUTO-LOOP-001 | 闭环引擎 — 内容链路/分享/自进化 |

| system-health.js | — | 系统健康 |

3.3 L1 能力层 — server/core/capability-runtime.js (2012 行)

CapabilityRuntime 类，包装六基础能力为统一接口，规则引擎优先 → LLM 降级。

核心能力方法（10 个）：

| 方法 | 行 | 能力 | 说明 |

|---|---|---|---|

| identify(context, options) | 872 | 识别 | 查询/识别对象类型与属性 |

| validate(context, options) | 835 | 校验 | 审核一致性 |

| repair(context, options) | 952 | 修复 | 修复数据质量问题 |

| optimize(context, options) | 1126 | 优化 | 优化工艺参数 |

| compare(context, options) | 1212 | 比对 | BOM/供应商差异比对 |

| generate(context, options) | 1276 | 生成 | 内容/文档生成 |

| inspect(context, options) | 1660 | 体检 | 五维健康评分 |

| import(context, options) | 187 | 导入 | EXCEL/CSV/JSON/XML 导入 |

| valuate(context, options) | 580 | 估值 | 成本/收益/市场三阶段估值 |

| collect(context, options) | 732 | 采集 | 多源数据采集 |

统计计数器：ruleEngineHits / llmWorkerHits / llmSolverHits / totalCalls / byCapability — 用于评估规则引擎命中率。

配套核心模块（server/core/，50+ 个）：

  • rule-engine.js / rule-engine-core.js / rule-evolution.js / rule-simulator.js / rule-workbench-service.js / rule-intent-interpreter.js — 规则引擎全家桶
  • unified-asset-service.js — 统一数据资产服务（核心，dashboard API）
  • unified-schema.js / unified-validator.js — Schema/校验
  • capability-dispatcher.js — 能力分发
  • relationship-capability.js / relationship-checklist.js / relationship-resolver.js — 关系解析
  • health-inspector.js / health-patrol.js / health-scanner.js — 健康体检
  • asset-valuator.js / asset-catalog-service.js — 估值/编目
  • object-importer.js / object-modeler.js — 对象导入/建模
  • document-generator.js / docs-converter.js / doc-chat-service.js — 文档
  • content-engine.js / content-publisher.js / content-audit-engine.js / content-asset-manager.js / content-calendar-manager.js — 内容引擎
  • marketing-service.js / marketing-loop-engine.js — 营销
  • auto-loop-service.js / automation-service.js — 自动闭环
  • workflow-executor.js / workflow-to-schema.js — 工作流
  • intent-engine.js / intent-classifier.js / smart-intent-recognizer.js / rule-intent-interpreter.js — 意图识别
  • correction-learner.js / evolution-engine.js — 自进化
  • knowledge-indexer.js / knowledge-search.js / domain-knowledge-extractor.js / product-knowledge-integrator.js — 知识
  • llm-process-generator.js / llm-process-exporter.js / llm-process-knowledge.js / llm-process-store.js — LLM 工艺
  • phosphorus-asset-service.js / phosphorus-kb-builder.js — 磷化工 Demo
  • bom-demo-builder.js / bom-process-linker.js — BOM
  • process-spec-generator.js / SCSAI-process-sync.js / SCSAI-rule-sync.js — 工艺规程
  • change-chain-engine.js — 变更链
  • share-service.js — 分享
  • tenant-content-adapter.js / user-asset-service.js / platform-service.js — 租户/用户/平台
  • prompt-template-manager.js — Prompt 模板
  • scirot-rules-bridge.js — SCIOT 规则桥
  • staff-capability-portrait.js / staff-domain-mapper.js — 员工能力画像
  • industrial-data-asset-overview.js — 工业数据资产总览
  • context-injector.js / data-collection-service.js / data-service-api.js / execution-to-content.js / alignment-engine.js / ai-reasoning-visualizer.js / behavior-service.js / generation-task-manager.js / enterprise-rules.js — 各类辅助

四、YAML Profile 员工全表（server/boss-scheduler/profiles/local.yaml）

local.yaml 定义了 30+ 个员工，按类别分组：

4.1 IT/数据底座类

ID名称cronworkercapabilityllm
DS-BOSS-001小智-数据书记员0 /2data-clerkidentifyfalse
DS-BOSS-002小智-系统运维师0 /3system-healthidentifyfalse
DS-IMPORT-001小智-数据导入员0 /10—importtrue
DS-OPS-001小智-数据管家0 2 *data-caretakeridentifyfalse
DS-COLLECT-001小智-数据采集员0 /4—collectfalse
DS-IDENTIFY-001小智-资产识别员——identifytrue

4.2 采购/供应链类

ID名称cronworkercapabilityllm
DS-PROC-001小智-采购助手—procurementcreatetrue（MTClaw）
DS-VEN-001小智-供应商管家0 /2vendor-reviewinspectfalse（MTClaw）
DS-COST-001小智-成本优化师—cost-optimizercomparetrue
DS-STOCK-001小智-库存管家0 /2stock-manageridentifyfalse
DS-SUPPLY-001小智-供应链管家0 /4—pipelinetrue

4.3 工程/工艺/变更类

ID名称cronworkercapabilityllm
DS-SCSAI-001小智-SCSAI工程师—SCSAI-creatorcreatetrue
DS-ECR-001小智-ECR审核员0 /4ecr-workervalidatetrue
DS-PROCESS-OPT-001小智-工艺优化0 9 1-5process-optimizeroptimizetrue（16步工作流）
DS-ECO-001小智-变更分析师——comparetrue
DS-PLM-BRAIN-001小智-PLM文档大脑——analyzetrue

4.4 质量/估值类

ID名称cronworkercapabilityllm
DS-REVIEW-001小智-文档校验员0 /6—validatefalse
DS-INSPECT-001小智-数据巡检员0 8 1—inspecttrue
DS-REPAIR-001小智-数据修复员——repairtrue
DS-VALUATION-001小智-数据估值师——valuatetrue

4.5 经营/报告/文档/内容类

ID名称cronworkercapabilityllm
DS-BIZ-001小智-经营大脑0 8 *biz-analystidentifytrue（Pipeline+协作）
DS-REPORT-001小智-报告分析师0 8 1report-analystgeneratetrue
DS-DOC-001小智-文档数字员工0 /4docgeneratetrue
DS-CONTENT-001小智-内容生成师—contentgeneratetrue
DS-AUTO-LOOP-001小智-闭环引擎0 /4auto-loopgeneratetrue（Loop）

4.6 芯片设计类（ChipWise，6 个）

ID名称capability说明
DS-CHIP-001芯智识别师chip_identifyRISC-V 规格识别
DS-CHIP-002芯智创建师chip_createRTL 代码生成
DS-CHIP-003芯智修复师chip_repairVerilog 修复
DS-CHIP-004芯智比对师chip_compareRTL 版本比对
DS-CHIP-005芯智优化师chip_optimizePPA 优化
DS-CHIP-006芯智生成师chip_generate文档+测试生成
DS-CHIP-007芯智端侧师chip_edgeRISC-V 开发板部署

4.7 通用办公类（7 个）

ID名称capability说明
DS-KNOWLEDGE-001小智-知识库助手knowledge_rag本地向量检索
DS-WORKFLOW-001小智-工作流助手workflow_automation日程/待办/邮件
DS-ANALYTICS-001小智-数据分析助手data_analyticsNL→SQL/Pandas
DS-HEALTH-001小智-健康顾问health_advisor健康追踪
DS-VISION-001小智-视觉分析助手vision_analysisOCR/图片理解
DS-WRITER-001小智-写作助手writing_assistant润色/翻译
DS-NEWS-001小智-资讯助手news_digest行业资讯订阅

4.8 Loop Engineering 模式（4 个示例）

| ID | 名称 | 模式 | 说明 |

|---|---|---|---|

| DS-PROC-LOOP-001 | 小智-价格监控员 | 监控型 | 涨价超5%触发重新询价 |

| DS-BOSS-LOOP-001 | 小智-目标追踪员 | 目标驱动型（/goal） | 月度销售100万追踪 |

| DS-VEN-LOOP-001 | 小智-数据修复员 | 自修复型 | 供应商缺失字段自动补全 |

| DS-STOCK-LOOP-001 | 小智-库存预警员 | 监控型 | 低库存自动生成采购申请 |

Loop Engineering 三模式：

  1. 监控型 — cron + condition → action pipeline
  2. 目标驱动型（goal）— verification_condition + interval + on_success/on_failure
  3. 自修复型 — action pipeline（identify→repair→validate）+ max_iterations + retry_delay

五、server.js 路由总表（5269 行，handleRequest 在 1372-5008）

5.1 数字员工 API（/api/digital-staff/*，40+ 端点）

运行控制：

  • GET /api/digital-staff/run — 手动触发单个员工
  • POST /api/digital-staff/run — 同上
  • POST /api/digital-staff/run-internal — 内部触发
  • POST /api/digital-staff/start / stop / toggle — 启停
  • POST /api/digital-staff/reload — 重载配置

状态/监控：

  • GET /api/digital-staff/status — 状态
  • GET /api/digital-staff/health — 健康
  • GET /api/digital-staff/dashboard — 仪表盘
  • GET /api/digital-staff/runs / run-detail — 运行记录
  • GET /api/digital-staff/logs / POST /logs/delete — 日志
  • GET /api/digital-staff/logs/stream — SSE 实时日志流（registerSSEClient）

确认/恢复（人机协作）：

  • GET /api/digital-staff/pending-confirms — 待确认列表
  • POST /api/digital-staff/confirm — 确认决策（ConfirmNeededError 暂停后恢复）
  • GET/POST /api/digital-staff/resume — 恢复执行

配置 CRUD（server/routes/digital-staff-routes.js）：

  • GET /api/digital-staff/list / /:id — 列表/详情
  • POST /api/digital-staff — 创建
  • PUT /api/digital-staff/:id — 更新
  • DELETE /api/digital-staff/:id — 删除
  • POST /api/digital-staff/:id/enable — 启用
  • GET /api/digital-staff/:id/rules-prompts — 规则和提示词
  • GET/POST /api/digital-staff/config — 配置读写
  • GET /api/digital-staff/llm-config — LLM 配置

任务管理：

  • GET /api/digital-staff/tasks / /:id — 任务列表/详情
  • POST /api/digital-staff/tasks — 创建任务
  • GET /api/digital-staff/task-stats — 任务统计

Loop/Goal：

  • GET /api/digital-staff/loops / /:id — Loop 列表/详情
  • POST /api/digital-staff/loops — 创建 Loop
  • PUT/DELETE /api/digital-staff/loops/:id — 更新/删除
  • GET /api/digital-staff/goals / /:id — Goal 状态
  • POST /api/digital-staff/goals/:id/reset — 重置 Goal

匹配/导入导出：

  • POST /api/digital-staff/match — 关键词匹配员工
  • GET /api/digital-staff/import/formats / POST /import — 导入
  • POST /api/digital-staff/export / GET /export/formats — 导出

MTClaw/Router：

  • GET /api/digital-staff/mtclaw/stats / POST /mtclaw/test — MTClaw 统计/测试
  • GET /api/digital-staff/router/stats / POST /router/test — LLM Router 统计/测试

5.2 业务 API（按 server.js 出现顺序）

| 前缀 | 说明 |

|---|---|

| /api/bom/* | BOM 管理（version/import/search/config/cron/object-graph/generate-nested/save-nested）— 693 行 handleBomApi |

| /api/audit/* | 审计日志 |

| /api/vendor/ / /api/vendor-part/ | 供应商 |

| /api/customer/* | 客户 |

| /api/change/stats | 变更统计 |

| /api/messages/stream | SSE 消息流 |

| /api/miniapp/gst/* | 小程序 GST（商品/订单/支付/课程/主播等 10+ 子路径） |

| /api/wechat/* | 微信渠道 |

| /api/auth/ /api/admin/enterprises /api/enterprise/ | 认证/企业 |

| /api/ai/agent/ /api/ai-agent/ | AI Agent |

| /api/asr/recognize | 语音识别 |

| /api/content/* | 内容数字员工 API |

| /api/employee/* | 员工 |

| /api/unified/* | 统一资产（数据资产平台核心） |

| /api/object-modeler/* | 对象建模 |

| /api/tenant/quota | 租户配额 |

| /api/sciot/parts | SCIOT 零件 |

| /api/dashboard/* | 仪表盘（asset-overview / today-governance） |

| /api/SCSAI/query | SCSAI 查询（SOAP 代理） |

| /api/unified-assets/* | 数据资产看板（dashboard / list / :id / relation-graph）— workbuddy 代理的就是这套 |

注意：部分路由已迁移到 app/router.js（boss/dispatch/feishu/workbuddy/coze），server.js 留了注释标记 MIGRATED。

六、前端路由（src/router/index.js，60+ 页面）

数字员工相关页面：

| 路径 | 组件 | 说明 |

|---|---|---|

| /digital-staff | DigitalStaff.vue（3261行） | 数字员工管理台 |

| /ai-workbench | AiWorkbench.vue（3259行） | AI 工作台（对话触发员工） |

| /staff-capabilities | StaffCapabilities.vue | 员工能力画像 |

| /staff-customizer | — | 员工定制 |

| /content-center | ContentCenter.vue | 内容中心 |

| /document-intelligence | DocumentIntelligence.vue | 文档智能 |

| /llm-config | LLMConfig.vue | LLM 配置 |

业务页面：dashboard / product-list / private-library / bom-assistant / change-management / vendor-management / customer-management / order-management / project-management / document-center / file-business / quality-management / inventory-management / workflow-management / modeling-center / itemtype-management / system-objects / data-collection / rules-templates / feishu-config / system-log / inspection-history / 等

特色页面：ChipWiseEngine（芯片设计）/ PlmDocBrain（PLM 文档大脑）/ ProcessOptimization / ProcessSpecStudio / PpsTechFileBrowser / PpsExtractPanel / CrossIndustryValidation / DataMarketplace / DataRelationGraph / IndustrialAssetOverview / CustomizationCenter / CustomObjectBuilder / RuleCustomizer / PromptCustomizer

七、关键配置

7.1 环境变量（.env.example）

服务器：PORT=3006 JWT_SECRET AUTH_SECRET

数据库：DB_BACKEND=sqlite|mysql DATABASE_PATH DB_MYSQLDB_*

SCSAI PLM：SCSAI_SERVER SCSAI_DATABASE SCSAI_USERNAME SCSAI_PASSWORD SCSAI_AUTH_TYPE

LLM：

  • 主链：LLM_API_KEY LLM_ENDPOINT LLM_MODEL LLM_PROVIDER
  • DeepSeek：DEEPSEEK_*
  • Ollama 本地：OLLAMA_ENDPOINT=http://localhost:11434 OLLAMA_MODEL=gemma3:4b
  • Worker（小模型）：LLM_WORKER_ENDPOINT/MODEL/API_KEY
  • Solver（大模型）：LLM_SOLVER_ENDPOINT/MODEL/API_KEY

邮件：SMTP_HOST/PORT/SECURE/USER/PASS/FROM

7.2 YAML features 配置（local.yaml 底部）

MTClaw 加速：

  • base_url: http://127.0.0.1:18790/v1
  • completion_mode: permissive
  • 40+ high_frequency_actions（db_query/identify/inspect/compare/repair/validate/procurement_assistant/...）
  • disabled_actions：parse_email/understand_intent/generate_text/complex_reasoning

LLM Router：

  • Worker：gemma3:4b（Ollama，5s 超时）
  • Solver：deepseek-chat（30s 超时，temp 0.7，max_tokens 2000）
  • default_to_solver: true（保守策略）
  • task_rules：simple_types（db_query/calc/validate/render/send/notify/check/list/get/find）vs complex_types（analyze/plan/create/generate/reason/understand）
  • simple_patterns / complex_patterns：正则匹配
  • chain：mtclaw(disabled) / ollama(enabled) / deepseek(enabled)
  • circuit_breaker：5 failures → open，60s recovery
  • retry：3 attempts，exponential backoff，jitter
  • cache：1000 size，60s TTL

八、与 workbuddy-claw-wechat-publisher 的对接关系

workbuddy (8088)                          bossagents (3006)
┌─────────────────────────┐               ┌─────────────────────────────────┐
│ handleBossagentsProxy   │ ──fetch──→    │ /api/unified-assets/*           │
│ /api/bossagents-proxy   │               │ /api/aml/unified/schema/:type   │
│   ?type=Part            │               │   （BossAgents 真活端点）         │
│   ?endpoint=/api/...    │               │                                 │
└─────────────────────────┘               │ 挂了 → workbuddy 降级 mock 真数据 │
                                          │                                 │
│ handleDemoCapabilityApi │               │ CapabilityRuntime 六大能力       │
│ /api/demo/capability    │ ←─内嵌AI演示─ │ （不调 bossagents，直接调 AI）   │
│ （identify/create/...） │               │                                 │
└─────────────────────────┘               │                                 │
                                          │                                 │
│ handleDemoMarketingApi  │               │                                 │
│ /api/demo/marketing     │ ←─内嵌AI演示─ │                                 │
│ （4平台营销内容）        │               │                                 │
└─────────────────────────┘               └─────────────────────────────────┘

对接点只有 1 个：/api/bossagents-proxy → ylxt.chat，10 秒超时。

BossAgents 的真活端点（被 workbuddy 演示页调用）：

  • /api/aml/unified/schema/Part — 识别能力（Schema API，唯一活端点）
  • /api/unified-assets/value/total — 资产价值
  • /api/unified-assets/dashboard — 关系网络/流程追溯
  • /api/unified-assets/quality/issues — 质量体检
  • /api/unified-assets/ai-insight — AI 洞察
  • /api/unified-assets/external-stats — 数字员工协同

未活的端点（workbuddy 降级展示）：bossagents 后端没跑或 500 时，workbuddy 前端显示 mock 真数据 + "⚠ BOSSAGENTS API 未活，降级真数据展示" 提示。

九、最近改动主线（最近 20 个 commit）

583bda87 最新提交同步
bb663674 feat(软著): 7份各生成三件套（登记申请表+说明书PDF+源码PDF）
6662cdec feat(软著): sc3/sc5 源码补足至60页，7份统一60页
df522fee feat: gst-health Node直连云诊平台，移除Java代理层
5f8b9171 fix(软著): 源码超60页裁切为前30+后30共60页
ccf93004 docs(软著): 7份说明书全面扩充至>=30页
56e3ee2f feat(软著): 主文件夹补入 bossagents 主平台软著(sc1)，共7份
f516d130 feat(aml): 构建AML工业数据资产管理体系，101万+数据资产落地
2fe84d69 feat(软著): 新增软著材料生成脚本
d0b633b1 fix(postbuild): 扩展内联覆盖 store/composables/config
e517c43f fix(miniapp): 修复云开发初始化报错和生命周期钩子导入错误
953686ce docs: HICOOL MTClaw策划方案优化 + 测试框架完善
b89cf8fe feat: MTClaw Ollama本地模型调度 + 测试框架优化
17b1e53a feat: MTClaw API Key空值处理 + 商汤SenseNova配置优化
6457fb32 fix: 修复数字员工配置问题
f33f3680 docs: 数字员工全面测试报告 - 34个员工100%通过
0b2808ea 小程序优化
7628fed8 优化

主轴：软著材料准备（7份）+ MTClaw 加速 + 数字员工测试报告（34个员工100%通过）+ AML 资产管理。最近一周重心在 软著申请材料 和 小程序优化。

十、潜在坑与注意事项

  1. server.js 5269 行单文件，3637 行的 handleRequest 巨函数，71+ 个路由分支全挤一起 —— 比 workbuddy 的 cms-server.cjs 还离谱，扩展极痛苦。
  2. digital-staff/index.js（2712行）和 boss-scheduler/lite-scheduler.js（2323行）双调度器，loader.js 已统一指向 lite-scheduler，但旧 index.js 仍保留"兼容引用"，代码债。
  3. YAML 关键词库重复：staff-router.js 的 STAFF_KEYWORDS 和 local.yaml 各员工 keywords 字段两套关键词，改一个不改另一个会失配。
  4. MTClaw 端口 18790 与 Ollama 11434 双本地模型，配置在 YAML 和 env 两处，env 优先但 YAML 可覆盖 —— 容易混乱。
  5. _evaluateCondition 用 eval 执行 YAML 里的 condition 字符串 —— 安全风险，YAML 被篡改即 RCE。
  6. 数据库密码硬编码：docs-to-cms-pipeline.js（在 workbuddy 那边）硬编码 alibaba，指向 bossagents 同一台机器的 DB，秘密外泄。
  7. 软著材料 7 份（最近提交）— 如果要发布或公开仓库，注意软著源码材料里可能含敏感配置。
  8. 34个员工100%通过（f33f3680）的测试报告 —— 但 local.yaml 里只有 30+ 个员工定义，34 vs 30+ 的差额要核对（可能含 Loop 员工）。
  9. SSE /api/digital-staff/logs/stream 必须用 server/digital-staff/index.js 的 registerSSEClient（和 staffLog 同模块），跨模块会丢日志。
  10. _runCapabilityPath 调 CapabilityRuntime，但 CapabilityRuntime 的 10 个能力方法里 import/valuate/collect/inspect 不在"六大能力"叙事里 —— 改叙事或改代码要同步。

附：关键运行命令

# 后端（3006）
node server.js
npm run dev            # 等价

# 前端开发（5173）
npm run dev:vite

# 构建
npm run build          # vite build
npm run preview

# 测试
npm test               # jest --coverage
npm run test:watch
npm run test:integration
npm run test:frontend  # vitest run

# Lint
npm run lint
npm run lint:fix

# 数据资产看板验证
curl https://ylxt.chat/api/unified-assets/dashboard
curl https://ylxt.chat/api/unified-assets/list?asset_type=process_spec
curl "https://ylxt.chat/api/unified-assets/spec_pps0005290Bs2pbsl/relation-graph?depth=2"

# 数字员工手动触发
curl https://ylxt.chat/api/digital-staff/run?staffId=DS-BOSS-002

# 切换 Profile
BOSS_SCHEDULER_PROFILE=./server/boss-scheduler/profiles/valuation.yaml node server.js

附：与 workbuddy 的能力对照

| 维度 | workbuddy-claw-wechat-publisher | bossagents |

|---|---|---|

| 定位 | 内容数字员工（嘴+门面） | 全栈数字员工平台（大脑+脊柱） |

| 端口 | 8088 | 3006 |

| 主语言 | Node.js（cjs） | Node.js + Vue3 |

| 员工数 | 11（叙事）/ 3（真跑） | 34（测试通过）/ 30+（YAML 定义） |

| 员工定义 | cms-server.cjs 内联 handler | YAML Profile + Worker 模块 |

| 调度 | node-cron 简单定时 | LiteScheduler（cron+互斥+队列+Loop/Goal/Pipeline） |

| 能力 | 直接调 AI（callAI 多路容错） | CapabilityRuntime（规则引擎优先→LLM降级） |

| LLM | 多 provider JSON 配置（实时读） | LLMBrain + LLMRouter（Worker/Solver 分工） |

| 数据库 | MySQL（lvbo_type/lvbo_article） | SQLite/MySQL（digital_staff/staff_tasks/...） |

| SCSAI | 无 | 深度集成（SOAP 代理 + AML） |

| 前端 | public/ 静态 HTML | Vue3 60+ 页面 |

| 小程序 | 无 | bossagents-miniapp/ |

| 软著 | 无 | 7 份申请中 |

← 返回案例列表
分享：
🤖 Try Now →
🤖
🎁