BossAgents BossAgents

数字员工认知地图 · workbuddy-claw-wechat-publisher

👤 BossAgents 技术团队 📅 2026-07-28 👁️ 阅读 9 👍 点赞 0 ☕ 24 分钟阅读

数字员工认知地图 · workbuddy-claw-wechat-publisher

本文由 BossAgents 文档数字员工自动转化 · 来源：技术文档 · 内容未经修改

数字员工认知地图 · workbuddy-claw-wechat-publisher

> 本文档是对 cms/workbuddy-claw-wechat-publisher 项目的结构化认知梳理，重点聚焦"数字员工"部分。 > 来源：基于对源码（index.js、scripts/cms-server.cjs、scripts/enhanced-engine.js、config/ai-providers.json 等）与最近 git 改动的实际阅读。 > 路径基准：C:\www\wwwroot\cms\workbuddy-claw-wechat-publisher\

---

一、产品定位（关键：名字滞后于能力）

这个插件叫 workbuddy-claw-wechat-publisher，但名字已严重滞后于实际能力。它现在的真实身份是：

> 左帮右臂 · BossAgents — 面向制造业的 AI 驱动企业级 PLM 数字员工平台

不再是"微信发布插件"。演化路径：

微信公众号自动发布器 (v1) → 卡兹克风格写作 (v2) → 增强 markdown 发布 (v3) → 中小企业内容数字员工 (v4) → 内容数字员工平台 v5 + BossAgents 对接 (v5+)

  • SKILL.md 写的是 v5.0
  • package.json 还停在 3.0.0 —— 版本号没同步
  • README.md 第一句"中小企业内容数字员工（原微信发布插件升级版）"也是滞后文案，与首页"让每家制造企业都拥有自己的数字员工 / PLM 平台"的定位已对不上 —— README 和实际产品叙事分裂成了两套话术

    • ---

    二、代码结构（一张图记牢）

    cms/workbuddy-claw-wechat-publisher/ ├─ index.js # CLI 入口（--hotspot/--publish/--diary/--enhanced/--v4） ├─ scripts/ │ ├─ engine.cjs # 引擎门面 → 优先 engine-v3.cjs，降级 enhanced-engine.js │ ├─ enhanced-engine.js # v2 引擎：抓热点→AI写文→发公众号（717行，卡兹克风格核心） │ ├─ cms-server.cjs # ★★★ 2319行 Node CMS 主服务器（8088端口，真正的主角） │ ├─ cms-database.cjs # MySQL 直连（lvbo_article / lvbo_type 表） │ ├─ cms-bridge.cjs # content-pipeline → CMS 入库桥 │ ├─ content-pipeline.cjs # 信源采集主管线 │ ├─ ai-scorer.cjs # 五维评分 + 预筛 │ ├─ content-storage.cjs # JSON/MySQL 双后端存储 │ ├─ multi-platform-publisher.cjs # 微信/文心发布器 │ ├─ content-fission-engine.js # 长文→短视频脚本/图文卡片/金句海报 │ ├─ marketing-pipeline.js # 自营销内容管线 │ ├─ experience-server.js # 体验 API 独立服务器 │ ├─ experience-route.js # /api/experience/ 路由 │ ├─ data-sedimentation.js # 体验脱敏→模式→知识库 │ ├─ docs-to-cms-pipeline.js # 文档→CMS→AI优化→多平台发布 │ ├─ cms-column-generator.js # CMS 栏目生成器 │ ├─ cms-template-generator.js # CMS 模板生成器 │ ├─ collect-product-data.js # 产品平台数据采集 │ ├─ generate-bom.js # BOM 清单生成 │ ├─ publish-xiaohongshu.js # 小红书发布 │ ├─ reddit-video/ # Reddit 短视频管线 │ └─ video-platforms/ # 抖音/YouTube/微博等各平台发布器 ├─ config/ │ ├─ ai-providers.json # ★ 多 provider AI 引擎配置（实时读，改完即生效） │ ├─ user-config.json # 用户配置（公众号 + 产品平台 + 各平台发布） │ └─ example-config.json # 配置模板 ├─ data/ # 内容、栏目、分享、沉淀数据 │ ├─ exports/ # 发布日志、导出文章 │ ├─ shares/ # 分享卡片 │ ├─ sedimentation/ # 体验沉淀（patterns/records/insights） │ └ templates/ # list/page 模板 └─ public/ # 前台静态资源（tpl/）

    真正在生产跑的是 cms-server.cjs，不是 index.js。 index.js 是老 CLI 那套（热点→写作→发公众号），现在主入口是：

    node scripts/cms-server.cjs # 默认 0.0.0.0:8088 node scripts/cms-server.cjs --port 9000 # 指定端口 
    或
     npm run cms

    ---

    三、cms-server.cjs 的核心架构（数字员工的"大脑"）

    1. AI 多路容错引擎（最值钱的部分）

    config/ai-providers.json 配置了多 provider，实时读文件不重启：

    | priority | provider | role | 模型 | 备注 | |---|---|---|---|---| | 1 | sensetime-nova | general | sensenova-6.7-flash-lite | 商汤，262K 上下文，与 BossAgents 一致 | | 2 | deepseek | general | deepseek-chat | 降级备选 | | 3 | tencent-hunyuan | general | hunyuan-turbo | ${HUNYUAN_API_KEY} 待填 | | 2 | tencent-hunyuan-code | code | hunyuan-code | 代码专用 | | 3 | volcengine-ark | code | ark-code-latest | 火山方舟 | | 4 | glm / moonshot | — | — | disabled |

    调用链：

    callAI(prompt, sys, max, temp, role, preferredModel) → 按 role 过滤 → 按 priority 排序 → 依次降级（callProvider） → 全挂才报错

    两个关键容错细节（写代码时别踩坑）：

  • 推理模型识别：/sensenova|reasoner|qwq|deepseek-r1/i → 自动放大 max_tokens 到 ≥8000，并启用 separate_reasoning
  • 推理模型 content 被思维链吃光时，降级返回 reasoning 并加前缀提示，避免前端"处理失败"

    • 2. 路由总表（cms-server.cjs 第 2200-2305 行）

    #### 前台页

    | 路径 | handler | 说明 | |---|---|---| | / | handleHome | 首页：Hero + 六大行业信任锚 + 三大产品线 + 六大原子能力 + 四层架构 + 最新动态 + 客服机器人 | | /list/:typeid | handleList | 列表页 | | /article/:aid | handleArticle | 详情页 | | /admin/columns | handleColumnsAdmin | 栏目管理后台 | | /admin/templates | handleTemplatesAdmin | 模板管理后台 | | /bossagents-demo | handleBossagentsDemo | 能力演示页（六大价值维度 + 六大原子能力 + 11 数字员工 + 6 行业案例） | | /feedback | handleFeedbackPage | 反馈页 | | /tech-docs、/docs | handleTechDocs | 技术文档 |

    #### API（/api/）

    | 路径 | 方法 | handler | 说明 | |---|---|---|---| | /api/bossagents-proxy | GET | handleBossagentsProxy | 代理到本地 ylxt.chat 的 BossAgents 后端，10秒超时，500就降级真数据 | | /api/demo/capability | POST | handleDemoCapabilityApi | 六大能力演示（identify/create/repair/optimize/compare/generate） | | /api/demo/products | GET | handleDemoProductsApi | 从 lvbo_article 取 12 条当产品展示 | | /api/demo/marketing | POST | handleDemoMarketingApi | 营销数字员工：一次生成公众号/CSDN/微博/邮件四平台内容 | | /api/chat | POST | handleChatApi | 客服数字员工 | | /api/publish/wechat | POST | handleWechatPublishApi | 公众号发布（有用户 token 走真 API，否则模拟） | | /api/publish/generate | POST | handleGenerateApi | 文章生成 | | /api/rewrite | POST | handleRewriteApi | AI 改写 | | /api/humanize | POST | handleHumanizeApi | 去 AI 味 | | /api/cms/generate-report | POST | handleGenerateReportApi | AI 分析报告 | | /api/tasks | | handleTasksApi | 定时任务 | | /api/publish/topics | GET | handleTopicsApi | 话题库 | | /api/publish/records | GET | handlePublishRecordsApi | 发布记录 | | /api/column(s)/:id | | handleColumnsApi | 栏目 CRUD | | /api/articles、/api/article/:id | | handleArticlesApi | 文章列表/详情 | | /api/article | POST | handleArticleCreateApi | 创建文章 | | /api/article-content | GET | — | 取文章 JSON（重新发布用） | | /api/docs、/api/docs/convert | | handleDocsListApi/handleDocConvertApi | 文档列表 + 文档→文章转换 | | /api/ai-providers | | handleAIProvidersApi | AI Provider 配置 | | /api/system-config | | handleSystemConfigApi | 系统配置 | | /api/email-config | | handleEmailConfigApi | 邮件配置 | | /api/pref-config | | handlePrefConfigApi | 优化偏好 | | /api/auth/ | | handleAuthApi | 用户认证 | | /api/user/config | | handleUserConfigApi | 用户配置 | | /api/feedback | GET/POST | handleFeedbackApi | 反馈 | | /api/models | GET | handleModelsListApi | 模型列表 |

    3. 数据库（MySQL eastaiai）

    主要表：

  • lvbo_type（栏目树：fid 父级，typeid 主键，drank 排序，ismenu/islink/url）
  • lvbo_article（aid 主键，title/author/content/description/typeid/status/addtime/hits/keywords）
  • user_configs（wechat_appid/wechat_secret/wechat_author 等用户自有公众号配置）

    • 潜在风险点：executeTask 第 919 行 SELECT MAX(aid)+1 作为新 aid，并发下会撞主键 —— 多任务调度时是隐患。handleArticlesApi、handleArticleCreateApi 也可能有同样问题，下次写代码要注意加 UNIQUE 或事务。

    4. 定时任务 executeTask（任务数字员工）

    完整链路：

  • 按 keywords / platform / style / angle / length / model 拼 prompt
  • callAI 生成文章，正则提标题
  • 可选 humanize 去 AI 味（硬规则禁用"首先/综上所述/在当今…时代"等 AI 腔，第二次调 sensenova-6.7-flash-lite 改写）
  • 入库 lvbo_article（typeid=21215，author='WorkBuddy AI'）
  • 若 targets 含 wechat，调微信 draft/add 发草稿箱
  • 写 execution log，更新 lastRun/runCount

    • 调度器：startTaskScheduler（按 task.schedule cron 触发）。

    ---

    四、"数字员工"的具体品种（首页和演示页对外宣称 11 个）

    | 数字员工 | 实现位置 | 状态 | |---|---|---| | 内容数字员工 | executeTask + /api/publish/generate + docs-to-cms-pipeline | ✅ 可跑 | | 营销数字员工 | /api/demo/marketing + marketing-pipeline.js | ✅ 可跑 | | 客服数字员工 | /api/chat（BA_KNOWLEDGE 灌知识） | ✅ 可跑 | | 数据资产员工 | 依赖 BossAgents 后端 schema API | 🟡 代理降级 | | 质量巡检员工 | demo capability repair | 🟡 AI 演示态 | | 工艺规程员工 | demo capability optimize/generate | 🟡 AI 演示态 | | BOM 管理员工 | demo capability compare | 🟡 AI 演示态 | | 变更管控员工 | 无独立实现 | ❌ 仅文案 | | 供应商员工 | 无独立实现 | ❌ 仅文案 | | 成本分析员工 | 无独立实现 | ❌ 仅文案 | | 老板私有智能体 | 飞书/微信小程序入口（前端未在此仓库） | ❌ 仅叙事 |

    结论：在当前仓库里实际能演示的只有 3 个真跑（内容/营销/客服），其余靠 /api/bossagents-proxy 调外部 3006 站口，挂了就降级 mock 真数据展示。这是"叙事领先实现"的典型 —— 改代码时要分清"演示态"和"真能干"。

    ---

    五、最近改动焦点（最近 5 个 commit）

    c83d4e2 fix: 大模型配置与前端下拉同步 + 接入 BossAgents 商汤端点 43f9a26 fix: 模板管理 Windows 路径反斜杠被 JS 转义导致文件不存在 88bdb20 新增: 6大真实案例入库 + 首页6行业信任锚 + 演示页案例板块 230c105 增强: 6大能力演示 + 产品展示中心 + 营销内容工坊 cb05e74 修复: BossAgents 真实数据连接 + 移除 mock 降级 + AI 分析报告 + 客服机器人优化

    主轴就是 BossAgents 对接和首页/演示页叙事升级。接下来要做的事大概率落在这三块之一：

  • 继续把 BossAgents 3006 后端的某个能力接到演示页
  • 首页/演示页叙事再扩（新案例、新数字员工、新行业）
  • cms-server.cjs 里某个 handler 的 bug 或体验优化

    • ---

    六、潜在坑（动手前要记牢）

  • package.json 版本 3.0.0 vs SKILL.md v5.0 不一致，发布 npm 时会误导用户。
  • README.md 的"中小企业内容数字员工"叙事和首页"制造业 PLM 数字员工平台"叙事 分裂 —— 改文案要同步两处。
  • handleBossagentsDemo 第 2002-2005 行有重复代码块（if (key === 'identify') 写了两遍），逻辑能跑但是冗余，可以清理。
  • executeTask 的 MAX(aid)+1 并发不安全。
  • docs-to-cms-pipeline.js 把数据库密码硬编码 alibaba，cms-bridge.cjs 也硬编码 gyCms2024! —— 秘密外泄，应该走环境变量。cms-server.cjs 倒是规规矩矩走 env，但前两个文件没改。
  • config/ai-providers.json 把商汤和 DeepSeek 的真 API key 直接写进来了（sk-zvAKP...、sk-61f7...），只有腾讯用了 ${HUNYUAN_API_KEY} 占位。这是要立刻处理的秘密外泄。
  • cms-server.cjs 2319 行单文件，71 个 handler 全挤一个文件，再继续加功能会很痛苦 —— 可能要考虑拆。

    • ---

    附：关键运行命令

    # 主入口（生产用） node scripts/cms-server.cjs # 0.0.0.0:8088 node scripts/cms-server.cjs --port 9000 # 指定端口 npm run cms # 等价
    老 CLI（卡兹克热点→写作→发布）
     node index.js --hotspot # 查看今日热点 node index.js --publish # 抓热点→卡兹克风格写文章→发布 node index.js --validate # 验证公众号配置 node index.js --diary "标题" "正文" # 发布自定义文章 node index.js --enhanced  [title] # 增强版发布 markdown node index.js --v4 # 启动增强版引擎 v6
    内容主管线
     node scripts/content-pipeline.cjs # 完整流水线（采集→AI评分→精选） node scripts/content-pipeline.cjs weibo-hot # 单源采集 node scripts/ai-scorer.cjs # AI 评分测试
    文档→CMS→AI→多平台
     node scripts/docs-to-cms-pipeline.js --limit 5 --dry-run --skip-optimize --platforms website node scripts/docs-to-cms-pipeline.js --file bom.md --style 公众号 --platforms wechat,zhihu

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