agent-xiaohongshu-workbench

一个依托 Codex CLI 运行的本地小红书图文内容工作台：从热点研究、笔记拆解、原创文稿和去 AI 味，到品牌配图、完整预览与人工确认发布。

Agent 小红书工作台面向需要持续运营多个图文内容账号的创作者。每个内容账号拥有独立的定位、品牌角色、视觉语言、热点缓存、稿件和故事线；它们共用一个仅用于浏览器研究的执行会话。它不接入第三方模型 API，也不托管账号数据；Codex Agent 在你的本地环境中完成推理和浏览器操作。

工作台界面

截图来自全新的空白工作区，展示账号定位、品牌角色、图文热点、拆解、文稿、配图与发布确认的完整界面；不含任何账号、笔记或发布数据。

分发边界

这个仓库交付的是工作流本身：本地前后端、Agent 编排提示、输出 schema、媒体过滤和发布保护、项目特有的 Skill 副本，以及可复现的依赖清单。它不是一个把操作系统、Node.js、Codex CLI、Chrome、浏览器扩展或模型运行时打包进 Git 的便携包。

因此，另一位用户或 Agent 克隆仓库后，先阅读本 README 与 Agent 配置清单，即可按公开软件的正常安装方式准备运行环境；无需另外寻找本项目的提示词、工作流文件或私有历史素材。

它解决什么问题

小红书图文创作常常卡在“热点很多，但不知道该如何变成符合自己账号调性的原创内容”。这个工作台将过程拆成可检查、可编辑、可暂停的步骤：

1. 新建或切换内容账号；新账号从空白定位开始，独立生成品牌角色和视觉语言。
2. 使用共享的浏览器研究会话，按当前内容账号的垂类定位研究小红书图文热点；热点只缓存给该账号，且只保留已验证媒体类型和互动数据的爆款图文笔记。
3. 给出恰好 5 个可编辑的选题方向，并结合该账号手动标记的已发布主题保持内容故事线连续性。
4. 用一个内置的 Lingzao Skill 拆解热点笔记中可借鉴的标题、信息节奏与表达机制，不复制原文或原图。
5. 生成初稿，再通过内置中文去 AI 味 Skill 形成可编辑终稿。
6. 上传任意本地品牌主体图片（人物、动物、吉祥物、物体、植物或图形），或让 Agent 按账号定位设计品牌主体；由 Agent 锁定可见特征与绘制方式。裁切或局部参考图会扩展为明确标注的品牌延展形态，再生成 6 个可逐张预览的系列形象。
7. 由选题和拆解推荐动态视觉方向，并由用户选择本轮生成 1–6 张配图；卡片文稿、角色动作、预览与发布数量始终一致。
8. 在完整预览中查看文稿和全部配图；每轮产出写入版本化的本地 output/。未绑定发布账号时流程停在确认产出；绑定后才可选择“立即发布”或“暂缓发布”。

这是一套本地 AI Agent 内容工作流，不是小红书官方产品，也不会声称平台数据或发布结果。

工作流

选择 / 新建内容账号
  -> 账号定位（定位、品牌、热点与故事线隔离）
  -> 上传任意品牌主体母版 或 按定位生成品牌角色
  -> 可辨识特征锁与 6 个系列品牌形象
  -> 共享研究会话按本账号垂类检索图文爆款（排除视频与低互动笔记）
  -> 5 个可编辑选题
  -> Lingzao 单一 Skill 热点拆解
  -> 选择 1–6 张配图
  -> 原始文稿
  -> 中文去 AI 味
  -> 动态视觉推荐与品牌角色配图
  -> 完整预览 / 输入修改意见 / 版本化本地输出
  -> 未绑定发布账号：确认产出并结束
  -> 已绑定发布账号：立即发布 或 暂存离开
  -> 手动标记已发布，写入本账号故事线

快速开始

Windows 安装包

Windows x64 用户可从 GitHub Releases 下载 Agent-XHS-Workbench-Setup-*.exe。安装后从开始菜单或桌面启动“Agent 小红书工作台”。它是本地桌面启动器：工作台数据保存到当前 Windows 用户的应用数据目录，不会写入安装包或 GitHub 仓库。

安装包不包含 Codex CLI、Chrome、Browser Bridge 或小红书登录态；首次运行前仍须完成下方的前置条件。需要从源码自行构建时，运行 npm run package:win。

1. 准备前置条件

• Node.js >= 22.13
• 已自行安装并登录的 Codex CLI
• Chrome 及用户自己的小红书登录会话
• OpenCLI Browser Bridge 扩展

