实战经验

⚠️ 本页为社区实战经验汇总，仅作思路参考。企业落地需复核安全边界；涉及自媒体/内容类仅保留工具用法，不含批量运营套路。

来源分类：社区实战经验（个人博主、独立开发者、一线用户在公开技术社区与自媒体上分享的真实使用记录）。 采集口径：仅采集公开可访问的博文、问答、媒体报道；小红书/公众号正文若需登录无法精读，以搜索引擎返回的公开摘要片段为准并已注明。 合规说明：本手册不包含腾讯《WorkBuddy 效率智能体 OPC 从业者认证课程》的视频字幕、课件原文或任何内部分发材料；所有条目均来自第三方公开渠道。 统一标注：以下每条均为「社区玩法，企业落地需复核安全边界」；凡涉及写文件、执行 shell、调用第三方写接口、配置密钥/Token 的操作，均保留「需人工确认」提示。

主要来源 URL 列表

1. 今日头条/人人都是产品经理：http://m.toutiao.com/group/7690836049324458539/
2. 人人都是产品经理《WorkBuddy 新版「资料库」上线，实测惊艳到了》：https://www.woshipm.com/ai/6446112.html
3. 腾讯云开发者社区《我用 WorkBuddy 把「读网」变成了资产》：https://developer.cloud.tencent.com/article/2763625
4. 腾讯云开发者社区《我花了两周把 AI 助手调成了"第二大脑"》：https://developer.cloud.tencent.cn/article/2675890
5. 稀土掘金《我用 WorkBuddy + ima 搭了一套自动知识加工流水线》：https://juejin.cn/post/7651426279837138996
6. 云巴巴《WorkBuddy 外贸怎么落地？Managed Agents 出海 10 个场景先做 4 类》：https://www.yun88.com/news/16108.html
7. 云巴巴《外贸业务员每天跟询盘做报价，WorkBuddy 能省下多少重复劳动？》：https://www.yun88.com/qa/8362.html
8. 腾讯云开发者社区《外贸老兵用 WorkBuddy 跑通"开发信—客户回复—成单"全流程实录》：https://developer.cloud.tencent.cn/article/2719373
9. CSDN《WorkBuddy 教师手册》：https://blog.csdn.net/ngbshzhn/article/details/166088540
10. 云巴巴《教师怎么用 WorkBuddy 减负？备课提效五步方案》：https://www.yun88.com/news/17158.html
11. 腾讯云开发者社区《用 WorkBuddy 从一句话需求做到可交付的固定资产管理系统 v3.4 实战全记录》：https://developer.cloud.tencent.cn/article/2756986
12. 腾讯云开发者社区《用 WorkBuddy 做 SMT 车间设备台账与保养计划》：https://developer.cloud.tencent.com/article/2755893
13. 云巴巴《制造企业办公室怎么用？WorkBuddy 接报表汇总和设备台账两切入》：https://www.yun88.com/news/16798.html
14. 云巴巴《WorkBuddy 设备台账怎么管不乱？巡检、保养、异常三用法》：https://www.yun88.com/news/14365.html
15. 今日头条《workbuddy + obsidian 搭建一套 AI 创作素材库》：http://m.toutiao.com/group/7702076097156792867/
16. 今日头条/人人都是产品经理《workbuddy + miora，下一代高级设计工作台来了》：http://m.toutiao.com/group/7699023150763360768/
17. 腾讯云开发者社区《时尚学院 × AI：一个指令出海报、一个指令存知识库》：https://developer.cloud.tencent.cn/article/2702636
18. 腾讯云开发者社区《WorkBuddy 设计 Skill 详解与鸭血粉丝汤实操案例》：https://developer.cloud.tencent.com/article/2704025
19. 腾讯云开发者社区《用 WorkBuddy 打造小红书 AI 内容自动化工作流》：https://developer.cloud.tencent.com/article/2705043
20. 腾讯云开发者社区《我用 WorkBuddy 从 0 到 1 跑通了 500 条小红书笔记》：https://cloud.tencent.com/developer/article/2723643
21. 人人都是产品经理《WorkBuddy 究竟是怎么火起来的？》：https://www.woshipm.com/ai/6471478.html
22. 腾讯云开发者社区《用 WorkBuddy 搭建微信公众号全自动发布流水线》：https://cloud.tencent.com.cn/developer/article/2752821
23. 人人都是产品经理《实测 WorkBuddy 打通公众号！文章自动进草稿箱！》：https://www.woshipm.com/ai/6448280.html
24. 云巴巴《用 WorkBuddy 给公众号排版：搭一次 skill，每次省 20 分钟》：https://www.yun88.com/news/11621.html
25. 腾讯云开发者社区《我把 WorkBuddy 用成了「自己会干活」的系统：6 个真实踩坑和修法》：https://developer.cloud.tencent.com/article/2765291
26. 腾讯云开发者社区《我在 WorkBuddy 里做定时自动化踩的 6 个坑》：https://developer.cloud.tencent.com/article/2757520
27. 腾讯云开发者社区《我用 WorkBuddy 开发 AI 营销平台的真实经历：3 个让我差点放弃的坑》：https://cloud.tencent.cn/developer/article/2731258
28. 腾讯云开发者社区《WorkBuddy 绑定 GitHub 踩坑实录：从反复「失败重连」到成功授权》：https://cloud.tencent.com/developer/article/2761198
29. 腾讯云开发者社区《避坑大全！WorkBuddy 使用中的 10 个常见问题及解决方法》：https://cloud.tencent.com/developer/article/2669309
30. OSCHINA《WorkBuddy 自定义模型接入失败：从接口、鉴权到协议兼容的完整排查指南》：https://my.oschina.net/u/9487999/blog/19749985
31. 七牛云《WorkBuddy 自定义模型失败怎么办？从接口鉴权到协议兼容的完整排查》：https://news.qiniu.com/archives/1789631952165
32. workbuddy.press《故障排查（401 Unauthorized / 定时任务没执行）》：https://workbuddy.press/docs/troubleshooting
33. 腾讯云开发者社区《把本地 Ollama 模型接进 WorkBuddy 踩过的坑》：https://developer.cloud.tencent.com/article/2736131
34. 京报网《5000 积分只卖 8.88 元？记者调查：WorkBuddy"低价充值"实为"李鬼灰产"》：https://xinwen.bjd.com.cn/content/s6aa0082ee4b0e42f8f000921.html
35. AsiaICT《How Dependable Is WorkBuddy, the AI Assistant, Now Seamlessly Integrated into WeCom?》：https://www.asiaict.com/cloud/21290.html
36. 腾讯云开发者社区《WorkBuddy 自动化实战：3 个场景让每日重复工作"自动跑起来"》：https://cloud.tencent.com.cn/developer/article/2721636
37. 云巴巴《WorkBuddy 怎么设置微信提醒？避开 2 个坑的推送方案》：https://www.yun88.com/news/15818.html
38. 腾讯云开发者社区《把这条流水线交给 Agent 定时跑：WorkBuddy 自动化配置全流程》：https://developer.cloud.tencent.com/article/2771138

