◆ SHULING v2.2.0

GITHUB

[ SYS.ONLINE ]SKILL-AS-BRAIN · RUNTIME v2.2.0◆ 7 CORE FLOWS◆ 8 DB TABLES◆ 9 MCP TOOLS◆ 4 AI PLATFORMS[ SYS.ONLINE ]SKILL-AS-BRAIN · RUNTIME v2.2.0◆ 7 CORE FLOWS◆ 8 DB TABLES◆ 9 MCP TOOLS◆ 4 AI PLATFORMS

v2.2.0 "EXISTING CREATOR SUPPORT" · 2026-04-21

让你的 AI 助手

懂小红书的博主搭档

从选题、创作、发布到复盘形成闭环，历史数据驱动自进化，越用越懂你。基于 Skill-as-Brain 架构，一份 SKILL.md 通吃 Hermes / Claude Code / Codex。

INITIATE SEQUENCE ▸ VIEW ON GITHUB

//CORE

核心业务流程

//DATA

SQLite 数据表

//MCP

MCP 工具

//HOSTS

AI 平台支持

◆ SYSTEM.OVERVIEW / 01

这是什么

把你的 AI 助手变成懂小红书的博主搭档——从选题、创作、发布到复盘形成闭环，历史数据驱动自进化。

// PROFILE.NEW

◇

新博主

还没发或刚开始——三问对话建画像，竞品冷启动，每日选题/起稿/发布/复盘全流程。

// PROFILE.EXIST · v2.2.0

◈

老博主（v2.2.0+）

已发 30~1000+ 条——批量导入历史，AI 反推画像，挖掘自己验证有效的 patterns，出账号体检报告。

// PROFILE.DEV

◇

AI 智能体开发者

可借鉴的 Skill-as-Brain 架构、业务路由 §0a、JSON Schema 契约、反模式禁令工程化实践。

⚠ 不是什么

[X]不是小红书自动化工具（没有批量发布、不刷量、不绕风控）
[X]不是内容农场（§5 合规规则兜底，不做标题党 / 同质化）
[X]不是独立运行机器人（必须搭一个能读 SKILL.md 的 AI 助手）
[X]不假设通讯渠道（Telegram / 微信等由 hermes-agent 或你自己配）

◆ CORE.PHILOSOPHY / 02

核心理念

SKILL-AS-BRAIN

业务逻辑全部在 SKILL.md 里，AI 助手读了它就是大脑； scripts/ 只是手脚，负责调 API、读写数据库、生成图片这些 AI 做不了的物理操作。

▸换 AI 平台零成本：只要能读 SKILL.md，hermes / Claude Code / Codex / OpenClaw 都通用
▸改流程不用改代码：改 SKILL.md 即可，版本号 BRAIN+1
▸越用越聪明：每次选择、每条数据都记录到 DB，驱动偏好进化
▸AI 自律工程保障：§0a 业务路由 + §0b 写入校验 + schemas/ + 反模式禁令

~/shuling/arch.map

┌─────────────────────────────────────────┐
│  AI 助手（大脑 / Skill-as-Brain）       │
│                                         │
│  §0a 业务路由 → §0b 平台识别/校验      │
│   ├─ §0c 老博主接入 (v2.2.0+)           │
│   └─ §0/§1 新博主流程                    │
│  → §2/§3/§4 选题/创作/发布/复盘          │
└┬────┬────┬────┬────┬────┬────┬────┬────┘
 │    │    │    │    │    │    │    │
┌▼──┐┌▼──┐┌▼─┐┌▼─┐┌▼──┐┌▼──┐┌▼──┐┌▼──┐
│xhs││db ││img││fet││note││pre││imp││aud│
│.sh││.sh││.py││ch ││rx  ││fli││ort││it │
│MCP││SQL││gen││   ││diag││chk││220││220│
└───┘└───┘└───┘└───┘└────┘└───┘└───┘└───┘

