@zenaigc/zenmcp 0.1.6 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/INSTALL.md CHANGED
@@ -4,16 +4,17 @@
4
4
 
5
5
  ## 交互要求
6
6
 
7
- - 向用户展示五步清单并随完成情况更新:环境检查 → 安装 → 平台 Key → 客户端配置 → 验证(完成项标记为已完成)。
7
+ - 向用户展示五步清单并随完成情况更新:环境检查 → 安装 → 客户端配置 → 绑定平台 Key → 验证(完成项标记为已完成)。
8
8
  - 缺失依赖只合并询问一次,列出所有缺项,提供「全部安装 / 我自行安装」两个选项;使用客户端提供的选项式提问工具(如有)。
9
- - 将 `zenmcp-doctor` 输出整理成「通过 / 缺失」清单,不直接展示原始 JSON;配置变量状态只说明是否配置,不展示值。
10
- - Key 不进入聊天:可以先写带占位符的配置并告知用户粘贴位置,给用户在自己终端运行的命令,或使用客户端 MCP 表单;不得要求用户把 Key 发给 Agent。
9
+ - 将 `zenmcp-doctor` 输出整理成「通过 / 缺失」清单,不直接展示原始 JSON;配置状态(`ZENMCP_BASE_URL`、`ZENMCP_TOKEN`、`credentials_file`)只说明是否配置,不展示值或路径。
10
+ - 客户端 MCP 配置默认使用不含密钥的 `{"command": "zenmcp"}`,Agent 可直接代写并保留其他已有 MCP 服务。Key 不进入聊天:引导用户在运行 `zenmcp` 的机器终端自行执行 `zenmcp login`(隐藏输入,支持本机与远程 SSH)或桌面运行 `zenmcp-setup` 粘贴保存;不得要求用户把 Key 发给 Agent。
11
11
  - `account_status` 成功后原样展示其「可以这样说」欢迎块;有效可用积分为 0 时,引导前往 https://api.zenaigc.com 充值或调整 Key 限额。
12
12
 
13
13
  | 异常 | 下一步 |
14
14
  | --- | --- |
15
- | 命令找不到 | 按第 5 步改用命令或 Node 的绝对路径;Windows 先检查 `zenmcp.cmd`。 |
16
- | `token_missing` / `invalid_credential` | 按第 4–5 步在账户页创建 Key,填入客户端配置 `env.ZENMCP_TOKEN` 后重新加载;不要在聊天中粘贴。 |
15
+ | 命令找不到 | 按第 4 步改用命令或 Node 的绝对路径;Windows 先检查 `zenmcp.cmd`。 |
16
+ | `token_missing` | 按第 5 步在账户页创建 Key,请用户在终端运行 `zenmcp login`(或桌面运行 `zenmcp-setup`)保存,无需重启客户端即可重试 `account_status`;不要在聊天中粘贴。 |
17
+ | `invalid_credential` | 查看报错提示的凭据来源:若来自本机凭据文件,运行 `zenmcp login` 重新保存即刻生效;若来自 `env.ZENMCP_TOKEN`(优先于凭据文件),请移除或更新客户端配置中的 `env.ZENMCP_TOKEN` 后重新加载客户端。 |
17
18
  | 网络失败 | 检查网络连接及客户端能否访问 https://api.zenaigc.com,恢复后重试只读账户查询。 |
18
19
 
19
20
  ## 1. 检查本机环境
@@ -40,38 +41,29 @@ npm install -g @zenaigc/zenmcp
40
41
  zenmcp-doctor
41
42
  ```
42
43
 
43
- 确认输出 `"ok": true`,否则按检查结果修复环境再运行。此时在终端直接运行,`config` 中 `ZENMCP_BASE_URL` 与 `ZENMCP_TOKEN` 两项显示为 `false` 是正常的;这两项只表示当前进程是否配置环境变量,不影响本机自检结果,也不验证平台 Key 或服务器连通性。
44
+ 确认输出 `"ok": true`,否则按检查结果修复环境再运行。未绑定 Key 前,`config` 中 `ZENMCP_BASE_URL`、`ZENMCP_TOKEN` 与 `credentials_file` 显示为 `false` 是正常的;它们只表示是否存在对应配置,不影响本机自检结果,也不验证服务器连通性。
44
45
 
45
- ## 4. 获取平台 Key
46
+ ## 4. 配置 MCP 客户端(无密钥配置,首次配置后重载一次)
46
47
 
47
- 引导用户登录 ZenAIGC 官网 https://zenaigc.com 获取平台 Key。**官网域名切换前请使用 https://api.zenaigc.com 登录获取**。
48
-
49
- Key 不得在对话中回显明文。由用户自行粘贴进配置,或由 Agent 写入配置文件但不回显;不要把真实 Key 放入命令记录或日志。
50
-
51
- ## 5. 配置 MCP 客户端
52
-
53
- 通用配置块如下,将 `<平台Key>` 替换为用户的平台 Key:
48
+ 默认配置块不含任何密钥,Agent 可直接合并写入,保留客户端已有的其他 MCP 服务:
54
49
 
55
50
  ```json
