cc-vision-hook 0.1.0

package/dist/commands/toggle.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `cvh enable` / `cvh disable` 命令实现：只写配置文件的 enabled 字段，不涉及 Hook 注册。
+ */
+/**
+ * 设置 enabled 字段并落盘。
+ *
+ * @param enabled - 目标开关状态
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export declare const runToggle: (enabled: boolean, jsonOutput: boolean) => Promise<void>;

package/dist/commands/toggle.js

@@ -0,0 +1,21 @@
+/**
+ * `cvh enable` / `cvh disable` 命令实现：只写配置文件的 enabled 字段，不涉及 Hook 注册。
+ */
+import { loadConfig, saveConfig } from "../config.js";
+/**
+ * 设置 enabled 字段并落盘。
+ *
+ * @param enabled - 目标开关状态
+ * @param jsonOutput - 是否以 JSON 格式输出结果
+ */
+export const runToggle = async (enabled, jsonOutput) => {
+    const config = await loadConfig();
+    config.enabled = enabled;
+    await saveConfig(config);
+    if (jsonOutput) {
+        console.log(JSON.stringify({ ok: true, enabled }));
+        return;
+    }
+    console.log(enabled ? "✅ cvh 已启用" : "⚠️  cvh 已停用");
+};
+//# sourceMappingURL=toggle.js.map

package/dist/commands/toggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.js","sourceRoot":"","sources":["../../src/commands/toggle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,OAAgB,EAAE,UAAmB,EAAiB,EAAE;IACtF,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;IAEzB,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,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,72 @@
+/**
+ * `cvh` 配置读写：拍平一层 JSON，存于 `~/.claude/cc-vision-hook.json`。
+ * 优先级：CLI flags > 环境变量 > config json > 默认值（CLI/env 合并逻辑在调用处完成，本文件只负责 json 层）。
+ */
+/** 支持的视觉解析上游 provider（内部映射到对应的 AI SDK 包，见 vision.ts）。 */
+export type CvhProvider = "oai" | "responses" | "anthropic" | "gemini";
+export interface CvhConfig {
+    /** 唯一运行开关：true 处理图片，false 立即空返回。默认 false（安装后需要显式 enable）。 */
+    enabled: boolean;
+    /** 视觉模型上游 provider。 */
+    provider: CvhProvider;
+    /** 视觉模型名（provider 内部的模型 id）。 */
+    model: string;
+    /** 上游 API base URL，留空则使用 provider 默认官方地址。 */
+    baseUrl?: string;
+    /**
+     * API Key，明文存储（用户决策：明文可接受，类比 Claude Code 第三方接入本身也是明文存 code/token）。
+     * install 时会把配置文件权限设为 0600，降低同机其他用户读取的风险。
+     */
+    apiKey?: string;
+    /** 单次视觉解析请求超时（毫秒）。 */
+    timeoutMs: number;
+    /** 视觉模型单次回复最大 token 数。 */
+    maxTokens: number;
+    /** 磁盘缓存 TTL（天）。全局共享，见 cache.ts。 */
+    cache: {
+        ttlDays: number;
+    };
+    /** 是否已安装 MCP server（仅用于 status/doctor 展示，不参与开关逻辑）。 */
+    mcpInstalled: boolean;
+}
+export declare const DEFAULT_CONFIG: CvhConfig;
+/**
+ * Claude Code 配置根目录（即 `~/.claude`）。
+ *
+ * 支持 `CVH_CLAUDE_HOME` 环境变量覆盖，用于：
+ * ① 单测/集成测试注入隔离的临时目录，避免污染真实 `~/.claude`；
+ * ② 真机验证时用隔离的临时 HOME 跑一次真实 Claude Code 会话，不影响用户日常配置。
+ * 所有需要拼 `~/.claude/...` 路径的模块都应该调用这个函数，不要各自直接 `homedir()`。
+ *
+ * @returns Claude Code 配置根目录的绝对路径
+ */
+export declare const getClaudeHomeDir: () => string;
+/** `cvh` 在用户主目录下的根目录：`~/.claude/cc-vision-hook/`。 */
+export declare const getCvhHomeDir: () => string;
+/** 配置文件路径：`~/.claude/cc-vision-hook.json`（与 Claude Code 自身配置同级，便于用户发现）。 */
+export declare const getConfigPath: () => string;
+/**
+ * 读取配置文件，文件不存在时返回默认配置（不落盘，install 阶段才落盘）。
+ *
+ * @returns 合并后的配置对象
+ */
+export declare const loadConfig: () => Promise<CvhConfig>;
+/**
+ * 写入配置文件，并设置 `0600` 权限（仅当前用户可读写，因为里面可能存明文 API key）。
+ *
+ * @param config - 要写入的完整配置对象
+ */
+export declare const saveConfig: (config: CvhConfig) => Promise<void>;
+/**
+ * 读取环境变量覆盖项（`CVH_*`），用于命令行免配置文件临时覆盖场景。
+ *
+ * @returns 环境变量中显式设置的配置片段（未设置的字段不出现在返回对象中）
+ */
+export declare const loadEnvOverrides: () => Partial<CvhConfig>;
+/**
+ * 按优先级合并配置：环境变量 > 配置文件 > 默认值。
+ * （CLI flags 由调用方在拿到这个结果之后再叠加一层，优先级最高。）
+ *
+ * @returns 最终生效的配置对象
+ */
+export declare const resolveConfig: () => Promise<CvhConfig>;

