feiguazhitou-mcp-cli 0.1.0

package/dist/skills.js

@@ -0,0 +1,139 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { COMMAND_NAME } from "./constants.js";
+import { outputLanguage, t } from "./i18n.js";
+export const SKILL_PROTOCOL = "feiguazhitou-mcp-cli.skills/v1";
+export const SKILL_PROTOCOL_VERSION = 1;
+const skillNamePattern = /^[a-z][a-z0-9-]{0,63}$/;
+function packageDirectory() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+}
+function skillsDirectory() {
+    return path.join(packageDirectory(), "skills");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requiredString(value, key, context) {
+    const candidate = value[key];
+    if (typeof candidate !== "string" || !candidate.trim()) {
+        throw new Error(t(`${context}.${key} 必须是非空字符串。`, `${context}.${key} must be a non-empty string.`));
+    }
+    return candidate;
+}
+function optionalString(value, key, context) {
+    const candidate = value[key];
+    if (candidate === undefined) {
+        return undefined;
+    }
+    if (typeof candidate !== "string" || !candidate.trim()) {
+        throw new Error(t(`${context}.${key} 存在时必须是非空字符串。`, `${context}.${key} must be a non-empty string when present.`));
+    }
+    return candidate;
+}
+function requiredStringArray(value, key, context) {
+    const candidate = value[key];
+    if (!Array.isArray(candidate) || !candidate.every((item) => typeof item === "string" && item.trim())) {
+        throw new Error(t(`${context}.${key} 必须是由非空字符串组成的数组。`, `${context}.${key} must be an array of non-empty strings.`));
+    }
+    return [...candidate];
+}
+function resolveEntrypoint(directory, entrypoint) {
+    if (path.isAbsolute(entrypoint)) {
+        throw new Error(t("Skill entrypoint 必须是包内相对路径。", "Skill entrypoint must be package-relative."));
+    }
+    const resolved = path.resolve(directory, entrypoint);
+    const relative = path.relative(directory, resolved);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw new Error(t("Skill entrypoint 必须位于对应的 Skill 目录内。", "Skill entrypoint must remain inside its skill directory."));
+    }
+    return resolved;
+}
+function parseSkillDescriptor(value, directoryName) {
+    const context = t(`Skill 清单 ${directoryName}`, `Skill manifest ${directoryName}`);
+    if (!isRecord(value)) {
+        throw new Error(t(`${context} 必须是 JSON 对象。`, `${context} must be a JSON object.`));
+    }
+    if (value.protocol !== SKILL_PROTOCOL || value.protocolVersion !== SKILL_PROTOCOL_VERSION) {
+        throw new Error(t(`${context} 未实现 ${SKILL_PROTOCOL}。`, `${context} does not implement ${SKILL_PROTOCOL}.`));
+    }
+    const name = requiredString(value, "name", context);
+    if (!skillNamePattern.test(name) || name !== directoryName) {
+        throw new Error(t(`${context}.name 必须匹配其小写 kebab-case 目录名。`, `${context}.name must match its lowercase kebab-case directory name.`));
+    }
+    if (value.apply !== "available") {
+        throw new Error(t(`${context}.apply 必须为 \"available\"。`, `${context}.apply must be \"available\".`));
+    }
+    if (!isRecord(value.requirements)) {
+        throw new Error(t(`${context}.requirements 必须是 JSON 对象。`, `${context}.requirements must be a JSON object.`));
+    }
+    return {
+        protocol: SKILL_PROTOCOL,
+        protocolVersion: SKILL_PROTOCOL_VERSION,
+        skillVersion: requiredString(value, "skillVersion", context),
+        name,
+        description: requiredString(value, "description", context),
+        ...(optionalString(value, "argumentHint", context) ? { argumentHint: optionalString(value, "argumentHint", context) } : {}),
+        apply: "available",
+        entrypoint: requiredString(value, "entrypoint", context),
+        capabilities: requiredStringArray(value, "capabilities", context),
+        requirements: {
+            command: requiredString(value.requirements, "command", context),
+            runtimeEnvironment: requiredStringArray(value.requirements, "runtimeEnvironment", context),
+            optionalRuntimeEnvironment: requiredStringArray(value.requirements, "optionalRuntimeEnvironment", context),
+        },
+    };
+}
+async function readSkill(directoryName) {
+    if (!skillNamePattern.test(directoryName)) {
+        throw new Error(t(`未知的内置 Skill '${directoryName}'。`, `Unknown bundled skill '${directoryName}'.`));
+    }
+    const directory = path.join(skillsDirectory(), directoryName);
+    const manifestCandidates = outputLanguage() === "en" ? ["skill.en.json", "skill.json"] : ["skill.json"];
+    let manifestText;
+    for (const filename of manifestCandidates) {
+        try {
+            manifestText = await readFile(path.join(directory, filename), "utf8");
+            break;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+    }
+    if (manifestText === undefined) {
+        throw new Error(t(`未知的内置 Skill '${directoryName}'。`, `Unknown bundled skill '${directoryName}'.`));
+    }
+    let descriptor;
+    try {
+        descriptor = parseSkillDescriptor(JSON.parse(manifestText), directoryName);
+    }
+    catch (error) {
+        throw new Error(t(`内置 Skill '${directoryName}' 无效：${error instanceof Error ? error.message : String(error)}`, `Invalid bundled skill '${directoryName}': ${error instanceof Error ? error.message : String(error)}`));
+    }
+    const markdown = await readFile(resolveEntrypoint(directory, descriptor.entrypoint), "utf8");
+    return { ...descriptor, markdown };
+}
+export function skillProtocolDocument() {
+    return {
+        protocol: SKILL_PROTOCOL,
+        protocolVersion: SKILL_PROTOCOL_VERSION,
+        commands: {
+            list: `${COMMAND_NAME} skills list --output json`,
+            show: `${COMMAND_NAME} skills show NAME [--output json|markdown]`,
+        },
+        transport: "local-package",
+        execution: t("CLI 只暴露 Skill metadata 和 Markdown，不会执行 Skill 内容。", "The CLI exposes skill metadata and Markdown only; it does not execute skill content."),
+    };
+}
+export async function listBundledSkills() {
+    const entries = await readdir(skillsDirectory(), { withFileTypes: true });
+    const skills = await Promise.all(entries.filter((entry) => entry.isDirectory()).map((entry) => readSkill(entry.name)));
+    return skills.map(({ markdown: _markdown, ...descriptor }) => descriptor).sort((left, right) => left.name.localeCompare(right.name));
+}
+export async function showBundledSkill(name) {
+    return await readSkill(name);
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/tool-catalog.js

@@ -0,0 +1,126 @@
+import { CATALOG_STALE_AFTER_DAYS, CATALOG_STALE_AFTER_MS, GENERATED_FAILURE_EXIT_POLICY_VERSION } from "./constants.js";
+import { t } from "./i18n.js";
+export const TOOL_CATALOG_PROTOCOL = "feiguazhitou-mcp-cli.tools/v1";
+export const TOOL_CATALOG_PROTOCOL_VERSION = 1;
+export function catalogFreshness(lastCheckedAt, now = Date.now()) {
+    const checkedAt = lastCheckedAt ? Date.parse(lastCheckedAt) : Number.NaN;
+    return {
+        lastCheckedAt: lastCheckedAt ?? null,
+        staleAfterMs: CATALOG_STALE_AFTER_MS,
+        isStale: !Number.isFinite(checkedAt) || now - checkedAt > CATALOG_STALE_AFTER_MS,
+    };
+}
+export function generatedCommandName(mcpTool) {
+    return mcpTool.replaceAll("_", "-");
+}
+function descriptorFor(tool, autoApprove) {
+    return {
+        mcpTool: tool.name,
+        command: generatedCommandName(tool.name),
+        autoApproved: autoApprove.has(tool.name) || autoApprove.has(generatedCommandName(tool.name)),
+        ...(tool.title ? { title: tool.title } : {}),
+        ...(tool.description ? { description: tool.description } : {}),
+        inputSchema: tool.inputSchema ?? { type: "object", properties: {} },
+        ...(tool.outputSchema === undefined ? {} : { outputSchema: tool.outputSchema }),
+        ...(tool.annotations === undefined ? {} : { annotations: tool.annotations }),
+    };
+}
+export function toolCatalog(manifest, currentTimeoutMs, autoApprove = [], lastCheckedAt) {
+    const autoApprovedTools = new Set(autoApprove);
+    const freshness = catalogFreshness(lastCheckedAt);
+    return {
+        protocol: TOOL_CATALOG_PROTOCOL,
+        protocolVersion: TOOL_CATALOG_PROTOCOL_VERSION,
+        artifact: {
+            id: manifest.artifactId,
+            generatedAt: manifest.generatedAt,
+            server: manifest.server,
+            timeoutMs: manifest.timeoutMs,
+            currentTimeoutMs,
+            executionTimeoutMs: currentTimeoutMs,
+            currentTimeoutMatches: manifest.timeoutMs === currentTimeoutMs,
+            failureExitPolicyVersion: manifest.failureExitPolicyVersion ?? null,
+            requiredFailureExitPolicyVersion: GENERATED_FAILURE_EXIT_POLICY_VERSION,
+            currentFailureExitPolicyMatches: manifest.failureExitPolicyVersion === GENERATED_FAILURE_EXIT_POLICY_VERSION,
+            ...freshness,
+        },
+        tools: manifest.tools.map((tool) => descriptorFor(tool, autoApprovedTools)).sort((left, right) => left.command.localeCompare(right.command)),
+    };
+}
+export function findTool(catalog, name) {
+    return catalog.tools.find((tool) => tool.command === name || tool.mcpTool === name);
+}
+export function toolInvocationTemplate(tool) {
+    return `feiguazhitou-mcp-cli run ${tool.command} --raw '<JSON matching inputSchema>' --output json`;
+}
+export function toolCatalogText(catalog) {
+    const lines = [
+        t(`已生成工具（${catalog.tools.length} 个）：`, `Generated tools (${catalog.tools.length}):`),
+        ...(catalog.artifact.currentTimeoutMatches
+            ? []
+            : [
+                t(`注意：生成产物的默认超时为 ${catalog.artifact.timeoutMs}ms；当前 run 会使用 ${catalog.artifact.executionTimeoutMs}ms，无需 refresh。`, `Note: the generated artifact default timeout is ${catalog.artifact.timeoutMs}ms; the current run uses ${catalog.artifact.executionTimeoutMs}ms without requiring refresh.`),
+            ]),
+        ...(catalog.artifact.currentFailureExitPolicyMatches
+            ? []
+            : [
+                t("注意：本地生成 CLI 不包含当前失败退出码策略；执行前必须 refresh。", "Note: the local generated CLI does not include the current failure-exit policy; refresh is required before execution."),
+            ]),
+        ...(catalog.artifact.isStale
+            ? [
+                t(`注意：本地工具目录已超过 ${CATALOG_STALE_AFTER_DAYS} 天未检查；当前命令没有连接 MCP。如需检查最新工具，执行 feiguazhitou-mcp-cli tools list --refresh。`, `Note: the local tool catalog has not been checked for over ${CATALOG_STALE_AFTER_DAYS} days; this command did not contact MCP. Run feiguazhitou-mcp-cli tools list --refresh to check for updated tools.`),
+            ]
+            : []),
+        ...catalog.tools.map((tool) => `  ${tool.command}${tool.autoApproved ? t(" [已自动批准]", " [auto-approved]") : ""}${tool.description ? ` - ${tool.description}` : ""}`),
+        "",
+        t("查看精确 schema：feiguazhitou-mcp-cli tools show NAME --output json", "Read an exact schema: feiguazhitou-mcp-cli tools show NAME --output json"),
+        t("执行工具：feiguazhitou-mcp-cli run COMMAND --raw '<JSON matching inputSchema>' --output json", "Run a tool: feiguazhitou-mcp-cli run COMMAND --raw '<JSON matching inputSchema>' --output json"),
+        t("复杂 JSON 也可使用 --raw @FILE，或通过 --raw - 从标准输入读取。", "Complex JSON can also use --raw @FILE, or --raw - to read from standard input."),
+        t("查看工作流指南：feiguazhitou-mcp-cli skills show feiguazhitou-mcp-cli", "Read the workflow guide: feiguazhitou-mcp-cli skills show feiguazhitou-mcp-cli"),
+    ];
+    return `${lines.join("\n")}\n`;
+}
+export function toolMarkdown(catalog, tool) {
+    const sections = [
+        `# ${tool.command}`,
+        "",
+        t(`- MCP 工具：\`${tool.mcpTool}\``, `- MCP tool: \`${tool.mcpTool}\``),
+        t(`- 自动批准：${tool.autoApproved ? "是" : "否"}`, `- Auto-approved: ${tool.autoApproved ? "yes" : "no"}`),
+        ...(catalog.artifact.currentTimeoutMatches
+            ? []
+            : [
+                t(`- 执行超时：生成默认值为 ${catalog.artifact.timeoutMs}ms；当前 run 使用 ${catalog.artifact.executionTimeoutMs}ms，无需 refresh。`, `- Execution timeout: the generated default is ${catalog.artifact.timeoutMs}ms; the current run uses ${catalog.artifact.executionTimeoutMs}ms without requiring refresh.`),
+            ]),
+        ...(catalog.artifact.currentFailureExitPolicyMatches
+            ? []
+            : [
+                t("- 执行状态：本地生成 CLI 不包含当前失败退出码策略；执行前需要 refresh。", "- Execution status: the local generated CLI does not include the current failure-exit policy; refresh is required before execution."),
+            ]),
+        ...(catalog.artifact.isStale
+            ? [
+                t(`- 目录状态：已超过 ${CATALOG_STALE_AFTER_DAYS} 天未检查；当前命令没有连接 MCP。需要检查最新工具时执行 \`feiguazhitou-mcp-cli tools list --refresh\`。`, `- Catalog status: it has not been checked for over ${CATALOG_STALE_AFTER_DAYS} days; this command did not contact MCP. Run \`feiguazhitou-mcp-cli tools list --refresh\` when a live check is needed.`),
+            ]
+            : []),
+        ...(tool.title ? [t(`- 标题：${tool.title}`, `- Title: ${tool.title}`)] : []),
+        ...(tool.description ? [t(`- 描述：${tool.description}`, `- Description: ${tool.description}`)] : []),
+        "",
+        t("## 调用方式", "## Invocation"),
+        "",
+        "```bash",
+        toolInvocationTemplate(tool),
+        "```",
+        "",
+        t("复杂 JSON 可改为 `--raw @FILE`，或使用 `--raw -` 从标准输入读取。", "For complex JSON, use `--raw @FILE`, or use `--raw -` to read standard input."),
+        "",
+        t("## 输入 Schema", "## Input Schema"),
+        "",
+        "```json",
+        JSON.stringify(tool.inputSchema, null, 2),
+        "```",
+    ];
+    if (tool.outputSchema !== undefined) {
+        sections.push("", t("## 输出 Schema", "## Output Schema"), "", "```json", JSON.stringify(tool.outputSchema, null, 2), "```");
+    }
+    return `${sections.join("\n")}\n`;
+}
+//# sourceMappingURL=tool-catalog.js.map

package/dist/tool-catalog.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "feiguazhitou-mcp-cli",
+  "version": "0.1.0",
+  "description": "Runtime schema discovery and MCPorter-generated CLI bridge for the local Feiguazhitou MCP service.",
+  "type": "module",
+  "bin": {
+    "feiguazhitou-mcp-cli": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "USER-GUIDE.md",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=20.19"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "package": "npm run build && node scripts/package.mjs",
+    "test": "npm run build && tsx --test tests/schema.test.ts tests/skills.test.ts tests/agent-protocol.test.ts",
+    "test:mcp": "tsx tests/fixtures/test-mcp-server.ts",
+    "test:integration": "npm run build && tsx --test tests/integration.test.ts",
+    "test:pack": "npm run build && tsx tests/pack.test.ts",
+    "test:e2e:mock": "npm run build && tsx --test tests/feiguazhitou-mcp.fixture.e2e.test.ts",
+    "test:e2e:fixture": "npm run test:e2e:mock",
+    "test:e2e:real": "npm run build && tsx --test tests/feiguazhitou-mcp.real.e2e.test.ts",
+    "test:all": "npm run test && npm run test:integration && npm run test:pack && npm run test:e2e:mock",
+    "mcporter:help": "mcporter generate-cli --help"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/client": "2.0.0",
+    "mcporter": "0.13.7"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/server": "2.0.0",
+    "@types/node": "24.10.0",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "zod": "4.4.3"
+  }
+}

package/skills/feiguazhitou-mcp-cli/SKILL.en.md

@@ -0,0 +1,99 @@
+---
+name: feiguazhitou-mcp-cli
+description: Install, configure, refresh, diagnose, and safely use the local Feiguazhitou MCP through its dynamic CLI.
+argument_hint: Feiguazhitou client status, MCP endpoint, or the CLI issue to troubleshoot
+metadata:
+  pre_input: Describe the Feiguazhitou client status, MCP endpoint, or the CLI issue to troubleshoot:
+apply: available
+---
+
+# Feiguazhitou MCP CLI Setup and Connection
+
+This Skill is based on the Feiguazhitou MCP service guide. The service runs only on the same computer as the Feiguazhitou desktop client.
+It covers installation, connection, refresh, and troubleshooting. Do not assume or hard-code MCP tools; use the current local tool catalog.
+
+## Mandatory Transport Boundary
+
+Agents, scripts, and other callers **must not connect directly** to the local Feiguazhitou MCP endpoint or invoke tools through another MCP client. Use only canonical `feiguazhitou-mcp-cli` commands, especially `feiguazhitou-mcp-cli run COMMAND ...`. The CLI connects to MCP internally; this restriction applies to callers, not to the CLI's own MCP connection.
+
+## Prerequisites
+
+1. Start the Feiguazhitou client and verify its MCP address and port in client settings.
+2. Sign in to Compass for the target live account and keep its monitor online.
+3. Run the CLI on the same computer as the client. The service normally listens on `127.0.0.1`, so it is not reachable from another computer.
+
+## Installation and First Connection
+
+Install the npm package and use the endpoint shown in client settings. The usual default is `http://127.0.0.1:19528/mcp`, but the user may change the port:
+
+```bash
+npm install --global feiguazhitou-mcp-cli
+
+export FEIGUAZHITOU_CLI_MCP_URL="http://127.0.0.1:19528/mcp"
+export FEIGUAZHITOU_CLI_API_KEY="<only-when-your-client-requires-it>"
+
+feiguazhitou-mcp-cli refresh
+feiguazhitou-mcp-cli doctor --output text
+feiguazhitou-mcp-cli describe --output json
+feiguazhitou-mcp-cli tools list --output json
+```
+
+By default, `FEIGUAZHITOU_CLI_API_KEY` is used only in the process environment. When a user sends a standard `mcpServers` JSON document in a conversation, the CLI does **not** read or parse the complete JSON document. This Skill tells the Agent to understand it and call the CLI one setting at a time. The Agent first reads `feiguazhitou-mcp-cli describe --output json`, then applies fields supported by the current CLI for the user-selected server. When several servers exist and the target is unclear, ask instead of guessing.
+
+For a currently usable endpoint, the Agent runs `feiguazhitou-mcp-cli config set endpoint URL`. For every Header in the selected server, unless the user opted out, it runs `feiguazhitou-mcp-cli config set header HEADER --value-stdin` and supplies the value only through standard input, never in a command-line argument. The command saves one Header in a local unencrypted credential file; systems with POSIX permissions restrict it to the current user, and the Agent must tell the user. Actual Header values never enter ordinary config, this Skill, a tool catalog, a generated bundle, or command output. When the user opts out, for each Header run `config unset header HEADER`, then `config set header-env HEADER ENV_VAR`; the actual value exists only in the environment of later CLI processes. Do not put tokens, cookies, account data, or Header values in project config, this Skill, or command examples.
+
+When the user configuration includes `autoApprove`, the Agent must place its raw JSON array in `FEIGUAZHITOU_CLI_AUTO_APPROVE` for later CLI processes. It is client-side catalog metadata, never an HTTP Header sent to MCP, and it does not replace explicit authorization for unfamiliar or high-impact actions. Additional or future fields are reference information, not errors: this Skill is not a field allowlist. An Agent maps them only when the current `describe` defines a corresponding CLI setting or environment variable; it must not invent mappings, discard fields, or directly connect to the configuration URL. After individual configuration, the Agent explicitly runs `feiguazhitou-mcp-cli refresh --output json`, then reads `tools list`, `tools show`, and uses `run`.
+
+Set `FEIGUAZHITOU_CLI_LANG=en` when English launcher output is wanted. MCP tool descriptions, schemas, parameters, and returned business data remain unchanged.
+
+## Dynamic Tool Discovery
+
+Use the stable launcher protocol. Do not guess top-level dynamic commands. Read the local contract and catalog first:
+
+```bash
+feiguazhitou-mcp-cli describe --output json
+feiguazhitou-mcp-cli tools list --output json
+```
+
+If `tools list` returns `ARTIFACT_MISSING`, or an explicit live schema check is needed, run:
+
+```bash
+feiguazhitou-mcp-cli refresh --output json
+feiguazhitou-mcp-cli tools list --output json
+```
+
+Run `refresh` whenever the service adds, removes, or changes a tool. When the local catalog has not been checked for over 7 days, `tools list` and `tools show` suggest `tools list --refresh`, but never connect automatically. Use `refresh --force` after a schema or HTTP header-name change. After changing `FEIGUAZHITOU_CLI_MCP_TIMEOUT` or `config set timeout`, the next `run` uses the new timeout without refresh. Do not manually edit a generated CLI bundle in the local data directory; the next refresh replaces it.
+
+Before calling a tool, read its current schema. `NAME` can be a raw underscore-separated MCP tool name or a hyphenated CLI command name:
+
+```bash
+feiguazhitou-mcp-cli tools show NAME --output json
+```
+
+## Invocation Rules
+
+- Use the canonical form: `feiguazhitou-mcp-cli run COMMAND ...`.
+- Use the local Feiguazhitou MCP as a single session. Do not run `run`, `refresh`, or `doctor` concurrently; wait for each MCP-connecting command to finish before starting the next one. The CLI does not queue concurrent calls automatically.
+- Prefer `--raw '<json>' --output json` for objects, arrays, and optional-parameter combinations. For complex JSON, use `--raw @INPUT.json` to read a file, or `cat INPUT.json | feiguazhitou-mcp-cli run COMMAND --raw - --output json` to read standard input. When generated-command `--help` exposes scalar flags, Chinese and space-containing values work with normal shell quoting; `--raw` is not a workaround for Chinese parameters.
+- Output preserves the MCP response container and fields. Amounts, counts, and ratios may be raw numbers, strings, or `{ "unit", "value" }`; inspect the current response before converting or aggregating them.
+- For dependent workflows, read each preceding response before creating the next `--raw` input. Do not guess identifiers, page numbers, or time ranges.
+- `run` does not implicitly connect for schema discovery or refresh. On `ARTIFACT_MISSING`, `ARTIFACT_REFRESH_REQUIRED`, or `TOOL_NOT_FOUND`, read the JSON error remediation and then run the requested `refresh` or `tools list` action.
+- When MCP standard `isError: true`, Feiguazhitou `ok: false`, or non-zero `BaseResp.StatusCode` signals a failed call, the CLI preserves the MCP output and exits with code `1`. Scripts and Agents should check the exit code first.
+- If a generated command fails before it produces an MCP response, such as a timeout, a call with `--output json` returns `COMMAND_FAILED`; the raw error text is in `error.details.stderr`. The CLI does not retry the call.
+
+## Troubleshooting
+
+| Symptom | Action |
+| --- | --- |
+| Connection failure or no tools | Confirm that the client is running and its port matches settings, then run `doctor`. |
+| A remote computer cannot connect | This is a local loopback service. Run the CLI on the same computer as the Feiguazhitou client. |
+| A data tool reports no account or monitor | Check Compass sign-in and monitor state. This is a data-source prerequisite, not a CLI schema failure. |
+| Request timeout | The CLI does not retry. When a timeout occurs before an MCP response, `--output json` returns `COMMAND_FAILED` and preserves the raw timeout text in `error.details.stderr`. Check client and monitor state. The default is 90000ms; use `config set timeout MILLISECONDS` when a different limit is needed, and it takes effect on the next `run`. |
+| A new tool or parameter is absent | Run `refresh`, or `refresh --force` when required, then inspect the latest `tools list` and `tools show`. |
+
+## Safety Boundaries
+
+- `describe`, `tools list`, `tools show`, and `run` do not write live-account, order, or query results to project configuration or generated artifacts.
+- Unless the user opted out, the Agent saves each Header credential with `config set header HEADER --value-stdin`; that local file is unencrypted and the CLI reports this to the user. When the user opts out, the Agent uses `config unset header` and `config set header-env`.
+- Query data only from a user-approved local client and target account.
+- Future schemas may include high-impact operations. Read help and parameters first, and obtain explicit authorization before an action can change account state, publish content, delete data, or trigger external effects.

package/skills/feiguazhitou-mcp-cli/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: feiguazhitou-mcp-cli
+description: 使用飞瓜智投本机 MCP 的动态 CLI 完成安装、配置、刷新、诊断与排障。适用于飞瓜智投客户端的 MCP 端点连接、本机鉴权、端口变更、工具 schema 更新或调用失败的场景。
+argument_hint: 飞瓜智投客户端状态、端点或要排查的 CLI 问题
+metadata:
+  pre_input: 请说明飞瓜智投客户端状态、MCP 端点或需要排查的 CLI 问题：
+apply: available
+---
+
+# 飞瓜智投 MCP CLI 安装与连接
+
+本 Skill 来源于飞瓜智投 MCP 服务使用指南，服务仅运行在启动飞瓜智投客户端的本机。
+它只指导安装、连接、刷新和排障；不要假设或写死可用的 MCP tool，工具列表以当前
+本地 tool catalog 为准。
+
+## 强制调用边界
+
+Agent、脚本和其他调用方**不得直接连接**飞瓜智投本机 MCP endpoint，也不得通过其他 MCP client
+调用 tool。只能使用 `feiguazhitou-mcp-cli` 的规范命令，尤其是
+`feiguazhitou-mcp-cli run COMMAND ...`。CLI 会在内部连接 MCP；此约束仅限制调用方，不影响 CLI
+自身的 MCP 连接。
+
+## 前置检查
+
+1. 飞瓜智投客户端已启动，并在客户端设置中确认 MCP 服务地址和端口。
+2. 目标直播号已在客户端完成罗盘登录，且监视器在线。
+3. CLI 与飞瓜智投客户端运行在同一台电脑。服务通常只监听 `127.0.0.1`，不能把本机
+   endpoint 当作可从其他机器访问的地址。
+
+## 安装与首次连接
+
+安装 npm 包后，使用客户端设置页显示的 endpoint。默认值通常为
+`http://127.0.0.1:19528/mcp`，但端口可能被用户修改：
+
+```bash
+npm install --global feiguazhitou-mcp-cli
+
+export FEIGUAZHITOU_CLI_MCP_URL="http://127.0.0.1:19528/mcp"
+export FEIGUAZHITOU_CLI_API_KEY="<only-when-your-client-requires-it>"
+
+feiguazhitou-mcp-cli refresh
+feiguazhitou-mcp-cli doctor --output text
+feiguazhitou-mcp-cli describe --output json
+feiguazhitou-mcp-cli tools list --output json
+```
+
+默认情况下，`FEIGUAZHITOU_CLI_API_KEY` 只在环境变量中使用。当用户在对话中直接发送标准
+`mcpServers` JSON 时，CLI **不会**读取或解析整份 JSON；Skill 只指导 Agent 自己理解配置，并逐项调用
+CLI。Agent 先读取 `feiguazhitou-mcp-cli describe --output json`，根据用户指定的 server 和当前 CLI 契约处理
+可映射字段；多个 server 而目标不清楚时先询问，不能猜测。
+
+对当前可用 endpoint，Agent 执行 `feiguazhitou-mcp-cli config set endpoint URL`。对所选 server 中的每个
+Header，用户未要求不保存时，Agent 默认执行 `feiguazhitou-mcp-cli config set header HEADER --value-stdin`，并只用
+标准输入提供该 Header 值，绝不把值放进命令行参数。该命令把单个 Header 保存到本机未加密凭据文件；支持 POSIX
+权限的系统会限制为当前用户读写，Agent 必须告知用户。实际 Header 值不会进入普通配置、Skill、tool catalog、
+生成 bundle 或命令输出。用户要求不保存时，Agent 对每个 Header 执行 `config unset header HEADER`，再执行
+`config set header-env HEADER ENV_VAR`；实际值只在后续 CLI 进程的环境变量中提供。不要把 Token、Cookie、账号
+数据或 Header 值写入项目配置、Skill 或命令示例。
+
+若用户配置含 `autoApprove`，Agent 必须把其中的原始 JSON 数组设置为后续 CLI 进程的
+`FEIGUAZHITOU_CLI_AUTO_APPROVE`。它是客户端侧目录标记，不会作为 HTTP Header 发往 MCP，也不替代对未知或
+高影响操作的明确授权。额外或未来新增字段是参考信息，不是错误：本 Skill 不是字段白名单，Agent 只能在当前
+`describe` 已定义对应 CLI 配置或环境变量时映射，不能自行臆造映射、删除字段或直连配置中的 URL。逐项配置后，
+Agent 显式运行 `feiguazhitou-mcp-cli refresh --output json`，再读取 `tools list`、`tools show` 并使用 `run`。
+
+launcher 文案默认输出中文。需要英文时设置 `FEIGUAZHITOU_CLI_LANG=en`；MCP 的 tool 描述、schema、
+参数和业务数据不会被翻译或改写。
+
+`FEIGUAZHITOU_CLI_AUTO_APPROVE` 接受 MCP 原始 tool 名或生成 command 名组成的 JSON 数组；`tools list` 和
+`tools show` 会为匹配项标出 `autoApproved: true`。
+
+## 动态工具发现
+
+使用稳定 launcher 协议，不要猜测顶层动态命令。先读取本地契约和 catalog：
+
+```bash
+feiguazhitou-mcp-cli describe --output json
+feiguazhitou-mcp-cli tools list --output json
+```
+
+如果 `tools list` 返回 `ARTIFACT_MISSING`，或明确需要读取服务的最新 schema，再执行：
+
+```bash
+feiguazhitou-mcp-cli refresh --output json
+feiguazhitou-mcp-cli tools list --output json
+```
+
+服务新增、下线或调整 tool 后也执行 `refresh`。若本地目录超过 7 天未检查，`tools list` 和
+`tools show` 会提示执行 `tools list --refresh`，但不会自动联网。若 schema 或 HTTP Header 名称变更，执行
+`refresh --force`。修改 `FEIGUAZHITOU_CLI_MCP_TIMEOUT` 或 `config set timeout` 后，下一次 `run` 会直接使用
+新超时，不需要 refresh。不要手动修改本地数据目录下生成的 CLI bundle；该产物会在下次 refresh 时被替换。
+
+调用某个工具前，读取它的实时 schema。`NAME` 可为 MCP 原始 tool 名（下划线）或 CLI command
+名（连字符）：
+
+```bash
+feiguazhitou-mcp-cli tools show NAME --output json
+```
+
+## 调用约定
+
+- 使用 canonical 调用：`feiguazhitou-mcp-cli run COMMAND ...`。
+- 飞瓜本机 MCP 按单会话使用。不要并发执行 `run`、`refresh` 或 `doctor`；必须等待上一条会连接 MCP 的命令完全结束后，再执行下一条。CLI 不会自动排队。
+- 对对象、数组或可选参数组合，优先使用 `--raw '<json>' --output json`。复杂 JSON 可使用 `--raw @INPUT.json` 从文件读取，或用 `cat INPUT.json | feiguazhitou-mcp-cli run COMMAND --raw - --output json` 从标准输入读取。若生成 command 的 `--help` 暴露标量 flag，中文和带空格的值可按正常 shell 引号规则直接传入；`--raw` 不是中文参数的绕过方式。
+- 输出保留 MCP 服务的原始 JSON 容器和字段。金额、计数和比例可能是原始数值、文本，或
+  `{ "unit", "value" }` 结构；先读取当前返回结构，再做换算或汇总。
+- 对依赖前一步结果的工作流，先读取上一步返回值，再构造下一次 `--raw` 参数；不要猜测
+  标识符、页面号或时间范围。
+- `run` 不会自动联网或刷新。若返回 `ARTIFACT_MISSING`、`ARTIFACT_REFRESH_REQUIRED` 或
+  `TOOL_NOT_FOUND`，读取 JSON 错误里的 remediation 后执行相应的 `refresh` 或 `tools list`。
+- MCP 标准 `isError: true`、飞瓜业务响应 `ok: false` 或非零 `BaseResp.StatusCode` 表示调用失败时，CLI 保持 MCP 输出不变并以退出码 `1` 结束。脚本和 Agent 应优先检查退出码。
+- 若生成命令在产生 MCP 响应前失败（例如超时），带 `--output json` 的调用会返回 `COMMAND_FAILED`；原始错误文本位于 `error.details.stderr`。CLI 不重试该调用。
+
+## 常见排障
+
+| 现象 | 处理 |
+| --- | --- |
+| 连接失败或工具为空 | 确认客户端正在运行、端口与设置页一致，然后运行 `doctor`。 |
+| 远程机器无法连接 | 这是本机回环服务，应在运行飞瓜智投客户端的同一台机器执行 CLI。 |
+| 数据工具报无账号或监视器错误 | 检查罗盘登录和监视器在线状态；这是数据源前置条件，不是 CLI schema 错误。 |
+| 请求超时 | CLI 不重试。若超时前没有 MCP 输出，`--output json` 返回 `COMMAND_FAILED`，原始超时文本在 `error.details.stderr`；检查客户端和监视器状态。默认 90000ms；需要不同等待上限时使用 `config set timeout MILLISECONDS`，新值在下一次 `run` 生效。 |
+| 新工具或参数未出现 | 运行 `refresh`，必要时使用 `refresh --force`，再读取最新 `tools list` 和 `tools show`。 |
+
+## 安全边界
+
+- `describe`、`tools list`、`tools show` 与 `run` 不会把直播账号、订单或查询结果写入项目配置或 artifact。
+- 用户未选择不保存时，Agent 通过 `config set header HEADER --value-stdin` 逐个保存 Header 凭据；该文件未加密，CLI 会在输出中告知用户。用户要求不保存时，Agent 使用 `config unset header` 与 `config set header-env`。
+- 只在用户确认的本地客户端和目标账号上运行数据查询。
+- 未来 schema 可能引入高影响操作。遇到不熟悉的生成命令时，先阅读 help 和参数说明，
+  并在执行会改变账号、发布内容、删除数据或触发外部动作的命令前取得明确授权。

package/skills/feiguazhitou-mcp-cli/skill.en.json

@@ -0,0 +1,39 @@
+{
+  "protocol": "feiguazhitou-mcp-cli.skills/v1",
+  "protocolVersion": 1,
+  "skillVersion": "1.6.0",
+  "name": "feiguazhitou-mcp-cli",
+  "description": "Install, configure, refresh, diagnose, and safely use the dynamically generated Feiguazhitou MCP CLI.",
+  "argumentHint": "Feiguazhitou client status, MCP endpoint, or the CLI issue to troubleshoot",
+  "apply": "available",
+  "entrypoint": "SKILL.en.md",
+  "capabilities": [
+    "local-mcp-installation",
+    "streamable-http-configuration",
+    "runtime-schema-refresh",
+    "agent-cli-bootstrap",
+    "local-tool-catalog",
+    "canonical-tool-execution",
+    "runtime-approval-policy",
+    "credential-environment-setup",
+    "granular-cli-configuration",
+    "secure-header-stdin-configuration",
+    "agent-standard-mcp-config-interpretation",
+    "connection-troubleshooting",
+    "complex-raw-input",
+    "structured-failure-exit"
+  ],
+  "requirements": {
+    "command": "feiguazhitou-mcp-cli",
+    "runtimeEnvironment": [],
+    "optionalRuntimeEnvironment": [
+      "FEIGUAZHITOU_CLI_MCP_URL",
+      "FEIGUAZHITOU_CLI_API_KEY",
+      "FEIGUAZHITOU_CLI_MCP_HEADERS",
+      "FEIGUAZHITOU_CLI_AUTO_APPROVE",
+      "FEIGUAZHITOU_CLI_MCP_TIMEOUT",
+      "FEIGUAZHITOU_CLI_DATA_DIR",
+      "FEIGUAZHITOU_CLI_LANG"
+    ]
+  }
+}