@zenaigc/zenmcp 0.1.4 → 0.1.5
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 +0 -1
- package/README.md +2 -2
- package/dist/src/core/job-store.js +2 -0
- package/dist/src/engine/steps.js +5 -2
- package/dist/src/gateway/attempt-store.js +2 -0
- package/dist/src/mcp/server.js +12 -8
- package/dist/src/speech/tools.js +1 -1
- package/package.json +1 -1
- package/skills/zenmcp/SKILL.md +5 -5
- package/skills/zenmcp/widgets/fixtures/zenmcp-budget-confirm.insufficient.json +1 -1
- package/skills/zenmcp/widgets/fixtures/zenmcp-budget-confirm.json +1 -1
- package/skills/zenmcp/widgets/fixtures/zenmcp-budget-confirm.minimal.json +1 -1
- package/skills/zenmcp/widgets/fixtures/zenmcp-budget-confirm.unknown.json +1 -1
- package/skills/zenmcp/widgets/zenmcp-budget-confirm/template.json +2 -2
- package/skills/zenmcp/widgets/zenmcp-budget-confirm/widget.html +1 -1
package/INSTALL.md
CHANGED
|
@@ -72,7 +72,6 @@ Key 不得在对话中回显明文。由用户自行粘贴进配置,或由 Age
|
|
|
72
72
|
- **SuperOne**:在其 MCP 设置中添加上述配置块。
|
|
73
73
|
- **Claude Code**:命令格式为 `claude mcp add zenmcp -s user -e ZENMCP_TOKEN=<Key> -- zenmcp`;不要在对话中回显真实 Key,避免将含真实 Key 的命令保存在历史或日志中。
|
|
74
74
|
- **Claude Desktop**:在 `claude_desktop_config.json` 中添加上述配置块。
|
|
75
|
-
- **OpenClaw**:在其 MCP 配置中添加上述配置块。
|
|
76
75
|
|
|
77
76
|
命令查找失败时按以下顺序处理:
|
|
78
77
|
|
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
|
|
6
6
|
## 一句话
|
|
7
7
|
|
|
8
|
-
在 Super-1(多 harness 桌面 Agent 壳)之上,用 MCP 原子工具 + 对话式 Agent
|
|
8
|
+
在 Super-1(多 harness 桌面 Agent 壳)之上,用 MCP 原子工具 + 对话式 Agent,为非专业用户提供短视频拆解二创能力:第一批以电商带货为业务方向,覆盖**穿搭展示、手持展示、场景展示、人物讲述**四类视频(可叠加口播、画面特效等属性),核心操作是换人、换产品(含换衣服)、或人品双换,并保持原片的结构、节奏和卡点。
|
|
9
9
|
|
|
10
10
|
## 项目关系
|
|
11
11
|
|
|
@@ -39,7 +39,7 @@
|
|
|
39
39
|
以下是既有产品方向,不代表功能均已实现;历史范围与新云建议冲突时,先查当前进度页及最新明确决定,不从旧文档推导开工授权。
|
|
40
40
|
|
|
41
41
|
- 形态:Super-1 内的能力(小程序 `.s1app` + MCP 工具 + Skill),对话为主、UI 为辅(UI 只做语言难描述的对齐与可视化确认)。
|
|
42
|
-
- 用户:非专业用户(非 AIGC
|
|
42
|
+
- 用户:非专业用户(非 AIGC 专业、非行业专业),看到好视频就想拆解二创。
|
|
43
43
|
- 动作:靠参考视频本身或白模(姿态/骨骼信号)驱动,不做动作词表;语义识别只是可选加强。
|
|
44
44
|
- 人物:不提供人物库;模特由用户提供参考图,版权由用户自行确认并承担。用户选择保留原片模特时不做授权确认。
|
|
45
45
|
- 素材外发:不做授权审核,也不单独告知,相关说明写入服务条款。
|
package/dist/src/engine/steps.js
CHANGED
|
@@ -21,8 +21,11 @@ const EFFECT_RENDERER_UNAVAILABLE = 'effect_renderer_unavailable:任务有特
|
|
|
21
21
|
export function safeError(error, secret) {
|
|
22
22
|
// External exception messages may contain credentials or signed output URLs.
|
|
23
23
|
const fileError = error;
|
|
24
|
-
if (fileError && typeof fileError.code === 'string' && typeof fileError.syscall === 'string')
|
|
25
|
-
|
|
24
|
+
if (fileError && typeof fileError.code === 'string' && typeof fileError.syscall === 'string') {
|
|
25
|
+
const code = /^[A-Z0-9_]+$/i.test(fileError.code) ? fileError.code : 'UNKNOWN';
|
|
26
|
+
const syscall = /^[a-z0-9_]+$/i.test(fileError.syscall) ? ` (${fileError.syscall})` : '';
|
|
27
|
+
return `file_error:${code}${syscall}`;
|
|
28
|
+
}
|
|
26
29
|
const message = error instanceof Error ? error.message : 'step_failed';
|
|
27
30
|
return containsSensitiveText(message) ? 'step_failed:外部错误详情未持久化,避免泄露敏感信息' : scrub(message, secret);
|
|
28
31
|
}
|
package/dist/src/mcp/server.js
CHANGED
|
@@ -15,7 +15,7 @@ import { SpeechTools, transcribeInputSchema, cloneInputSchema } from '../speech/
|
|
|
15
15
|
import { trimMedia } from '../acquire/trim.js';
|
|
16
16
|
import { ACCOUNT_URL, ERROR_GUIDANCE, POLL_AFTER_SECONDS, LARGE_AMOUNT_CREDITS, LARGE_BALANCE_RATIO, errorGuidance } from './guidance.js';
|
|
17
17
|
export const DEFAULT_BASE_URL = 'https://api.zenaigc.com/api/v1';
|
|
18
|
-
export const CLIENT_VERSION = '0.1.
|
|
18
|
+
export const CLIENT_VERSION = '0.1.5';
|
|
19
19
|
const inputSchema = z.object({
|
|
20
20
|
job: jobSchema, reference: z.string().min(1),
|
|
21
21
|
output: z.object({ duration_seconds: z.number().int(), resolution: z.enum(['480P', '720P', '1080P']), ratio: z.string(), seed: z.number().int().optional() }),
|
|
@@ -30,7 +30,7 @@ function effectiveAvailableCredits(me) {
|
|
|
30
30
|
return Math.min(me.credits_available, ...(me.daily_credit_limit === null ? [] : [Math.max(0, me.daily_credit_limit - me.used_today)]), ...(me.total_credit_limit === null ? [] : [Math.max(0, me.total_credit_limit - me.used_total)]));
|
|
31
31
|
}
|
|
32
32
|
const GETTING_STARTED = {
|
|
33
|
-
examples: ['生成一张雨后街头的图片', '
|
|
33
|
+
examples: ['生成一张雨后街头的图片', '用这个链接拆解二创一段短视频', '把这段录音转成文字'],
|
|
34
34
|
billing_rule: '报价免费,确认后才扣积分;失败退款以任务查询结果为准。',
|
|
35
35
|
};
|
|
36
36
|
function refundText(state) {
|
|
@@ -285,10 +285,14 @@ export function createServer(engine, socialOptions = {}, speechOptions = {}) {
|
|
|
285
285
|
}
|
|
286
286
|
if (result.status === 'failed') {
|
|
287
287
|
const detail = (await failure(new Error(attempt?.rejected_code ?? result.error ?? 'step_failed'), engine.tokens)).structuredContent;
|
|
288
|
+
const fileHint = detail.code === 'file_error' && result.error?.startsWith('file_error:') ? `(${result.error.slice('file_error:'.length)})` : '';
|
|
289
|
+
const reason = `${detail.message}${fileHint}`;
|
|
288
290
|
const status = attempt?.status === 'cancelled' ? 'cancelled' : 'failed';
|
|
289
|
-
const
|
|
290
|
-
|
|
291
|
-
|
|
291
|
+
const uncharged = (!attempt && !result.charge_notice) || attempt?.state === 'rejected';
|
|
292
|
+
const refund_state = uncharged ? 'uncharged' : (attempt?.refund_state ?? 'unknown');
|
|
293
|
+
const refund = uncharged ? '本次未产生扣费,无需等待退款。' : refundText(attempt?.refund_state);
|
|
294
|
+
return { ...result, result_summary: { status, reason, refund_state, refund_message: refund },
|
|
295
|
+
markdown: `${status === 'cancelled' ? '生成已取消' : '生成未完成'}:${reason}\n\n${refund}${result.charge_notice ? `\n\n${result.charge_notice}:预算已保留。${errorGuidance('outcome_unknown').next}` : ''}`,
|
|
292
296
|
next_action: result.charge_notice ? errorGuidance('outcome_unknown').next : detail.next_action,
|
|
293
297
|
};
|
|
294
298
|
}
|
|
@@ -302,13 +306,13 @@ export function createServer(engine, socialOptions = {}, speechOptions = {}) {
|
|
|
302
306
|
inputSchema: transcribeInputSchema.shape,
|
|
303
307
|
}, guarded(input => speech.transcribe(input)));
|
|
304
308
|
server.registerTool('clone_voice', {
|
|
305
|
-
description: '
|
|
309
|
+
description: '使用用户明确同意的本地音频样本训练定制音色。必须显式传入 consent_confirmed:true;≤10MB,建议14–30秒。训练不启用音色,付费启用另需报价和批准。相同参数重试可续查。',
|
|
306
310
|
inputSchema: cloneInputSchema.shape,
|
|
307
311
|
}, guarded(input => speech.clone(input)));
|
|
308
|
-
server.registerTool('list_voices', { description: '
|
|
312
|
+
server.registerTool('list_voices', { description: '查询当前账户定制音色及 training、ready、active、failed、expired 状态;不启用、不收费。', inputSchema: {} }, guarded(() => speech.list()));
|
|
309
313
|
const prompts = [
|
|
310
314
|
{ name: 'generate_media', title: '生成图片或视频', text: '请帮我生成图片或视频:先 list_models,再 quote_generation 免费报价。本地素材上传前取得同意;一次性确认模型、关键参数、上传文件数及积分后,携带 requestDigest 调用 run_generation;按 poll_after_seconds 等待后在同一目录 get_generation,并展示输出。' },
|
|
311
|
-
{ name: 'replicate_video', title: '
|
|
315
|
+
{ name: 'replicate_video', title: '拆解二创短视频', text: '请拆解二创我提供的短视频:链接先 fetch_social_post,本地文件直接 analyze_reference;必要时选段并 trim_media。展示素材并确认最终属性后 import_assets,再 plan_job;一次合并确认模型、关键参数、上传文件数及积分后 execute_job,按 poll_after_seconds 在同一目录 get_job,展示输出。' },
|
|
312
316
|
{ name: 'check_setup', title: '检查安装与账户', text: `请检查 Zenmcp 安装和账户:环境异常时运行 zenmcp-doctor,随后 account_status 查询积分与客户端版本。缺少或无效的 Key 请引导用户前往 ${ACCOUNT_URL} 创建,写入 MCP 客户端配置 env.ZENMCP_TOKEN 后重新加载;绝不在聊天中索取 Key。` },
|
|
313
317
|
];
|
|
314
318
|
for (const prompt of prompts)
|
package/dist/src/speech/tools.js
CHANGED
|
@@ -179,6 +179,6 @@ export class SpeechTools {
|
|
|
179
179
|
}
|
|
180
180
|
async list() {
|
|
181
181
|
const list = { voices: (await this.gateway.listVoices()).voices.map(safeVoice) };
|
|
182
|
-
return { ...list, markdown: list.voices.length ? list.voices.map(v => `- ${v.name}(${v.id}):${v.status}`).join('\n') : '
|
|
182
|
+
return { ...list, markdown: list.voices.length ? list.voices.map(v => `- ${v.name}(${v.id}):${v.status}`).join('\n') : '当前账户暂无定制音色。' };
|
|
183
183
|
}
|
|
184
184
|
}
|
package/package.json
CHANGED
package/skills/zenmcp/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: zenmcp
|
|
3
|
-
description:
|
|
3
|
+
description: 用户需要生图、生视频、拆解二创短视频、录音识别、标准语音合成或进行 ZenMCP 环境配置自检时使用。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# ZenMCP
|
|
@@ -11,12 +11,12 @@ description: 用户需要生图、生视频、复刻短视频、录音识别、
|
|
|
11
11
|
|
|
12
12
|
- 直出生成:`list_models` → `quote_generation` → 展示报价并获得用户明确批准的积分 → `run_generation` → `get_generation`。
|
|
13
13
|
- 每次生成使用新的空目录。本地素材上传前须获得用户同意,并传 `consent_confirmed: true`;提交时携带报价的 `requestDigest`。
|
|
14
|
-
-
|
|
14
|
+
- 视频拆解二创:`fetch_social_post` 或用户提供的本地视频 → `analyze_reference` → 用户确认最终素材及属性后 `import_assets(confirmed: true)` → `plan_job` 报价 → 获批后 `execute_job` → `get_job`;修改走 `revise_job`。
|
|
15
15
|
- 分享链接先调用 `fetch_social_post`,每帖使用新的空目录,同一任务不重复抓取同一链接。本地视频跳过抓取,直接分析;抓取与分析无需用户确认。
|
|
16
16
|
- 视频超过约 30 秒或报价提示时长限制时,先征求用户同意保留的片段,再用 `trim_media` 截取并分析截取后的文件。
|
|
17
17
|
- 图集先展示图片,由用户确认哪些是产品或模特素材。最终素材及属性确认前不得调用 `import_assets`。
|
|
18
18
|
- 录音识别:先取得本地音视频上传同意,再调用 `transcribe_media`(单次最长 30 分钟,当前服务端使用每日次数限额)。输出 `transcript.json`,相同参数可恢复未完成任务。
|
|
19
|
-
- 标准语音合成:`list_models` → 选择 `doubao-seed-tts-2.0` → `quote_generation` → 用户批准积分 → `run_generation` → `get_generation
|
|
19
|
+
- 标准语音合成:`list_models` → 选择 `doubao-seed-tts-2.0` → `quote_generation` → 用户批准积分 → `run_generation` → `get_generation`。定制音色暂不开放。
|
|
20
20
|
- 额度查询:用只读工具 `account_status` 查询。
|
|
21
21
|
|
|
22
22
|
## 展示与确认
|
|
@@ -35,8 +35,8 @@ description: 用户需要生图、生视频、复刻短视频、录音识别、
|
|
|
35
35
|
- `plan_job` 后先原样展示返回的完整 `markdown`(分段、素材角色与属性、输出规格、预算明细及警告),随后用 `zenmcp-budget-confirm`,data 为 `{ confirmation, planDigest, directory, account_url }`。两者合为一次确认,不额外再问;当前 `confirmation` 只有总预算与重试预留,不得从设计示例编造分段、素材或余额。
|
|
36
36
|
- `list_models` 用 `zenmcp-model-picker`,data 为 `{ medium, models: [{ capability, label, medium, price_hint, highlights }] }`;`account_status` 用 `zenmcp-account`,data 为其结果加 `account_url`;安装与配置引导用 `zenmcp-install-checklist`,Key 不进卡片。
|
|
37
37
|
- **取用方式**:每个会话先调用一次 `widget_list_templates`。列表里有以上 id(用户手动保存的可能带后缀,按 `zenmcp-` 前缀匹配)就用 `widget_show({ template, data })`。没有时,征得用户同意后把 `widgets/<id>/` 整个目录一次性复制到 SuperOne 用户模板目录(stable 为 `~/.superone/widget/`,alpha 为 `~/.superone/alpha/widget/`),再查一次列表。仍然没有(Agent 与 SuperOne 桌面不在同一台机器)时,读取 `widgets/<id>/widget.html` 原文作为 `widget_code` 并照样传 `data`,不得改写 HTML。
|
|
38
|
-
- **按钮消息即用户答复**:卡片按钮以用户身份发送固定文字。收到“确认付费生成:…批准 N 积分。requestDigest=…,directory
|
|
39
|
-
- **结果展示**:生成图片用 `@native/image-gallery`,视频用 `@native/video-gallery`,data 为 `{ images | videos: [{ path }], prompt, params: { 模型, 关键参数, 实扣积分 }, warnings }`;实扣积分取 `result_summary.charged_credits
|
|
38
|
+
- **按钮消息即用户答复**:卡片按钮以用户身份发送固定文字。收到“确认付费生成:…批准 N 积分。requestDigest=…,directory=…”或“确认执行拆解二创任务,批准 N 积分。planDigest=…,directory=…”才算批准,按其中的积分和摘要调用付费工具。“把参数修改为…然后重新报价”:重新 `quote_generation` 并展示新卡。“取消这次付费,不要扣费。”:结束,不调用付费工具。“本次任务 N 积分内不用再逐次确认…”:按上文免再问预算处理。未收到确认前不得调用付费工具。
|
|
39
|
+
- **结果展示**:生成图片用 `@native/image-gallery`,视频用 `@native/video-gallery`,data 为 `{ images | videos: [{ path }], prompt, params: { 模型, 关键参数, 实扣积分 }, warnings }`;实扣积分取 `result_summary.charged_credits`。拆解二创视频在 `warnings` 中加入“服装与身份需人工验收”。报告和多份文件用 `@native/files-previewer`。失败时不展示图集,按 `result_summary.reason` 与 `refund_message` 说明。
|
|
40
40
|
- **远程会话**:若展示时报“文件不存在”(Agent 在服务器上),把输出文件复制到 `$SUPERONE_SESSION_DIR/agent/<生成目录名>/`,用新路径展示;原生成目录保留不动,续查依赖它。
|
|
41
41
|
- 有客户端提供的选项式提问工具时,用它呈现模型、参数和片段等选择。
|
|
42
42
|
- 工具不存在时,按通用方式展示 Markdown 图片或文件路径,不调用不存在的工具。
|
|
@@ -26,7 +26,7 @@ pair($('reserve'),'重试预留',`${display(view.reserve)} 积分(已含在总
|
|
|
26
26
|
(view.segments ?? []).forEach(s => pair($('segments'),s.label,`${display(s.credits)} 积分`));
|
|
27
27
|
if (view.assets?.length) $('assets').append(node('label','素材'),node('p',view.assets.join('、')));
|
|
28
28
|
if (view.sufficient === false) { $('confirm').textContent = '充值'; $('confirm').disabled = !view.accountUrl; $('confirm').onclick = () => account(view.accountUrl); }
|
|
29
|
-
else { $('confirm').textContent = `确认执行 ${display(view.total)} 积分 \u2197`; $('confirm').onclick = () => prompt(
|
|
29
|
+
else { $('confirm').textContent = `确认执行 ${display(view.total)} 积分 \u2197`; $('confirm').onclick = () => prompt(`确认执行拆解二创任务,批准 ${display(view.total)} 积分。planDigest=${view.digest},directory=${view.directory}`); }
|
|
30
30
|
$('cancel').onclick = () => prompt('取消这次付费,不要扣费。');
|
|
31
31
|
|
|
32
32
|
</script>
|