一个给 AI Agent（Claude Code / Codex / OpenClaw / WorkBuddy 等）用的自媒体内容生产系统。你说「写一篇公众号文章」，它会抓热点、评选题、搜真实素材、按你的人格风格出稿并完成编辑审稿。正文完成后，你可以直接交付，也可以再单独要求配图、排版预览或推送草稿箱。原始正文始终保留；配图会生成独立图片和带图副本。想改就按自己的意思改，再让它「学习我的修改」，下一篇会更像你。

WorkNex 以 wewrite（MIT）为代码基座，融合自有多渠道经验：channels/ 渠道抽象面向全渠道覆盖（本期实现公众号，小红书 / 朋友圈 / 口播与短视频脚本在路线图中），发布约束与降级路径收敛到渠道定义里。

"写一篇公众号文章"
  → 抓热点 → 选题评分 → 文章任务书 → 主张与来源清单
  → 安全内容增强 → 初稿（真实信息锚定 + 风格注入）
  → 编辑判断 → 必要时改稿并复审 → 交付成稿

完成后按需追加：
  ├─ 配封面 / 完整配图 → 图片 + 带图副本
  ├─ 排版预览           → 微信兼容 HTML
  └─ 推到草稿箱         → 明确授权且条件满足后发布

✨ 核心特性

• 一句话完成正文：选题、素材、写作和审稿连续完成；说「交互模式」可在选题或框架处暂停确认。
• 后续动作真正独立：配图、排版、发布都能在文章完成后单独执行；排版和发布不会偷偷触发生图。
• 模块化，one step at a time：主入口 + 10 个独立 skill，只要选题说 /worknex-topic、只要封面说 /worknex-visual、做营销海报说 /worknex-poster，缺前置会自己补齐。
• 写出能直接用的文章：先明确读者问题、核心判断与证据边界，再写初稿；审稿不通过就直接改稿并复审，禁止编造作者经历。
• 7 套写作人格：像选主题一样选文风，从深夜老友到冷静分析师，一行配置切换。
• 越用越像你：编辑飞轮（学习你的修改）+ 范文风格库（SICO 式 few-shot）+ 阅读数据回填反哺选题。
• 18 主题排版引擎：样式全内联、微信兼容修复、暗黑模式；learn-theme 还能从任意公众号文章学习一套新主题。
• 一稿多发：小红书图文 / 抖音口播 / 朋友圈短帖 / 口播稿 / 短视频分镜脚本，内容级真改，检查编辑质量和源稿相似度，支持五旋钮（钩子/情绪/节奏/收尾/口语化）一篇一调。
• 渠道抽象：channels/<平台>/ 定义内容形态、发布约束与降级路径，全渠道扩展不改 skill prompt。

✅ 适合 / ❌ 不适合

✅ 适合：公众号创作者的日常出稿（热点文/干货文/故事文/测评文）· 只想要某个环节的人（选题灵感、封面配图、质量自检、排版发布）· 想把已有文章一稿多发到小红书/抖音 · 想让 AI 逐渐学会自己文风的长期使用者。

❌ 不适合：普通网页/落地页排版（用前端 skill）· PPT/邮件/blog · 非公众号生态的 SEO · 追求组件级设计定制的纯排版需求（可以只用 worknex-publish，但更推荐专门的排版 skill）。

🚀 快速开始

git clone <本仓库地址> ~/worknex_cli
cd ~/worknex_cli && bash install.sh

install.sh 做三件事：装 worknex CLI（uv/pipx，无则回退 venv）、把 10 个 skill 链接到 ~/.claude/skills/ 与 ~/.agents/skills/（检测到 OpenClaw / Codex 时一并链接其 skills 目录）、创建 ~/.worknex/ 状态目录。

也可以让 AI 自己装。对任意 Agent 说一句：

请帮我安装 ~/worknex_cli 这个 skill（跑仓库里的 install.sh）

装好后直接开聊：

你：写一篇公众号文章                → 审过的本地成稿（默认不生图、不发布）
你：完整制作一篇公众号文章          → 成稿 + 配图 + 本地预览
你：推到公众号草稿箱                → 明确授权后才发布
你：今天写什么                      → 只要选题
你：检查一下                        → 生成档案 + 质量自检
你：改写成小红书                    → 多平台改写
你：学习我的修改                    → 编辑飞轮
你：看看有什么主题 / 换成 sspai 主题 → 主题画廊 / 重排版
你：做一个小绿书                    → 图片帖（横滑轮播）
你：更新                            → 升级到最新版

for s in ~/worknex_cli/skills/worknex*; do ln -sfn "$s" ~/.openclaw/skills/$(basename "$s"); done
# Codex 同理，目标换成 ~/.codex/skills/

