aidrama-cli 1.0.0

package/README.md

@@ -0,0 +1,135 @@
+# ai-drama agent CLI（Node 版）
+
+用命令行驱动 **AI 短剧 Agent 流程**的基础能力。**仅依赖 Node 内置能力**（全局 `fetch`，无需 `npm install`），需 **Node >= 18**，尽量通用。
+
+## 运行
+
+无需安装依赖，直接用 Node 运行：
+
+```bash
+node cli/aidrama.js --help
+# 或加可执行权限后直接运行（首行已是 #!/usr/bin/env node）
+chmod +x cli/aidrama.js
+./cli/aidrama.js --help
+```
+
+注册为全局命令（可选，零依赖）：
+
+```bash
+cd cli && npm link      # 之后可直接用 `aidrama ...`
+# 或手动软链： ln -s "$PWD/cli/aidrama.js" /usr/local/bin/aidrama
+```
+
+## 配置与凭据
+
+优先级：命令行参数 > 环境变量 > 配置文件 > 默认值。
+
+| 项 | 命令行 | 环境变量 | 默认 |
+|---|---|---|---|
+| 后端基址 | `--base-url` | `AI_DRAMA_BASE_URL` | `http://localhost:38000` |
+| 凭据 token | （登录后自动保存） | `AI_DRAMA_TOKEN` | 配置文件 |
+| 配置文件 | — | `AI_DRAMA_CLI_CONFIG` | `~/.ai-drama-cli.json` |
+
+```bash
+node cli/aidrama.js config set-base-url http://localhost:38000
+node cli/aidrama.js config show
+```
+
+## 鉴权（飞书登录为主，兼容密码登录）
+
+### 飞书登录（推荐）
+
+飞书 OAuth 的回调地址固定指向前端页面，CLI 采用「manual-code」流：
+
+```bash
+# 1) 打印授权链接
+node cli/aidrama.js auth feishu
+#    在浏览器打开链接 → 完成飞书授权 → 浏览器跳转到回调页（URL 带 code）
+
+# 2) 用回调里的 code 换取 token（state 用上一步打印的）
+node cli/aidrama.js auth feishu --code <code> --state <state>
+#    或直接把整个回调 URL 丢进来，自动解析 code/state：
+node cli/aidrama.js auth feishu --redirect-url 'http://localhost:5193/feishu/callback?code=xxx&state=yyy'
+```
+
+> 需后端启用飞书登录（`AUTH_FEISHU_ENABLED=true` 且配置 FEISHU_APP_ID/SECRET/REDIRECT_URI）。用 `auth methods` 可查当前启用了哪些登录方式。
+
+### 用户名/密码登录（兼容，便于自动化/调试）
+
+```bash
+node cli/aidrama.js auth login -u admin -p admin123
+node cli/aidrama.js auth me        # 查看当前用户、角色与权限
+node cli/aidrama.js auth logout
+```
+
+## Agent 流程能力
+
+```bash
+# 项目
+node cli/aidrama.js projects list
+node cli/aidrama.js projects create "我的项目"
+
+# 渠道（仅列启用的；可按能力过滤）
+node cli/aidrama.js providers list --capability text     # text | image | video
+
+# 原文内容（pipeline 入口）
+node cli/aidrama.js content set 2 --file novel.txt        # 或 --text "..."
+node cli/aidrama.js content get 2
+
+# 元素推理 / 列表（--wait 触发后轮询到完成）
+node cli/aidrama.js elements run 2 --wait
+node cli/aidrama.js elements list 2
+
+# 图片生成（不传 --element-id = 批量基础态；传则单个/状态图）
+node cli/aidrama.js images run 2 --wait
+node cli/aidrama.js images run 2 --element-id 333 --provider-id 5 --wait
+
+# 剧集拆解
+node cli/aidrama.js episodes run 2 --wait
+node cli/aidrama.js episodes list 2
+
+# 分镜策划
+node cli/aidrama.js storyboards run 2 --episode-id 10 --wait
+node cli/aidrama.js storyboards list 2 --episode-id 10
+
+# 视频生成
+node cli/aidrama.js videos run 2 --storyboard-ids 67 68 69 --provider-id 5 --gen-mode multi_ref --wait
+node cli/aidrama.js videos list 2
+
+# 直连视频渠道生视频（默认首个启用视频渠道, 如 seedance 2.0）—— 纯提示词→视频, 不依赖分镜
+node cli/aidrama.js videos raw --prompt "一只橘猫在窗台伸懒腰，暖阳，电影质感" --duration 5 --aspect-ratio 9:16 --wait
+# 多模态参考（图/视频/音频）；音频不能单独, 须与图或视频同传
+node cli/aidrama.js videos raw --prompt "她转身微笑" --ref-images https://.../a.png --wait
+node cli/aidrama.js videos raw --prompt "从A过渡到B" --gen-mode first_last_frame --ref-images https://.../first.png https://.../last.png --wait
+node cli/aidrama.js videos raw --prompt "镜头缓缓推进" --ref-videos https://.../ref.mp4 --aspect-ratio 9:16 --wait
+node cli/aidrama.js videos raw --prompt "角色说话" --ref-images https://.../face.png --ref-audios https://.../voice.mp3 --wait
+# --out: 自动等待生成完成并把成片下载到本地
+node cli/aidrama.js videos raw --prompt "夜雨霓虹的赛博街道" --aspect-ratio 16:9 --out ./out.mp4
+
+# 会话状态
+node cli/aidrama.js session status <session_id>
+node cli/aidrama.js session wait <session_id> --interval 3
+```
+
+## 通用透传（最大化通用性）
+
+任何后端接口都能直接调（自动带 token）：
+
+```bash
+node cli/aidrama.js api GET  /api/agent/projects/2/elements
+node cli/aidrama.js api POST /api/agent/elements/run --data '{"project_id":2}'
+node cli/aidrama.js api GET  /api/providers --query capability=image
+```
+
+## 输出
+
+默认美化 JSON；加 `--json` 输出单行紧凑 JSON，便于管道处理（配合 `jq` 等）：
+
+```bash
+node cli/aidrama.js --json projects list | jq '.[].id'
+```
+
+## 退出码
+
+- `0` 成功
+- 非 0：HTTP 错误（打印 `HTTP <code>: <detail>`）、连接失败、未登录等

