@pptalker/agent 1.0.2 → 1.0.4

package/dist/config.js

@@ -39,11 +39,27 @@ export function loadConfig(env = process.env) {
     if (!Number.isInteger(defaultSpeed) || defaultSpeed < 80 || defaultSpeed > 150) {
         throw new Error('PPTALKER_SPEED 必须为 80–150 的整数');
     }
+    // 字幕逐维可配；未设置时用后端默认（显示、字号 medium、白色、半透明底）。
+    const rawSubtitles = env.PPTALKER_SUBTITLES;
+    let defaultSubtitles = null;
+    if (rawSubtitles !== undefined && rawSubtitles !== '') {
+        if (!['true', 'false'].includes(rawSubtitles)) throw new Error('PPTALKER_SUBTITLES 只能是 true 或 false');
+        defaultSubtitles = rawSubtitles === 'true';
+    }
+    const pick = (name, allowed) => {
+        const value = (env[name] || '').trim().toLowerCase() || null;
+        if (value && !allowed.includes(value)) throw new Error(`${name} 只能是 ${allowed.join(' / ')}`);
+        return value;
+    };
+    const defaultSubtitleSize = pick('PPTALKER_SUBTITLE_SIZE', ['small', 'medium', 'large']);
+    const defaultSubtitleColor = pick('PPTALKER_SUBTITLE_COLOR', ['white', 'yellow', 'black', 'blue']);
+    const defaultSubtitleBg = pick('PPTALKER_SUBTITLE_BG', ['none', 'semi-transparent', 'solid']);
     const cacheDir = env.PPTALKER_RECOVERY_DIR === 'off' ? null
         : env.PPTALKER_RECOVERY_DIR || join(homedir(), '.pptalker-agent', 'recovery', 'v2');
     if (cacheDir && !isAbsolute(cacheDir)) throw new Error('PPTALKER_RECOVERY_DIR 必须为绝对路径或 off');
     return { apiBase: url.toString().replace(/\/+$/, ''), apiKey, waitSeconds, operationSeconds,
         cacheDir, defaultLanguage: env.PPTALKER_LANGUAGE || 'zh-CN', defaultStyle,
-        defaultVoice, defaultSpeed };
+        defaultVoice, defaultSpeed, defaultSubtitles, defaultSubtitleSize,
+        defaultSubtitleColor, defaultSubtitleBg };
 }
 export const CONFIG_HELP = '设置 PPTALKER_AGENT_API_BASE（独立 Agent endpoint）及 PPTALKER_API_KEY。';

