@pippit-dev/cli 0.0.1

package/scripts/install.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+
+const crypto = require("crypto");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { isWindows, run } = require("./platform");
+const { installSkillsFromRoot } = require("./skills");
+
+const VERSION = require("../package.json").version.replace(/-.*$/, "");
+const REPO = "Pippit-dev/cli";
+const NAME = "pippit-cli";
+const ROOT = path.join(__dirname, "..");
+const BIN_DIR = path.join(ROOT, "bin");
+
+const PLATFORM_MAP = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+};
+
+const ARCH_MAP = {
+  x64: "amd64",
+  arm64: "arm64",
+};
+
+const platform = PLATFORM_MAP[process.platform];
+const arch = ARCH_MAP[process.arch];
+const archiveExt = isWindows ? ".zip" : ".tar.gz";
+const archiveName = `${NAME}-${VERSION}-${platform}-${arch}${archiveExt}`;
+const releaseURL = `https://github.com/${REPO}/releases/download/v${VERSION}/${archiveName}`;
+const dest = path.join(BIN_DIR, NAME + (isWindows ? ".exe" : ""));
+
+function download(url, destPath) {
+  const args = [
+    "--fail",
+    "--location",
+    "--silent",
+    "--show-error",
+    "--connect-timeout",
+    "10",
+    "--max-time",
+    "120",
+    "--max-redirs",
+    "3",
+    "--output",
+    destPath,
+  ];
+  if (isWindows) {
+    args.unshift("--ssl-revoke-best-effort");
+  }
+  args.push(url);
+  run("curl", args);
+}
+
+function expectedChecksum(name) {
+  const checksumsPath = path.join(ROOT, "checksums.txt");
+  if (!fs.existsSync(checksumsPath)) {
+    console.warn("[WARN] checksums.txt not found, skipping checksum verification");
+    return null;
+  }
+  for (const line of fs.readFileSync(checksumsPath, "utf8").split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    const idx = trimmed.indexOf("  ");
+    if (idx === -1) continue;
+    const hash = trimmed.slice(0, idx);
+    const file = trimmed.slice(idx + 2);
+    if (file === name) return hash;
+  }
+  throw new Error(`Checksum entry not found for ${name}`);
+}
+
+function verifyChecksum(filePath, expectedHash) {
+  if (!expectedHash) return;
+  const hash = crypto.createHash("sha256");
+  const fd = fs.openSync(filePath, "r");
+  try {
+    const buf = Buffer.alloc(64 * 1024);
+    let bytesRead;
+    while ((bytesRead = fs.readSync(fd, buf, 0, buf.length, null)) > 0) {
+      hash.update(buf.subarray(0, bytesRead));
+    }
+  } finally {
+    fs.closeSync(fd);
+  }
+  const actual = hash.digest("hex");
+  if (actual.toLowerCase() !== expectedHash.toLowerCase()) {
+    throw new Error(`Checksum mismatch for ${path.basename(filePath)}: expected ${expectedHash}, got ${actual}`);
+  }
+}
+
+function extractZipWindows(archivePath, destDir) {
+  const env = {
+    ...process.env,
+    PIPPIT_CLI_ARCHIVE: archivePath,
+    PIPPIT_CLI_DEST: destDir,
+  };
+  const ps = [
+    "-NoProfile",
+    "-ExecutionPolicy",
+    "Bypass",
+    "-Command",
+    "$ErrorActionPreference='Stop';Expand-Archive -LiteralPath $env:PIPPIT_CLI_ARCHIVE -DestinationPath $env:PIPPIT_CLI_DEST -Force",
+  ];
+  run("powershell.exe", ps, { env });
+}
+
+function extractArchive(archivePath, destDir) {
+  if (isWindows) {
+    extractZipWindows(archivePath, destDir);
+    return;
+  }
+  run("tar", ["-xzf", archivePath, "-C", destDir]);
+}
+
+function install() {
+  if (!platform || !arch) {
+    throw new Error(`Unsupported platform: ${process.platform}-${process.arch}`);
+  }
+
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "pippit-cli-"));
+  const archivePath = path.join(tmpDir, archiveName);
+  try {
+    download(releaseURL, archivePath);
+    verifyChecksum(archivePath, expectedChecksum(archiveName));
+    extractArchive(archivePath, tmpDir);
+
+    const extracted = path.join(tmpDir, NAME + (isWindows ? ".exe" : ""));
+    fs.copyFileSync(extracted, dest);
+    fs.chmodSync(dest, 0o755);
+
+    if (process.env.PIPPIT_CLI_SKIP_SKILLS !== "1") {
+      installSkillsFromRoot(ROOT);
+    }
+    console.log(`${NAME} v${VERSION} installed successfully`);
+  } finally {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+
+if (require.main === module) {
+  const isNpxPostinstall =
+    process.env.npm_command === "exec" && !process.env.PIPPIT_CLI_RUN;
+
+  if (isNpxPostinstall) {
+    process.exit(0);
+  }
+
+  try {
+    install();
+  } catch (err) {
+    console.error(`Failed to install ${NAME}: ${err.message || err}`);
+    console.error(
+      "\nTry:\n" +
+      "  npm install -g @pippit-dev/cli\n" +
+      `  node "${path.join(__dirname, "install.js")}"\n`
+    );
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  archiveName,
+  expectedChecksum,
+  install,
+  verifyChecksum,
+};

package/scripts/platform.js

@@ -0,0 +1,28 @@
+const { execFileSync } = require("child_process");
+
+const isWindows = process.platform === "win32";
+
+function execCmd(cmd, args, opts = {}) {
+  if (isWindows) {
+    return execFileSync("cmd.exe", ["/c", cmd, ...args], opts);
+  }
+  return execFileSync(cmd, args, opts);
+}
+
+function run(cmd, args, opts = {}) {
+  return execCmd(cmd, args, { stdio: "inherit", ...opts });
+}
+
+function runSilent(cmd, args, opts = {}) {
+  return execCmd(cmd, args, {
+    stdio: ["ignore", "pipe", "pipe"],
+    ...opts,
+  });
+}
+
+module.exports = {
+  execCmd,
+  isWindows,
+  run,
+  runSilent,
+};

package/scripts/run.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+const ext = process.platform === "win32" ? ".exe" : "";
+const bin = path.join(__dirname, "..", "bin", "pippit-cli" + ext);
+const args = process.argv.slice(2);
+
+const oldBin = bin + ".old";
+function restoreOldBinary() {
+  try {
+    if (fs.existsSync(bin)) {
+      fs.rmSync(bin, { force: true });
+    }
+    fs.renameSync(oldBin, bin);
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
+
+if (process.platform === "win32" && fs.existsSync(oldBin)) {
+  if (!fs.existsSync(bin)) {
+    restoreOldBinary();
+  } else {
+    try {
+      execFileSync(bin, ["--help"], { stdio: "ignore", timeout: 10000 });
+      fs.rmSync(oldBin, { force: true });
+    } catch (_) {
+      restoreOldBinary();
+    }
+  }
+}
+
+// Match the lark-cli install entry: `npx @pippit-dev/cli@latest install`
+// should run the JS setup flow before the native binary exists.
+if (args[0] === "install") {
+  require("./install-wizard.js");
+} else {
+  if (!fs.existsSync(bin)) {
+    try {
+      execFileSync(process.execPath, [path.join(__dirname, "install.js")], {
+        stdio: "inherit",
+        env: { ...process.env, PIPPIT_CLI_RUN: "true" },
+      });
+    } catch (_) {
+      console.error(
+        "\nFailed to prepare pippit-cli binary.\n" +
+        "Make sure Go is installed and available in PATH, then retry.\n"
+      );
+      process.exit(1);
+    }
+  }
+
+  try {
+    execFileSync(bin, args, { stdio: "inherit" });
+  } catch (e) {
+    process.exit(e.status || 1);
+  }
+}

package/scripts/skills.js

@@ -0,0 +1,32 @@
+const fs = require("fs");
+const path = require("path");
+const { run, runSilent } = require("./platform");
+
+const DEFAULT_PKG = "@pippit-dev/cli";
+
+function installSkillsFromRoot(root, opts = {}) {
+  const source = path.resolve(root);
+  const skillsDir = path.join(source, "skills");
+  if (!fs.existsSync(skillsDir)) {
+    throw new Error(`skills directory not found: ${skillsDir}`);
+  }
+  run("npx", ["-y", "skills", "add", source, "-g", "-y"], {
+    timeout: opts.timeout || 120000,
+  });
+}
+
+function globalPackageRoot(pkg = DEFAULT_PKG) {
+  const npmRoot = runSilent("npm", ["root", "-g"], { timeout: 15000 }).toString().trim();
+  return path.join(npmRoot, ...pkg.split("/"));
+}
+
+function installGlobalPackageSkills(pkg = DEFAULT_PKG, opts = {}) {
+  installSkillsFromRoot(globalPackageRoot(pkg), opts);
+}
+
+module.exports = {
+  DEFAULT_PKG,
+  globalPackageRoot,
+  installGlobalPackageSkills,
+  installSkillsFromRoot,
+};

package/skills/short-drama/SKILL.md

@@ -0,0 +1,280 @@
+---
+name: pippit-short-drama-skill
+description: 使用 pippit-cli 的短剧场景能力提交和查询短剧创作任务。覆盖短剧生成、续写、改写、剧情扩展、人物设定、分集草稿、世界观设定、会话文件获取、文件资源下载等创作场景。当用户要求创作短剧、写短剧剧本、续写故事、修改剧情、补充角色设定、查询短剧任务进展、获取短剧会话文件或下载短剧文件资源，或提到 pippit-cli short-drama / 小云雀短剧时触发。
+user-invocable: true
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📖",
+        "requires":
+          {
+            "bins": ["pippit-cli"]
+          }
+      }
+  }
+---
+
+# 小云雀短剧创作
+
+通过 `pippit-cli short-drama` 命令提交短剧创作任务、上传参考文件，并查询任务进展，获取会话产物文件。
+
+短剧场景面向剧情、人物、分集与画面化叙事创作，用户的原始需求通过 `--message` 发送给后端 Agent。后端 Agent 负责理解任务、编排流程和生成内容；用户侧 Agent 只负责提交任务、查询进展和展示结果。
+
+## 功能
+
+1. **提交短剧 Run 任务** - 创建新会话或向已有会话发送短剧创作需求。
+2. **查询会话进展** - 根据 `thread_id`、`run_id`、`after_seq` 拉取短剧任务消息列表。
+3. **上传文件** - 上传短剧相关参考文件，得到文件 ID，供后续任务引用。
+4. **获取会话文件** - 根据 `thread_id` 拉取会话文件列表，得到 `file_path`、`file_name`、`download_url`。
+5. **下载文件资源** - 使用文件列表中的 `download_url` 下载资源，并按 `file_path` 写入用户本地目录。
+
+## 前置要求
+
+需要已安装 `pippit-cli`：
+
+```bash
+npx @pippit-dev/cli@latest install
+```
+
+## 使用方法
+
+### 1. 提交短剧任务
+
+```bash
+# 创建新会话并提交短剧创作需求
+pippit-cli short-drama +submit-run --message "创作一个赛博朋克短剧开头"
+
+# 向已有会话追加新的短剧需求
+pippit-cli short-drama +submit-run --message "继续写下一集，重点描写主角的逃亡" --thread-id THREAD_ID
+
+# 携带已上传文件 ID 提交任务
+pippit-cli short-drama +submit-run --message "参考这个大纲写第一集" --asset-ids ASSET_ID
+```
+
+### 2. 查询短剧任务进展
+
+```bash
+# 查询会话消息列表
+pippit-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID --after-seq 0
+```
+
+> `thread_id` 和 `run_id` 由 `+submit-run` 返回。`after-seq` 用于增量拉取消息，首次查询可使用 `0`。
+
+### 3. 上传文件
+
+当用户提供短剧大纲、人物设定、世界观设定、已有分集或剧本等本地文件路径时，可先上传文件。
+
+```bash
+pippit-cli short-drama +upload-file --path /path/to/outline.md
+```
+
+### 4. 获取会话文件
+
+```bash
+# 获取会话文件列表
+pippit-cli short-drama +list-thread-file --thread-id THREAD_ID --page-num 1 --page-size 100
+```
+
+`+list-thread-file` 返回的每个文件对象包含：
+
+```json
+{
+  "file_path": "./{thread-id}/路径/文件名", // 文件完整路径，包含文件名
+  "download_url": "https://..." // URL
+}
+```
+
+`+list-thread-file` 只负责获取会话文件列表，不负责下载文件。
+
+### 5. 下载文件资源
+
+```bash
+# 下载文件资源到指定目录
+pippit-cli short-drama +download-result --url DOWNLOAD_URL --output-dir FILE_PATH 
+```
+
+`+download-result` 负责把会话产生的文件，通过URL下载到 `file_path`目录中，如果目标文件已存在，跳过下载。
+
+## 典型工作流
+
+### 场景 1：用户要求生成短剧内容
+
+```
+1. pippit-cli short-drama +submit-run --message "用户的原始短剧需求"
+   → 拿到 thread_id、run_id 和 web_thread_link
+2. 立即将 web_thread_link 展示给用户
+3. 并行发起：
+   a. pippit-cli short-drama +get-thread --thread-id THREAD_ID --run-id RUN_ID --after-seq SEQUENCE
+   b. pippit-cli short-drama +list-thread-file --thread-id THREAD_ID --page-num 1 --page-size 100
+4. 检查 `get-thread` 返回的 messages：
+   - 如果任务仍在进行中：展示过程消息，继续查询
+   - 如果后端 Agent 提出问题：展示问题，等待用户回复
+5. 解析 `list-thread-file` 返回的 files，只获取文件元信息：
+   - 对每个文件取 file_path、file_name、download_url
+   - 按 file_path 在用户本地环境构建目录
+   - 如果在工作目录中 file_name 已存在：跳过下载
+6. 对缺失的本地文件，调用 +download-result 并行下载资源：
+   - 使用第 5 步获取的 download_url 作为 --url
+   - 使用第 5 步获取的 file_path 作为 --output-dir
+7. 如用户继续追加需求，使用同一 thread_id 再次 submit-run
+```
+
+### 场景 2：用户提供参考文件要求创作
+
+```
+1. pippit-cli short-drama +upload-file --path /path/to/file
+   → 拿到 file_id
+2. pippit-cli short-drama +submit-run --message "用户的原始短剧需求" --asset-ids file_id
+   → 拿到 thread_id、run_id 和 web_thread_link
+3. 后续同场景 1 的并行查询和文件下载流程
+```
+
+### 场景 3：在已有短剧会话中续写或修改
+
+```
+1. pippit-cli short-drama +submit-run --message "用户的新需求" --thread-id THREAD_ID
+   → 拿到新的 run_id 和 web_thread_link
+2. 继续按场景 1 展示进展、处理用户补充问题、获取新增会话文件列表，并按需下载新增文件资源
+```
+
+## 轮询策略
+
+- **间隔**：每 10 秒查询一次。
+- **增量拉取**：首次使用 `--after-seq 0`，后续根据已读消息进度调整 `after-seq`。
+- **并行查询**：每次 `+submit-run` 返回 `thread_id` 后，同时发起 `+get-thread` 和 `+list-thread-file`；会话信息展示流程保持不变，`+list-thread-file` 只用于获取文件元信息。
+- **文件下载**：解析 `+list-thread-file` 的结果后，只有目标本地文件不存在时才调用 `+download-result` 下载资源。
+- **用户确认**：如果消息中出现需要用户确认、补充设定或回答问题的内容，先展示给用户，等待用户回复。
+- **超时**：如果长时间无结果，告知用户任务仍在生成中，可稍后通过 `web_thread_link` 查看。
+- **错误处理**：单次查询失败可重试；连续失败时停止轮询并向用户说明错误。
+
+## 输出格式
+
+**+submit-run** 返回：
+
+```json
+{
+  "thread_id": "thread_...",
+  "run_id": "run_...",
+  "web_thread_link": "https://xyq.jianying.com/..."
+}
+```
+
+**+get-thread** 返回：
+
+```json
+{
+  "messages": [
+    {
+      "id": "message_...",
+      "role": "assistant",
+      "content": [
+        {
+          "type": "text",
+          "data": {}
+        }
+      ]
+    }
+  ]
+}
+```
+
+**+upload-file** 返回：
+
+```json
+{
+  "scene": "short-drama",
+  "file_id": "file_...",
+  "status": "uploaded",
+  "uploaded_at": "2026-05-19T00:00:00Z",
+  "request": {
+    "path": "/path/to/file",
+    "file_name": "file.md"
+  }
+}
+```
+
+**+list-thread-file** 返回：
+
+```json
+{
+  "files": [
+    {
+      "file_path": "./{thread-id}/{file_path}/{file_name}",
+      "download_url": "https://..."
+    }
+  ],
+  "total": 1
+}
+```
+
+**+download-result** 返回：
+
+```json
+{
+  "output_dir": "/path/to/output-dir",
+  "downloaded": ["/path/to/output-dir/01.md"],
+  "total": 1
+}
+```
+
+## 会话文件与资源下载
+
+先用 `+list-thread-file` 获取会话文件列表，再按需用 `+download-result` 并行下载文件资源。
+
+### 获取会话文件
+
+从 `+list-thread-file` 的 `files` 中逐个读取文件元信息：`file_path`、`download_url`。
+
+```
+1. file_path在本地已存在
+   → 跳过
+2. file_path在本地不存在
+   → 记录该file_path和URL
+   → 多个待下载的文件 → 使用 +download-result 工具并行下载文件到本地
+```
+
+### 并行下载文件资源
+
+只对目标路径不存在的文件调用下载工具，可并行：
+
+1. 调用 `pippit-cli short-drama +download-result --url DOWNLOAD_URL --output-dir FILE_PATH`。
+2. 下载完成后，向用户展示本地文件路径；如果某个文件下载失败，只报告该文件错误，不阻塞已成功落盘的文件展示。
+
+## 向用户展示内容
+
+- 任务提交后：立即展示 `web_thread_link`。
+- 任务进行中：展示后端 Agent 返回的过程消息。
+- 需要用户补充信息时：原样展示后端 Agent 的问题，等待用户回复。
+- 任务完成后：展示短剧内容、分集草稿、设定说明或其他结果信息。
+- 获取会话文件后：展示或记录文件元信息，不把它当成已下载结果。
+- 文件资源下载后：展示已落盘的本地文件路径；已存在而跳过下载的文件也要标明。
+
+## 核心原则：用户侧不做创作，只做传话
+
+你（用户侧 Agent）的职责是传递用户需求和展示后端结果，不是替后端 Agent 创作短剧。
+
+你要做的只有三件事：
+
+1. **上传**：如果用户给了本地参考文件，先调用 `+upload-file`。
+2. **提交任务**：把用户原始短剧需求和文件 ID 通过 `+submit-run` 发给后端。
+3. **传话、取文件、下载资源**：根据 `+get-thread` 返回的消息展示进展、问题和结果；根据 `+list-thread-file` 获取文件列表；再根据 `download_url` 调用 `+download-result` 把缺失资源下载到用户本地。
+
+**不要做的事：**
+
+- 不要替用户扩写、润色、翻译 prompt。
+- 不要自行编排剧情、人物关系、世界观或分集大纲后再提交。
+- 不要把用户的一个需求拆成多次 `+submit-run`，除非用户明确要求分多次处理。
+- 不要将自己编写的短剧内容混入后端返回结果。
+
+后端 Agent 会负责理解短剧任务、组织创作流程和生成内容。用户侧 Agent 越俎代庖会降低结果一致性。
+
+## 注意事项
+
+- `--message` 是用户的原始短剧需求，不能为空。
+- 查询进展时优先使用 `+submit-run` 返回的 `thread_id` 和 `run_id`。
+- `--after-seq` 用于增量拉取消息，首次查询可设置为 `0`。
+- `+upload-file` 当前用于短剧场景文件上传链路，上传后将返回可传给 `+submit-run` 的文件 ID。
+- `+list-thread-file` 只需要 `thread_id`；分页参数默认 `--page-num 1 --page-size 100`。
+- `+list-thread-file` 和 `+download-result` 是两个不同的 CLI 指令：前者获取会话文件元信息，后者下载 URL 资源并写入到本地目录。
+- `+download-result` 接收 `--url`、`--output-dir`、`--workers`。