配置（可选）

cp config.example.yaml ~/.worknex/config.yaml

填入微信公众号 appid/secret（推送需要）和图片 API key（生图需要）。写作不需要这些配置；排版可以直接生成本地 HTML，请求配图但没有图片服务时会输出图片提示词。配了 WORKNEX_WRITER_API_KEY 则正文可交给独立写作模型；实际费用以你使用的服务为准。

⚠️ 自动推草稿箱需要已认证公众号（2025-07 起个人主体/未认证账号无草稿 API 权限）+ 公网 IP 白名单。无权限时一切降级为「本地 HTML 预览 + 人工粘贴」，功能不缺失。

🧩 模块速查

管道的每一段都是独立 skill。每篇文章保存在 ~/.worknex/runs/<任务编号>/，进度可恢复， 多篇同时进行也不会互相覆盖。上午选完题，下午说“继续上次”就能接上。

🏗 架构：三层解耦

设计原则一句话：prompt 负责判断，Python 负责确定性。

skill 目录复制到哪都能用；CLI 与 skill 独立安装升级；换机器只需带走 ~/.worknex/。

🔩 核心能力

✍️ 写作人格

像选排版主题一样选写作风格。在 ~/.worknex/style.yaml 里一行配置：

writing_persona: "midnight-friend"

每个人格定义语气、数据呈现和节奏偏好，但不能覆盖事实和个人材料边界。只有用户在当前任务 明确提供的经历才能写成作者亲历。详见 skills/worknex-write/personas/；自定义人格放 ~/.worknex/personas/。

📝 内容质量

WorkNex 的目标是写出准确、有观点、对读者有用的文章。核心机制：

1. 先定义再写：任务书明确目标读者、真正问题、核心判断、新增价值、反方和适用边界
2. 主张对证据：事实、推断、意见和用户经历分别记录；无法支持的具体主张不进入初稿
3. 安全增强：热点文找有证据的新角度，干货文补行动条件，故事文只用真实材料，对比文给决策条件
4. 编辑门槛：按准确、观点、有用、合声、好读判断；未通过就直接修改并复审，只有通过才生成成稿
5. 谨慎学习：范文只校准结构与节奏；单次人工修改不自动升级为所有文章的硬规则
6. 场景库：热点解读/痛点干货/故事案例/对比测评/复盘经验五个写作场景，各带钩子路线与语气规范
7. 去 AI 味：score 检测项对应定点改写手法（句长交错/段落粉碎/情感微扰），只动表达不动事实

每篇任务保留 brief.yaml、claims.yaml、draft.md、article.md 和 review-report.json，方便追溯“为什么这样写”和初稿到成稿改了多少。完整标准见 docs/content-quality-rubric.md。

🎨 排版引擎

worknex gallery    # 浏览器内预览所有主题（并排对比 + 一键复制）
worknex themes     # 列出主题名称

所有主题均支持微信暗黑模式。全部 18 个主题：装好后 worknex gallery 在浏览器里并排对比 + 一键复制。worknex learn-theme <url> 学到的新主题存在 ~/.worknex/themes/，加载时优先于内置主题。

另有四个排版细节自动处理：产物合规校验（worknex validate，preview/publish 自动跑，拦截会被微信过滤的写法）、粘贴加固（preview 产物自动做 <span leaf> 包裹，复制进编辑器不掉样式；API 发布路径无需）、GIF 角标（动图自动加右上角标签）、H2 章节编号（主题 YAML 设 section_numbering: true 启用）。

:::dialogue
你好，请问这个功能怎么用？
> 很简单，直接在 Markdown 里写就行。
:::

:::timeline
**2024 Q1** 立项启动
**2024 Q3** MVP 上线
:::

:::callout tip
提示框，支持 tip / warning / info / danger。
:::

:::quote
好的排版不是让读者注意到设计，而是让读者忘记设计。
:::

🔧 CLI 独立使用

worknex CLI 不依赖任何 Agent，可以单独当排版/发布/评分工具用：

