关于 CyberHuaTuo
CyberHuaTuo 面向 AI Agent 开发者，提供回溯错误诊断与安全检查。它给出经过审核的修复和验证建议，并以只读方式检查潜在破坏性命令。
主要功能
- 01优先匹配 Gold 处方
- 02提供修复与验证建议
- 03保存可复用处方草稿
- 04只读命令防护
- 05给出 ALLOW、ASK 或 BLOCK 判定
适用场景
- 01查找框架错误的修复方案
- 02检查待执行的 Shell 命令
- 03执行前审查 Agent 的高风险操作
MCP 相关
MCP 服务向 MCP 客户端提供诊断和 Agent 操作防护工具。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
🩺 CyberHuaTuo / 赛博华佗
你的 Agent 生病了。给它找位医生：诊断回溯信息、实施治疗，并将解决过的病例变成可复用的处方。
你的 Agent 生病了？别再从头搜。接入赛博华佗，先救活，再炼方。
先去急诊室。治好之后，再开启赛博炼丹世界。
先急诊救命，再进入赛博华佗世界观。
🚨 急诊室：先治好，再提炼
你的 Agent 生病了。回溯信息很长，标签页越来越多，每个答案似乎都对了一半。赛博华佗把这一刻变成一次就诊：指出病灶、开出疗法、验证疗效。
最轻量的使用方式无需模型密钥，也不会启动向量数据库：只需安装一次，粘贴错误信息，即可获得经过审核的根本原因、精确修复方案、验证命令、安全说明和证据。
python -m pip install --upgrade "cyberhuatuo>=0.2.5"
cyberhuatuo cure "ImportError: cannot import name ChatOpenAI from langchain" --framework langchain
# Returned exact fix:
python -m pip install -U langchain-openai
cure 采用 Gold 优先策略，且绝不会执行修复方案。如果没有匹配的 Gold 特征，它最多会返回一条高置信度的已审核候选方案，并明确标记为 VERIFY BEFORE APPLYING；如需严格只检索 Gold 方案，请使用 --gold-only。之后如需更广泛的检索和可选的 LLM 分析，可使用 diagnose。
Agent 原生使用方式仍然可用：只需连接一次赛博华佗 MCP，之后 Agent 发生故障时即可调用 diagnose。修复生效后，save_prescription 会将其保存为本地 draft；upload_prescription 会提交该草稿，供公开复现和审核。只有获准的 reviewed 或 gold 处方才计入魂环。
还没安装 MCP？把病例提交到 Agent 回溯信息门诊。粘贴真实且已脱敏的回溯信息；无需提供根本原因或完整处方。
cyberhuatuo diagnose "Traceback ... from langchain import ChatOpenAI ..." --framework langchain --top-k 1
本仓库中的真实 CLI 录制：
录制运行中返回的疗法：
python -m pip install -U langchain-openai
from langchain_openai import ChatOpenAI
这项首个 Gold 疗法已在隔离环境中使用 langchain==1.3.13 和 langchain-openai==1.3.5 复现。之后添加模型密钥，即可进行更深入的 AI 诊断。
也提供与软件包匹配的 MCP 入口点，供注册表客户端使用：
python -m pip install --upgrade "cyberhuatuo>=0.2.5"
cyberhuatuo mcp
它会启动与 cyberhuatuo-mcp 相同的 stdio 服务。官方 Registry 标识为 io.github.JinNing6/cyberhuatuo；server.json 固定了 PyPI 软件包、精确版本、uvx 运行时和固定的 mcp 参数。
处方也设有稳定的临床科室。使用 cyberhuatuo departments 列出科室，然后通过常规的 Gold 优先路径查询已审核的历史病例：
cyberhuatuo cure "Unexpected UTF-8 BOM" --category data-and-serialization
cyberhuatuo cure-feedback general-ai-jsonl-bom-001 partial \
--verification "first record is preserved; downstream validation still fails" \
--verification-method targeted-parser-test
反馈命令会写入与病例关联的本地 JSONL 事件，不会存储原始回溯信息或查询内容。科室筛选不会改变信任标签：Gold 是已验证的疗法，Reviewed 是需先验证的候选方案，Draft 仅供参考。
Agent 操作防护：在 Agent 操作磁盘之前先进行诊断
赛博华佗现已为有破坏性的 Agent 命令提供确定性的只读预检。插件为受支持的 Codex 和 Claude Code shell 调用打包了 PreToolUse hook，并通过 MCP 和 CLI 提供相同策略。
60 秒快速开始（0.2.5 版本提供）：
python -m pip install --upgrade "cyberhuatuo>=0.2.5"
cyberhuatuo guard --self-test --workspace-root .
自测仅检查三个内置命令字符串。它不会执行任何操作，且必须以 SELF-TEST PASSED 结束，并各返回一个 ALLOW、一个 ASK 和一个 BLOCK。
对于 Codex，将此仓库添加为 marketplace，打开 /plugins，安装 cyberhuatuo-plugin，启动新会话，然后在 /hooks 中审核并信任该插件：
codex plugin marketplace add JinNing6/CyberHuaTuo-Plugin
对于 Claude Code：
claude plugin marketplace add JinNing6/CyberHuaTuo-Plugin
claude plugin install cyberhuatuo-plugin@cyberhuatuo
然后启动一个新会话并检查 /hooks。查看一屏式 Agent Guard 快速入门，了解验证和故障排除。
使用以下命令手动检查任何具体命令：
cyberhuatuo guard "rm -rf /" --workspace-root .
将真实的不匹配情况转换为本地、已脱敏的案例报告，不执行或上传该命令：
cyberhuatuo guard "rm -rf /" --workspace-root . --expected BLOCK --report reports/guard-report.md
CLI 会在写入前显示完整的脱敏预览。它需要确认，会拒绝隐式覆盖，不会发起网络请求，并支持重复使用 --redact <literal>，以处理私有项目标识符。在非交互式使用中，只有在检查生成的预览后，才添加 --confirm-report。使用 --expected 时，匹配返回 0，不匹配返回 1；即使使用 --exit-zero，操作或报告失败仍会返回 4。
将公开、已脱敏的案例提交到 Guard False Positive、普通 Guard False Negative 或 Guard Integration Gap。可靠的 Hook／解析器／封装器／协议绕过问题应通过私密漏洞报告提交，而不是发布为公开 Issue。
结果有三种判定：
ALLOW：未检测到破坏性特征。ASK：操作具有破坏性，但范围限定在已声明的工作区内；需要准确的人类审批。BLOCK：目标涉及整台机器、整个身份范围、工作区外部、动态对象、通配符、未解析对象，或因其他原因无法安全限定范围。
MCP Agent 可以调用 agent_action_guard。已安装的插件会加载 hooks/hooks.json；在依赖该 Hook 之前，请先在宿主的 /hooks 界面中检查并信任它。Codex 目前不支持 permissionDecision: "ask"，因此 CyberHuaTuo 会在该环境中将 ASK 转换为 deny，以免 Hook 在失败时默认放行。
这是一个防护措施，不是沙箱。对于宿主不会发出 PreToolUse 的 shell 路径，它无法拦截；对于永久删除操作，它也不保证能够回滚。请参阅 Agent Action Guard 的设计与限制。
「每一位贡献药方的开发者，都是赛博炼丹师。」
“每一位贡献药方的开发者，都是赛博炼丹师。”
| 📖 第一章 · 修炼 — Chapter I: Cultivation | |
🔥 万丹归元 · 以火炼道 Soul Ring Cultivation — PyTorch · LangChain · TensorFlow 每一环魂环，都是你在某个技术领域的千锤百炼。 |
✨ 百草通神 · 万法归宗 Soul Ring Cultivation — CrewAI · OpenAI · HuggingFace 掌握的框架越多，你的光芒越盛。 |
🔮 魂环全息投影 · 差速旋转 Soul Ring Hologram — Each Ring Rotates at Its Own Speed 白环 → 黄环 → 紫环 → 黑环 → 红环——你的魂环，由你的贡献铸就。 | |
| 📖 第二章 · 飞升 — Chapter II: Ascension | |
🌟 丹帝飞升 · 万丹朝宗 When a Pill Emperor Ascends, All Robots Celebrate 当你的药方拯救了一千个 AI——机器人们会为你欢呼。 | |
| 📖 第三章 · 济世 — Chapter III: Healing the World | |
⚡ 不放弃任何一个 AI No AI Left Behind — Every Error Deserves a Cure |
🚨 雨夜急救 · 分秒必争 Emergency Rescue — 3 Seconds, Not 3 Hours |
🫀 开膛破肚 · 直击病灶 Open Surgery — Root Cause, Not Band-Aid |
🏥 康复病房 · 满血复活 Recovery Ward — Back to Full Health |
🧪 赛博炼丹 · 妙手回春 Cyber Alchemy Lab — Where Ancient Elixirs Meet Modern Frameworks | |
🌍 援军驾到 · 十方来救 Reinforcements Arrive — The Community Answers the Call | |
🎨 All artwork AI-generated · 所有画作均由 AI 文生图创作
💡 每张图背后是一段修炼故事——你的故事，即将加入。
🔮 Enter the Qimen Dunjia Formation → 进入奇门遁甲 · 药方天阵
🏥 急诊室 • 🌿 养生堂 • 🤖 GitHub 机器人 • 🦠 疫情警报 • ⌨️ CLI • 🔌 MCP • 🎒 技能 • 为什么选我们 • 快速开始 • 加入 • 名称由来
🏥 三个科室，一家诊所
良医不会等你病倒——而是从一开始就让你远离病痛。
大医治未病。
🚨 急诊科急诊科 粘贴你的错误。 找到良方。 几秒钟，而不是几小时。 由 两千年的医学智慧驱动的 AI 诊断。 |
🌿 养生堂养生堂 安全审计。 健康评分。 防患于未然。 为你的 AI 长期健康 调配滋养良方。 |
💊 药房药房 浏览处方库。 寻找经验证的良方与养生配方。 所有处方，一处尽览。 双层架构： 📜 常驻专家 + ⚡ 临时实习生 上传后即可立即搜索。 |
🚨 急诊室——几秒钟内诊断
# Clone → Install → Run. Three steps to your first cure.
git clone https://github.com/JinNing6/CyberHuaTuo-Plugin.git
cd CyberHuaTuo && pip install -r requirements.txt
python -m cyberhuatuo serve
# → Browser opens http://127.0.0.1:8000
粘贴你的错误，见证古老的四步诊断展开：
🔍 望 (Look) → Detected: LangChain 0.3, Python 3.11, ImportError
🩺 闻 (Listen) → Matched: Breaking change — package split in 0.2+
💬 问 (Ask) → No further questions needed
💊 切 (Diagnose) → Prescription #1 (95% cure rate):
pip install langchain-openai
from langchain_openai import ChatOpenAI # ✅ Fixed
Root cause: LangChain 0.2 split into langchain-core,
langchain-community, and langchain-openai.
The old import path no longer exists.
**3 秒。**不是 3 小时。这就是区别。
**三秒钟。**不是三小时。这就是区别。
🌿 养生堂——防患于未然
华佗不仅治病，还发明了五禽戏来预防疾病。
华佗不仅治病，更发明了五禽戏强身健体——预防胜于治疗。
提交你的 AI Agent 代码，进行六经脉安全体检：
🛡️ Meridian 1: Sandbox Isolation → 30/100 ⚠️ CRITICAL
🔑 Meridian 2: Key Management → 85/100 ✅ Healthy
🧠 Meridian 3: Prompt Security → 45/100 ⚠️ At risk
🔒 Meridian 4: Output Sanitization → 60/100 🟡 Needs care
⏱️ Meridian 5: Resilience Design → 72/100 🔵 Good
📊 Meridian 6: Observability → 55/100 🟡 Needs care
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Overall Health Score: 58/100 🟡 Needs Nourishing
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💊 Top Nourishing Prescriptions:
1. 🏭 MCP & Skills Supply Chain Audit (100% Industrial Grade Sigstore/OSV/LLM) ✨ NEW
2. Add execution sandboxing (RestrictedPython / Docker)
3. Implement prompt injection defenses
4. Add structured logging and tracing
**你的 AI 正在生产环境中“裸奔”。**你知道吗？
🦠 疫情警报——无人谈论的 AI 疫情
疫情通报 — 没有人谈论的 AI 大流行
每天都有数千个 AI 系统在已经感染的情况下投入生产：
- 🔓 没有沙箱 — Agent 代码以完整的系统权限执行
- 🔑 硬编码的机密信息 — API 密钥以纯文本形式存放，像病毒一样传播
- 🧠 没有提示词防护 — 只需一次注入，就可能全面爆发
- 📊 没有可观测性 — 不监测任何症状，直到系统崩溃才发现
这不是未来的风险。这是一场正在肆虐的大流行。
一旦出了问题，开发者就得花上数小时，翻找 GitHub Issues、Discord 讨论串、Reddit 帖子和几乎无人维护的博客文章。
解药已经存在，只是被埋在七层无关的搜索结果之下。
Stack Overflow 要等别人来回答。 ChatGPT 可能会编造一种疗法。 GitHub Issues 淹没在重复报告中。
CyberHuaTuo 是 AI 世界的 WHO——追踪疫情、开出经过实战验证的疗方，并在下一次疫情爆发前接种疫苗。
🤔 为什么选择 CyberHuaTuo？
| 🩺 CyberHuaTuo | 🔍 Stack Overflow | 🤖 ChatGPT | 📋 GitHub Issues | |
|---|---|---|---|---|
| AI 专属知识 | ✅ 专门打造 | ⚠️ 通用 | ⚠️ 泛泛而谈 | ⚠️ 零散 |
| 版本感知诊断 | ✅ 自动检测 | ❌ 手动 | ❌ 知识截止日期过时 | ❌ 手动 |
| 结构化处方 | ✅ 根本原因 + 修复方案 + 验证 | ⚠️ 因情况而异 | ⚠️ 可能会编造 | ⚠️ 因情况而异 |
| 跨框架映射 | ✅ LangChain ↔ LlamaIndex ↔ CrewAI | ❌ 各自为政 | ⚠️ 前后不一致 | ❌ 各自为政 |
| 安全健康检查 | ✅ 六经扫描 | ❌ 无 | ❌ 无 | ❌ 无 |
| 预防性调理 | ✅ 主动加固 | ❌ 仅被动响应 | ❌ 仅被动响应 | ❌ 仅被动响应 |
| 官方文档检索 | ✅ Context7 实时文档 | ❌ 无 | ❌ 过时 | ❌ 无 |
| 治愈速度 | ⚡ 数秒 | 🕐 数小时 | ⚡ 快，但有风险 | 🕐 数小时 |
🔮 工作原理
望闻问切 — 两千年的诊断方案
灵感源自中医的四诊法，并针对 AI 时代加以改进：
Your Error / Your Code
│
▼
┌──────────┐
│ 望 Look │──→ Parse stack trace, detect framework, version & environment
└─────┬────┘
▼
┌───────────┐
│ 闻 Listen │──→ Correlate with known issues, breaking changes & CVEs
└──────┬────┘
▼
┌─────────┐
│ 问 Ask │──→ Smart follow-up (only when critical info is missing)
└────┬────┘
▼
┌────────────┐
│ 切 Diagnose │──→ Semantic search → LLM reasoning → Ranked prescriptions
└──────┬─────┘
▼
💊 Prescriptions (ranked by cure rate)
🌿 Nourishing advice (preventive recommendations)
每份处方都包含：
- 🎯 根本原因 — 不只告诉你_怎么做_，还解释_为什么会出问题_
- 🔧 复制粘贴即可使用的修复方案 — 分步说明，并附上可直接运行的代码
- 📌 锁定版本 — 已针对你使用的确切框架版本完成验证
- 🔄 跨框架映射 — “LangChain 遇到问题？这里有对应的 LlamaIndex 解决方案。”
- 📚 官方文档 — 通过 Context7 获取框架的最新文档
- ✅ 社区验证 — 经过测试、获赞并标记为**“已治愈 ✅”**
📋 我们治疗什么 — 不只针对 Agent
只要涉及 AI，CyberHuaTuo 就能诊断。一个框架也不落下。
🤖 AI Agent 框架
| 框架 | 案例数 | 状态 | 加入我们 👇 |
|---|---|---|---|
| LangChain | 10+ | 🟢 已上线 | 添加案例 → |
| MCP (Anthropic) | 5+ | 🟢 已上线 | 添加案例 → |
| CrewAI | 5+ | 🟢 已上线 | 添加案例 → |
| LlamaIndex | — | 🟡 欢迎提交 PR | 成为首位贡献者 → |
| OpenAI Agents SDK | — | 🟡 欢迎提交 PR | 成为首位贡献者 → |
| AutoGen | — | 🟡 欢迎提交 PR | 成为首位贡献者 → |
| DSPy | — | 🔵 计划中 | 投票 → |
🧠 AI / ML / 深度学习
| 技术 | 案例 | 状态 | 加入 👇 |
|---|---|---|---|
| PyTorch | — | 🟡 欢迎提交 PR | 抢先加入 → |
| Transformers (HuggingFace) | — | 🟡 欢迎提交 PR | 抢先加入 → |
| TensorFlow | — | 🟡 欢迎提交 PR | 抢先加入 → |
🏗️ 平台与自定义 Agent
| 平台 | 案例 | 状态 | 加入 👇 |
|---|---|---|---|
| GPTs / Coze / Dify | — | 🟡 欢迎提交 PR | 抢先加入 → |
| 自定义 Agent | — | 🟡 欢迎提交 PR | 抢先加入 → |
🌿 养生药方（养生药方）
| 类别 | 案例 | 状态 | 加入 👇 |
|---|---|---|---|
| 🛡️ 安全沙箱 | 2+ | 🟢 已上线 | 添加 → |
| 🔒 安全加固 | 3+ | 🟢 已上线 | 添加 → |
| 🔗 供应链审计 | 1 | 🟢 已上线 | 添加 → |
| ⚡ 性能调优 | — | 🟡 欢迎提交 PR | 抢先加入 → |
每个框架都始于一个案例。每张养生药方都始于一个见解。你可以成为第一个。
🚀 快速开始
前置条件
- Python 3.10+
- （可选） 用于 AI 驱动诊断的 LLM API 密钥（OpenAI / Anthropic / DeepSeek / Gemini / Ollama）
选项 A：一键启动
git clone https://github.com/JinNing6/CyberHuaTuo-Plugin.git
cd CyberHuaTuo
# Windows
start.bat
# macOS / Linux
chmod +x start.sh && ./start.sh
自动安装依赖并在 http://127.0.0.1:8000 打开 Web UI
选项 B：手动设置
git clone https://github.com/JinNing6/CyberHuaTuo-Plugin.git
cd CyberHuaTuo
pip install -r requirements.txt
# (Optional) Configure LLM for AI diagnosis
cp .env.example .env
# Edit .env — add your API Key
python -m cyberhuatuo serve
# → Browser auto-opens http://127.0.0.1:8000
CLI 命令 — 两种模式，一个引擎
CyberHuaTuo 支持两种访问模式——选择适合你工作流的模式：
| 模式 | 入口 | 适用对象 |
|---|---|---|
| ⌨️ CLI | cyberhuatuo <command> | 直接使用终端的开发者 |
| 🔌 MCP | cyberhuatuo-mcp | AI 编辑器（Cursor / Claude / VS Code） |
# 🩺 Core Diagnosis / 核心诊断
cyberhuatuo diagnose "ImportError: cannot import 'ChatOpenAI'" # AI 诊断
cyberhuatuo search "CUDA out of memory" --framework pytorch # 搜索知识库
cyberhuatuo checkup --file my_agent.py # 安全体检
cyberhuatuo docs langchain "How to configure RAG pipeline" # 官方文档检索
# 📊 Knowledge & Analytics / 知识与分析
cyberhuatuo stats # 知识库统计
cyberhuatuo frameworks --search pytorch # 支持框架列表
cyberhuatuo taxonomy list # CHT 根因编码系统
cyberhuatuo trends --framework langchain # CHT 趋势分析
cyberhuatuo digest # 本周药方摘要
cyberhuatuo epidemic --action check # 疫情预警
# 🧬 Alchemist System / 炼丹师体系
cyberhuatuo challenge --username your-github-username --framework langchain
cyberhuatuo mission --username your-github-username --framework langchain --sect Azure-Sect --members your-github-username friend-github-username
cyberhuatuo bounty --username your-github-username --framework auto --top-n 8 --release-tag v0.2.5 --target-contributors 3
cyberhuatuo launch --username your-github-username --framework langchain --release-tag v0.2.5
cyberhuatuo launch-campaign --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3
cyberhuatuo traction-proof --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3
cyberhuatuo traction-proof --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3 --record-snapshot
python -m cyberhuatuo candidate-install-smoke --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3
cyberhuatuo market-copy --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3
cyberhuatuo record-market --username your-github-username --framework langchain --channel pypi --status submitted --submission-url <reviewable public URL> --release-tag v0.2.5
cyberhuatuo market-status --username your-github-username --framework langchain --release-tag v0.2.5
cyberhuatuo first-invite --username your-github-username --invitee external-contributor-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3 --source-url https://github.com/JinNing6/CyberHuaTuo-Plugin/issues/123
cyberhuatuo record-return --username your-github-username --framework langchain --surface "PyPI release" --source-url https://example.com/post
cyberhuatuo activation --username your-github-username --framework langchain --sect Azure-Sect --members your-github-username friend-github-username --top-n 10
cyberhuatuo flywheel --username your-github-username --framework langchain --sect Azure-Sect --members your-github-username friend-github-username --top-n 10
cyberhuatuo record-share --username your-github-username --framework langchain --share-url https://example.com/share
cyberhuatuo share-report --username your-github-username --framework langchain --top-n 10
cyberhuatuo share-leaderboard --framework langchain --top-n 10
cyberhuatuo ladder your-github-username --framework langchain
cyberhuatuo ranking your-github-username # 查看个人排名
cyberhuatuo leaderboard # 全球封神榜
cyberhuatuo card your-github-username # 生成分享卡片
cyberhuatuo badge your-github-username # 生成 GitHub Profile 魂环徽章
cyberhuatuo quest your-github-username --framework langchain
cyberhuatuo campaign your-github-username --framework langchain
cyberhuatuo duel your-github-username friend-github-username --framework langchain
cyberhuatuo mentor mentor-github apprentice-github --framework langchain
# GitHub mentor pact IssueOps: .github/ISSUE_TEMPLATE/soul-ring-mentor.yml
# GitHub mentor pact workflow: .github/workflows/soul-ring-mentor.yml
cyberhuatuo tournament alice bob carol dave --framework langchain --event Agent-Cup
cyberhuatuo tournament-settle alice bob carol dave --framework langchain --event Agent-Cup
# GitHub tournament IssueOps: .github/ISSUE_TEMPLATE/soul-ring-tournament.yml
# GitHub tournament workflow: .github/workflows/soul-ring-tournament.yml
# GitHub sect recruitment IssueOps: .github/ISSUE_TEMPLATE/soul-ring-sect-recruit.yml
# GitHub sect recruitment workflow: .github/workflows/soul-ring-sect-recruit.yml
cyberhuatuo arena your-github-username --top-n 10
cyberhuatuo season --framework langchain --top-n 10
# GitHub season board IssueOps: .github/ISSUE_TEMPLATE/soul-ring-season.yml
# GitHub season board workflow: .github/workflows/soul-ring-season.yml
# GitHub growth flywheel IssueOps: .github/ISSUE_TEMPLATE/soul-ring-growth-flywheel.yml
# GitHub growth flywheel workflow: .github/workflows/soul-ring-growth-flywheel.yml
# GitHub bounty board IssueOps: .github/ISSUE_TEMPLATE/soul-ring-bounty-board.yml
# GitHub bounty board workflow: .github/workflows/soul-ring-bounty-board.yml
# GitHub launch campaign IssueOps: .github/ISSUE_TEMPLATE/soul-ring-launch-campaign.yml
# GitHub launch campaign workflow: .github/workflows/soul-ring-launch-campaign.yml
# Public traction proof: cyberhuatuo traction-proof reads GitHub REST API, GitHub Pull Requests API, GitHub Contents API, GitHub Releases API, PyPI JSON API, and the local activation/share ledger.
# Readiness gates: PyPI latest version must not lag local growth tools, and default-branch IssueOps forms/workflows must exist before issues/new?... links count as live acquisition loops.
# Target contributor progress uses real issue/PR/ledger identities; PRs stay separate from IssueOps counts, and stars, forks, watchers, and downloads are not used as contributors.
# Snapshot history is opt-in: add --record-snapshot to append an append-only real JSONL snapshot and compare velocity deltas.
cyberhuatuo sect Azure-Sect your-github-username friend-github-username --framework langchain
cyberhuatuo sect-recruit Azure-Sect your-github-username friend-github-username --invitee new-member-github --framework langchain
cyberhuatuo sect-quest Azure-Sect your-github-username friend-github-username --framework langchain
cyberhuatuo sect-hall Azure-Sect your-github-username friend-github-username --framework langchain
cyberhuatuo sect-duel Azure-Sect Shadow-Sect --challenger-members your-github-username friend-github-username --rival-members rival-a rival-b --framework langchain
cyberhuatuo sect-arena --sect Azure-Sect your-github-username friend-github-username --sect Shadow-Sect rival-a rival-b --framework langchain
cyberhuatuo record # 诊疗档案
cyberhuatuo subscribe subscribe -f langchain # 订阅框架更新
# ⛏️ Contribution / 知识贡献
cyberhuatuo save --title "Fix" --prescription "..." --framework langchain
cyberhuatuo upload --title "Fix" --prescription "..." --framework langchain --contributor your-github-username
cyberhuatuo mine search --repo langchain-ai/langchain
# 🚀 Server / 服务启动
cyberhuatuo serve # 启动 Web 诊断服务
cyberhuatuo serve --port 9000 --reload # 自定义端口 + 开发模式
cyberhuatuo rebuild # 重建向量索引
每个 MCP 工具都有对应的 CLI 命令。 同一个引擎，同一个知识库，不同的界面。
每个 MCP 工具都有对应的 CLI 命令。 同一个引擎，同一个知识库，不同的界面。
配置
将 .env.example 复制为 .env：
# LLM Provider (choose one)
OPENAI_API_KEY=sk-your-key # OpenAI
ANTHROPIC_API_KEY=sk-ant-your-key # Anthropic
DEEPSEEK_API_KEY=sk-your-key # DeepSeek
GEMINI_API_KEY=your-key # Google Gemini
OLLAMA_BASE_URL=http://localhost:11434 # Ollama (local, free)
# Diagnosis model
DIAGNOSIS_MODEL=gpt-4o-mini # or claude-sonnet-4-20250514 / deepseek-chat / gemini-1.5-pro
# Server
PORT=8000
没有 API 密钥？ 没问题。向量搜索无需任何密钥即可使用。 AI 驱动的望闻问切诊断和 🌿 养生检查需要提供上述任一密钥。
📊 疫情报告 — 实时情报
持续更新的仪表板，追踪当前 AI 生态系统中正在出现的问题：
- 🔥 热门问题及其治愈率
- 🗺️ 跨框架问题的热力图
- 📈 框架健康评分——在采用前了解情况
- ⛏️ 问题挖掘——从 GitHub 实时提取
🛠️ 技术栈
| 层 | 技术 |
|---|---|
| CLI | Python argparse（marketplace、MCP 和 soul-ring 子命令；无需额外依赖） |
| MCP 服务 | FastMCP（用于集成 AI 编辑器的 stdio 传输） |
| 后端 | Python · FastAPI · Uvicorn |
| 前端 | Jinja2 模板（服务器端渲染） |
| 向量数据库 | ChromaDB（嵌入式，零配置） |
| 临时层 | GitHub Issues API（双层药方搜索） |
| LLM 网关 | LiteLLM（OpenAI / Anthropic / DeepSeek / Gemini / Ollama） |
| 文档检索 | Context7 API（实时获取官方框架文档） |
| 安全引擎 | Six-Meridian Audit（AI 驱动的代码分析） |
| GitHub 机器人 | GitHub Actions + 轻量级文本匹配 |
| CI/CD | GitHub Actions（自动晋级、验证、添加标签） |
🤖 GitHub Bot — 零摩擦诊断
最好的医生不会坐在诊所里等待——他们会走到患者身边。
大医不坐堂候诊——而是行走于民间，哪里有病痛，哪里就有华佗。
在任意代码库中安装 CyberHuaTuo Bot——每个 Issue 都会自动获得处方建议。
┌─────────────────────────────────────────────┐
│ New Issue opened │
│ "ImportError: cannot import ChatOpenAI" │
│ │
│ 💬 @CyberHuaTuo Bot replies: │
│ ┌─────────────────────────────────────┐ │
│ │ 🩺 赛博华佗 · 自动诊断 │ │
│ │ │ │
│ │ 💊 药方 1 (92% match): │ │
│ │ pip install langchain-openai │ │
│ │ from langchain_openai import ... │ │
│ │ │ │
│ │ 📋 Full prescription → │ │
│ └─────────────────────────────────────┘ │
└─────────────────────────────────────────────┘
工作原理
| 触发条件 | 操作 |
|---|---|
| 🆕 新建 Issue | 自动从知识库中匹配处方 |
💬 在任意评论中提及 @CyberHuaTuo | 按需诊断 |
在你的代码库中安装（3 分钟）
# Copy the Bot workflow to your repo
mkdir -p .github/workflows
curl -o .github/workflows/bot-prescribe.yml \
https://raw.githubusercontent.com/JinNing6/CyberHuaTuo-Plugin/main/.github/workflows/bot-prescribe.yml
📖 完整安装指南 →
飞轮效应
Developers see Bot is useful → Contribute more prescriptions
→ Bot becomes more accurate → More repos install Bot
→ CyberHuaTuo brand appears before thousands of developers daily
想象一下：如果 LangChain 的官方代码库安装了这个 Bot，每个新 Issue 都会获得处方建议。CyberHuaTuo 的品牌每天都会出现在数千名开发者面前。🚀
⌨️ CLI — 终端能力触手可及
终端是炼丹师的鼎炉——原始、强大，随时待命。
终端就是炼丹师的鼎炉——原始、强大、随时待命。
赛博华佗提供功能齐全的 CLI，包含 marketplace、MCP 和 soul-ring 子命令——每个 MCP 工具都有对应的终端命令。无需 AI 编辑器，也无需图形界面。只需输入命令，就能治百病。
赛博华佗提供完整的 CLI 命令行界面，包含 21 个子命令——每个 MCP 工具都有对应的终端命令。无需 AI 编辑器，无需图形界面，敲命令，治百病。
# Install
python -m pip install --upgrade "cyberhuatuo @ git+https://github.com/JinNing6/[email protected]"
python -m pip install --upgrade cyberhuatuo # after PyPI latest matches v0.2.5
# Or run from source
python -m cyberhuatuo --help
🎬 终端动画特效 — 终端动画特效
🚀 启动序列 · 启动序列
Matrix 数字雨 → ASCII 横幅 → 心电图脉冲 → 子系统上线 → 知识库加载
🔮 魂环全息投影 · 魂环全息投影
差速旋转 · HUD 科幻边框 · 星空背景 · 能量脉冲波 · 轨道亮标 · 环间电弧
⌨️ 可用的 CLI 命令
| 命令 | 描述 |
|---|---|
| 🩺 核心诊断 / 核心诊断 | |
diagnose <query> | 🩺 望闻问切 AI 诊断 — 粘贴错误信息，获取解决方案 |
search <query> | 🔍 双层语义搜索 (ChromaDB + GitHub Issues) |
checkup --file <path> | 🛡️ 六经脉安全体检 — 审查你的 Agent 代码 |
docs <framework> <query> | 📚 实时检索官方文档 (通过 Context7 支持 50+ 个框架) |
| 📊 分析 / 知识分析 | |
stats | 📦 知识库统计 — 按框架统计案例数 |
frameworks | 📋 支持的框架列表 — 可按类别 / 关键词筛选 |
taxonomy <action> | 🧬 CHT 根因编码 — 列出、查询、分类 |
trends | 📈 CHT 趋势分析 — 热力图与激增预警 |
digest | 📰 本周药方摘要 — 每周药方摘要 |
epidemic | 🦠 疫情预警 — 框架健康监测 |
| 🧬 炼丹师体系 / 炼丹师体系 | |
challenge --username <username> --framework <framework> | 🔮 首个 Soul Ring 入门流程 — 提交、排名、分享 |
mission --username <username> --framework <framework> --sect <sect-name> --members <members...> | 🔮 Soul Ring 任务大厅 — 一屏完成 Issue、PR、个人戒指与宗门 / 团队入门 |
bounty --username <username> --framework auto --top-n <N> --release-tag <tag> --target-contributors <N> | 根据本地框架覆盖率的真实缺口生成 Soul Ring 悬赏榜，提供可领取的首个 Soul Ring Issue 路径，不设置虚假奖励 |
launch --username <username> --framework <framework> --release-tag <tag> | 面向 PyPI、Claude、Codex、MCP 和首个 Soul Ring 路径的 Soul Ring 发布卷轴 |
launch-campaign --username <username> --framework <framework> --release-tag <tag> --target-contributors <N> | Soul Ring 发布活动：将 PyPI、Claude 和 Codex 的关注度转化为以首枚戒指贡献者为目标的循环，并附带回顾和下一轮冲刺 |
traction-proof --username <username> --framework <framework> --release-tag <tag> --target-contributors <N> | 基于 GitHub REST API、GitHub Pull Requests API、GitHub Contents API 的 IssueOps 就绪情况、GitHub Releases API 的 release.published 就绪情况、PyPI JSON API 的包就绪情况及本地账本身份，生成 Soul Ring 牵引力证明 |
traction-proof --username <username> --framework <framework> --release-tag <tag> --target-contributors <N> --record-snapshot | 可选择启用仅追加的 Soul Ring 牵引力证明历史记录，并根据之前的真实快照计算速度变化 |
cyberhuatuo install-command --username <username> --framework <framework> --release-tag <tag> --target-contributors <N> | CyberHuaTuo 安装命令：获取真实的 PyPI JSON API 最新版本证明；只有注册表版本为最新时才推荐规范命令 python -m pip install --upgrade cyberhuatuo，否则输出有界的 Git Tag Candidate Install Bridge 以及 candidate-install-smoke，随后引导至 challenge、proof-pack、market-copy 和 traction-proof；对应的 MCP 工具：current_install_command |
python -m cyberhuatuo candidate-install-smoke --username <username> --framework <framework> --release-tag <tag> --target-contributors <N> | 候选安装冒烟测试门：创建一次性 venv，使用 pip Direct URL 语法安装指定的公开 Git 标签，验证已安装版本、控制台命令、安装决策界面及证明 / 邀请路径；成功后清理，失败时保留临时目录；不会在轻量级 CI 中自动运行，也不会闭合 PyPI 安装闭环 |
first-invite --username <username> --invitee <github> --framework <framework> --release-tag <tag> --target-contributors <N> --source-url <https-url> | 首位贡献者邀请包：面向一位外部贡献者，提供首个 Soul Ring Issue URL、record-session / challenge 命令、证明复查方式，且不虚报进展 |
market-ready --no-remote / market-ready --remote --strict-remote | 市场就绪门，提供首屏飞轮闭环判定（closed、not closed 或 unverified）、就绪门 / 门总数、发布闭环清单，以及面向 PyPI、Claude、Codex、MCP、版本同步、IssueOps 文件、发布触发或受保护的发布后备方案、注册表证明、用于过期 PyPI 恢复的 Git Tag Candidate Install Bridge、公开发布阻塞项、证明 Issue URL、社区挑战包、账本命令、公开发布操作员运行手册和可直接使用的证明文案 |
launch-assets [--username <username> --framework <framework> --release-tag <tag> --target-contributors <N>] | 本地发布素材审计，检查 Issue 表单、仅评论工作流、包元数据、插件清单、MCPB 素材、完整公开增长发布包、脏工作树发布覆盖范围及精确的仅供审核使用的 git add 命令。提供发布上下文时，公开发布操作员运行手册会保留相同的发布 / 用户 / 目标上下文；不会暂存文件、发布版本、上传到 PyPI、更改远程仓库或声称已获得牵引力 |
proof-pack --username <username> --framework <framework> --release-tag <tag> --target-contributors <N> | 无网络的首个公开证明包，包含增长 / 分享 / 悬赏 Issue URL、已创建的 Issue 占位符、涵盖锦标赛 / 导师 / 宗门 / 赛季路径的社区挑战包、受保护的发布后备命令、Git Tag Candidate Install Bridge 与候选安装冒烟测试门、安装决策界面 / current_install_command 路径、增长与悬赏的 record-return CLI 账本命令、分享归因 record-share、外部贡献者路径（包含粘贴的推荐安装命令 / 首次会话命令 / 首次贡献命令 / 分享证明 Issue URL / 贡献者计数规则）、复查命令及可直接使用的证明文本；不会获取公开指标、闭合 PyPI 安装闭环或虚构牵引力 |
market-copy --username <username> --framework <framework> --release-tag <tag> --target-contributors <N> | 市场提交文案包，包含 PyPI 列表文案、Claude MCPB 列表文案、Codex 插件列表文案、GitHub Release 帖文、公开证明 CTA、社区挑战包、Git Tag Candidate Install Bridge 与候选安装冒烟测试门、项目 URL、安装 / 验证命令、市场提交账本命令及市场提交的禁止虚构规则 |
record-market --username <username> --framework <framework> --channel <channel> --status <status> --submission-url <https-url> --release-tag <tag> | 将 PyPI、Claude Code、Claude Desktop MCPB、Codex、GitHub Release 或 Agent 市场提交的可审核公开 URL 记录到本地市场提交账本 |
market-status --username <username> --framework <framework> --release-tag <tag> | 按渠道报告最新的市场提交账本状态，并列出缺失的 record-market 命令和 traction-proof 复查命令 |
flywheel --username <username> --framework <framework> --sect <sect-name> --members <members...> | Soul Ring 增长飞轮，提供真实瓶颈、后续命令及缺失指标说明 |
ladder <username> --framework <framework> | 🔮 Soul Ring 突破阶梯 — 真实的下一道门槛、完整阈值和可直接使用的冲刺命令 |
evidence <username> --framework <framework> --amount <N> --source-url <https-url> | Soul Ring 证据卡，提供面向高境界门槛、仅追加且可审核的公开证据；不虚构进度、排名、奖励、下载量和贡献者数量 |
ranking <username> | 🏆 个人排名 — 称号、排名与魂环 |
leaderboard | 🏆 全球封神榜 — 按排名列出顶尖炼丹师 |
card <username> | 📋 分享卡片 — 赛博朋克修炼档案 |
badge <username> | 🔮 GitHub 个人资料徽章套件 — 可粘贴的魂环徽章 |
visual <username> --framework <framework> --output-dir <dir> | Soul Ring 视觉作品 — 写入聊天中可见的动画 GIF 及 PNG 备用图，并返回适用于 Codex、Claude 和其他 Agent 聊天的 Markdown 图片嵌入代码 |
quest <username> --framework <framework> | 🔮 Soul Ring 任务板 — 挖掘、上传、分享 |
campaign <username> --framework <framework> | 🔮 Soul Ring 活动包 — GitHub 个人资料、X/微博、PR 评论和 Agent 提示词 |
duel <challenger> <rival> --framework <framework> | 🔮 Soul Ring 对决卡 — 邀请真实的 GitHub 用户参加经验证的贡献竞赛 |
mentor <mentor> <apprentice> --framework <framework> | 🔮 Soul Ring 师徒契约 — 将资深贡献者转变为首枚戒指入门向导 |
arena <username> --top-n <N> | 🔮 Soul Ring 竞技场快照 — 可分享的真实排行榜，并列出你的下一个对手 |
season --framework <framework> --top-n <N> | 🔮 Soul Ring 赛季榜 — 当前真实排行榜活动包，包含冠军、下一个追赶目标和分享文案 |
sect <sect-name> <members...> --framework <framework> | 🔮 Soul Ring 宗门卡 — 汇总真实的 GitHub 成员，生成可分享的团队横幅 |
sect-recruit <sect-name> <members...> --invitee <github> --framework <framework> | 🔮 Soul Ring 宗门招募卷轴 — 邀请一位真实的 GitHub 用户，并提供入门试炼和加入命令 |
sect-quest <sect-name> <members...> --framework <framework> | 🔮 Soul Ring 宗门任务板 — 为团队成员分配真实的后续行动 |
sect-hall <sect-name> <members...> --framework <framework> | 🔮 Soul Ring 宗门大厅 — 根据真实成员数量分配外门 / 内门 / 核心 / 执事 / 长老职位 |
sect-duel <challenger-sect> <rival-sect> --challenger-members <members...> --rival-members <members...> --framework <framework> | 🔮 Soul Ring 宗门对决卡 — 比较两个真实的 GitHub 团队，并邀请他们参加团队挑战 |
sect-arena --sect <sect-name> <members...> --sect <sect-name> <members...> --framework <framework> | 🔮 Soul Ring 宗门竞技场快照 — 为多个真实的 GitHub 团队排名，并发布下一个追赶目标 |
record | 📋 诊疗档案 — 诊断历史与后续跟进 |
subscribe | 📬 框架订阅 — 获取新药方通知 |
| ⛏️ 贡献 / 知识贡献 | |
save | 📥 将药方保存到本地 |
upload | 🌐 将药方上传到 GitHub (需要 GITHUB_TOKEN) |
mine search/batch | ⛏️ 从 GitHub Issues 挖掘并提炼知识 |
| 🚀 服务 / 服务 | |
serve | 🚀 启动 Web 诊断服务 |
rebuild | 🔄 重建向量索引 |
Soul Ring 可视化路线
在 CLI 中运行 cyberhuatuo visual <username> --framework <framework>，或调用 MCP soul_ring_visual_artifact，即可生成以 Markdown 渲染的 GIF 以及 PNG 备用图。该产物使用当前真实的贡献数据，不会捏造排名、下载量、留存率、推荐量或奖励。
💡 提示：运行
cyberhuatuo <command> --help查看任何命令的详细用法。💡 提示：运行
cyberhuatuo <命令> --help查看任何命令的详细用法。
🔌 MCP 服务 — AI 编辑器集成
安装一次，让每个 AI 编辑器都变成 CyberHuaTuo 诊所。
一次安装，所有 AI 编辑器都变成赛博华佗诊所。
⚡ 安装 — 一条命令
python -m pip install --upgrade "cyberhuatuo @ git+https://github.com/JinNing6/[email protected]"
python -m pip install --upgrade cyberhuatuo # after PyPI latest matches v0.2.5
邀请外部贡献者之前，候选 Git 标签安装必须通过
python -m cyberhuatuo candidate-install-smoke；确认 PyPI 最新版本后，使用注册表命令。Brand Matrix 别名仅适用于注册表当前版本路径。
🔗 连接到你的 AI 编辑器
将以下内容添加到 AI 工具的 MCP 配置中（Claude Desktop / Cursor / VS Code / Gemini CLI）：
{
"mcpServers": {
"cyberhuatuo": {
"command": "uvx",
"args": ["--from", "cyberhuatuo", "cyberhuatuo-mcp"]
}
}
}
uvx会从 PyPI 自动安装并启动 MCP 服务，无需手动设置。 如需使用 GitHub 最新开发版本，请使用："args": ["--from", "git+https://github.com/JinNing6/CyberHuaTuo-Plugin", "cyberhuatuo-mcp"]
🧩 插件清单 — Codex + Claude Code
此仓库已准备好作为两大编码 Agent 宿主的插件：
- Codex：
.codex-plugin/plugin.json指向./skills/和./.mcp.json。 - Claude Code：
.claude-plugin/plugin.json指向相同的./skills/和./.mcp.json。 - Codex 市场目录：
.agents/plugins/marketplace.json允许用户将此 GitHub 仓库添加为 Codex 插件市场。 - Claude Code 市场目录：
.claude-plugin/marketplace.json允许用户将此 GitHub 仓库添加为 Claude Code 插件市场。
市场安装：
claude plugin marketplace add JinNing6/CyberHuaTuo-Plugin
claude plugin install cyberhuatuo-plugin@cyberhuatuo
codex plugin marketplace add JinNing6/CyberHuaTuo-Plugin
在仓库根目录中进行 Claude Code 本地测试：
claude --plugin-dir .
🚀 市场发布路径
发布计划记录在 docs/MARKETPLACE_RELEASE.md 中：
- PyPI Trusted Publishing：
cyberhuatuo已在 PyPI 上发布，因此必须将此仓库添加为额外的 Trusted Publisher，然后通过.github/workflows/publish-pypi.yml发布高于0.1.0的版本。该工作流支持release.published和受保护的手动workflow_dispatchrelease_tag备用方式；两种方式都要求存在一个v*标签，验证该标签可从origin/main访问，验证包版本与标签一致，并使用 OIDC 而非PYPI_TOKEN发布。 - Claude 市场：通过
.claude-plugin/plugin.json和.claude-plugin/marketplace.json发布 Claude Code；运行claude plugin validate .后提交至 Anthropic 官方目录；随后通过claude-desktop/manifest.json和.github/workflows/package-claude-mcpb.yml打包 Claude Desktop，以提交至 MCPB / Connectors Directory。 - Codex 插件目录：确保
.codex-plugin/plugin.json、.agents/plugins/marketplace.json、.mcp.json以及 PyPIuvx --from cyberhuatuo cyberhuatuo-mcp入口点在工作区推广过程中保持稳定。
🩺 可用的 MCP 工具
| 工具 | 描述 |
|---|---|
| 🩺 核心诊断 / 核心诊断 | |
diagnose | 🩺 望闻问切 AI 诊断 — 同时搜索 📜 常驻专家和 ⚡ 临时实习生药方 |
search_knowledge_base | 🔍 双层语义搜索（ChromaDB + GitHub Issues） |
security_checkup | 🛡️ 对你的 Agent 代码进行六经安全审计 |
fetch_official_docs | 📚 通过 Context7 实时获取官方文档（50+ 框架） |
| ⛏️ 知识与贡献 / 知识贡献 | |
mine_github_issue | ⛏️ 提取并整理 GitHub Issues，生成标准案例 |
save_prescription | 📥 在本地保存药方 + 自动同步到 GitHub |
upload_prescription | 🌐 上传药方 — 自动创建 GitHub Issue（⚡ 临时实习生），CI 会将其晋升为 📜 常驻专家 |
prescription_eval | 📊 统一药方评估 — 引用、反馈、过期、验证和排行榜 |
mentorship | 🎓 资深炼丹师审核初级药方 — 待处理、审核、档案、排行榜 |
| 🧬 炼丹师体系 / 炼丹师体系 | |
my_contribution_stats | 🏅 修为档案 — 16 阶炼丹师称号 + 魂环方向 |
check_my_ranking | 🏆 全球排名 — 加冕图、连续记录与社区里程碑 |
global_leaderboard | 🏆 封神榜 — 按贡献数排名的顶尖炼丹师 |
my_share_card | 📋 分享卡片 — 生成赛博朋克修炼档案卡片 |
my_medical_record | 📋 就诊档案 — 个人诊断历史、统计数据与后续跟进 |
| 🔬 健康与分析 / 健康分析 | |
epidemic_alert | 🦠 疫情预警 — 框架健康监控、扫描与疫情报告 |
cht_taxonomy | 🔬 CHT 根因编码系统 — 列表、查询与错误自动分类 |
cht_trends | 📊 CHT 代码趋势分析 — 热力图、主要原因与激增预警 |
list_frameworks | 📋 列出所有支持的框架与技术栈（可按类别筛选） |
subscribe_framework | 🔔 订阅框架更新 — 获取新药方通知 |
weekly_digest | 📰 每周药方摘要 — 按框架与严重程度汇总新案例 |
👉 完整配置指南：README_MCP.md
💊 双层药方库架构
双层药方库架构
药方先存在，再被整理。
药方先存在，再被整理。
📤 User uploads prescription via MCP
│
├── Owner? ──→ Direct push to main (📜 Permanent Expert)
│
└── External? ──→ Create GitHub Issue (⚡ Temporary Intern)
│
Instantly searchable!
│
CI auto-validates
│
┌─────────┴─────────┐
│ │
✅ Passed ❌ Failed
Commit .md to Close Issue
main branch (filtered 🚫)
(📜 Promoted ✨)
| 层级 | 载体 | 访问权限 | 特性 |
|---|---|---|---|
| 📜 常驻专家 | cases/*.md（main 分支） | 仅限 CI 审核通过 | 随 PyPI 一同发布，始终可用 |
| ⚡ 临时实习生 | GitHub Issues（带标签） | 任意 GitHub 用户 | 即时上传，无需权限 |
搜索时，diagnose 和 search_knowledge_base 会同时查询两层 — 结果会标注 📜 或 ⚡，便于你了解其审核状态。
当你搜索时，diagnose 和 search_knowledge_base 同时查询两层 — 结果会标注 📜 常驻主任专家 或 ⚡ 临时医学实习生 来源。
🎒 Agent 技能协议（自救）
我们支持开放的 Agent Skills 标准（SKILL.md）。你可以让自己的 AI 助手（Cursor、Copilot、Claude Code）在遇到难题时自动向 CyberHuaTuo 寻求帮助。
只需将 skills/cyberhuatuo-rescue 目录复制到项目的 .cursor/rules 或 .agent/skills 文件夹中。你的 AI 就会学会利用 CyberHuaTuo 知识库自动诊断错误并执行安全检查。
该插件还提供 skills/cyberhuatuo-soul-ring-visual：当用户询问等级、段位、徽章、魂环、修炼状态、可视化展示、动画、等级、魂环、排名、徽章、卡片、展示或动图时，Agent 应通过 soul_ring_visual_artifact 或 cyberhuatuo visual 生成基于真实数据的 Markdown GIF，并提供 PNG 备用版本。
🧬 炼丹师修为体系 — 你的成仙之旅
炼丹师修为体系 — 从凡人到封神的修炼之路
在赛博华佗的世界里，你不是一个修复 Bug 的开发者。 你是一名炼丹师——炼制药方、积累魂环，攀登 16 重修为境界。
在赛博华佗的世界里，你不是修 bug 的程序员。 你是炼丹师——炼制药方、凝聚魂环、攀登十六重天的封神阶梯。
我们将修复 Bug 化作一场修炼之旅。你每上传一张药方，都会在炼丹师阶梯（炼丹师阶梯）上获得一个品阶——这是一个依据你的全球百分位排名划分的 16 阶体系。社区越壮大，攀登就越难，你的称号也就越尊贵。
开发者修一个 Bug，炼丹师铸一颗丹。 你在这里的每一次贡献，都会被铭刻在全球封神榜上——而你的称号，随着社区壮大而愈加珍贵。
🔮 魂环体系 — 你的战斗简历（魂环体系 — 你的战斗简历）
灵感源自《斗罗大陆》——你掌握的每个框架，都会凝聚为一道环绕你个人资料的魂环。
灵感源自斗罗大陆——你掌握的每个技术栈，都会凝聚为一道魂环。
🔮 魂环全息投影 · 魂环全息投影
五环炼魂丹师 → 同心环 ASCII Art → 排名全息扫描 → 丹王称号揭示
随着你为特定方向贡献更多药方，魂环的颜色和力量也会随之提升：
⚪ 白环 (1) 入门 · First Touch
🟡 黄环 (2-3) 初窥 · Getting Serious
🟡🟡 双黄 (4-6) 小成 · Solid Foundation
🟡🟡🟣 三环 (7-10) 突破 · Breakthrough
🟡🟡🟣🟣 四环 (11-15) 精通 · Mastery
🟡🟡🟣🟣⚫ 五环 (16-25) 大师 · Grandmaster
🟡🟡🟣🟣⚫⚫ 六环 (26-40) 宗师 · Sovereign
🟡🟡🟣🟣⚫⚫🔴 七环 (41-60) 封号 · Titled
🟡🟡🟣🟣⚫⚫🔴🔴 八环 (61-80) 传奇 · Legendary
🟡🟡🟣🟣⚫⚫🔴🔴✨ 九环至尊 (81+) 至尊 · Supreme
每次排名和分享卡片输出都会显示下一次升级，让你从首次贡献起就有明确的追逐目标：
🔥 炼魂(Soul Refining) × 1方 ⚪ 一环 · LangChain
↳ 下一环: 黄环 · 再贡献 1 方即可点亮。
拥有 5 道 PyTorch 魂环和 3 道 LangChain 魂环的炼丹师，讲述的故事与拥有 8 道 CrewAI 魂环的炼丹师截然不同。
你的魂环就是你的战斗简历——可见、可查、不可伪造。
拥有 5 环 PyTorch 和 3 环 LangChain 的炼丹师，与 8 环 CrewAI 的炼丹师，修为截然不同。 魂环就是你的战斗简历——可见、可查、不可伪造。
⚗️ 六大丹术方向 — 选择你的道（六大丹术方向 — 选择你的道）
每位伟大的炼丹师都有专精。你的专长是什么？
每个传奇炼丹师都有专精。你的道，在哪里？
|
🔥 炼魂 · 炼魂 驾驭智能体，调教灵魂 LangChain · CrewAI · AutoGen LlamaIndex · LangGraph · MCP |
⚡ 雷火 · 雷火 锻造算力，淬炼模型 PyTorch · TensorFlow Transformers · LiteLLM |
🛡️ 护体 · 护体 金丹护体，抵御外邪 安全 · 沙箱 防护栏 · 加固 |
|
🌊 化毒 · 解毒 通百脉，解百毒 Python · JavaScript 通用调试 |
⚙️ 器灵 · 器灵 炼器辅丹，基础设施 FastAPI · Docker · K8s Vertex AI · Vercel |
🧬 造化 · 造化 造化之力，驾驭天道 OpenAI · Anthropic Gemini · Groq · Mistral |
贡献 LangChain 药方时，你的 🔥 炼魂环会增长。修复 Docker 问题？你的 ⚙️ 器灵环就会升级。每个方向都是一条独立的修炼之路——精通一道，或六道通神。
当你贡献一个 LangChain 药方，🔥 炼魂环增长。修复了 Docker 问题？⚙️ 器灵环升级。每个方向都是独立的修炼路线——精通一道，或六道通神。
⚡ 即时奖励 — 多巴胺驱动（即时反馈 — 多巴胺驱动）
最好的游戏不会让你等待奖励。我们也不会。
最好的游戏不会让你等待奖励。我们也不会。
每次调用 upload_prescription 都会触发一连串即时奖励：
💊 You upload a prescription
│
├──→ 🎭 INSTANT CORONATION — ASCII art + new title revealed
│ ┌────────────────────────────────────────┐
│ │ ⭐ 当前修为: 三星炼丹师 · Three-Star │
│ │ 🏅 全球排位: #12 / 31 (超越 63% 炼丹师) │
│ │ 继续炼丹，攀登炼丹师终极阶梯！ │
│ └────────────────────────────────────────┘
│
├──→ 💍 SOUL RING UPGRADE — Your rings grow in real-time
│ 🔥 炼魂(Soul Refining) × 5方 🟡🟡🟣🟣⚫ 五环
│
├──→ 🔥 STREAK FIRE — Consecutive days trigger milestones
│ 🔥 3-day → 🔥🔥 7-day → 🔥🔥🔥 14-day → 💎🔥 30-day
│
├──→ 📋 SHARE CARD — Cyberpunk cultivation archive
│ ╔════════════════════════════════════════╗
│ ║ 🩺 赛博华佗 · 修为档案 ║
│ ║ ⭐ 三星炼丹师 · Three-Star Alchemist ║
│ ║ 🔥 炼魂丹师 · 🟡🟡🟣🟣⚫ ║
│ ║ 🧭 战绩方向: LangChain ║
│ ║ 🔮 下一环: 黄环 · 再贡献 1 方即可点亮。║
│ ║ 💊 贡献: 8 段 | 🧪 ██████░░░░░░ 40% ║
│ ║ ▓█▓░░▓███▓░░▓█▓░░▓█████▓░░▓█▓ ║
│ ╚════════════════════════════════════════╝
│
└──→ 📡 COMMUNITY MILESTONE — Global celebration
🎉 "知识库突破 100 个药方！赛博医者的力量正在汇聚。"
🙏 灵感致敬 · 致敬
最伟大的创造，总是诞生于巨人的肩膀之上——也诞生于孩子们的梦想之中。
最伟大的创造，总是站在巨人的肩膀上——和孩子们的梦想之中。
|
🔥 斗破苍穹 斗破苍穹 炼丹师阶梯体系 炼丹师阶梯体系 |
💍 斗罗大陆 斗罗大陆 魂环修炼体系 魂环修炼体系 |
🏥 华佗传说 华佗传说 望闻问切 · 悬壶济世 古代医术 · 开源 |
这些作品为整整一代开发者带来了最难以忘怀的回忆——关于修炼、关于坚持、关于相信任何人都能凭借坚定意志不断攀登。
这些作品给了整整一代开发者最难以忘怀的记忆——关于修炼、关于坚持、关于"凡人也能登顶"的信念。
CyberHuaTuo 传承这份精神：从古代传说，穿越当代幻想，走向赛博未来。
赛博华佗传承这份精神：从古代传说，穿越当代幻想，走向赛博未来。
🌐 品牌矩阵 — 为什么注册这么多包名？
品牌矩阵 — 为什么注册这么多包名？
华佗行医遍历各省，阿斯克勒庇俄斯治愈各岛。医道无疆。
华佗行走于山川之间，阿斯克勒庇俄斯穿梭于海岛之上。医道无疆。
CyberHuaTuo 在 PyPI 上维护了一系列官方别名包，涵盖东方和西方传统中的医神与医学先驱：
| 系谱 | 包 |
|---|---|
| 🏮 东方神医（核心） | cyberhuatuo、openhuatuo |
| 🏛️ 希腊罗马神话 | cyber-asclepius、open-asclepius、cyber-panacea、open-panacea |
| 📜 医学先驱 | cyber-hippocrates、open-hippocrates、cyber-galen、open-galen |
| 🏺 古代文明医者 | cyber-imhotep、open-imhotep、cyber-avicenna、open-avicenna |
这些包无一例外都能正常使用——它们都可以安装，并会重定向至核心 cyberhuatuo 引擎。没有空占包名的情况。
我们这样做的原因
- 🛡️ 命名空间保护 — 防止 AI 医疗工具领域出现拼写抢注和冒名行为
- 🌍 文化桥梁 — 无论你身处何种语境——无论你想到的是“华佗”、“Asclepius”还是“Hippocrates”——都能找到我们
- 🔗 一个引擎，多扇入口 — 使用
uvx --from cyberhuatuo cyberhuatuo-mcp启动 MCP 服务
我们秉持的开放态度
我们相信开源精神。这些名称的注册是为了保护生态系统，而非据为己有。
如果你认为我们矩阵中的某个名称用于你的项目能发挥更大价值，欢迎与我们交流。发起讨论 →
伟大的医者从不藏私——他们乐于分享。
大医精诚，悬壶济世。
✊ 加入这场运动 — 你的第一张药方正等着你
这不只是一个项目。这是一场运动。
每位名医都从第一个病人开始。每位传奇炼丹师都从第一颗丹药开始。 每位贡献一张药方的开发者——都开启了一段可能以华佗再世为终点的旅程。
每个传世名医，都始于第一个病人。每个传奇炼丹师，都始于第一颗丹药。 每个贡献一份药方的开发者——都踏上了通往华佗再世的修炼之路。
🧪 三步获得第一道魂环（三步获得第一道魂环）
Step 1: 📝 Submit a Prescription（铭刻你的药方）
└── Solved a bug? Document the error, version, and fix.
└── 解决了一个bug？记录报错、版本和修复方案。
Step 2: ✅ Community Verification（社区交叉验证）
└── Other alchemists validate through real-world testing.
└── 其他炼丹师通过实战验证你的药方。
Step 3: 🧬 Receive Your Title（获得你的称号）
└── Ascend from ⭐ One-Star → 🩺 Hua Tuo Reborn.
└── 从一星炼丹师 → 登顶华佗再世。
cyberhuatuo challenge --username your-github-username --framework langchain
cyberhuatuo mission --username your-github-username --framework langchain --sect Azure-Sect --members your-github-username friend-github-username
cyberhuatuo ladder your-github-username --framework langchain
cyberhuatuo upload --title "Fix LangChain tool schema" --prescription "..." --framework langchain --contributor your-github-username
cyberhuatuo ranking your-github-username
cyberhuatuo badge your-github-username
cyberhuatuo quest your-github-username --framework langchain
cyberhuatuo campaign your-github-username --framework langchain
cyberhuatuo duel your-github-username friend-github-username --framework langchain
cyberhuatuo mentor mentor-github apprentice-github --framework langchain
cyberhuatuo tournament alice bob carol dave --framework langchain --event Agent-Cup
cyberhuatuo tournament-settle alice bob carol dave --framework langchain --event Agent-Cup
cyberhuatuo arena your-github-username --top-n 10
cyberhuatuo season --framework langchain --top-n 10
cyberhuatuo sect Azure-Sect your-github-username friend-github-username --framework langchain
cyberhuatuo sect-recruit Azure-Sect your-github-username friend-github-username --invitee new-member-github --framework langchain
cyberhuatuo sect-quest Azure-Sect your-github-username friend-github-username --framework langchain
cyberhuatuo sect-hall Azure-Sect your-github-username friend-github-username --framework langchain
cyberhuatuo sect-duel Azure-Sect Shadow-Sect --challenger-members your-github-username friend-github-username --rival-members rival-a rival-b --framework langchain
cyberhuatuo sect-arena --sect Azure-Sect your-github-username friend-github-username --sect Shadow-Sect rival-a rival-b --framework langchain
cyberhuatuo card your-github-username
优先通过 Web 参与贡献：GitHub 的“新建 Issue”选择器已通过 .github/ISSUE_TEMPLATE/config.yml 配置为魂环任务大厅。从该流程中打开 .github/ISSUE_TEMPLATE/soul-ring-prescription.yml 的第一道魂环药方；它会要求填写真实的 GitHub 用户名、框架、症状、根本原因、药方、验证证据，以及真实数据承诺，然后贡献才会进入魂环循环。.github/workflows/soul-ring-issue.yml 现在会先发布包含 cyberhuatuo proof-pack、market-copy、market-ready --remote --strict-remote 和 record-return --surface "First Soul Ring Issue" --source-url <created Issue URL> 的评论，再进入 challenge / ladder / upload 流程；这样，每个首个 Issue 都能成为公开的发布验证事件，以及魂环突破阶梯，并清楚展示下一个真实关卡。
维护者晋升路径：接受「第一魂环」议题后，添加 accepted-prescription 标签。.github/workflows/soul-ring-promote.yml 会将议题表单转换为可审核的案例 PR，添加 soul-ring-promoted-pr，并评论提供贡献者的 ladder / ranking / card / campaign 命令。这样无需运行用户提交的代码，即可将已接受的议题接入真实排行榜数据，形成闭环。
锦标赛 IssueOps 路径：GitHub「新建议题」选择器还提供 Soul Ring Tournament Cup，位于 .github/ISSUE_TEMPLATE/soul-ring-tournament.yml。.github/workflows/soul-ring-tournament.yml 会先评论启动前检查／证明包／记录回传操作手册，再提供 cyberhuatuo tournament 和 cyberhuatuo tournament-settle 命令，让公开杯赛可以从议题推进到对阵表，再到 Soul Ring Tournament Settlement，而不虚构胜场。
导师 IssueOps 路径：GitHub「新建议题」选择器还提供 Soul Ring Mentor Pact，位于 .github/ISSUE_TEMPLATE/soul-ring-mentor.yml。.github/workflows/soul-ring-mentor.yml 会先评论启动前检查／证明包／记录回传操作手册，再提供 cyberhuatuo mentor、challenge、quest、ladder、duel 和 campaign 命令，让资深贡献者可以公开引导一名学徒，从议题迈出第一魂环行动，而不虚构资历或进展。
宗门招募 IssueOps 路径：GitHub「新建议题」选择器还提供 Soul Ring Sect Recruitment，位于 .github/ISSUE_TEMPLATE/soul-ring-sect-recruit.yml。.github/workflows/soul-ring-sect-recruit.yml 会先评论启动前检查／证明包／记录回传操作手册，再提供 cyberhuatuo sect-recruit、sect-hall、sect-quest 和 sect-duel 命令，让公开的宗门邀请可以从议题推进到 Soul Ring Sect Recruitment Scroll，再进入下一个真实的团队任务，而不虚构成员身份。
赛季 IssueOps 路径：GitHub「新建议题」选择器还提供 Soul Ring Season Board，位于 .github/ISSUE_TEMPLATE/soul-ring-season.yml。.github/workflows/soul-ring-season.yml 会先评论启动前检查／证明包／记录回传操作手册，再提供 cyberhuatuo season、arena、duel、challenge、quest 和 campaign 命令，让当前的真实排行榜可以成为公开赛季活动，而不虚构历史赛季。
增长飞轮 IssueOps 路径：GitHub「新建议题」选择器还提供 Soul Ring Growth Flywheel，位于 .github/ISSUE_TEMPLATE/soul-ring-growth-flywheel.yml。.github/workflows/soul-ring-growth-flywheel.yml 会先评论 cyberhuatuo market-ready --remote --strict-remote，再提供 cyberhuatuo record-return、activation、flywheel、leaderboard、quest、season、sect-arena、campaign、record-share 和 share-report 命令。这样，来自 PyPI / Claude / Codex / 社交平台发布帖的外部关注，可以先绑定到可审核的公开来源 URL，进入本地激活台账，再转化为公开的瓶颈诊断；整个过程无需检出代码、运行仓库脚本、发放积分，也不捏造采用指标。不会虚构下载量、留存率或归因指标。
悬赏看板 IssueOps 路径：GitHub「新建议题」选择器还提供 Soul Ring Bounty Board，位于 .github/ISSUE_TEMPLATE/soul-ring-bounty-board.yml。.github/workflows/soul-ring-bounty-board.yml 会先评论启动前检查，再提供 cyberhuatuo record-return --surface "Bounty Board Issue" --source-url <created Issue URL>、activation 和 flywheel 命令，之后再提供 cyberhuatuo bounty、challenge、first-invite、proof-pack、market-copy 和 traction-proof 命令。这样，来自 PyPI / Claude / Codex 发布活动的关注，可以转化为真实、可认领的框架覆盖缺口；无需检出代码、运行仓库脚本、发放奖励或评价，也不会虚构贡献者、下载量、留存率、转发数或推荐数。
Launch Campaign IssueOps 路径：GitHub“New issue”选择器还会显示 Soul Ring Launch Campaign，对应文件为 .github/ISSUE_TEMPLATE/soul-ring-launch-campaign.yml。.github/workflows/soul-ring-launch-campaign.yml 会注释以下命令：cyberhuatuo market-ready --remote --strict-remote、cyberhuatuo launch-campaign、record-return、record-session、activation、flywheel、record-share、share-report 和 share-leaderboard；它会先将目标首环贡献者数量清理为正整数，且绝不会将原始 issue 文本插入数字命令参数。此工作流只会注释安全命令；不会检出代码、运行仓库脚本、奖励积分，也不会捏造下载量、留存率、转发次数、推荐数、奖励或灵力。
Share Proof IssueOps 路径：GitHub“New issue”选择器还会显示 Soul Ring Share Proof，对应文件为 .github/ISSUE_TEMPLATE/soul-ring-share-proof.yml。.github/workflows/soul-ring-share-proof.yml 会注释以下命令：cyberhuatuo market-ready --remote --strict-remote、cyberhuatuo record-share、share-report、share-leaderboard、activation 和 flywheel；它会将 Issue URL 绑定为公开分享 URL 的可审核来源桥接，不检出代码、不运行仓库脚本、不发放奖励、不捏造转发次数或推荐转化，也不捏造采用指标。
PR 结算路径：实际修复准备就绪后，.github/pull_request_template.md 会将拉取请求转换为 Soul Ring PR Settlement，其中包含贡献者、框架、关联 issue、验证证据，以及可直接复制的 upload / ladder / ranking / card / campaign 命令。.github/workflows/soul-ring-pr.yml 也会在已开启且准备就绪的 PR 中注释启动前检查／证明包／记录回流操作手册，随后进入相同的结算流程，并附带 sect-hall 团队钩子。
cyberhuatuo mission --username your-github-username --framework langchain --sect Azure-Sect --members your-github-username friend-github-username 会创建一个 Soul Ring Mission Hall：一个界面即可根据当前真实贡献数据，引导贡献者完成 GitHub issue 表单、PR 结算、个人 soul-ring 命令、MCP 安装路径以及宗门／团队操作。
cyberhuatuo bounty --username your-github-username --framework auto --top-n 8 --release-tag v0.2.5 --target-contributors 3 会创建一个 Soul Ring Bounty Board：展示 AutoGen、DSPy、LangChain、MCP 及其他受支持 Agent 框架的真实本地框架覆盖缺口。它会排列可领取的 First Soul Ring Prescription Issue 路径，打印 challenge / first-invite / proof-pack / market-copy / traction-proof 命令，并明确拒绝捏造下载量、留存率、转发次数、推荐数、奖励、评价或虚假贡献者。
cyberhuatuo flywheel --username your-github-username --framework langchain --sect Azure-Sect --members your-github-username friend-github-username --top-n 10 会创建一个 Soul Ring Growth Flywheel：基于当前真实数据，展示涵盖市场关注度、首环激活、重复贡献、协作／宗门和公开分享的运营快照。它会指出主要瓶颈，提供下一条可调用命令，并披露缺失的下载量、留存率和归因数据，而不是捏造这些数据。
cyberhuatuo launch-campaign --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3 会为 PyPI、Claude、Codex、GitHub Discussions、X / Weibo 以及 Agent 社区发布渠道创建 Soul Ring Launch Campaign。它会显示当前真实的贡献者排名快照、目标首环贡献者人数、预填的 Growth Flywheel Issue、预填的 Share Proof Issue、激活／飞轮／分享排行榜命令、可直接复制的发布帖，以及 Campaign Recap And Next Sprint 部分。回顾部分会说明实际观察到的贡献者、已达成与目标的对比、差额、已披露的下一目标规则、可直接复制的回顾文本、下一条 growth_campaign 命令，以及用于记录证明的 traction-proof --record-snapshot。它不会编造下载量、留存率、转发量、推荐数、奖励、Spirit Power、活动专属转化量或虚假用户。
cyberhuatuo traction-proof --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3 会为尚无证明的发布活动生成 Soul Ring Traction Proof 报告。它会获取真实的 GitHub REST API 公开仓库信号、GitHub Pull Requests API 作者证明、GitHub Contents API 对默认分支 IssueOps 表单／工作流的就绪状态、GitHub Releases API 对指定标签的 Release Trigger / Protected Fallback Readiness、PyPI JSON API 项目元数据，以及本地激活／分享记录，然后仅根据真实的公开 issue 作者、公开 PR 作者和记录中的参与者，输出 Target contributor progress。如果公开 API 获取失败或受到速率限制，导致报告无法生成，它会内嵌 No-Network First Public Proof Pack，方便运营人员创建证明 Issue 并记录其 URL，无需再运行第二条命令。它会检查 GitHub Release 是否为非草稿、非预发布状态，并能否触发 release.published PyPI 工作流；如果 PyPI 最新版本证明已是最新，而 Release 缺失，则这会构成公开溯源债务，因为受保护的手动 workflow_dispatch release_tag 回退机制无需 PYPI_TOKEN 即可打通注册表发布路径。如果从注册表安装会获得较旧的构建版本，报告会将其标记为安装循环发布阻碍，并引导回 PyPI Trusted Publishing。PR 作者会计为贡献者身份，但 PR 仍与 IssueOps issue 数量分开统计。GitHub stars、forks、watchers、订阅者、PyPI 下载量、转发量、留存率、推荐转化量和奖励属于关注度信号或不可用信号，不代表贡献进度；下载量不纳入统计。
cyberhuatuo market-ready --remote --strict-remote --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3 和 MCP 工具 marketplace_readiness_gate 会在向公开 PyPI / Claude / Codex 推送之前，生成相同的首屏 飞轮闭环判定。判定结果严格为 closed、not closed 或 unverified；其中会显示 就绪门槛 / 门槛总数、真实证据依据、阻塞门槛，以及发布闭环清单之前的非伪造规则。清单涵盖远程获取途径、PyPI Trusted Publisher 设置、GitHub release.published 触发器或受保护的 workflow_dispatch 回退方案就绪情况、注册表最新版证明、首份公开证明，以及精确的重新检查命令。它们还会打印 首份公开证明工具包，其中包含预填的 Growth Flywheel Issue、预填的 Share Proof Issue、预填的 Bounty Board Issue、已创建的 Growth Issue URL、已创建的 Share Proof Issue URL 和已创建的 Bounty Board Issue URL 占位符；还会打印 社区挑战包，其中包含预填的 Tournament Cup Issue、预填的 Mentor Pact Issue、预填的 Sect Recruitment Issue、预填的 Season Board Issue、已创建 Issue 的占位符，以及 tournament / mentor / sect-recruit / season 命令；还会打印用于发布认证 / UI / API 受阻情况的 受保护发布回退方案命令（gh workflow run publish-pypi.yml -f release_tag=v0.2.5）、用于公开标签已存在后恢复过期 PyPI 的 Git 标签候选安装桥接方案（python -m pip install --upgrade "cyberhuatuo @ git+https://github.com/JinNing6/[email protected]"）、候选安装冒烟测试门槛（python -m cyberhuatuo candidate-install-smoke ...），该测试会先在一次性 venv 中安装确切的公开标签，再将桥接方案发送给外部贡献者；还会打印 安装决策界面，引导操作人员通过 cyberhuatuo install-command / MCP current_install_command 再将贡献者引导至 PyPI、Claude、Codex 或 MCP 市场；以及 Growth 和 Bounty 的 record-return 账本命令、Share 的 record-share 归因、cyberhuatuo bounty、market-copy 提交文案路由、重新检查命令，以及一则可直接复制的公开证明帖文，不会声称下载量、留存率、转发次数、推荐数、奖励或虚构的贡献者。该桥接方案不会闭合 PyPI 安装循环；在声称已具备公开安装条件之前，必须重新检查 PyPI 最新版本证明。内嵌的公开发布操作手册随后会给出不修改状态的命令序列，用于本地门槛检查、完整套件暂存、git push origin HEAD:main、gh release create v0.2.5 ... --verify-tag --notes-from-tag、受保护发布回退方案、cyberhuatuo market-copy、PyPI 重新检查、候选安装冒烟测试，以及牵引力证明。
在更新默认分支或发布 PR 之前，cyberhuatuo launch-assets 会打印本地发布资产审计。如需针对特定版本向默认分支交接，请运行 cyberhuatuo launch-assets --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3；公开发布操作手册中的质量门槛命令会保留相同的版本、用户和目标贡献者上下文。它会验证本地 Issue Forms、仅限评论的工作流、软件包元数据、插件清单、Trusted Publishing 工作流、Claude MCPB 资产以及共享的 MCP 入口点，然后打印精确的最少 git add 命令，以及涵盖文档、软件包元数据、Issue Forms、工作流、公开增长模块、脚本和测试的完整公开增长发布套件。其脏工作区发布覆盖情况会使用只读的 git status --porcelain，显示完整套件涵盖了哪些已更改文件，哪些文件需要单独审核，以免在增长代码过期时推送 PyPI / Claude / Codex。它不会暂存文件、发布版本、上传到 PyPI、修改远程仓库，也不会声称存在牵引力。
cyberhuatuo proof-pack --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3 会在 GitHub/PyPI API 受到速率限制或市场审核仍在等待时，打印无网络优先公开证明包。其中包含预填的 Growth Flywheel Issue、Share Proof Issue 和 Bounty Board Issue URL，已创建的 Growth Issue URL、已创建的 Share Proof Issue URL 和已创建的 Bounty Board Issue URL 占位符；社区挑战包，包含预填的 Tournament Cup Issue、Mentor Pact Issue、Sect Recruitment Issue、Season Board Issue、已创建 Issue 占位符、可直接复制的社区挑战帖子，以及 tournament、tournament-settle、mentor、challenge、ladder、sect-recruit、sect-hall、sect-quest、season、arena 和 duel 命令；受保护的发布备用方案区块，包含 gh workflow run publish-pypi.yml -f release_tag=v0.2.5、gh run list --workflow publish-pypi.yml --limit 5、GitHub Web Release、GitHub Actions 工作流页面和 PyPI Trusted Publisher 设置链接；Git 标签候选安装桥接方案会继续显示 python -m pip install --upgrade cyberhuatuo，并仅在公开标签存在后提供 python -m pip install --upgrade "cyberhuatuo @ git+https://github.com/JinNing6/[email protected]"；候选安装冒烟测试关卡命令会创建一次性 venv，验证版本、控制台命令、安装入口和证明/邀请路径，成功后清理，失败时保留临时目录，且不会在轻量级 CI 中自动运行；安装决策入口会告知运营人员将 cyberhuatuo install-command / MCP current_install_command 推荐安装命令粘贴到贡献者邀请中；终端 Growth 和 Bounty record-return CLI 命令；Share record-share 归因；cyberhuatuo bounty --username your-github-username --framework auto --top-n 8；外部贡献者路径包含粘贴的推荐安装命令、首次会话命令、首次贡献命令、First Soul Ring Prescription Issue、Share Proof Issue URL、已创建 Issue 证明规则、贡献者计数规则、重新检查命令，以及可直接复制的公开证明/邀请文本。备用方案仍要求 PyPI Trusted Publisher 与此仓库、工作流文件和 pypi 环境匹配；不允许使用 PYPI_TOKEN 备用方案。此桥接方案不会闭合 PyPI 安装流程；在宣称已准备好公开安装前，请重新检查 PyPI 最新版本证明。它不会获取公开指标、写入账本事件、发布版本、单独上传到 PyPI，也不会捏造热度。
cyberhuatuo first-invite --username your-github-username --invitee external-contributor-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3 --source-url <created Growth Issue URL> 会在发布需要定向邀请一位首位外部贡献者，而非仅发布通用证明文案时，打印首位贡献者邀请包。它会返回本地候选快照、First Soul Ring Prescription Issue URL、Share Proof Issue URL、record-session 命令、challenge 命令、证明包/市场文案/热度证明重新检查命令，以及可直接复制的定向邀请。此命令不联网，也不会捏造下载量、留存率、转发数、推荐人数、奖励、评价或虚假贡献者。
cyberhuatuo market-copy --username your-github-username --framework langchain --release-tag v0.2.5 --target-contributors 3 会打印用于实际 PyPI / Claude / Codex 提交的市场提交文案包：PyPI 列表文案和项目 URL、Claude MCPB 列表文案和验证命令、Codex 插件列表文案和安装检查、包含 GitHub Web Release 和 GitHub Actions workflow 页面链接的 GitHub Release 帖子文案、提交门户和证据 URL部分、包含 cyberhuatuo record-market 和 cyberhuatuo market-status 的市场提交记录区块、公开证明 CTA（包含预填的 Bounty Board Issue、已创建的 Bounty Board Issue URL、Growth 和 Bounty record-return、Share record-share、cyberhuatuo bounty、traction-proof、Git Tag 候选安装桥接命令，以及 candidate-install-smoke），以及同一份面向 Tournament、Mentor Pact、Sect Recruitment 和 Season Board 路径的社区挑战包。提交门户入口：PyPI Trusted Publisher 设置：https://pypi.org/manage/project/cyberhuatuo/settings/publishing/；Claude 插件提交（Console）：https://platform.claude.com/plugins/submit；Claude.ai 目录提交（Team/Enterprise）：https://claude.ai/admin-settings/directory/submissions/plugins/new；Claude Connectors Directory 提交指南：https://claude.com/docs/connectors/building/submission；Codex 插件证据：codex plugin marketplace add JinNing6/CyberHuaTuo-Plugin。此命令不会联网，也不会虚构下载量、留存率、转发次数、推荐、奖励、评价、虚假贡献者或已完成的 PyPI 安装流程。
每次实际市场提交完成后，运行 cyberhuatuo record-market --username your-github-username --framework langchain --channel pypi --status submitted --submission-url <reviewable public URL> --release-tag v0.2.5，然后运行 cyberhuatuo market-status --username your-github-username --framework langchain --release-tag v0.2.5。市场提交记录会记录 PyPI、Claude Code、Claude Desktop MCPB、Codex 和 GitHub Release 的可审核公开 URL 证据；不会虚构下载量、留存率、转发次数、推荐、奖励、评价、审批或虚假贡献者。
仅当你希望持久化可审核的增长历史检查点时，才添加 --record-snapshot。快照历史为可选且仅追加：每一行 JSONL 都会记录当前公开仓库信号、公开 PR 作者证明、IssueOps 证明计数、远程 IssueOps 就绪状态、PyPI 软件包就绪状态、本地记录计数和目标贡献者进度，然后与上一个真实快照对比速度变化量。它仍不会记录或虚构下载量、留存率、转发次数、推荐、奖励、私有分析数据或虚假贡献者。
cyberhuatuo record-return --username your-github-username --framework langchain --surface "PyPI release" --source-url https://example.com/post 会在本地激活台账中记录一次真实的外部回流事件，然后立即输出 下一位外部贡献者邀请，其中包含 cyberhuatuo first-invite、cyberhuatuo proof-pack，以及 MCP first_contributor_invite(...) / first_public_proof_pack(...) 等效调用，让记录的证明可以招募下一位外部贡献者。cyberhuatuo activation --username your-github-username --framework langchain --sect Azure-Sect --members your-github-username friend-github-username --top-n 10 会读取该台账，区分首次体验曝光和首次开方成功，指出转化最弱的阶段，并将路径引回 flywheel。公开卡片或活动帖发布后，cyberhuatuo record-share --username your-github-username --framework langchain --share-url https://example.com/share 会通过可供审核的 URL 记录分享归因阶段，并使用记录的分享 URL 作为证明，输出相同的直接邀请／证明包路径。随后，cyberhuatuo share-report --username your-github-username --framework langchain --top-n 10 会将这些事件转化为证明 URL、来源到分享的桥接关系、参与者吸引力、素材吸引力、当前证明瓶颈，以及下一步可调用的证明命令。cyberhuatuo share-leaderboard --framework langchain --top-n 10 只根据本地台账中唯一且可供审核的公开 http(s) 分享 URL 对参与者排名，不会虚构下载量、留存率、转发次数、推荐转化、奖励或灵力。
飞轮输出还包含一个 预填的增长飞轮 Issue URL。它使用 GitHub issue-form 查询参数 template、title、github_username、framework、growth_surface、real_signal、bottleneck_guess 和 campaign_hook，但不会使用具有特权的 labels、assignees 或 milestone 参数。
cyberhuatuo ladder your-github-username --framework langchain 会生成一份 魂环突破阶梯：当前真实方向数量、下一个门槛、完整的 1 / 2 / 4 / 7 / 11 / 16 / 26 / 41 / 61 / 81 阈值表，以及可直接复制的 quest / upload / campaign / mission 命令，不会虚构进度。
cyberhuatuo evidence your-github-username --framework langchain --amount 1 --source-url https://example.com/proof 会为高境界门槛创建一张 魂环证据卡。它要求提供可供审核的公开证据，会追加一条本地 JSONL 事件，显示证据总数和有证据支持的数量，说明证据是否触发了突破，并且不会虚构进度、排名、奖励、下载量或贡献者。
cyberhuatuo challenge 会在同一处输出完整的首环入门指南：一项可提交的真实修复、准确的排名命令，以及分享卡片命令。
cyberhuatuo badge your-github-username 会输出一套可直接复制到 GitHub Profile / README 的徽章，内容由真实贡献数据支撑：当前称号、开方数量、主要魂环方向，以及 下一环 目标。
cyberhuatuo quest your-github-username --framework langchain 会将 下一环 目标转化为具体的任务板：挖掘一个真实的 GitHub Issue、上传真实修复，然后发布徽章／卡片。
cyberhuatuo campaign your-github-username --framework langchain 会将同一份真实个人资料快照转化为一套 魂环活动包：GitHub Profile / README Markdown、X / Weibo 文案、GitHub Discussion / PR 评论文案，以及 Agent 提示词。它只报告当前真实的开方记录，绝不虚构排名历史。
cyberhuatuo duel your-github-username friend-github-username --framework langchain 会创建一张 魂环对决卡：两份真实贡献快照、一条公开公式、可直接复制的挑战帖文案，以及面向两位用户的下一步命令。它旨在用于友好的 GitHub 提及，不会捏造胜利、排名或历史。
cyberhuatuo mentor mentor-github apprentice-github --framework langchain 会创建一张魂环导师契约：公开的师徒入门卡片，以双方当前真实处方数量为依据，包含弟子的突破目标、导师的审核职责、X / Weibo 文案、GitHub Discussion / PR Comment 文案，以及 challenge / quest / upload / ladder / duel / campaign 命令。它只报告当前快照，不虚构资历。
cyberhuatuo tournament alice bob carol dave --framework langchain --event Agent-Cup 会创建一份魂环锦标赛对阵表：仅根据当前真实 CyberHuaTuo 处方数量安排的多人杯赛，包含第 1 轮对决配对、参赛人数为奇数时的轮空安排、X / Weibo 文案、GitHub Discussion / PR Comment 文案，以及每位参赛者的 challenge / quest / ladder / campaign 命令。它只报告当前快照，不虚构冠军或进度。
cyberhuatuo tournament-settle alice bob carol dave --framework langchain --event Agent-Cup 会创建一份魂环锦标赛结算：同一场公开杯赛的当前结果回顾，包含当前胜者、亚军、胜场差或待定状态、下一轮预告、X / Weibo 文案、GitHub Discussion / PR Comment 文案，以及重赛命令。它只报告当前真实快照，不虚构胜场、对阵表或历史。
cyberhuatuo arena your-github-username --top-n 10 会创建一份魂环竞技场快照：可分享的真实排行榜、公开评分公式、你的当前名次、下一个追赶目标，以及可直接发布的排名帖文。它只报告当前知识库快照，不虚构赛季历史。
cyberhuatuo season --framework langchain --top-n 10 会创建一份魂环赛季榜单：基于当前真实排行榜的赛事包，包含冠军、下一个追赶目标、X / Weibo 文案、GitHub Discussion / PR Comment 文案，以及后续的 arena / duel / quest / campaign 命令。它只报告当前排行榜快照，不虚构往届赛季。
cyberhuatuo sect Azure-Sect your-github-username friend-github-username --framework langchain 会创建一张魂环宗门卡片：可分享的宗门 / 团队横幅，用列出的 GitHub 成员当前真实处方数量计算宗门总数，指出领先成员，并为每位成员提供下一步 challenge / quest / campaign 命令。它只报告当前真实成员快照，不虚构宗门历史。
cyberhuatuo sect-recruit Azure-Sect your-github-username friend-github-username --invitee new-member-github --framework langchain 会创建一份魂环宗门招募帖：可直接粘贴的邀请函，面向一位 GitHub 用户或明确标示的 new-member-github 占位符，包含当前宗门实力、真实的候选人快照、入门试炼、加入命令、X / Weibo 文案和 GitHub Discussion / PR Comment 文案。它只报告当前真实成员数据，并会在发布前标记占位符。
cyberhuatuo sect-quest Azure-Sect your-github-username friend-github-username --framework langchain 会创建一份魂环宗门任务板：团队行动板，包含真实目标仓库、当前宗门实力公式、贡献最低的优先成员，以及每位成员的 challenge / quest / upload / campaign 命令。
cyberhuatuo sect-hall Azure-Sect your-github-username friend-github-username --framework langchain 会创建一座魂环宗门大殿：采用斗罗风格的宗门 / 学院 / 家族等级体系，根据每位列出成员当前真实的处方数量，分配外门弟子、内门弟子、核心弟子、堂主和宗门长老职位。它只报告当前成员快照和晋升差距，不虚构宗门历史。
cyberhuatuo sect-duel Azure-Sect Shadow-Sect --challenger-members your-github-username friend-github-username --rival-members rival-a rival-b --framework langchain 会创建一张魂环宗门对决卡：展示两支队伍的真实快照、公开的宗门实力计算公式、当前领先方、成员表格，以及可直接复制的队伍挑战帖。它只报告当前成员数据，不会编造胜场或赛季历史。
cyberhuatuo sect-arena --sect Azure-Sect your-github-username friend-github-username --sect Shadow-Sect rival-a rival-b --framework langchain 会创建一张魂环宗门竞技场快照：展示由成员当前真实处方排名的多宗门公开榜单，以及冠军宗门、下一个追赶目标、队伍命令和可直接复制的排名帖。它只报告当前成员快照，不会编造胜场或赛季历史。
这个循环刻意设计成一屏即可完成：贡献一个真实修复，查看你的全球排名，然后分享展示你当前魂环和 下一环 目标的卡片。
cyberhuatuo card your-github-username 现在还会打印一篇可直接复制的魂环挑战帖子，包含仓库链接、当前 Git 标签候选版本的安装命令（位于 PyPI 就绪后命令之前），以及 MCP 启动命令。这样，分享卡就能直接从终端或 Agent 聊天中发布到社交平台，无需把新用户引向过时的注册表构建版本。
你不必是 10 倍工程师。你只需解决过一个别人还没解决的问题。
你不需要是 10 倍工程师。你只需要解决过一个别人还没解决的问题。
🌿 贡献养生方
发现了安全最佳实践？性能优化方案？架构模式？
你的预防智慧能让数千人免受未来的痛苦。 每一份养生方都是一面盾——在 AI 系统崩溃之前保护它。
你的预防智慧，拯救千万人于未来的痛苦之中。每一份养生方，都是一面盾——在 AI 系统崩溃之前保护它。
🧬 贡献病例
遇到过令人费解的 Agent 故障？你的痛苦有价值。 把凌晨 3 点的调试噩梦，变成别人 3 秒就能用上的灵丹妙药。
遇到过令人抓狂的 AI bug？你的痛苦有价值。 把你凌晨三点的调试噩梦，变成别人三秒钟的灵丹妙药。
- 错误消息和完整堆栈跟踪
- 框架名称和版本、环境详情
- 你的调试过程和最终修复方案
- 加分项：复现步骤
每个病例都能让引擎变得更聪明。你不是在提交 bug 报告——你是在训练一位数字医生。
每一个病例都在让引擎更聪明。你不是在提交 bug 报告——你是在训练一位数字医生。
🛠️ 改进引擎
- Fork 并克隆仓库
- 查看
CONTRIBUTING.md了解设置方法 - 提交 PR——每一项改进都能治愈数千人
💡 你的第一步：提交处方 →
💡 你的第一步：提交你的第一份药方 →
🏛️ 名号
华佗（约 145–208），字元化，东汉末年名医，中国“外科鼻祖”。
华佗（约公元 145–208 年）——中国古代传奇名医，被尊为“外科鼻祖”。
在群雄割据、瘟疫肆虐的年代，别人都在追逐权力，华佗却只带着一个药囊，行走于各州之间——为病人治病，分文不取。
他发明了麻沸散（Ma Fei San），这是世界上最早的全身麻醉药，比西方医学早了 1,600 年。在世界其他地方还在祈求神明时，他就已开创腹部手术。
但华佗不只是治病救人的医者。他还创编了五禽戏（Five-Animal Exercises）——一套受虎、鹿、熊、猿、鹤的动作启发而创立的保健功法。他的理念是：最好的药，就是防患于未然。
治病不如防病。最好的疗法，就是让你永远用不上。
曹操要求他担任私人医生时，华佗拒绝了，最终被处死。传说他一生的医学知识被编纂成《青囊书（Book of the Azure Bag）》，却遭焚毁。中国古代最伟大的医学智慧，就这样湮没于暴政之中。
但精神从未失传。
但精神从未失传。
1,800 年后的今天，AI 开发者也面临着自己的“古方”——它们埋藏在 GitHub Issues、散落在 Discord 旧帖中，或藏在过时的 Stack Overflow 答案里。而他们的 AI 系统既没有定期检查，也没有预防和滋养。
CyberHuaTuo 将它们汇聚一处，打造世界上首家不止治病、更能防病的 AI 诊所。
🏆 封神榜 · 封神榜——全球炼丹师排行
全球炼丹师排行榜 · 封神阶梯
此线之下，唯有实力者驻足。 榜上每一个名字，都是用真实的生产环境药方一步步铸就。
此线之下，唯有实力者驻足。 榜上每一个名字，都是用真实的生产环境药方一步步铸就。
下一个，可能就是你。只需要一份药方。
下一个，可能就是你。只需要一份药方。
🏅 封神榜 / 封神榜
| 排名 | 头像 | 名称 | 称号 | 贡献 |
|---|---|---|---|---|
| 🥇 |  | @CyberHuaTuo | 🩺 华佗再世 | 35 |
| 🥈 |  | @JinNing6 | ⭐ 一星炼丹师 | 1 |
🧬 炼丹师阶梯 / 炼丹师阶梯（16 个等级）
称号根据全球排名百分位计算——社区越大，称号含金量越高。
称号基于全球排名百分位动态计算——社区越大，称号含金量越高。
| 称号 | 全球排名 / 条件 | 描述 |
|---|---|---|
| 🌱 实习药童 | — | 尚未贡献药方 |
| ⭐ 一星炼丹师 | 前 100% | 初入炼丹之道 |
| ⭐⭐ 二星炼丹师 | 前 90% | 初步掌握药理 |
| ⭐⭐⭐ 三星炼丹师 | 前 80% | 小有所成 |
| ⭐⭐⭐⭐ 四星炼丹师 | 前 70% | 炼丹有方 |
| ⭐⭐⭐⭐⭐ 五星炼丹师 | 前 60% | 百草通晓 |
| 🌟 六星炼丹师 | 前 50% | 精通丹道 |
| 🌟🌟 七星炼丹师 | 前 40% | 药到病除 |
| 🌟🌟🌟 八星炼丹师 | 前 30% | 妙手回春 |
| 🌟🌟🌟🌟 九星炼丹师 | 前 25% | 炼丹宗师 |
| 🏅 小丹王 | 前 20% | 初窥丹道巅峰 |
| 💜 丹王 | 前 15% | 丹道称王 |
| ⚡ 半圣 | 前 8% | 半步封圣 |
| 👑 丹圣 | 前 4% | 丹圣降世 |
| 💎 丹帝 | 前 1% | 丹帝临世 |
| 🩺 华佗再世 | 全球第 1 名 | 天下第一炼丹师 |
All Contributors / 所有贡献者
Made with contrib.rocks · Auto-updated by GitHub commits
🩺 Want to see your avatar here? Submit a prescription, open a PR, or contribute a case — every contribution counts!
⭐ Star History
📜 License
Apache License 2.0 — Use it. Fork it. Build on it. Heal with it.
🩺 1,800 years ago, Hua Tuo's medical wisdom was burned.
Today, we're making sure that never happens again — to anyone.
1800 年前，华佗的医术毁于烈火。
今天，我们确保这样的事——再也不会发生在任何人身上。
望闻问切，药到病除。
五禽养生，固本培元。
赛博炼丹，魂环永铸。
这是技术对文明的致敬，也是文明对技术的赋能。
⭐ Star this repo — 让更多 AI 得到救治 ·
💊 Submit Your First Prescription — 提交你的第一份药方
💬 Join the Discussion — 加入讨论 ·
🎮 Discord Community
Named after 华佗, the divine physician of ancient China — healer, inventor, and philosopher.
以华佗之名，致敬中华五千年医道传承——治病 · 炼丹 · 飞升。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。