Sharpen CyberHuaTuo public error-doctor entry

Author: JinQian

.agents/plugins/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "cyberhuatuo",
-  "description": "CyberHuaTuo Codex plugin marketplace for AI-agent debugging workflows, MCP tools, and soul-ring contribution loops.",
+  "description": "CyberHuaTuo Codex plugin marketplace for paste-a-traceback AI-agent diagnosis, MCP tools, and reusable prescriptions.",
   "interface": {
     "displayName": "CyberHuaTuo Plugins"
   },
@@ -18,8 +18,8 @@
       "category": "Developer Tools",
       "interface": {
         "displayName": "CyberHuaTuo Plugin",
-        "shortDescription": "Diagnose AI-agent errors and route real fixes into the First Soul Ring loop.",
-        "longDescription": "CyberHuaTuo bundles a Codex skill and an MCP server for diagnosing AI-agent, MCP, LangChain, CrewAI, LlamaIndex, OpenAI SDK, and frontend framework failures using a curated public prescription knowledge base.",
+        "shortDescription": "Paste AI-agent tracebacks and get root cause, exact fixes, and verification steps.",
+        "longDescription": "CyberHuaTuo bundles a Codex skill and an MCP server for diagnosing AI-agent, MCP, LangChain, CrewAI, LlamaIndex, OpenAI SDK, and frontend framework failures using a curated public prescription knowledge base. Real fixes can still flow into the First Soul Ring contribution loop after the error is cured.",
         "developerName": "CyberHuaTuo Contributors",
         "capabilities": [
           "MCP",

.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "cyberhuatuo",
-  "description": "CyberHuaTuo Claude Code plugin marketplace for AI-agent debugging workflows, MCP tools, and soul-ring contribution loops.",
+  "description": "CyberHuaTuo Claude Code plugin marketplace for paste-a-traceback AI-agent diagnosis, MCP tools, and reusable prescriptions.",
   "owner": {
     "name": "CyberHuaTuo Contributors",
     "url": "https://github.com/JinNing6/CyberHuaTuo-Plugin"
@@ -10,7 +10,7 @@
       "name": "cyberhuatuo-plugin",
       "source": "./",
       "version": "0.2.1",
-      "description": "Diagnose AI-agent and coding framework failures, search reusable prescriptions, and join the First Soul Ring contribution ladder.",
+      "description": "Paste AI-agent tracebacks to get root cause, exact fixes, verification steps, reusable prescriptions, and an optional First Soul Ring contribution path after the cure.",
       "category": "Developer Tools",
       "keywords": [
         "mcp",

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "cyberhuatuo-plugin",
   "version": "0.2.1",
-  "description": "CyberHuaTuo diagnostic workflows, MCP tools, and agent skills for AI agent and coding framework failures.",
+  "description": "Paste AI-agent tracebacks and get root cause, exact fixes, verification steps, and reusable prescriptions through CyberHuaTuo MCP tools and agent skills.",
   "author": {
     "name": "CyberHuaTuo"
   },

.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "cyberhuatuo-plugin",
   "version": "0.2.1",
-  "description": "CyberHuaTuo diagnostic workflows for AI agent and coding framework failures.",
+  "description": "Paste AI-agent tracebacks and get root cause, exact fixes, verification steps, and reusable prescriptions.",
   "author": {
     "name": "CyberHuaTuo"
   },
@@ -19,8 +19,8 @@
   "mcpServers": "./.mcp.json",
   "interface": {
     "displayName": "CyberHuaTuo Plugin",
-    "shortDescription": "Diagnose AI agent and coding framework failures.",
-    "longDescription": "CyberHuaTuo bundles a Codex skill and an MCP server for diagnosing AI agent, MCP, LangChain, CrewAI, LlamaIndex, OpenAI SDK, and frontend framework failures using a curated public prescription knowledge base.",
+    "shortDescription": "Paste tracebacks and get exact AI-agent fixes.",
+    "longDescription": "CyberHuaTuo bundles a Codex skill and an MCP server for paste-a-traceback diagnosis across AI agent, MCP, LangChain, CrewAI, LlamaIndex, OpenAI SDK, and frontend framework failures using a curated public prescription knowledge base.",
     "developerName": "CyberHuaTuo",
     "category": "Developer Tools",
     "capabilities": [
@@ -30,7 +30,7 @@
     ],
     "brandColor": "#00D09C",
     "defaultPrompt": [
-      "Diagnose this traceback with CyberHuaTuo.",
+      "Paste this traceback into CyberHuaTuo and return the root cause, exact fix, and verification command.",
       "Search CyberHuaTuo for this framework error.",
       "Run a security checkup on this agent code."
     ]

README.md

@@ -16,6 +16,36 @@
   <em>你的 AI 生病了？推门而入。别人诊断不了的，我们药到病除。</em>
 </p>
 
+---
+
+## 🚨 Emergency Room: Paste The Traceback First
+
+**AI Agent Error Doctor** — paste any MCP / LangChain / CrewAI / OpenAI SDK traceback and get the root cause, exact fix, and verification steps from the CyberHuaTuo prescription library.
+
+```bash
+python -m cyberhuatuo diagnose "Traceback ... from langchain import ChatOpenAI ..." --framework langchain --top-k 1
+```
+
+**Real CLI recording from this repository:**
+
+<p align="center">
+  <img src="assets/cli_emergency_diagnosis_demo.gif" alt="CyberHuaTuo emergency diagnosis CLI demo: traceback to exact LangChain fix" width="100%"/>
+</p>
+
+**The cure returned by the recorded run:**
+
+```bash
+pip install langchain-openai
+```
+
+```python
+from langchain_openai import ChatOpenAI
+```
+
+This first rescue path works from the local prescription library even before you add an LLM API key. Add a model key later for deeper AI diagnosis.
+
+---
+
 <p align="center">
   <a href="#-quick-start">
     <img src="assets/prescription_universe.svg" alt="CyberHuaTuo Holographic Bagua Engine" width="100%"/>

README_CN.md

@@ -16,6 +16,36 @@
   <em>不只是修 Bug —— 我们让你的 AI 百毒不侵。</em>
 </p>
 
+---
+
+## 🚨 急诊入口：先粘贴报错
+
+**AI Agent 报错急诊室** — 粘贴 MCP / LangChain / CrewAI / OpenAI SDK 的 traceback，赛博华佗直接给病灶、根因、可执行修复和验证步骤。
+
+```bash
+python -m cyberhuatuo diagnose "Traceback ... from langchain import ChatOpenAI ..." --framework langchain --top-k 1
+```
+
+**来自当前仓库 CLI 的真实录制：**
+
+<p align="center">
+  <img src="assets/cli_emergency_diagnosis_demo.gif" alt="赛博华佗急诊 CLI Demo：从 traceback 到 LangChain 精确修复" width="100%"/>
+</p>
+
+**这次急诊返回的药方：**
+
+```bash
+pip install langchain-openai
+```
+
+```python
+from langchain_openai import ChatOpenAI
+```
+
+这条急诊路径直接使用本地药方库；即使还没有配置 LLM API Key，也能先给出可复制的命中药方。配置模型 Key 后，可以继续使用更深度的 AI 望闻问切。
+
+---
+
 <p align="center">
   <a href="#-快速开始">
     <img src="assets/prescription_universe.svg" alt="赛博华佗全息八卦引擎" width="100%"/>

README_MCP.md

@@ -1,7 +1,7 @@
 # 🩺 CyberHuaTuo MCP Server
 
-> 让所有 AI Coding 工具都能调用赛博华佗的「望闻问切」诊断能力
-> Make CyberHuaTuo available in every AI coding tool
+> Paste an Agent / MCP / LangChain / CrewAI traceback and get the root cause, exact fix, and verification steps inside any AI coding tool.
+> 粘贴 Agent / MCP / LangChain / CrewAI traceback，在任意 AI Coding 工具里得到病灶、药方和验证步骤。
 
 ## 什么是 MCP？
 

assets/cli_emergency_diagnosis_demo.cast

@@ -0,0 +1,140 @@
+{"version": 2, "width": 120, "height": 36, "timestamp": 1782973436, "env": {"SHELL": "powershell", "TERM": "xterm-256color"}}
+[0.0, "o", "PS E:\\ideaProjects\\agent\\CyberHuaTuo-Plugin> "]
+[0.025, "o", "pyt"]
+[0.05, "o", "hon"]
+[0.075, "o", " -m"]
+[0.1, "o", " cy"]
+[0.125, "o", "ber"]
+[0.15, "o", "hua"]
+[0.175, "o", "tuo"]
+[0.2, "o", " di"]
+[0.225, "o", "agn"]
+[0.25, "o", "ose"]
+[0.275, "o", " \"T"]
+[0.3, "o", "rac"]
+[0.325, "o", "eba"]
+[0.35, "o", "ck "]
+[0.375, "o", "..."]
+[0.4, "o", " fr"]
+[0.425, "o", "om "]
+[0.45, "o", "lan"]
+[0.475, "o", "gch"]
+[0.5, "o", "ain"]
+[0.525, "o", " im"]
+[0.55, "o", "por"]
+[0.575, "o", "t C"]
+[0.6, "o", "hat"]
+[0.625, "o", "Ope"]
+[0.65, "o", "nAI"]
+[0.675, "o", " .."]
+[0.7, "o", ".\" "]
+[0.725, "o", "--f"]
+[0.75, "o", "ram"]
+[0.775, "o", "ewo"]
+[0.8, "o", "rk "]
+[0.825, "o", "lan"]
+[0.85, "o", "gch"]
+[0.875, "o", "ain"]
+[0.9, "o", " --"]
+[0.925, "o", "top"]
+[0.95, "o", "-k "]
+[0.975, "o", "1"]
+[1.125, "o", "\r\n"]
+[1.185, "o", "\r\n"]
+[1.245, "o", "🩺 CyberHuaTuo 赛博华佗 · CLI\r\n"]
+[1.305, "o", "==================================================\r\n"]
+[1.365, "o", "  望闻问切 · AI 诊断\r\n"]
+[1.425, "o", "==================================================\r\n"]
+[1.485, "o", "\r\n"]
+[1.545, "o", "🩺 CyberHuaTuo 索引构建器\r\n"]
+[1.605, "o", "========================================\r\n"]
+[1.665, "o", "✅ 已有索引（36 个病例），跳过构建\r\n"]
+[1.725, "o", "✅ 知识库索引就绪，共 36 个病例\r\n"]
+[1.785, "o", "# CyberHuaTuo Diagnosis Report\r\n"]
+[1.845, "o", "**Report ID**: `CHT-DR-20260702-ae37`\r\n"]
+[1.905, "o", "\r\n"]
+[1.965, "o", "**Framework**: Langchain\r\n"]
+[2.025, "o", "**Complaint**: Traceback (most recent call last): File 'app.py', line 3, in <module> from langchain import ChatOpenAI ImportError: cannot import name 'ChatOpenAI' from 'langchain'\r\n"]
+[2.085, "o", "\r\n"]
+[2.145, "o", "---\r\n"]
+[2.205, "o", "\r\n"]
+[2.265, "o", "## [LOOK] Identification\r\n"]
+[2.325, "o", "\r\n"]
+[2.385, "o", "- **Framework**: Langchain\r\n"]
+[2.445, "o", "- **Error Type**: ImportError\r\n"]
+[2.505, "o", "- **CHT Code**: `CHT-UNK-000` 未分类问题 / Unclassified Issue\r\n"]
+[2.565, "o", "- **Category**: UNK (未分类问题)\r\n"]
+[2.625, "o", "\r\n"]
+[2.685, "o", "## [LISTEN] Category Assessment\r\n"]
+[2.745, "o", "\r\n"]
+[2.805, "o", "- **Root Cause Category**: 未分类问题 / Unclassified Issue\r\n"]
+[2.865, "o", "- **Severity**: MEDIUM\r\n"]
+[2.925, "o", "- **Matched Cases**: 1\r\n"]
+[2.985, "o", "\r\n"]
+[3.045, "o", "## [DIAGNOSE] Root Cause Analysis\r\n"]
+[3.105, "o", "\r\n"]
+[3.165, "o", "⚠️ 未配置 LLM API Key，无法使用 AI 诊断功能。\r\n"]
+[3.225, "o", "\r\n"]
+[3.285, "o", "你可以：\r\n"]
+[3.345, "o", "1. 在搜索框下方的「开发者设置」中填入你的 API Key\r\n"]
+[3.405, "o", "2. 或在 `.env` 文件中配置相应的 Key（如 OPENAI_API_KEY, DEEPSEEK_API_KEY 等）\r\n"]
+[3.465, "o", "   - 支持本地模型，通过 OLLAMA_BASE_URL 接入无需 Key\r\n"]
+[3.525, "o", "\r\n"]
+[3.585, "o", "配置后即可使用 AI 望闻问切诊断。\r\n"]
+[3.645, "o", "\r\n"]
+[3.705, "o", "当前可以使用「向量搜索」模式直接搜索知识库中的病例。\r\n"]
+[3.765, "o", "\r\n"]
+[3.825, "o", "## [PRESCRIBE] Knowledge-Base Cure\r\n"]
+[3.885, "o", "\r\n"]
+[3.945, "o", "LLM diagnosis is unavailable, but the local prescription library already matched a concrete cure:\r\n"]
+[4.005, "o", "\r\n"]
+[4.065, "o", "**Source Case**: LangChain 0.3 升级后 ChatOpenAI 导入失败 (82% relevance, Permanent)\r\n"]
+[4.125, "o", "**Case File**: `cases\\langchain\\import-error\\chatmodel-import-001.md`\r\n"]
+[4.185, "o", "\r\n"]
+[4.245, "o", "## 💊 药方\r\n"]
+[4.305, "o", "Prescriptions\r\n"]
+[4.365, "o", "\r\n"]
+[4.425, "o", "### 药方 1：更新导入路径 ✅ 推荐\r\n"]
+[4.485, "o", "\r\n"]
+[4.545, "o", "**适用版本**: `langchain >= 0.3.0`\r\n"]
+[4.605, "o", "\r\n"]
+[4.665, "o", "1. 安装独立的 OpenAI 集成包：\r\n"]
+[4.725, "o", "\r\n"]
+[4.785, "o", "```bash\r\n"]
+[4.845, "o", "pip install langchain-openai\r\n"]
+[4.905, "o", "```\r\n"]
+[4.965, "o", "\r\n"]
+[5.025, "o", "2. 更新导入语句：\r\n"]
+[5.085, "o", "\r\n"]
+[5.145, "o", "```python\r\n"]
+[5.205, "o", "# ❌ 旧写法（0.2.x 及更早）\r\n"]
+[5.265, "o", "from langchain import ChatOpenAI\r\n"]
+[5.325, "o", "\r\n"]
+[5.385, "o", "# ✅ 新写法（0.3.x）\r\n"]
+[5.445, "o", "from langchain_openai import ChatOpenAI\r\n"]
+[5.505, "o", "```\r\n"]
+[5.565, "o", "\r\n"]
+[5.625, "o", "3. 其他常用类的迁移：\r\n"]
+[5.685, "o", "\r\n"]
+[5.745, "o", "```python\r\n"]
+[5.805, "o", "# Embeddings\r\n"]
+[5.865, "o", "from langchain_openai import OpenAIEmbeddings\r\n"]
+[5.925, "o", "\r\n"]
+[5.985, "o", "# LLM\r\n"]
+[6.045, "o", "from langchain_openai import OpenAI\r\n"]
+[6.105, "o", "```\r\n"]
+[6.165, "o", "\r\n"]
+[6.225, "o", "---\r\n"]
+[6.285, "o", "\r\n"]
+[6.345, "o", "## Confidence Assessment\r\n"]
+[6.405, "o", "\r\n"]
+[6.465, "o", "- **Confidence**: **MEDIUM** (48/100)\r\n"]
+[6.525, "o", "- **Basis**: 1 related case(s), top relevance 82%\r\n"]
+[6.585, "o", "- **Mode**: pattern match / related cases available\r\n"]
+[6.645, "o", "\r\n"]
+[6.705, "o", "## Matched Cases\r\n"]
+[6.765, "o", "\r\n"]
+[6.825, "o", "| # | Case | Framework | Relevance | Severity | Source |\r\n"]
+[6.885, "o", "|:-:|:-----|:---------:|:---------:|:--------:|:------:|\r\n"]
+[6.945, "o", "| 1 | LangChain 0.3 升级后 ChatOpenAI 导入失败 | langchain | 82% | medium | Permanent |\r\n"]
+[7.005, "o", "\r\n"]

assets/cli_emergency_diagnosis_demo.gif

@@ -2412,13 +2412,14 @@ def build_marketplace_submission_copy_pack(
         "contributor_counting_rule": contributor_rule,
         "pypi": {
             "short": (
-                "CyberHuaTuo turns AI-agent failures into reusable prescriptions, MCP tools, "
-                "and a First Soul Ring contribution loop."
+                "CyberHuaTuo lets developers paste AI-agent tracebacks and get root cause, "
+                "exact fixes, verification steps, and reusable prescriptions."
             ),
             "long": (
                 f"CyberHuaTuo {release} ships a Python CLI, shared MCP server, Codex plugin, "
-                "Claude Desktop MCPB package, and real-data soul-ring growth surfaces for "
-                f"{clean_framework} debugging workflows."
+                "and Claude Desktop MCPB package for paste-a-traceback diagnosis across "
+                f"{clean_framework} and other AI-agent debugging workflows. After a real cure, "
+                "fixes can still flow into real-data soul-ring growth surfaces."
             ),
             "project_urls": [
                 ("Homepage", repo_url),
@@ -2430,7 +2431,7 @@ def build_marketplace_submission_copy_pack(
             "commands": [install_command, mcp_command],
         },
         "claude": {
-            "short": "One-click Claude Desktop extension for CyberHuaTuo AI-agent diagnosis and soul-ring contribution routing.",
+            "short": "One-click Claude Desktop extension for paste-a-traceback CyberHuaTuo AI-agent diagnosis.",
             "install_note": (
                 "Install `dist/cyberhuatuo-claude-desktop.mcpb` in Claude Desktop after validating the bundle."
             ),
@@ -2442,29 +2443,31 @@ def build_marketplace_submission_copy_pack(
             "review_notes": [
                 "Tool annotations distinguish read-only reports from ledger-writing tools.",
                 "Privacy policy is linked from `claude-desktop/manifest.json`.",
-                "Working examples route diagnose, market-ready, proof-pack, and first-ring contribution flows.",
+                "Working examples lead with diagnose, then route market-ready, proof-pack, and first-ring contribution flows.",
             ],
         },
         "codex": {
             "short": (
-                "Codex plugin bundle for diagnosing AI-agent failures, using CyberHuaTuo MCP tools, "
-                "and following a team soul-ring contribution process."
+                "Codex plugin bundle for pasting AI-agent tracebacks, getting exact CyberHuaTuo fixes, "
+                "and optionally following a team soul-ring contribution process."
             ),
             "files": [".codex-plugin/plugin.json", ".agents/plugins/marketplace.json", ".mcp.json"],
             "install_commands": [
                 f"codex plugin marketplace add {slug}",
                 "codex mcp list",
             ],
             "usage_prompt": (
-                f"Use CyberHuaTuo to diagnose this {clean_framework} failure, then generate my First Soul Ring path."
+                f"Paste this {clean_framework} traceback into CyberHuaTuo, return the exact fix, "
+                "then generate my optional First Soul Ring path."
             ),
         },
         "github_release": {
             "command": release_command,
             "web_links": release_web_links,
             "post": (
-                f"CyberHuaTuo {release} is the public growth-loop release: PyPI install, Claude MCPB, "
-                "Codex plugin metadata, IssueOps proof routes, and First Soul Ring contributor activation."
+                f"CyberHuaTuo {release} is the public AI-agent error doctor release: PyPI install, "
+                "Claude MCPB, Codex plugin metadata, a paste-a-traceback diagnosis path, IssueOps proof routes, "
+                "and First Soul Ring contributor activation after real cures."
             ),
         },
         "submission_portals": submission_portals,
@@ -2479,7 +2482,8 @@ def build_marketplace_submission_copy_pack(
             "bounty_command": bounty_command,
             "traction_command": traction_command,
             "copy": (
-                f"CyberHuaTuo {release} public proof sprint: target {target} real first-ring contributors. "
+                f"CyberHuaTuo {release} public proof sprint: first show paste-a-traceback diagnosis, "
+                f"then target {target} real first-ring contributors. "
                 f"Start with `{install_decision_command}` or MCP `{install_decision['mcp_tool']}`, "
                 f"paste its Recommended Install, run `{mcp_command}` for agent clients, submit a real "
                 "First Soul Ring prescription or request the Bounty Board for claimable framework gaps, "
@@ -2501,6 +2505,8 @@ def build_marketplace_submission_copy_pack(
         },
         "maintainer_announcement": (
             f"CyberHuaTuo {release} is ready for PyPI, Claude Desktop MCPB, and Codex plugin submission copy. "
+            "Lead every channel with the error doctor promise: paste an AI-agent traceback, get root cause, "
+            "exact fix, and verification steps. "
             f"The first public loop is simple: `{install_decision_command}`, paste its Recommended Install, "
             "run the First Soul Ring challenge, publish a "
             f"real {clean_framework} prescription, request claimable gaps with `{bounty_command}`, "