---

一、实战分享（社区玩法，企业落地需复核安全边界）

1. 个人知识管理闭环

1.1 WorkBuddy + IMA 管理知识、构建个人第二大脑

• 来源：人人都是产品经理（今日头条转载） http://m.toutiao.com/group/7690836049324458539/
• 内容要点：
  • 博主把爆款文章拆解后沉淀为「可复用的创作方法库」，再让 WorkBuddy 按爆款逻辑对自己新写的文章做体检，"看是否符合这个套路，哪些环节还可以优化"。
  • 强调写作这一步仍然由人工完成，WorkBuddy 只负责"按爆款逻辑分析"，避免 AI 味。
  • 工作流：人工确认选题 → WorkBuddy 拆解写作逻辑 → 沉淀到 Output → 人工按自己语言风格写稿 → 再让 WorkBuddy 对照套路复盘。
• 标注：社区玩法，企业落地需复核安全边界。

1.2 WorkBuddy 新版「资料库」实测

• 来源：人人都是产品经理 https://www.woshipm.com/ai/6446112.html
• 内容要点：
  • 资料库建立之后，关键是"用起来"：所有个人和团队空间文档、本地产物中文档都支持「添加到任务」，在对话框里作为上下文和 AI 协作。
  • 博主示例：把一篇公众号文章链接直接添加到任务并给指令，让 WorkBuddy 基于该链接内容做事。
• 标注：社区玩法，企业落地需复核安全边界。

1.3 用 WorkBuddy 把「读网」变成资产

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2763625
• 内容要点：
  • 作者借助 WorkBuddy、Skill 和知识工作台，让信息"不止停在找到、看过，还能回查、能引用，用久了还能接着改"。
  • 分工："代码和跑任务交给 WorkBuddy、CodeBuddy 做，我负责定方向、看结果、给反馈。"
  • 跑通后做成了一个自己每天在用的桌面应用（涉及本地应用打包，需人工确认）。
• 标注：社区玩法，企业落地需复核安全边界。

1.4 两周把 AI 助手调成"第二大脑"的配置清单

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.cn/article/2675890
• 内容要点：
  • WorkBuddy 的工作记忆分两层：MEMORY.md 存跨 session 长期信息；按日期命名的日志文件（如 2026-05-28.md）记录当天做了什么。
  • 同社区另一篇《首发 WorkBuddy 系统使用教程》补充了记忆维护规则：完成实质性工作后、用户告知偏好时、做出技术决策时才写入；不写临时信息（中间搜索结果、临时文件路径、工具报错）；超过 30 天的日志提炼到 MEMORY.md 后删除。来源：https://cloud.tencent.com/developer/article/2722703
• 标注：社区玩法，企业落地需复核安全边界。

1.5 WorkBuddy + ima 自动知识加工流水线，每天省 2 小时

• 来源：稀土掘金 https://juejin.cn/post/7651426279837138996
• 内容要点：
  • 四步走：收藏一篇微信文章 → 查看 ima 自动摘要 → 用 WorkBuddy 生成报告 → 人工审阅补充。
  • 基础配置：WorkBuddy 需授权访问文件夹（建议先授权 Downloads 和桌面）；ima 创建第一个知识库，建议从个人资料库开始。
  • 建议从"微信文章处理"作为第一个跑通场景，再逐步扩展。
  • （涉及本地文件夹授权，需人工确认授权范围。）
• 标注：社区玩法，企业落地需复核安全边界。

2. 外贸询盘

2.1 外贸老兵跑通"开发信—客户回复—成单"全流程

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.cn/article/2719373
• 内容要点：
  • 六步流程：Excel 客户表 → 生成 200 封个性化开发信 → 回复自动归档 → 自动分类（询盘/拒绝/无效/老客户）→ 真询盘自动起草多语言回复 → 客户下单自动写入成单记录 → 全流程日报推微信。
  • 分类标准：A 真实询盘（提到具体产品、MOQ、价格、货期）；B 拒绝/已读不回；C 无效/垃圾（机器群发、PR 稿）；D 老客户。
  • 作者做法："没有让 AI 写正文，只让它按我给的模板填空——这样语感还是我的，不会有 AI 味。"
  • 真询盘回复要求：英文回（德语/西语询盘对应语言）、阶梯报价（FOB + 3 个 MOQ 档位）、附 catalog、邀请加 WhatsApp；回复存为 .eml 草稿，不直接发。
  • 成单归档：监听本地 订单确认/ 文件夹，新 PDF 进来后提取 PO 号/产品/数量/金额/收货日期，回写 Excel，并微信推送。