package/dist/config.js

@@ -0,0 +1,94 @@
+/**
+ * `cvh` 配置读写：拍平一层 JSON，存于 `~/.claude/cc-vision-hook.json`。
+ * 优先级：CLI flags > 环境变量 > config json > 默认值（CLI/env 合并逻辑在调用处完成，本文件只负责 json 层）。
+ */
+import { readFile, writeFile, mkdir, chmod } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+export const DEFAULT_CONFIG = {
+    enabled: false,
+    provider: "oai",
+    model: "gpt-4o-mini",
+    timeoutMs: 45000,
+    maxTokens: 1200,
+    cache: { ttlDays: 7 },
+    mcpInstalled: false,
+};
+/**
+ * Claude Code 配置根目录（即 `~/.claude`）。
+ *
+ * 支持 `CVH_CLAUDE_HOME` 环境变量覆盖，用于：
+ * ① 单测/集成测试注入隔离的临时目录，避免污染真实 `~/.claude`；
+ * ② 真机验证时用隔离的临时 HOME 跑一次真实 Claude Code 会话，不影响用户日常配置。
+ * 所有需要拼 `~/.claude/...` 路径的模块都应该调用这个函数，不要各自直接 `homedir()`。
+ *
+ * @returns Claude Code 配置根目录的绝对路径
+ */
+export const getClaudeHomeDir = () => process.env.CVH_CLAUDE_HOME || join(homedir(), ".claude");
+/** `cvh` 在用户主目录下的根目录：`~/.claude/cc-vision-hook/`。 */
+export const getCvhHomeDir = () => join(getClaudeHomeDir(), "cc-vision-hook");
+/** 配置文件路径：`~/.claude/cc-vision-hook.json`（与 Claude Code 自身配置同级，便于用户发现）。 */
+export const getConfigPath = () => join(getClaudeHomeDir(), "cc-vision-hook.json");
+/**
+ * 读取配置文件，文件不存在时返回默认配置（不落盘，install 阶段才落盘）。
+ *
+ * @returns 合并后的配置对象
+ */
+export const loadConfig = async () => {
+    try {
+        const raw = await readFile(getConfigPath(), "utf8");
+        const parsed = JSON.parse(raw);
+        return { ...DEFAULT_CONFIG, ...parsed, cache: { ...DEFAULT_CONFIG.cache, ...parsed.cache } };
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+};
+/**
+ * 写入配置文件，并设置 `0600` 权限（仅当前用户可读写，因为里面可能存明文 API key）。
+ *
+ * @param config - 要写入的完整配置对象
+ */
+export const saveConfig = async (config) => {
+    const path = getConfigPath();
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    // 明文 API key 落盘，权限收紧到仅当前用户可读写，降低同机多用户环境下的泄露面。
+    await chmod(path, 0o600).catch(() => { });
+};
+/**
+ * 读取环境变量覆盖项（`CVH_*`），用于命令行免配置文件临时覆盖场景。
+ *
+ * @returns 环境变量中显式设置的配置片段（未设置的字段不出现在返回对象中）
+ */
+export const loadEnvOverrides = () => {
+    const overrides = {};
+    if (process.env.CVH_ENABLED !== undefined)
+        overrides.enabled = process.env.CVH_ENABLED === "1" || process.env.CVH_ENABLED === "true";
+    if (process.env.CVH_PROVIDER)
+        overrides.provider = process.env.CVH_PROVIDER;
+    if (process.env.CVH_MODEL)
+        overrides.model = process.env.CVH_MODEL;
+    if (process.env.CVH_BASE_URL)
+        overrides.baseUrl = process.env.CVH_BASE_URL;
+    if (process.env.CVH_API_KEY)
+        overrides.apiKey = process.env.CVH_API_KEY;
+    if (process.env.CVH_TIMEOUT_MS)
+        overrides.timeoutMs = Number(process.env.CVH_TIMEOUT_MS);
+    if (process.env.CVH_MAX_TOKENS)
+        overrides.maxTokens = Number(process.env.CVH_MAX_TOKENS);
+    return overrides;
+};
+/**
+ * 按优先级合并配置：环境变量 > 配置文件 > 默认值。
+ * （CLI flags 由调用方在拿到这个结果之后再叠加一层，优先级最高。）
+ *
+ * @returns 最终生效的配置对象
+ */
+export const resolveConfig = async () => {
+    const fileConfig = await loadConfig();
+    const envOverrides = loadEnvOverrides();
+    // envOverrides 目前不产生 cache 字段（无对应 CVH_CACHE_* 环境变量），这里始终沿用 fileConfig.cache。
+    return { ...fileConfig, ...envOverrides, cache: fileConfig.cache };
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/extract.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 通用图片提取器：不依赖任何工具的固定 schema，只依赖结构自省 + 少量已知的旁路触发规则。
+ *
+ * 已知三种真实 tool_response shape，彼此完全不同：
+ *   - Read 工具：判别式对象 { type: "image", file: { base64, type, ... } }
+ *   - MCP 工具：content block 数组 [{ type: "image", source: { type, media_type, data } }]
+ *   - Bash/PowerShell 工具：扁平对象 + isImage 布尔标志，图片是 stdout 里的完整 data URI 字符串
+ * 因为 cvh 的策略是"只追加不替换"（不需要精确还原成目标 schema），
+ * 提取器只需要"找到"图片，不需要保留可回写的精确路径信息。
+ */
+/** 单张被提取出来的图片。 */
+export interface ExtractedImage {
+    /** 不含 data URI 前缀的纯 base64 数据。 */
+    base64: string;
+    /** 形如 "image/png" 的 MIME 类型。 */
+    mimeType: string;
+    /** 在原始结构中的调试定位路径（如 "$.file.base64"），仅用于日志排查，不用于回写。 */
+    path: string;
+}
+/**
+ * 从任意嵌套的 JSON 结构（对象/数组/字符串）中递归提取出所有可识别的图片。
+ *
+ * 识别规则（对应三种已知真实样本）：
+ * - 规则 A：某一层同时具备"base64 类字段"+"mime 类型字段"（Read/MCP 场景）；
+ * - 规则 B：某一层存在 `isImage === true` 标志时，去检查同级的 stdout/output/content 字段（Bash/PowerShell 场景）；
+ * - 规则 C：字符串本身就是一个完整的 data URI（配合规则 B 触发，也可能独立命中）。
+ *
+ * @param node - 待扫描的任意 JSON 值（一般传入某个工具的 tool_response）
+ * @param path - 当前递归位置的调试定位路径，外部调用无需传入
+ * @returns 本次扫描发现的所有图片（可能为空数组）
+ */
+export declare const extractImages: (node: unknown, path?: string) => ExtractedImage[];

package/dist/extract.js

@@ -0,0 +1,105 @@
+/**
+ * 通用图片提取器：不依赖任何工具的固定 schema，只依赖结构自省 + 少量已知的旁路触发规则。
+ *
+ * 已知三种真实 tool_response shape，彼此完全不同：
+ *   - Read 工具：判别式对象 { type: "image", file: { base64, type, ... } }
+ *   - MCP 工具：content block 数组 [{ type: "image", source: { type, media_type, data } }]
+ *   - Bash/PowerShell 工具：扁平对象 + isImage 布尔标志，图片是 stdout 里的完整 data URI 字符串
+ * 因为 cvh 的策略是"只追加不替换"（不需要精确还原成目标 schema），
+ * 提取器只需要"找到"图片，不需要保留可回写的精确路径信息。
+ */
+// base64 解码后的大小上限（20MB）。参考 Claude Code 官方 BashTool 的 MAX_IMAGE_FILE_SIZE 同款阈值，
+// 避免把无关的大 base64 字段误判成图片、发起不必要的视觉解析调用。
+const MAX_DECODED_BYTES = 20 * 1024 * 1024;
+const IMAGE_TYPE_MARKERS = new Set(["image", "image/png", "image/jpeg", "image/jpg", "image/webp", "image/gif", "image/bmp"]);
+const BASE64_FIELD_NAMES = ["base64", "data"];
+const MIME_FIELD_NAMES = ["type", "media_type", "mimeType"];
+// Bash/PowerShell 场景下，isImage===true 时应该去检查的候选字符串字段名。
+const DATA_URI_CARRIER_FIELDS = ["stdout", "output", "content"];
+const DATA_URI_RE = /^data:(image\/[a-z0-9.+_-]+);base64,(.+)$/i;
+// base64 字符集校验（允许换行/空白，做基础粗过滤，不追求 100% 严格）。
+const BASE64_CHARSET_RE = /^[A-Za-z0-9+/=\s]+$/;
+/**
+ * 粗略判断一个字符串是否"像"base64 编码内容：长度、字符集、且解码后不超过大小上限。
+ *
+ * @param value - 待检测的字符串
+ * @returns 是否可能是合法的图片 base64 数据
+ */
+const looksLikeBase64 = (value) => {
+    if (value.length < 64)
+        return false; // 太短的字符串不太可能是图片
+    if (!BASE64_CHARSET_RE.test(value))
+        return false;
+    // base64 每 4 字符编码 3 字节，用长度估算解码后大小，避免真的 decode 一次超大字符串。
+    const estimatedBytes = (value.length / 4) * 3;
+    return estimatedBytes <= MAX_DECODED_BYTES;
+};
+/**
+ * 判断某个字符串值是否命中"图片类型标记"（如 "image"、"image/png" 等）。
+ *
+ * @param value - 待检测的字符串
+ * @returns 是否是已知的图片类型标记
+ */
+const matchesImageTypeMarker = (value) => IMAGE_TYPE_MARKERS.has(value) || /^image\/[a-z0-9.+_-]+$/i.test(value);
+/**
+ * 把 MIME 字段值归一化成标准的 "image/xxx" 形式（有些字段只给了 "image" 这种粗粒度值时兜底成 png）。
+ *
+ * @param raw - 原始 MIME 字段值
+ * @returns 归一化后的 MIME 类型字符串
+ */
+const normalizeMime = (raw) => (raw === "image" ? "image/png" : raw);
+/**
+ * 从任意嵌套的 JSON 结构（对象/数组/字符串）中递归提取出所有可识别的图片。
+ *
+ * 识别规则（对应三种已知真实样本）：
+ * - 规则 A：某一层同时具备"base64 类字段"+"mime 类型字段"（Read/MCP 场景）；
+ * - 规则 B：某一层存在 `isImage === true` 标志时，去检查同级的 stdout/output/content 字段（Bash/PowerShell 场景）；
+ * - 规则 C：字符串本身就是一个完整的 data URI（配合规则 B 触发，也可能独立命中）。
+ *
+ * @param node - 待扫描的任意 JSON 值（一般传入某个工具的 tool_response）
+ * @param path - 当前递归位置的调试定位路径，外部调用无需传入
+ * @returns 本次扫描发现的所有图片（可能为空数组）
+ */
+export const extractImages = (node, path = "$") => {
+    const results = [];
+    if (Array.isArray(node)) {
+        node.forEach((item, i) => results.push(...extractImages(item, `${path}[${i}]`)));
+        return results;
+    }
+    if (typeof node === "string") {
+        // 规则 C：字符串本身是 data URI。
+        const match = node.match(DATA_URI_RE);
+        if (match?.[1] && match[2] && looksLikeBase64(match[2])) {
+            results.push({ base64: match[2], mimeType: match[1], path });
+        }
+        return results;
+    }
+    if (node && typeof node === "object") {
+        const obj = node;
+        // 规则 A：本层同时具备 base64 字段 + mime 类型字段。
+        const base64Field = BASE64_FIELD_NAMES.find((f) => typeof obj[f] === "string" && looksLikeBase64(obj[f]));
+        if (base64Field) {
+            const mimeValue = MIME_FIELD_NAMES.map((f) => obj[f]).find((v) => typeof v === "string" && matchesImageTypeMarker(v));
+            if (typeof mimeValue === "string") {
+                results.push({ base64: obj[base64Field], mimeType: normalizeMime(mimeValue), path: `${path}.${base64Field}` });
+            }
+        }
+        // 规则 B：isImage===true 旁路标志，检查候选字符串字段是否为 data URI。
+        if (obj.isImage === true) {
+            for (const field of DATA_URI_CARRIER_FIELDS) {
+                const value = obj[field];
+                if (typeof value === "string")
+                    results.push(...extractImages(value, `${path}.${field}`));
+            }
+        }
+        // 递归所有子字段，覆盖嵌套一层的情况（如 file.base64、source.data）。
+        for (const [key, value] of Object.entries(obj)) {
+            // 避免对已经在规则 B 里处理过的 data URI 载体字段重复递归产生重复结果。
+            if (obj.isImage === true && DATA_URI_CARRIER_FIELDS.includes(key))
+                continue;
+            results.push(...extractImages(value, `${path}.${key}`));
+        }
+    }
+    return results;
+};
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

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

package/dist/hooks/postToolUse.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `PostToolUse` Hook 处理逻辑。
+ *
+ * matcher 建议设为 `*`（匹配所有工具），检测逻辑在 hook 内部完成，不依赖工具名白名单——
+ * 这样能自动覆盖未来任何新工具。性能上已实测验证：Bun 进程启动 + import
+ * AI SDK provider 包耗时在 10ms 级别，可以接受挂在所有工具调用上。
+ *
+ * 只追加不替换：本 Hook 永远只输出 additionalContext，不使用 updatedToolOutput——
+ * 因为目标模型是"静默忽略型"，不需要真的把 image block 从 tool_response 里挪走，
+ * 只需要给模型补一段文字描述（这也是本项目相比"替换"方案最大的简化点）。
+ */
+import type { HookOutput } from "./userPromptSubmit.js";
+/** Claude Code 传给 `PostToolUse` hook 的 stdin payload（仅取用到的字段）。 */
+export interface PostToolUseInput {
+    session_id: string;
+    hook_event_name: "PostToolUse";
+    tool_name: string;
+    tool_input: unknown;
+    tool_response: unknown;
+}
+/**
+ * 处理一次 `PostToolUse` 事件。
+ *
+ * @param input - Claude Code 传入的 hook payload
+ * @returns 供 Claude Code 消费的 hook 输出（enabled=false 或未检测到图片时返回空对象）
+ */
+export declare const handlePostToolUse: (input: PostToolUseInput) => Promise<HookOutput>;

package/dist/hooks/postToolUse.js

@@ -0,0 +1,53 @@
+/**
+ * `PostToolUse` Hook 处理逻辑。
+ *
+ * matcher 建议设为 `*`（匹配所有工具），检测逻辑在 hook 内部完成，不依赖工具名白名单——
+ * 这样能自动覆盖未来任何新工具。性能上已实测验证：Bun 进程启动 + import
+ * AI SDK provider 包耗时在 10ms 级别，可以接受挂在所有工具调用上。
+ *
+ * 只追加不替换：本 Hook 永远只输出 additionalContext，不使用 updatedToolOutput——
+ * 因为目标模型是"静默忽略型"，不需要真的把 image block 从 tool_response 里挪走，
+ * 只需要给模型补一段文字描述（这也是本项目相比"替换"方案最大的简化点）。
+ */
+import { resolveConfig } from "../config.js";
+import { extractImages } from "../extract.js";
+import { findCacheByBytes, putCacheEntry } from "../cache.js";
+import { describeImage } from "../vision.js";
+/**
+ * 处理一次 `PostToolUse` 事件。
+ *
+ * @param input - Claude Code 传入的 hook payload
+ * @returns 供 Claude Code 消费的 hook 输出（enabled=false 或未检测到图片时返回空对象）
+ */
+export const handlePostToolUse = async (input) => {
+    const config = await resolveConfig();
+    if (!config.enabled)
+        return {};
+    const images = extractImages(input.tool_response);
+    if (images.length === 0)
+        return {};
+    const blocks = [];
+    for (const image of images) {
+        try {
+            const bytes = Buffer.from(image.base64, "base64");
+            let entry = await findCacheByBytes(bytes);
+            if (!entry) {
+                const description = await describeImage(image.base64, image.mimeType, config);
+                entry = await putCacheEntry(bytes, image.mimeType, input.tool_name, description, config.cache.ttlDays);
+            }
+            blocks.push(`<tool_image_vision id="${entry.imageId}" tool="${input.tool_name}">\n${entry.description}\n</tool_image_vision>`);
+        }
+        catch (error) {
+            blocks.push(`<tool_image_vision error="true" tool="${input.tool_name}">图片解析失败：${error instanceof Error ? error.message : String(error)}</tool_image_vision>`);
+        }
+    }
+    if (blocks.length === 0)
+        return {};
+    return {
+        hookSpecificOutput: {
+            hookEventName: "PostToolUse",
+            additionalContext: blocks.join("\n"),
+        },
+    };
+};
+//# sourceMappingURL=postToolUse.js.map

package/dist/hooks/postToolUse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postToolUse.js","sourceRoot":"","sources":["../../src/hooks/postToolUse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAY7C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,KAAuB,EAAuB,EAAE;IACtF,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAE/B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAClD,IAAI,KAAK,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC9E,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzG,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,OAAO,WAAW,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC,WAAW,wBAAwB,CAAC,CAAC;QACjI,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,yCAAyC,KAAK,CAAC,SAAS,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CACjJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO;QACL,kBAAkB,EAAE;YAClB,aAAa,EAAE,aAAa;YAC5B,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;SACrC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/hooks/userPromptSubmit.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `UserPromptSubmit` Hook 处理逻辑。
+ *
+ * 流程：enabled? -> 扫描 ~/.claude/image-cache/<session_id>/ -> 过滤未处理过的图片
+ *       -> 逐个"查缓存命中?/视觉解析->写缓存" -> 拼接 additionalContext。
+ *
+ * 只追加不替换：本 Hook 永远只输出 additionalContext，不尝试修改/删除原始 prompt
+ * （Claude Code 官方文档明确 UserPromptSubmit 无法替换 prompt，只能追加）。
+ */
+/** Claude Code 传给 `UserPromptSubmit` hook 的 stdin payload（仅取用到的字段）。 */
+export interface UserPromptSubmitInput {
+    session_id: string;
+    hook_event_name: "UserPromptSubmit";
+    prompt: string;
+}
+/** Hook 的标准输出结构。 */
+export interface HookOutput {
+    hookSpecificOutput?: {
+        hookEventName: string;
+        additionalContext?: string;
+    };
+}
+/**
+ * 处理一次 `UserPromptSubmit` 事件。
+ *
+ * @param input - Claude Code 传入的 hook payload
+ * @returns 供 Claude Code 消费的 hook 输出（enabled=false 或没有新图片时返回空对象）
+ */
+export declare const handleUserPromptSubmit: (input: UserPromptSubmitInput) => Promise<HookOutput>;

package/dist/hooks/userPromptSubmit.js

@@ -0,0 +1,64 @@
+/**
+ * `UserPromptSubmit` Hook 处理逻辑。
+ *
+ * 流程：enabled? -> 扫描 ~/.claude/image-cache/<session_id>/ -> 过滤未处理过的图片
+ *       -> 逐个"查缓存命中?/视觉解析->写缓存" -> 拼接 additionalContext。
+ *
+ * 只追加不替换：本 Hook 永远只输出 additionalContext，不尝试修改/删除原始 prompt
+ * （Claude Code 官方文档明确 UserPromptSubmit 无法替换 prompt，只能追加）。
+ */
+import { resolveConfig } from "../config.js";
+import { scanPastedImages, readPastedImageBytes } from "../pasteScanner.js";
+import { findCacheByBytes, putCacheEntry, computeImageId } from "../cache.js";
+import { describeImage } from "../vision.js";
+import { loadSeenImageIds, markImagesSeen } from "../seenTracker.js";
+/**
+ * 处理一次 `UserPromptSubmit` 事件。
+ *
+ * @param input - Claude Code 传入的 hook payload
+ * @returns 供 Claude Code 消费的 hook 输出（enabled=false 或没有新图片时返回空对象）
+ */
+export const handleUserPromptSubmit = async (input) => {
+    const config = await resolveConfig();
+    if (!config.enabled)
+        return {};
+    const pastedImages = await scanPastedImages(input.session_id);
+    if (pastedImages.length === 0)
+        return {};
+    const seenIds = await loadSeenImageIds(input.session_id);
+    const blocks = [];
+    const newlySeenIds = [];
+    for (const file of pastedImages) {
+        try {
+            const bytes = await readPastedImageBytes(file.path);
+            const imageId = computeImageId(bytes);
+            // 本 session 内已经展示过的图片不再重复塞进 additionalContext（内容 hash 缓存本身仍全局共享，
+            // 这里只是过滤"要不要在这一轮上下文里再提一次"，避免多轮对话后上下文线性膨胀）。
+            if (seenIds.has(imageId))
+                continue;
+            let entry = await findCacheByBytes(bytes);
+            if (!entry) {
+                const base64 = bytes.toString("base64");
+                const description = await describeImage(base64, file.mimeType, config);
+                entry = await putCacheEntry(bytes, file.mimeType, "paste", description, config.cache.ttlDays);
+            }
+            blocks.push(`<image_vision id="${entry.imageId}">\n${entry.description}\n</image_vision>`);
+            newlySeenIds.push(entry.imageId);
+        }
+        catch (error) {
+            // 单张图片解析失败不应该阻断整个提交流程，跳过并继续处理其他图片。
+            blocks.push(`<image_vision error="true">图片解析失败：${error instanceof Error ? error.message : String(error)}</image_vision>`);
+        }
+    }
+    if (newlySeenIds.length > 0)
+        await markImagesSeen(input.session_id, newlySeenIds);
+    if (blocks.length === 0)
+        return {};
+    return {
+        hookSpecificOutput: {
+            hookEventName: "UserPromptSubmit",
+            additionalContext: blocks.join("\n"),
+        },
+    };
+};
+//# sourceMappingURL=userPromptSubmit.js.map

package/dist/hooks/userPromptSubmit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userPromptSubmit.js","sourceRoot":"","sources":["../../src/hooks/userPromptSubmit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAiBrE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,KAA4B,EAAuB,EAAE;IAChG,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAE/B,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzC,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACzD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACtC,iEAAiE;YACjE,2CAA2C;YAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,SAAS;YAEnC,IAAI,KAAK,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACxC,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACvE,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChG,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,WAAW,mBAAmB,CAAC,CAAC;YAC3F,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mCAAmC;YACnC,MAAM,CAAC,IAAI,CAAC,qCAAqC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC5H,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,cAAc,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAClF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO;QACL,kBAAkB,EAAE;YAClB,aAAa,EAAE,kBAAkB;YACjC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;SACrC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * cvh 包的默认导出入口，等价于 `./sdk`（保留两个导出路径以兼容不同引用习惯）。
+ */
+export * from "./sdk/index.js";

package/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * cvh 包的默认导出入口，等价于 `./sdk`（保留两个导出路径以兼容不同引用习惯）。
+ */
+export * from "./sdk/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC"}

package/dist/pasteScanner.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 用户粘贴图片场景的扫描器：复用 Claude Code 官方在用户粘贴图片时会提前落盘的旁路事实。
+ *
+ * 依赖的实现细节（非官方承诺的稳定 API，best-effort，不做版本防御）：
+ * `~/.claude/image-cache/<session_id>/<pasteId>.<ext>`
+ * 该路径已通过泄露源码 `src/utils/imageStore.ts` 的 `getImageStoreDir()` 源码级确认，
+ * `session_id` 与 hook input 里的顶层 `session_id` 字段是同一个值。
+ */
+/** 一个已落盘的粘贴图片文件。 */
+export interface PastedImageFile {
+    path: string;
+    mimeType: string;
+    mtimeMs: number;
+}
+/**
+ * 拼出指定 session 的 image-cache 目录路径。
+ *
+ * @param sessionId - Claude Code hook input 里的 `session_id` 字段
+ * @returns 该 session 对应的图片缓存目录绝对路径
+ */
+export declare const getImageCacheDir: (sessionId: string) => string;
+/**
+ * 扫描指定 session 的 image-cache 目录，列出所有图片文件（按修改时间升序）。
+ * 目录不存在时（如该 session 从未粘贴过图片）静默返回空数组，不抛错——
+ * 这是预期中的常见情况，不是异常。
+ *
+ * @param sessionId - Claude Code hook input 里的 `session_id` 字段
+ * @returns 该 session 目录下所有可识别的图片文件列表
+ */
+export declare const scanPastedImages: (sessionId: string) => Promise<PastedImageFile[]>;
+/**
+ * 读取指定图片文件的字节内容。
+ *
+ * @param path - 图片文件绝对路径
+ * @returns 图片二进制数据
+ */
+export declare const readPastedImageBytes: (path: string) => Promise<Buffer>;