Codex CLI 是运行本项目的外部前置条件，不会被打包、上传或随 npm install 安装。请先确保下面命令可执行：

codex --version

2. 安装项目依赖

git clone https://github.com/EthanYoQ/agent-xiaohongshu-workbench.git
cd agent-xiaohongshu-workbench
npm install
npm run setup
npm run dev

打开终端提示的本地地址，默认是 http://127.0.0.1:4173。

npm install 会安装项目需要的 OpenCLI；项目所需的 Lingzao、中文去 AI 味和 OpenCLI 浏览器 Skill 已随仓库包含，无需再克隆其他 Skill 项目。

node_modules 不会被提交到 Git。它属于标准公开依赖的本地安装结果，而不是项目交付物；Python 也不是本项目的运行前置条件。

3. 连接浏览器

首次执行“图文热点检索”或发布前：

1. 在 Chrome 中安装并启用 OpenCLI Browser Bridge 扩展。
2. 用自己的账号登录小红书，保持对应 Chrome 个人资料已打开。
3. 根据扩展提示连接 Browser Bridge；必要时执行 npm exec opencli -- doctor 排查。
4. 回到本地工作台，输入账号定位并开始检索。

工作台不读取、复制或落盘 Cookie、密码和平台 API Key。登录态始终由你的 Chrome 会话管理。

运行模型与推理强度

本项目从本机 PATH 调用 Codex CLI，默认模型为 gpt-5.6-terra。

生图使用 Codex Agent 运行环境提供的内置 image_gen 能力，不需要在本仓库配置模型 API Key；其可用性取决于你的 Codex 环境。

内置依赖与 Skill

完整的来源和许可说明见 THIRD_PARTY_NOTICES.md 与 skills-lock.json。

隐私与发布边界

• 公开仓库从空白工作区启动：不含账号定位、热点 URL、原始笔记、评论、历史文稿、图片、发布记录、浏览器日志或登录信息。
• .data/、output/、public/generated/、public/brand/avatars/ 与 public/brand/actions/ 都是本地运行数据，已被 Git 忽略；不要手动将它们提交。
• 热点研究排除视频、混合媒体、无法确认媒体类型和互动指标缺失的内容；爆款门槛为赞 ≥ 300、藏 ≥ 100 或赞藏合计 ≥ 400，评论数量不能单独使笔记达标，也不读取评论内容。
• 任何发布动作都需要完成配图和文稿预览，并在界面再次确认。
• 发布账号默认未绑定。用户必须自行在当前浏览器会话切换到目标账号、阅读风控提示并明确启用，工作台不保存 Cookie、密码或账号凭据。
• “立即发布”只有拿到可验证的笔记 ID 或 URL 才记为成功；“暂缓发布”只允许点击小红书创作页文字完全一致的“暂存离开”，绝不点击“发布”。
• 故事线只在用户手动标记“已发布”时更新当前内容账号；不会读取评论、同步创作后台或把失败、草稿、结果不明的任务升级为已发布。
• 请遵守小红书平台规则、适用法律以及原始内容的版权边界；将热点拆解用于原创表达，而不是复刻他人的具体作品。

项目结构

.
├─ .agents/skills/                 # 随仓库分发的工作流 Skill
├─ server/                         # 本地 Agent 编排、状态与发布守卫
├─ src/                            # 本地工作台前端
├─ scripts/                        # 媒体探针、图片处理、运行时检查
├─ public/                         # 项目 logo；运行时生成目录被忽略
├─ desktop/                        # Windows 桌面启动器
├─ packages/share-site/            # 可选的静态协作预览站点
├─ docs/seo/                       # 仓库 SEO 元数据与基线记录
└─ test/                           # 核心工作流单元测试

packages/share-site 是不接登录态的可分享演示站点：它只在访问者浏览器本地保存演示编辑，不会代替本地工作台调用 Codex、抓取热点、生成图片或发布。

验证与开发

npm run verify:runtime
npm test
npm run build
npm run build:share
npm run package:win

开源许可

本项目源码使用 MIT License。项目 Logo 由项目发起人提供，仅作为本仓库的识别资产使用。第三方组件和 Skill 的许可不因本项目 MIT 许可而改变。

贡献

欢迎提交可复现的问题、隐私安全改进和工作流优化。请不要在 Issue、PR、测试、截图或提交历史中包含真实账号、Cookie、聊天记录、笔记正文或发布结果。