worknex preview article.md --theme sspai            # Markdown → 微信 HTML 预览
worknex publish article.md --cover cover.png --title "标题"   # 推送草稿箱
worknex image-post p1.jpg p2.jpg -t "周末探店"       # 小绿书/图片帖（横滑轮播）
worknex score article.md --verbose                  # 写作质量评分（11 项检测）
worknex doctor-content --runs 10 --json             # 跨篇模板化体检（缺省扫最近 runs 成稿；高危判定=样本≥5且≥2维度触发，退出码 1；小样本封顶警告）
worknex content-eval --draft draft.md --final article.md --assessment assessment.yaml --json # 编辑结果
worknex hotspots --limit 20                         # 抓热点
worknex hotspots --velocity                         # 热点增速：与上次快照对比，标注上升期（标题规范化匹配，首跑只存基线）
worknex search-articles "AI编程" -n 15 -t 2         # 搜公众号文章（-t 时间过滤，-r 解析直链）
worknex search-articles "AI编程" --engine wechat-node # 外部采集器通道（本机不可用降级回搜狗并提示）
worknex deconstruct <url> --save                    # 爆款结构拆解（六项确定性），--save 入范文库（同 URL 幂等跳过）
worknex geo-score article.md --json                 # AI 搜索可引用性评分（<60 退出码 1）
worknex geo-score --emit-faq article.md             # 抽取 FAQ markdown 块（粘贴进文尾）
worknex geo-track --register article.md             # 登记本号文章标题供引用检测
worknex geo-track "问题" --engine doubao            # AI 引擎引用追踪（需 bsk，缺失退出码 3）
worknex seo --json "AI大模型" "科技股"               # SEO 分析
worknex stats                                       # API 拉阅读数据回填 history（48001 无权限时提示第二通道）
worknex stats --import 后台导出.csv                  # 通道 B：后台导出表格导入（容错表头；xlsx 先转 csv）
worknex stats --channel web                         # 通道 A：bsk 开公众号后台读数据（未登录引导扫码，无 bsk 退出码 3）
worknex stats --channel read                        # 通道 D：bsk 逐平台读创作中心 → 快照（recipe 校准前 fail-closed）
worknex stats --channel read --platform xiaohongshu # 同上，只跑指定平台
worknex stats --advice --json                       # 三级归因复盘：打开率→完读率→互动涨粉（阈值常量可解释）
worknex stats --all --json                          # 跨平台数据聚合表（~/.worknex/stats-platforms/ 手工文件与 read 快照混读）
worknex exemplar article.md / --list                # 范文风格库
worknex fetch-article <url> -o out.md               # 公众号文章 → Markdown
worknex learn-theme <url> --name my-style           # 学排版主题
worknex validate article.html                       # 微信兼容性校验
worknex collect shoot --url <url> --out shot.png    # 网页截图（可 --scroll-to 定位）
worknex collect term --script term.json --out t.png # 终端风格视觉图
worknex collect feishu-write --url <wiki> --file 素材.md --dry-run  # 只看写入计划
worknex collect feishu-write --url <wiki> --file 素材.md --yes --check 关键词1,关键词2  # 写入+校验（幂等短码防重复）
worknex publish-all --file 终稿.md --title "标题" --platforms wechat,xhs,zhihu,toutiao,juejin,csdn \
    --images cover.png,shot1.png --yes   # 多平台发布编排，9 渠道可选（--dry-run 先看计划；发布前自动模板化快检，风险 ≥40 要求显式 --yes，--skip-doctor 跳过）
worknex channels list                               # 渠道清单：驱动/形态/真机验证状态
worknex channels status --check                     # 各平台登录态活体探测（bsk 开窗）
worknex channels login douyin                       # 弹窗人工登录（扫码），成功后验证发布页
worknex diagnose                                    # 环境 + 配置自检
worknex run start/list/resume/show/finish/permission # 独立文章任务、恢复与发布授权
worknex sources add/list                            # 保存和查看事实来源
worknex calendar                                    # 内容日历：本地计划+草稿箱+已发布聚合
worknex calendar add --title "选题" --date 2026-09-10  # 添加发布计划
worknex comments <msg_id>                           # 留言管理：拉评论/精选/回复/删除
worknex idea add "灵感" --score 80                  # 选题池：灵感入库/评分/跟踪
worknex poster --prompt-file prompt.md --platform xhs --slug 招生 --prompt-only --json  # 海报零成本核对（比例/尺寸/费用，不生成）
worknex poster gallery                                # 本地离线浏览海报风格/版式，复制参数与查看 Recipe
worknex poster --prompt-file brief.md --platform xhs --candidates 3 --json  # 零费用输出三种方向配方
python3 scripts/generate_poster_gallery_samples.py --benchmark knowledge # 只预检费用，不生图
python3 scripts/generate_poster_gallery_samples.py --benchmark knowledge --max-total-cost <上限> --yes # 预算内生成本地图鉴样张
worknex poster --prompt-file prompt.md --platform xhs --slug 招生 --max-cost 0.2         # 出单张海报/社媒封面（规划由 worknex-poster skill 完成）
worknex poster --prompt-file prompt.md --reference good基准.png --max-cost 0.2   # 垫图/带图迭代：参考图 + 调整指令 → 新图（images/edits）
worknex poster-compose --background bg.png --spec compose.json --output final.png # 两步法合成：中文文案/Logo 确定性叠加（零费用）
worknex home                                        # 查看状态目录

