html-to-aippt-composition-skill 1.0.3

package/bin/agentpower-skill.mjs

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+
+import { cpSync, existsSync, mkdirSync, rmSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const skillName = "html-to-aippt-composition";
+const bundledSkillDir = path.join(packageRoot, skillName);
+const requiredFiles = [
+  "SKILL.md",
+  "reference/composition-contract.md",
+  "scripts/ensure-html-to-composition.mjs",
+  "scripts/publish-template.mjs",
+];
+
+const help = `
+Usage:
+  npx @agentpower/html-to-aippt-composition-skill install [--force]
+  npx @agentpower/html-to-aippt-composition-skill doctor
+  npx @agentpower/html-to-aippt-composition-skill uninstall
+
+Options:
+  --codex-home <path>   Install under this Codex home instead of CODEX_HOME or ~/.codex.
+  --force               Replace an existing installed skill.
+  --help                Show this help.
+`;
+
+main().catch((error) => {
+  console.error(error.message);
+  process.exitCode = 1;
+});
+
+async function main() {
+  const { command, options } = parseArgs(process.argv.slice(2));
+
+  if (options.help || command === "help") {
+    process.stdout.write(help.trimStart());
+    return;
+  }
+
+  if (command === "install") {
+    install(options);
+    return;
+  }
+
+  if (command === "doctor") {
+    doctor(options);
+    return;
+  }
+
+  if (command === "uninstall") {
+    uninstall(options);
+    return;
+  }
+
+  throw new Error(`Unknown command: ${command || "(none)"}\n\n${help.trimStart()}`);
+}
+
+function install(options) {
+  assertBundledSkill();
+
+  const installPath = installedSkillPath(options);
+  if (existsSync(installPath)) {
+    if (!options.force) {
+      throw new Error(`${skillName} is already installed at ${installPath}. Re-run with --force to replace it.`);
+    }
+    rmSync(installPath, { recursive: true, force: true });
+  }
+
+  mkdirSync(path.dirname(installPath), { recursive: true });
+  cpSync(bundledSkillDir, installPath, {
+    recursive: true,
+    filter: (source) => path.basename(source) !== ".env",
+  });
+
+  console.log(`Installed ${skillName} to ${installPath}`);
+  console.log("Restart Codex to pick up the skill.");
+}
+
+function doctor(options) {
+  const installPath = installedSkillPath(options);
+  if (!existsSync(installPath)) {
+    throw new Error(`${skillName} is not installed at ${installPath}. Run install first.`);
+  }
+
+  const missing = missingRequiredFiles(installPath);
+  if (missing.length > 0) {
+    throw new Error(`${skillName} is installed but missing: ${missing.join(", ")}`);
+  }
+
+  console.log(`${skillName} is ready at ${installPath}`);
+}
+
+function uninstall(options) {
+  const installPath = installedSkillPath(options);
+  if (!existsSync(installPath)) {
+    throw new Error(`${skillName} is not installed at ${installPath}.`);
+  }
+
+  rmSync(installPath, { recursive: true, force: true });
+  console.log(`Uninstalled ${skillName} from ${installPath}`);
+}
+
+function parseArgs(argv) {
+  const options = {
+    codexHome: process.env.CODEX_HOME || path.join(os.homedir(), ".codex"),
+    force: false,
+    help: false,
+  };
+  let command = null;
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (token === "--help" || token === "-h") {
+      options.help = true;
+      continue;
+    }
+    if (token === "--force") {
+      options.force = true;
+      continue;
+    }
+    if (token === "--codex-home") {
+      const value = argv[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new Error("Missing value for --codex-home");
+      }
+      options.codexHome = path.resolve(value);
+      index += 1;
+      continue;
+    }
+    if (token.startsWith("--codex-home=")) {
+      options.codexHome = path.resolve(token.slice("--codex-home=".length));
+      continue;
+    }
+    if (token.startsWith("--")) {
+      throw new Error(`Unknown option: ${token}`);
+    }
+    if (command) {
+      throw new Error(`Unexpected argument: ${token}`);
+    }
+    command = token;
+  }
+
+  return { command: command || "help", options };
+}
+
+function installedSkillPath(options) {
+  return path.join(options.codexHome, "skills", skillName);
+}
+
+function assertBundledSkill() {
+  if (!existsSync(bundledSkillDir)) {
+    throw new Error(`Bundled skill directory not found: ${bundledSkillDir}`);
+  }
+
+  const missing = missingRequiredFiles(bundledSkillDir);
+  if (missing.length > 0) {
+    throw new Error(`Bundled skill is incomplete: ${missing.join(", ")}`);
+  }
+}
+
+function missingRequiredFiles(root) {
+  return requiredFiles.filter((relativePath) => !existsSync(path.join(root, relativePath)));
+}

