@zenaigc/zenmcp 0.1.8 → 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,106 +1,134 @@
1
1
  # ZenMCP Agent 自助安装指南
2
2
 
3
- 请按以下七步执行。涉及安装缺失依赖时先征得用户同意;平台 Key 不得在对话或日志中回显明文。
3
+ 请在后台按步骤静默完成环境检查、安装、当前软件配置、平台 Key 检查与技能投递。**平台 Key 不得在对话、命令行参数或日志中出现明文。**
4
4
 
5
- ## 交互要求
5
+ ## 对用户说话铁律(面向非技术用户,最高沟通准则)
6
6
 
7
- - 向用户展示五步清单并随完成情况更新:环境检查 → 安装 → 客户端配置 → 绑定平台 Key → 验证(完成项标记为已完成)。
8
- - 缺失依赖只合并询问一次,列出所有缺项,提供「全部安装 / 我自行安装」两个选项;使用客户端提供的选项式提问工具(如有)。
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
- - `account_status` 成功后原样展示其「可以这样说」欢迎块;有效可用积分为 0 时,引导前往 https://api.zenaigc.com 充值或调整 Key 限额。
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>"` 为其弹出绑定网页即可,不要让普通用户去敲终端命令。
12
11
 
13
- | 异常 | 下一步 |
14
- | --- | --- |
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` 后重新加载客户端。 |
18
- | 网络失败 | 检查网络连接及客户端能否访问 https://api.zenaigc.com,恢复后重试只读账户查询。 |
12
+ ---
19
13
 
20
- ## 1. 检查本机环境
14
+ ## 后台执行规范(仅供 AI 内部遵循,严禁向用户复述)
21
15
 
22
- 运行 `node -v`,确认 Node.js 版本 ≥ 22;运行 `ffmpeg -version`、`ffprobe -version`,并检查 Google Chrome 已安装且可启动。
16
+ ### 1. 锁定唯一目标软件并检查依赖
23
17
 
24
- 有缺失时,先告知用户需要安装的组件并征得同意,再按系统安装:
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 包
25
23
 
26
- - macOS:使用 `brew`,例如 `brew install node@22 ffmpeg`、`brew install --cask google-chrome`。确保 Node.js 的 bin 目录在 PATH 中。
27
- - Windows:使用 `winget`,例如 `winget install OpenJS.NodeJS.LTS`、`winget install Gyan.FFmpeg`、`winget install Google.Chrome`。
28
- - Linux:使用 `apt` 安装 Node.js、FFmpeg 和 Google Chrome(Chrome 使用官方 deb 包交给 `apt` 安装)。先检查 apt 软件源提供的 Node.js 是否 ≥ 22;不满足时先说明需要配置兼容的软件源,获得用户同意后再处理。
24
+ ### 2. 单次安装并读取运行时路径
29
25
 
30
- 安装后重新打开终端并重复检查;Node.js 必须 ≥ 22,FFmpeg 安装应同时提供 ffprobe。
31
-
32
- ## 2. 安装 ZenMCP
33
-
34
- ```bash
35
- npm install -g @zenaigc/zenmcp
36
- ```
37
-
38
- ## 3. 运行本机自检
26
+ 优先从 npm 官方源安装(避免镜像源滞后;仅官方源不可达时回退默认源),随后运行一次自检:
39
27
 
40
28
  ```bash
29
+ npm install -g @zenaigc/zenmcp --registry=https://registry.npmjs.org
41
30
  zenmcp-doctor
42
31
  ```
43
32
 
44
- 确认输出 `"ok": true`,否则按检查结果修复环境再运行。未绑定 Key 前,`config` 中 `ZENMCP_BASE_URL`、`ZENMCP_TOKEN` 与 `credentials_file` 显示为 `false` 是正常的;它们只表示是否存在对应配置,不影响本机自检结果,也不验证服务器连通性。
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`,直接按文末「最终对用户的回复模板」收尾。
45
36
 