56
51
  {
57
52
  "mcpServers": {
58
53
  "zenmcp": {
59
- "command": "zenmcp",
60
- "env": {
61
- "ZENMCP_TOKEN": "<平台Key>"
62
- }
54
+ "command": "zenmcp"
63
55
  }
64
56
  }
65
57
  }
66
58
  ```
67
59
 
68
- 无需配置 `ZENMCP_BASE_URL`,已内置默认地址 `https://api.zenaigc.com/api/v1`。编辑已有配置时合并 `zenmcp` 项,保留其他 MCP 服务。
60
+ 无需配置 `ZENMCP_BASE_URL`,已内置默认地址 `https://api.zenaigc.com/api/v1`。
69
61
 
70
- - **WorkBuddy**:写入 `~/.workbuddy/mcp.json`,或在客户端 MCP 设置中添加上述配置块。
71
- - **豆包电脑版**:左侧「技能·连接器」→ 添加 MCP,填入上述配置块,或命令填 `zenmcp`、环境变量填 `ZENMCP_TOKEN`。
72
62
  - **SuperOne**:在其 MCP 设置中添加上述配置块。
73
- - **Claude Code**:命令格式为 `claude mcp add zenmcp -s user -e ZENMCP_TOKEN=<Key> -- zenmcp`;不要在对话中回显真实 Key,避免将含真实 Key 的命令保存在历史或日志中。
74
- - **Claude Desktop**:在 `claude_desktop_config.json` 中添加上述配置块。
63
+ - **Claude Code**:运行 `claude mcp add zenmcp -s user -- zenmcp`。
64
+ - **WorkBuddy**:写入 `~/.workbuddy/mcp.json`,或在客户端 MCP 设置中添加上述配置块。
65
+ - **豆包电脑版**:左侧「技能·连接器」→ 添加 MCP,填入上述配置块,或命令填 `zenmcp`。
66
+ - **Claude Desktop**:在 `claude_desktop_config.json` 中合并添加上述配置块。
75
67
 
76
68
  命令查找失败时按以下顺序处理:
77
69
 
@@ -79,12 +71,36 @@ Key 不得在对话中回显明文。由用户自行粘贴进配置,或由 Age
79
71
  - GUI 客户端找不到命令时,`command` 改用 `command -v zenmcp`(Windows 用 `where zenmcp`)得到的绝对路径。
80
72
  - 如果仍然报 `node` 找不到,`command` 填 `node` 的绝对路径,`args` 填 `["<npm root -g>/@zenaigc/zenmcp/dist/src/mcp/server.js"]`;将 `<npm root -g>` 替换为运行 `npm root -g` 得到的真实目录。
81
73
 
74
+ 首次写完客户端配置后,重载或重启一次客户端使 `zenmcp` 工具挂载生效。
75
+
76
+ ## 5. 获取并绑定平台 Key(一次保存,全机共用,免重启生效)
77
+
78
+ 引导用户登录 ZenAIGC 官网 https://zenaigc.com 获取平台 Key。**官网域名切换前请使用 https://api.zenaigc.com 登录获取**。
79
+
80
+ Key 不得在对话中回显明文,也不要通过命令行参数传入。请用户在运行 `zenmcp` 的机器上选择任一方式完成连接:
81
+
82
+ - **终端隐藏输入(通用推荐,支持本机与远程 SSH 服务器)**:在终端运行以下命令,按提示粘贴平台 Key(输入不回显):
83
+
84
+ ```bash
85
+ zenmcp login
86
+ ```
87
+
88
+ - **本机网页卡片(适合图形桌面环境)**:在本机终端运行以下命令,在自动打开的 `127.0.0.1` 页面粘贴验证(连接完成后临时端口自动关闭):
89
+
90
+ ```bash
91
+ zenmcp-setup
92
+ ```
93
+
94
+ 验证通过后,凭据以用户私有权限保存在本机安全凭据库(macOS / Linux 为 `~/.config/zenmcp/credentials.json` 权限 `0600`;Windows 为 `%APPDATA%\zenmcp\credentials.json`),同机所有客户端自动共用,且**无需重启客户端即可立即生效**。如需清除已保存凭据可运行 `zenmcp logout`。
95
+
96
+ 如需按单个客户端单独指定 Key,也兼容在客户端配置块中加入 `"env": { "ZENMCP_TOKEN": "<平台Key>" }` 并重载客户端(注意:`env.ZENMCP_TOKEN` 优先级高于本机凭据文件;若该环境变量中的旧 Key 已失效,需先将其移除或更新并重载客户端)。
97
+
82
98
  ## 6. 安装 Skill
