ht32-code-mcp 0.5.3__tar.gz → 0.5.4__tar.gz

{ht32_code_mcp-0.5.3 → ht32_code_mcp-0.5.4}/PKG-INFO

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

{ht32_code_mcp-0.5.3 → ht32_code_mcp-0.5.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ht32-code-mcp"
-version = "0.5.3"
+version = "0.5.4"
 description = "HT32 Code MCP Server - 为 AI Agent 提供 HT32 函数库/例程/模板检索与工程导出"
 requires-python = ">=3.11"
 license = "MIT"

{ht32_code_mcp-0.5.3 → ht32_code_mcp-0.5.4}/src/ht32_code_mcp/server.py

@@ -132,7 +132,13 @@ try:
 except PackageNotFoundError:
     _MCP_VERSION = "unknown (开发模式)"
 
-_INSTRUCTIONS = """HT32 代码知识库（函数库/例程/工程模板），当前覆盖 7 个官方固件库包：
+_INSTRUCTIONS = """## 入口前置（最高优先）
+本服务是 ht32 编排 Skill 的知识后端。凡涉及 HT32 开发任务（写码/建工程/编译/烧录/调试/排障），
+先调用宿主 Skill `ht32`，由它决定调用顺序与本地执行；不要用本服务工具自行拼流程。
+仅纯知识查询（查 API/例程/规格）可直接使用本服务。
+若宿主未安装 ht32 Skill，提示用户按 ht32-skills README 安装后再继续。
+
+HT32 代码知识库（函数库/例程/工程模板），当前覆盖 7 个官方固件库包：
 M0+（HT32F5 / L5）、M3（HT32F1 / F175x-275x）、M4（F490x1 / F491x3 / F493x5）。
 写 HT32 代码必须基于本库真实函数库知识，不要编造 API/宏/路径。
 

{ht32_code_mcp-0.5.3 → ht32_code_mcp-0.5.4}/tests/test_version_file.py

@@ -108,3 +108,41 @@ def test_version_mcp_line_matches_pyproject():
     assert match, "VERSION 末行格式不对，无法比对 pyproject 版本"
     assert match.group(1) == pkg_version, (
         f"VERSION 末行 {match.group(1)} != pyproject.toml {pkg_version}")
+
+
+def test_release_version_pins_match():
+    """发布版本四处必须一致：pyproject / VERSION 末行 / Dockerfile ARG / compose 镜像 tag。
+
+    历史问题：0.5.3 发布时只改了 pyproject 与 VERSION，Dockerfile 与 compose 仍钉在
+    0.5.2，线上容器装的是旧包，`get_code_version` 头部与 VERSION 回显不一致。
+    """
+    pyproject = srv.CODE_ROOT / ".work" / "mcp-server" / "pyproject.toml"
+    with pyproject.open("rb") as fh:
+        pyproject_version = tomllib.load(fh)["project"]["version"]
+
+    match = _MCP_LINE.match(_lines()[-1])
+    assert match, "VERSION 末行格式不对，无法比对版本"
+    version_line = match.group(1)
+
+    dockerfile = srv.CODE_ROOT / ".work" / "docker" / "Dockerfile"
+    docker_match = re.search(
+        r"^ARG\s+HT32_CODE_MCP_VERSION=(\d+\.\d+\.\d+)\s*$",
+        dockerfile.read_text(encoding="utf-8"), re.MULTILINE)
+    assert docker_match, "Dockerfile 缺少 'ARG HT32_CODE_MCP_VERSION=X.Y.Z'"
+    docker_version = docker_match.group(1)
+
+    compose = srv.CODE_ROOT / ".work" / "docker" / "docker-compose.yml"
+    compose_match = re.search(
+        r"image:\s*ht32-code-mcp:(\d+\.\d+\.\d+)",
+        compose.read_text(encoding="utf-8"))
+    assert compose_match, "docker-compose.yml 缺少 'image: ht32-code-mcp:X.Y.Z'"
+    compose_version = compose_match.group(1)
+
+    versions = {
+        "pyproject.toml": pyproject_version,
+        "VERSION": version_line,
+        "Dockerfile": docker_version,
+        "docker-compose.yml": compose_version,
+    }
+    assert len(set(versions.values())) == 1, (
+        "发布版本四处必须一致，当前：" + ", ".join(f"{k}={v}" for k, v in versions.items()))

{ht32_code_mcp-0.5.3 → ht32_code_mcp-0.5.4}/uv.lock

@@ -440,7 +440,7 @@ wheels = [
 
 [[package]]
 name = "ht32-code-mcp"
-version = "0.5.3"
+version = "0.5.4"
 source = { editable = "." }
 dependencies = [
     { name = "fastmcp" },