• 标注：社区玩法，企业落地需复核安全边界。（批量发信、自动回写客户表属第三方写操作，需人工确认。）

2.2 出海 10 个场景先做 4 类：询盘自动分流

• 来源：云巴巴 https://www.yun88.com/news/16108.html
• 内容要点：
  • 询盘来源分散在 Alibaba、独立站、展会和社交媒体，质量差异大。
  • 系统按询盘内容、客户国家、邮箱域名和历史行为分类：A 类直接进销售流程，B 类转入自动培育，低价值的由 AI 做基础回复。
  • 原文定位："AI 不替代销售，它的任务是让值得（跟的询盘被优先处理）"。
• 标注：社区玩法，企业落地需复核安全边界。

2.3 报价重复劳动的四节点落地

• 来源：云巴巴问答 https://www.yun88.com/qa/8362.html
• 内容要点：
  • WorkBuddy 省时效果按"连邮箱、跑单次报价、固化 Skill、挂定时任务"四个节点落地，每节点有可验收输出物。
  • 节点一连邮箱：桌面客户端左侧「连接器」找到「网易邮箱」连接，跳转授权页登录；"如果授权要求填密码，不要填登录（密码）"（原文被截断，提示走授权而非密码）。
• 标注：社区玩法，企业落地需复核安全边界。（邮箱授权凭据需人工确认。）

3. 教培题库

3.1 WorkBuddy 教师手册：错题集与成绩分析

• 来源：CSDN 博客 https://blog.csdn.net/ngbshzhn/article/details/166088540
• 内容要点：
  • 错题集用法（原文指令示例）："根据上传的答卷 Excel，为初二（3）班每位学生生成个性化错题集 Word，含错题原题、正确答案、解析和复习建议。"
  • 数据分析用法："读取这份成绩 Excel，输出平均分、分段分布、错题率排名和改进建议，生成可交互 HTML 报告。"
• 标注：社区玩法，企业落地需复核安全边界。（学生成绩属个人敏感信息，学校落地需人工确认数据合规。）

3.2 教师备课提效五步：出题模板化 + 错题回流

• 来源：云巴巴 https://www.yun88.com/news/17158.html
• 内容要点：
  • 用指令模板固化出题结构：题型配比、题量、知识点分布、难度梯度写进模板，再按班级学情调整参数，Agent 生成成套初稿，教师审改后定稿。
  • 校本题库同步入库；学生错题按错误类型回流，同一知识点的题目按错误类型沉淀，下次出题直接从沉淀里取。
  • 原文："错题回流的关键是按错误类型归档而（不是只按题目）"。
• 标注：社区玩法，企业落地需复核安全边界。

待补充：面向 K12 的真实教师长篇实战复盘（除上述手册/科普文外，公开渠道暂未检索到更多带完整步骤的个人教师博客）。

4. 资产台账

4.1 从一句话需求到可交付的固定资产管理系统 v3.4

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.cn/article/2756986
• 内容要点：
  • 交付物：Windows 安装包（可直接覆盖升级）+ 40 页 PDF 用户手册 + 在线下载页。
  • 功能模块：资产全生命周期、组织架构、存放地点、保管人、RFID 标签、标签打印、折旧、盘点、报表、借用、维修、维保、RBAC 权限、操作日志与撤销、数据库备份恢复。
  • 阶段纪律：先让 WorkBuddy 基于 PRD 输出 docs/ARCHITECTURE.md（技术选型、12 张表建表 SQL、50+ 后端 API、22 个前端路由、共享约定），"这一步千万别跳过"，后续迭代靠它省对齐成本。
  • 编码分 5 个串行任务：基础设施 → 数据库与迁移 → 后端 API → 前端页面 → 批量导入导出，每个任务单独一轮对话，避免上下文污染。
  • 迭代案例：标签打印被裁剪（缩放系数只看宽度 → 改宽高联合降档）；数据库"分类备份 + 恢复不出 bug"（恢复分 replace/merge 两种，ID 冲突跳过、绝不重分配 ID；失败回滚不落盘）；操作日志 + 管理员撤销（撤销前做"数据已被后续修改"校验，不一致返回 409；撤销必须填 ≥5 字说明）。
• 标注：社区玩法，企业落地需复核安全边界。（涉及 RBAC、许可证、打包私钥 private.pem，需人工确认密钥与权限边界。）

4.2 SMT 车间设备台账与保养计划：三张表

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2755893
• 内容要点：
  • 关键决策：把"设备编号"作为唯一主键，统一编号规则如 SMT-印刷机-01，后面所有表靠这个字段挂接；作者称"这一点在后面的实测里救了我一次"。
  • 从零自动生成三张表（设备台账、保养计划、巡检记录），附完整步骤。
• 标注：社区玩法，企业落地需复核安全边界。

4.3 制造企业办公室：报表汇总 + 设备台账两切入

• 来源：云巴巴 https://www.yun88.com/news/16798.html
• 内容要点：
  • 台账整理：三份表按统一编号合成一台账，新购、调拨、维修、报废四类状态各占一列；状态冲突的行标黄待查；产物以 Excel 落盘，设备科与资产口共用底表。
  • 月度盘点前先拿标黄行集中议一遍，议定口径回写进编号映射规则，"台账的规则库随盘点一轮轮累积，对账的争议只会越来越少"。
• 标注：社区玩法，企业落地需复核安全边界。

4.4 设备台账三用法：巡检、保养、异常

• 来源：云巴巴 https://www.yun88.com/news/14365.html
• 内容要点：
  • 三条通道：巡检记录电子化流转、保养提醒按周期自动排、异常上报走结构化通道。
  • 原文定位："台账从一本死账变成一条活流。活起来的账，才算真正在管设备。"
