扣子（Coze）合规 Bot 上线
把命理/玄学/起名/风水等敏感业务，做成「去命理化」的合规文化 Bot 并上架扣子商店的标准流程。
核心原则：敏感业务要上扣子，必须包装成「文化赏析」，绝不能出现算命/五行/吉凶/改运字样，否则踩平台红线被下架。
何时使用
- 用户要在扣子(coze.cn)上架一个与命理/玄学/起名/风水相关的 Bot，且希望合规不被封。
- 用户问「扣子怎么变现/收款」「为什么 Bot 上架了没收入」「扣子商店发布不了」。
- 用户已经有 WorkBuddy 专家包，想顺手在扣子也铺一个引流/分成 Bot。
标准流程（六步）
1. 清洗素材（去命理化）
- 把原文档复制一份，只留文化章节（字源/音韵/典籍出处/历史礼俗），整段删除命理推算部分。
- 禁用词清单见
references/redline_checklist.md，务必 grep 校验一遍，确保一个不剩（结尾免责声明除外）。 - 知识库文档同样要清洗——扣子会审知识库，残留命理词照样驳回。
- 把清洗后的 .md 放到一个固定本地目录（如桌面某文件夹），方便脚本批量读取。
2. 写合规人设 Prompt
- 能力范围只写文化赏析；必须嵌入「硬性边界」段（不批八字/不算命/不评吉凶/不风水择日），模板见 redline_checklist.md。
- 遇到命理请求，礼貌拒绝并引导回文化赏析（附话术示例）。
3. 生成 PAT（个人访问令牌）
- 入口：扣子 → 空间配置 → API 管理 → 授权 → 个人访问令牌（直达
https://www.coze.cn/open/oauth/pats）。 - 生成时：权限全选、有效期设短（7 天）、范围选「所有工作空间」。
- 令牌等于账号钥匙，明文有效，不落盘存储；用完即删/作废。
4. 脚本自动建 Bot + 知识库（API 渠道）
- 用
scripts/coze_build_bot.py（依赖cozepy，pip install cozepy）。 - 复用前替换顶部 CONFIG 区：BOT_NAME/BOT_DESC/PROMPT/KNOWLEDGE_DIR/AVATAR_PATH。
- 运行：
$env:COZE_API_TOKEN='pat_xxx'; python coze_build_bot.py - 脚本自动完成：取空间 ID → 传头像 → 建知识库 → 传清洗文档 → 建 Bot → 挂知识库 → 发布到 API 渠道(1024)。
- 注意：本机 Bash 的 shell-runtime 缺
dirname会 exit 127，一律改用 PowerShell 跑 Python。
5. 网页手动发布到「扣子商店」
- 「扣子商店(10000122)」对个人版账号不允许 API 代发，必须在网页发布弹窗里手动勾选发布（走内容审核）。发布弹窗里通常只有「扣子商店」「飞书」等可勾。
- 豆包渠道已彻底关闭（两条都断）：① 扣子→豆包发布渠道 2026-07-01 被官方下线；② 豆包 App 本身于 2026-07-15 全面下线用户自建智能体（广场/自建/搜索入口全关，新规《人工智能拟人化互动服务管理暂行办法》落地＋行业整改），存量智能体停跑、数据 2026-10-15 前可导出、之后永久清除。故「去豆包原生重建」也不再可行。字节承接智能体的替代产品是 猫箱 App（偏角色互动/陪伴，用户画像与"找起名的人"不对，做文化顾问不划算）。
- 结论：别在豆包上花力气，主战场就是扣子（商店 + API）。要扩流量，用扣子 API 把 Bot 嵌进自己的网站/小程序/公众号，把用户引到扣子商店 Bot。
渠道清单与真实受众（2026-09 核实，勿再凭记忆答）
| 渠道 | 本质 | 真实受众 / 用途 |
|---|---|---|
| 扣子商店(10000122) | 扣子内的应用商店 | 逛的多是 AI 创作者/同行，普通用户极少来；当"官网占位"，不是来客源 |
| API(1024) | 接口渠道 | 可 API 发布；给自家网站/小程序后端调用 |
| Chat SDK | 网页嵌入渠道（非"发到某平台"） | 发布后得 JS 安装代码，在自己网页右下角挂免登录悬浮聊天球；支持 isIframe（规避小程序 webview 域名限制）。未发布此渠道就调用会报「智能体已经被解绑」；免费额度有限（控制台「累计 100 条，升级套餐豁免额度限制」）。代码内需 Access Token 鉴权，勿把 PAT 明文塞进公开网页 |
| 掘金(juejin.cn) | 字节旗下程序员技术社区 | 发布后仅能在「AI 聊天室」圈子（沸点）@ 机器人、评论回复，仅文本、消息约 1 分钟审核。受众是开发者，对起名/文化业务几乎无引流价值；唯一可用姿势是发一篇"我用扣子搭了 xxx Bot"技术向文章导流 |
| 飞书 | 企业协同办公平台 | 官方硬限「仅支持同一飞书租户内分享，不支持跨租户」；个人号≈只自己可见，无引流价值 |
| 豆包 | 已双重关闭 | 放弃（2026-07-01 扣子侧下线 + 2026-07-15 豆包侧下线） |
| - 必须登录网页端：「项目开发 → 智能体开发 → 该 Bot → 右上「发布」→ 勾选「扣子商店」（分类如"文本创作"）→ 发布」。 | ||
| - 走平台内容审核，命理内容已剥离通常秒过~1-2 天。过审即上架。 |
6. 收尾
- 回扣子后台「发布历史」看审核状态。
- 删除用过的 PAT（空间配置 → API 管理 → 授权）。
- 完善商店详情页文案（名称/简介/开场白/示例问题），提升点击率。
6之二、命名类 Bot 的"中国正统"话术要点（2026-09-13 收口）
起名/姓名文化类 Bot 的人设，须把"中国正统"立为主纲：
- 主纲＝《左传·桓公六年》申繻「五可六避」＋《礼记》避讳＋六亲避讳，这是中华本土命名礼法（前 706 年，比三才五格早 2600 年）。
- 三才五格定位＝日本 1918 熊崎健翁舶来品，仅作结构参考：人设里写明"本顾问依据中国正统命名礼法（五可六避/避讳/音形义），不采用日本三才五格体系；如被问及，平和说明其来源即可"。
- 交付周期、定价、六亲问卷等商务信息，人设只给"文化咨询"口径，收款/下单走微信钩子，红线守住。
- 已落地：善思君·国学起名文化顾问（API 渠道 v1789293191319）即按此口径。
变现与收款（必须讲清的硬约束）
上线 ≠ 能收款。 详见 references/coze_settlement.md。要点：
- 免费 Bot 上架只是「公开展示/引流」，不直接产生可提现收益。
- 真要收款（付费模板 2:8、付费技能 70%起、积分分成），需先开通收款账户，必交：身份证 + 本人实名对私银行卡 + (支付宝或抖音支付二选一)。
- 可以不用支付宝，改用抖音支付；但本人为被执行人/被保全时，任何本人实名账户进账都可能被法院划扣，换渠道解决不了；不可建议用他人账户规避执行。此类情况应暂缓付费变现，只做免费展示引流。
与 WorkBuddy 的分工
- 扣子：合规文化版，去命理化，引流 + 试水分成机制，不能真算命。
- WorkBuddy 专家包（紫微/起名）：能真算，但平台分成机制尚未落地，目前是占坑养流量。
- 命理核心业务仍走 WorkBuddy 专家包或用户线下，扣子 Bot 内绝不嵌算命、不发二维码；但可写温和引导微信话术（如"如需一对一的姓名文化交流可添加微信 XXX"），只谈文化咨询、不承诺改运效果——这是用户 2026-09-13 拍板允许的引流方式，红线仍守住。
常见坑（必读）
- 扣子改版：「智能体开发」入口从侧边栏收起，从「项目开发」或直达
https://www.coze.cn/open/oauth/sats进入；「API 管理/授权」页是给写代码调接口的，不是建 Bot 的地方。 - 发布弹窗里只勾「扣子商店」（+ 已授权的「飞书」）；没有豆包选项是正常的（豆包渠道 2026-07-01/07-15 已双重关闭，别去豆包找入口，找不到是对的）。其余微信/抖音渠道未授权不用管。
- 别把「豆包工作」当发布场所：doubao.com/work 的「豆包工作」是任务工作台（新工作任务/定时任务/技能·连接器·伙伴/云盘），建的东西只有自己用，不能被别人搜到，不是智能体商店。
- 知识库 build_local_file 传字符串，
file_type='md'；markdown 也可。
