2.9 KiB
2.9 KiB
Soul 文章推送飞书群 · 逻辑说明
上传到小程序后，同步把该章节推送到固定飞书群：发前 6% 正文（一句一行、行间空一行）+ 章节海报图（含小程序码），不发小程序链接。
原则
- 不发链接：群里不出现「小程序：https://...」等链接，只通过海报中的二维码引导扫码阅读。
- 文本格式：一句一行，句子之间空一行（也就是用
\n\n分隔句子）。 - 内容：一条文本消息（标题 + 文章前 6% 正文）+ 一条图片消息（章节海报，内含该章节小程序码）。
- 顺序：先发前 6% 正文，再发海报图。
脚本与命令
- 脚本：永平项目下
scripts/send_chapter_poster_to_feishu.py - 依赖：
pip install requests Pillow；飞书应用凭证写在scripts/.env.feishu（FEISHU_APP_ID、FEISHU_APP_SECRET）。 - 固定群 webhook：脚本内置默认发到 Soul 彩民团队 飞书群，webhook 为
https://open.feishu.cn/open-apis/bot/v2/hook/14a7e0d3-864d-4709-ad40-0def6edba566。无需复制链接，直接运行命令即可。 - 自定义 webhook（--webhook）：用
--webhook "https://..."可指定其他群。推送前必须确认：目标群名称含有「瘦」或「IP」，否则不要推送；脚本无法从 webhook 获知群名，需人工在飞书里核对。 - 命令示例（上传完成后执行）：
cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验-永平"
python3 scripts/send_chapter_poster_to_feishu.py 9.24 "第112场｜一个人起头，维权挣了大半套房" \
--md "/Users/karuo/Documents/个人/2、我写的书/《一场soul的创业实验》/第四篇｜真实的赚钱/第9章｜我在Soul上亲访的赚钱案例/第112场｜一个人起头，维权挣了大半套房.md"
- 参数：
<章节id>、<章节标题>、--md <文章 .md 路径>。摘要自动取该文章正文前 6% 字数。
海报规则
- 标题：章节标题（如「第112场｜…」），不再用「Soul创业派对」或「精彩内容」做主标题。
- 摘要区：文章前 6% 字数，每句空一行，严格限制在摘要框内，超出则截断并加省略号。
- 无手指图标；底部为「长按识别小程序码」+ 章节小程序码。
- 字体：PingFang（标题加粗、正文常规），便于阅读。
完整链路（写文章 → 上传 → 推送）
- 写文章 → 保存到书稿第9章目录（如
第112场｜…md）。 - 上传到小程序：
content_upload.py --id 9.xx --title "…" --content-file "<md路径>" --part part-4 --chapter chapter-9 --price 1.0。 - 推送飞书群：
scripts/send_chapter_poster_to_feishu.py <章节id> "<章节标题>" --md "<同一 md 路径>"。
推送后，飞书群收到：① 标题 + 前 6% 正文；② 海报图（含该章节小程序码）。不收到任何小程序链接。