fix: 统一 CodeGuard 英文显示名称并补齐标准 MCP 配置 (#91)

* fix: 统一 CodeGuard 英文显示名称并补齐标准 MCP 配置

* docs: 将标准 MCP 说明纳入现有双语章节

---------

Co-authored-by: hiwepy@gmail.com <wandl123!@#>

Author: loong10k

.agents/plugins/marketplace.json

@@ -1,28 +1,28 @@
 {
   "name": "partme-ai-codeguard",
   "interface": {
-    "displayName": "代码规范守卫"
+    "displayName": "CodeGuard"
   },
   "plugins": [
     {
       "name": "codeguard",
       "source": {
         "source": "url",
         "url": "https://github.com/full-stack-plugins/codeguard-plugin.git",
-        "ref": "v0.18.2"
+        "ref": "v0.18.3"
       },
       "policy": {
         "installation": "AVAILABLE",
         "authentication": "ON_USE"
       },
       "category": "Developer Tools",
-      "version": "0.18.2",
+      "version": "0.18.3",
       "description": "Evidence-backed code checks and Git content gates for AI assistants, with Maven/Gradle module impact analysis. Save hooks provide feedback; unverified checks are explicit.",
-      "icon": "https://cdn.jsdelivr.net/gh/full-stack-plugins/codeguard-plugin@v0.18.2/assets/official-logo.png",
+      "icon": "https://cdn.jsdelivr.net/gh/full-stack-plugins/codeguard-plugin@v0.18.3/assets/official-logo.png",
       "interface": {
-        "displayName": "代码规范守卫",
+        "displayName": "CodeGuard",
         "shortDescription": "Trustworthy code checks and Java impact analysis",
-        "logo": "https://cdn.jsdelivr.net/gh/full-stack-plugins/codeguard-plugin@v0.18.2/assets/official-logo.png"
+        "logo": "https://cdn.jsdelivr.net/gh/full-stack-plugins/codeguard-plugin@v0.18.3/assets/official-logo.png"
       }
     }
   ]

.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
     {
       "name": "codeguard",
       "description": "Evidence-backed code checks and Git content gates for AI assistants, with Maven/Gradle module impact analysis. Save hooks provide feedback; unverified checks are explicit.",
-      "version": "0.18.2",
+      "version": "0.18.3",
       "source": "./"
     }
   ]

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codeguard",
-  "version": "0.18.2+codex.20260929",
+  "version": "0.18.3+codex.20261003",
   "description": "Evidence-backed code checks and Git content gates for AI assistants, with Maven/Gradle module impact analysis. Save hooks provide feedback; unverified checks are explicit.",
   "author": {
     "name": "Full Stack Skills / PartMe.AI",
@@ -23,7 +23,7 @@
   ],
   "skills": "./skills/",
   "interface": {
-    "displayName": "代码规范守卫",
+    "displayName": "CodeGuard",
     "shortDescription": "Trustworthy code checks and Java impact analysis",
     "longDescription": "Evidence-backed code checks and Git content gates for AI assistants, with Maven/Gradle module impact analysis. Save hooks provide feedback; unverified checks are explicit. Java planning is read-only; executing project checks runs trusted build/test commands, not a security sandbox.",
     "developerName": "Full Stack Skills / PartMe.AI",

.zcode-plugin/plugin.json

@@ -1,11 +1,11 @@
 {
   "name": "codeguard",
-  "displayName": "代码规范守卫",
+  "displayName": "CodeGuard",
   "displayName_i18n": {
-    "en": "代码规范守卫",
+    "en": "CodeGuard",
     "zh-CN": "代码规范检查"
   },
-  "version": "0.18.2",
+  "version": "0.18.3",
   "description": "Evidence-backed code checks and Git content gates for AI assistants, with Maven/Gradle module impact analysis. Save hooks provide feedback; unverified checks are explicit.",
   "description_i18n": {
     "en": "Evidence-backed code checks and Git content gates for AI assistants, with Maven/Gradle module impact analysis. Save hooks provide feedback; unverified checks are explicit.",

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.18.3 — 2026-10-03
+
+- 各宿主和市场清单的显示名称统一为 `CodeGuard`，保留中文本地化翻译。
+
+- 补齐标准根目录 `mcp.json`，让可移植客户端发现已有 CodeGuard stdio MCP 服务。
+- 增加配置发现回归测试，明确依赖安装与工具调用的目标项目路径要求。
+
+
 按版本段落提炼的主题摘要（生成于 2026-09-23，来源：git 历史 212 个提交与各 release 提交）。逐提交细节以 `git log` 与 GitHub Releases 为准；本文件按主题归纳，不逐条罗列。
 
 ## v0.16.1 — 测试可移植性收口与汇流

README.md

@@ -115,6 +115,8 @@ CVE exits: 0 pass, 1 unverified, 2 findings, 3 invalid ecosystem. Maven/npm/pip-
 
 ### MCP server
 
+The root `mcp.json` provides portable Agent Plugins 1.0.0 discovery of the existing CodeGuard stdio server. The host needs Python and the dependencies in `requirements.txt`; installation does not install them automatically. The configured working directory is the plugin root. For `check_code_style`, `auto_fix`, and `analyze_java_impact`, supply the target project’s absolute `path` in each tool call; the plugin directory is not the user project. `list_languages` needs no project path.
+
 ```bash
 # Requires the dependencies declared in requirements.txt.
 python3 scripts/run_check.py --mcp /path/to/project

README.zh-CN.md

@@ -115,6 +115,8 @@ CVE 退出码：0 通过、1 未验证、2 发现漏洞、3 非法生态。Maven
 
 ### MCP 服务
 
+根目录 `mcp.json` 按 Agent Plugins 1.0.0 声明已有 CodeGuard stdio 服务。宿主需要 Python 及 `requirements.txt` 中的依赖，插件不会自动安装。配置工作目录是插件根目录；调用 `check_code_style`、`auto_fix`、`analyze_java_impact` 时必须显式传入目标项目的绝对 `path`，不得把插件目录当作用户项目。`list_languages` 不需要项目路径。
+
 ```bash
 # 需要 requirements.txt 已声明的依赖。
 python3 scripts/run_check.py --mcp /path/to/project

kimi.plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codeguard",
-  "version": "0.18.2",
+  "version": "0.18.3",
   "description": "Evidence-backed code checks and Git content gates for AI assistants, with Maven/Gradle module impact analysis. Save hooks provide feedback; unverified checks are explicit.",
   "author": {
     "name": "Full Stack Skills / PartMe.AI"
@@ -20,7 +20,7 @@
     "pre-commit"
   ],
   "interface": {
-    "displayName": "代码规范守卫",
+    "displayName": "CodeGuard",
     "shortDescription": "Trustworthy code checks and Java impact analysis",
     "longDescription": "Evidence-backed code checks and Git content gates for AI assistants, with Maven/Gradle module impact analysis. Save hooks provide feedback; unverified checks are explicit. Java planning is read-only; executing project checks runs trusted build/test commands, not a security sandbox.",
     "developerName": "Full Stack Skills / PartMe.AI",

mcp.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
+  "mcpServers": {
+    "codeguard": {
+      "type": "stdio",
+      "command": "python",
+      "args": [
+        "-X",
+        "utf8",
+        "./scripts/run_check.py",
+        "--mcp"
+      ],
+      "cwd": "./"
+    }
+  }
+}

openspec/specs/mcp-tool-server/spec.md

@@ -52,3 +52,13 @@ auto_fix MUST 默认仅处理 Git 改动文件并按相同范围复检；无法
 
 - **WHEN** the client calls `list_languages`
 - **THEN** the response enumerates every entry in `scripts/languages.json` with exactly two fields (`id`, `name`) per record
+
+### Requirement: Portable MCP discovery SHALL use root mcp.json
+
+提供已有 MCP 服务的发布包 MUST 在根目录包含标准 `mcp.json`，声明 Agent Plugins 1.0.0 MCP Schema、`stdio` 传输、单独的 Python 可执行命令与参数，指向包内 `scripts/run_check.py --mcp`。不得在可移植 `plugin.json` 中内嵌 `mcpServers`。
+
+#### Scenario: A portable client discovers CodeGuard
+- **WHEN** 客户端读取根目录 `mcp.json`
+- **THEN** 可发现 `codeguard` stdio 服务，配置中的脚本存在于插件包内，Schema 版本与 `plugin.json` 一致
+- **AND** 项目工具调用由客户端显式传入目标项目的绝对 `path`；配置工作目录为插件根，不代表用户项目
+- **AND** MCP SDK 依赖仍通过 `requirements.txt` 声明，不自动安装