Cerina-Protocol

Cerina协议铸造厂

多代理LangGraph后端+React仪表板，可协同起草、评论和完成CBT练习，并具有强制性的人工批准门。包括MCP服务器暴露、SQLite检查点持久性和Docker化生产设置。

特性

• 代理循环： 起草人→ 安全卫士→ 临床评论家→ 具有迭代限制和自我纠正的主管。
• 共享状态“黑板”： 意图、草稿、安全标志、评论指标、注释、日志、先前版本和存储在SQLite检查指针中的时间戳。
• 循环中的人： 图表停止在 awaiting_human；仪表板允许人类编辑/批准；批准恢复图形以最终确定。
• MCP工具： create_protocol 向MCP客户端（例如Claude Desktop）公开相同的工作流。
• 生产就绪： Docker镜像、CORS控件、基于环境的秘密、健康端点和干净的关注点分离。

回购布局

• backend/ --FastAPI+LangGraph+MCP服务器。
• frontend/ --React/Vite仪表板用于实时协议审查。
• docs/architecture.md --代理拓扑图和注释。

快速入门（Docker，类似于生产环境）

cp env.example .env  # set API keys if desired
docker-compose up --build
# frontend: http://localhost:5173
# backend:  http://localhost:8000/health

本地开发（后端）

cd backend
python -m venv .venv
.venv/Scripts/activate  # or source .venv/bin/activate on mac/linux
pip install -r requirements.txt
uvicorn app.api:app --reload --host 0.0.0.0 --port 8000

本地开发（前端）

cd frontend
npm install
npm run dev -- --host --port 5173
# VITE_API_URL defaults to http://localhost:8000

MCP服务器

cd backend
python -m app.mcp_server
# Configure your MCP client to point to this server; tool name: create_protocol

测试

cd backend && pytest

人在循环中流动

1. 用户在UI中提交意图（POST /api/protocols).
2. LangGraph运行绘图程序→ 安全→ 批评家→ 主管，检查每一步。
3. 主管暂停状态 awaiting_human；UI轮询 /api/protocols/{id} 显示草稿+日志。
4. 人工编辑/批准；UI发送 /approve 或 /feedback.
5. 图形恢复、运行 finalizer，和标记 done.