cc-vision-hook 0.1.0

package/dist/claudeSettings.js

@@ -0,0 +1,115 @@
+/**
+ * 对 `~/.claude/settings.json` 里 Hook 注册条目的幂等读写。
+ *
+ * 幂等标识：用固定的 command 字符串（"cvh hook user-prompt-submit"/"cvh hook post-tool-use"）
+ * 作为唯一标识——install 前先检查是否已存在同样的条目，避免重复注册；uninstall 时精确按这个
+ * 字符串过滤移除，不误删用户自己配置的其他 Hook。
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { getClaudeHomeDir } from "./config.js";
+export const USER_PROMPT_SUBMIT_COMMAND = "cvh hook user-prompt-submit";
+export const POST_TOOL_USE_COMMAND = "cvh hook post-tool-use";
+const getSettingsPath = () => join(getClaudeHomeDir(), "settings.json");
+/**
+ * 读取 `~/.claude/settings.json`，文件不存在或解析失败时返回空对象（不覆盖用户已有配置）。
+ *
+ * @returns 解析后的设置对象
+ */
+const readSettings = async () => {
+    try {
+        const raw = await readFile(getSettingsPath(), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+};
+/**
+ * 写回 `~/.claude/settings.json`。
+ *
+ * @param settings - 完整的设置对象
+ */
+const writeSettings = async (settings) => {
+    const path = getSettingsPath();
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(settings, null, 2)}\n`, "utf8");
+};
+/**
+ * 检查某个 Hook 分组数组里是否已经存在指定 command 的条目。
+ *
+ * @param groups - Hook 分组数组
+ * @param command - 要查找的命令字符串
+ * @returns 是否已存在
+ */
+const hasCommand = (groups, command) => (groups ?? []).some((g) => g.hooks.some((h) => h.command === command));
+/**
+ * 幂等地在 `~/.claude/settings.json` 中注册 `UserPromptSubmit` 和 `PostToolUse` 两个 Hook。
+ * 已存在同样 command 的条目时跳过，不重复添加；不会动用户已有的其他 Hook 配置。
+ *
+ * @returns 本次实际新增的 Hook 数量（0 表示已经是安装好的状态，重复执行安全）
+ */
+export const installHooks = async () => {
+    const settings = await readSettings();
+    settings.hooks ??= {};
+    let added = 0;
+    if (!hasCommand(settings.hooks.UserPromptSubmit, USER_PROMPT_SUBMIT_COMMAND)) {
+        settings.hooks.UserPromptSubmit = [
+            ...(settings.hooks.UserPromptSubmit ?? []),
+            { hooks: [{ type: "command", command: USER_PROMPT_SUBMIT_COMMAND, timeout: 60 }] },
+        ];
+        added += 1;
+    }
+    if (!hasCommand(settings.hooks.PostToolUse, POST_TOOL_USE_COMMAND)) {
+        settings.hooks.PostToolUse = [
+            ...(settings.hooks.PostToolUse ?? []),
+            // matcher 显式设为 "*"：图片检测逻辑完全在 hook 内部完成（不依赖工具名白名单），
+            // 挂 "*" 才能自动覆盖未来任何新工具（含 MCP/Bash 等），不需要用户手动维护 matcher 列表。
+            // 不显式设置时 Claude Code 的匹配行为未经验证，不能假设留空等价于匹配全部。
+            { matcher: "*", hooks: [{ type: "command", command: POST_TOOL_USE_COMMAND, timeout: 60 }] },
+        ];
+        added += 1;
+    }
+    await writeSettings(settings);
+    return added;
+};
+/**
+ * 精确移除 cvh 注册的两个 Hook 条目，不影响用户配置的其他 Hook。
+ *
+ * @returns 本次实际移除的 Hook 数量
+ */
+export const uninstallHooks = async () => {
+    const settings = await readSettings();
+    if (!settings.hooks)
+        return 0;
+    let removed = 0;
+    if (settings.hooks.UserPromptSubmit) {
+        const before = settings.hooks.UserPromptSubmit.length;
+        settings.hooks.UserPromptSubmit = settings.hooks.UserPromptSubmit
+            .map((g) => ({ ...g, hooks: g.hooks.filter((h) => h.command !== USER_PROMPT_SUBMIT_COMMAND) }))
+            .filter((g) => g.hooks.length > 0);
+        removed += before - settings.hooks.UserPromptSubmit.length;
+    }
+    if (settings.hooks.PostToolUse) {
+        const before = settings.hooks.PostToolUse.length;
+        settings.hooks.PostToolUse = settings.hooks.PostToolUse
+            .map((g) => ({ ...g, hooks: g.hooks.filter((h) => h.command !== POST_TOOL_USE_COMMAND) }))
+            .filter((g) => g.hooks.length > 0);
+        removed += before - settings.hooks.PostToolUse.length;
+    }
+    await writeSettings(settings);
+    return removed;
+};
+/**
+ * 检查两个 Hook 是否都已注册（用于 `cvh status`/`doctor`）。
+ *
+ * @returns 分别表示两个 Hook 是否已注册
+ */
+export const checkHooksInstalled = async () => {
+    const settings = await readSettings();
+    return {
+        userPromptSubmit: hasCommand(settings.hooks?.UserPromptSubmit, USER_PROMPT_SUBMIT_COMMAND),
+        postToolUse: hasCommand(settings.hooks?.PostToolUse, POST_TOOL_USE_COMMAND),
+    };
+};
+//# sourceMappingURL=claudeSettings.js.map

package/dist/claudeSettings.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * cvh CLI 入口（命令分发）。
+ * P0 范围：install/uninstall/enable/disable/status/doctor/config/test-image + 两个 hook 入口。
+ * P1（交互式 init/`--json` 已在部分命令支持）、P2（MCP）为后续阶段，见 README「路线图」。
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+/**
+ * cvh CLI 入口（命令分发）。
+ * P0 范围：install/uninstall/enable/disable/status/doctor/config/test-image + 两个 hook 入口。
+ * P1（交互式 init/`--json` 已在部分命令支持）、P2（MCP）为后续阶段，见 README「路线图」。
+ */
+import { runInstall, runUninstall } from "./commands/install.js";
+import { runToggle } from "./commands/toggle.js";
+import { runStatus } from "./commands/status.js";
+import { runDoctor } from "./commands/doctor.js";
+import { runConfigGet, runConfigSet } from "./commands/configCmd.js";
+import { runTestImage } from "./commands/testImage.js";
+import { handleUserPromptSubmit } from "./hooks/userPromptSubmit.js";
+import { handlePostToolUse } from "./hooks/postToolUse.js";
+const printHelp = () => {
+    console.log(`cc-vision-hook (cvh)
+
+让"静默忽略图片"型模型（收到图片不报错、只是看不懂）也能理解 Claude Code 里的图片内容。
+⚠️ 对"协议层硬拒绝"型模型（收到图片直接导致请求失败）无效，详见 \`cvh doctor\` 提示。
+
+Usage:
+  cvh install                    安装：创建配置 + 注册 Hook（幂等）
+  cvh uninstall [--purge]        卸载：移除 Hook 注册（--purge 连带删除配置和缓存）
+  cvh enable / cvh disable       开关（唯一决定是否处理图片的开关）
+  cvh status                     查看当前状态
+  cvh doctor                     自检（配置/Hook/视觉模型连通性 + 边界声明）
+  cvh config get                 查看当前配置
+  cvh config set <key> <value>   设置配置项（provider/model/baseUrl/apiKey/timeoutMs/maxTokens）
+  cvh test-image <path>          手动测试：本地图片 -> 视觉解析
+
+Global options:
+  --json    以 JSON 格式输出（供脚本消费）
+`);
+};
+/** 读取 stdin 全部内容（用于 hook 子命令）。 */
+const readStdin = async () => {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString("utf8");
+};
+const main = async () => {
+    const argv = process.argv.slice(2);
+    const jsonOutput = argv.includes("--json");
+    const args = argv.filter((a) => a !== "--json");
+    const [command, ...rest] = args;
+    switch (command) {
+        case undefined:
+        case "help":
+        case "--help":
+            printHelp();
+            return;
+        case "install":
+            return runInstall(jsonOutput);
+        case "uninstall":
+            return runUninstall(rest.includes("--purge"), jsonOutput);
+        case "enable":
+            return runToggle(true, jsonOutput);
+        case "disable":
+            return runToggle(false, jsonOutput);
+        case "status":
+            return runStatus(jsonOutput);
+        case "doctor":
+            return runDoctor(jsonOutput);
+        case "config":
+            if (rest[0] === "get")
+                return runConfigGet(jsonOutput);
+            if (rest[0] === "set" && rest[1] && rest[2])
+                return runConfigSet(rest[1], rest[2], jsonOutput);
+            throw new Error("用法：cvh config get | cvh config set <key> <value>");
+        case "test-image":
+            if (!rest[0])
+                throw new Error("用法：cvh test-image <path>");
+            return runTestImage(rest[0], jsonOutput);
+        case "hook": {
+            const raw = await readStdin();
+            const payload = JSON.parse(raw || "{}");
+            if (rest[0] === "user-prompt-submit" || payload.hook_event_name === "UserPromptSubmit") {
+                const output = await handleUserPromptSubmit(payload);
+                console.log(JSON.stringify(output));
+                return;
+            }
+            if (rest[0] === "post-tool-use" || payload.hook_event_name === "PostToolUse") {
+                const output = await handlePostToolUse(payload);
+                console.log(JSON.stringify(output));
+                return;
+            }
+            // 未知 hook 事件，安全兜底返回空对象，不阻塞 Claude Code 流程。
+            console.log("{}");
+            return;
+        }
+        default:
+            throw new Error(`未知命令：${command}。运行 \`cvh help\` 查看用法。`);
+    }
+};
+main().catch((error) => {
+    // hook 子命令即使出错也不能让 Claude Code 卡住，统一输出空对象兜底 + 把错误打到 stderr 供排查。
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`cvh error: ${message}`);
+    if (process.argv[2] === "hook") {
+        console.log("{}");
+        process.exit(0);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/configCmd.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `cvh config get/set` 命令实现。
+ */
+/**
+ * 打印当前完整配置（脱敏 apiKey）。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出
+ */
+export declare const runConfigGet: (jsonOutput: boolean) => Promise<void>;
+/**
+ * 设置单个配置项并落盘。
+ *
+ * @param key - 配置项名（仅允许 EDITABLE_KEYS 中的字段）
+ * @param value - 新值（字符串形式，数字字段会自动转换）
+ * @param jsonOutput - 是否以 JSON 格式输出
+ * @throws 当 key 不在允许列表内时抛出错误
+ */
+export declare const runConfigSet: (key: string, value: string, jsonOutput: boolean) => Promise<void>;

package/dist/commands/configCmd.js

@@ -0,0 +1,104 @@
+/**
+ * `cvh config get/set` 命令实现。
+ */
+import { loadConfig, saveConfig } from "../config.js";
+const EDITABLE_KEYS = ["provider", "model", "baseUrl", "apiKey", "timeoutMs", "maxTokens"];
+/** provider 字段允许的合法值，与 vision.ts 的 resolveModel() 分支一一对应。 */
+const VALID_PROVIDERS = ["oai", "responses", "anthropic", "gemini"];
+const isEditableKey = (key) => EDITABLE_KEYS.includes(key);
+/**
+ * 按字段名把字符串值写入配置对象的对应字段，避免使用 `as any` 绕过类型检查——
+ * 每个分支都显式声明目标字段的真实类型，并在写入前做基本校验，
+ * 避免非法值一直存活到 `describeImage()` 真正调用时才报错（体验差、排查成本高）。
+ *
+ * @param config - 待修改的配置对象（原地修改）
+ * @param key - 目标字段名
+ * @param value - 字符串形式的新值
+ * @throws 当值不满足对应字段的校验规则时抛出错误（provider 非法、数字字段非数字/非正数等）
+ */
+const applyConfigValue = (config, key, value) => {
+    switch (key) {
+        case "provider": {
+            if (!VALID_PROVIDERS.includes(value)) {
+                throw new Error(`不支持的 provider：${value}。可用值：${VALID_PROVIDERS.join(", ")}`);
+            }
+            config.provider = value;
+            return;
+        }
+        case "model": {
+            if (!value.trim())
+                throw new Error("model 不能为空");
+            config.model = value;
+            return;
+        }
+        case "baseUrl": {
+            try {
+                // eslint-disable-next-line no-new
+                new URL(value);
+            }
+            catch {
+                throw new Error(`baseUrl 不是合法的 URL：${value}`);
+            }
+            config.baseUrl = value;
+            return;
+        }
+        case "apiKey": {
+            if (!value.trim())
+                throw new Error("apiKey 不能为空");
+            config.apiKey = value;
+            return;
+        }
+        case "timeoutMs": {
+            const n = Number(value);
+            if (!Number.isFinite(n) || n <= 0)
+                throw new Error(`timeoutMs 必须是正数：${value}`);
+            config.timeoutMs = n;
+            return;
+        }
+        case "maxTokens": {
+            const n = Number(value);
+            if (!Number.isFinite(n) || n <= 0)
+                throw new Error(`maxTokens 必须是正数：${value}`);
+            config.maxTokens = n;
+            return;
+        }
+    }
+};
+/**
+ * 打印当前完整配置（脱敏 apiKey）。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出
+ */
+export const runConfigGet = async (jsonOutput) => {
+    const config = await loadConfig();
+    const masked = { ...config, apiKey: config.apiKey ? `${config.apiKey.slice(0, 6)}***` : undefined };
+    if (jsonOutput) {
+        console.log(JSON.stringify(masked));
+        return;
+    }
+    for (const [key, value] of Object.entries(masked)) {
+        console.log(`${key} = ${typeof value === "object" ? JSON.stringify(value) : value}`);
+    }
+};
+/**
+ * 设置单个配置项并落盘。
+ *
+ * @param key - 配置项名（仅允许 EDITABLE_KEYS 中的字段）
+ * @param value - 新值（字符串形式，数字字段会自动转换）
+ * @param jsonOutput - 是否以 JSON 格式输出
+ * @throws 当 key 不在允许列表内时抛出错误
+ */
+export const runConfigSet = async (key, value, jsonOutput) => {
+    if (!isEditableKey(key)) {
+        throw new Error(`不支持的配置项：${key}。可用项：${EDITABLE_KEYS.join(", ")}`);
+    }
+    const config = await loadConfig();
+    applyConfigValue(config, key, value);
+    await saveConfig(config);
+    if (jsonOutput) {
+        console.log(JSON.stringify({ ok: true, key, value }));
+        return;
+    }
+    console.log(`✅ ${key} = ${key === "apiKey" ? "***" : value}`);
+};
+//# sourceMappingURL=configCmd.js.map

package/dist/commands/configCmd.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `cvh doctor` 命令实现：自检配置有效性、API key 可用性、Hook 注册完整性，
+ * 并显著提示 cvh 的适用边界（仅对"静默忽略图片"型模型有效）。
+ */
+/**
+ * 执行一整套自检并打印结果。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export declare const runDoctor: (jsonOutput: boolean) => Promise<void>;

package/dist/commands/doctor.js

@@ -0,0 +1,60 @@
+/**
+ * `cvh doctor` 命令实现：自检配置有效性、API key 可用性、Hook 注册完整性，
+ * 并显著提示 cvh 的适用边界（仅对"静默忽略图片"型模型有效）。
+ */
+import { stat } from "node:fs/promises";
+import { loadConfig, getConfigPath } from "../config.js";
+import { checkHooksInstalled } from "../claudeSettings.js";
+import { describeImage } from "../vision.js";
+// 1x1 透明 PNG，仅用于自检时验证视觉模型连通性，不产生真实业务含义。
+const PROBE_IMAGE_BASE64 = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=";
+/**
+ * 执行一整套自检并打印结果。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export const runDoctor = async (jsonOutput) => {
+    const checks = [];
+    const config = await loadConfig();
+    checks.push({ name: "配置文件存在", ok: true, detail: getConfigPath() });
+    try {
+        const s = await stat(getConfigPath());
+        // eslint-disable-next-line no-bitwise
+        const mode = (s.mode & 0o777).toString(8);
+        checks.push({ name: "配置文件权限", ok: mode === "600", detail: `当前权限 ${mode}（建议 600，避免同机其他用户读取明文 API key）` });
+    }
+    catch {
+        checks.push({ name: "配置文件权限", ok: false, detail: "配置文件不存在，请先运行 cvh install" });
+    }
+    const hooks = await checkHooksInstalled();
+    checks.push({ name: "UserPromptSubmit Hook 已注册", ok: hooks.userPromptSubmit, detail: hooks.userPromptSubmit ? "" : "请运行 cvh install" });
+    checks.push({ name: "PostToolUse Hook 已注册", ok: hooks.postToolUse, detail: hooks.postToolUse ? "" : "请运行 cvh install" });
+    checks.push({ name: "API Key 已配置", ok: Boolean(config.apiKey), detail: config.apiKey ? "已设置" : "请运行 cvh config set apiKey <key>" });
+    if (config.apiKey) {
+        try {
+            const start = Date.now();
+            await describeImage(PROBE_IMAGE_BASE64, "image/png", config, "这是什么？一个字回答即可。");
+            checks.push({ name: "视觉模型连通性", ok: true, detail: `调用成功，耗时 ${Date.now() - start}ms` });
+        }
+        catch (error) {
+            checks.push({ name: "视觉模型连通性", ok: false, detail: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    else {
+        checks.push({ name: "视觉模型连通性", ok: false, detail: "跳过（未配置 API Key）" });
+    }
+    const allOk = checks.every((c) => c.ok);
+    if (jsonOutput) {
+        console.log(JSON.stringify({ ok: allOk, checks, boundaryWarning: BOUNDARY_WARNING }));
+        return;
+    }
+    for (const check of checks) {
+        console.log(`${check.ok ? "✅" : "❌"} ${check.name}${check.detail ? ` — ${check.detail}` : ""}`);
+    }
+    console.log("");
+    console.log(BOUNDARY_WARNING);
+};
+const BOUNDARY_WARNING = "⚠️  重要边界声明：cvh 只对「静默忽略图片」型模型有效（模型收到图片后不报错，只是不理解）。\n" +
+    "   对「协议层硬拒绝」型模型（收到图片直接导致整个请求失败/报错）完全无效，装了 cvh 该场景依然会失败。\n" +
+    "   请自行判断当前使用的模型属于哪一种，再决定是否启用 cvh。";
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/install.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `cvh install` / `cvh uninstall` 命令实现。
+ */
+/**
+ * 安装 cvh：创建配置文件（若不存在）+ 注册 Hook。幂等，可重复执行。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export declare const runInstall: (jsonOutput: boolean) => Promise<void>;
+/**
+ * 卸载 cvh：移除 Hook 注册，可选连带删除配置和缓存。
+ *
+ * @param purge - 是否连带删除配置文件和缓存目录
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export declare const runUninstall: (purge: boolean, jsonOutput: boolean) => Promise<void>;

package/dist/commands/install.js

@@ -0,0 +1,48 @@
+/**
+ * `cvh install` / `cvh uninstall` 命令实现。
+ */
+import { rm } from "node:fs/promises";
+import { DEFAULT_CONFIG, getConfigPath, getCvhHomeDir, loadConfig, saveConfig } from "../config.js";
+import { installHooks, uninstallHooks } from "../claudeSettings.js";
+/**
+ * 安装 cvh：创建配置文件（若不存在）+ 注册 Hook。幂等，可重复执行。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export const runInstall = async (jsonOutput) => {
+    const existing = await loadConfig().catch(() => null);
+    if (!existing)
+        await saveConfig(DEFAULT_CONFIG);
+    const added = await installHooks();
+    if (jsonOutput) {
+        console.log(JSON.stringify({ ok: true, hooksAdded: added, configPath: getConfigPath() }));
+        return;
+    }
+    console.log("✅ cvh 安装完成");
+    console.log(`   配置文件：${getConfigPath()}`);
+    console.log(`   新增 Hook 注册数：${added}（0 表示之前已安装过，本次是幂等重跑）`);
+    console.log(`   ⚠️  当前默认 enabled=false，运行 \`cvh enable\` 后才会生效`);
+    console.log(`   ⚠️  cvh 仅对"静默忽略图片"型模型有效，对协议层硬拒绝型模型（如某些不支持视觉的模型）无效，详见 README`);
+};
+/**
+ * 卸载 cvh：移除 Hook 注册，可选连带删除配置和缓存。
+ *
+ * @param purge - 是否连带删除配置文件和缓存目录
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export const runUninstall = async (purge, jsonOutput) => {
+    const removed = await uninstallHooks();
+    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 }));
+        return;
+    }
+    console.log("✅ cvh 卸载完成");
+    console.log(`   移除 Hook 注册数：${removed}`);
+    if (purge)
+        console.log("   已删除配置文件与缓存目录（--purge）");
+};
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +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"}

package/dist/commands/status.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `cvh status` 命令实现：展示开关状态、Hook 注册情况、缓存统计。
+ */
+/**
+ * 打印当前 cvh 的运行状态。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export declare const runStatus: (jsonOutput: boolean) => Promise<void>;

package/dist/commands/status.js

@@ -0,0 +1,35 @@
+/**
+ * `cvh status` 命令实现：展示开关状态、Hook 注册情况、缓存统计。
+ */
+import { loadConfig, getConfigPath } from "../config.js";
+import { checkHooksInstalled } from "../claudeSettings.js";
+import { countCacheEntries, getCacheDiskUsage } from "../cache.js";
+/**
+ * 打印当前 cvh 的运行状态。
+ *
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export const runStatus = async (jsonOutput) => {
+    const config = await loadConfig();
+    const hooks = await checkHooksInstalled();
+    const cacheCount = await countCacheEntries();
+    const cacheBytes = await getCacheDiskUsage();
+    const result = {
+        enabled: config.enabled,
+        provider: config.provider,
+        model: config.model,
+        configPath: getConfigPath(),
+        hooksInstalled: hooks,
+        cache: { entries: cacheCount, bytes: cacheBytes, ttlDays: config.cache.ttlDays },
+    };
+    if (jsonOutput) {
+        console.log(JSON.stringify(result));
+        return;
+    }
+    console.log(`开关状态：${config.enabled ? "✅ 已启用" : "⚠️  已停用"}`);
+    console.log(`视觉 provider：${config.provider} / 模型：${config.model}`);
+    console.log(`配置文件：${config.enabled ? "" : ""}${getConfigPath()}`);
+    console.log(`Hook 注册：UserPromptSubmit=${hooks.userPromptSubmit ? "✅" : "❌"} PostToolUse=${hooks.postToolUse ? "✅" : "❌"}`);
+    console.log(`本地缓存：${cacheCount} 条，约 ${(cacheBytes / 1024).toFixed(1)} KB，TTL ${config.cache.ttlDays} 天`);
+};
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +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"}

package/dist/commands/testImage.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `cvh test-image <path>` 命令实现：本地图片 -> 视觉解析 -> 打印描述，验证链路通畅。
+ */
+/**
+ * 读取本地图片文件，调用当前配置的视觉模型解析并打印结果。
+ *
+ * @param path - 本地图片文件路径
+ * @param jsonOutput - 是否以 JSON 格式输出
+ * @throws 当文件不存在、格式不支持或视觉模型调用失败时抛出错误
+ */
+export declare const runTestImage: (path: string, jsonOutput: boolean) => Promise<void>;

package/dist/commands/testImage.js

@@ -0,0 +1,40 @@
+/**
+ * `cvh test-image <path>` 命令实现：本地图片 -> 视觉解析 -> 打印描述，验证链路通畅。
+ */
+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",
+};
+/**
+ * 读取本地图片文件，调用当前配置的视觉模型解析并打印结果。
+ *
+ * @param path - 本地图片文件路径
+ * @param jsonOutput - 是否以 JSON 格式输出
+ * @throws 当文件不存在、格式不支持或视觉模型调用失败时抛出错误
+ */
+export const runTestImage = async (path, jsonOutput) => {
+    const mimeType = EXT_TO_MIME[extname(path).toLowerCase()];
+    if (!mimeType)
+        throw new Error(`不支持的图片格式：${path}（支持 png/jpg/jpeg/webp/gif）`);
+    const bytes = await readFile(path);
+    const config = await loadConfig();
+    if (!config.apiKey)
+        throw new Error("尚未配置 API Key，请先运行 cvh config set apiKey <key>");
+    const start = Date.now();
+    const description = await describeImage(bytes.toString("base64"), mimeType, config);
+    const elapsedMs = Date.now() - start;
+    if (jsonOutput) {
+        console.log(JSON.stringify({ ok: true, description, elapsedMs }));
+        return;
+    }
+    console.log(`✅ 解析成功（耗时 ${elapsedMs}ms）：`);
+    console.log(description);
+};
+//# sourceMappingURL=testImage.js.map

package/dist/commands/testImage.js.map

@@ -0,0 +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"}