package/dist/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { realpathSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -33,6 +34,11 @@ const RenderInput = z.object({
     voice: z.string().max(80).optional().describe('音色名称或 ID，可取 account 返回的 voices（标准音色）或 cloned_voices（克隆音色）。不传则用 PPTALKER_VOICE 或该语言默认音色。'),
     style: z.enum(['clean', 'bold']).optional(),
     speed: z.number().int().min(80).max(150).optional().describe('语速 80–150；不传则用 PPTALKER_SPEED（默认 100）。慢≈85，快≈120。'),
+    subtitles: z.boolean().optional().describe('是否显示字幕；不传则用 PPTALKER_SUBTITLES（默认显示）。'),
+    subtitle_size: z.enum(['small', 'medium', 'large']).optional().describe('字幕字号档位，默认 medium。'),
+    subtitle_color: z.enum(['white', 'yellow', 'black', 'blue']).optional().describe('字幕颜色，默认 white。'),
+    subtitle_bg: z.enum(['none', 'semi-transparent', 'solid']).optional()
+        .describe('字幕背景：none 无底 / semi-transparent 半透明黑底 / solid 实心黑底，默认 semi-transparent。'),
     video_title: z.string().max(200).optional().describe('视频标题；对应当前独立后端的 video_title 字段。'),
     is_public: z.boolean().default(false).describe('是否生成公开分享页；默认 false（私有，只给临时签名链接）。'),
     wait,
@@ -90,7 +96,20 @@ async function main() {
     console.error(`[pptalker-agent] v${PKG.version} 就绪`);
 }
 
-if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+// npx / node_modules/.bin 通过符号链接执行本文件，process.argv[1] 是链接路径，
+// 而 import.meta.url 已被 Node 解析成真实路径。必须 realpath 归一后再比较，
+// 否则直接运行为“静默退出”（exit 0、无任何输出），表现为 MCP 客户端 -32000。
+function isDirectRun() {
+    const entry = process.argv[1];
+    if (!entry) return false;
+    try {
+        return realpathSync(resolve(entry)) === realpathSync(fileURLToPath(import.meta.url));
+    } catch {
+        return false;
+    }
+}
+
+if (isDirectRun()) {
     main().catch(() => {
         console.error(`[pptalker-agent] 启动失败。${CONFIG_HELP}`);
         process.exitCode = 1;

package/dist/tools/render.js

@@ -103,7 +103,11 @@ export async function handleRender(client, cfg, input, extra = {}) {
                 voice: input.voice || cfg.defaultVoice || undefined,
                 style: input.style || cfg.defaultStyle,
                 speed: input.speed ?? cfg.defaultSpeed ?? 100,
-                video_title: input.video_title || '', is_public: input.is_public === true },
+                video_title: input.video_title || '', is_public: input.is_public === true,
+                subtitles: input.subtitles ?? cfg.defaultSubtitles ?? undefined,
+                subtitle_size: input.subtitle_size || cfg.defaultSubtitleSize || undefined,
+                subtitle_color: input.subtitle_color || cfg.defaultSubtitleColor || undefined,
+                subtitle_bg: input.subtitle_bg || cfg.defaultSubtitleBg || undefined },
         }), Math.min(120000, remaining()), extra.signal);
         const result = normalizeTask(raw, { ...context, submission: 'accepted' });
         context = result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pptalker/agent",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "独立 PPTalker Agent MCP：异步准备、讲稿确认、私有视频与可取消的短状态查询。",
   "keywords": [
     "mcp",

package/skills/pptalker-agent/SKILL.md

@@ -46,10 +46,14 @@ Key 从 https://www.pptalker.com/profile 获取，与网页端用的是同一个
 |---|---|---|---|
 | `PPTALKER_AGENT_API_BASE` | ✅ | — | `https://api.pptalker.com`。只填 origin，**不要带 `/api/v1/agent`**，带上会直接报配置错误 |
 | `PPTALKER_API_KEY` | ✅ | — | `pptk_live_` 开头的 key |
-| `PPTALKER_LANGUAGE` | — | `zh-CN` | 默认旁白语言，可被单次调用覆盖 |
+| `PPTALKER_LANGUAGE` | — | `zh-CN` | 默认旁白语言。接受 BCP-47（`zh-CN`）或友好名（`Chinese`/`中文`/`English`） |
 | `PPTALKER_STYLE` | — | `clean` | `clean` 或 `bold` |
 | `PPTALKER_VOICE` | — | 按语言取 | 全局默认音色。标准音色填名称或 ID，克隆音色填 `cloned_voices` 里的 `name` 或 `id` |
 | `PPTALKER_SPEED` | — | `100` | 全局默认语速，整数 80–150 |
+| `PPTALKER_SUBTITLES` | — | 显示 | 是否显示字幕，`true`/`false` |
+| `PPTALKER_SUBTITLE_SIZE` | — | `medium` | 字幕字号 `small`/`medium`/`large` |
+| `PPTALKER_SUBTITLE_COLOR` | — | `white` | 字幕颜色 `white`/`yellow`/`black`/`blue` |
+| `PPTALKER_SUBTITLE_BG` | — | `semi-transparent` | 字幕背景 `none`/`semi-transparent`/`solid` |
 | `PPTALKER_WAIT_SECONDS` | — | `30` | 仅 `wait=true` 时的客户端轮询预算，整数 10–45 |
 | `PPTALKER_OPERATION_SECONDS` | — | `180` | 单个新任务的总预算（上传 + 首次解析），整数 10–300 |
 | `PPTALKER_RECOVERY_DIR` | — | `~/.pptalker-agent/recovery/v2` | 本地恢复日志目录；填 `off` 关闭（关闭后中断任务只能靠用户自己记 id） |