83
99
 
84
- 从 `$(npm root -g)/@zenaigc/zenmcp/skills/zenmcp/SKILL.md` 复制到客户端的 skills 目录,例如 `~/.agents/skills/zenmcp/SKILL.md`;Claude Code 为 `~/.claude/skills/zenmcp/SKILL.md`。先创建目标目录。Windows 上使用 `npm root -g` 的输出定位源文件,再复制到对应目录。
100
+ 从 `$(npm root -g)/@zenaigc/zenmcp/skills/zenmcp` 整个目录复制到客户端的 skills 目录,例如 `~/.agents/skills/zenmcp`(包含 `SKILL.md` 及 `widgets/` 交互卡片模板);Claude Code 为 `~/.claude/skills/zenmcp`。若使用 SuperOne 桌面端,可同时将 `skills/zenmcp/widgets/zenmcp-*` 复制到 `~/.superone/widget/`(alpha 版为 `~/.superone/alpha/widget/`)。先创建目标目录。Windows 上使用 `npm root -g` 的输出定位源目录,再复制到对应目录。
85
101
 
86
102
  客户端不支持 skills 时跳过这一步。
87
103
 
88
104
  ## 7. 验证连通性
89
105
 
90
- 重启客户端或重载 MCP,调用只读工具 `account_status`;返回积分信息即为连通。若提示 Key 未配置,检查客户端 MCP 环境变量后重载,排查时不要回显 Key。
106
+ 直接调用只读工具 `account_status`;返回积分信息与凭据来源即为连通。排查时不要回显任何 Key。
@@ -2,6 +2,7 @@
2
2
  import { realpath } from 'node:fs/promises';
3
3
  import { pathToFileURL } from 'node:url';
4
4
  import { checkEffectsRuntime } from './effects/index.js';
5
+ import { hasSavedCredential } from './setup/credentials.js';
5
6
  /** Local readiness only: configuration values and server connectivity stay private. */
