cc-vision-hook 0.1.1 → 0.2.0

package/dist/commands/init.js

@@ -0,0 +1,112 @@
+/**
+ * `cvh init` 命令实现：交互式安装向导，一步到位完成
+ * 「选 provider → 填 model/baseUrl/apiKey → 写配置 → 注册 Hook → 可选注册 MCP → 可选立即 enable」。
+ *
+ * 设计取舍：
+ * - 只在 TTY 环境下可用（`process.stdin.isTTY`），非交互环境（CI/脚本管道）直接报错并提示
+ *   改用 `cvh install` + `cvh config set` 组合命令，避免卡在 readline 等待输入。
+ * - 不提供 `--json` 模式——`init` 的本质是"人工问答"，脚本化场景应该走 `install`/`config set`，
+ *   这与其他命令的 `--json` 支持约定不冲突（`init` 本来就不是给脚本用的）。
+ */
+import { createInterface } from "node:readline/promises";
+import { DEFAULT_CONFIG, configFileExists, getConfigPath, loadConfig, saveConfig } from "../config.js";
+import { installHooks } from "../claudeSettings.js";
+import { installMcpServer } from "../claudeMcp.js";
+const VALID_PROVIDERS = ["oai", "responses", "anthropic", "gemini"];
+/** provider -> 默认模型名的建议值，减少用户输入负担（可直接回车采用默认值）。 */
+const DEFAULT_MODEL_BY_PROVIDER = {
+    oai: "gpt-4o-mini",
+    responses: "gpt-4o-mini",
+    anthropic: "claude-3-5-sonnet-latest",
+    gemini: "gemini-2.5-flash",
+};
+/**
+ * 向用户提问一行文字，返回去除首尾空白的回答；回答为空时使用 `defaultValue`。
+ *
+ * @param rl - readline 接口实例
+ * @param question - 提示文字（不含默认值展示，由调用方自行拼接）
+ * @param defaultValue - 用户直接回车时采用的默认值
+ * @returns 用户输入或默认值
+ */
+const ask = async (rl, question, defaultValue) => {
+    const suffix = defaultValue ? ` [${defaultValue}]` : "";
+    const answer = (await rl.question(`${question}${suffix}: `)).trim();
+    return answer || defaultValue || "";
+};
+/**
+ * 向用户提问一个 y/n 问题。
+ *
+ * @param rl - readline 接口实例
+ * @param question - 提示文字
+ * @param defaultYes - 用户直接回车时是否视为"是"
+ * @returns 用户的选择
+ */
+const askYesNo = async (rl, question, defaultYes) => {
+    const suffix = defaultYes ? "[Y/n]" : "[y/N]";
+    const answer = (await rl.question(`${question} ${suffix}: `)).trim().toLowerCase();
+    if (!answer)
+        return defaultYes;
+    return answer === "y" || answer === "yes";
+};
+/**
+ * 运行交互式安装向导。
+ *
+ * @throws 当 stdin 不是 TTY（非交互环境）时抛出错误，提示改用 `install`/`config set`
+ */
+export const runInit = async () => {
+    if (!process.stdin.isTTY) {
+        throw new Error("cvh init 需要交互式终端（TTY），当前环境不支持。非交互场景请改用：\n" +
+            "  cvh install && cvh config set provider <provider> && cvh config set model <model> && cvh config set apiKey <key> && cvh enable");
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        console.log("cc-vision-hook 交互式安装向导\n");
+        const existed = await configFileExists();
+        const current = existed ? await loadConfig() : { ...DEFAULT_CONFIG };
+        if (existed) {
+            console.log(`检测到已有配置（${getConfigPath()}），当前值将作为默认值，直接回车可保留。\n`);
+        }
+        let provider = current.provider;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const input = await ask(rl, `视觉模型上游 provider（可选：${VALID_PROVIDERS.join("/")}）`, current.provider);
+            if (VALID_PROVIDERS.includes(input)) {
+                provider = input;
+                break;
+            }
+            console.log(`⚠️  不支持的 provider：${input}，请重新输入`);
+        }
+        const model = await ask(rl, "视觉模型名", current.model !== DEFAULT_CONFIG.model ? current.model : DEFAULT_MODEL_BY_PROVIDER[provider]);
+        const baseUrlInput = await ask(rl, "上游 API base URL（留空使用 provider 官方默认地址）", current.baseUrl ?? "");
+        // apiKey 单独处理：不能像其他字段那样把"脱敏展示值"直接当默认值塞回 ask()——
+        // 那样用户直接回车时，写入配置的就会是 "sk-xxx***" 这段脱敏字符串本身，而不是真实 key。
+        // 直接问一个新值，用户想保留原 key 时留空即可。
+        const apiKeyPrompt = current.apiKey ? `API Key（当前已设置 ${current.apiKey.slice(0, 6)}***，回车保留）` : "API Key";
+        const apiKeyInput = (await rl.question(`${apiKeyPrompt}: `)).trim();
+        const resolvedApiKey = apiKeyInput || current.apiKey;
+        const installMcp = await askYesNo(rl, "是否同时注册 MCP server（vision_ask 等追问工具，与主开关无关）", false);
+        const enableNow = await askYesNo(rl, "是否立即启用（enabled=true）", true);
+        const finalConfig = {
+            ...current,
+            provider,
+            model,
+            baseUrl: baseUrlInput || undefined,
+            apiKey: resolvedApiKey || undefined,
+            enabled: enableNow,
+        };
+        await saveConfig(finalConfig);
+        const hooksAdded = await installHooks();
+        const mcpChanged = installMcp ? await installMcpServer() : false;
+        console.log("\n✅ cvh 初始化完成");
+        console.log(`   配置文件：${getConfigPath()}`);
+        console.log(`   Provider / 模型：${provider} / ${model}`);
+        console.log(`   新增 Hook 注册数：${hooksAdded}`);
+        console.log(`   MCP server：${installMcp ? (mcpChanged ? "已注册" : "已经是最新状态") : "未注册（可后续运行 cvh mcp install）"}`);
+        console.log(`   开关状态：${enableNow ? "已启用" : "已停用（运行 cvh enable 手动启用）"}`);
+        console.log("\n建议运行 `cvh doctor` 验证配置和连通性。");
+    }
+    finally {
+        rl.close();
+    }
+};
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/install.d.ts

