@easytwin/devkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EasyTwin DevKit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# @easytwin/devkit
+
+EasyTwin 第三方应用开发工具集的核心包:lib(函数库)与 bin(`easytwin` 命令)双导出,供人类与 AI agent(如 Cursor / Claude Code / Codex)共同使用。设计蓝图见仓库根 `AGENTS.md`。
+
+## 安装
+
+```bash
+npm i -g @easytwin/devkit   # 全局安装 CLI
+```
+
+也可作为库安装:`npm i @easytwin/devkit`。
+
+## 命令
+
+| 命令 | 行为 |
+| --- | --- |
+| `easytwin init` | 交互式生成 `easytwin.config.json`,并追加进 `.gitignore`(无则创建) |
+| `easytwin scene list` | 列出凭据可见的场景 |
+| `easytwin scene pull <id> [--out <path>]` | 拉取场景 JSON 到本地 |
+| `easytwin upload <dir>` | 全量覆盖上传目录 |
+| `easytwin skills sync [--target cursor\|claude\|codex\|all]` | 同步 skills 到用户项目,缺省 all |
+
+## 配置
+
+项目根 `easytwin.config.json`:
+
+```json
+{
+  "appId": "必填",
+  "appSecret": "必填",
+  "baseUrl": "可选,缺省官方固定域名"
+}
+```
+
+环境变量 `EASYTWIN_APP_ID` / `EASYTWIN_APP_SECRET` / `EASYTWIN_BASE_URL` 优先于文件。文件含密钥,永不入库(`init` 会处理 gitignore)。
+
+## skills
+
+六件套(`easytwin-render` / `-core` / `-develop` / `-bootstrap` / `-scene` / `-upload`)随包分发,通过 `easytwin skills sync` 显式写入 Cursor(`.cursor/skills/`)、Claude Code(`.claude/skills/`)与 Codex(`AGENTS.md` 标记段),重复执行幂等。
+
+## 发布到 npm
+
+```bash
+# 1. 登录(写入 ~/.npmrc 的 npmjs token;CI 用 NPM_TOKEN 环境变量)
+npm login --registry https://registry.npmjs.org/
+
+# 2. 确认发布产物应包含 dist/ 与 skills/
+npm pack --dry-run
+
+# 3. 升版本
+npm version patch|minor|major
+
+# 4. 发布(发布前自动 build + test;publishConfig 已固定 public + npmjs)
+pnpm publish
+```
+
+- scoped 包需 publishConfig.access 为 public,已配置;
+- 本机默认 registry 是 npmmirror,publishConfig.registry 已固定为官方 npmjs;
+- 包名是否被占用可用 npm view @easytwin/devkit 确认;
+- repository 目前指向内网 GitLab,公网发布前建议改为公开地址(可选)。
+
+## 开发
+
+```bash
+pnpm install
+pnpm -r build
+pnpm -r test
+```
+
+## 已知外部输入(TODO)
+
+内部 swagger(API 契约)、渲染 API 文档与 d.ts、场景 JSON 格式、官方缺省域名——均未到位,代码中以 `TODO(swagger)` / `TODO(外部输入)` 标记,不臆造。

package/dist/bin.js