package/aidrama.js

@@ -0,0 +1,375 @@
+#!/usr/bin/env node
+'use strict';
+/**
+ * ai-drama agent CLI（Node 版）—— 用命令行驱动 AI 短剧 Agent 流程的基础能力。
+ *
+ * 特点：
+ *   - 仅用 Node 内置能力（全局 fetch / fs / os / path），零三方依赖，需 Node >= 18。
+ *   - 鉴权以「飞书登录」为主（manual-code 流），同时兼容后端用户名/密码登录，便于自动化/调试。
+ *   - 覆盖 agent 流程基础能力：项目、内容上传、元素推理、图片生成、剧集拆解、分镜、视频、会话轮询、渠道。
+ *   - 内置通用透传命令 `api`，可直接调任意后端接口，最大化通用性。
+ *
+ * 配置与凭据（优先级：命令行 > 环境变量 > 配置文件 > 默认）：
+ *   - base_url：--base-url / 环境 AI_DRAMA_BASE_URL / 配置文件 / 默认 http://localhost:38000
+ *   - token：  环境 AI_DRAMA_TOKEN / 配置文件（登录后自动写入）
+ *   - 配置文件：环境 AI_DRAMA_CLI_CONFIG / 默认 ~/.ai-drama-cli.json
+ */
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const DEFAULT_BASE_URL = 'http://localhost:38000';
+const CONFIG_PATH = process.env.AI_DRAMA_CLI_CONFIG || path.join(os.homedir(), '.ai-drama-cli.json');
+
+// ---------------- 配置 / 凭据 ----------------
+function loadCfg() {
+  try { return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8')); } catch { return {}; }
+}
+function saveCfg(cfg) {
+  try {
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2));
+    try { fs.chmodSync(CONFIG_PATH, 0o600); } catch { /* 凭据文件权限收紧，失败忽略 */ }
+  } catch (e) { eprint(`警告：无法写入配置 ${CONFIG_PATH}: ${e.message}`); }
+}
+function getBase(flags) {
+  return (flags['base-url'] || process.env.AI_DRAMA_BASE_URL || loadCfg().base_url || DEFAULT_BASE_URL)
+    .replace(/\/+$/, '');
+}
+function getToken() { return process.env.AI_DRAMA_TOKEN || loadCfg().token || null; }
+function setToken(t) { const c = loadCfg(); c.token = t; saveCfg(c); }
+
+// ---------------- 输出 ----------------
+function eprint(...a) { console.error(...a); }
+function out(obj, jsonOut) {
+  if (obj !== null && typeof obj === 'object') console.log(JSON.stringify(obj, null, jsonOut ? 0 : 2));
+  else console.log(obj);
+}
+function fail(msg) { eprint(msg); process.exit(1); }
+function num(v) { return v === undefined || v === null ? undefined : Number(v); }
+
+// ---------------- HTTP ----------------
+async function request(method, base, p, { token, body, params } = {}) {
+  let url = base.replace(/\/+$/, '') + '/' + String(p).replace(/^\/+/, '');
+  if (params) {
+    const q = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+      if (v === undefined || v === null) continue;
+      q.append(k, Array.isArray(v) ? v.join(',') : String(v));
+    }
+    const s = q.toString();
+    if (s) url += '?' + s;
+  }
+  const headers = { 'Content-Type': 'application/json', 'Accept': 'application/json' };
+  if (token) headers['Authorization'] = 'Bearer ' + token;
+  let resp;
+  try {
+    resp = await fetch(url, {
+      method: method.toUpperCase(),
+      headers,
+      body: body !== undefined && body !== null ? JSON.stringify(body) : undefined,
+    });
+  } catch (e) { fail(`连接失败 ${url}: ${e.message}`); }
+  const text = await resp.text();
+  let data;
+  try { data = text ? JSON.parse(text) : {}; } catch { data = text; }
+  if (!resp.ok) {
+    if (resp.status === 401) fail('HTTP 401 未授权：token 缺失或过期，请重新 `aidrama auth feishu` / `auth login`');
+    let detail = (data && typeof data === 'object' && 'detail' in data) ? data.detail : (text || resp.statusText);
+    if (typeof detail === 'object') detail = JSON.stringify(detail, null, 0);
+    fail(`HTTP ${resp.status}: ${detail}`);
+  }
+  return data;
+}
+function authToken() {
+  const t = getToken();
+  if (!t) fail('未登录，请先执行 `aidrama auth feishu` 或 `aidrama auth login -u <user> -p <pass>`');
+  return t;
+}
+function authRequest(method, base, p, opt = {}) { return request(method, base, p, { token: authToken(), ...opt }); }
+
+// 下载文件到本地（用于 --out：把成片直接存到本地）
+async function downloadFile(url, dest) {
+  let resp;
+  try { resp = await fetch(url); } catch (e) { fail(`下载失败 ${url}: ${e.message}`); }
+  if (!resp.ok) fail(`下载失败 HTTP ${resp.status}: ${url}`);
+  const buf = Buffer.from(await resp.arrayBuffer());
+  fs.writeFileSync(dest, buf);
+  return { path: path.resolve(dest), bytes: buf.length };
+}
+
+// ---------------- session 轮询 ----------------
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function waitSession(base, sid, interval = 3, maxWait = 1800) {
+  const deadline = Date.now() + maxWait * 1000;
+  let last = null;
+  while (Date.now() < deadline) {
+    const st = await authRequest('GET', base, `/api/agent/sessions/${sid}/status`);
+    const report = st.validation_report || {};
+    const prog = report.progress;
+    let line = `  · status=${st.status}`;
+    if (prog) line += ` progress=${prog.done}/${prog.total}`;
+    if (line !== last) { eprint(line); last = line; }
+    if (st.status === 'completed' || st.status === 'failed') return st;
+    await sleep(interval * 1000);
+  }
+  eprint('  · 轮询超时，请稍后用 `aidrama session status` 查看');
+  return { status: 'timeout', session_id: sid };
+}
+async function maybeWait(flags, base, res) {
+  const sid = res && res.session_id;
+  const wantOut = !!flags.out;            // --out 需要最终 video_url，故隐含等待完成
+  if ((flags.wait || wantOut) && sid) {
+    eprint(`已触发 session=${sid}，轮询中…`);
+    const st = await waitSession(base, sid);
+    if (wantOut) {
+      const url = st && st.validation_report && st.validation_report.video_url;
+      if (url) {
+        const info = await downloadFile(url, flags.out);
+        eprint(`已下载成片到 ${info.path}（${(info.bytes / 1048576).toFixed(2)} MB）`);
+        st.saved_to = info.path;
+      } else {
+        eprint('注意：会话结果无 video_url，--out 仅适用于产出单个视频的命令（如 videos raw）。');
+      }
+    }
+    out(st, flags.json);
+  } else out(res, flags.json);
+}
+
+// ---------------- 参数解析 ----------------
+const BOOL_FLAGS = new Set(['json', 'wait', 'help']);
+const MULTI_FLAGS = new Set(['storyboard-ids', 'query', 'ref-images', 'ref-videos', 'ref-audios']);
+const ALIAS = { '-u': '--username', '-p': '--password', '-h': '--help' };
+function parseArgs(argv) {
+  const positionals = [];
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    let a = argv[i];
+    if (ALIAS[a]) a = ALIAS[a];
+    if (a.startsWith('--')) {
+      let key = a.slice(2);
+      if (key.includes('=')) { const idx = key.indexOf('='); flags[key.slice(0, idx)] = key.slice(idx + 1); continue; }
+      if (BOOL_FLAGS.has(key)) { flags[key] = true; continue; }
+      if (MULTI_FLAGS.has(key)) {
+        const vals = [];
+        while (i + 1 < argv.length && !argv[i + 1].startsWith('--')) vals.push(argv[++i]);
+        flags[key] = vals;
+        continue;
+      }
+      flags[key] = argv[++i];
+    } else positionals.push(a);
+  }
+  return { positionals, flags };
+}
+
+const USAGE = `aidrama —— AI 短剧 Agent 流程命令行（飞书登录鉴权，尽量通用）
+
+用法: aidrama [--base-url URL] [--json] <分组> <命令> [参数...]
+
+鉴权:
+  auth methods                                查询后端启用的登录方式
+  auth login -u <user> -p <pass>              用户名/密码登录（兼容）
+  auth feishu [--code C --state S | --redirect-url URL]   飞书登录
+  auth me                                     当前用户(含 roles/permissions)
+  auth logout                                 清除本地 token
+配置:
+  config show
+  config set-base-url <url>
+项目/渠道/内容:
+  projects list | projects create <name>
+  providers list [--capability text|image|video]
+  content get <pid> | content set <pid> [--text T | --file F] [--content-type novel]
+Agent 步骤(--wait 触发后轮询到完成):
+  elements run <pid> [--provider-id N] [--wait] | elements list <pid>
+  images run <pid> [--element-id N] [--state-id N] [--provider-id N] [--wait]
+  episodes run <pid> [--provider-id N] [--wait] | episodes list <pid>
+  storyboards run <pid> [--episode-id N] [--provider-id N] [--wait] | storyboards list <pid> [--episode-id N]
+  videos run <pid> --storyboard-ids A B C --provider-id N [--gen-mode multi_ref] [--resolution R] [--wait] | videos list <pid>
+  videos raw --prompt "..." [--provider-id N] [--duration 5] [--aspect-ratio 9:16] [--resolution 720p] [--ref-images URL...] [--ref-videos URL...] [--ref-audios URL...] [--gen-mode multi_ref] [--idempotency-key K] [--wait] [--out FILE]   直连视频渠道(默认 seedance 2.0)生视频, 支持多模态参考(图/视频/音频); --out 自动等待并把成片下载到本地
+会话:
+  session status <sid> | session wait <sid> [--interval 3]
+通用透传:
+  api <GET|POST|PUT|DELETE> <path> [--data JSON] [--query k=v ...]
+`;
+
+// ---------------- 命令实现 ----------------
+async function dispatch({ positionals, flags }) {
+  const [group, cmd] = positionals;
+  const base = getBase(flags);
+  const A = positionals; // 位置参数简写
+
+  if (group === 'api') {
+    const method = A[1], pth = A[2];
+    if (!method || !pth) fail('用法: aidrama api <GET|POST|PUT|DELETE> <path> [--data JSON] [--query k=v ...]');
+    const body = flags.data ? JSON.parse(flags.data) : undefined;
+    const params = {};
+    for (const kv of (flags.query || [])) { const i = kv.indexOf('='); if (i > 0) params[kv.slice(0, i)] = kv.slice(i + 1); }
+    return out(await authRequest(method, base, pth, { body, params: Object.keys(params).length ? params : undefined }), flags.json);
+  }
+
+  switch (`${group} ${cmd}`) {
+    // auth
+    case 'auth methods':
+      return out(await request('GET', base, '/api/auth/methods'), flags.json);
+    case 'auth login': {
+      if (!flags.username || !flags.password) fail('用法: aidrama auth login -u <user> -p <pass>');
+      const res = await request('POST', base, '/api/auth/login',
+        { body: { username: flags.username, password: flags.password } });
+      if (!res.access_token) fail('登录失败：' + JSON.stringify(res));
+      setToken(res.access_token);
+      eprint('登录成功，token 已保存。');
+      return out({ ok: true, token_prefix: res.access_token.slice(0, 12) + '…' }, flags.json);
+    }
+    case 'auth feishu': {
+      let code = flags.code, state = flags.state;
+      if (flags['redirect-url']) {
+        const u = new URL(flags['redirect-url']);
+        code = code || u.searchParams.get('code');
+        state = state || u.searchParams.get('state');
+      }
+      if (!code) {
+        const info = await request('GET', base, '/api/auth/feishu/authorize-url');
+        eprint('请在浏览器打开下面的飞书授权链接，完成授权后会跳转到回调页：\n');
+        eprint('  ' + (info.authorize_url || '(后端未配置飞书登录)') + '\n');
+        eprint('授权后，从回调地址取出 code，再执行：');
+        eprint(`  aidrama auth feishu --code <code> --state ${info.state || ''}`);
+        eprint('或直接粘贴整个回调 URL：');
+        eprint("  aidrama auth feishu --redirect-url '<回调完整URL>'");
+        return out({ authorize_url: info.authorize_url, state: info.state }, flags.json);
+      }
+      const res = await request('POST', base, '/api/auth/feishu/callback', { body: { code, state } });
+      if (!res.access_token) fail('飞书登录失败：' + JSON.stringify(res));
+      setToken(res.access_token);
+      eprint('飞书登录成功，token 已保存。');
+      return out({ ok: true, token_prefix: res.access_token.slice(0, 12) + '…' }, flags.json);
+    }
+    case 'auth me':
+      return out(await authRequest('GET', base, '/api/auth/me'), flags.json);
+    case 'auth logout': {
+      const c = loadCfg(); delete c.token; saveCfg(c);
+      return eprint('已登出，本地 token 已清除。');
+    }
+
+    // config
+    case 'config show': {
+      const c = loadCfg();
+      if (c.token) c.token = c.token.slice(0, 12) + '…';
+      return out({ config_path: CONFIG_PATH, base_url: base, ...c }, flags.json);
+    }
+    case 'config set-base-url': {
+      if (!A[2]) fail('用法: aidrama config set-base-url <url>');
+      const c = loadCfg(); c.base_url = A[2].replace(/\/+$/, ''); saveCfg(c);
+      return eprint(`base_url 已设为 ${c.base_url}`);
+    }
+
+    // projects
+    case 'projects list':
+      return out(await authRequest('GET', base, '/api/projects'), flags.json);
+    case 'projects create':
+      if (!A[2]) fail('用法: aidrama projects create <name>');
+      return out(await authRequest('POST', base, '/api/projects', { body: { name: A[2] } }), flags.json);
+
+    // providers
+    case 'providers list':
+      return out(await authRequest('GET', base, '/api/providers',
+        { params: { capability: flags.capability } }), flags.json);
+
+    // content
+    case 'content get':
+      return out(await authRequest('GET', base, `/api/agent/projects/${reqId(A[2])}/content`), flags.json);
+    case 'content set': {
+      let text = flags.text;
+      if (flags.file) text = fs.readFileSync(flags.file, 'utf8');
+      if (text === undefined) fail('请用 --text 或 --file 提供原文内容');
+      return out(await authRequest('POST', base, `/api/agent/projects/${reqId(A[2])}/content`,
+        { body: { original_text: text, content_type: flags['content-type'] || 'novel' } }), flags.json);
+    }
+
+    // elements
+    case 'elements run':
+      return maybeWait(flags, base, await authRequest('POST', base, '/api/agent/elements/run',
+        { body: { project_id: reqId(A[2]), provider_id: num(flags['provider-id']) } }));
+    case 'elements list':
+      return out(await authRequest('GET', base, `/api/agent/projects/${reqId(A[2])}/elements`), flags.json);
+
+    // images
+    case 'images run':
+      return maybeWait(flags, base, await authRequest('POST', base, '/api/agent/images/run',
+        { body: { project_id: reqId(A[2]), element_id: num(flags['element-id']),
+                  provider_id: num(flags['provider-id']), state_id: num(flags['state-id']) } }));
+
+    // episodes
+    case 'episodes run':
+      return maybeWait(flags, base, await authRequest('POST', base, '/api/agent/episodes/run',
+        { body: { project_id: reqId(A[2]), provider_id: num(flags['provider-id']) } }));
+    case 'episodes list':
+      return out(await authRequest('GET', base, `/api/agent/projects/${reqId(A[2])}/episodes`), flags.json);
+
+    // storyboards
+    case 'storyboards run':
+      return maybeWait(flags, base, await authRequest('POST', base, '/api/agent/storyboards/run',
+        { body: { project_id: reqId(A[2]), episode_id: num(flags['episode-id']),
+                  provider_id: num(flags['provider-id']) } }));
+    case 'storyboards list':
+      return out(await authRequest('GET', base, `/api/agent/projects/${reqId(A[2])}/storyboards`,
+        { params: { episode_id: num(flags['episode-id']) } }), flags.json);
+
+    // videos
+    case 'videos run': {
+      if (!flags['storyboard-ids'] || !flags['provider-id'])
+        fail('用法: aidrama videos run <pid> --storyboard-ids A B C --provider-id N');
+      return maybeWait(flags, base, await authRequest('POST', base, '/api/agent/videos/run',
+        { body: { project_id: reqId(A[2]), storyboard_ids: flags['storyboard-ids'].map(Number),
+                  provider_id: num(flags['provider-id']), gen_mode: flags['gen-mode'] || 'multi_ref',
+                  resolution: flags.resolution } }));
+    }
+    case 'videos list':
+      return out(await authRequest('GET', base, `/api/agent/projects/${reqId(A[2])}/videos`), flags.json);
+    case 'videos raw': {
+      if (!flags.prompt) fail('用法: aidrama videos raw --prompt "..." [--provider-id N] [--duration 5] [--aspect-ratio 9:16] [--resolution 720p] [--ref-images URL...] [--ref-videos URL...] [--ref-audios URL...] [--gen-mode multi_ref] [--negative-prompt "..."] [--idempotency-key K] [--wait] [--out FILE]');
+      const body = {
+        prompt: flags.prompt,
+        provider_id: num(flags['provider-id']),
+        project_id: num(flags['project-id']),
+        duration: flags.duration !== undefined ? Number(flags.duration) : undefined,
+        aspect_ratio: flags['aspect-ratio'],
+        resolution: flags.resolution,
+        ref_images: flags['ref-images'],
+        ref_videos: flags['ref-videos'],
+        ref_audios: flags['ref-audios'],
+        gen_mode: flags['gen-mode'],
+        negative_prompt: flags['negative-prompt'],
+        idempotency_key: flags['idempotency-key'],
+      };
+      return maybeWait(flags, base, await authRequest('POST', base, '/api/agent/videos/raw', { body }));
+    }
+
+    // session
+    case 'session status':
+      return out(await authRequest('GET', base, `/api/agent/sessions/${reqStr(A[2])}/status`), flags.json);
+    case 'session wait':
+      return out(await waitSession(base, reqStr(A[2]), Number(flags.interval) || 3), flags.json);
+  }
+  // 未匹配
+  eprint(`未知命令: ${group || ''} ${cmd || ''}`.trim());
+  eprint('\n' + USAGE);
+  process.exit(2);
+}
+
+function reqId(v) { if (v === undefined) fail('缺少 project_id 参数'); return Number(v); }
+function reqStr(v) { if (v === undefined) fail('缺少 session_id 参数'); return v; }
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const { positionals, flags } = parseArgs(argv);
+  if (flags.help || positionals.length === 0) { console.log(USAGE); return 0; }
+  await dispatch({ positionals, flags });
+  return 0;
+}
+
+main().catch((e) => {
+  if (e && e.code === 'EPIPE') process.exit(0); // 下游管道(head/jq)提前关闭：静默退出
+  eprint(e && e.stack ? e.stack : String(e));
+  process.exit(1);
+});
+// 下游管道关闭时 stdout 触发 EPIPE：静默退出，避免 traceback
+process.stdout.on('error', (e) => { if (e.code === 'EPIPE') process.exit(0); });

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "aidrama-cli",
+  "version": "1.0.0",
+  "description": "AI 短剧 Agent 流程命令行（飞书登录鉴权，零三方依赖，Node>=18）",
+  "bin": {
+    "aidrama": "aidrama.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "files": [
+    "aidrama.js",
+    "README.md"
+  ],
+  "private": false
+}