package/html-to-aippt-composition/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: html-to-aippt-composition
+description: 当用户需要将 HTML slide、自定义页面布局转换为 AIPPT SlideComposition JSON，或提到发布、上传、审核通过、上架、提交模板等发布类意图时使用。
+---
+
+# HTML 转 AIPPT Composition
+
+当用户提供 HTML slide、由截图还原的 HTML、自定义页面布局，并希望生成可用于 AIPPT 在线预览和 PPTX 导出的 `SlideCompositionDocument` JSON 时，使用本 Skill。
+
+## 工作流程
+
+1. 如果用户表达发布、上传、上架、提交审核、审核通过、发布模板等发布类意图，必须先暂停发布/上传动作，并按顺序收集发布元数据：
+   - 先只提示用户输入：`模版标题`。
+   - 用户输入标题后，再提示用户输入：`模版描述`。
+   - 不要在同一次回复里同时询问标题和描述。
+   - 用户输入模版描述后，如果 SDK 输出 JSON 尚未生成，先完成本工作流程的生成和验证步骤；随后执行“发布/上传后台保存流程”。
+   - 如果用户已在当前对话明确提供其中一项，只追问缺失项。
+2. 确认 SDK CLI 可用且保持最新。每次使用转换能力前先执行：
+
+```bash
+node html-to-aippt-composition/scripts/ensure-html-to-composition.mjs
+```
+
+这个脚本是幂等的：如果已经安装且是 npm 最新版本，会直接复用本机 `aippt-html-import`；如果未安装，会安装 `html-to-composition@latest`；如果 npm 上有新版本，会升级到 latest。联调脚本行为时可先执行 `node html-to-aippt-composition/scripts/ensure-html-to-composition.mjs --dry-run`。
+
+3. 确认用户提供的 HTML 文件路径，以及是否有图片替换 URL。
+4. 调用 SDK CLI：
+
+```bash
+aippt-html-import --html <html-file> --out <composition-json> --pretty
+```
+
+如果用户提供了替换图片，按图片出现顺序重复传入 `--image <url>`。
+
+批量转换时优先使用 SDK 批量能力，不要用外层脚本手写循环：
+
+```bash
+aippt-html-import --html-dir <slides-dir> --out <deck-composition-json> --slide-id-prefix <deck-id> --pretty
+```
+
+也可以重复传入 `--html`：
+
+```bash
+aippt-html-import --html slide_01.html --html slide_02.html --out deck-composition.json --pretty
+```
+
+批量图片替换按“slide 排序顺序 + 每页图片出现顺序”依次消费 `--image`。如果映射复杂，先整理成明确的顺序清单再执行。
+
+5. 阅读 CLI 输出摘要、`report` 和 `warnings`，重点检查：
+   - `textCount`、`imageCount`、`shapeCount` 是否明显少于源 HTML。
+   - 是否存在 `hybrid` 或 `raster` 导出策略。
+   - 是否有未使用的图片替换。
+   - 批量模式下 `slides.length` 是否等于 HTML 文件数，slide 顺序是否符合文件名排序。
+6. 校验输出文档包含 `version: "aippt-composition/v1"`，并且至少包含一页 slide。
+7. 必须做视觉保真验证：
+   - 用浏览器截取源 HTML 作为基准图。
+   - 将生成的 JSON 放入 AIPPT composition 渲染器，再截取渲染图。
+   - 导出 PPTX，并检查 PPTX 画面是否与浏览器渲染一致。
+   - 批量模式下至少抽查首尾页和所有 warning 页；交付前优先逐页验证。
+8. 根据验证结果选择交付等级：
+   - `native`：文本、普通图片、基础形状都可编辑，视觉差异小。
+   - `hybrid`：文本尽量可编辑，复杂 SVG path、异形裁切、遮罩、滤镜等局部锁定或标记不可编辑。
+   - `raster`：差异过大时用整页截图兜底，明确说明可编辑性降低。
+9. 如果视觉结果不完整，优先修正 SDK 的 transform、SVG path、clipPath、z-index、字体或图片替换逻辑；不要只因为 JSON schema 通过就交付。
+
+## 发布/上传后台保存流程
+
+当用户已经输入 `模版标题` 和 `模版描述` 后，按《PPT 模板生产后台保存对接文档》的“2. 推荐流程”执行。
+
+这里的 `template.json` 固定指 SDK 生成的 `SlideCompositionDocument` JSON，也就是本 Skill 通过 `aippt-html-import` 产出的 `slide-composition.json` 或 `deck-composition.json`。不要另造一份模板 JSON，不要上传源 HTML、截图、PPTX 或 render JSON。
+
+执行顺序：
+
+1. 确认 SDK 已生成并验证 `template.json`：
+   - 单页任务使用 SDK 输出的 `slide-composition.json` 作为 `template.json`。
+   - 批量任务使用 SDK 输出的 `deck-composition.json` 作为 `template.json`。
+   - 上传前必须已完成 JSON 结构校验和视觉保真验证。
+2. 优先调用本 Skill 自带脚本执行后台保存链路：
+
+```bash
+node html-to-aippt-composition/scripts/publish-template.mjs \
+  --phone <admin-phone> \
+  --template-json <slide-composition.json-or-deck-composition.json> \
+  --template-code <template-code> \
+  --template-version <template-version> \
+  --title <模版标题> \
+  --description <模版描述>
+```
+
+首次执行或联调前可以先 dry-run：
+
+```bash
+node html-to-aippt-composition/scripts/publish-template.mjs \
+  --phone <admin-phone> \
+  --template-json <slide-composition.json-or-deck-composition.json> \
+  --template-code <template-code> \
+  --template-version <template-version> \
+  --title <模版标题> \
+  --description <模版描述> \
+  --dry-run
+```
+
+脚本默认使用服务端真实 `api-base`：`https://prism-stone-pre.byering.com`。脚本会依次执行登录、`templateCode` 存在性校验、OSS 预签名、OSS 直传、后台保存，并在成功后输出 `templateJsonObjectKey` 和保存结果。可把 `AIPPT_API_BASE`、`AIPPT_ADMIN_PHONE`、`AIPPT_SMS_CODE`、`AIPPT_TEMPLATE_CODE`、`AIPPT_TEMPLATE_VERSION` 写到 `html-to-aippt-composition/.env`；不要把 `.env` 提交到仓库。
+
+3. 如果脚本不可用，才按下面接口顺序手动执行：
+4. Web 登录，拿到 `access_token` Cookie：
+   - 登录接口为 `POST /api/web/auth/login`。
+   - 请求必须带 `credentials: "include"`。
+   - 验证码默认传 `123456`。
+   - 不要手写 Cookie，不要把 token 写入 URL、OSS object key、日志或模板 JSON。
+5. 调模板名称校验接口，按 `templateCode` 判断模板是否已存在：
+   - 接口为 `POST /admin/deliverable-presentation-templates/exists`。
+   - 校验字段是 `templateCode`，不是 `模版标题` / `title`。
+   - 如果 `exists=true`，停止上传和保存，提示用户更换 `templateCode`。
+6. 调通用 OSS 预签名接口，为 `template.json` 申请固定 object key 上传凭证：
+   - 接口为 `GET /bean/storage/oss/presign`。
+   - `fileName` 固定传 `template.json`。
+   - `prefix` 推荐 `deliverables/templates/presentation/<templateCode>/<templateVersion>`。
+   - `contentType` 传 `application/json`。
+   - `publicRead` 固定传 `true`。
+7. 前端把 SDK 生成的 `template.json` 直传 OSS：
+   - 使用预签名响应中的 `host`、`objectKey`、`accessId`、`policy`、`signature`、`contentType`、`acl` 组装表单。
+   - 表单中的 `key` 必须等于 `presign.objectKey`。
+   - `file` 字段放在最后，文件名使用 `template.json`。
+   - 直传 OSS 时不要携带业务 Cookie 或 Authorization。
+8. 调 PPT 模板保存接口，只保存模板元数据和 `templateJsonObjectKey`：
+   - 接口为 `POST /admin/deliverable-presentation-templates/save`。
+   - 请求体包含 `templateCode`、`templateVersion`、`title`、`description`、`templateJsonObjectKey`、`remark`。
+   - `title` 使用用户输入的 `模版标题`。
+   - `description` 使用用户输入的 `模版描述`。
+   - `templateJsonObjectKey` 必须使用 `presign.objectKey`，不能传 URL、publicUrl 或签名 URL。
+   - 新建模板默认 `status=0`，启用由运营后台处理，不属于本 Skill 上传流程。
+
+如果执行推荐流程所需的 `apiBase`、管理员手机号、`templateCode` 或 `templateVersion` 缺失，先逐项向用户补问缺失项；不要跳过名称校验、OSS 上传或保存步骤。
+
+## 质量规则
+
+- 将 `SlideCompositionDocument` 视为最终交付协议。
+- 尽可能把文本保留为 native text，方便后续编辑。
+- 普通图片应保留为 native image element。
+- SVG `path`、CSS transform、clipPath、z-index、字体加载和图片裁切是高风险项，必须通过截图或 PPTX 检查验证。
+- 复杂或暂不支持的视觉效果，需要用 `exportPolicy.mode: "hybrid"` / `raster` 标记，或输出 warning。
+- 不要声称任意 HTML 都能完全可编辑，除非浏览器渲染和 PPTX 导出检查已经证明这一点。
+- 当用户要求模板不固定时，不要写模板特判；优先提升 SDK 的通用抽取、保真校验和降级策略。
+
+## 交付物
+
+- `slide-composition.json`
+- 批量任务交付 `deck-composition.json`，包含多页 `slides`
+- 源 HTML 基准截图
+- AIPPT composition 渲染截图
+- PPTX 导出文件或导出验证结果
+- 文本、图片、形状数量摘要
+- 影响保真度或可编辑性的 warnings
+- `native` / `hybrid` / `raster` 交付等级说明