@@ -0,0 +1,586 @@
+#!/usr/bin/env node
+
+// src/bin.ts
+import { Command } from "commander";
+import { realpathSync } from "fs";
+import { readFile } from "fs/promises";
+import { createInterface } from "readline/promises";
+import { stdin, stdout } from "process";
+import { pathToFileURL } from "url";
+import path5 from "path";
+
+// src/config.ts
+import { promises as fs } from "fs";
+import path from "path";
+var CONFIG_FILE_NAME = "easytwin.config.json";
+var DEFAULT_BASE_URL = "https://api.easytwin.example.com";
+var ConfigError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ConfigError";
+  }
+};
+function configFilePath(cwd) {
+  return path.join(cwd, CONFIG_FILE_NAME);
+}
+function parseConfig(raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new ConfigError(`\u914D\u7F6E\u6587\u4EF6\u4E0D\u662F\u5408\u6CD5 JSON:${CONFIG_FILE_NAME}`);
+  }
+  return validateConfigShape(parsed);
+}
+function validateConfigShape(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new ConfigError("\u914D\u7F6E\u5FC5\u987B\u662F JSON \u5BF9\u8C61");
+  }
+  const v = value;
+  if (typeof v.appId !== "string" || v.appId.length === 0) {
+    throw new ConfigError("\u914D\u7F6E\u7F3A\u5C11\u5FC5\u586B\u5B57\u6BB5 appId");
+  }
+  if (typeof v.appSecret !== "string" || v.appSecret.length === 0) {
+    throw new ConfigError("\u914D\u7F6E\u7F3A\u5C11\u5FC5\u586B\u5B57\u6BB5 appSecret");
+  }
+  if (v.baseUrl !== void 0 && (typeof v.baseUrl !== "string" || v.baseUrl.length === 0)) {
+    throw new ConfigError("baseUrl \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32");
+  }
+  const config = { appId: v.appId, appSecret: v.appSecret };
+  if (typeof v.baseUrl === "string") config.baseUrl = v.baseUrl;
+  return config;
+}
+async function readConfigFile(cwd) {
+  const file = configFilePath(cwd);
+  let raw;
+  try {
+    raw = await fs.readFile(file, "utf8");
+  } catch {
+    throw new ConfigError(`\u672A\u627E\u5230\u914D\u7F6E\u6587\u4EF6 ${file},\u8BF7\u5148\u8FD0\u884C \`easytwin init\``);
+  }
+  return parseConfig(raw);
+}
+function resolveConfig(file, env = process.env) {
+  const appId = env.EASYTWIN_APP_ID ?? file.appId;
+  const appSecret = env.EASYTWIN_APP_SECRET ?? file.appSecret;
+  const baseUrl = env.EASYTWIN_BASE_URL ?? file.baseUrl ?? DEFAULT_BASE_URL;
+  if (!appId) throw new ConfigError("\u7F3A\u5C11 appId:\u914D\u7F6E\u6587\u4EF6\u4E2D\u672A\u63D0\u4F9B,\u4E14\u672A\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF EASYTWIN_APP_ID");
+  if (!appSecret) throw new ConfigError("\u7F3A\u5C11 appSecret:\u914D\u7F6E\u6587\u4EF6\u4E2D\u672A\u63D0\u4F9B,\u4E14\u672A\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF EASYTWIN_APP_SECRET");
+  const source = env.EASYTWIN_APP_ID !== void 0 || env.EASYTWIN_APP_SECRET !== void 0 ? "env" : "file";
+  return { appId, appSecret, baseUrl, source };
+}
+async function loadConfig(cwd, env = process.env) {
+  return resolveConfig(await readConfigFile(cwd), env);
+}
+async function writeConfigFile(cwd, config) {
+  const file = configFilePath(cwd);
+  const body = { appId: config.appId, appSecret: config.appSecret };
+  if (config.baseUrl) body.baseUrl = config.baseUrl;
+  await fs.mkdir(cwd, { recursive: true });
+  await fs.writeFile(file, JSON.stringify(body, null, 2) + "\n", "utf8");
+  return file;
+}
+var GITIGNORE_FILE_NAME = ".gitignore";
+var GITIGNORE_ENTRY = "easytwin.config.json";
+async function appendGitignore(cwd) {
+  const file = path.join(cwd, GITIGNORE_FILE_NAME);
+  let content = "";
+  let created = false;
+  try {
+    content = await fs.readFile(file, "utf8");
+  } catch {
+    created = true;
+  }
+  const lines = content.split(/\r?\n/);
+  if (lines.includes(GITIGNORE_ENTRY)) return { created, added: false };
+  const prefix = content.length > 0 && !content.endsWith("\n") ? "\n" : "";
+  await fs.writeFile(file, content + prefix + GITIGNORE_ENTRY + "\n", "utf8");
+  return { created, added: true };
+}
+async function initConfig(input, cwd) {
+  const validated = validateConfigShape(input);
+  const configFile = await writeConfigFile(cwd, validated);
+  const gitignore = await appendGitignore(cwd);
+  return { configFile, gitignore };
+}
+
+// src/client.ts
+import http from "http";
+import https from "https";
+import { URL as URL2 } from "url";
+var AUTH_HEADER = "Authorization";
+var BEARER_PREFIX = "Bearer";
+var APP_ID_HEADER = "X-Easytwin-App-Id";
+var ENDPOINTS = {
+  scenes: "/api/scenes",
+  scene: (id) => `/api/scenes/${encodeURIComponent(id)}`,
+  upload: "/api/upload"
+};
+var EasyTwinApiError = class extends Error {
+  status;
+  body;
+  constructor(status, message, body) {
+    super(message);
+    this.name = "EasyTwinApiError";
+    this.status = status;
+    this.body = body;
+  }
+};
+function messageFromBody(body) {
+  if (typeof body === "object" && body !== null) {
+    const m = body.message;
+    if (typeof m === "string") return m;
+  }
+  return void 0;
+}
+function parseResponseBody(buffer) {
+  const text = buffer.toString("utf8");
+  if (text.length === 0) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+var EasyTwinClient = class {
+  baseUrl;
+  appId;
+  appSecret;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+    this.appId = config.appId;
+    this.appSecret = config.appSecret;
+  }
+  /** 全仓唯一认证头注入点。 */
+  authHeaders() {
+    return {
+      [AUTH_HEADER]: `${BEARER_PREFIX} ${this.appSecret}`,
+      [APP_ID_HEADER]: this.appId
+    };
+  }
+  /** JSON 请求(原生 fetch)。 */
+  async request(path6, options = {}) {
+    const url = `${this.baseUrl}${path6}`;
+    const headers = { ...this.authHeaders(), ...options.headers };
+    if (options.body !== void 0 && options.body !== null && !("Content-Type" in headers)) {
+      headers["Content-Type"] = "application/json";
+    }
+    let res;
+    try {
+      res = await fetch(url, {
+        method: options.method ?? "GET",
+        headers,
+        body: options.body,
+        signal: options.signal
+      });
+    } catch (err) {
+      throw new EasyTwinApiError(0, `\u8BF7\u6C42\u5931\u8D25:${err instanceof Error ? err.message : String(err)}`);
+    }
+    return this.handleStatus(res.status, Buffer.from(await res.arrayBuffer()));
+  }
+  /**
+   * multipart 流式上传(手写 http 请求以支持逐字节进度回调)。
+   * 这是 fetch 上传的替代路径:原生 fetch 无法上报上传进度。
+   */
+  async upload(path6, options) {
+    const url = new URL2(`${this.baseUrl}${path6}`);
+    const mod = url.protocol === "https:" ? https : http;
+    const headers = {
+      ...this.authHeaders(),
+      "Content-Type": `multipart/form-data; boundary=${options.boundary}`,
+      "Content-Length": String(options.body.length)
+    };
+    const raw = await new Promise((resolve, reject) => {
+      const req = mod.request(url, { method: "POST", headers }, (res) => {
+        const chunks = [];
+        res.on("data", (c) => chunks.push(c));
+        res.on("end", () => resolve({ status: res.statusCode ?? 0, body: Buffer.concat(chunks) }));
+      });
+      req.on("error", reject);
+      const CHUNK = 64 * 1024;
+      let offset = 0;
+      const sendNext = () => {
+        if (offset >= options.body.length) {
+          req.end();
+          return;
+        }
+        const chunk = options.body.subarray(offset, offset + CHUNK);
+        offset += chunk.length;
+        req.write(chunk, () => {
+          options.onBytes?.(chunk.length);
+          sendNext();
+        });
+      };
+      sendNext();
+    });
+    return this.handleStatus(raw.status, raw.body);
+  }
+  handleStatus(status, body) {
+    if (status >= 200 && status < 300) return parseResponseBody(body);
+    const parsed = parseResponseBody(body);
+    throw new EasyTwinApiError(status, messageFromBody(parsed) ?? `HTTP ${status}`, parsed);
+  }
+};
+
+// src/scene.ts
+import { promises as fs2 } from "fs";
+import path2 from "path";
+function normalizeSceneList(data) {
+  const list = Array.isArray(data) ? data : data?.list;
+  if (!Array.isArray(list)) throw new Error("scene list \u54CD\u5E94\u7ED3\u6784\u65E0\u6CD5\u8BC6\u522B");
+  return list.map((item) => {
+    const it = item ?? {};
+    return { id: String(it.id ?? ""), name: String(it.name ?? it.id ?? "") };
+  });
+}
+function normalizeSceneDetail(data) {
+  const it = data ?? {};
+  return { id: String(it.id ?? ""), name: String(it.name ?? ""), payload: data };
+}
+async function listScenes(client) {
+  const data = await client.request(ENDPOINTS.scenes, { method: "GET" });
+  return normalizeSceneList(data);
+}
+async function pullScene(client, id) {
+  const data = await client.request(ENDPOINTS.scene(id), { method: "GET" });
+  return normalizeSceneDetail(data);
+}
+async function saveSceneJson(scene, out) {
+  await fs2.mkdir(path2.dirname(out), { recursive: true });
+  await fs2.writeFile(out, JSON.stringify(scene.payload ?? scene, null, 2) + "\n", "utf8");
+  return out;
+}
+
+// src/upload.ts
+import { promises as fs3 } from "fs";
+import path3 from "path";
+var DEFAULT_IGNORED_DIRS = /* @__PURE__ */ new Set([".git"]);
+async function collectFiles(dir, ignore = () => false) {
+  const files = [];
+  async function walk(current, rel) {
+    const entries = await fs3.readdir(current, { withFileTypes: true });
+    for (const entry of entries) {
+      const relPath = path3.posix.join(rel, entry.name);
+      if (ignore(relPath)) continue;
+      if (entry.isDirectory()) {
+        if (DEFAULT_IGNORED_DIRS.has(entry.name)) continue;
+        await walk(path3.join(current, entry.name), relPath);
+      } else if (entry.isFile()) {
+        const absPath = path3.join(current, entry.name);
+        const stat = await fs3.stat(absPath);
+        files.push({ relPath, absPath, size: stat.size });
+      }
+    }
+  }
+  await walk(dir, "");
+  files.sort((a, b) => a.relPath.localeCompare(b.relPath));
+  return files;
+}
+function buildMultipartBody(boundary, fields, file) {
+  const parts = [];
+  for (const [key, value] of Object.entries(fields)) {
+    parts.push(
+      Buffer.from(`--${boundary}\r
+Content-Disposition: form-data; name="${key}"\r
+\r
+${value}\r
+`, "utf8")
+    );
+  }
+  parts.push(
+    Buffer.from(
+      `--${boundary}\r
+Content-Disposition: form-data; name="file"; filename="${file.name}"\r
+Content-Type: application/octet-stream\r
+\r
+`,
+      "utf8"
+    )
+  );
+  parts.push(file.content);
+  parts.push(Buffer.from(`\r
+--${boundary}--\r
+`, "utf8"));
+  return Buffer.concat(parts);
+}
+async function uploadDirectory(client, dir, options = {}) {
+  const ignore = options.ignore ?? (() => false);
+  const files = await collectFiles(dir, ignore);
+  const total = files.reduce((sum, f) => sum + f.size, 0);
+  options.onProgress?.({ phase: "collect", current: total, total });
+  let sent = 0;
+  for (const file of files) {
+    const content = await fs3.readFile(file.absPath);
+    const boundary = `----easytwin${Date.now().toString(36)}${Math.random().toString(36).slice(2)}`;
+    const body = buildMultipartBody(
+      boundary,
+      // TODO(swagger): multipart 字段名/结构待定,当前为占位约定。
+      { path: file.relPath },
+      { name: path3.basename(file.relPath), content }
+    );
+    await client.upload(ENDPOINTS.upload, { boundary, body });
+    sent += file.size;
+    options.onProgress?.({ phase: "upload", current: sent, total, file: file.relPath });
+  }
+  return { fileCount: files.length, byteCount: sent };
+}
+
+// src/skills.ts
+import { promises as fs4 } from "fs";
+import path4 from "path";
+import { fileURLToPath } from "url";
+var SKILL_NAMES = [
+  "easytwin-render",
+  "easytwin-core",
+  "easytwin-develop",
+  "easytwin-bootstrap",
+  "easytwin-scene",
+  "easytwin-upload"
+];
+var CODEX_MARKER_BEGIN = "<!-- EASYTWIN-SKILLS:BEGIN -->";
+var CODEX_MARKER_END = "<!-- EASYTWIN-SKILLS:END -->";
+var META_FILE_NAME = ".easytwin-meta.json";
+function normalizeTargets(target = "all") {
+  if (target === "all") return ["cursor", "claude", "codex"];
+  if (Array.isArray(target)) return [...new Set(target)];
+  return [target];
+}
+function resolveSkillsSourceDir() {
+  if (typeof import.meta.url !== "string" || import.meta.url.length === 0) {
+    throw new Error("\u65E0\u6CD5\u5B9A\u4F4D skills \u6E90\u76EE\u5F55:\u63D2\u4EF6(bundle/CJS)\u573A\u666F\u5FC5\u987B\u663E\u5F0F\u4F20\u5165 sourceDir");
+  }
+  const here = path4.dirname(fileURLToPath(import.meta.url));
+  return path4.resolve(here, "..", "skills");
+}
+async function readJson(file) {
+  return JSON.parse(await fs4.readFile(file, "utf8"));
+}
+async function readDevkitVersion(skillsDir = resolveSkillsSourceDir()) {
+  const marker = path4.join(skillsDir, ".easytwin-source.json");
+  try {
+    const meta = await readJson(marker);
+    if (typeof meta.version === "string") return meta.version;
+  } catch {
+  }
+  try {
+    const pkg = await readJson(path4.resolve(skillsDir, "..", "package.json"));
+    return pkg.version;
+  } catch {
+    return "0.0.0";
+  }
+}
+async function copyDir(src, dest) {
+  await fs4.mkdir(dest, { recursive: true });
+  const entries = await fs4.readdir(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const s = path4.join(src, entry.name);
+    const d = path4.join(dest, entry.name);
+    if (entry.isDirectory()) await copyDir(s, d);
+    else if (entry.isFile()) await fs4.copyFile(s, d);
+  }
+}
+async function dirMatches(src, dest) {
+  let sourceEntries;
+  try {
+    sourceEntries = await fs4.readdir(src);
+  } catch {
+    return false;
+  }
+  for (const name of sourceEntries) {
+    const s = path4.join(src, name);
+    const d = path4.join(dest, name);
+    const sStat = await fs4.stat(s);
+    if (sStat.isDirectory()) {
+      if (!await dirMatches(s, d)) return false;
+    } else {
+      let dStat;
+      try {
+        dStat = await fs4.stat(d);
+      } catch {
+        return false;
+      }
+      if (!sStat.isFile() || !dStat.isFile() || sStat.size !== dStat.size) return false;
+      if (!(await fs4.readFile(s)).equals(await fs4.readFile(d))) return false;
+    }
+  }
+  return true;
+}
+function actionFor(exists, matches) {
+  if (!exists) return "created";
+  return matches ? "unchanged" : "updated";
+}
+async function writeMeta(destDir, version) {
+  const meta = { name: "@easytwin/devkit", version };
+  await fs4.writeFile(path4.join(destDir, META_FILE_NAME), JSON.stringify(meta, null, 2) + "\n", "utf8");
+}
+async function syncToDir(target, sourceRoot, targetRoot, version) {
+  const entries = [];
+  for (const name of SKILL_NAMES) {
+    const src = path4.join(sourceRoot, name);
+    const dest = path4.join(targetRoot, name);
+    const exists = await fs4.stat(dest).then(() => true).catch(() => false);
+    const matches = await dirMatches(src, dest);
+    const action = actionFor(exists, matches);
+    if (action !== "unchanged") {
+      await fs4.rm(dest, { recursive: true, force: true });
+      await copyDir(src, dest);
+    }
+    entries.push({ name, action });
+  }
+  await writeMeta(targetRoot, version);
+  return { target, entries };
+}
+function buildCodexSegment(version) {
+  return [
+    CODEX_MARKER_BEGIN,
+    "<!-- \u672C\u6BB5\u7531 `easytwin skills sync` \u7BA1\u7406,\u53EF\u6574\u6BB5\u66FF\u6362;\u624B\u52A8\u4FEE\u6539\u4F1A\u88AB\u4E0B\u6B21\u540C\u6B65\u8986\u76D6\u3002 -->",
+    `EasyTwin \u5F00\u53D1\u6280\u80FD(\u7531 @easytwin/devkit v${version} \u540C\u6B65):`,
+    "",
+    "- `easytwin-develop`:\u5DE5\u4F5C\u6D41\u603B\u7EB2,\u5F00\u59CB EasyTwin \u5F00\u53D1\u524D\u5FC5\u8BFB\u3002",
+    "- `easytwin-bootstrap`:\u521D\u59CB\u5316\u5E94\u7528\u7EA7\u51ED\u8BC1(easytwin.config.json)\u3002",
+    "- `easytwin-scene`:\u5217\u51FA\u573A\u666F\u3001\u62C9\u53D6\u573A\u666F JSON\u3002",
+    "- `easytwin-render`:\u7528 twin runtime \u5F00\u53D1\u6E32\u67D3\u529F\u80FD(\u4E3B\u529B)\u3002",
+    "- `easytwin-core`:\u5F15\u64CE\u5185\u6838 API(RuntimeEngine/\u57FA\u7C7B/Time/\u76F8\u673A/\u7269\u7406)\u3002",
+    "- `easytwin-upload`:\u5168\u91CF\u4E0A\u4F20\u5F00\u53D1\u4EA7\u7269\u76EE\u5F55(\u8986\u76D6\u4E0D\u53EF\u9006)\u3002",
+    "",
+    "\u8BE6\u7EC6\u7528\u6CD5\u89C1\u5404\u6280\u80FD;\u91CD\u65B0\u540C\u6B65\u8FD0\u884C `easytwin skills sync --target codex`\u3002",
+    CODEX_MARKER_END
+  ].join("\n");
+}
+async function syncToCodex(sourceRoot, cwd, version) {
+  const agentsFile = path4.join(cwd, "AGENTS.md");
+  const segment = buildCodexSegment(version);
+  let content = "";
+  let exists = true;
+  try {
+    content = await fs4.readFile(agentsFile, "utf8");
+  } catch {
+    exists = false;
+  }
+  const start = content.indexOf(CODEX_MARKER_BEGIN);
+  const end = content.indexOf(CODEX_MARKER_END);
+  let action;
+  let next;
+  if (start === -1 || end === -1 || end < start) {
+    action = exists ? "updated" : "created";
+    next = content.length > 0 && !content.endsWith("\n") ? content + "\n\n" : content + (content.length > 0 ? "\n" : "");
+    next += segment + "\n";
+  } else {
+    const current = content.slice(start, end + CODEX_MARKER_END.length);
+    action = current === segment ? "unchanged" : "updated";
+    next = content.slice(0, start) + segment + content.slice(end + CODEX_MARKER_END.length);
+  }
+  if (action !== "unchanged") {
+    await fs4.mkdir(cwd, { recursive: true });
+    await fs4.writeFile(agentsFile, next, "utf8");
+  }
+  return { target: "codex", entries: [], codex: { name: "AGENTS.md", action } };
+}
+async function syncSkills(options) {
+  const targets = normalizeTargets(options.targets ?? "all");
+  const sourceRoot = options.sourceDir ?? resolveSkillsSourceDir();
+  const version = options.version ?? await readDevkitVersion(sourceRoot);
+  const summaries = [];
+  for (const target of targets) {
+    if (target === "cursor") summaries.push(await syncToDir("cursor", sourceRoot, path4.join(options.cwd, ".cursor", "skills"), version));
+    else if (target === "claude") summaries.push(await syncToDir("claude", sourceRoot, path4.join(options.cwd, ".claude", "skills"), version));
+    else summaries.push(await syncToCodex(sourceRoot, options.cwd, version));
+  }
+  return summaries;
+}
+
+// src/bin.ts
+async function readVersion() {
+  try {
+    const pkg = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8"));
+    return pkg.version;
+  } catch {
+    return "0.0.0";
+  }
+}
+async function prompt(question) {
+  const rl = createInterface({ input: stdin, output: stdout });
+  try {
+    return (await rl.question(question)).trim();
+  } finally {
+    rl.close();
+  }
+}
+async function runInit(cwd, flags) {
+  const appId = flags.appId ?? await prompt("App ID: ");
+  const appSecret = flags.appSecret ?? await prompt("App Secret: ");
+  const baseUrlInput = flags.baseUrl ?? await prompt(`Base URL(\u7F3A\u7701 ${DEFAULT_BASE_URL}): `);
+  const input = { appId, appSecret };
+  if (baseUrlInput.trim().length > 0) input.baseUrl = baseUrlInput.trim();
+  const result = await initConfig(input, cwd);
+  console.log(`\u5DF2\u751F\u6210 ${result.configFile}`);
+  console.log(
+    result.gitignore.added ? `\u5DF2\u628A ${CONFIG_FILE_NAME} \u8FFD\u52A0\u8FDB .gitignore(\u9632\u6B62\u5BC6\u94A5\u5165\u5E93)` : `.gitignore \u5DF2\u5305\u542B ${CONFIG_FILE_NAME}`
+  );
+}
+function buildProgram(cwd, version = "0.0.0") {
+  const program = new Command();
+  program.name("easytwin").description("EasyTwin DevKit \u547D\u4EE4\u884C\u5DE5\u5177").version(version, "-V, --version");
+  program.command("init").description("\u4EA4\u4E92\u5F0F\u751F\u6210 easytwin.config.json,\u5E76\u8FFD\u52A0\u8FDB .gitignore").option("--app-id <id>", "App ID(\u8DF3\u8FC7\u4EA4\u4E92)").option("--app-secret <secret>", "App Secret(\u8DF3\u8FC7\u4EA4\u4E92)").option("--base-url <url>", "Base URL(\u8DF3\u8FC7\u4EA4\u4E92)").action((opts) => runInit(cwd, opts));
+  const scene = program.command("scene").description("\u573A\u666F\u7BA1\u7406");
+  scene.command("list").description("\u5217\u51FA\u51ED\u636E\u53EF\u89C1\u7684\u573A\u666F").action(async () => {
+    const config = await loadConfig(cwd);
+    const client = new EasyTwinClient(config);
+    const scenes = await listScenes(client);
+    if (scenes.length === 0) {
+      console.log("(\u65E0\u573A\u666F)");
+      return;
+    }
+    for (const s of scenes) console.log(`${s.id}	${s.name}`);
+  });
+  scene.command("pull <id>").description("\u62C9\u53D6\u573A\u666F JSON \u5230\u672C\u5730").option("-o, --out <path>", "\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84(\u7F3A\u7701 ./<id>.scene.json)").action(async (id, opts) => {
+    const config = await loadConfig(cwd);
+    const client = new EasyTwinClient(config);
+    const scene2 = await pullScene(client, id);
+    const out = opts.out ?? path5.join(cwd, `${id}.scene.json`);
+    const file = await saveSceneJson(scene2, out);
+    console.log(`\u5DF2\u4FDD\u5B58\u5230 ${file}`);
+  });
+  program.command("upload <dir>").description("\u5168\u91CF\u8986\u76D6\u4E0A\u4F20\u76EE\u5F55(\u4E0D\u53EF\u9006)").action(async (dir) => {
+    const config = await loadConfig(cwd);
+    const client = new EasyTwinClient(config);
+    await uploadDirectory(client, dir, {
+      onProgress: (p) => {
+        if (p.phase === "upload") {
+          process.stderr.write(`\r\u5DF2\u4E0A\u4F20 ${p.current}/${p.total} bytes${p.file ? ` (${p.file})` : ""}`);
+        }
+      }
+    });
+    process.stderr.write("\n");
+  });
+  const skills = program.command("skills").description("skills \u540C\u6B65\u5230\u7528\u6237\u9879\u76EE");
+  skills.command("sync").description("\u540C\u6B65 skills \u5230\u7528\u6237\u9879\u76EE(cursor/claude/codex),\u7F3A\u7701 all").option("--target <target>", "cursor|claude|codex|all", "all").action(async (opts) => {
+    const summaries = await syncSkills({ cwd, targets: opts.target });
+    for (const s of summaries) {
+      if (s.codex) {
+        console.log(`[codex] AGENTS.md: ${s.codex.action}`);
+        continue;
+      }
+      for (const e of s.entries) console.log(`[${s.target}] ${e.name}: ${e.action}`);
+    }
+  });
+  return program;
+}
+async function main(argv, cwd = process.cwd()) {
+  const version = await readVersion();
+  const program = buildProgram(cwd, version);
+  await program.parseAsync(argv, { from: "user" });
+}
+var isMain = process.argv[1] !== void 0 && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href;
+if (isMain) {
+  main(process.argv.slice(2)).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exitCode = 1;
+  });
+}
+export {
+  buildProgram,
+  main,
+  runInit
+};
+//# sourceMappingURL=bin.js.map