ht32-code-mcp 0.4.2__tar.gz → 0.4.3__tar.gz

{ht32_code_mcp-0.4.2 → ht32_code_mcp-0.4.3}/PKG-INFO

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

{ht32_code_mcp-0.4.2 → ht32_code_mcp-0.4.3}/pyproject.toml

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

{ht32_code_mcp-0.4.2 → ht32_code_mcp-0.4.3}/src/ht32_code_mcp/server.py

@@ -98,7 +98,8 @@ M0+（HT32F5 / L5）、M3（HT32F1 / F175x-275x）、M4（F490x1 / F491x3 / F493
 - 知识库缺了用户需要的内容，你只能用推测回答
 - 导出工程有缺陷（编译失败、型号参数错、缺文件）
 - **ht32-skills（编排层：流程/脚本/模板/环境检测）本身有缺陷**，用 issue_type=skill_defect
-  上报（本渠道是 skill 问题的统一入口），details 里附 ht32-skills 版本号与现象
+  上报（本渠道是 skill 问题的统一入口），`skill_version` 传本机 `ht32.py version` 的版本号，
+  details 里附现象与日志路径
 务必附 model_id；submit_feedback 之外的调用已由服务端自动记入用量日志，无需你重复上报。
 """
 
@@ -561,6 +562,7 @@ def submit_feedback(
     details: str = "",
     model_id: str = "",
     tools_called: list[str] | None = None,
+    skill_version: str = "",
 ) -> str:
     """提交纠正反馈，改进 HT32 代码知识库 / ht32-skills 编排层。
 