package/html-to-aippt-composition/reference/composition-contract.md

@@ -0,0 +1,40 @@
+# Composition 协议
+
+SDK 输出的顶层结构为：
+
+```json
+{
+  "version": "aippt-composition/v1",
+  "slides": []
+}
+```
+
+每一页 slide 应为 1280 x 720，并包含可被 AIPPT composition 渲染器消费的 layers：
+
+- `background`
+- `media`
+- `structure`
+- `content`
+- `ornament`
+
+首版 HTML 导入优先生成 `text`、`image` 和 `shape` 元素。复杂效果应通过 warning 或 `exportPolicy.mode: "hybrid"` 明确标记。
+
+## 批量导入
+
+批量导入应输出一个 `SlideCompositionDocument`，其中：
+
+- `slides.length` 等于输入 HTML 文件数。
+- `--html-dir` 按文件名排序，`--html` 重复传入时按参数顺序。
+- 每页 `slide.id` 必须稳定且唯一。
+- `assets[].id` 必须跨页唯一。
+- 顶层 `warnings` 和 `report` 汇总所有页面。
+- 图片替换按页面顺序、页内图片出现顺序消费。
+
+## 保真要求
+
+模板不固定时，导入器不能依赖模板特判。必须优先使用通用规则处理：
+
+- 坐标、字号、clipPath 都要统一考虑 CSS transform。
+- SVG `path` 不能静默丢弃；可编辑近似形状用 native shape，无法编辑的复杂形状用 `hybrid` 或 `raster` 标记。
+- layer 的 `zIndex` 应接近源 HTML/PPT 的绘制顺序，避免图片盖住前景指标或标签。
+- 生成后必须用源 HTML 截图、composition 渲染截图和 PPTX 导出结果做保真验证。