6
7
  export async function checkEnvironment(env = process.env) {
7
8
  const checks = [
@@ -9,8 +10,13 @@ export async function checkEnvironment(env = process.env) {
9
10
  ...await checkEffectsRuntime(),
10
11
  ];
11
12
  return {
12
- ok: checks.every(check => check.ok), checks,
13
- config: { ZENMCP_BASE_URL: Boolean(env.ZENMCP_BASE_URL), ZENMCP_TOKEN: Boolean(env.ZENMCP_TOKEN) },
13
+ ok: checks.every(check => check.ok),
14
+ checks,
15
+ config: {
16
+ ZENMCP_BASE_URL: Boolean(env.ZENMCP_BASE_URL),
17
+ ZENMCP_TOKEN: Boolean(env.ZENMCP_TOKEN),
18
+ credentials_file: await hasSavedCredential({ env }),
19
+ },
14
20
  };
15
21
  }
16
22
  const entry = process.argv[1] ? await realpath(process.argv[1]).catch(() => process.argv[1]) : '';
@@ -4,7 +4,7 @@ export const POLL_AFTER_SECONDS = 15;
4
4
  // 展示阈值暂定,仅提醒,不参与预算或执行判断。
5
5
  export const LARGE_AMOUNT_CREDITS = 100;
6
6
  export const LARGE_BALANCE_RATIO = 0.3;
7
- const keySetup = `请引导用户前往 ${ACCOUNT_URL} 创建平台 Key,填入 MCP 客户端配置 env.ZENMCP_TOKEN 后重新加载客户端;不要让用户在聊天中粘贴 Key。`;
7
+ const keySetup = `请引导用户前往 ${ACCOUNT_URL} 创建平台 Key,在终端运行 zenmcp login(或桌面环境运行 zenmcp-setup)粘贴保存即可立即生效,也可填入 MCP 客户端配置 env.ZENMCP_TOKEN 后重新加载客户端;不要让用户在聊天中粘贴 Key。`;
8
8
  const sameDirectory = '请保留当前目录与原账户,等待后在同一目录继续调用 get_generation 或 get_job 查询扣费及任务状态。';
9
9
  export const ERROR_GUIDANCE = {
10
10
  token_missing: { message: '尚未配置平台 Key。', next: keySetup },
@@ -22,7 +22,7 @@ export const ERROR_GUIDANCE = {
22
22
  invalid_request: { message: '请求内容不符合要求。', next: '请对照工具参数及 list_models 返回的目录修正输入。' },
23
23
  validation_error: { message: '请求参数校验未通过。', next: '请对照工具参数及 list_models 返回的目录修正输入。' },
24
24
  account_mismatch: { message: '当前账户与任务绑定账户不一致。', next: sameDirectory },
25
- access_denied: { message: '当前平台 Key 没有此操作权限。', next: '请用户检查 MCP 配置中的平台 Key 权限后重新加载客户端。' },
25
+ access_denied: { message: '当前平台 Key 没有此操作权限。', next: '请用户检查平台 Key 权限后运行 zenmcp login 更新,或检查 MCP 配置中的 env.ZENMCP_TOKEN 后重新加载客户端。' },
26
26
  capability_not_available: { message: '所选生成能力当前不可用。', next: '请免费调用 list_models,选择当前可用能力。' },
27
27
  asset_not_found: { message: '云端素材不存在或已过期。', next: '请在原目录核对素材及任务状态。' },
28
28
  generation_not_found: { message: '暂未查到生成任务,扣费结果仍需核实。', next: sameDirectory },
@@ -59,7 +59,7 @@ export const ERROR_GUIDANCE = {
59
59
  input_too_large: { message: '输入文件大小超过模型限制。', next: '请压缩素材至 list_models 标注的大小限制内。' },
60
60
  invalid_input: { message: '输入不是有效的媒体文件。', next: '请核对本地文件可读且媒体内容完整。' },
61
61
  asset_not_ready: { message: '上传素材尚未处理完成。', next: '请稍后在原目录查询或继续原报价步骤。' },
62
- token_in_input: { message: '输入中含有平台 Key 或其他凭据,已阻止发送。', next: '请从提示词和参数中移除凭据;平台 Key 仅放在 MCP 客户端配置 env.ZENMCP_TOKEN 中。' },
62
+ token_in_input: { message: '输入中含有平台 Key 或其他凭据,已阻止发送。', next: '请从提示词和参数中移除凭据;平台 Key 仅通过 zenmcp login 保存或放在 MCP 客户端配置 env.ZENMCP_TOKEN 中。' },
63
63
  prior_payment_unresolved: { message: '已有付款尚未核实。', next: sameDirectory },
64
64
  payment_mismatch: { message: '付款记录与生成结果不一致。', next: sameDirectory },
65
65
  refund_pending: { message: '退款或积分释放尚未确认。', next: sameDirectory },
@@ -5,7 +5,8 @@ import { GatewayError, redact } from '../gateway/errors.js';
5
5
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
6
6
  import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
7
7
  import { z } from 'zod';
8
- import { basename } from 'node:path';
8
+ import { readFile } from 'node:fs/promises';
9
+ import { basename, join } from 'node:path';
9
10
  import { jobSchema, assetSchema } from '../core/index.js';
10
11
  import { CloudGateway, scrub } from '../gateway/index.js';
11
12
  import { PopTitleRenderer } from '../effects/index.js';
@@ -14,8 +15,9 @@ import { DirectGeneration } from '../engine/direct.js';
14
15
  import { SpeechTools, transcribeInputSchema, cloneInputSchema } from '../speech/tools.js';
15
16
  import { trimMedia } from '../acquire/trim.js';
16
17
  import { ACCOUNT_URL, ERROR_GUIDANCE, POLL_AFTER_SECONDS, LARGE_AMOUNT_CREDITS, LARGE_BALANCE_RATIO, errorGuidance } from './guidance.js';
18
+ import { createDefaultTokenProvider } from '../setup/credentials.js';
17
19
  export const DEFAULT_BASE_URL = 'https://api.zenaigc.com/api/v1';
18
- export const CLIENT_VERSION = '0.1.6';
20
+ export const CLIENT_VERSION = '0.1.7';
19
21
  const inputSchema = z.object({
20
22
  job: jobSchema, reference: z.string().min(1),
21
23
  output: z.object({ duration_seconds: z.number().int(), resolution: z.enum(['480P', '720P', '1080P']), ratio: z.string(), seed: z.number().int().optional() }),
@@ -67,7 +69,15 @@ export async function failure(error, tokens) {
67
69
  const known = Object.hasOwn(ERROR_GUIDANCE, code);
68
70
  const message = known ? redact(guidance.message, secret) : sanitized;
69
71
  const detail = known && !(error instanceof GatewayError) && code !== 'step_failed' && sanitized.startsWith(`${code}:`) ? `\n详情:${sanitized.slice(code.length + 1)}` : '';
70
- const next_action = redact(guidance.next, secret);
72
+ const credSource = (code === 'invalid_credential' || code === 'access_denied')
73
+ ? await tokens.source?.().catch(() => undefined)
74
+ : undefined;
75
+ const sourcePrefix = credSource === 'env'
76
+ ? '当前生效凭据来自客户端环境变量 env.ZENMCP_TOKEN(优先于本机凭据文件);若已通过 zenmcp login 更新 Key,请移除客户端配置中的 env.ZENMCP_TOKEN 后重新加载客户端。'
77
+ : credSource === 'file'
78
+ ? '当前生效凭据来自本机凭据文件;可运行 zenmcp login 重新粘贴新 Key,保存后免重启立即生效。'
79
+ : '';
80
+ const next_action = redact(`${sourcePrefix}${guidance.next}`, secret);
71
81
  return { isError: true, content: [{ type: 'text', text: `${known ? `${code}:${message}${detail}` : message}\n下一步:${next_action}` }], structuredContent: { code, message, next_action } };
72
82
  }
73
83
  const SERVER_INSTRUCTIONS = `Zenmcp tools are atomic. Combine them as follows.
@@ -98,7 +108,7 @@ const SERVER_INSTRUCTIONS = `Zenmcp tools are atomic. Combine them as follows.
98
108
  - 参数从用户需求与目录默认值填入,不逐项询问;报价前仅将没有默认值的必填缺项合并问一次,其余参数在确认卡中展示和修改。
99
109
  - 原样展示工具的 markdown 确认卡;每个付费步骤只发起一次合并确认。无本地文件时只确认积分卡;有本地文件时,先短问一次「将上传 N 个本地文件(文件名)到云端用于报价和生成,同意吗?」,获同意再报价,卡片的上传行只说明本次报价已上传的文件。
100
110
  - 仅当用户对当前任务明确给出免再问的总额上限时,可在该额度内执行;每次结果报告已花及剩余额度。retryAfterRelease、音色授权、价格变化后的重新报价及 large:true 的单项始终另需明确批准。
101
- - 平台 Key 仅写入 MCP 客户端配置 env.ZENMCP_TOKEN,绝不要求用户在聊天中提供 Key。若用户自行粘贴,不回显,写入客户端配置并建议立即在账户页撤销重建,因为原 Key 已留在聊天记录。
111
+ - 平台 Key 推荐请用户在终端运行 zenmcp login(或桌面环境运行 zenmcp-setup)写入本机安全凭据库,保存后无需重启立即生效;兼容写入 MCP 客户端配置 env.ZENMCP_TOKEN。绝不要求用户在聊天中提供 Key。若用户自行粘贴,不回显,引导立即在账户页撤销重建,因为原 Key 已留在聊天记录。
102
112
  - 提交后只向用户说明一次正在运行、稍后可查询;按 poll_after_seconds 在同一目录轮询,不逐次播报,避免重复提交。扣费状态待确认时保留同一目录续查。
103
113
  - 使用当前客户端提供的媒体展示能力展示输出;不支持时提供文件路径。`;
104
114
  /** Background tasks live in this MCP process; state and attempts survive its restart. */
@@ -129,10 +139,50 @@ export function createServer(engine, socialOptions = {}, speechOptions = {}) {
129
139
  const data = plan.result?.data;
130
140
  if (typeof data?.totalCredits !== 'number' || typeof data.retryReserveCredits !== 'number')
131
141
  return response(plan);
132
- return response({ ...plan, confirmation: { kind: 'budget', total_credits: data.totalCredits, retry_reserve_credits: data.retryReserveCredits },
133
- markdown: `${'markdown' in plan ? plan.markdown : ''}\n\n最多扣 ${data.totalCredits} 积分,其中 ${data.retryReserveCredits} 为重试预留,未重试不扣。回复「确认」开始执行。`,
134
- next_action: '原样展示计划与预算句并只确认一次;获用户批准后携带 approvedCredits 和 planDigest 调用 execute_job。',
135
- });
142
+ const [me, savedInput, secret] = await Promise.all([
143
+ engine.options.gateway.me().catch(() => null),
144
+ readFile(join(directory, 'input.json'), 'utf8').then(raw => JSON.parse(raw)).catch(() => null),
145
+ engine.tokens.token().catch(() => ''),
146
+ ]);
147
+ const jobObj = (savedInput?.job && typeof savedInput.job === 'object' ? savedInput.job : input?.job);
148
+ const segmentCount = Array.isArray(jobObj?.storyboard?.segments) ? jobObj.storyboard.segments.length : null;
149
+ const lineItems = Array.isArray(data.lineItems) ? data.lineItems : [];
150
+ const segments = lineItems
151
+ .filter(item => typeof item?.credits === 'number')
152
+ .map(item => ({
153
+ label: item.operation === 'generate'
154
+ ? (segmentCount ? `视频生成(共 ${segmentCount} 段)` : '视频生成')
155
+ : String(item.operation ?? '项目'),
156
+ credits: Number(item.credits),
157
+ }));
158
+ const roleLabels = { identity: '身份', motion_ref: '动作参考', product: '服装', scene: '场景', detail: '细节' };
159
+ const assets = Array.isArray(jobObj?.assets)
160
+ ? jobObj.assets.map(a => `${a.id ?? ''}(${roleLabels[a.role ?? ''] ?? a.role ?? ''})`)
161
+ : [];
162
+ const total = data.totalCredits;
163
+ const reserve = data.retryReserveCredits;
164
+ const balance = me?.credits_available ?? null;
165
+ const sufficient = me ? total <= effectiveAvailableCredits(me) : null;
166
+ const large = total >= LARGE_AMOUNT_CREDITS || (balance !== null && total > balance * LARGE_BALANCE_RATIO);
167
+ const confirmation = {
168
+ kind: 'budget',
169
+ total_credits: total,
170
+ retry_reserve_credits: reserve,
171
+ balance_before: balance,
172
+ balance_after: balance === null ? null : balance - total,
173
+ sufficient,
174
+ large,
175
+ segments,
176
+ assets,
177
+ };
178
+ const baseMarkdown = 'markdown' in plan ? plan.markdown : '';
179
+ const markdown = sufficient === false
180
+ ? `${baseMarkdown}\n\n最多扣 ${total} 积分,其中 ${reserve} 为重试预留,未重试不扣。\n当前有效可用积分不足(${effectiveAvailableCredits(me)} 积分),请前往 ${ACCOUNT_URL} 充值或调整平台 Key 限额后再查询额度。`
181
+ : `${baseMarkdown}\n\n最多扣 ${total} 积分,其中 ${reserve} 为重试预留,未重试不扣。回复「确认」开始执行。`;
182
+ const next_action = sufficient === false
183
+ ? `请展示计划与预算卡片并引导用户前往 ${ACCOUNT_URL} 补足额度后调用 account_status 核实;现在不要请求积分批准或调用 execute_job。`
184
+ : '原样展示计划与预算句并只确认一次;获用户批准后携带 approvedCredits 和 planDigest 调用 execute_job。';
185
+ return response(scrub({ ...plan, confirmation, markdown, next_action }, secret));
136
186
  });
137
187
  server.registerTool('execute_job', { description: '携带用户一次合并确认批准的积分上限(及可选的已确认计划摘要 planDigest),后台执行;按 poll_after_seconds 等待后在同一目录用 get_job 查询,勿重复提交。', inputSchema: { directory: z.string(), approvedCredits: z.number().int().nonnegative(), planDigest: z.string().min(1).optional() } }, async ({ directory, approvedCredits, planDigest }) => {
138
188
  if (active.has(directory))
@@ -153,8 +203,28 @@ export function createServer(engine, socialOptions = {}, speechOptions = {}) {
153
203
  const file = job.state.steps.report?.output?.data.path ?? job.state.steps.export?.output?.data.path;
154
204
  const running = job.state.status === 'running';
155
205
  const chargeHint = String(markdown).includes('扣费状态待确认') || String(markdown).includes('退款待确认') ? `\n\n${errorGuidance('outcome_unknown').next}` : '';
156
- const errorText = job.state.error ? `\n\n${(await failure(new Error(job.state.error), engine.tokens)).content[0].text}` : '';
206
+ const parsedFailure = job.state.error || job.state.status === 'failed'
207
+ ? await failure(new Error(job.state.error ?? 'step_failed'), engine.tokens)
208
+ : null;
209
+ const errorText = job.state.error && parsedFailure ? `\n\n${parsedFailure.content[0].text}` : '';
210
+ const result_summary = job.state.status === 'completed'
211
+ ? {
212
+ status: 'completed',
213
+ charged_credits: job.budget?.settled ?? null,
214
+ in_progress_credits: job.budget?.in_progress ?? 0,
215
+ output: typeof file === 'string' ? { file, kind: 'video' } : null,
216
+ suggestions: ['调整花字或混音(0 积分本地重跑)', '换随机种子重跑全片'],
217
+ }
218
+ : job.state.status === 'failed'
219
+ ? {
220
+ status: 'failed',
221
+ reason: parsedFailure.structuredContent.message,
222
+ settled_credits: job.budget?.settled ?? 0,
223
+ in_progress_credits: job.budget?.in_progress ?? 0,
224
+ }
225
+ : undefined;
157
226
  return response({ ...job, background, interrupted,
227
+ ...(result_summary ? { result_summary } : {}),
158
228
  ...(running ? { poll_after_seconds: POLL_AFTER_SECONDS } : {}),
159
229
  markdown: `${markdown}${errorText}${chargeHint}${running ? `\n\n${pollHint('get_job')}` : job.state.status === 'completed' && typeof file === 'string' ? `\n\n${outputHint(file)}` : ''}`,
160
230
  });
@@ -176,6 +246,14 @@ export function createServer(engine, socialOptions = {}, speechOptions = {}) {
176
246
  try {
177
247
  const secret = await engine.tokens.token().catch(() => '');
178
248
  const me = scrub(await engine.options.gateway.me(), secret);
249
+ const credInfo = await engine.tokens.inspect?.().catch(() => undefined);
250
+ const credSource = credInfo?.source ?? (await engine.tokens.source?.().catch(() => undefined)) ?? 'custom';
251
+ const envOverridesFile = Boolean(credInfo?.envOverridesFile);
252
+ const sourceLabel = credSource === 'file'
253
+ ? '本机安全凭据文件'
254
+ : credSource === 'env'
255
+ ? '客户端环境变量 env.ZENMCP_TOKEN'
256
+ : '自定义提供方';
179
257
  const effectiveAvailable = effectiveAvailableCredits(me);
180
258
  const note = me.daily_credit_limit === null
181
259
  ? '当前平台 Key 未设置日积分限额,建议在网站账户页为 Key 配置日限额以防超支。'
@@ -187,6 +265,8 @@ export function createServer(engine, socialOptions = {}, speechOptions = {}) {
187
265
  `- 今日已用 / 日限额:${me.used_today} / ${me.daily_credit_limit ?? '未设置'}`,
188
266
  `- 累计已用 / 总限额:${me.used_total} / ${me.total_credit_limit ?? '未设置'}`,
189
267
  `- 当前单次可支配上限:${effectiveAvailable}`,
268
+ `- 凭据来源:${sourceLabel}`,
269
+ ...(envOverridesFile ? ['- 注意:同时存在客户端环境变量 env.ZENMCP_TOKEN 与本机凭据文件,当前以 env.ZENMCP_TOKEN 为准。'] : []),
190
270
  `- 说明:${note}`,
191
271
  ...(effectiveAvailable === 0 ? [`- 当前可支配积分为 0,请前往 ${ACCOUNT_URL} 充值或调整平台 Key 限额。`] : []),
192
272
  `- 客户端版本:${CLIENT_VERSION}`,
@@ -200,6 +280,8 @@ export function createServer(engine, socialOptions = {}, speechOptions = {}) {
200
280
  used_total: me.used_total,
201
281
  effective_available_credits: effectiveAvailable,
202
282
  credential_kind: me.credential_kind,
283
+ credential_source: credSource,
284
+ env_overrides_file: envOverridesFile,
203
285
  client_version: CLIENT_VERSION,
204
286
  getting_started: GETTING_STARTED,
205
287
  note,
@@ -308,7 +390,7 @@ export function createServer(engine, socialOptions = {}, speechOptions = {}) {
308
390
  const prompts = [
309
391
  { name: 'generate_media', title: '生成图片或视频', text: '请帮我生成图片或视频:先 list_models,再 quote_generation 免费报价。本地素材上传前取得同意;一次性确认模型、关键参数、上传文件数及积分后,携带 requestDigest 调用 run_generation;按 poll_after_seconds 等待后在同一目录 get_generation,并展示输出。' },
310
392
  { name: 'replicate_video', title: '拆解二创短视频', text: '请拆解二创我提供的短视频:链接先 fetch_social_post,本地文件直接 analyze_reference;必要时选段并 trim_media。展示素材并确认最终属性后 import_assets,再 plan_job;一次合并确认模型、关键参数、上传文件数及积分后 execute_job,按 poll_after_seconds 在同一目录 get_job,展示输出。' },
311
- { name: 'check_setup', title: '检查安装与账户', text: `请检查 Zenmcp 安装和账户:环境异常时运行 zenmcp-doctor,随后 account_status 查询积分与客户端版本。缺少或无效的 Key 请引导用户前往 ${ACCOUNT_URL} 创建,写入 MCP 客户端配置 env.ZENMCP_TOKEN 后重新加载;绝不在聊天中索取 Key。` },
393
+ { name: 'check_setup', title: '检查安装与账户', text: `请检查 Zenmcp 安装和账户:环境异常时运行 zenmcp-doctor,随后 account_status 查询积分与客户端版本。缺少或无效的 Key 请引导用户前往 ${ACCOUNT_URL} 创建,在终端运行 zenmcp login(或桌面运行 zenmcp-setup)粘贴保存即可立即生效,或写入 MCP 客户端配置 env.ZENMCP_TOKEN 后重新加载;绝不在聊天中索取 Key。` },
312
394
  ];
313
395
  for (const prompt of prompts)
314
396
  server.registerPrompt(prompt.name, { title: prompt.title, description: prompt.title }, async () => ({ messages: [{ role: 'user', content: { type: 'text', text: prompt.text } }] }));
@@ -317,12 +399,7 @@ export function createServer(engine, socialOptions = {}, speechOptions = {}) {
317
399
  export function createEngine(baseUrl = DEFAULT_BASE_URL, tokens) {
318
400
  const capturedToken = process.env.ZENMCP_TOKEN;
319
401
  delete process.env.ZENMCP_TOKEN;
320
- const provider = tokens ?? { token: async () => {
321
- const value = capturedToken ?? process.env.ZENMCP_TOKEN;
322
- if (!value)
323
- throw new Error('token_missing');
324
- return value;
325
- } };
402
+ const provider = tokens ?? createDefaultTokenProvider({ capturedEnvToken: capturedToken });
326
403
  return new Engine({ effects: job => new PopTitleRenderer(job), gateway: new CloudGateway({ baseUrl, tokens: provider }), tokens: provider, catalogLabel: '云端 catalog(仅运行工具时读取;Wan 可用性以返回目录为准)' });
327
404
  }
328
405
  export async function startServer(baseUrl = DEFAULT_BASE_URL, tokens) {
@@ -333,6 +410,19 @@ export async function startServer(baseUrl = DEFAULT_BASE_URL, tokens) {
333
410
  // Importing this module in an embedding host never starts network or stdio work.
334
411
  const entry = process.argv[1] ? await (await import('node:fs/promises')).realpath(process.argv[1]).catch(() => process.argv[1]) : '';
335
412
  if (entry && import.meta.url === (await import('node:url')).pathToFileURL(entry).href) {
336
- const baseUrl = process.env.ZENMCP_BASE_URL?.trim() || DEFAULT_BASE_URL;
337
- await startServer(baseUrl);
413
+ const cliArgs = process.argv.slice(2);
414
+ if (cliArgs[0] === 'login' || cliArgs[0] === 'logout' || cliArgs[0] === '--help' || cliArgs[0] === '-h') {
415
+ const { runAuthSubcommand } = await import('../setup/cli.js');
416
+ try {
417
+ await runAuthSubcommand(cliArgs);
418
+ }
419
+ catch (error) {
420
+ console.error(error instanceof Error ? error.message : '账户连接未能完成。');
421
+ process.exitCode = 1;
422
+ }
423
+ }
424
+ else {
425
+ const baseUrl = process.env.ZENMCP_BASE_URL?.trim() || DEFAULT_BASE_URL;
426
+ await startServer(baseUrl);
427
+ }
338
428
  }