46
- ## 4. 配置 MCP 客户端(无密钥配置,首次配置后重载一次)
37
+ ### 3. 按当前软件的 MCP 注册能力配置
47
38
 
48
- 默认配置块不含任何密钥,Agent 可直接合并写入,保留客户端已有的其他 MCP 服务:
39
+ 配置统一使用无密钥绝对路径(内置默认服务地址,无需写 `ZENMCP_BASE_URL`):
49
40
 
50
41
  ```json
51
42
  {
52
43
  "mcpServers": {
53
44
  "zenmcp": {
54
- "command": "zenmcp"
45
+ "command": "<node_path>",
46
+ "args": ["<server_entry>"]
55
47
  }
56
48
  }
57
49
  }
58
50
  ```
59
51
 
60
- 无需配置 `ZENMCP_BASE_URL`,已内置默认地址 `https://api.zenaigc.com/api/v1`。
61
-
62
- - **SuperOne**:在其 MCP 设置中添加上述配置块。
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` 中合并添加上述配置块。
67
-
68
- 命令查找失败时按以下顺序处理:
69
-
70
- - Windows 上 `command` 用 `zenmcp.cmd`。
71
- - GUI 客户端找不到命令时,`command` 改用 `command -v zenmcp`(Windows 用 `where zenmcp`)得到的绝对路径。
72
- - 如果仍然报 `node` 找不到,`command` 填 `node` 的绝对路径,`args` 填 `["<npm root -g>/@zenaigc/zenmcp/dist/src/mcp/server.js"]`;将 `<npm root -g>` 替换为运行 `npm root -g` 得到的真实目录。
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
-
98
- ## 6. 安装 Skill
99
-
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` 的输出定位源目录,再复制到对应目录。
101
-
102
- 客户端不支持 skills 时跳过这一步。
103
-
104
- ## 7. 验证连通性
105
-
106
- 直接调用只读工具 `account_status`;返回积分信息与凭据来源即为连通。排查时不要回显任何 Key。
52
+ - **M1(原生 CLI 注册)**:调用当前软件官方 CLI 原子写入用户级配置。
53
+ - **M2(本地配置文件备份合并)**:仅操作当前软件自己的配置文件(先备份原文件),按其语法方言合并 `zenmcp` 节点,保留其他全部已有配置。
54
+ - **M3(界面手动粘贴)**:当前软件无公开外部配置文件时,不改其他软件文件、不用桌面自动化点宿主自身窗口;在最终回复中按「场景 A 模板」给出填好真实绝对路径的 JSON 块。
55
+
56
+ | 宿主软件 | MCP 注册方式与位置 | Skill 投递(第 5 步) |
57
+ | --- | --- | --- |
58
+ | **SuperOne** | **M2 / M3**:在其 MCP 设置中添加标准 `mcpServers` JSON | **S2**:整目录复制到 `~/.agents/skills/zenmcp`,并将 `widgets/zenmcp-*` 复制到 `~/.superone/widget/`(alpha 为 `~/.superone/alpha/widget/`) |
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` |
62
+ | **DeepSeek Harness (`dsh`)** | **M2-YAML**:在 `~/.dsh/` 当前 profile 的 Cordis 配置中为 `@deepseek-ai/dsh-mcp-client` 添加 stdio 服务 | **S1**:`~/.dsh/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`,否则跳过 |
72
+ | **OpenClaw** | **M2-JSON5**:先读取 `~/.openclaw/openclaw.json` 确认结构后合并或通过 `mcporter` 注册 | **S1**:`~/.openclaw/skills/zenmcp/SKILL.md` |
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(静默完成)
84
+
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(不支持的软件)**:静默跳过。
88
+
89
+ ### 内部排障参考(仅报错时使用,正常安装严禁向用户输出)
90
+
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。
95
+
96
+ ---
97
+
98
+ ## 最终对用户的回复模板(严格三选一,禁止额外加段落或表格)
99
+
100
+ 当前对话未挂载 `zenmcp` 工具时,**严禁在终端手动运行 `server.js` 冒充连通**,直接按场景 A 或场景 B 输出即可。
101
+
102
+ ### 场景 A:需用户在软件界面粘贴一次配置(M3,如豆包电脑版等)
103
+
104
+ 直接按以下结构回复(将入口名称换成当前软件界面名,填入真实绝对路径,不要加其他标题):
105
+
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」即可。)*
123
+
124
+ ### 场景 B:已自动写好配置,需重启软件或新开对话生效(M1 / M2 未热挂载时)
125
+
126
+ > **ZenMCP 已全部自动安装并配置完成**(核心组件、软件配置、平台 Key 与创作技能均已就绪)。
127
+ >
128
+ > **下一步:** 请**重启当前软件或新开一个对话**,发送 **「检查我的 ZenMCP 账户状态」** 即可开始使用。
129
+ >
130
+ > *(如需更换平台 Key,随时对我说「帮我更换 ZenMCP 的 Key」即可。)*
131
+
132
+ ### 场景 C:当前对话已挂载 `zenmcp` 工具(调用 `account_status` 成功后)
133
+
134
+ 直接回复一句 **「ZenMCP 已安装并连通成功!」**,随后原样展示 `account_status` 返回的积分信息与「可以这样说」创作示例(可用积分为 0 时附一句前往 https://zenaigc.com/console 充值的提示),**不要**附加任何安装过程说明。
@@ -1,14 +1,86 @@
1
1
  #!/usr/bin/env node
2
2
  import { realpath } from 'node:fs/promises';
3
- import { pathToFileURL } from 'node:url';
3
+ import { platform as osPlatform } from 'node:os';
4
+ import { dirname, join } from 'node:path';
5
+ import { fileURLToPath, pathToFileURL } from 'node:url';
4
6
  import { checkEffectsRuntime } from './effects/index.js';
7
+ import { CLIENT_VERSION } from './mcp/server.js';
8
+ import { isHeadlessOrSsh } from './setup/cli.js';
5
9
  import { hasSavedCredential } from './setup/credentials.js';
10
+ export function isAppSandboxRuntime(nodePath, pkgRoot, cwd) {
11
+ const candidates = [nodePath, pkgRoot, cwd].map(value => value.replaceAll('\\', '/').toLowerCase());
12
+ return candidates.some(value => (value.includes('/doubao/sandbox_runtime/') ||
13
+ value.includes('/sandbox_runtime/bases/') ||
14
+ value.includes('/doubao/default/sandbox_envs_dir/') ||
15
+ (value.includes('/appdata/local/doubao/') && value.includes('sandbox_runtime'))));
16
+ }
17
+ export function detectHostHint(env, cwd, nodePath) {
18
+ if (env.SUPERONE_SESSION_DIR || env.SUPERONE_SESSION_ID || env.SUPERONE_ENV || env.SUPERONE_HOST) {
19
+ return 'superone';
20
+ }
21
+ const normalizedCwd = cwd.replaceAll('\\', '/').toLowerCase();
22
+ const normalizedNode = nodePath.replaceAll('\\', '/').toLowerCase();
23
+ if (normalizedCwd.includes('/.doubao/agent_mode') ||
24
+ normalizedCwd.includes('/application support/doubao/') ||
25
+ normalizedCwd.includes('/appdata/local/doubao/') ||
26
+ normalizedNode.includes('/application support/doubao/') ||
27
+ normalizedNode.includes('/appdata/local/doubao/')) {
28
+ return 'doubao';
29
+ }
30
+ if (env.OPENCLAW_CONFIG_PATH || env.OPENCLAW_HOME || normalizedCwd.includes('/.openclaw/')) {
31
+ return 'openclaw';
32
+ }
33
+ const termProgram = env.TERM_PROGRAM?.toLowerCase() ?? '';
34
+ if (env.CURSOR_TRACE_ID || env.CURSOR_SESSION_ID || termProgram === 'cursor') {
35
+ return 'cursor';
36
+ }
37
+ if (env.TRAE_SESSION_ID || env.TRAE_TRACE_ID || termProgram.includes('trae')) {
38
+ return 'trae';
39
+ }
40
+ if (env.WINDSURF_SESSION_ID || termProgram.includes('windsurf')) {
41
+ return 'windsurf';
42
+ }
43
+ if (env.CODEBUDDY_SESSION_ID || env.WORKBUDDY_SESSION_ID || termProgram.includes('codebuddy')) {
44
+ return 'codebuddy';
45
+ }
46
+ if (env.VSCODE_PID || termProgram === 'vscode') {
47
+ return 'vscode';
48
+ }
49
+ if (env.CLAUDECODE === '1' || env.CLAUDE_CODE_ENTRYPOINT) {
50
+ return 'claude-code';
51
+ }
52
+ if (env.CODEX_SANDBOX || env.CODEX_THREAD_ID || env.CODEX_CI) {
53
+ return 'codex';
54
+ }
55
+ if (env.GROK_CLI || env.GROK_SESSION_ID) {
56
+ return 'grok';
57
+ }
58
+ if (env.DSH_PROFILE || env.DSH_HOME || env.CORDIS_HOME) {
59
+ return 'dsh';
60
+ }
61
+ if (env.ANTIGRAVITY_CLI_ALIAS || env.GEMINI_CLI) {
62
+ return 'gemini';
63
+ }
64
+ if (env.OPENCODE || env.OPENCODE_CONFIG) {
65
+ return 'opencode';
66
+ }
67
+ return 'unknown';
68
+ }
6
69
  /** Local readiness only: configuration values and server connectivity stay private. */
7
- export async function checkEnvironment(env = process.env) {
70
+ export async function checkEnvironment(env = process.env, options = {}) {
8
71
  const checks = [
9
72
  { name: 'Node', ok: Number(process.versions.node.split('.')[0]) >= 22 },
10
73
  ...await checkEffectsRuntime(),
11
74
  ];
75
+ const selfPath = await realpath(fileURLToPath(import.meta.url)).catch(() => fileURLToPath(import.meta.url));
76
+ const normalizedSelf = selfPath.replaceAll('\\', '/');
77
+ const distSrcDir = normalizedSelf.includes('/dist/src/')
78
+ ? dirname(selfPath)
79
+ : join(dirname(dirname(selfPath)), 'dist', 'src');
80
+ const pkgRoot = dirname(dirname(distSrcDir));
81
+ const currentPlatform = options.platform ?? osPlatform();
82
+ const currentCwd = options.cwd ?? process.cwd();
83
+ const nodePath = options.execPath ?? process.execPath;
12
84
  return {
13
85
  ok: checks.every(check => check.ok),
14
86
  checks,
@@ -17,6 +89,17 @@ export async function checkEnvironment(env = process.env) {
17
89
  ZENMCP_TOKEN: Boolean(env.ZENMCP_TOKEN),
18
90
  credentials_file: await hasSavedCredential({ env }),
19
91
  },
92
+ runtime: {
93
+ client_version: CLIENT_VERSION,
94
+ platform: currentPlatform,
95
+ headless_or_ssh: isHeadlessOrSsh(env, currentPlatform),
96
+ in_app_sandbox: isAppSandboxRuntime(nodePath, pkgRoot, currentCwd),
97
+ detected_host_hint: detectHostHint(env, currentCwd, nodePath),
98
+ node_path: nodePath,
99
+ server_entry: join(distSrcDir, 'mcp', 'server.js'),
100
+ setup_bin: join(distSrcDir, 'setup', 'cli.js'),
101
+ skill_dir: join(pkgRoot, 'skills', 'zenmcp'),
102
+ },
20
103
  };
21
104
  }
22
105
  const entry = process.argv[1] ? await realpath(process.argv[1]).catch(() => process.argv[1]) : '';
@@ -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.8';
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.8",
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