• 标注：社区玩法，企业落地需复核安全边界。

5. 设计师素材管理

5.1 WorkBuddy + Obsidian 搭 AI 创作素材库

• 来源：今日头条 http://m.toutiao.com/group/7702076097156792867/
• 内容要点：
  • 三段式：WorkBuddy 调度内容（通过账号关联 + 连接器，围绕具体任务检索不同应用中有权限访问的资料）；Obsidian 搭建个人知识库。
  • Obsidian 里沉淀"经过整理、有长期保留价值"的内容：个人观点、用户问题、真实案例、方法经验。
• 标注：社区玩法，企业落地需复核安全边界。

5.2 WorkBuddy + miora 设计工作台（附 3 个开源 Skill）

• 来源：今日头条/人人都是产品经理 http://m.toutiao.com/group/7699023150763360768/
• 内容要点：
  • 在对话里说需求，WB 调 miora 生图、生视频，生成结果一件件加到同一张 miora 画布上，"不用再费劲巴拉找文件夹"。
  • 作者开源了 3 个把审美和流程写进 Skill 的玩法，示例包括"万圣节海报高级配色 skill"。
• 标注：社区玩法，企业落地需复核安全边界。

5.3 时尚学院教学：一个指令出海报、一个指令存知识库

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.cn/article/2702636
• 内容要点：
  • WorkBuddy 通过已信任的 lexiang 连接器自动定位「夏老师个人知识库」。
  • 不是简单丢一段文本，而是生成包含 7 大章节的完整 Markdown：设计概述、色彩方案、字体层级、视觉层级、四阶段路径详情、设计元素清单、落地计划。
• 标注：社区玩法，企业落地需复核安全边界。

5.4 设计 Skill 图谱（ClawHub / 官方来源）

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2704025
• 内容要点：
  • 社区整理的 Skill 表（原文表格摘录）：design-assets（图标批量工厂，APP 图标、网页图标、SVG 矢量图一站式处理，来源 ClawHub 社区）；theme-factory（10 套成熟专业主题：极简/复古/清新等，一键切换并同步匹配字体，标注来源 Anthropic 官方）。
• 标注：社区玩法，企业落地需复核安全边界。（第三方 Skill 来源需审计，需人工确认。）

6. 小红书 / 自媒体内容

6.1 从 0 到 1 跑通 500 条小红书笔记

• 来源：腾讯云开发者社区 https://cloud.tencent.com/developer/article/2723643
• 内容要点：
  • 作者称自己曾在朋友圈分享"利用 WorkBuddy 一天内产出 300 条小红书笔记"，本文为该方法的全流程拆解。
  • 文章定位为保姆级教程，覆盖从选题到批量产出的完整链路。
• 标注：社区玩法，企业落地需复核安全边界。（批量产出内容需注意平台规则与原创性，需人工确认。）

6.2 小红书 AI 内容自动化工作流：从灵感到发布

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2705043
• 内容要点：
  • 作者定位："把「想」的部分留给自己，「做」的部分全部交给 WorkBuddy。"
  • 选题策划示例指令："帮我分析最近小红书 AI 表情包赛道的热门内容，给我 5 个明天可以发的选题，每个配一段（文案）"。
• 标注：社区玩法，企业落地需复核安全边界。

6.3 WorkBuddy 怎么火起来的：小红书 183 篇帖子标题观察

• 来源：人人都是产品经理 https://www.woshipm.com/ai/6471478.html
• 内容要点：
  • 作者抓取小红书上标题带「AI 工作台」的 183 篇高热度帖子，发现近一半在标题里写明了"给谁做、做什么用"。
  • 标题里出现的身份和用途有三十多种：班主任、化学老师、辅导员、HR、律师、外贸人、产品经理、考公和考研的人、四年级孩子、上小班（的家长）等。
• 标注：社区玩法，企业落地需复核安全边界。

7. 微信公众号

7.1 公众号全自动发布流水线（附踩坑记录）

• 来源：腾讯云开发者社区 https://cloud.tencent.com.cn/developer/article/2752821
• 内容要点：
  • 三条互相独立的定时任务：每日 09:30（扫本地「创作文稿」文件夹，取 1 篇 → 纠错润色 → 内联样式 HTML 排版 → AI 配图裁水印 → 推草稿箱 → 汇报库存）；每周日 09:30（扫 E 盘「学习研究」，新增资料上传云端知识库）；每月 30 日 09:30（各平台后台导出数据汇总成 HTML 看板）。
  • 目录结构：wechat_mp/ 下 config.json（AppID + AppSecret）、publish.py（取 token → 正文图传图床 → 封面传永久素材 → draft/add）、articles/、images/、processed.json（已推送台账防重复）。
  • 大文件处理：48 个文件里两个 PPTX 超单文件 100MB 上限，WorkBuddy 方案是把 PPTX 当 zip 拆开、对 5–9MB 高清图降采样（最长边 2000px、JPEG 质量 80）后重新打包，142MB 压到 17MB。
  • 实测：从读到 Word 到草稿箱出现成品全程 5 分钟以内，接口推送只要 9 秒。
• 标注：社区玩法，企业落地需复核安全边界。（AppID/AppSecret、脚本写库、调用微信写接口均需人工确认。）

7.2 实测打通公众号：文章自动进草稿箱

• 来源：人人都是产品经理 https://www.woshipm.com/ai/6448280.html
• 内容要点：
  • WorkBuddy 可调用微信开发者平台接口，将排好版的文章直接推入公众号草稿箱。
  • 文中给出微信接口配置、风格库/Skill 建设和 5 步人工审核清单，并用风格训练消除 AI 味。
• 标注：社区玩法，企业落地需复核安全边界。