@@ -8,7 +8,9 @@
  */
 export declare const runInstall: (jsonOutput: boolean) => Promise<void>;
 /**
- * 卸载 cvh：移除 Hook 注册，可选连带删除配置和缓存。
+ * 卸载 cvh：移除 Hook 注册 + MCP server 注册，可选连带删除配置和缓存。
+ * MCP 注册无论是否 `--purge` 都会移除——保留配置/缓存但留一个孤立的 MCP server 注册
+ * 没有意义（用户显式执行了 uninstall，说明不想再让 Claude Code 感知到 cvh 的存在）。
  *
  * @param purge - 是否连带删除配置文件和缓存目录
  * @param jsonOutput - 是否以 JSON 格式输出结果

package/dist/commands/install.js

@@ -2,16 +2,20 @@
  * `cvh install` / `cvh uninstall` 命令实现。
  */
 import { rm } from "node:fs/promises";
-import { DEFAULT_CONFIG, getConfigPath, getCvhHomeDir, loadConfig, saveConfig } from "../config.js";
+import { DEFAULT_CONFIG, configFileExists, getConfigPath, getCvhHomeDir, saveConfig } from "../config.js";
 import { installHooks, uninstallHooks } from "../claudeSettings.js";
+import { uninstallMcpServer } from "../claudeMcp.js";
 /**
  * 安装 cvh：创建配置文件（若不存在）+ 注册 Hook。幂等，可重复执行。
  *
  * @param jsonOutput - 是否以 JSON 格式输出结果
  */
 export const runInstall = async (jsonOutput) => {
-    const existing = await loadConfig().catch(() => null);
-    if (!existing)
+    // 注意：不能用 loadConfig().catch(...) 判断文件是否存在——loadConfig() 内部自带
+    // try/catch 兜底，文件不存在时会静默返回默认配置对象而不是抛错，外层 catch 永远不会
+    // 触发。之前的实现正是因为这个假设错误，导致 cvh install 从未真正创建过配置文件。
+    const existed = await configFileExists();
+    if (!existed)
         await saveConfig(DEFAULT_CONFIG);
     const added = await installHooks();
     if (jsonOutput) {
@@ -25,23 +29,27 @@ export const runInstall = async (jsonOutput) => {
     console.log(`   ⚠️  cvh 仅对"静默忽略图片"型模型有效，对协议层硬拒绝型模型（如某些不支持视觉的模型）无效，详见 README`);
 };
 /**
- * 卸载 cvh：移除 Hook 注册，可选连带删除配置和缓存。
+ * 卸载 cvh：移除 Hook 注册 + MCP server 注册，可选连带删除配置和缓存。
+ * MCP 注册无论是否 `--purge` 都会移除——保留配置/缓存但留一个孤立的 MCP server 注册
+ * 没有意义（用户显式执行了 uninstall，说明不想再让 Claude Code 感知到 cvh 的存在）。
  *
  * @param purge - 是否连带删除配置文件和缓存目录
  * @param jsonOutput - 是否以 JSON 格式输出结果
  */
 export const runUninstall = async (purge, jsonOutput) => {
     const removed = await uninstallHooks();
+    const mcpRemoved = await uninstallMcpServer();
     if (purge) {
         await rm(getConfigPath(), { force: true });
         await rm(getCvhHomeDir(), { recursive: true, force: true });
     }
     if (jsonOutput) {
-        console.log(JSON.stringify({ ok: true, hooksRemoved: removed, purged: purge }));
+        console.log(JSON.stringify({ ok: true, hooksRemoved: removed, mcpRemoved, purged: purge }));
         return;
     }
     console.log("✅ cvh 卸载完成");
     console.log(`   移除 Hook 注册数：${removed}`);
+    console.log(`   MCP server 注册：${mcpRemoved ? "已移除" : "未发现（无需移除）"}`);
     if (purge)
         console.log("   已删除配置文件与缓存目录（--purge）");
 };

package/dist/commands/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,UAAmB,EAAiB,EAAE;IACrE,MAAM,QAAQ,GAAG,MAAM,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ;QAAE,MAAM,UAAU,CAAC,cAAc,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,YAAY,EAAE,CAAC;IAEnC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1F,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,WAAW,aAAa,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,sBAAsB,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;AAChF,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,KAAc,EAAE,UAAmB,EAAiB,EAAE;IACvF,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;IACvC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAChF,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;IACzC,IAAI,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AACrD,CAAC,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1G,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,UAAmB,EAAiB,EAAE;IACrE,6DAA6D;IAC7D,oDAAoD;IACpD,iDAAiD;IACjD,MAAM,OAAO,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACzC,IAAI,CAAC,OAAO;QAAE,MAAM,UAAU,CAAC,cAAc,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,YAAY,EAAE,CAAC;IAEnC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1F,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,WAAW,aAAa,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,sBAAsB,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;AAChF,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,KAAc,EAAE,UAAmB,EAAiB,EAAE;IACvF,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC9C,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5F,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,oBAAoB,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACpE,IAAI,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/commands/mcpCmd.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `cvh mcp install` / `cvh mcp uninstall` / `cvh mcp serve` 命令实现。
+ *
+ * 三个子命令与主开关（enabled）完全独立：install/uninstall 只负责注册/移除
+ * `~/.claude.json` 里的 MCP server 条目，serve 才是真正跑 stdio server 的长驻进程入口。
+ */
+/**
+ * 安装 MCP server 注册（幂等）。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export declare const runMcpInstall: (jsonOutput: boolean) => Promise<void>;
+/**
+ * 卸载 MCP server 注册。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export declare const runMcpUninstall: (jsonOutput: boolean) => Promise<void>;
+/**
+ * 打印 MCP 注册状态（供 `cvh mcp status` 或整合进 `cvh status` 使用）。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export declare const runMcpStatus: (jsonOutput: boolean) => Promise<void>;
+/**
+ * 以 stdio 模式启动 MCP server（由 Claude Code 作为子进程调起，不应由用户手动运行）。
+ * 这是一个长驻进程，函数不会主动退出。
+ */
+export declare const runMcpServe: () => Promise<void>;

package/dist/commands/mcpCmd.js

@@ -0,0 +1,58 @@
+/**
+ * `cvh mcp install` / `cvh mcp uninstall` / `cvh mcp serve` 命令实现。
+ *
+ * 三个子命令与主开关（enabled）完全独立：install/uninstall 只负责注册/移除
+ * `~/.claude.json` 里的 MCP server 条目，serve 才是真正跑 stdio server 的长驻进程入口。
+ */
+import { installMcpServer, uninstallMcpServer, checkMcpInstalled } from "../claudeMcp.js";
+import { serveMcpStdio } from "../mcpServer.js";
+/**
+ * 安装 MCP server 注册（幂等）。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export const runMcpInstall = async (jsonOutput) => {
+    const changed = await installMcpServer();
+    if (jsonOutput) {
+        console.log(JSON.stringify({ ok: true, changed }));
+        return;
+    }
+    console.log("✅ cvh MCP server 已注册到 ~/.claude.json");
+    console.log(`   ${changed ? "本次为新增/更新条目" : "已经是最新状态，未发生变化"}`);
+    console.log("   工具：vision_ask / vision_describe_image / vision_describe_data_url");
+    console.log("   ⚠️  MCP 与主开关（enabled）无关，即使 cvh disable，Agent 仍可主动调用这些工具解析图片");
+};
+/**
+ * 卸载 MCP server 注册。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export const runMcpUninstall = async (jsonOutput) => {
+    const removed = await uninstallMcpServer();
+    if (jsonOutput) {
+        console.log(JSON.stringify({ ok: true, removed }));
+        return;
+    }
+    console.log(removed ? "✅ 已从 ~/.claude.json 移除 cc-vision-hook MCP server" : "⚠️  未发现已注册的 MCP server，无需移除");
+};
+/**
+ * 打印 MCP 注册状态（供 `cvh mcp status` 或整合进 `cvh status` 使用）。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export const runMcpStatus = async (jsonOutput) => {
+    const installed = await checkMcpInstalled();
+    if (jsonOutput) {
+        console.log(JSON.stringify({ installed }));
+        return;
+    }
+    console.log(`MCP server 注册：${installed ? "✅ 已注册" : "❌ 未注册（运行 cvh mcp install）"}`);
+};
+/**
+ * 以 stdio 模式启动 MCP server（由 Claude Code 作为子进程调起，不应由用户手动运行）。
+ * 这是一个长驻进程，函数不会主动退出。
+ */
+export const runMcpServe = async () => {
+    await serveMcpStdio();
+};
+//# sourceMappingURL=mcpCmd.js.map

package/dist/commands/mcpCmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpCmd.js","sourceRoot":"","sources":["../../src/commands/mcpCmd.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,UAAmB,EAAiB,EAAE;IACxE,MAAM,OAAO,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACzC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC;IACnF,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;AAChF,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,UAAmB,EAAiB,EAAE;IAC1E,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC3C,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,kDAAkD,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC;AAC5G,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,UAAmB,EAAiB,EAAE;IACvE,MAAM,SAAS,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAC5C,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,iBAAiB,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,EAAE,CAAC,CAAC;AACpF,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;IACnD,MAAM,aAAa,EAAE,CAAC;AACxB,CAAC,CAAC"}

package/dist/commands/status.js

@@ -3,6 +3,7 @@
  */
 import { loadConfig, getConfigPath } from "../config.js";
 import { checkHooksInstalled } from "../claudeSettings.js";
+import { checkMcpInstalled } from "../claudeMcp.js";
 import { countCacheEntries, getCacheDiskUsage } from "../cache.js";
 /**
  * 打印当前 cvh 的运行状态。
@@ -12,6 +13,9 @@ import { countCacheEntries, getCacheDiskUsage } from "../cache.js";
 export const runStatus = async (jsonOutput) => {
     const config = await loadConfig();
     const hooks = await checkHooksInstalled();
+    // MCP 注册状态实时读取 ~/.claude.json，而不是 config.mcpInstalled 静态字段——
+    // 后者仅作展示用途的历史字段，不会被 mcp install/uninstall 更新，容易与真实状态不一致。
+    const mcpInstalled = await checkMcpInstalled();
     const cacheCount = await countCacheEntries();
     const cacheBytes = await getCacheDiskUsage();
     const result = {
@@ -20,6 +24,7 @@ export const runStatus = async (jsonOutput) => {
         model: config.model,
         configPath: getConfigPath(),
         hooksInstalled: hooks,
+        mcpInstalled,
         cache: { entries: cacheCount, bytes: cacheBytes, ttlDays: config.cache.ttlDays },
     };
     if (jsonOutput) {
@@ -30,6 +35,7 @@ export const runStatus = async (jsonOutput) => {
     console.log(`视觉 provider：${config.provider} / 模型：${config.model}`);
     console.log(`配置文件：${config.enabled ? "" : ""}${getConfigPath()}`);
     console.log(`Hook 注册：UserPromptSubmit=${hooks.userPromptSubmit ? "✅" : "❌"} PostToolUse=${hooks.postToolUse ? "✅" : "❌"}`);
+    console.log(`MCP server：${mcpInstalled ? "✅ 已注册" : "❌ 未注册（运行 cvh mcp install）"}`);
     console.log(`本地缓存：${cacheCount} 条，约 ${(cacheBytes / 1024).toFixed(1)} KB，TTL ${config.cache.ttlDays} 天`);
 };
 //# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,UAAmB,EAAiB,EAAE;IACpE,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAC7C,MAAM,UAAU,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAE7C,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,aAAa,EAAE;QAC3B,cAAc,EAAE,KAAK;QACrB,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;KACjF,CAAC;IAEF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACpC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,QAAQ,SAAS,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,EAAE,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,gBAAgB,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3H,OAAO,CAAC,GAAG,CAAC,QAAQ,UAAU,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAC3G,CAAC,CAAC"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,UAAmB,EAAiB,EAAE;IACpE,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC1C,6DAA6D;IAC7D,yDAAyD;IACzD,MAAM,YAAY,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAC7C,MAAM,UAAU,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAE7C,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,aAAa,EAAE;QAC3B,cAAc,EAAE,KAAK;QACrB,YAAY;QACZ,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;KACjF,CAAC;IAEF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACpC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,QAAQ,SAAS,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,EAAE,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,gBAAgB,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3H,OAAO,CAAC,GAAG,CAAC,cAAc,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,EAAE,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,QAAQ,UAAU,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAC3G,CAAC,CAAC"}

package/dist/commands/testImage.js

@@ -5,13 +5,7 @@ import { readFile } from "node:fs/promises";
 import { extname } from "node:path";
 import { loadConfig } from "../config.js";
 import { describeImage } from "../vision.js";
-const EXT_TO_MIME = {
-    ".png": "image/png",
-    ".jpg": "image/jpeg",
-    ".jpeg": "image/jpeg",
-    ".webp": "image/webp",
-    ".gif": "image/gif",
-};
+import { EXT_TO_MIME } from "../imageMime.js";
 /**
  * 读取本地图片文件，调用当前配置的视觉模型解析并打印结果。
  *

package/dist/commands/testImage.js.map

@@ -1 +1 @@
-{"version":3,"file":"testImage.js","sourceRoot":"","sources":["../../src/commands/testImage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,GAA2B;IAC1C,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,IAAY,EAAE,UAAmB,EAAiB,EAAE;IACrF,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,4BAA4B,CAAC,CAAC;IAE7E,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAErF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAErC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC,CAAC"}
+{"version":3,"file":"testImage.js","sourceRoot":"","sources":["../../src/commands/testImage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,IAAY,EAAE,UAAmB,EAAiB,EAAE;IACrF,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,4BAA4B,CAAC,CAAC;IAE7E,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAErF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAErC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/config.d.ts

@@ -26,8 +26,6 @@ export interface CvhConfig {
     cache: {
         ttlDays: number;
     };
-    /** 是否已安装 MCP server（仅用于 status/doctor 展示，不参与开关逻辑）。 */
-    mcpInstalled: boolean;
 }
 export declare const DEFAULT_CONFIG: CvhConfig;
 /**
@@ -51,6 +49,14 @@ export declare const getConfigPath: () => string;
  * @returns 合并后的配置对象
  */
 export declare const loadConfig: () => Promise<CvhConfig>;
+/**
+ * 检查配置文件是否已存在于磁盘（区别于 `loadConfig()`——后者文件不存在时会静默兜底返回
+ * 默认配置对象，不能用来判断"文件是否真的存在"，`cvh install` 需要这个区分来决定是否要
+ * 首次落盘写入默认配置）。
+ *
+ * @returns 配置文件是否存在
+ */
+export declare const configFileExists: () => Promise<boolean>;
 /**
  * 写入配置文件，并设置 `0600` 权限（仅当前用户可读写，因为里面可能存明文 API key）。
  *

package/dist/config.js

@@ -12,7 +12,6 @@ export const DEFAULT_CONFIG = {
     timeoutMs: 45000,
     maxTokens: 1200,
     cache: { ttlDays: 7 },
-    mcpInstalled: false,
 };
 /**
  * Claude Code 配置根目录（即 `~/.claude`）。
@@ -44,6 +43,22 @@ export const loadConfig = async () => {
         return { ...DEFAULT_CONFIG };
     }
 };
+/**
+ * 检查配置文件是否已存在于磁盘（区别于 `loadConfig()`——后者文件不存在时会静默兜底返回
+ * 默认配置对象，不能用来判断"文件是否真的存在"，`cvh install` 需要这个区分来决定是否要
+ * 首次落盘写入默认配置）。
+ *
+ * @returns 配置文件是否存在
+ */
+export const configFileExists = async () => {
+    try {
+        await readFile(getConfigPath(), "utf8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
 /**
  * 写入配置文件，并设置 `0600` 权限（仅当前用户可读写，因为里面可能存明文 API key）。
  *

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/imageMime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 图片文件扩展名 -> MIME 类型的共享映射表。
+ *
+ * 之前 `pasteScanner.ts`/`testImage.ts` 各自维护了一份相同的映射，MCP 的
+ * `vision_describe_image` 工具也需要同样的逻辑，抽成单一来源避免三处漂移。
+ */
+export declare const EXT_TO_MIME: Record<string, string>;
+/**
+ * 根据文件路径的扩展名推断 MIME 类型。
+ *
+ * @param path - 文件路径（只看扩展名，不检查文件是否存在）
+ * @returns 识别出的 MIME 类型，扩展名未知时返回 undefined
+ */
+export declare const mimeFromPath: (path: string) => string | undefined;

package/dist/imageMime.js

@@ -0,0 +1,22 @@
+/**
+ * 图片文件扩展名 -> MIME 类型的共享映射表。
+ *
+ * 之前 `pasteScanner.ts`/`testImage.ts` 各自维护了一份相同的映射，MCP 的
+ * `vision_describe_image` 工具也需要同样的逻辑，抽成单一来源避免三处漂移。
+ */
+import { extname } from "node:path";
+export const EXT_TO_MIME = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+};
+/**
+ * 根据文件路径的扩展名推断 MIME 类型。
+ *
+ * @param path - 文件路径（只看扩展名，不检查文件是否存在）
+ * @returns 识别出的 MIME 类型，扩展名未知时返回 undefined
+ */
+export const mimeFromPath = (path) => EXT_TO_MIME[extname(path).toLowerCase()];
+//# sourceMappingURL=imageMime.js.map

package/dist/imageMime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageMime.js","sourceRoot":"","sources":["../src/imageMime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAsB,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC"}

package/dist/mcpServer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MCP stdio server：暴露 `vision_ask` / `vision_describe_image` / `vision_describe_data_url`
+ * 三个工具，让 Claude 主模型在对话中可以主动追问此前已被 Hook 处理过的图片，
+ * 或直接解析一张新的本地图片/data URL（不依赖磁盘缓存命中）。
+ *
+ * 设计对齐 docs/research/cc-vision-hook-design-2026-07-08.md §8.3：
+ * - `vision_ask`：按 image_id 从磁盘缓存取回原图字节，用 describeImage() 追问，
+ *   不写回缓存的 description 字段（避免用一次追问的针对性回答覆盖掉原本的通用描述）。
+ * - `vision_describe_image` / `vision_describe_data_url`：直接解析，不依赖历史缓存命中，
+ *   但解析结果仍然按内容 hash 落盘缓存，方便后续 `vision_ask` 追问同一张图。
+ *
+ * MCP 本身与 enabled 开关无关（见 claudeSettings.ts 顶部注释的既定设计：
+ * "cvh disable 不卸载 MCP，cvh enable 不安装 MCP"）——但工具执行时仍然遵守 enabled
+ * 开关，因为调用视觉模型本身就是"处理图片"这件事，enabled=false 时应视为功能关闭。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 创建并配置好三个视觉工具的 MCP Server 实例（尚未连接 transport）。
+ * 拆成独立函数是为了方便单测：可以直接调用 `server.server` 上的能力做集成测试，
+ * 不需要真的起一个 stdio 子进程。
+ *
+ * @returns 配置完毕、可直接 connect(transport) 的 McpServer 实例
+ */
+export declare const createVisionMcpServer: () => McpServer;
+/**
+ * 以 stdio 模式启动 MCP server（由 Claude Code 作为子进程调起，`cvh mcp serve` 的入口）。
+ * 这是一个长驻进程，函数本身不会 resolve（除非 transport 关闭）。
+ *
+ * @returns 在 transport 关闭前不会 resolve 的 Promise
+ */
+export declare const serveMcpStdio: () => Promise<void>;