@zenaigc/zenmcp 0.1.9 → 0.1.10

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
@@ -1,59 +1,42 @@
1
1
  # ZenMCP Agent 自助安装指南
2
2
 
3
- 请按「识别唯一宿主 → 环境检查 → 单次安装与自检 → 能力匹配配置 → 绑 Key → Skill → 诚实验收」流程执行。**平台 Key 不得在对话、命令行参数或日志中出现明文。**
3
+ 请在后台按步骤静默完成环境检查、安装、当前软件配置、平台 Key 检查与技能投递。**平台 Key 不得在对话、命令行参数或日志中出现明文。**
4
4
 
5
- ## 交互要求与红线
5
+ ## 对用户说话铁律(面向非技术用户,最高沟通准则)
6
6
 
7
- - **单宿主铁律(最高优先级)**:先确认当前对话所在的**唯一目标软件**(若会话存在 `mcp_superone_*` / `widget_show` 等工具,即使底层模型/引擎是 Claude、Codex、Grok、DeepSeek 或 Cursor,目标宿主一律为 **SuperOne**)。除非用户明确要求配置其他软件,**严禁扫描、询问或修改本机其他 AI 客户端的配置文件、软链或技能目录**。
8
- - **五步进度清单**:向用户展示并随真实进度更新:`环境检查 → 安装 → 客户端配置 → 绑定平台 Key → 启用与验证`。
9
- - **诚实勾选原则**:只有当前会话已实际挂载 `zenmcp` 工具并成功调用 `account_status` 时,最后一项才可标 `[x]`;凡需用户在界面手动粘贴配置或重载/新开会话才能生效时,对应项必须保持 `[ ] 待粘贴/重载后生效`,**严禁在终端手搓脚本调用 `server.js` 冒充会话已连通**。
10
- - **最少打扰与隐私脱敏**:
11
- - 缺失系统依赖只合并询问一次,列出所有缺项并提供「全部安装 / 我自行安装」选项(有选项式提问工具时优先使用)。
12
- - 将 `zenmcp-doctor` 输出整理成「通过 / 缺失」表格,不直接贴大段原始 JSON;`config` 三项(`ZENMCP_BASE_URL`、`ZENMCP_TOKEN`、`credentials_file`)只说明是否已配置,不展示值或凭据文件路径。
13
- - Key 不进入聊天:引导通过 `zenmcp-setup` 本机网页或终端 `zenmcp login` 隐藏输入保存;若用户自行粘贴到聊天,不回显并提示立即前往账户页撤销重建。
7
+ - **用户不是程序员**:正常安装全程静默执行,不要每跑一条命令就播报技术日志。最后**只输出一段极简结果**(除必须粘贴的配置块外控制在 **8 行以内**),只用大白话讲清两件事:**① 已经帮你装好了什么**、**② 下一步需要你点哪里**。
8
+ - **严禁输出技术黑话、长表格、`[x]` 符号与自证汇报**:给用户的回复中**禁止出现**进度表格,**禁止使用 `[x]` / `[ ]` 勾选符号**(普通用户会把 `x` 误认为失败打叉),且**禁止出现** `zenmcp-doctor`、`ok: true`、`Node / FFmpeg / ffprobe / Chrome / render.js` 版本号、`ZENMCP_BASE_URL`、`ZENMCP_TOKEN`、`credentials_file`、`in_app_sandbox`、`0600`、`127.0.0.1`、`SKILL.md`、`widgets`、`nvm`、`Homebrew`、“封闭存储”、“未触碰其他客户端”、“没有重复安装”、“不会伪造调用”等任何内部实现词。
9
+ - **正常项全部静默,仅需用户配合时才开口**:环境齐全、安装成功、本机已有平台 Key 时一律后台直接通过,不逐项汇报;仅当**电脑缺少基础软件需征得安装同意**,或**本机尚无平台 Key 需用户在网页保存**时,才用一句大白话请用户配合。
10
+ - **Key 零明文与一句话换绑**:绝不让用户把 Key 发到聊天里(若用户误发,不回显并提醒前往 https://zenaigc.com/console 撤销重建)。本机已有 Key 时**不要**科普绑 Key 命令;若用户主动说「帮我更换 ZenMCP 的 Key」,直接在后台运行 `"<node_path>" "<setup_bin>"` 为其弹出绑定网页即可,不要让普通用户去敲终端命令。
14
11
 
15
- | 异常 | 下一步 |
16
- | --- | --- |
17
- | 命令找不到 | 改用 `zenmcp-doctor` 返回的 `node_path` 与 `server_entry` 绝对路径(`command` 填 `node_path`,`args` 填 `[server_entry]`)。 |
18
- | `token_missing` | 按第 4 步在账户页创建 Key,通过本机 `zenmcp-setup` 或终端 `zenmcp login` 保存;保存后免重启客户端即可重试 `account_status`。 |
19
- | `invalid_credential` | 查看报错提示的凭据来源:来自本机凭据文件时重新执行登录保存即可;来自 `env.ZENMCP_TOKEN`(优先于凭据文件)时,移除或更新客户端配置中的 `env.ZENMCP_TOKEN` 后重载客户端。 |
20
- | 网络失败 | 检查网络连接及客户端能否访问 https://api.zenaigc.com,恢复后重试只读账户查询。 |
12
+ ---
21
13
 
22
- ## 1. 识别当前宿主与检查本机环境
14
+ ## 后台执行规范(仅供 AI 内部遵循,严禁向用户复述)
23
15
 
24
- 结合自身系统提示词/内置工具列表、当前工作目录路径及环境变量确认唯一宿主(可参考第 2 步 `zenmcp-doctor` 的 `runtime.detected_host_hint`,但以“外层对话软件优先于底层引擎”为准)。
16
+ ### 1. 锁定唯一目标软件并检查依赖
25
17
 
26
- 随后检查依赖:`node -v`(确认 Node.js ≥ 22)、`ffmpeg -version`、`ffprobe -version`,并检查 Google Chrome 已安装且可启动。
18
+ - **单宿主铁律**:结合自身系统提示词/内置工具列表、当前工作目录及环境变量确认当前对话所在的**唯一目标软件**(若会话存在 `mcp_superone_*` / `widget_show` 等工具,即使底层模型是 Claude、Codex、Grok、DeepSeek 或 Cursor,目标宿主一律为 **SuperOne**)。除非用户明确要求,**严禁扫描、询问或修改本机其他 AI 软件的配置文件、软链或技能目录**。
19
+ - **静默检查依赖**:检查 `node -v`(≥ 22)、`ffmpeg -version`、`ffprobe -version` 与 Google Chrome。全部具备时静默进入下一步;若有缺失,合并用一句大白话询问用户是否允许自动安装(有选项式提问工具时优先使用,提供「自动安装 / 我自己装」),获同意后按系统安装:
20
+ - macOS:`brew install node@22 ffmpeg`、`brew install --cask google-chrome`
21
+ - Windows:`winget install OpenJS.NodeJS.LTS`、`winget install Gyan.FFmpeg`、`winget install Google.Chrome`
22
+ - Linux:`apt` 安装 Node.js(≥ 22)、FFmpeg 与 Google Chrome 官方 deb 包
27
23
 
28
- 有缺失时,先合并告知缺项并征得用户同意,再按系统安装:
24
+ ### 2. 单次安装并读取运行时路径
29
25
 
30
- - macOS:`brew install node@22 ffmpeg`、`brew install --cask google-chrome`(确保 Node.js 在 `PATH` 中)。
31
- - Windows:`winget install OpenJS.NodeJS.LTS`、`winget install Gyan.FFmpeg`、`winget install Google.Chrome`。
32
- - Linux:使用 `apt` 安装 Node.js、FFmpeg 与 Google Chrome(使用官方 deb 包交给 `apt` 安装);若默认源 Node.js < 22,先说明需要配置兼容软件源并获同意后再处理。
33
-
34
- 安装后重新打开终端或刷新环境并复查;FFmpeg 应同时提供 `ffprobe`。
35
-
36
- ## 2. 安装 ZenMCP 并运行单次自检
37
-
38
- 优先指定 npm 官方源安装,避免国内镜像源滞后在旧版本(仅当官方源不可达时回退默认 `npm install -g @zenaigc/zenmcp`):
26
+ 优先从 npm 官方源安装(避免镜像源滞后;仅官方源不可达时回退默认源),随后运行一次自检:
39
27
 
40
28
  ```bash
41
29
  npm install -g @zenaigc/zenmcp --registry=https://registry.npmjs.org
42
- ```
43
-
44
- 随后运行一次本机自检:
45
-
46
- ```bash
47
30
  zenmcp-doctor
48
31
  ```
49
32
 
50
- - 确认 `"ok": true`(否则按缺项修复后重跑)。未绑 Key 前 `config` 中 `ZENMCP_BASE_URL`、`ZENMCP_TOKEN` 与 `credentials_file` 为 `false` 属正常,不影响自检。
51
- - 从返回的 `runtime` 读取 `node_path`、`server_entry`、`setup_bin`、`skill_dir`、`in_app_sandbox`、`headless_or_ssh` 与 `detected_host_hint`(若遇旧版尚无 `runtime` 字段,用 `command -v node` / `where.exe node` 与 `npm root -g` 定位 `<npm root -g>/@zenaigc/zenmcp/dist/src/mcp/server.js` 等路径)。
52
- - **沙盒免双装规则**:当 `in_app_sandbox` 为 `true`(如豆包电脑版内置 `sandbox_runtime`)时,**禁止再往用户的 `nvm`、Homebrew 或系统目录重复安装第二遍**;后续统一使用 `runtime.node_path` 与 `runtime.server_entry` 绝对路径,GUI 与沙盒均可直接独立启动。
33
+ - 确认 `"ok": true`,从 `runtime` 读取 `node_path`、`server_entry`、`setup_bin`、`skill_dir`、`in_app_sandbox`、`headless_or_ssh` 与 `detected_host_hint`(旧版无 `runtime` 时用 `command -v node` / `where.exe node` 与 `npm root -g` 定位)。
34
+ - **沙盒免双装**:`in_app_sandbox` 为 `true`(如豆包内置沙盒)时,**禁止再往用户的 `nvm`、Homebrew 或系统目录装第二遍**,后续配置直接使用 `runtime.node_path` 与 `runtime.server_entry` 绝对路径。
35
+ - **禁止回读包内旧文档**:全程以当前这份指南为准,安装完成后无需再去读取 `node_modules` 包内的 `INSTALL.md`,直接按文末「最终对用户的回复模板」收尾。
53
36
 
54
- ## 3. 按宿主的 MCP 注册能力配置当前软件
37
+ ### 3. 按当前软件的 MCP 注册能力配置
55
38
 
56
- GUI 客户端常不继承终端 `nvm` / Homebrew 的 `PATH`,配置一律使用**无密钥绝对路径**(内置默认地址 `https://api.zenaigc.com/api/v1`,无需配置 `ZENMCP_BASE_URL`):
39
+ 配置统一使用无密钥绝对路径(内置默认服务地址,无需写 `ZENMCP_BASE_URL`):
57
40
 
58
41
  ```json
59
42
  {
@@ -66,69 +49,86 @@ GUI 客户端常不继承终端 `nvm` / Homebrew 的 `PATH`,配置一律使用
66
49
  }
67
50
  ```
68
51
 
69
- ### 三种注册模式
52
+ - **M1(原生 CLI 注册)**:调用当前软件官方 CLI 原子写入用户级配置。
53
+ - **M2(本地配置文件备份合并)**:仅操作当前软件自己的配置文件(先备份原文件),按其语法方言合并 `zenmcp` 节点,保留其他全部已有配置。
54
+ - **M3(界面手动粘贴)**:当前软件无公开外部配置文件时,不改其他软件文件、不用桌面自动化点宿主自身窗口;在最终回复中按「场景 A 模板」给出填好真实绝对路径的 JSON 块。
70
55
 
71
- - **M1(原生 CLI 注册)**:调用当前宿主的官方 CLI 命令原子写入用户级配置。
72
- - **M2(本地配置文件备份合并)**:仅操作当前宿主自己的配置文件(已有文件先备份),按其语法方言合并 `zenmcp` 节点,保留其他全部已有配置与服务。
73
- - **M3(封闭存储 / 界面手动添加)**:当前宿主无公开外部配置文件时,**不改其他客户端文件、不用桌面自动化点击宿主自身窗口**;向用户输出填好真实 `<node_path>` 与 `<server_entry>` 的配置块并指明界面入口,清单对应项保持 `[ ] 待你在界面粘贴启用`。
74
-
75
- ### 主流宿主能力匹配表
76
-
77
- | 宿主软件 | MCP 注册模式与目标位置 / 语法方言 | Skill 模式(第 5 步) |
56
+ | 宿主软件 | MCP 注册方式与位置 | Skill 投递(第 5 步) |
78
57
  | --- | --- | --- |
79
58
  | **SuperOne** | **M2 / M3**:在其 MCP 设置中添加标准 `mcpServers` JSON | **S2**:整目录复制到 `~/.agents/skills/zenmcp`,并将 `widgets/zenmcp-*` 复制到 `~/.superone/widget/`(alpha 为 `~/.superone/alpha/widget/`) |
80
- | **Claude Code** | **M1**:执行 `claude mcp add -s user zenmcp -- "<node_path>" "<server_entry>"` | **S1**:`~/.claude/skills/zenmcp/SKILL.md` |
81
- | **Codex** (OpenAI) | **M1 / M2-TOML**:执行 `codex mcp add zenmcp -- "<node_path>" "<server_entry>"`,或备份合并 `~/.codex/config.toml` 的 `[mcp_servers.zenmcp]` | **S1**:`~/.codex/skills/zenmcp/SKILL.md` |
82
- | **Grok CLI** (xAI) | **M2-TOML**:备份合并 `~/.grok/config.toml` 的 `[mcp_servers.zenmcp]`(`command = "<node_path>"`、`args = ["<server_entry>"]`),可用 `grok inspect` 检查 | **S1**:`~/.grok/skills/zenmcp/SKILL.md` |
59
+ | **Claude Code** | **M1**:`claude mcp add -s user zenmcp -- "<node_path>" "<server_entry>"` | **S1**:`~/.claude/skills/zenmcp/SKILL.md` |
60
+ | **Codex** (OpenAI) | **M1 / M2-TOML**:`codex mcp add zenmcp -- "<node_path>" "<server_entry>"`,或合并 `~/.codex/config.toml` 的 `[mcp_servers.zenmcp]` | **S1**:`~/.codex/skills/zenmcp/SKILL.md` |
61
+ | **Grok CLI** (xAI) | **M2-TOML**:合并 `~/.grok/config.toml` 的 `[mcp_servers.zenmcp]`(`command = "<node_path>"`、`args = ["<server_entry>"]`) | **S1**:`~/.grok/skills/zenmcp/SKILL.md` |
83
62
  | **DeepSeek Harness (`dsh`)** | **M2-YAML**:在 `~/.dsh/` 当前 profile 的 Cordis 配置中为 `@deepseek-ai/dsh-mcp-client` 添加 stdio 服务 | **S1**:`~/.dsh/skills/zenmcp/SKILL.md` |
84
- | **Cursor** | **M2-JSON**:备份合并 `~/.cursor/mcp.json`(`mcpServers`) | **S1**:`~/.cursor/skills/zenmcp/SKILL.md` |
85
- | **Trae / Trae CN** | **M2-JSON**:备份合并 `~/.trae/mcp.json`(`mcpServers`) | **S1**:当前项目工作区 `.trae/skills/zenmcp/SKILL.md`(无工作区则跳过) |
86
- | **CodeBuddy / WorkBuddy** | **M2-JSON**:CodeBuddy 合并 `~/.codebuddy/mcp.json`;WorkBuddy 合并 `~/.workbuddy/mcp.json`(`mcpServers`) | **S1**:CodeBuddy 为 `~/.codebuddy/skills/zenmcp/SKILL.md`;WorkBuddy 如无 skills 目录则跳过 |
87
- | **豆包电脑版** | **M3**:输出绝对路径 JSON 块,引导左侧「技能·连接器 → 添加 MCP」粘贴 | **S1**:复制到豆包 Agent 工作区的 `.user_skills/zenmcp/SKILL.md` |
88
- | **Claude Desktop** | **M2-JSON**:备份合并 macOS `~/Library/Application Support/Claude/claude_desktop_config.json` 或 Windows `%APPDATA%\Claude\claude_desktop_config.json` | **S0**:跳过 |
89
- | **VS Code (Copilot)** | **M2-异构 JSON**:合并用户级 `mcp.json` 或工作区 `.vscode/mcp.json`,**顶层键为 `"servers"`**,条目为 `{"type":"stdio","command":"<node_path>","args":["<server_entry>"]}` | **S0 / S1**:有项目工作区可写 `.github/skills/zenmcp/SKILL.md`,否则跳过 |
90
- | **OpenCode** | **M2-异构 JSON**:备份合并 `~/.config/opencode/opencode.json`,在 **`"mcp"`** 下配置 `"zenmcp": {"type":"local","command":["<node_path>","<server_entry>"],"enabled":true}` | **S1**:`~/.config/opencode/skills/zenmcp/SKILL.md` |
91
- | **Gemini CLI** | **M2-JSON**:备份合并 `~/.gemini/settings.json`(`mcpServers`,保留全部其他字段) | **S1**:`~/.gemini/skills/zenmcp/SKILL.md` |
92
- | **Antigravity / Windsurf / Kiro** | **M2-JSON**:分别合并 `~/.gemini/antigravity/mcp_config.json`、`~/.codeium/windsurf/mcp_config.json`、`~/.kiro/settings/mcp.json`(`mcpServers`) | **S1**:支持全局 `skills/` 时写入对应 `skills/zenmcp/SKILL.md`,否则跳过 |
63
+ | **Cursor** | **M2-JSON**:合并 `~/.cursor/mcp.json`(`mcpServers`) | **S1**:`~/.cursor/skills/zenmcp/SKILL.md` |
64
+ | **Trae / Trae CN** | **M2-JSON**:合并 `~/.trae/mcp.json`(`mcpServers`) | **S1**:当前项目工作区 `.trae/skills/zenmcp/SKILL.md`(无工作区则跳过) |
65
+ | **CodeBuddy / WorkBuddy** | **M2-JSON**:合并 `~/.codebuddy/mcp.json` 或 `~/.workbuddy/mcp.json`(`mcpServers`) | **S1**:CodeBuddy 为 `~/.codebuddy/skills/zenmcp/SKILL.md`;WorkBuddy 无 skills 目录则跳过 |
66
+ | **豆包电脑版** | **M3**:引导左侧「技能·连接器 → 添加 MCP」粘贴 | **S1**:复制到豆包 Agent 工作区 `.user_skills/zenmcp/SKILL.md` |
67
+ | **Claude Desktop** | **M2-JSON**:合并 macOS `~/Library/Application Support/Claude/claude_desktop_config.json` 或 Windows `%APPDATA%\Claude\claude_desktop_config.json` | **S0**:跳过 |
68
+ | **VS Code (Copilot)** | **M2-异构 JSON**:合并用户级 `mcp.json` 或 `.vscode/mcp.json`,**顶层键为 `"servers"`**,条目 `{"type":"stdio","command":"<node_path>","args":["<server_entry>"]}` | **S0 / S1**:有项目工作区可写 `.github/skills/zenmcp/SKILL.md`,否则跳过 |
69
+ | **OpenCode** | **M2-异构 JSON**:合并 `~/.config/opencode/opencode.json` 的 **`"mcp"`** 下 `"zenmcp": {"type":"local","command":["<node_path>","<server_entry>"],"enabled":true}` | **S1**:`~/.config/opencode/skills/zenmcp/SKILL.md` |
70
+ | **Gemini CLI** | **M2-JSON**:合并 `~/.gemini/settings.json`(`mcpServers`,保留其他字段) | **S1**:`~/.gemini/skills/zenmcp/SKILL.md` |
71
+ | **Antigravity / Windsurf / Kiro** | **M2-JSON**:分别合并 `~/.gemini/antigravity/mcp_config.json`、`~/.codeium/windsurf/mcp_config.json`、`~/.kiro/settings/mcp.json` | **S1**:支持全局 `skills/` 时写入对应 `skills/zenmcp/SKILL.md`,否则跳过 |
93
72
  | **OpenClaw** | **M2-JSON5**:先读取 `~/.openclaw/openclaw.json` 确认结构后合并或通过 `mcporter` 注册 | **S1**:`~/.openclaw/skills/zenmcp/SKILL.md` |
94
- | **Muse / Cherry Studio / Cline / Roo Code** | **M3**:输出绝对路径 JSON 块,引导在当前软件的「Settings → Connectors」或「MCP 服务器」面板粘贴 | **S0**:跳过 |
73
+ | **Muse / Cherry Studio / Cline / Roo Code** | **M3**:引导在当前软件「Settings → Connectors」或「MCP 服务器」面板粘贴 | **S0**:跳过 |
74
+
75
+ - **未知软件兜底**:未在上表出现时,① 先查自身内置 MCP 工具或 `<当前CLI> mcp --help`;② 有检索能力时查询该软件官方 MCP 配置路径与格式;③ 无法 100% 确认时严禁盲猜写文件,退回 **M3** 请用户在设置界面粘贴。
76
+
77
+ ### 4. 检查或引导绑定平台 Key(一次保存,同机共用)
78
+
79
+ - **A0(已有 Key,`config.credentials_file: true`)**:直接静默跳过,**不要**向用户讲任何绑 Key 命令或配置说明。
80
+ - **A1(无 Key + 本机桌面,`headless_or_ssh: false`)**:直接在后台运行 `"<node_path>" "<setup_bin>"` 自动弹出本地绑定网页,只用一句话告诉用户:「已为你打开绑定网页,请点击页面入口登录 https://zenaigc.com/console 创建平台 Key,粘贴保存后告诉我一声即可(请勿把 Key 发到聊天里)。」若沙盒限制无法弹窗,改运行 `"<node_path>" "<setup_bin>" --no-open` 把本地网页链接发给用户点开。
81
+ - **A2(无 Key + 纯终端 / 远程 SSH,`headless_or_ssh: true`)**:请用户前往 https://zenaigc.com/console 创建 Key,并在服务器终端执行 `"<node_path>" "<setup_bin>" --terminal`(或 `zenmcp login`)隐藏输入保存。
82
+
83
+ ### 5. 投递当前软件的 Skill(静默完成)
95
84
 
96
- ### 未知宿主自省兜底流程
85
+ - **S2(SuperOne)**:将 `<skill_dir>` 整目录复制到 `~/.agents/skills/zenmcp`,并将 `<skill_dir>/widgets/zenmcp-*` 复制到 `~/.superone/widget/`(alpha 为 `~/.superone/alpha/widget/`)。
86
+ - **S1(支持 `SKILL.md` 的软件)**:创建对应目录,仅复制 `<skill_dir>/SKILL.md` 单文件。
87
+ - **S0(不支持的软件)**:静默跳过。
97
88
 
98
- 当当前软件未在上表中出现时,按三步自主探索:
89
+ ### 内部排障参考(仅报错时使用,正常安装严禁向用户输出)
99
90
 
100
- 1. 检查自身工具列表是否有内置 MCP 注册工具,或在终端尝试 `<当前宿主CLI> mcp --help` 查看原生命令。
101
- 2. 若具备联网搜索或本地文档检索能力,主动查询 `<当前软件名> MCP configuration file format path skills directory`,核实配置文件路径与顶层键名。
102
- 3. 凡无法 100% 确认外部配置文件路径与格式时,**严禁盲猜写文件**,自动退回 **M3 模式**,输出已填好真实绝对路径的标准配置块,请用户在当前软件的 MCP / 连接器设置界面粘贴。
91
+ - 命令找不到:配置改用 `runtime.node_path` 与 `runtime.server_entry` 绝对路径。
92
+ - `token_missing`:按第 4 步打开绑定网页或终端隐藏输入保存,免重启即可重试。
93
+ - `invalid_credential`:若来自本机凭据文件则重新运行 `"<node_path>" "<setup_bin>"` 更换;若客户端配置了 `env.ZENMCP_TOKEN`(优先于凭据文件),移除旧环境变量并重载软件。
94
+ - 网络失败:检查本机能否访问 https://api.zenaigc.com。
103
95
 
104
- 首次写入或粘贴完成后,重载或新开一次宿主会话使工具挂载生效。
96
+ ---
105
97
 
106
- ## 4. 按运行环境匹配零密文绑 Key 通道(一次保存,同机共用)
98
+ ## 最终对用户的回复模板(严格三选一,禁止额外加段落或表格)
107
99
 
108
- 引导用户前往 https://zenaigc.com/console (或 https://api.zenaigc.com )登录并创建平台 Key,按环境分流:
100
+ 当前对话未挂载 `zenmcp` 工具时,**严禁在终端手动运行 `server.js` 冒充连通**,直接按场景 A 或场景 B 输出即可。
109
101
 
110
- - **A0(已绑定)**:`zenmcp-doctor` 显示 `config.credentials_file: true` 时直接跳过,说明本机安全凭据库已有可用 Key。
111
- - **A1(本机图形桌面,`headless_or_ssh: false`)**:由 Agent 直接运行以下命令启动本机 `127.0.0.1` 网页连接卡片(保存后临时端口自动关闭,写入 `0600` 权限凭据库,同机所有客户端共用且免重启生效):
112
- ```bash
113
- "<node_path>" "<setup_bin>"
114
- ```
115
- 若宿主沙盒禁止弹出浏览器,改用 `"<node_path>" "<setup_bin>" --no-open` 输出本地地址或将该完整命令交由用户执行。
116
- - **A2(纯终端或远程 SSH,`headless_or_ssh: true`)**:请用户在运行 `zenmcp` 的机器终端自行执行以下命令隐藏粘贴保存(若 `zenmcp` 已在系统 `PATH` 可直接运行 `zenmcp login`):
117
- ```bash
118
- "<node_path>" "<setup_bin>" --terminal
119
- ```
102
+ ### 场景 A:需用户在软件界面粘贴一次配置(M3,如豆包电脑版等)
120
103
 
121
- 如需按单个客户端单独指定 Key,也兼容在客户端配置块中加入 `"env": { "ZENMCP_TOKEN": "<平台Key>" }` 并重载客户端(注意:`env.ZENMCP_TOKEN` 优先级高于本机凭据文件;若其中旧 Key 已失效,需先移除或更新并重载)。如需清除本机保存的凭据,可运行 `"<node_path>" "<setup_bin>" logout`(或 `zenmcp logout`)。
104
+ 直接按以下结构回复(将入口名称换成当前软件界面名,填入真实绝对路径,不要加其他标题):
122
105
 
123
- ## 5. 只投递当前宿主的 Skill(S0 / S1 / S2)
106
+ > **ZenMCP 已安装完成**(运行环境、核心组件、平台 Key 与创作技能均已自动备好)。
107
+ >
108
+ > **最后一步(需你在软件界面添加):**
109
+ > 1. 打开左侧 **「技能·连接器」→「添加 MCP」**,粘贴下面这段配置并保存:
110
+ > ```json
111
+ > {
112
+ > "mcpServers": {
113
+ > "zenmcp": {
114
+ > "command": "<真实 node_path>",
115
+ > "args": ["<真实 server_entry>"]
116
+ > }
117
+ > }
118
+ > }
119
+ > ```
120
+ > 2. **新开一个对话**,对我说:**「检查我的 ZenMCP 账户状态」** 即可开始使用。
121
+ >
122
+ > *(如需更换平台 Key,随时对我说「帮我更换 ZenMCP 的 Key」即可。)*
124
123
 
125
- 使用第 2 步得到的 `skill_dir`:
124
+ ### 场景 B:已自动写好配置,需重启软件或新开对话生效(M1 / M2 未热挂载时)
126
125
 
127
- - **S2(SuperOne)**:将 `<skill_dir>` 整个目录复制到 `~/.agents/skills/zenmcp`(含 `SKILL.md` 与 `widgets/`),并把 `<skill_dir>/widgets/zenmcp-*` 复制到 `~/.superone/widget/`(alpha 版为 `~/.superone/alpha/widget/`)。
128
- - **S1(支持 `SKILL.md` 的其他宿主)**:先创建当前宿主对应的 `skills/zenmcp` 目录,**仅复制 `<skill_dir>/SKILL.md` 单文件**(不复制 `widgets/`,更不写入其他客户端的目录)。
129
- - **S0(不支持 Skills 的宿主)**:跳过本步。
126
+ > **ZenMCP 已全部自动安装并配置完成**(核心组件、软件配置、平台 Key 与创作技能均已就绪)。
127
+ >
128
+ > **下一步:** 请**重启当前软件或新开一个对话**,发送 **「检查我的 ZenMCP 账户状态」** 即可开始使用。
129
+ >
130
+ > *(如需更换平台 Key,随时对我说「帮我更换 ZenMCP 的 Key」即可。)*
130
131
 
131
- ## 6. 连通验证与收尾
132
+ ### 场景 C:当前对话已挂载 `zenmcp` 工具(调用 `account_status` 成功后)
132
133
 
133
- - **当前会话已原生挂载 `zenmcp` 工具时**:直接调用只读工具 `account_status`,原样展示积分信息与「可以这样说」欢迎块(有效可用积分为 0 时引导前往 https://zenaigc.com/console 充值或调整 Key 限额),五步清单全部标 `[x]`。
134
- - **需界面粘贴(M3)或尚未重载会话(M1/M2)时**:保持「启用与验证」为 `[ ]`,明确提示用户在完成界面粘贴或重载/新开对话后,发送「检查我的 ZenMCP 账户状态」即可完成最后一步验证。
134
+ 直接回复一句 **「ZenMCP 已安装并连通成功!」**,随后原样展示 `account_status` 返回的积分信息与「可以这样说」创作示例(可用积分为 0 时附一句前往 https://zenaigc.com/console 充值的提示),**不要**附加任何安装过程说明。
@@ -17,7 +17,7 @@ import { trimMedia } from '../acquire/trim.js';
17
17
  import { ACCOUNT_URL, ERROR_GUIDANCE, POLL_AFTER_SECONDS, LARGE_AMOUNT_CREDITS, LARGE_BALANCE_RATIO, errorGuidance } from './guidance.js';
18
18
  import { createDefaultTokenProvider } from '../setup/credentials.js';
19
19
  export const DEFAULT_BASE_URL = 'https://api.zenaigc.com/api/v1';
20
- export const CLIENT_VERSION = '0.1.9';
20
+ export const CLIENT_VERSION = '0.1.10';
21
21
  const inputSchema = z.object({
22
22
  job: jobSchema, reference: z.string().min(1),
23
23
  output: z.object({ duration_seconds: z.number().int(), resolution: z.enum(['480P', '720P', '1080P']), ratio: z.string(), seed: z.number().int().optional() }),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zenaigc/zenmcp",
3
- "version": "0.1.9",
3
+ "version": "0.1.10",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "zenmcp": "dist/src/mcp/server.js",
@@ -5,7 +5,7 @@ description: 用户需要生图、生视频、拆解二创短视频、录音识
5
5
 
6
6
  # ZenMCP
7
7
 
8
- 环境异常或未安装时运行 `zenmcp-doctor`,或参照同包内的 `INSTALL.md`(安装包根目录,在线地址:https://api.zenaigc.com/install.md)。安装缺失依赖前须征得用户同意。
8
+ 环境异常或未安装时优先参照在线最新指南 https://zenaigc.com/install.md (离线时参照同包内的 `INSTALL.md`),后台静默运行 `zenmcp-doctor`;对普通用户只输出极简大白话结果,禁止输出进度表格、`[x]` 标记或内部技术术语。安装缺失依赖前须征得用户同意。
9
9
 
10
10
  ## 工具编排
11
11