🔄 工作流程

Step 1  环境检查 + 加载风格（不存在则 Onboard）        ← 主入口 worknex
  ↓
Step 2  热点 + 高频需求 → 历史去重 + 搜索需求 → 选题    ← worknex-topic
  ↓
Step 3  文章任务书 → 主张与来源 → 安全内容增强         ┐
  ↓                                                    ├ worknex-write
Step 4  用户风格与有效学习规则 → 初稿                  ┘
  ↓
Step 5  编辑判断 → 必要时改稿并复审 → 成稿与编辑报告    ← worknex-review
  ↓
Step 6  封存原始正文 → 写入历史                         ← 主入口 worknex

正文完成后，可独立执行：
  ├─ 配封面 / 完整配图                                 ← worknex-visual
  ├─ 微信排版与本地预览                                ← worknex-publish
  └─ 明确授权后推送草稿箱                              ← worknex-publish

默认连续完成正文，但“写一篇”只交付本地成稿。“完整制作”是正文、配图和本地预览三个独立 动作的组合快捷方式；“推到草稿箱”才授予发布权限，而且不会自动生图。已完成文章可以继续 配图、排版或发布，原始正文不被覆盖。每篇文章使用独立任务目录并可恢复（契约见 skills/worknex/references/pipeline-state.md）。

worknex_cli/
├── skills/                   # Prompt 层：11 个自包含 skill（复制即用）
│   ├── worknex/                # 主入口：内容流程编排 + 配图/海报/排版/发布可选路由
│   ├── worknex-style/          # 风格设置 / Onboard（onboard.md、style-template.md、style.example.yaml）
│   ├── worknex-topic/          # 选题（topic-selection.md）
│   ├── worknex-write/          # 任务书 + 主张证据 + 安全增强 + 初稿（personas/ 7 人格…）
│   ├── worknex-review/         # 事实核对 + 改稿复审 + 标题摘要 + 编辑报告
│   ├── worknex-visual/         # 封面 + 必要配图（数量与费用上限）
│   ├── worknex-poster/         # 营销海报/社媒封面：层级/钩子/BASE-E2 提示词 + 出图编排
│   ├── worknex-publish/        # 排版 + 发布 + 主题画廊 + 小绿书（wechat-constraints.md）
│   ├── worknex-learn/          # 学习修改 / 导入范文 / 学排版（learn-edits.md）
│   ├── worknex-stats/          # 文章数据复盘（effect-review.md）
│   └── worknex-rewrite/        # 一源多平台改写（multiplatform-rewrite.md + platforms/ 平台定义）
│
├── channels/                 # 渠道抽象：每平台一个目录（channel.yaml + constraints.md）
│   └── wechat/                 # 本期实现：公众号的内容形态、发布约束与降级路径
│
├── src/worknex/              # Runtime 层：`worknex` CLI（pip 包）
│   ├── cli.py                  # 子命令调度器
│   ├── paths.py                # 状态目录解析（$WORKNEX_HOME → ~/.worknex）
│   ├── commands/               # run / sources / diagnose / score / content-eval / hotspots / search-articles / deconstruct / seo / stats / learn-* / exemplar / fetch-article / llm-write / similarity / build-playbook / collect / poster
│   └── toolkit/                # converter / theme / publisher / wechat_api / image_gen + 18 个内置主题
│
├── pyproject.toml            # CLI 打包定义
├── config.example.yaml       # API 配置模板
├── scripts/                  # 仅开发工具（context_budget 预算门 / gen_star_history 图表）
└── tests/                    # 排版、任务流程、skill/README 契约与上下文预算测试

🗺 渠道路线图

9 渠道已内置于 worknex publish-all（渠道抽象 src/worknex/channels/， 真机校准档案见 src/worknex/channels/README.md）：

浏览器路径均为 prepare/assisted 模式：脚本完成导航/上传/填充，发布按钮 留给人工点击（平台风控红线）。渠道登录态管理用 worknex channels （status --check 活体探测 / login 弹窗扫码）。

后续按需扩展：百家号、微博等，按 channels/ 抽象接入，skill prompt 不改。

⬆️ 升级

对 Agent 说「更新」，或手动：

cd ~/worknex_cli && git pull && bash install.sh

🤝 致谢与贡献

本项目基于 imraywang/wewrite（MIT）改造扩展，感谢原项目的优秀设计。Issue / PR 欢迎。跑 python3 -m pytest tests/ -q 与 python3 scripts/context_budget.py --budget-tokens 15500 保持绿灯（CI 同款检查）。

📄 License

MIT（继承自 wewrite，见 LICENSE）