AI 开源情报站 → 小红书图文一键发布
账号定位（运营基调）
- 人设：AI 工具情报站 / 数码效率达人——"每天帮你盯 GitHub 和 AI 圈的侦察兵"，朋友安利口吻、数据说话、不端着。
- 目标人群：18–30 岁职场人、学生、开发者；痛点是信息过载、效率焦虑、怕错过新工具。
- 差异化：只发"有出处、可验证、真上手"的 AI 情报——新闻/模型必带来源，仓库必带 star 数与仓库地址，教程必带真实命令。
- 内容配比：70% 干货价值（教程 + 清单 + Top5 + 博客解读）+ 20% 热点速报 + 10% 人设互动；稳定更新 > 爆发式更新。
每周内容日历（固定节奏）
| 星期 | 内容类型 | 数据源 | 建议发布时间 |
|---|---|---|---|
| 周一 | AI 新闻 + 模型发布速报 | llm-stats.com/ai-news、llm-stats.com/llm-updates | 12:00–13:00 或 19:00–21:00 |
| 周二 | 今日 GitHub 涨星最多 AI 仓库（用户测评） | GitHub Trending daily | 19:00–21:00 |
| 周三 | 5 款 GitHub 效率工具 | GitHub Trending / 收藏夹 | 12:00–13:00 |
| 周四 | Hugging Face 最新博客解读 | huggingface.co/blog | 12:00–13:00 |
| 周五 | 本周 GitHub 热度 Top5 | GitHub Trending weekly | 12:00–13:00 |
工作日日更 5 篇，周末复盘并备下周选题。涉及 GitHub 仓库的内容（周二/周三/周五）必须先查发布台账，跳过已发布仓库。
通用生产流程
选材（先查发布台账，跳过已发布仓库）→ 提取信息（写 UTF-8 JSON 数据文件）→ 撰写文案 → 生成配图 → 通过 xiaohongshu-mcp 发布 → 登记发布台账 → 黄金 2 小时互动 → 数据复盘。以下按内容类型拆解。
排版与配图基准（必读）
参考笔记：http://xhslink.cn/o/2HFSGw2XoUm（《✨本周Github最火AI热门项目，第一名狂揽5w🌟》）。所有配图按此风格：
- 尺寸：1080x1440 竖版；浅灰底 + 白色圆角卡，顶部红色/绿色横幅写英文栏目头与日期，底部页脚写栏目英文名。
- 配色：红 (229,57,53) 用于排名/强调，绿 (9,99,73) 用于增长数字/要点，白底、浅灰底 (242,244,239)。
- 卡片要素：编号徽章（
01/新闻 01/模型 01）、大标题、要点列表（绿色圆点）、数据框（如 star 数）、仓库/来源链接（蓝色等宽字体）。 - 文案排版：标题 = 钩子 + 悬念/数字；正文逐条编号（如
[拔草R]01 ...），每条之间空行；话题 5–8 个统一放tags参数。
周一 · AI 新闻 + 模型发布速报
- 数据源：
- 新闻：https://llm-stats.com/ai-news —— 取最新 3 条，每条提取标题、概述（1–3 句）、来源、日期、链接；
- 模型发布：https://llm-stats.com/llm-updates —— 取最新 AI Model Releases 列表，逐个概括更新内容（名称、机构、类别、更新要点 2–4 条、链接）。
- 文案：标题 = 钩子 + 数量（如"AI圈今天炸了🔥3条重磅+5个新模型"）；正文 = 总起一句 → 新闻 01/02/03 概述 → 模型更新逐一概括 → 互动提问（"哪个新模型你最想试？"）。
- 配图：
--template news --news-json news.json --models-json models.json。前 3 张为新闻卡（标题 + 概述 + 来源），后续每张介绍一个模型更新，张数 = 拉取到的模型数。 - 发布后：无需登记仓库。
周二 · GitHub 今日涨星最多 AI 仓库（用户测评）
- 选题：读 GitHub Trending daily（https://github.com/trending?since=daily），找当天涨星最多的 AI 相关仓库 1 个；README 完整、安装方式主流。先运行
python scripts/repo_ledger.py --check owner/repo，已发布过则换候选。 - 记录：
full_name/desc（一句话简介）/today_stars（今日涨星）/total_stars（总 star）/url/summary（按 README 标题归纳的要点 3–5 条）/usage（使用方法 3–5 条）/code（2–4 条真实命令）/review（你的测评观点）。 - 文案：以用户测评角度主观编写：为什么盯上它 → 上手体验 → 优缺点/真实感受（数据+吐槽都行）→ 互动提问；标题 = 钩子 + star 数字（如"今天涨星最快的AI仓库，我实测了一下"）。
- 配图：
--template review --repo-json repo.json，固定 3 张：
1. page1：仓库名称 + 今日涨星 + 总 star + 仓库地址；
2. page2：功能详情；
3. page3：使用方法（含真实命令）。 - 发布成功后：
python scripts/repo_ledger.py --mark owner/repo --title "笔记标题"。
周三 · 5 款 GitHub 效率工具
- 选题：从 GitHub Trending + 收藏夹挑 5 款效率向 AI/开发工具，优先 star 高、README 完整、免费；用台账过滤掉已发布仓库，不足 5 个从备选补足。
- 记录：每款
name/stars/func（一句话功能）/features（亮点 2–3 条）/url。 - 文案：清单体，标题必含数字（如"打工人必备的5个效率AI工具"）；正文 = 总起 → 01–05 每款（名称 + star + 功能 + 仓库地址）→ 收藏引导 + 互动提问。
- 配图：
--template tools --tools-json tools.json： - 第 1 张 tools_list：5 款工具列表（名称 + star + 功能）；
- 后续 5 张 tool_01..05：每款详情（功能、亮点、仓库地址）。
- 发布成功后：5 个仓库逐一
--mark。
周四 · Hugging Face 最新博客解读
- 数据源：https://huggingface.co/blog —— 取最新一篇 blog，提取
title/author/date/summary（核心要点 4–6 条）/takeaways（启发与应用 3–5 条）/url。 - 文案：标题 = 钩子 + 主题（如"HF最新博客：XXX 终于开源了"）；正文 = 博客背景 → 核心要点 → 我的理解与启发 → 互动提问。
- 配图：
--template hfblog --blog-json blog.json（封面 + 核心要点 + 启发与应用，共 3 张）。 - 发布后：无需登记仓库。
周五 · 本周 GitHub 热度 Top5
- 选题：读 GitHub Trending weekly，取本周热度前 5 的 AI 相关仓库；用台账过滤掉已发布仓库，不足 5 个从备选补足。
- 记录：每仓
full_name/stars/weekly_stars（周增）/func（一句话功能）/effect（使用效果 2–3 条）/usage（使用方法 2–3 条）/url。 - 文案：盘点体，标题必含数字（如"本周GitHub热度Top5，第一名狂揽XX🌟"）；正文 = 总起 → 01–05 每仓（名称 + star + 功能）→ 互动提问（"你最想试哪个？评论区告诉我"）。
- 配图：
--template weektop --repos-json repos.json： - 第 1 张 top5_list：5 仓列表（名称 + star + 功能）；
- 后续 5 张 repo_01..05：每仓详情（功能与效果、使用方法、仓库地址）。
- 发布成功后：5 个仓库逐一
--mark。
文案方法论（通用）
- 标题 ≤ 20 个中文字（含标点），必含数字或热点词；模板：数字型、清单型、悬念型、对比型、共情型。
- 正文 ≤ 1000 字，推荐 300–500 字；黄金结构：钩子 → 核心价值 → 演示/证明 → 总结 → 互动 CTA。
- 正文不要写
#开头的话题标签；话题统一放tags参数，5–8 个，组合公式 = 1–2 泛标签（#AI #效率工具）+ 2–3 细分标签（#AI工具 #开源项目 #程序员 #AI新闻 #大模型）+ 1–2 人群标签（#打工人必备 #学生党神器）+ 1 热点标签。 - SEO：标题埋核心词（AI工具 / 效率工具 / GitHub / 大模型 / 开源），正文自然嵌入长尾词。
防重复发布（发布台账）
- 台账文件：
data/posted_repos.json（位于技能目录；可用环境变量XHS_LEDGER_PATH或发布配置ledger字段覆盖路径）。 - 唯一键：
owner/repo（自动小写、剥离github.com/前缀）；同名仓库换话题角度也算重复，直接跳过。 - 流程：选材前
--check→ 候选名单--filter过滤 → 发布成功后--mark（记标题、时间，有 note_id 一并记）。 - 命令：
python scripts/repo_ledger.py --check owner/repo（未发布退出码 0）python scripts/repo_ledger.py --listpython scripts/repo_ledger.py --filter --file repos.json（输出未发布仓库）python scripts/repo_ledger.py --mark owner/repo --title "标题" --note-id xxxx- 一键发布已内置：
xhs_auto_publish.py的配置带repos字段时，自动查重跳过已发布仓库，发布成功后自动登记；全被跳过则输出RESULT: SKIP_ALL_POSTED不发布。
生成配图
- 运行
scripts/make_note_images.py生成 1080x1440 竖版卡片，版式由--template控制：news（周一）/review（周二）/tools（周三）/hfblog（周四）/weektop（周五）。 - 通用参数：
--out-dir（图片目录，建议work/xhs_images）、--date-range（如2026.08.13，默认今天）、--skip-ascii-check（中文目录 + HTTP 供图时必加）。 - 各模板 JSON 输入（UTF-8）：
- news：
--news-json（数组，元素{"title","summary","source","date","url"}，取前 3）+--models-json（数组，元素{"name","category","bullets":[...],"link"}）； - review：
--repo-json（对象，{"full_name","desc","today_stars","total_stars","url","summary":[...],"usage":[...],"code":[...],"review"}）； - tools：
--tools-json（数组，元素{"name","stars","func","features":[...],"url"}，取前 5）； - hfblog：
--blog-json（对象，{"title","author","date","summary":[...],"takeaways":[...],"url"}）； - weektop：
--repos-json（数组，元素{"full_name","stars","weekly_stars","func","effect":[...],"usage":[...],"url"}，取前 5）。 - 示例：
python scripts/make_note_images.py --template weektop \ --repos-json repos.json --date-range 2026.08.10–08.14 \ --out-dir work/xhs_images --skip-ascii-check - 推荐方式（零授权、无人值守友好）：图片生成到会话工作区，随后用本地 HTTP 服务以纯英文 URL 供图（见"发布"节），全程不需要沙箱外的英文目录。
- 传统方式（仅当直接传本地文件路径时）：输出目录必须是纯 ASCII 路径（如
D:\xhs_images），中文路径会导致 MCP 图片上传超时。
发布
- 发布前预检（必做，避免最后一步才失败）：
1. 若是测试或验证发送过程则不发送；
2. 服务健康：访问http://localhost:18060/health，确认"status":"healthy"且版本 ≥ v2.4.3；
3. 登录状态：运行python scripts/publish_xhs.py --check-login（或调用check_login_status）；未登录则用get_login_qrcode扫码（见 references/mcp-integration.md）。 - 推荐发布方式（零授权）：写 UTF-8 的
note_config.json（note字段 = title/content/tags/is_original/visibility；cover字段 = 模板与数据；repos= 仓库名单，可选），运行scripts/xhs_auto_publish.py --config note_config.json，一键完成"查重 → 预检 → 生成配图 → 本地供图 → 发布 → 登记台账 → 校验"。 - 传统发布方式：写 UTF-8 的 JSON 参数文件（title / content / images / tags，可选 is_original、visibility、schedule_at），用
scripts/publish_xhs.py --params <file>发布；此时images必须为纯 ASCII 本地路径。 - 成功标准：返回文本含
Status:发布完成；发布成功后立即--mark登记（一键方式自动完成）。
必读：关键坑
完整细节见 references/mcp-integration.md，至少记住：
- MCP 服务地址
http://localhost:18060/mcp，版本需 ≥ v2.4.3（旧版发布报"没有找到发布 TAB"）。 - 图片路径含中文 → 上传必超时（60s）。解法一：把图片复制到 ASCII 路径再传；解法二（推荐，零授权）：本地 HTTP 服务用
http://127.0.0.1:<port>/xxx.png纯英文 URL 供图。 - 中文参数禁止走 PowerShell 管道/heredoc（会转成
?????），一律用 Python 或 apply_patch 写 UTF-8 JSON 文件。 - 同一账号勿多端同时登录网页版，否则 MCP 会被"踢出登录"。
- 运营红线：不搬运、不刷量、前 30 篇不接硬广、不频繁删文；搬运/引流会被限流甚至封号。
- 定时任务无人值守注意：① 发布服务必须已在运行；② 登录 cookie 过期需扫码（平台限制），任务启动先预检登录；③ 同一账号勿多任务并发，会互踢；④ 优先用零授权 HTTP 供图，避免沙箱外目录写权限卡住整个任务；⑤ 台账要落在持久化路径，定时任务与手动发布共用同一份，防止重复发布。