package/html-to-aippt-composition/scripts/ensure-html-to-composition.mjs

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
+const PACKAGE_NAME = "html-to-composition";
+const CLI_NAME = "aippt-html-import";
+
+const HELP = `
+Usage:
+  node html-to-aippt-composition/scripts/ensure-html-to-composition.mjs
+
+Options:
+  --dry-run       Check installed/latest versions without installing.
+  --help          Show this help.
+
+Behavior:
+  - If ${PACKAGE_NAME} is not installed globally, install ${PACKAGE_NAME}@latest.
+  - If a newer npm version exists, upgrade the global package to latest.
+  - If the installed version is already latest, do nothing.
+  - If npm latest cannot be queried but the CLI is installed, keep using the installed CLI.
+`;
+
+main().catch((error) => {
+  console.error(`ERROR: ${error.message}`);
+  process.exitCode = 1;
+});
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) {
+    process.stdout.write(HELP.trimStart());
+    return;
+  }
+
+  const installed = await getInstalledVersion();
+  const latest = await getLatestVersion();
+
+  if (!latest && !installed.version) {
+    throw new Error(`Cannot find installed ${PACKAGE_NAME}, and npm latest lookup failed`);
+  }
+
+  const plan = decidePlan(installed.version, latest);
+  if (args.dryRun) {
+    console.log(JSON.stringify({
+      dryRun: true,
+      package: PACKAGE_NAME,
+      cli: CLI_NAME,
+      installedVersion: installed.version,
+      latestVersion: latest,
+      action: plan.action,
+      reason: plan.reason,
+    }, null, 2));
+    return;
+  }
+
+  if (plan.action === "use-installed") {
+    console.log(`${PACKAGE_NAME} ${installed.version} is ready (${plan.reason}).`);
+    return;
+  }
+
+  console.log(`${plan.reason}; running npm install -g ${PACKAGE_NAME}@latest`);
+  await installLatest();
+  const afterInstall = await getInstalledVersion();
+  if (!afterInstall.version) {
+    throw new Error(`${PACKAGE_NAME} installation finished, but global package was not detected`);
+  }
+  console.log(`${PACKAGE_NAME} ${afterInstall.version} is ready.`);
+}
+
+function parseArgs(argv) {
+  const args = {};
+  for (const arg of argv) {
+    if (arg === "--help") {
+      args.help = true;
+    } else if (arg === "--dry-run") {
+      args.dryRun = true;
+    } else {
+      throw new Error(`Unknown argument: ${arg}`);
+    }
+  }
+  return args;
+}
+
+async function getInstalledVersion() {
+  const npmLs = await run("npm", ["ls", "-g", PACKAGE_NAME, "--json", "--depth=0"], { allowFailure: true });
+  if (npmLs.ok) {
+    const version = parseInstalledVersion(npmLs.stdout);
+    if (version) {
+      return { version, source: "npm-ls" };
+    }
+  }
+
+  const which = await run(process.platform === "win32" ? "where" : "which", [CLI_NAME], { allowFailure: true });
+  if (!which.ok) {
+    return { version: null, source: "missing" };
+  }
+
+  return { version: null, source: "cli-present-version-unknown" };
+}
+
+function parseInstalledVersion(stdout) {
+  try {
+    const parsed = JSON.parse(stdout);
+    return parsed.dependencies?.[PACKAGE_NAME]?.version || null;
+  } catch {
+    return null;
+  }
+}
+
+async function getLatestVersion() {
+  const result = await run("npm", ["view", PACKAGE_NAME, "version"], { allowFailure: true });
+  if (!result.ok) {
+    return null;
+  }
+  return result.stdout.trim() || null;
+}
+
+function decidePlan(installedVersion, latestVersion) {
+  if (!latestVersion) {
+    return {
+      action: "use-installed",
+      reason: "npm latest lookup failed; using installed CLI",
+    };
+  }
+
+  if (!installedVersion) {
+    return {
+      action: "install",
+      reason: `${PACKAGE_NAME} is not installed globally`,
+    };
+  }
+
+  if (compareSemver(installedVersion, latestVersion) < 0) {
+    return {
+      action: "upgrade",
+      reason: `${PACKAGE_NAME} ${installedVersion} is older than latest ${latestVersion}`,
+    };
+  }
+
+  return {
+    action: "use-installed",
+    reason: `${PACKAGE_NAME} ${installedVersion} is already latest ${latestVersion}`,
+  };
+}
+
+async function installLatest() {
+  await run("npm", ["install", "-g", `${PACKAGE_NAME}@latest`], { stdio: "inherit" });
+}
+
+function compareSemver(left, right) {
+  const a = semverParts(left);
+  const b = semverParts(right);
+  for (let i = 0; i < Math.max(a.length, b.length); i += 1) {
+    const diff = (a[i] || 0) - (b[i] || 0);
+    if (diff !== 0) {
+      return diff;
+    }
+  }
+  return 0;
+}
+
+function semverParts(version) {
+  return version
+    .split(/[.-]/)
+    .slice(0, 3)
+    .map((part) => Number.parseInt(part, 10))
+    .map((part) => Number.isFinite(part) ? part : 0);
+}
+
+async function run(command, args, options = {}) {
+  try {
+    const result = await execFileAsync(command, args, {
+      encoding: "utf8",
+      stdio: options.stdio,
+    });
+    return { ok: true, stdout: result.stdout || "", stderr: result.stderr || "" };
+  } catch (error) {
+    if (options.allowFailure) {
+      return {
+        ok: false,
+        stdout: error.stdout || "",
+        stderr: error.stderr || error.message,
+      };
+    }
+    throw error;
+  }
+}

