公众号创作工坊

立项背景：公众号内容创作依赖人工写稿和反复修改，效率低、质量不稳定。本项目旨在打造一个本地运行的"微信公众号多智能体创作工作台"，通过多个 AI 智能体协作，实现从选题素材到成品文章的自动化生产，让运营者只需提供主题或链接，即可获得可直接粘贴进公众号编辑器的高质量成稿。

核心功能模块：（1）多智能体协作编排——Main 智能体负责任务分发与交付，Writer 智能体负责撰稿，Publisher 智能体扮演主编，按 9 个维度百分制打分（90 分合格，含一票否决项），不合格自动打回重写，最多迭代 6 轮；（2）素材自动抓取——支持 GitHub 开源项目、网页链接、纯文字素材三种任务模式，自动抓取并清洗正文注入写作上下文；（3）"反思"经验库——审稿中发现的问题自动归档并按出现次数升级关注等级（L1→L4），升满后自动转为一票否决红线，使审核标准随使用不断进化；（4）配套能力——任务管理与持久化、可插拔写作技能（如爆款标题公式）、在线文件浏览编辑、模型与密钥热切换、token 用量与成本实时统计

业务流程：用户在网页端填写主题/素材与风格要求并提交任务 → 后端自动抓取链接素材 → Main 打包下发 → Writer 写稿 → Publisher 审稿打分 → 未达标则携带修改意见回炉迭代 → 通过后自动落盘生成 Markdown 源文件与内联样式 HTML（适配公众号排版，可直接粘贴发布）→ Main 生成交付说明。全程通过 WebSocket 逐字流式推送各智能体输出，用户可实时旁观、随时补充信息或取消任务。

整体架构与技术栈：前后端分离的本地化单机应用。后端 Node.js + Express 提供 REST API，用 ws 实现 WebSocket 流式推送；前端 React 18 + Vite，配合 react-markdown 渲染与 CodeMirror 在线编辑；无数据库，任务与配置以 JSON 文件持久化，服务重启自动恢复。模型层接入三条通道：Claude CLI 子进程模式（spawn 启动、stream-json 逐行解析）、Anthropic Messages API 直连（自行维护多轮消息与 tool_use 工具循环）、DeepSeek API（Writer 专用），Main/Publisher 可在设置面板按供应商独立热切换。

我负责的模块与结果：独立完成核心编排器 taskRunner（约 600 行，覆盖任务创建、三智能体循环、取消与恢复）、三套智能体提示词体系及"反思"自进化审核机制。上线后已稳定产出成品文章，审核经验库累计沉淀 12 类错误模式；素材抓取成功率通过多源兜底显著提升；单篇文章从人工数小时压缩到十几分钟内自动完成，最多 6 轮自动打磨保证 90 分以上出稿。

难点与解决方案：（1）子进程管理——Windows 下命令行长度限制导致长文本崩溃，改用 stdin 管道喂入；父进程退出遗留孤儿进程，用 tree-kill 强杀进程树并维护存活 PID 集合优雅关闭；（2）长流式生成易被网络抖动掐断，且任务已消耗真实费用不能判死，实现指数退避重试并广播重置事件让前端清空半截消息重新接收；（3）GitHub 国内访问不稳定，设计 API→raw→多镜像→CDN 五级兜底链，并过滤镜像站返回的错误页；（4）API 模式无服务端会话，自行维护含 tool_use 往返的完整消息历史，并设迭代上限防死循环；（5）安全上通过目录白名单与路径穿越校验限制文件读写，Publisher 工具最小权限只开放反思目录。