ht32-code-mcp 0.2.3__tar.gz → 0.2.5__tar.gz

{ht32_code_mcp-0.2.3 → ht32_code_mcp-0.2.5}/DEPLOY.md

@@ -363,7 +363,7 @@ uv lock && uv build && uv publish
 |---|------|------|------|
 | 3.1 | MCP 工具实现（7 检索/导出 + 1 反馈） | `.work/mcp-server/src/ht32_code_mcp/`（FastMCP） | ✅ |
 | 3.2 | 工具级测试 | `pytest` 46 用例全绿 | ✅ |
-| 3.3 | PyPI 发布（hatchling） | `ht32-code-mcp` 0.2.2（2026-09-23，含 bundle 通道 + 统一反馈/用量日志 + 软失败识别 + 原生 Streamable HTTP） | ✅ |
+| 3.3 | PyPI 发布（hatchling） | `ht32-code-mcp` 0.2.3（2026-09-24，含全系列固件库覆盖 + 6 模板多模板导出） | ✅ |
 | 3.4 | 云端 git clone + 挂载 | `/opt/ht32-code:/app/code` | ✅ |
 | 3.5 | 1Panel 部署（uvx + supergateway → streamableHttp stateful，镜像 next-uvx） | `https://mcp.s621.work/ht32-code` | ✅ |
 | 3.6 | OpenResty 超时修复（`proxy_read_timeout 3600s`） | 修复 60s 空闲断连；2026-09-21 复核两端空闲 100s 后调用仍 200，未被 1Panel 回退 | ✅ |