@@ -576,9 +578,12 @@ def submit_feedback(
         issue_type: 问题类型，枚举上述其一（skill_defect = ht32-skills 编排层缺陷）
         answer: 你给出的回答原文
         correction: 你认为正确的信息或用户指出的正确内容
-        details: 补充上下文（如编译报错原文；skill_defect 请附 ht32-skills 版本号与现象）
+        details: 补充上下文（如编译报错原文、复现步骤、日志路径）
         model_id: 你的模型标识，如 deepseek-v4-flash
         tools_called: 本次调过的查询工具列表（不含 submit_feedback 自身）
+        skill_version: 本机 ht32-skills 版本，取 `ht32.py version` 的 skill_version
+            （如 "v0.1.19"）。服务端跨进程拿不到客户端 skill 版本，**skill_defect 必填**，
+            否则无从判断缺陷属于哪个版本
     """
     if not question or not question.strip():
         return "错误：question 参数不能为空，请提供用户原始需求。"
@@ -595,6 +600,7 @@ def submit_feedback(
         tools_called=tools_called,
         mcp_version=_MCP_VERSION,
         kb_version=index.data.get("code_version", ""),
+        skill_version=skill_version,
     )
     if path is None:
         return ("错误：反馈未能写入。服务端可能未配置 FEEDBACK_ROOT，"

{ht32_code_mcp-0.4.2 → ht32_code_mcp-0.4.3}/src/ht32_code_mcp/usage.py

@@ -9,7 +9,8 @@
 - **tool_call**（`UsageMiddleware`，服务端自动）：拦截所有工具调用，
   记录工具名、参数原文、耗时、成败。不依赖 Agent 配合，数据完整。
 - **feedback**（`record_feedback`，由各 server 的 `submit_feedback` 工具调用）：
-  记录 Agent 主动上报的语义性问题，middleware 无法判断这些。
+  记录 Agent 主动上报的语义性问题，middleware 无法判断这些。其中 `skill_version`
+  由 Agent 自报（服务端跨进程拿不到客户端 skill 版本），用于定位 ht32-skills 缺陷版本。
 
 目录布局（同根 + 服务子目录）：
 
@@ -38,7 +39,7 @@ from typing import Any
 from fastmcp.server.middleware import Middleware, MiddlewareContext
 
 # 实现版本号：两仓库副本必须一致（各仓测试会校验，防止只改一边造成漂移）
-_IMPL_VERSION = "1.1.0"
+_IMPL_VERSION = "1.2.0"
 
 # 服务名 → 子目录名。新增服务在此登记。
 SERVICE_WIKI = "wiki"
@@ -203,6 +204,7 @@ def record_feedback(
     tools_called: list[str] | None = None,
     mcp_version: str = "",
     kb_version: str = "",
+    skill_version: str = "",
 ) -> Path | None:
     """记录一条 Agent 主动提交的反馈。"""
     record = {
@@ -219,5 +221,6 @@ def record_feedback(
         "tools_called": [t for t in (tools_called or []) if t and t != "submit_feedback"],
         "mcp_version": mcp_version,
         "kb_version": kb_version,
+        "skill_version": skill_version.strip(),
     }
     return write_record(log_dir, FEEDBACK_PREFIX, record)

{ht32_code_mcp-0.4.2 → ht32_code_mcp-0.4.3}/tests/test_tools.py

@@ -677,7 +677,7 @@ def test_version_reports_skill_latest(monkeypatch):
 def test_usage_impl_version_pinned():
     """两仓库的 usage.py 是逐字节相同副本，实现版本号用于防止只改一边。"""
     from ht32_code_mcp import usage
-    assert usage._IMPL_VERSION == "1.1.0"
+    assert usage._IMPL_VERSION == "1.2.0"
     assert usage.SERVICE_CODE == "code"
     assert usage.SERVICE_WIKI == "wiki"
     # 噪声参数含 out_dir（code 特有：可能含用户本地路径）
@@ -735,6 +735,7 @@ def test_submit_feedback_writes_jsonl(tmp_path, monkeypatch):
         details="编译报错 too few arguments",
         model_id="deepseek-v4-flash",
         tools_called=["search_code_knowledge", "submit_feedback", "get_file"],
+        skill_version="v0.1.19",
     )
     assert "反馈已记录" in out
     f = next((tmp_path / "logs").glob("feedback_*.jsonl"))
@@ -747,6 +748,8 @@ def test_submit_feedback_writes_jsonl(tmp_path, monkeypatch):
     # submit_feedback 自身被过滤，只留查询类工具
     assert rec["tools_called"] == ["search_code_knowledge", "get_file"]
     assert rec["mcp_version"] and rec["kb_version"]
+    # 客户端 skill 版本是结构化字段（不再靠 details 散文），未传时为空串而非缺键
+    assert rec["skill_version"] == "v0.1.19"
 
 
 def test_submit_feedback_accepts_skill_defect(tmp_path, monkeypatch):
@@ -757,11 +760,22 @@ def test_submit_feedback_accepts_skill_defect(tmp_path, monkeypatch):
         issue_type="skill_defect",
         details="ht32-skills v0.1.0；导出后 uvprojx 未按工程名重命名",
         model_id="deepseek-v4-flash",
+        skill_version="v0.1.0",
     )
     assert "skill_defect" in out
     f = next((tmp_path / "logs").glob("feedback_*.jsonl"))
     rec = json.loads(f.read_text(encoding="utf-8").splitlines()[0])
     assert rec["issue_type"] == "skill_defect"
+    assert rec["skill_version"] == "v0.1.0"
+
+
+def test_feedback_skill_version_key_always_present(tmp_path, monkeypatch):
+    """没传 skill_version 时字段仍存在（空串），日志消费方不必分支判键。"""
+    monkeypatch.setattr(srv, "LOG_DIR", str(tmp_path / "logs"))
+    srv.submit_feedback(question="x", issue_type="other")
+    f = next((tmp_path / "logs").glob("feedback_*.jsonl"))
+    rec = json.loads(f.read_text(encoding="utf-8").splitlines()[0])
+    assert rec["skill_version"] == ""
 
 
 def test_submit_feedback_empty_question(tmp_path, monkeypatch):

{ht32_code_mcp-0.4.2 → ht32_code_mcp-0.4.3}/uv.lock

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