sansheng-write · 中文长文写作引擎
把「选题 → 大纲 → 正文 → 改稿 → 排版 → 配图」跑完的 Claude Code skill。喂它你的语料，它长出你的声音。
中文 | English
先看产出，再决定装不装
↓ 20 秒手机实拍：一篇公众号长文从选题落定到成品排版，跑完整条链的样子。
https://github.com/user-attachments/assets/7b5d8a8c-7caf-41e3-957e-5c2428859c79
一句「帮我写一篇关于 X 的文章」，它跑完这条链，最后给你一份微信公众号能直接粘贴的 HTML：
选题快评 → 大纲（含开篇策略分流）→ 正文 → 改稿（去 AI 味三层过滤）
→ 标题（内联锻造 5 个候选）→ 排版（10 个组件 + 契约门）→ 配图 / 封面
排版组件都在 templates/，配色跟着你的主题走：
| 组件 | 用途 |
|---|
| 导读栏 | 文首「一句话说清这篇讲什么」卡片 |
| PART 编号 H2 | 大标题 + 副标题，自动编号 |
| 时间线 H3 | 小标题竖线时间轴 |
| 要点卡 / 金句卡 | 左竖条 + 浅色底，轻盈不厚重 |
| 数字卡 / 步骤条 / 对比块 | 结构化信息，HTML 注释指令驱动 |
| 表格品牌化 | 主题色表头、列宽自动计算、手机端横滑 |
| 继续往下读 / 信息来源 / 关注卡 | 强相关旧文与自有阵地、可复核来源、文末转化 |
质量不靠自觉，靠契约门：作者审批绑定具体稿件摘要；本 Skill 的 visual planner 是唯一真实生产者，新文章默认经叁笙生图画风库（schema2）出最终像素，历史文章与显式选择仍走 baoyu-image-gen（schema1）；封面与插图的全部内容文字必须和画面一次性原生生成，禁止 SVG 或本地字体后期补字。最终视觉、HTML 与微信草稿 media_id 用 receipt 逐层绑定。产出被改过，已完成下游会自动变成 dirty，不能拿旧绿灯继续发。
$ python scripts/format_layout.py 定稿.html --all --check
✅ 成功将 3 个原生 H2 转换为 PART 格式
✅ 表格品牌化完成（主题色表头 / 行分隔线 / 交替行色 / 圆角容器）
✅ 成功将 3 处重点标记转换为主题色文字
⚠️ 2 个警告（非阻塞），无错误
门里检查半角标点、加粗密度、词性比例、套话黑名单、信息图数量、封面比例……
这是什么
一套中文长文的写作方法论 + 排版工程，封装成 Claude Code 的 skill。
它不是「输入标题、输出文章」的一键生成器。它是一条有纪律的流水线：
每个阶段有它该读的规则，每个产出有它该过的门。你在里面的角色是主笔，不是甲方。
它也不是通用写作助手。它为「中文、长文、要发出去给人读」这个场景做了很多取舍：
排版针对微信公众号的 HTML 限制做了大量妥协，去 AI 味的规则针对中文的套话习惯。
它到底帮你做什么
| 阶段 | 它做什么 | 你做什么 |
|---|
| 选题 | 快评这个题值不值得写、从哪个角度切 | 拍板 |
| 大纲 | 分流开篇、搭骨架，并把材料/来源/断言边界逐节对账 | 改结构 |
| 正文 | 按你的风格手册写，注入你的金句库与声纹样本 | 挑开头（唯一法定停顿点） |
| 改稿 | 三层过滤去 AI 味 | 手改（它会从你的 diff 里学） |
| 标题 | 内联锻造 5 个候选并排序 | 选一个 |
| 排版 | 一键出微信 HTML，契约门把关 | 看一眼 |
| 配图 | 封面 / 信息图 / 数据图（数据图用 matplotlib 画，不让模型编数字） | 提意见 |
去 AI 味的七条核心
不是句式伪装，是内容层的要求：
- 材料先承重 -- 每个核心章节都能指出真实材料；不够就补、缩或停
- 来源不过界 -- 事实、自述、转述、推断和未知分开，先后不冒充因果，结果不冒充动机
- 逐段有新增 -- 每段至少推进事实、动作、例子、区分或后果之一
- So What 按需兑现 -- 读者后果没显现才追问，动作或案例已经说明白就停
- 作者声来自知识路径 -- 写清为什么知道、什么改变了判断、哪里仍不确定，不强塞「我」
- 可信细节会停笔 -- 只用有来源的动作、物件、数字或原话；情绪成立就删解释尾巴
- 句间引力 -- 上句尾留钩子，下句头接住
诚实边界：机器只能硬拦部分表层指纹；句式体检也只是软提示。材料真伪、因果边界和段落新增信息仍靠材料账本、事实复核与异模型语义差分。
开箱效果 vs 喂料后效果
这一节比上面所有内容都重要。
| 你会得到 |
|---|
| 开箱（不配 profile） | 完整的方法论引擎：结构、纪律、去 AI 味过滤、排版工程。产出干净、不像 AI 通稿 |
喂料后（自建 profile/corpus/） | 上面全部，加上你自己的声音 |
不喂料时，产出接近通用 AI 写作 -- 这是设计，不是缺陷。
风格是你的语料长出来的，不是提示词变出来的。这个仓库里没有任何真实作者的风格手册：
那类手册要从别人受版权的作品里蒸馏，不该由我打包分发给你；何况模仿谁本来就该你自己挑。
取而代之的是：
顺带一提：最该做的第一份手册是「你自己」的。把你写得最满意的 20 篇丢进去蒸馏，
出来的手册会告诉你一些你没意识到的自己的习惯 -- 有些值得保留，有些该改。
三条使用路径
按你愿意装多少东西分三档。每一档都能独立用；缺东西只降级那一个环节，不断整链。
① 纯方法论（零门槛）
选题 / 大纲 / 正文 / 改稿 / 标题，全流程可用。
pip install pyyaml
python scripts/setup_check.py # 体检：告诉你能跑到第几档
② + 排版出微信 HTML
加：一键排版、契约门、10 个组件模板。
# 再装：bun（跑 markdown→HTML 转换器）+ Node 18+
cd scripts && npm install # jimp：给配图加水印
③ 全自动到发布
加：配图、封面、信息图、推送草稿箱。
cp .env.example .env # 填你自己的 key
依赖矩阵
| 依赖 | 哪一档要 | 缺了会怎样 | 怎么装 |
|---|
| Python 3.10+ / PyYAML | ① | 全都跑不了 | pip install pyyaml |
| Pillow | ③ | 生图缩放、配图压缩不可用 | pip install pillow |
| Node 18+ / jimp | ② | 配图加不了 logo 水印 | cd scripts && npm install |
宝玉 baoyu-image-gen | ③ 可选 | 历史文章与显式选择的旧链（schema1）无法出图 | 安装 JimLiu/baoyu-skills，provider 配在 ~/.baoyu-skills/；只用它出图，排版与发草稿已内置 |
叁笙生图 sansheng-image | ③ | 新文章默认的画风库链（schema2）无法出图 | 与本 Skill 同级安装，走 Codex 订阅额度；见 references/stylebook-contract.md |
| gcloud ADC（Vertex OAuth） | ③，且选择 Lyria 自动生成时 | Lyria 生成不可用；已用显式 manifest 绑定的网页生成或既有主题曲不受影响 | gcloud auth application-default login + gcloud config set project <P>；Lyria 不用 API Key |
| 微信公众号 appid/secret | ③ | release-to-draft 无法创建并读回草稿 | 写进 ~/.config/sansheng-write/wechat.env（非本仓 .env，权限 600）；后台还需把本机出口 IP 加白名单 |
| playwright / matplotlib | ③ 可选 | 独立精确图表的 SVG 转 PNG、数据图画不了；不用于封面/Hero/信息图补字 | pip install playwright matplotlib |
低档能力可以独立使用；一旦进入“定稿→草稿箱”机械链，配图、BGM、视觉 QA、发布预检和官方读回都是硬门，任一失败都会非零退出。BGM 硬门校验的是 _music-manifest.json 绑定的真实文件与来源，不强迫使用特定厂商：自动生成、网页手工生成和复用既有成品都可走同一合同。封面文字、品牌色、粘土配图方法、必备文字恰好一次与 renderer 都有机器校验；错字只允许同 prompt 单张重渲，不提供 SVG/后期叠字、force、legacy、跳过预检、人工豁免或自定义生图命令。
可选功能（默认全关，不配也能用）
上面三档之外，还有一组一稿多投的延伸模块：把已发布的文章派生到别的平台。
这些默认全部关闭。 你不启用的话，它们不会出现在任何命令的输出里——不报错、不提示、不占用你的注意力。只想写文章的话，这一节可以直接跳过。
| 模块 | 能做什么 | 需要你提供 | 不启用会怎样 |
|---|
| 小红书图文 | 按一个传播命题重编为 6-10 张 3:4 轮播图文，开浏览器填好标题/正文/图，你点「发布」 | 小红书账号 + 一个驱动创作服务平台网页端的发布脚本（自备） | 完全不影响写作与公众号发布 |
| 微博 | 独立生成完整微博正文与 4-9 张 1:1 图片，开浏览器填好，你点「发送」 | 微博账号（发布脚本可自动发现） | 同上 |
| 播客（RSS / 公众号 / 官网） | 把定稿做成双主持音频并复用到 RSS、官网；显式设 wechat_embed: true 后，公众号导读后也会出现与主题曲同级的播客卡 | NotebookLM 登录态、ffmpeg、一台放 mp3 与 feed.xml 的主机（可 SSH）；公众号插入后须在微信预览试听两条音频首尾 | 同上；未显式开启嵌入时公众号保持主题曲单卡 |
| X（Twitter）文章 | 把整篇定稿搬成 X 文章：标题 / 引用 / 列表 / 分割线按块保真，表格降级成列表，竖图垫成 3:4 免裁切，文末自动接网站全文、公众号原文、播客单集链接；建草稿 → 逐块校验（文本 + 块类型 + 空块）→ 预览截图 → 确认后发布 → 回读互动快照 | X Premium 账号、一个已登录 X 的 Chrome（脚本会自动拉起）、playwright | 同上 |
朋友圈文案写入 _moments-copy.md：文件首字符就是 emoji，无标题、代码围栏、前导空白或
附加说明。Agent 在聊天里交付时也必须把它作为独立最终消息原样发送，避免复制时带入杂字。
怎么启用：
python scripts/setup.py # 交互式：问你要哪些，只收集那些模块需要的配置
它只会问你选中的模块所需的东西，已经配好的不会重复问；第二次运行是「改配置」而不是从头再来。检测到非交互环境（CI、管道）时只打印清单、不阻塞。
装了 ruamel.yaml（pip install ruamel.yaml）时会保留注释就地改写你的 profile；没装则不写盘，改为打印配置片段让你自己粘贴——不会默默抹掉你 profile 里的注释。
共同前提：小红书、微博和 X 只在你按篇明确点名时触发，不随正式链接自动执行；两端分别生图，
不复用同一套比例。小红书、微博把内容填进发布框后就停手，最后那下「发布」永远由你点；X 文章在发布前打一张确认卡，只有你回 yes（或显式传 --yes）才发。填错了还能改，发出去收不回来。
安装
# 方式一：Claude Code 插件市场
claude plugin marketplace add sanshengai/sansheng-write
claude plugin install sansheng-write
# 方式二：clone + 软链
git clone https://github.com/sanshengai/sansheng-write.git
ln -s "$(pwd)/sansheng-write" ~/.claude/skills/sansheng-write
国内加速下载
GitHub 直连不畅时，给 clone 地址前面加一层公共镜像即可（下载源码 zip 同理）：
# 加速 clone（把 gh-proxy.com 换成 ghfast.top 即备用镜像）
git clone https://gh-proxy.com/https://github.com/sanshengai/sansheng-write.git
插件市场方式暂无稳定国内镜像；网络不畅时用上面的加速 clone + 软链。
更新
升级到新版，取决于你当初怎么装的：
- 插件市场装的：
claude plugin marketplace update 刷新市场，再 claude plugin update sansheng-write
- clone + 软链装的：进本仓目录
git pull（软链即时生效，不必重装、不必重连）
怎么知道有新版：看本仓 Releases；点仓库右上角 Watch → Custom → Releases，发新版时 GitHub 会通知你。每版改了什么见 CHANGELOG。
快速上手（从 clone 到第一篇）
python scripts/setup_check.py # 1. 体检：告诉你能跑到第几档、还缺什么
cp -r profile.example ~/my-writing-profile # 2. 复制一份 profile
export SANSHENG_WRITE_PROFILE_DIR=~/my-writing-profile
export SANSHENG_WRITE_DATA_DIR=~/my-articles # 3. 文章存哪
export SANSHENG_WRITE_ARCHIVE_DIR=~/article-archive # 全部流程结束后的永久成品根（绝对路径）
$EDITOR ~/my-writing-profile/context.md # 4. 告诉它你是谁（写给谁、怎么说话）
$EDITOR ~/my-writing-profile/brand.yaml # 5. 署名 + 主题 + 身份卡（发公众号才需要）
# 要出微信 HTML（②档）：已内置，无需额外安装；要给配图加 logo 水印再装 Node 18，然后
cd scripts && npm install # jimp 水印
# 要全自动配图/发布（③档）再补：
cp .env.example .env # 填可选 key；微信凭证见依赖矩阵
然后在 Claude Code 里说一句「帮我写一篇关于 X 的文章」。
每一步缺了什么，setup_check.py 都会指出来；缺件只降级对应环节，不断整链。
配置
三层分离 -- 代码在仓里，你的东西在你自己的目录里：
| 层 | 放什么 | 在哪 |
|---|
| ① 仓库 | 代码 + 方法论 | 这里 |
| ② profile | 配色 / 署名 / 身份卡 / 语料（私有但非密） | SANSHENG_WRITE_PROFILE_DIR |
| ③ secrets | API key（只从 env 读，永不打印，报错时打码） | .env（gitignored） |
不配 profile 也能跑 -- 自动回退到仓内 profile.example/（中性配色 + 占位署名）。
这是正常路径，不是错误。
多 worktree 场景不要把路径钉死在 main：.env 中可把 profile、数据目录、
作品库、飞轮与金句库写成 @workspace/...。pipeline.py --dir <文章目录> 会先
绑定承载该文章的 Git 工作树，再解析这些路径；同一进程切到另一棵树时也会重新
求值。非 Git 目录可用绝对路径，或显式配置 SANSHENG_WRITE_WORKSPACE_DIR。
文章先在当前工作树的 SANSHENG_WRITE_DATA_DIR 中生产。所有会继续写该目录的任务结束后，用 pipeline.py --dir <文章目录> physical-archive --delete-source 搬到 SANSHENG_WRITE_ARCHIVE_DIR；永久根必须是已存在的绝对路径，不能写 @workspace。pipeline.py archive 只是作品库登记，handoff-assets 只把上传文件汇齐到文章目录第一层，二者都不会替你完成整篇文件归档。
换主题一行搞定（profile/brand.yaml）：
theme: "sage" # slate 钢青（默认） | ink 近墨黑 | sage 草木绿 | jade 青玉绿 | amber 琥珀赭 | plum 梅子紫
模板里一个 hex 都不用改 -- 排版最后一步由 process_theme() 统一替换。
隐私
- 密钥只从 env /
.env 读，从不打印，报错信息里自动打码。
- 运行观察日志（
_skill-observations.jsonl）只写本地、不联网，
文章名默认写哈希。整个日志可以关：SANSHENG_WRITE_TELEMETRY=off。
- 你的语料、草稿、密钥，不会被发送到任何地方。生图 / 发布是你显式调用时才打对应的 API。
配套文章 · Article
（讲这个 skill 怎么用、以及怎么脱敏开源的公众号文章 -- 写好后补链接）
关于作者 · About the author
我是叁笙，一个用 AI 做内容、也用 AI 造工具的人。我做了个人站「叁笙早安 AI」--
每天清晨一份 AI 早报，加深度长文，还有一堆自己写来自己用的小东西：读书蒸馏、职业 AI 风险测评、
GitHub 宝藏精选、AI 羊毛铺……
这个仓里的 skill，就是我做这些内容时在真实工作流里一点点磨出来的。它写过的每一篇我都亲手改过，
改的地方又回头变成了它的规则。觉得好用，就清洗脱敏开源出来 -- 你可以直接用，也欢迎改成自己的。
如果这些东西对你有用，欢迎来网站逛逛，或扫码关注公众号「叁笙早安AI」
（公众号没有跳转链接，扫码最快）：
致谢与依赖 · Credits & Dependencies
致谢（借鉴来源）
-
baoyu-skills by 宝玉（MIT）--
排版链上游的 markdown→HTML 转换、信息图与发布工具链。本 skill 的排版后处理接在它的产出之后，
skill 的组织方式也从中借鉴颇多。不捆绑分发，请自行安装。
-
gzh-design-skill by 甲木 × 摸鱼小李（AGPL-3.0）--
排版层的重要方法论参照：「文章类型 → 组件配方表」、视觉层级与全文用色配额、封面文案策略
（两层标题分离 / 五视角）、「模板源头 lint + 产物 HTML 校验」双关卡、待补素材居中占位约定，
这些设计思想均借鉴自该项目。仅借鉴思路：本仓的组件 HTML 与校验脚本均为独立实现，
不含其代码或模板。不捆绑分发，两项目互不依赖。
-
WeWrite by oaker-io（MIT）--
「学习我的修改」闭环飞轮的整体设计（lessons → playbook 聚合、pattern 类型划分）、内容增强
四策略框架（角度发现 / 密度强化 / 细节锚定 / 真实体感）与微信兼容微调思路源自该项目；
脚本代码为独立实现。不捆绑分发。
-
humanizer by blader（MIT）--
反 AI 味过滤器中「四种高频 AI 句式」的识别框架来自该项目。
-
x-skills by sergebulaev（MIT）--
反 AI 味过滤器 2026-09 补进的四条句式判据（揭示桥 / 表演式真诚 / 反强制节奏 / 三连留一）、
密度口径与过度矫正三问，以及 X 账号页记分卡、算法信号权重，方法来自其 x-humanizer V3 与
x-profile-optimizer；规则按本 skill 口径独立重写，未复制原文。不捆绑分发。
-
baoyu-post-to-x、x-article-publisher-skill by 王树义、
qiaomu-x-article-publisher by （均 MIT）--
X 文章发布链的三个做法借鉴自它们：整篇粘贴 + 占位符定位插图、上传前压缩、粘贴后按块数稳定判定渲染完成；
为独立实现，未复制其代码。
运行依赖（不捆绑，请自行安装）
| 依赖 | 许可 | 用途 |
|---|
| jimp | MIT | 给配图加 logo 水印 |
| PyYAML | MIT | 配置与作品库读写 |
| Pillow | MIT-CMU | 生图缩放、配图压缩 |
| Playwright | Apache-2.0 | 独立精确图表的 SVG 转 PNG（可选；禁用于生成图补字） |
| matplotlib | PSF-based（BSD 兼容） | 数据图（可选） |
| baoyu-skills | MIT | markdown→HTML / 信息图 / 发布 |
画中文数据图需要中文字体。建议用 OFL 许可的
Noto Sans CJK / 思源黑体，
而不是 Windows 自带的微软雅黑（专有字体）。
License 兼容性
本仓以 MIT 分发。仓内不捆绑任何第三方源码（scripts/node_modules/ 已 gitignore，
由你 npm install 生成）。上表均为运行时依赖，其许可与本仓分发无关，已逐个核对并标注。
用着顺手的话，点个 ⭐ 吧 —— 这是我判断「要不要继续做下去」最直接的信号。
License
MIT © 2026 叁笙 (sansheng)