7.3 公众号排版 Skill：搭一次每次省 20 分钟

• 来源：云巴巴 https://www.yun88.com/news/11621.html
• 内容要点：
  • 新建项目"公众号自动排版"，把排版习惯（字号、行距、引用块样式等）一次性告诉 WorkBuddy 沉淀为 Skill，后续每次直接复用。
• 标注：社区玩法，企业落地需复核安全边界。

---

二、踩坑合集（社区玩法，企业落地需复核安全边界）

1. 编排死循环 / 改 A 坏 B

1.1 开发 AI 营销平台：修 A → B 坏 → 修 B → C 坏 的死循环

• 来源：腾讯云开发者社区 https://cloud.tencent.cn/developer/article/2731258
• 内容要点：
  • 现象：让 WorkBuddy 修"登录后刷新页面会退出"，它修好了刷新不退，但"退出登录"按钮点不动了；再修退出，"修改个人信息"又不能用。
  • 原文："那段时间我陷入了一个死循环：修 A → B 坏 → 修 B → C 坏 → 修 C → A 又坏了。"
  • 作者归因："WorkBuddy 处理代码的方式是'局部最优解'——它只关注你当前提的那个问题，不会主动去检查这次修改会不会影响其他地方……不会主动做回归测试。"
  • 另一坑："WorkBuddy 默认会优先保证'视觉上看起来对'，而不是'功能上真的对'。如果你不给它明确的指令说'我要的是真实可用的系统，不是演示页面'，它就会倾向于给你一个漂亮的壳。"
  • 作者解法：①建"验收清单"文件，列全核心功能，每次改完跑整张清单，发现哪个坏了截图发它"这个功能之前是好的，你这次改动把它弄坏了"；②提需求时加边界"只改 auth.service.ts，不要动其他文件"。
• 标注：社区玩法，企业落地需复核安全边界。

1.2 固定资产系统迭代中暴露的工程级连环坑

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.cn/article/2756986
• 内容要点（原文 10 条踩坑表摘录）：
  1. Express 4 不捕获 async 路由处理器异常，请求永久挂起 → 路由处理器一律写成同步，用静态 import 代替 await import()。
  2. sql.js 不支持命名参数，只认 ? 占位符 + 位置参数；且无外键级联 → 删主表必须手动清子表（asset_records / depreciation_records / rfid_tags / inventory_items / maintenance_plans / maintenance_records）。
  3. ?? 无法清空字段（null ?? x 得 x）→ 要支持清空必须用 !== undefined 判断。
  4. || null 会误清既有归属（领用后 28 条资产有 23 条部门变空）→ 可选更新字段一律用 ?? 原值。
  5. MUI 双触发：卡片 onClick + 内部 Checkbox 各绑一次，一次点击 toggle 两次相互抵消，表现为"点了没反应" → 加守卫 if (e.target.closest('.MuiFormControlLabel-root')) return;。
  6. sql.js 单进程全库载入内存 → 架构硬约束：只能单机/局域网授权，做 SaaS 必须先多租户重构。
  7. 字段名不一致（asset_records 是 operation_type 不是 type），SQL 报错被 catch 吞掉，表现为删除按钮无反应 → 统一校对字段命名。
  8. Express 路由顺序：/next-code、/check-code 必须注册在 /:id 之前，否则被吞 → 静态路由前置。
  9. 打包敏感数据泄露：private.pem、license-ledger.jsonl、data/、uploads/ 必须排除，但公钥 public.pem 必须进包 → 打包脚本加白/黑名单 + 自动泄露扫描。
  10. 版本号批量替换遗漏（踩了两次）→ 替换前先 grep 确认当前实际版本号，别凭记忆写匹配串。
  • 工程纪律：打包模式下启动服务会切换数据目录到 %APPDATA%，本地联调必须显式指定 DB_PATH。
• 标注：社区玩法，企业落地需复核安全边界。（私钥/许可证打包需人工确认。）

2. AI 幻觉 / 假成功 / 自述不可信

2.1 "它说发好了，其实根本没发"

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2765291
• 内容要点：
  • 现象：自动化任务返回成功，日志写着"发布成功"，时间、标题、状态全对；第二天看平台后台什么都没有。
  • 真相：脚本判断的"成功"是按钮点到了，不是平台真的执行了；点完按钮弹确认框，服务端其实返回了拒绝，但脚本看不懂继续往下走。作者抓网络请求看到真实返回：DOWN_SHELF_FAIL::为保障活动流量推广效果，请前往 App 修改。
  • 修法：任何"写"操作必须回读（发布要拿到平台返回的 id，下架要回读列表确认数量减 1）；拿不到 id 的一律记"待核"，不算完成、不进台账；别信 exit code，"exit 0 只代表脚本没崩，不代表事情办成了"。
• 标注：社区玩法，企业落地需复核安全边界。（涉及第三方平台写接口，需人工确认。）

2.2 "AI 说我在线，不等于它在线"

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2765291
• 内容要点：
  • 现象：群机器人说"心跳正常，一切在线"，但让它干活没人接，任务单一直挂着。
  • 真相：那个"心跳"是它自己写进去的；任何持有令牌的调用方都能写一个"我活着"的状态，属于自述，不可信。
  • 附带误判：作者为了让它别乱说话加了静音开关，结果它的消息全被丢弃，"明明活着，却看起来像死了"。
  • 修法：只看行为证据（有没有来拉任务、有没有产出物、有没有认领单子）；心跳只当参考不当结论。
• 标注：社区玩法，企业落地需复核安全边界。

2.3 为了防它编话，把"有人应"也一起关了

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2765291
• 内容要点：
  • 现象：群里有人喊三遍，两个 AI 一声不吭，对方直接火了。
  • 真相：静音开关关掉的是全部自动应答，包括最基础的"我在，马上到"。
  • 修法：应答拆两级——"报到"永远开放（60 秒内没人应就回"在，马上到"，不带任何内容、不解释、不编）；"内容"才受控（有数据才说，没数据就说"我不掌握"）。