knowledge-base/      schemas/ (契约)
├ profile.json       ├ state.*
├ preferences.json   ├ profile.*
├ patterns.md        ├ preferences.*
├ evolution-log.md   └ audit-report.*
└ audit-YYYY-MM-DD

> runtime: online

◆ CAPABILITY.MATRIX / 03

能力全景

4 个维度，完整覆盖博主运营闭环

◆ 核心业务流程（7 条主线）

新手引导

首次对话 → 建画像 + 环境就绪

02 · NEW

老博主接入

历史导入 + 画像反推 + patterns 种子

选题研究

带偏好加权的候选话题

内容创作

RedInk 双阶段大纲 + 正文 + 标签

图片生成

Gemini → OpenAI → HTML 三路降级

发布

小红书已发帖 + 本地 posts 记录

每日复盘 + 周回顾

日/周报 + patterns 进化 + 五维诊断

全部由 AI 读 SKILL.md 自动编排

◇ 自进化引擎

bayesian-laplace-v1

偏好学习

Laplace 平滑 + 集中度×样本因子 confidence — 小样本不冒进，口味稳时快收敛

≥0.75 → 1 选

选项递减

confidence 驱动：从"每次选几项"退化到"回一个'发'字"

ε-greedy · 7 天

探索机制

距上次探索 ≥7 天追加低 weight 类型，防过拟合，口味可演进

2× "换" → 0.45

"换"信号回弹

连续 2 次"换" → confidence 强制回 0.45，防单方向钻牛角尖

exp → med → high

Pattern 生命周期

标题/结构/图片 prompt 通用：experimental → medium → high / deprecated

≥5% → +0.1 · <2% → -0.1

收藏率驱动

真实数据驱动 patterns/anti-patterns 晋升 / 淘汰，无人为干预

◈ 运维与工程纪律

install.sh 六模式

默认 / --check / --dry-run / --yes / --target / --mode

preflight.py 双模式

AI 可读 JSON + --human 彩色表（退出码分级 0/1/2）

BRAIN.HANDS.CALIB 版本号

三段语义，breaking 只发生在 BRAIN+1

文档四件套

CHANGELOG / UPGRADE / RELEASING / docs/features/

JSON Schema 契约

state/profile/preferences/audit-report，AI 写入前自校验

账号风控

分级节流 + 日限额 v1-conservative，触顶自动拒绝

◆ AI 智能体协作纪律

§0a

业务路由

AI 首动作：preflight → 读 state → 查表决定下一步

§0b

平台识别 + 写入校验

按路径识别 hermes/claude/codex，写入前按 schema 核对

§0c

老博主接入

5 步流程的 additive 分支（v2.2.0+）

§8

异常矩阵

12 种异常场景 × 标准处理

◆ DEPLOY.SEQUENCE / 04

快速开始

根据你的身份选择接入路径

▣ 前置依赖

AI 助手

hermes / Claude Code / Codex / OpenClaw 任选

xiaohongshu-mcp

小红书 MCP 服务（搜索/详情/发布/评论/登录）

Node / Python 3 / sqlite3 / Playwright / jq

截图 / DB / 生图 / JSON

图片生成 API（可选）

Gemini Key（推荐）/ OpenAI Key，未配置则走 HTML 截图

NoteRx API（可选）

五维诊断，配 NOTERX_API_KEY 才启用

▸ 安装

~/shuling/install

# 克隆仓库
$ git clone git@github.com:AI-flower/shuling.git && cd shuling

# 一键安装：自动检测平台 + 依赖预检 + init DB + 生成配置
$ bash install.sh

# 其他模式
$ bash install.sh --check          # 只自检不动手
$ bash install.sh --dry-run        # 预演将做什么
$ SHULING_ASSUME_YES=1 bash install.sh   # CI / 远程非交互

路径 A

◇

新博主：从零起步

01/安装（默认 new，回车）bash install.sh
02/登录小红书：扫码或 Cookie 粘贴（"我给你 cookie：..."）
03/建立画像：对 AI 说"我想做小红书博主"，AI 三问（方向/受众/风格）
04/日常使用："帮我发小红书" / "今天发什么" / "看看昨天的数据"

