远程 agent 经 apikey 连 Streamable HTTP /mcp 调用的纯 MCP 后台,把小红书发布/账号/cookie/远程登录做成工具,前端交互全交给 agent。
能力(22 个 MCP 工具)
- 管理员 RBAC(8):operator 增删改查+轮换 apikey、按账号二元授权
- 账号(4) / cookie(3,共享一套 cookie,check_cookies 走 Camoufox 验证)
- 发布(4):publish_note 异步入队 + 状态轮询,图文+话题+可选定时
- 插件(1):get_extension_download;系统(2):health/whoami
架构
单进程 FastAPI + FastMCP(3.4.3) + SQLite/Alembic;去 celery/redis 用 asyncio 队列 + DB 状态机(原子占用+在途集合+异常兜底+周期回收);Camoufox 发布,§6.4 七个历史坑逐字保真移植;远程登录交给 chrome 插件(人工过验证→收割 cookie 含 httpOnly→推回后台),服务端零登录代码。
相对源仓的瘦身
110 表→4 表,148 config→18,57 依赖→~14;砍掉笔记采集、AI 内容生成、前端、celery/redis/多租户 JWT。
质量
- 17 个任务全程 TDD + 逐一 review;202 单测绿(1 条发布 e2e 需真号)
- 3 个 opus reviewer 并行终审,抓修 1 Critical(重复发帖竞态)+ 1 安全 IDOR(cookie 越权)+ 5 项
- 无任何"去 AI 水印/洗图/绕检测"代码,图片字节原样上传
上线
见 docs/DEPLOY.md(必设 SECRET_KEY + ROOT_ADMIN_APIKEY,跑 xvfb + run.sh,首跑对真号验证发布/登录链)。