@infimind-next/ai-hive-mcp 0.4.2 → 0.5.0

package/dist/setup/run-setup.js

@@ -1,6 +1,6 @@
 import { spawnSync } from "node:child_process";
 import { chmod, mkdir, readFile, rename, stat, unlink, writeFile, } from "node:fs/promises";
-import { basename, dirname, join } from "node:path";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep, } from "node:path";
 import { detectTarget } from "./detect.js";
 import { mergeJsonMcpServers, mergeOpenCodeServer, readJsonServerEnv, upsertCodexServer, } from "./merge.js";
 import { readBundledSkills } from "./skills.js";
@@ -127,7 +127,11 @@ async function detectAll(targets, dependencies) {
 }
 function buildServerEnv(config, key) {
     return {
-        ...(key ? { AI_HIVE_MCP_KEY: key } : {}),
+        ...(key
+            ? { AI_HIVE_MCP_KEY: key }
+            : {
+                AI_HIVE_WORKBUDDY_CREDENTIALS_FILE: resolve(config.credentialsFile),
+            }),
         ...(config.endpointExplicit
             ? { AI_HIVE_API_ENDPOINT: config.endpoint }
             : {}),
@@ -245,7 +249,8 @@ async function configureClaudeCode(input) {
         };
     }
     // 重复执行时 claude 会因为同名服务器报错; 先移除再添加, 保证 setup 可重复运行.
-    const runner = input.dependencies.runCommand ?? defaultRunner;
+    const runner = input.dependencies.runCommand ??
+        ((command, args) => defaultRunner(command, args, input.dependencies));
     await runner("claude", ["mcp", "remove", MCP_SERVER_NAME, "--scope", "user"]);
     const result = await runner("claude", args);
     if (!result.ok) {
@@ -270,15 +275,129 @@ function maskedCommand(args) {
         .map((part) => part.startsWith("AI_HIVE_MCP_KEY=") ? "AI_HIVE_MCP_KEY=***" : part)
         .join(" ");
 }
-async function defaultRunner(command, args) {
-    const result = spawnSync(command, args, {
+async function defaultRunner(command, args, input) {
+    const executable = input.platform === "win32"
+        ? await resolveWindowsCommand(command, input.env)
+        : { command, prefix: [] };
+    if (!executable)
+        return { ok: false };
+    const result = spawnSync(executable.command, [...executable.prefix, ...args], {
         stdio: "ignore",
-        // Windows 上 npm 安装的是 claude.cmd, Node 必须经 shell 才能执行; 参数只含常量和已校验的密钥.
-        shell: process.platform === "win32",
+        env: input.env,
+        shell: false,
         timeout: 30_000,
     });
     return { ok: result.status === 0 };
 }
+async function resolveWindowsCommand(command, env) {
+    const pathKey = Object.keys(env)
+        .sort()
+        .find((key) => key.toLowerCase() === "path");
+    const pathExtKey = Object.keys(env)
+        .sort()
+        .find((key) => key.toLowerCase() === "pathext");
+    const extensions = (pathExtKey ? env[pathExtKey] : undefined)?.split(";") ?? [
+        ".com",
+        ".exe",
+        ".bat",
+        ".cmd",
+    ];
+    for (const rawDirectory of (pathKey ? (env[pathKey] ?? "") : "").split(";")) {
+        const directory = rawDirectory.replace(/^"(.*)"$/, "$1");
+        if (!directory)
+            continue;
+        for (const rawExtension of extensions) {
+            const extension = rawExtension.toLowerCase();
+            if (![".exe", ".com", ".cmd", ".bat"].includes(extension))
+                continue;
+            const file = join(directory, `${command}${extension}`);
+            if (!(await stat(file).catch(() => null))?.isFile())
+                continue;
+            if (extension === ".exe" || extension === ".com") {
+                return { command: file, prefix: [] };
+            }
+            // 凭据路径不能交给 cmd 解释; npm shim 只用于定位同一安装的真实入口.
+            const packageRoot = join(directory, "node_modules/@anthropic-ai/claude-code");
+            try {
+                const metadata = JSON.parse(await readFile(join(packageRoot, "package.json"), "utf8"));
+                const bin = typeof metadata.bin === "string"
+                    ? metadata.bin
+                    : metadata.bin?.[command];
+                if (metadata.name !== "@anthropic-ai/claude-code" ||
+                    typeof bin !== "string")
+                    return null;
+                const entry = resolve(packageRoot, bin);
+                const local = relative(packageRoot, entry);
+                if (local === ".." ||
+                    local.startsWith(`..${sep}`) ||
+                    isAbsolute(local) ||
+                    !(await stat(entry)).isFile())
+                    return null;
+                const javascript = /\.(?:c|m)?js$/i.test(entry);
+                if (!javascript && !/\.(?:exe|com)$/i.test(entry))
+                    return null;
+                // 邻接官方包不能证明 wrapper 没有自定义账号环境或参数, 必须同时校验 shim 本身.
+                if (!isStandardNpmShim(await readFile(file, "utf8"), relative(directory, entry).replaceAll("/", "\\"), javascript))
+                    return null;
+                return javascript
+                    ? { command: process.execPath, prefix: [entry] }
+                    : { command: entry, prefix: [] };
+            }
+            catch {
+                // 已命中的 shim 无法安全解析时停止, 不切到 PATH 中另一份客户端安装.
+            }
+            return null;
+        }
+    }
+    return null;
+}
+function isStandardNpmShim(source, target, javascript) {
+    const lines = source
+        .replaceAll("\r\n", "\n")
+        .trim()
+        .split("\n")
+        .map((line) => line.trim().replace(/[ \t]+(?=%\*$)/, " "))
+        .filter(Boolean);
+    const head = [
+        "@ECHO off",
+        "GOTO start",
+        ":find_dp0",
+        "SET dp0=%~dp0",
+        "EXIT /b",
+        ":start",
+        "SETLOCAL",
+        "CALL :find_dp0",
+    ];
+    const nodeBranch = [
+        'IF EXIST "%dp0%\\node.exe" (',
+        'SET "_prog=%dp0%\\node.exe"',
+        ") ELSE (",
+        'SET "_prog=node"',
+    ];
+    const finish = "endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & ";
+    const invoke = `"%_prog%"  "%dp0%\\${target}" %*`;
+    // npm cmd-shim 8 与 9 将 PATHEXT 放在不同位置, 只接受已实测生成的两种标准结构.
+    const bodies = javascript
+        ? [
+            [
+                ...nodeBranch,
+                "SET PATHEXT=%PATHEXT:;.JS;=;%",
+                ")",
+                `${finish}${invoke}`,
+            ],
+            [
+                ...nodeBranch,
+                ")",
+                `${finish}set PATHEXT=%PATHEXT:;.JS;=;% & ${invoke}`,
+            ],
+        ]
+        : [[`"%dp0%\\${target}" %*`]];
+    return bodies.some((body) => {
+        const expected = [...head, ...body];
+        return (lines.length === expected.length &&
+            lines.every((line, index) => line === expected[index]));
+    });
+}
 async function installSkills(input) {
     const errors = [];
     let changed = 0;

package/dist/user-notices.d.ts

@@ -1,3 +1,47 @@
+import { z } from "zod";
+export declare const noticeSchema: z.ZodObject<{
+    id: z.ZodString;
+    revision: z.ZodString;
+    kind: z.ZodEnum<["RECHARGE_PROMOTION", "ANNOUNCEMENT"]>;
+    title: z.ZodString;
+    message: z.ZodString;
+    details: z.ZodString;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    action: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        url: string;
+    }, {
+        label: string;
+        url: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    revision: string;
+    kind: "RECHARGE_PROMOTION" | "ANNOUNCEMENT";
+    message: string;
+    title: string;
+    details: string;
+    expiresAt: string | null;
+    action?: {
+        label: string;
+        url: string;
+    } | undefined;
+}, {
+    id: string;
+    revision: string;
+    kind: "RECHARGE_PROMOTION" | "ANNOUNCEMENT";
+    message: string;
+    title: string;
+    details: string;
+    expiresAt: string | null;
+    action?: {
+        label: string;
+        url: string;
+    } | undefined;
+}>;
 export declare function toolResultContent(value: unknown): {
     type: "text";
     text: string;

package/dist/user-notices.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 // 独立 npm 包不能依赖私有 workspace, 与 contracts 的通知文本通过跨包用例校验.
-const noticeSchema = z.object({
+export const noticeSchema = z.object({
     id: z.string().min(1),
     revision: z.string().min(1),
     kind: z.enum(["RECHARGE_PROMOTION", "ANNOUNCEMENT"]),
@@ -18,16 +18,9 @@ const noticeSchema = z.object({
     })
         .optional(),
 });
-export function toolResultContent(value) {
-    if (!value ||
-        typeof value !== "object" ||
-        Array.isArray(value) ||
-        !("userNotices" in value)) {
-        return [{ type: "text", text: JSON.stringify(value) }];
-    }
-    const { userNotices, ...businessResult } = value;
-    const notices = Array.isArray(userNotices)
-        ? userNotices.flatMap((raw) => {
+function noticeContent(value, deduplicate = false) {
+    const valid = Array.isArray(value)
+        ? value.flatMap((raw) => {
             const parsed = noticeSchema.safeParse(raw);
             return parsed.success &&
                 (parsed.data.expiresAt === null ||
@@ -36,17 +29,42 @@ export function toolResultContent(value) {
                 : [];
         })
         : [];
+    const notices = deduplicate
+        ? [
+            ...new Map(valid.map((notice) => [`${notice.id}:${notice.revision}`, notice])).values(),
+        ]
+        : valid;
+    return notices.map((notice) => ({
+        type: "text",
+        text: [
+            `${notice.title}：${notice.message}`,
+            ...(notice.action
+                ? [`${notice.action.label}：${notice.action.url}`]
+                : []),
+            ...(notice.details ? [`充值档位：\n${notice.details}`] : []),
+        ].join("\n"),
+    }));
+}
+export function toolResultContent(value) {
+    if (value &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        "schemaVersion" in value &&
+        value.schemaVersion === 2 &&
+        "notices" in value) {
+        return [
+            { type: "text", text: JSON.stringify(value) },
+            ...noticeContent(value.notices, true),
+        ];
+    }
+    if (!value ||
+        typeof value !== "object" ||
+        Array.isArray(value) ||
+        !("userNotices" in value))
+        return [{ type: "text", text: JSON.stringify(value) }];
+    const { userNotices, ...businessResult } = value;
     return [
         { type: "text", text: JSON.stringify(businessResult) },
-        ...notices.map((notice) => ({
-            type: "text",
-            text: [
-                `${notice.title}：${notice.message}`,
-                ...(notice.action
-                    ? [`${notice.action.label}：${notice.action.url}`]
-                    : []),
-                ...(notice.details ? [`充值档位：\n${notice.details}`] : []),
-            ].join("\n"),
-        })),
+        ...noticeContent(userNotices),
     ];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infimind-next/ai-hive-mcp",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "private": false,
   "type": "module",
   "engines": {
@@ -13,13 +13,6 @@
     "dist",
     "skills"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
-    "lint": "eslint \"src/**/*.ts\"",
-    "prepack": "pnpm run build",
-    "test": "vitest run"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "file-type": "^21.3.4",
@@ -30,5 +23,11 @@
     "typescript": "^5.0.0",
     "typescript-eslint": "^8.0.0",
     "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "lint": "eslint \"src/**/*.ts\"",
+    "test": "vitest run"
   }
-}
+}

package/skills/ai-hive-billing/SKILL.md

@@ -31,3 +31,5 @@ MCP 工具：`get_billing_summary`、`list_billing_records`、`get_billing_recor
 ## 账户信息
 
 需要账户资料或充值入口时用 `get_user_info`。该工具同时返回当前活动，有活动时可以把活动信息转达给用户。
+
+新版包模型查询默认 V2。先按类型或关键词查轻目录，找到候选即可 get_model，默认读取参数和价格；已知模型 ID 直接 get_model。无需遍历所有分页，完整目录需求才读取 nextCursor。正式调用前预检并确认费用；未知提交先查原任务，不自动付费重试。

package/skills/ai-hive-image-video-generation/SKILL.md

@@ -39,3 +39,5 @@ description: 用蜂巢生成图片或视频。用户要出图、图生图、文
 
 - 成功：给结果链接或 mediaId，并说明本次消费（单位是蜂蜜，充值实付才是元）。
 - 失败：说明失败原因和用户能做什么，不展示上游响应体。
+
+新版包模型查询默认 V2。先按类型或关键词查轻目录，找到候选即可 get_model，默认读取参数和价格；已知模型 ID 直接 get_model。无需遍历所有分页，完整目录需求才读取 nextCursor。正式调用前预检并确认费用；未知提交先查原任务，不自动付费重试。

package/skills/ai-hive-media-upload/SKILL.md

@@ -31,3 +31,5 @@ description: 把本机图片、视频、音频或文档传给蜂巢，换取可
 - `complete_media_upload` 失败时不要直接拿去生成，先重试确认或重新上传。
 - 单文件大小和格式限制以 `get_model` 返回的媒体要求为准。
 - 不要把文件内容贴进对话文本，必须走上传换取 `mediaId`。
+
+新版包模型查询默认 V2。先按类型或关键词查轻目录，找到候选即可 get_model，默认读取参数和价格；已知模型 ID 直接 get_model。无需遍历所有分页，完整目录需求才读取 nextCursor。正式调用前预检并确认费用；未知提交先查原任务，不自动付费重试。

package/skills/ai-hive-model-selection/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ai-hive-model-selection
-description: 在蜂巢 AI 开放平台选择模型。用户要调用文字、图片或视频模型，但还没指定模型时使用；先列出可用模型和售价，再读取目标模型的参数契约，避免按记忆猜参数。也可用于比较同类模型的价格和线路。
+description: 在蜂巢 AI 开放平台选择模型。用户要调用文字、图片或视频模型，但还没指定模型时使用；先筛选轻目录，再读取候选模型的参数和价格，避免按记忆猜参数。也可用于比较同类模型的价格和线路。
 ---
 
 # 选择模型
@@ -14,7 +14,7 @@ description: 在蜂巢 AI 开放平台选择模型。用户要调用文字、图
 
 ## 步骤
 
-1. 列出候选模型（`detail=lite` 只返回选型需要的字段）：
+1. 按类型或关键词列出候选模型（目录每行仅 ID、名称、类型和素材模式）：
 
    ```
    ai-hive-mcp models --type IMAGE --json
@@ -27,7 +27,7 @@ description: 在蜂巢 AI 开放平台选择模型。用户要调用文字、图
    - 图片：`IMAGE`
    - 视频：`VIDEO`
 
-3. 比较 `pricingSummary` 里的 `saleMicros`。这是客户实际结算价，单位是蜂蜜微单位（1,000,000 微单位 = 1 蜂蜜），不要引用 `originalMicros`。只有充值实付金额才是元。
+3. 找到候选即可读取 `get_model` 默认参数与价格；已知 ID 可直接读取。比较 `pricingSnapshot` 里的 `saleMicros`。这是客户实际结算价，单位是蜂蜜微单位（1,000,000 微单位 = 1 蜂蜜），不要引用 `originalMicros`。只有充值实付金额才是元。
 4. 用 `get_model` / `ai-hive-mcp model <模型 ID> --json` 读取：
    - 支持的 `routingModes`
    - 参数 schema
@@ -46,5 +46,8 @@ description: 在蜂巢 AI 开放平台选择模型。用户要调用文字、图
 ## 失败处理
 
 - 返回"模型不存在或当前不可用"：重新列一遍模型，不要重试同一个 ID。
-- 返回没有价格：该模型暂不可售，换一个模型。
+- V2 轻目录不包含价格是正常行为：使用目录返回的 `publicModelId` 调用 `get_model`，读取价格和参数后再比较，不因此判定模型不可售。
+- `get_model` 详情价格缺失或不可用：暂停调用并核验详情的 pricing 章节与服务端状态，不自动换模型或发起生成。恢复后仍按原流程预检并确认费用。
 - 不要猜测参数名。`get_model` 没有给出的字段一律不要传。
+
+新版包模型查询默认 V2。先按类型或关键词查轻目录，找到候选即可 get_model，默认读取参数和价格；已知模型 ID 直接 get_model。无需遍历所有分页，完整目录需求才读取 nextCursor。正式调用前预检并确认费用；未知提交先查原任务，不自动付费重试。

package/skills/ai-hive-text-generation/SKILL.md

@@ -20,7 +20,7 @@ ai-hive-mcp run <模型 ID> "你的提示词" --json
 ## 必须遵守
 
 1. **每次付费调用都带 `clientRequestId`**，同一次业务请求重试必须复用同一个值。改参数后必须换新值，否则会被当成同一次请求去重。
-2. `pricingSnapshot` 可选。省略时客户端会自动向服务端取当前快照；手动传时必须是 `list_models` 返回的对应对象，且 `publicModelId`、`routingMode` 一致。
+2. `pricingSnapshot` 可选。省略时客户端会自动向服务端取当前快照；手动传时必须是 `get_model` 返回的对应快照对象，且 `publicModelId`、`routingMode` 一致。
 3. 多轮对话时把历史消息按 `system` / `user` / `assistant` 顺序传入。
 4. 图片理解：先把图片上传为 `mediaId`（见 `ai-hive-media-upload`），再放进 `messages[].mediaIds`。
 
@@ -37,3 +37,5 @@ ai-hive-mcp run <模型 ID> "你的提示词" --json
 - 给出生成结果。
 - 结果里包含 `chargeMicros` 时，换算成蜂蜜（除以 1,000,000）告诉用户本次消费；只有充值实付金额才是元。
 - 不要展示内部错误码或上游响应体。
+
+新版包模型查询默认 V2。先按类型或关键词查轻目录，找到候选即可 get_model，默认读取参数和价格；已知模型 ID 直接 get_model。无需遍历所有分页，完整目录需求才读取 nextCursor。正式调用前预检并确认费用；未知提交先查原任务，不自动付费重试。