package/html-to-aippt-composition/scripts/publish-template.mjs

@@ -0,0 +1,391 @@
+#!/usr/bin/env node
+
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const skillDir = path.resolve(scriptDir, '..');
+const DEFAULT_API_BASE = 'https://prism-stone-pre.byering.com';
+
+const HELP = `
+Usage:
+  node html-to-aippt-composition/scripts/publish-template.mjs \\
+    --phone 13800138001 \\
+    --template-json ./slide-composition.json \\
+    --template-code business_summary \\
+    --template-version 1.0.0 \\
+    --title "经营分析汇报" \\
+    --description "用于 PPT/PDF 演示生成"
+
+Options:
+  --api-base             Java API base URL. Defaults to ${DEFAULT_API_BASE}.
+  --phone                Admin login phone.
+  --sms-code             SMS code. Defaults to 123456.
+  --template-json        SDK generated template JSON path.
+  --template-code        Stable unique template code.
+  --template-version     Template version. Defaults to 1.0.0.
+  --title                Template display title.
+  --description          Template description.
+  --remark               Save remark. Defaults to "前端 skill 生成并上传".
+  --env                  Env file path. Defaults to html-to-aippt-composition/.env.
+  --dry-run              Validate inputs and print the request plan without calling APIs.
+  --help                 Show this help.
+
+Env fallback:
+  AIPPT_API_BASE, AIPPT_ADMIN_PHONE, AIPPT_SMS_CODE,
+  AIPPT_TEMPLATE_CODE, AIPPT_TEMPLATE_VERSION
+`;
+
+main().catch((error) => {
+	console.error(`ERROR: ${error.message}`);
+	process.exitCode = 1;
+});
+
+async function main() {
+	const args = parseArgs(process.argv.slice(2));
+	if (args.help) {
+		process.stdout.write(HELP.trimStart());
+		return;
+	}
+
+	const envPath = path.resolve(args.env || path.join(skillDir, '.env'));
+	const fileEnv = await readEnvFile(envPath);
+	const options = normalizeOptions(args, fileEnv);
+	const templateJson = await readAndValidateTemplateJson(options.templateJsonPath);
+
+	const plan = {
+		apiBase: options.apiBase,
+		templateJson: options.templateJsonPath,
+		templateCode: options.templateCode,
+		templateVersion: options.templateVersion,
+		title: options.title,
+		description: options.description,
+		prefix: templatePrefix(options.templateCode, options.templateVersion),
+		endpoints: [
+			'POST /api/web/auth/login',
+			'POST /admin/deliverable-presentation-templates/exists',
+			'GET /bean/storage/oss/presign',
+			'POST <oss-host>',
+			'POST /admin/deliverable-presentation-templates/save',
+		],
+	};
+
+	if (options.dryRun) {
+		console.log(JSON.stringify({ dryRun: true, plan }, null, 2));
+		return;
+	}
+
+	const cookieJar = new CookieJar();
+	await login(options, cookieJar);
+	await assertTemplateCodeAvailable(options, cookieJar);
+	const presign = await requestPresign(options, cookieJar);
+	await uploadTemplateJson(templateJson, presign);
+	const saved = await saveTemplate(options, presign.objectKey, cookieJar);
+
+	console.log(
+		JSON.stringify(
+			{
+				ok: true,
+				templateCode: options.templateCode,
+				templateVersion: options.templateVersion,
+				templateJsonObjectKey: presign.objectKey,
+				saved: saved.entity ?? saved,
+			},
+			null,
+			2,
+		),
+	);
+}
+
+function parseArgs(argv) {
+	const args = {};
+	for (let i = 0; i < argv.length; i += 1) {
+		const token = argv[i];
+		if (!token.startsWith('--')) {
+			throw new Error(`Unexpected argument: ${token}`);
+		}
+
+		const [rawKey, inlineValue] = token.slice(2).split(/=(.*)/s, 2);
+		const key = toCamelCase(rawKey);
+		if (key === 'help' || key === 'dryRun') {
+			args[key] = true;
+			continue;
+		}
+
+		const value = inlineValue !== undefined ? inlineValue : argv[i + 1];
+		if (!value || value.startsWith('--')) {
+			throw new Error(`Missing value for --${rawKey}`);
+		}
+		args[key] = value;
+		if (inlineValue === undefined) {
+			i += 1;
+		}
+	}
+	return args;
+}
+
+function toCamelCase(value) {
+	return value.replace(/-([a-z])/g, (_, char) => char.toUpperCase());
+}
+
+async function readEnvFile(envPath) {
+	if (!existsSync(envPath)) {
+		return {};
+	}
+
+	const content = await readFile(envPath, 'utf8');
+	const env = {};
+	for (const line of content.split(/\r?\n/)) {
+		const trimmed = line.trim();
+		if (!trimmed || trimmed.startsWith('#')) {
+			continue;
+		}
+		const index = trimmed.indexOf('=');
+		if (index === -1) {
+			continue;
+		}
+		const key = trimmed.slice(0, index).trim();
+		const value = trimmed
+			.slice(index + 1)
+			.trim()
+			.replace(/^['"]|['"]$/g, '');
+		env[key] = value;
+	}
+	return env;
+}
+
+function normalizeOptions(args, fileEnv) {
+	const options = {
+		apiBase: args.apiBase || fileEnv.AIPPT_API_BASE || DEFAULT_API_BASE,
+		phone: args.phone || fileEnv.AIPPT_ADMIN_PHONE,
+		smsCode: args.smsCode || fileEnv.AIPPT_SMS_CODE || '123456',
+		templateJsonPath: args.templateJson,
+		templateCode: args.templateCode || fileEnv.AIPPT_TEMPLATE_CODE,
+		templateVersion: args.templateVersion || fileEnv.AIPPT_TEMPLATE_VERSION || '1.0.0',
+		title: args.title,
+		description: args.description,
+		remark: args.remark || '前端 skill 生成并上传',
+		dryRun: Boolean(args.dryRun),
+	};
+
+	const missing = [];
+	for (const [key, value] of Object.entries(options)) {
+		if (key === 'remark' || key === 'dryRun') {
+			continue;
+		}
+		if (!value) {
+			missing.push(key);
+		}
+	}
+	if (missing.length > 0) {
+		throw new Error(`Missing required option(s): ${missing.join(', ')}`);
+	}
+
+	options.apiBase = options.apiBase.replace(/\/+$/, '');
+	options.templateJsonPath = path.resolve(options.templateJsonPath);
+	validateTemplateCode(options.templateCode);
+	validateTemplateVersion(options.templateVersion);
+	return options;
+}
+
+function validateTemplateCode(templateCode) {
+	if (!/^[a-z0-9_-]+$/.test(templateCode)) {
+		throw new Error('templateCode must use lowercase letters, numbers, underscores, or hyphens');
+	}
+}
+
+function validateTemplateVersion(templateVersion) {
+	if (!/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(templateVersion)) {
+		throw new Error('templateVersion must look like semantic version, for example 1.0.0');
+	}
+}
+
+async function readAndValidateTemplateJson(templateJsonPath) {
+	let parsed;
+	try {
+		parsed = JSON.parse(await readFile(templateJsonPath, 'utf8'));
+	} catch (error) {
+		throw new Error(`Cannot read or parse template JSON: ${error.message}`);
+	}
+
+	if (parsed.version !== 'aippt-composition/v1') {
+		throw new Error('template.json must contain version: "aippt-composition/v1"');
+	}
+	if (!Array.isArray(parsed.slides) || parsed.slides.length === 0) {
+		throw new Error('template.json must contain a non-empty slides array');
+	}
+	return parsed;
+}
+
+async function login(options, cookieJar) {
+	const payload = await fetchJson(
+		apiUrl(options.apiBase, '/api/web/auth/login'),
+		{
+			method: 'POST',
+			headers: { 'Content-Type': 'application/json' },
+			body: JSON.stringify({ phone: options.phone, smsCode: options.smsCode }),
+		},
+		cookieJar,
+	);
+
+	if (!payload.entity?.userInfo && !payload.entity?.accessToken) {
+		throw new Error('Login response did not include expected entity data');
+	}
+	if (!cookieJar.hasCookies()) {
+		throw new Error('Login did not return cookies');
+	}
+}
+
+async function assertTemplateCodeAvailable(options, cookieJar) {
+	const payload = await fetchJson(
+		apiUrl(options.apiBase, '/admin/deliverable-presentation-templates/exists'),
+		{
+			method: 'POST',
+			headers: { 'Content-Type': 'application/json' },
+			body: JSON.stringify({ templateCode: options.templateCode }),
+		},
+		cookieJar,
+	);
+
+	if (typeof payload.entity?.exists !== 'boolean') {
+		throw new Error('Exists response did not include entity.exists');
+	}
+	if (payload.entity?.exists) {
+		throw new Error(`templateCode already exists: ${options.templateCode}`);
+	}
+}
+
+async function requestPresign(options, cookieJar) {
+	const url = apiUrl(options.apiBase, '/bean/storage/oss/presign');
+	url.searchParams.set('fileName', 'template.json');
+	url.searchParams.set('prefix', templatePrefix(options.templateCode, options.templateVersion));
+	url.searchParams.set('contentType', 'application/json');
+	url.searchParams.set('publicRead', 'true');
+
+	const payload = await fetchJson(url, { method: 'GET' }, cookieJar);
+	const presign = payload.entity;
+	const required = ['accessId', 'policy', 'signature', 'host', 'objectKey'];
+	const missing = required.filter((key) => !presign?.[key]);
+	if (missing.length > 0) {
+		throw new Error(`Presign response missing field(s): ${missing.join(', ')}`);
+	}
+	if (presign.objectKey !== `${templatePrefix(options.templateCode, options.templateVersion)}/template.json`) {
+		throw new Error(`Unexpected presign objectKey: ${presign.objectKey}`);
+	}
+	return presign;
+}
+
+async function uploadTemplateJson(templateJson, presign) {
+	const contentType = presign.contentType || 'application/json';
+	const formData = new FormData();
+	formData.append('key', presign.objectKey);
+	formData.append('OSSAccessKeyId', presign.accessId);
+	formData.append('policy', presign.policy);
+	formData.append('Signature', presign.signature);
+	if (presign.contentType) {
+		formData.append('Content-Type', presign.contentType);
+	}
+	formData.append('x-oss-object-acl', presign.acl || 'public-read');
+	formData.append('file', new Blob([JSON.stringify(templateJson)], { type: contentType }), 'template.json');
+
+	const response = await fetch(presign.host, {
+		method: 'POST',
+		body: formData,
+	});
+	if (!response.ok) {
+		throw new Error(`OSS upload failed: HTTP ${response.status} ${await response.text()}`);
+	}
+}
+
+async function saveTemplate(options, templateJsonObjectKey, cookieJar) {
+	return fetchJson(
+		apiUrl(options.apiBase, '/admin/deliverable-presentation-templates/save'),
+		{
+			method: 'POST',
+			headers: { 'Content-Type': 'application/json' },
+			body: JSON.stringify({
+				templateCode: options.templateCode,
+				templateVersion: options.templateVersion,
+				title: options.title,
+				description: options.description,
+				templateJsonObjectKey,
+				remark: options.remark,
+			}),
+		},
+		cookieJar,
+	);
+}
+
+function templatePrefix(templateCode, templateVersion) {
+	return `deliverables/templates/presentation/${templateCode}/${templateVersion}`;
+}
+
+function apiUrl(apiBase, pathname) {
+	const base = new URL(apiBase.endsWith('/') ? apiBase : `${apiBase}/`);
+	const basePath = base.pathname.replace(/\/$/, '');
+	base.pathname = `${basePath}${pathname}`;
+	return base;
+}
+
+async function fetchJson(url, init, cookieJar) {
+	const headers = new Headers(init.headers || {});
+	if (cookieJar?.hasCookies()) {
+		headers.set('Cookie', cookieJar.header());
+	}
+
+	const response = await fetch(url, {
+		...init,
+		credentials: 'include',
+		headers,
+	});
+	cookieJar?.storeFrom(response.headers);
+
+	const text = await response.text();
+	let payload = {};
+	if (text) {
+		try {
+			payload = JSON.parse(text);
+		} catch {
+			throw new Error(`Expected JSON from ${url.pathname}, got: ${text.slice(0, 200)}`);
+		}
+	}
+
+	if (!response.ok) {
+		throw new Error(`HTTP ${response.status} from ${url.pathname}: ${JSON.stringify(payload)}`);
+	}
+	return payload;
+}
+
+class CookieJar {
+	#cookies = new Map();
+
+	storeFrom(headers) {
+		const rawCookies = typeof headers.getSetCookie === 'function' ? headers.getSetCookie() : splitSetCookieHeader(headers.get('set-cookie'));
+
+		for (const cookie of rawCookies) {
+			const pair = cookie.split(';', 1)[0];
+			const index = pair.indexOf('=');
+			if (index === -1) {
+				continue;
+			}
+			this.#cookies.set(pair.slice(0, index), pair.slice(index + 1));
+		}
+	}
+
+	hasCookies() {
+		return this.#cookies.size > 0;
+	}
+
+	header() {
+		return [...this.#cookies.entries()].map(([key, value]) => `${key}=${value}`).join('; ');
+	}
+}
+
+function splitSetCookieHeader(header) {
+	if (!header) {
+		return [];
+	}
+	return header.split(/,(?=\s*[^;=]+=[^;]+)/g).map((value) => value.trim());
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+	"name": "html-to-aippt-composition-skill",
+	"version": "1.0.3",
+	"description": "",
+	"type": "module",
+	"bin": {
+		"html-to-aippt-composition-skill": "./bin/agentpower-skill.mjs"
+	},
+	"files": [
+		"bin/",
+		"html-to-aippt-composition/",
+		"README.md"
+	],
+	"scripts": {
+		"test": "node --test test/*.test.mjs",
+		"pack:dry-run": "npm pack --dry-run"
+	},
+	"engines": {
+		"node": ">=18"
+	},
+	"license": "UNLICENSED"
+}