• 标注：社区玩法，企业落地需复核安全边界。

2.4 定时任务"幻觉"：简报生成了但没推送到企业微信

• 来源：AsiaICT（英文报道） https://www.asiaict.com/cloud/21290.html
• 内容要点（原文摘录翻译）：
  • 用户指出问题后，WorkBuddy 给出解释：它出现了一次模型幻觉（model hallucination）；定时任务确实为 15 号成功生成了正确简报，但由于一个系统 bug，简报没有被推送到企业微信。
  • 用户担心是自己操作失误，反问 WorkBuddy 确认。
• 标注：社区玩法，企业落地需复核安全边界。

2.5 AI 改稿的分寸：擅自改写句式、增删内容

• 来源：腾讯云开发者社区 https://cloud.tencent.com.cn/developer/article/2752821
• 内容要点：
  • 早期提示词让 AI"润色"，结果它擅自改写句式、增删内容。
  • 后来收紧成白名单：只允许改错别字、语病、标点、人名地名用字（如"螺祖"改"嫘祖"），其他一律不动，并要求汇报每一处修改。
  • 原文："交给 AI 的事，边界越具体越安全。"
• 标注：社区玩法，企业落地需复核安全边界。

3. 鉴权失败 / 连接器授权

3.1 绑定 GitHub 连续三次"连接失败，请重连"

• 来源：腾讯云开发者社区 https://cloud.tencent.com/developer/article/2761198
• 内容要点：
  • 现象：浏览器正常弹出 GitHub 授权页，登录确认后切回 WorkBuddy，等来一句"连接失败，请重连"，连试三次都一样；界面给的信息量约等于零。
  • 排查（让 WorkBuddy 翻自己的日志）：~/.workbuddy/logs/network-failover.jsonl 配置拉取全部 200、健康检查 failures 为空 → 不是网络；Info.plist 里 workbuddy:// URL Scheme 声明正常 → 不是回调协议没注册。
  • 真因：daemon.log 显示每次 server-side-authorization-opened（浏览器确实打开了授权页）后约 2 分钟出现 wb:connectors:cancel arg="github"——授权完成后的回传没回来。同时日志反复冒另一条错：GET /v2/as/connector/registry2c/list?scope=enterprise → 403 code=10085 "enterprise context is required for enterprise connector scope"，作者账号被认定为企业范围，连接器面板反复加载失败，"失败请重连"提示很可能是这条在刷屏。
  • 正确姿势：彻底退出 WorkBuddy（macOS 要 Cmd+Q，关窗口不算）再重开 → 重新走连接器流程 → 浏览器授权页务必走完（确认已登录 GitHub、点绿色 Authorize、弹窗问"是否允许此网页打开 WorkBuddy"必须选"允许"、中途不要手动关弹窗也不要切走）→ 自动跳回 App 状态变"已授权"→ 用 get_me 之类只读调用做端到端验证。
• 标注：社区玩法，企业落地需复核安全边界。（OAuth 授权与 Token 回调需人工确认。）

3.2 客户端 401：先按网络问题查，别先动密钥

• 来源：workbuddy.press 故障排查文档 https://workbuddy.press/docs/troubleshooting
• 内容要点：
  • 官方 FAQ 口径：客户端出现 401 报错归入网络环境问题，不是腾讯云 SecretId/SecretKey 错误；只有报错明确来自你配置的第三方 API、MCP 或连接器时，才检查该服务的 API Key、Token、URL 和权限。
  • 解决：先按网络问题排查（切换网络、关闭拦截插件等）。
• 标注：社区玩法，企业落地需复核安全边界。

3.3 自定义模型接入失败：401 查 Key、403 查权限、404 查 ID

• 来源：OSCHINA https://my.oschina.net/u/9487999/blog/19749985 ；七牛云转载 https://news.qiniu.com/archives/1789631952165
• 内容要点：
  • 速查表（原文）：401/403 优先怀疑 Key、权限或请求头，第一动作用 curl 单独请求接口；404/模型不存在优先怀疑模型 ID、区域端点，查供应商模型列表或文档。
  • "Unauthorized"：重新生成 Key，去掉首尾空格，确认 WorkBuddy 里填的没有多余空格。
  • 七牛云文结论："状态码即答案，401 查 Key，403 查权限，404 查 ID。200 说明网络、Key、路由基本通。"
• 标注：社区玩法，企业落地需复核安全边界。（API Key 配置需人工确认。）

3.4 本地 Ollama 接入：测试通过、派活就废

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2736131
• 内容要点：
  • 现象：开新任务让它分析本地项目代码结构，它就没反应了——不是报错、不是崩溃，就是卡住，最后要么超时，要么回一句莫名其妙的空内容。
  • 排查过程：先怀疑模型太小，换更大模型还是一样；再怀疑端口或网络，查一圈都正常。
• 标注：社区玩法，企业落地需复核安全边界。

4. 定时任务漏触发 / 自动化静默失败

