50 lines
2.9 KiB
Markdown
50 lines
2.9 KiB
Markdown
# 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 获知群名，需人工在飞书里核对。
|
||
- **命令示例**（上传完成后执行）：
|
||
|
||
```bash
|
||
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（标题加粗、正文常规），便于阅读。
|
||
|
||
---
|
||
|
||
## 完整链路（写文章 → 上传 → 推送）
|
||
|
||
1. 写文章 → 保存到书稿第9章目录（如 `第112场｜…md`）。
|
||
2. 上传到小程序：`content_upload.py --id 9.xx --title "…" --content-file "<md路径>" --part part-4 --chapter chapter-9 --price 1.0`。
|
||
3. 推送飞书群：`scripts/send_chapter_poster_to_feishu.py <章节id> "<章节标题>" --md "<同一 md 路径>"`。
|
||
|
||
推送后，飞书群收到：① 标题 + 前 6% 正文；② 海报图（含该章节小程序码）。不收到任何小程序链接。
|