v2.2.0+

◈

老博主：存量接入

01/老博主模式安装：bash install.sh --mode=existing-creator
02/登录（扫码或 Cookie，同路径 A）
03/对话触发："我已经在运营小红书，帮我接入"
04/AI 按 §0c 自动走 5 步：确认登录 → 导入 200 条 → 自动分类 → 画像反推 → 体检报告
05/完成后系统具备 6 个月+ 历史记忆，第一条发帖即达 P50 水平

手动跑：

$ bash scripts/import-existing.sh --limit 200
$ bash scripts/audit-report.sh --extract-patterns

▸ 日常对话指令

"帮我发小红书"

完整发布流程

"今天发什么"

选题研究

"起个稿子"

创作流程

"看看昨天的数据"

数据复盘

"最近怎么样"

近期小结

"我想换方向"

更新画像

"我给你 cookie..."

Cookie 登录

"复盘"

手动触发复盘

◆ HOST.REGISTRY / 05

部署到 AI 平台

一份 SKILL.md，所有平台产生相同业务行为

Hermes

cron job + prompt: 使用 shuling skill

全自动每日发布 + 复盘

◎

Claude Code

对话 + /loop 8h ...

VS Code 集成，支持定时

◐

Codex

对话触发

手动发布

◉

OpenClaw

兼容 agents/ 规范

通用 agents 兜底

◆ FILE.TREE / 06

架构与目录

一条主线：AI → SKILL.md → scripts/ → DB + knowledge-base

~/shuling · tree

▸ 点击展开

shuling/
├── SKILL.md                         # 大脑剧本（AI 读这个，核心）
├── VERSION                          # 版本号 + BRAIN/HANDS/CALIB 清单
├── CHANGELOG.md / UPGRADE.md / RELEASING.md
├── README.md
├── install.sh                       # 六模式安装脚本 (v2.1.3+)
│
├── config/runtime.env.example
│
├── scripts/                         # ──── Hands 层 ────
│   ├── preflight.py                 # 环境预检
│   ├── db.sh                        # SQLite CRUD (8 表)
│   ├── xhs.sh                       # MCP 统一入口 (9 工具+节流+限额+日志)
│   ├── image.py                     # Gemini / OpenAI 生图
│   ├── screenshot.cjs               # HTML 模板截图 (Playwright 降级)
│   ├── fetch-post-data.sh           # 合并拉 metrics + comments
│   ├── noterx-diagnose.sh           # NoteRx 五维诊断
│   ├── import-existing.sh           # 老博主批量导入 (v2.2.0+)
│   └── audit-report.sh              # 账号体检报告 (v2.2.0+)
│
├── schemas/                         # ──── AI 写入契约 (v2.1.3+) ────
│   ├── state.schema.json
│   ├── profile.schema.json
│   ├── preferences.schema.json
│   └── audit-report.schema.json     # v2.2.0+
│
├── migrations/                      # DB 迁移（幂等）
│   ├── v2.1.1.sh / v2.1.2.sh / v2.1.3.sh
│   └── v2.2.0.sh                    # ALTER posts + CREATE historical_stats
│
├── knowledge-base/                  # ──── 运行时生成（私有） ────
│   ├── profile.json                 # 博主画像
│   ├── preferences.json             # 偏好权重（自进化）
│   ├── patterns.md / anti-patterns.md
│   ├── image-patterns.md / image-anti-*
│   ├── evolution-log.md
│   ├── reviews/<YYYY-W##>.md
│   └── audit-<YYYY-MM-DD>.(md|json) # 老博主体检报告 (v2.2.0+)
│
├── data/xhs.db                      # SQLite 8 表
├── templates/post.html              # 小红书风格 HTML 模板
├── docs/                            # mcp-setup / features/
└── platform/                        # hermes / claude-code / codex