4.1 定时自动化踩的 6 个坑

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2757520
• 内容要点：
  1. 一条规则写多个时间直接报错：想 9/13/17/21 点各跑一次，把 BYHOUR 写成 9,13,17,21，创建直接失败——调度 RRULE 的 BYHOUR 不支持多值，一条规则只能挂一个整点。解法：拆成多条任务（09:00 主跑完整执行，13/17/21 补跑兜底），失败时能一眼看出是哪一段。
  2. 状态查询接口返回值不可信：任务幂等逻辑是"先查今天签没签，没签就签"，但实测签到成功后状态查询仍返回"今日未签到"，而积分余额确实涨了。若继续按该字段判断，补跑会反复调签到接口。解法：不看状态查询，看写入操作自己的返回码——"今日已签"时返回的特定错误码当成功处理并跳过。
  3. 失败被静默吞掉，看起来天天成功：连续几天任务汇报"执行完成"，但积分没怎么涨；实际一直在失败，脚本把异常吞了仍输出"完成"。解法：在任务提示里写死硬规则——出现登录态失效、网络异常、业务错误码必须如实报告失败原因、修复建议和下次重试时间，绝不允许输出"成功"；汇报信息不对称（成功无新领取只回一句"今日已完成"；有新领取说明领了什么；失败三要素一个不能少）。原文判断标准："如果一个自动化任务你从来没有收到过失败通知，先别高兴，去验证它到底有没有真的执行。没有失败的自动化，很可能是把失败藏起来了。"
  4. 以为"配好了就会一直跑"：配好后关了几天电脑，那几天全断签。真相：定时任务由客户端进程执行，客户端没打开或机器关机，那个时段就不执行——"这不是 bug，是这类客户端的固有约束"。解法：做冗余时段（09:00 主跑 + 三个补跑，当天客户端任意时段开着就能补上）；最后一段补跑若还失败，必须明确提醒"今天可能断签，需要手动处理"。
  5. 误读时间字段：旅行奖励"到达时间"显示成大整数，以为时间戳单位搞错了，改了好几次判断逻辑；实际是时区和显示口径问题。解法：处理时间字段一律用程序换算后再判断，跟服务端当前时间字段对齐比较，不要用本机时间直接对比。
  6. 达标了不等于到账了：连续签到满 7/14/28 天档位奖励，以为系统会自动发，结果满 7 天后档位仍锁定——这类档位奖励需要达标后主动领取。解法：把"领取档位奖励"加进每日任务执行清单，只领达标且未领取的档位。
• 标注：社区玩法，企业落地需复核安全边界。

4.2 定时任务没执行的通用排查清单

• 来源：workbuddy.press https://workbuddy.press/docs/troubleshooting ；腾讯云《避坑大全 10 个常见问题》https://cloud.tencent.com/developer/article/2669309
• 内容要点：
  • workbuddy.press：原因包括桌面客户端离线、时间规则配置错误、工作目录被移动。解决：确认保存任务的桌面客户端正在运行且账号保持登录；检查触发规则中的时区与时间；确认工作目录路径仍存在；所需模型、Skill、知识库和连接器仍可用；先手工运行同一提示词验证能否正常执行。
  • 避坑大全：①电脑是否开机（定时任务需电脑开机且 WorkBuddy 在运行）；②WorkBuddy 是否在后台运行（被系统自动关闭就白搭）；③任务时间对不对（检查时区，别设成 UTC）；④任务状态是"活跃"还是"暂停"。最佳实践：指令末尾加一句"如果执行失败，把错误信息保存到桌面'任务日志.txt'"。
• 标注：社区玩法，企业落地需复核安全边界。

4.3 自动化每次都是全新会话，上下文会丢

• 来源：腾讯云开发者社区《WorkBuddy 自动化实战：3 个场景》 https://cloud.tencent.com.cn/developer/article/2721636
• 内容要点（原文坑表摘录）：
  • 坑 1 定时任务不触发：检查客户端是否在后台运行；检查自动化状态是否为 ACTIVE。
  • 坑 2 上下文丢失：自动化任务每次都是全新会话，不能依赖历史对话；所有上下文必须写在 Prompt 里。
• 标注：社区玩法，企业落地需复核安全边界。

4.4 微信提醒的两个坑

• 来源：云巴巴 https://www.yun88.com/news/15818.html
• 内容要点：
  • WorkBuddy 定时任务分电脑端与云端两种跑法；电脑端任务能按时执行的前提是电脑开机且客户端运行，云端任务才由平台独立调度；把两者混着理解，消息提醒就无从谈起。
  • 博主实测踩出的坑：社交通道不与云端沙箱打通；微信 Clawbot 48（小时/次限制，原文被截断）。
• 标注：社区玩法，企业落地需复核安全边界。

4.5 流水线守卫：把"0 条算异常"写进提示词

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2771138
• 内容要点：
  • 命令写绝对路径（作者称"这是生死线"）；异常判定写进提示词——"0 条算异常"这句话让 Agent 替你判断空跑，它按提示词检查日志比脚本自己喊更灵活。
  • 把守卫接进任务：让 Agent 跑完流水线顺手跑 guard，或用任务链把两步串起来。
• 标注：社区玩法，企业落地需复核安全边界。（执行 shell 命令需人工确认。）

5. 其他真实问题

5.1 对话里起的常驻进程活不过这一轮

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2765291
• 内容要点：
  • 现象：让 AI 起常驻服务，它报告"已启动，进程 PID 12345"，几分钟后再看没了；再让它修，又报告"已修好"，几分钟后又没了。
  • 真相：子进程挂在当前会话的作业对象上，对话轮次一结束系统把整棵进程树回收。作者写探针（每 3 秒往文件记一行时间戳）验证：起跑 3 秒后永久静止，死亡时刻正好是那轮对话结束的那一秒。
  • AI 自己找错方向：先试"给进程加 breakaway 标志跳出作业对象"失败；又试"两个进程互相拉起"还是失败——因为两个都在同一个作业对象里。原文："位置不对，怎么改都没用。"
  • 修法：常驻的东西不要用自己的会话起，交给系统级启动（开机启动目录、计划任务、服务）；判断是不是被回收，写探针看时间戳，别问它。
• 标注：社区玩法，企业落地需复核安全边界。（系统级服务/开机启动需人工确认。）