{ht32_code_mcp-0.2.3 → ht32_code_mcp-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ht32-code-mcp
-Version: 0.2.3
+Version: 0.2.5
 Summary: HT32 Code MCP Server - 为 AI Agent 提供 HT32 函数库/例程/模板检索与工程导出
 License-Expression: MIT
 Keywords: firmware,holtek,ht32,mcp,mcu

{ht32_code_mcp-0.2.3 → ht32_code_mcp-0.2.5}/e2e_scenario_a.py

@@ -1,142 +1,164 @@
-"""P0-4 场景 a 端到端驱动：双 MCP 本地 stdio 真实子进程跑通新建工程链路。
-
-流程（对应 ht32-skills/ht32-project-create）：
-  wiki-mcp: get_model + get_chip_info（HT32F52352 规格核对）
-  code-mcp: tools/list（7 工具）→ get_project_manifest → export_project_bundle → 落盘核对
-
-用法：
-    <code-venv-python> e2e_scenario_a.py [--chip HT32F52352]
-输出：
-    %TEMP%/ht32_p0_4_e2e/wiki_chip_info.txt | manifest.txt | export.txt
-    %TEMP%/ht32_p0_4_e2e/stage/<chip>_demo/  导出产物（编译对象）
-退出码 0 全通过；1 失败。
-"""
-from __future__ import annotations
-
-import argparse
-import asyncio
-import os
-import shutil
-import sys
-from pathlib import Path
-
-from fastmcp import Client
-from fastmcp.client.transports import StdioTransport
-
-CODE_MCP_DIR = Path(__file__).resolve().parent
-WIKI_MCP_DIR = Path(r"d:\HoltekWork\WorkDesktop\ht32_ai_mcp\ht32-wiki\.work\mcp-server")
-WIKI_ROOT = WIKI_MCP_DIR.parents[1]
-
-CODE_PY = CODE_MCP_DIR / ".venv" / "Scripts" / "python.exe"
-WIKI_PY = WIKI_MCP_DIR / ".venv" / "Scripts" / "python.exe"
-
-EXPECTED_TOOLS = {
-    "get_code_version", "list_libraries", "find_example", "get_file",
-    "search_code_knowledge", "get_project_manifest", "export_project_bundle",
-}
-
-WORK = Path(os.environ.get("TEMP", ".")) / "ht32_p0_4_e2e"
-
-failed = 0
-
-
-def check(name: str, cond: bool, detail: str = "") -> bool:
-    global failed
-    suffix = f" — {detail}" if detail else ""
-    print(f"{'✅' if cond else '❌'} [{name}]{suffix}")
-    if not cond:
-        failed += 1
-    return cond
-
-
-async def call_text(client: Client, tool: str, args: dict) -> str:
-    r = await client.call_tool(tool, args)
-    parts = [c.text for c in r.content if getattr(c, "text", None)]
-    return "\n".join(parts)
-
-
-def wiki_transport() -> StdioTransport:
-    env = dict(os.environ)
-    env.update({"WIKI_ROOT": str(WIKI_ROOT), "MCP_TRANSPORT": "stdio",
-                "MCP_WARMUP": "1", "DS_RAG_AUTOBUILD": "0"})
-    for key in ("EMBED_API_KEY", "SILICONFLOW_API_KEY", "RERANK_API_KEY"):
-        env.pop(key, None)
-    return StdioTransport(str(WIKI_PY), ["-m", "ht32_wiki_mcp"],
-                          env=env, cwd=str(WIKI_MCP_DIR))
-
-
-def code_transport() -> StdioTransport:
-    env = dict(os.environ)
-    env["CODE_ROOT"] = str(CODE_MCP_DIR.parents[1])
-    return StdioTransport(str(CODE_PY), ["-m", "ht32_code_mcp"],
-                          env=env, cwd=str(CODE_MCP_DIR))
-
-
-async def phase_wiki(chip: str) -> str:
-    print("\n========== 阶段 1 · wiki-mcp 规格核对 ==========")
-    async with Client(wiki_transport()) as client:
-        model_text = await call_text(client, "get_model", {"model": chip})
-        check("get_model 返回系列映射", "系列：" in model_text,
-              model_text.splitlines()[0] if model_text else "(空)")
-        chip_text = await call_text(client, "get_chip_info", {"model": chip})
-        check("get_chip_info 命中系列页", "未找到" not in chip_text and len(chip_text) > 200,
-              f"{len(chip_text)} 字符")
-        (WORK / "wiki_chip_info.txt").write_text(
-            f"== get_model({chip}) ==\n{model_text}\n\n== get_chip_info({chip}) ==\n{chip_text}",
-            encoding="utf-8")
-        print(f"规格核对全文已存 {WORK / 'wiki_chip_info.txt'}")
-        return chip_text
-
-
-async def phase_code(chip: str) -> Path:
-    print("\n========== 阶段 2 · code-mcp manifest + export ==========")
-    stage = WORK / "stage" / f"{chip.lower()}_demo"
-    if stage.exists():
-        shutil.rmtree(stage)
-    stage.parent.mkdir(parents=True, exist_ok=True)
-
-    async with Client(code_transport()) as client:
-        tools = {t.name for t in await client.list_tools()}
-        check("7 工具注册齐全", EXPECTED_TOOLS <= tools,
-              f"{len(tools)} 个" if EXPECTED_TOOLS <= tools else f"缺 {EXPECTED_TOOLS - tools}")
-
-        manifest = await call_text(client, "get_project_manifest", {})
-        check("manifest 返回模板清单", "工程模板清单" in manifest,
-              manifest.splitlines()[0] if manifest else "(空)")
-        (WORK / "manifest.txt").write_text(manifest, encoding="utf-8")
-
-        export = await call_text(client, "export_project_bundle",
-                                  {"chip": chip, "out_dir": str(stage)})
-        check("export_project_bundle 成功", "导出失败" not in export and stage.is_dir(),
-              export.splitlines()[0] if export else "(空)")
-        (WORK / "export.txt").write_text(export, encoding="utf-8")
-
-    uvprojx = list(stage.rglob("*.uvprojx"))
-    check("落盘核对：.uvprojx 存在", len(uvprojx) == 1, str(uvprojx))
-    files = [p for p in stage.rglob("*") if p.is_file()]
-    check("落盘核对：工程文件数 > 20", len(files) > 20, f"{len(files)} 个文件")
-    print(f"导出产物：{stage}")
-    return stage
-
-
-async def main() -> int:
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--chip", default="HT32F52352")
-    args = parser.parse_args()
-    WORK.mkdir(parents=True, exist_ok=True)
-    if not (WIKI_PY.is_file() and CODE_PY.is_file()):
-        print("❌ 找不到 venv 解释器", file=sys.stderr)
-        return 1
-
-    await phase_wiki(args.chip)
-    stage = await phase_code(args.chip)
-
-    print("\n========== 摘要 ==========")
-    print(f"工作目录: {WORK}")
-    print(f"导出工程: {stage}")
-    print(f"结果: {'✅ 全部通过' if failed == 0 else f'❌ {failed} 项失败'}")
-    return 0 if failed == 0 else 1
-
-
-if __name__ == "__main__":
-    raise SystemExit(asyncio.run(main()))
+"""P0-4 场景 a 端到端驱动：双 MCP 本地 stdio 真实子进程跑通新建工程链路。
+
+流程（对应 ht32-skills/ht32-project-create）：
+  wiki-mcp: get_model + get_chip_info（HT32F52352 规格核对）
+  code-mcp: tools/list（7 工具）→ get_project_manifest → export_project_bundle → 落盘核对
+
+用法：
+    <code-venv-python> e2e_scenario_a.py [--chip HT32F52352]
+输出：
+    %TEMP%/ht32_p0_4_e2e/wiki_chip_info.txt | manifest.txt | export.txt
+    %TEMP%/ht32_p0_4_e2e/stage/<chip>_demo/  导出产物（编译对象）
+退出码 0 全通过；1 失败。
+"""
+from __future__ import annotations
+
+import argparse
+import asyncio
+import json
+import os
+import shutil
+import sys
+from pathlib import Path
+
+from fastmcp import Client
+from fastmcp.client.transports import StdioTransport
+
+CODE_MCP_DIR = Path(__file__).resolve().parent
+CODE_ROOT = CODE_MCP_DIR.parents[1]
+WIKI_MCP_DIR = Path(r"d:\HoltekWork\WorkDesktop\ht32_ai_mcp\ht32-wiki\.work\mcp-server")
+WIKI_ROOT = WIKI_MCP_DIR.parents[1]
+
+CODE_PY = CODE_MCP_DIR / ".venv" / "Scripts" / "python.exe"
+WIKI_PY = WIKI_MCP_DIR / ".venv" / "Scripts" / "python.exe"
+
+EXPECTED_TOOLS = {
+    "get_code_version", "list_libraries", "find_example", "get_file",
+    "search_code_knowledge", "get_project_manifest", "export_project_bundle",
+}
+
+WORK = Path(os.environ.get("TEMP", ".")) / "ht32_p0_4_e2e"
+
+failed = 0
+
+
+def check(name: str, cond: bool, detail: str = "") -> bool:
+    global failed
+    suffix = f" — {detail}" if detail else ""
+    print(f"{'✅' if cond else '❌'} [{name}]{suffix}")
+    if not cond:
+        failed += 1
+    return cond
+
+
+async def call_text(client: Client, tool: str, args: dict) -> str:
+    r = await client.call_tool(tool, args)
+    parts = [c.text for c in r.content if getattr(c, "text", None)]
+    return "\n".join(parts)
+
+
+def wiki_transport() -> StdioTransport:
+    env = dict(os.environ)
+    env.update({"WIKI_ROOT": str(WIKI_ROOT), "MCP_TRANSPORT": "stdio",
+                "MCP_WARMUP": "1", "DS_RAG_AUTOBUILD": "0"})
+    for key in ("EMBED_API_KEY", "SILICONFLOW_API_KEY", "RERANK_API_KEY"):
+        env.pop(key, None)
+    return StdioTransport(str(WIKI_PY), ["-m", "ht32_wiki_mcp"],
+                          env=env, cwd=str(WIKI_MCP_DIR))
+
+
+def devices_entry(chip: str) -> dict:
+    """该型号在 raw/templates/*/devices.json 中的参数条目（用于核对导出产物）。"""
+    for dj in sorted((CODE_ROOT / "raw" / "templates").glob("*/devices.json")):
+        for d in json.loads(dj.read_text(encoding="utf-8")).get("devices", []):
+            if d.get("device", "").upper() == chip.upper():
+                return d
+    return {}
+
+
+def code_transport() -> StdioTransport:
+    env = dict(os.environ)
+    env["CODE_ROOT"] = str(CODE_ROOT)
+    return StdioTransport(str(CODE_PY), ["-m", "ht32_code_mcp"],
+                          env=env, cwd=str(CODE_MCP_DIR))
+
+
+async def phase_wiki(chip: str) -> str:
+    print("\n========== 阶段 1 · wiki-mcp 规格核对 ==========")
+    async with Client(wiki_transport()) as client:
+        model_text = await call_text(client, "get_model", {"model": chip})
+        check("get_model 返回系列映射", "系列：" in model_text,
+              model_text.splitlines()[0] if model_text else "(空)")
+        chip_text = await call_text(client, "get_chip_info", {"model": chip})
+        check("get_chip_info 命中系列页", "未找到" not in chip_text and len(chip_text) > 200,
+              f"{len(chip_text)} 字符")
+        (WORK / "wiki_chip_info.txt").write_text(
+            f"== get_model({chip}) ==\n{model_text}\n\n== get_chip_info({chip}) ==\n{chip_text}",
+            encoding="utf-8")
+        print(f"规格核对全文已存 {WORK / 'wiki_chip_info.txt'}")
+        return chip_text
+
+
+async def phase_code(chip: str) -> Path:
+    print("\n========== 阶段 2 · code-mcp manifest + export ==========")
+    stage = WORK / "stage" / f"{chip.lower()}_demo"
+    if stage.exists():
+        shutil.rmtree(stage)
+    stage.parent.mkdir(parents=True, exist_ok=True)
+
+    async with Client(code_transport()) as client:
+        tools = {t.name for t in await client.list_tools()}
+        check("7 工具注册齐全", EXPECTED_TOOLS <= tools,
+              f"{len(tools)} 个" if EXPECTED_TOOLS <= tools else f"缺 {EXPECTED_TOOLS - tools}")
+
+        manifest = await call_text(client, "get_project_manifest", {})
+        check("manifest 返回模板清单", "工程模板清单" in manifest,
+              manifest.splitlines()[0] if manifest else "(空)")
+        (WORK / "manifest.txt").write_text(manifest, encoding="utf-8")
+
+        export = await call_text(client, "export_project_bundle",
+                                  {"chip": chip, "out_dir": str(stage)})
+        check("export_project_bundle 成功", "导出失败" not in export and stage.is_dir(),
+              export.splitlines()[0] if export else "(空)")
+        (WORK / "export.txt").write_text(export, encoding="utf-8")
+
+    uvprojx = list(stage.rglob("*.uvprojx"))
+    check("落盘核对：.uvprojx 存在", len(uvprojx) == 1, str(uvprojx))
+    files = [p for p in stage.rglob("*") if p.is_file()]
+    check("落盘核对：工程文件数 > 20", len(files) > 20, f"{len(files)} 个文件")
+    # 导出参数化自检（W3 回归）：内存布局 / Target 名 / SVD 都必须随型号改写，
+    # 否则链接器会按模板默认型号的容量静默放行
+    entry = devices_entry(chip)
+    text = uvprojx[0].read_text(encoding="utf-8") if uvprojx else ""
+    check("导出参数化：<Cpu> 与参数表一致",
+          bool(entry.get("cpu")) and f"<Cpu>{entry['cpu']}</Cpu>" in text,
+          entry.get("cpu", "参数表缺 cpu"))
+    check("导出参数化：Target/输出名 = 型号（缺省）",
+          f"<TargetName>{chip.upper()}</TargetName>" in text
+          and f"<OutputName>{chip.upper()}</OutputName>" in text)
+    check("导出参数化：<SFDFile> 指向型号", f"$$Device:{chip.upper()}$" in text)
+    print(f"导出产物：{stage}")
+    return stage
+
+
+async def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--chip", default="HT32F52352")
+    args = parser.parse_args()
+    WORK.mkdir(parents=True, exist_ok=True)
+    if not (WIKI_PY.is_file() and CODE_PY.is_file()):
+        print("❌ 找不到 venv 解释器", file=sys.stderr)
+        return 1
+
+    await phase_wiki(args.chip)
+    stage = await phase_code(args.chip)
+
+    print("\n========== 摘要 ==========")
+    print(f"工作目录: {WORK}")
+    print(f"导出工程: {stage}")
+    print(f"结果: {'✅ 全部通过' if failed == 0 else f'❌ {failed} 项失败'}")
+    return 0 if failed == 0 else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(asyncio.run(main()))

{ht32_code_mcp-0.2.3 → ht32_code_mcp-0.2.5}/pyproject.toml

@@ -1,35 +1,35 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "ht32-code-mcp"
-version = "0.2.3"
-description = "HT32 Code MCP Server - 为 AI Agent 提供 HT32 函数库/例程/模板检索与工程导出"
-requires-python = ">=3.11"
-license = "MIT"
-keywords = ["ht32", "mcu", "mcp", "firmware", "holtek"]
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Topic :: Software Development :: Embedded Systems",
-]
-dependencies = [
-    "fastmcp>=0.5.0",
-]
-
-[project.optional-dependencies]
-dev = [
-    "pytest>=8.0",
-]
-
-[project.scripts]
-ht32-code-mcp = "ht32_code_mcp.server:main"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/ht32_code_mcp"]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ht32-code-mcp"
+version = "0.2.5"
+description = "HT32 Code MCP Server - 为 AI Agent 提供 HT32 函数库/例程/模板检索与工程导出"
+requires-python = ">=3.11"
+license = "MIT"
+keywords = ["ht32", "mcu", "mcp", "firmware", "holtek"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Embedded Systems",
+]
+dependencies = [
+    "fastmcp>=0.5.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+]
+
+[project.scripts]
+ht32-code-mcp = "ht32_code_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ht32_code_mcp"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]