5.2 按 id 增量处理，id 回滚就永久停摆

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2765291
• 内容要点：
  • 现象：平台明明有新消息，系统却说"没有新活"，一连几小时不动。
  • 真相：按"从上一次的 id 往后取"做增量；平台重新部署后编号从 355 回滚到 207，游标停在 348，永远大于线上最大 id，所有新消息被当成"旧的"跳过。
  • 修法：每轮开始先取线上最大 id，和本地游标比，不一致先校准再判断有没有新活（if cursor > max_id: cursor = max_id - 1）。原文："这类 bug 特别阴，因为它不报错，只是安静地不干活。"
• 标注：社区玩法，企业落地需复核安全边界。

5.3 积分账单：一天 411 分，61% 花在一个超长会话

• 来源：腾讯云开发者社区 https://developer.cloud.tencent.com/article/2765291
• 内容要点：
  • 作者拉账单：一个超长会话（36 次请求）占 61%，全部自动化任务加起来才 24%，单次约 7 分。
  • 原因："会话越长，上下文越大，每次请求都在为历史付钱。"
  • 实战修法：小事开新会话（短上下文单次 1~2 分，省 70% 以上）；长会话只留给必须连续上下文的改造；定期把长会话结论压缩成笔记，下次用笔记而不是全文。
• 标注：社区玩法，企业落地需复核安全边界。

5.4 路径报错、大批量卡死、数字精度丢失、PDF 转换乱版

• 来源：腾讯云开发者社区《避坑大全！WorkBuddy 使用中的 10 个常见问题》 https://cloud.tencent.com/developer/article/2669309
• 内容要点（会计用户视角摘录）：
  • 路径：不要写"桌面上的报表.xlsx"（它可能去 C:\Users\Public\Desktop 找）；不要混用斜杠反斜杠；用完整绝对路径，或先让它"帮我看看桌面上有哪些 xlsx 文件"再复制路径。
  • 大批量文件中途卡住：分批处理（先 20 个确认完再下 20 个）；先缩小范围（只处理 >100KB 文件，跳过空文件）；关掉浏览器、微信等占内存程序。
  • 财务数字精度："把这两列数字相加"可能用浮点导致精度丢失；要写"所有金额保留两位小数，四舍五入，最终结果和手工计算器对一下"。
  • PDF 转 Word/Excel：原生 PDF 效果好；扫描件 PDF 需 OCR、精度有限；加密 PDF 无法提取；财务报表尽量从源系统导出 Excel，别走 PDF 转 Excel。
  • 适合/不适合交给 WorkBuddy 的判断：重复性高、规则明确、数据量大、操作标准化适合；涉及商业机密（数据会上传云端）、需要职业判断（税务筹划、审计意见）、结果要对外报送（审计报告、纳税申报表）、规则很复杂的不适合。原文："AI 做苦力，你做决策。数据处理交给它，最终把关留给你。"
• 标注：社区玩法，企业落地需复核安全边界。（财务/对外报送数据需人工确认。）

5.5 公众号个人订阅号没有群发权限（errno 48001）

• 来源：腾讯云开发者社区 https://cloud.tencent.com.cn/developer/article/2752821
• 内容要点：
  • 第一次跑通发布时兴冲冲调 freepublish 接口，直接返回 errno 48001——2025 年 7 月起平台回收了个人订阅号的自动群发权限。
  • 解法：改用 draft/add 接口推草稿箱，最终发布永远由人手动点。作者事后评价："AI 准备、人来把关，内容安全上更稳妥。"
  • 另一条：个人订阅号没有数据统计 API 权限（所有 datacube 接口返回 48001），看板只能走"文件导入"路线。
  • 还有"任务没跑其实是跑了一半"：某天 09:30 到点草稿箱没动静，排查发现自动化 09:37 就执行了，排版配图全做完，只卡在最后一步发布（IP 变了）。排查思路：先看 articles/ 目录最新文件时间戳和台账，判断执行到哪一步，不要一上来怀疑调度。
• 标注：社区玩法，企业落地需复核安全边界。（调用微信写接口需人工确认。）

5.6 "低价充值 5000 积分 8.88 元"是李鬼灰产

• 来源：京报网（北京日报）https://xinwen.bjd.com.cn/content/s6aa0082ee4b0e42f8f000921.html
• 内容要点：
  • 9 月 7 日有网友发帖称中了"WorkBuddy 积分"骗局：买来的积分"不仅不是 WorkBuddy 官方积分，还会盗取你的信息"，显示额度是假的，消耗至少是平时的 3 到 5 倍；想退款，对方一句"兑换码是虚拟（商品不退不换）"。
  • 媒体定性为"李鬼灰产"。
• 标注：社区玩法，企业落地需复核安全边界。（第三方充值链接需人工确认，勿在非官方渠道购买积分/兑换码。）

5.7 无头浏览器残留 SingletonLock 导致启动失败

• 来源：腾讯云开发者社区 WorkBuddy 标签聚合页 https://cloud.tencent.com.cn/developer/tag/18238
• 内容要点（标签页摘要片段）：
  • 10 月 19 日 07:14 监控脚本照常启动，回来一行字："取数失败: HTTP Error 502: Bad Gateway"，到 19:39 才真正修好。
  • 无头浏览器跑自动化时，如果上次进程被强杀，配置目录会残留 SingletonLock 锁文件，指向一个早已不存在的进程——之后每次启动都直接失败，报错还看不懂。
• 标注：社区玩法，企业落地需复核安全边界。

待补充：

• 小红书站内正文（需登录，公开搜索仅能拿到标题/摘要，未能精读笔记原文）。
• 「WorkBuddy 死循环」除 1.1 外的更多独立个案。
• 除 2.4 外、用户在企业微信/钉钉侧推送漏达的更多原始工单截图描述。
• WorkBuddy 官方社区 issue 原文（需登录，本次未取）。

---