@easytwin/devkit 0.1.0 → 0.1.1

package/README.md

@@ -28,11 +28,13 @@ npm i -g @easytwin/devkit   # 全局安装 CLI
 {
   "appId": "必填",
   "appSecret": "必填",
-  "baseUrl": "可选,缺省官方固定域名"
+  "env": "可选,prod=正式 / test=测试,缺省 prod",
+  "baseUrl": "可选,缺省按 env 选官方域名",
+  "ossUrl": "可选,缺省官方 OSS"
 }
 ```
 
-环境变量 `EASYTWIN_APP_ID` / `EASYTWIN_APP_SECRET` / `EASYTWIN_BASE_URL` 优先于文件。文件含密钥,永不入库(`init` 会处理 gitignore)。
+环境变量 `EASYTWIN_APP_ID` / `EASYTWIN_APP_SECRET` / `EASYTWIN_BASE_URL` / `EASYTWIN_ENV` / `EASYTWIN_OSS_URL` 优先于文件。官方 API:正式 `http://saas-twin.k8s.dtstack.cn/`、测试 `http://saas-twin-test.k8s.dtstack.cn/`,缺省按 env 选择。官方 OSS:`https://dt-easyv-test.oss-cn-hangzhou.aliyuncs.com/`,供 twin runtime 加载 webp/draco/组件脚本。文件含密钥,永不入库(`init` 会处理 gitignore)。
 
 ## skills
 
@@ -50,8 +52,9 @@ npm pack --dry-run
 # 3. 升版本
 npm version patch|minor|major
 
-# 4. 发布(发布前自动 build + test;publishConfig 已固定 public + npmjs)
-pnpm publish
+# 4. 发布(必须先升版本:同版本已在 npm 上会被跳过,提示 There are no new packages that should be published)
+# 在仓库根目录用 run,不要直接 pnpm publish(那是工作区递归发布内置命令)
+pnpm run publish
 ```
 
 - scoped 包需 publishConfig.access 为 public,已配置;
@@ -69,4 +72,4 @@ pnpm -r test
 
 ## 已知外部输入(TODO)
 
-内部 swagger(API 契约)、渲染 API 文档与 d.ts、场景 JSON 格式、官方缺省域名——均未到位,代码中以 `TODO(swagger)` / `TODO(外部输入)` 标记,不臆造。
+内部 swagger(API 契约)、渲染 API 文档与 d.ts——均未到位,代码中以 `TODO(swagger)` / `TODO(外部输入)` 标记,不臆造;官方 API 域名、官方 OSS 与场景 JSON 格式已定(见上)。

package/dist/bin.js

@@ -7,13 +7,20 @@ import { readFile } from "fs/promises";
 import { createInterface } from "readline/promises";
 import { stdin, stdout } from "process";
 import { pathToFileURL } from "url";
-import path5 from "path";
+import path6 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 DEFAULT_BASE_URL = "http://saas-twin.k8s.dtstack.cn/";
+var TEST_BASE_URL = "http://saas-twin-test.k8s.dtstack.cn/";
+var DEFAULT_OSS_URL = "https://dt-easyv-test.oss-cn-hangzhou.aliyuncs.com/";
+var MOCK_APP_ID = "test";
+var MOCK_APP_SECRET = "test";
+function isMockCredentials(appId, appSecret) {
+  return appId === MOCK_APP_ID && appSecret === MOCK_APP_SECRET;
+}
 var ConfigError = class extends Error {
   constructor(message) {
     super(message);
@@ -46,8 +53,16 @@ function validateConfigShape(value) {
   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");
   }
+  if (v.ossUrl !== void 0 && (typeof v.ossUrl !== "string" || v.ossUrl.length === 0)) {
+    throw new ConfigError("ossUrl \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32");
+  }
+  if (v.env !== void 0 && v.env !== "prod" && v.env !== "test") {
+    throw new ConfigError("env \u5FC5\u987B\u662F prod \u6216 test");
+  }
   const config = { appId: v.appId, appSecret: v.appSecret };
+  if (v.env === "prod" || v.env === "test") config.env = v.env;
   if (typeof v.baseUrl === "string") config.baseUrl = v.baseUrl;
+  if (typeof v.ossUrl === "string") config.ossUrl = v.ossUrl;
   return config;
 }
 async function readConfigFile(cwd) {
@@ -63,11 +78,13 @@ async function readConfigFile(cwd) {
 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;
+  const easyEnv = env.EASYTWIN_ENV === "test" || env.EASYTWIN_ENV === "prod" ? env.EASYTWIN_ENV : file.env ?? "prod";
+  const baseUrl = env.EASYTWIN_BASE_URL ?? file.baseUrl ?? (easyEnv === "test" ? TEST_BASE_URL : DEFAULT_BASE_URL);
+  const ossUrl = env.EASYTWIN_OSS_URL ?? file.ossUrl ?? DEFAULT_OSS_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 };
+  return { appId, appSecret, baseUrl, ossUrl, mock: isMockCredentials(appId, appSecret), source };
 }
 async function loadConfig(cwd, env = process.env) {
   return resolveConfig(await readConfigFile(cwd), env);
@@ -75,7 +92,9 @@ async function loadConfig(cwd, env = process.env) {
 async function writeConfigFile(cwd, config) {
   const file = configFilePath(cwd);
   const body = { appId: config.appId, appSecret: config.appSecret };
+  if (config.env) body.env = config.env;
   if (config.baseUrl) body.baseUrl = config.baseUrl;
+  if (config.ossUrl) body.ossUrl = config.ossUrl;
   await fs.mkdir(cwd, { recursive: true });
   await fs.writeFile(file, JSON.stringify(body, null, 2) + "\n", "utf8");
   return file;
@@ -144,10 +163,13 @@ function parseResponseBody(buffer) {
 }
 var EasyTwinClient = class {
   baseUrl;
+  /** 本地测试模式:true 时 scene/upload 走本地 mock,不发网络请求(见 config.ts)。 */
+  mock;
   appId;
   appSecret;
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+    this.mock = config.mock;
     this.appId = config.appId;
     this.appSecret = config.appSecret;
   }
@@ -159,8 +181,8 @@ var EasyTwinClient = class {
     };
   }
   /** JSON 请求(原生 fetch)。 */
-  async request(path6, options = {}) {
-    const url = `${this.baseUrl}${path6}`;
+  async request(path7, options = {}) {
+    const url = `${this.baseUrl}${path7}`;
     const headers = { ...this.authHeaders(), ...options.headers };
     if (options.body !== void 0 && options.body !== null && !("Content-Type" in headers)) {
       headers["Content-Type"] = "application/json";
@@ -182,8 +204,8 @@ var EasyTwinClient = class {
    * multipart 流式上传(手写 http 请求以支持逐字节进度回调)。
    * 这是 fetch 上传的替代路径:原生 fetch 无法上报上传进度。
    */
-  async upload(path6, options) {
-    const url = new URL2(`${this.baseUrl}${path6}`);
+  async upload(path7, options) {
+    const url = new URL2(`${this.baseUrl}${path7}`);
     const mod = url.protocol === "https:" ? https : http;
     const headers = {
       ...this.authHeaders(),
@@ -225,6 +247,7 @@ var EasyTwinClient = class {
 // src/scene.ts
 import { promises as fs2 } from "fs";
 import path2 from "path";
+import { fileURLToPath } from "url";
 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");
@@ -237,11 +260,50 @@ function normalizeSceneDetail(data) {
   const it = data ?? {};
   return { id: String(it.id ?? ""), name: String(it.name ?? ""), payload: data };
 }
-async function listScenes(client) {
+var EXAMPLE_SCENE_FILE = "scene.example.json";
+var MOCK_SCENE_NAME = "\u672C\u5730\u793A\u4F8B\u573A\u666F";
+function resolveExampleScenePath() {
+  if (typeof import.meta.url !== "string" || import.meta.url.length === 0) {
+    throw new Error(`\u65E0\u6CD5\u5B9A\u4F4D ${EXAMPLE_SCENE_FILE}:\u63D2\u4EF6(bundle/CJS)\u573A\u666F\u5FC5\u987B\u663E\u5F0F\u4F20\u5165 exampleFile`);
+  }
+  return path2.resolve(path2.dirname(fileURLToPath(import.meta.url)), "..", EXAMPLE_SCENE_FILE);
+}
+async function loadExampleScene(exampleFile) {
+  const file = exampleFile ?? resolveExampleScenePath();
+  let raw;
+  try {
+    raw = await fs2.readFile(file, "utf8");
+  } catch {
+    throw new Error(`\u65E0\u6CD5\u8BFB\u53D6\u672C\u5730\u793A\u4F8B\u573A\u666F ${file}(\u672C\u5730\u6D4B\u8BD5\u6A21\u5F0F\u9700\u8981 devkit \u5305\u5185\u7684 ${EXAMPLE_SCENE_FILE})`);
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`\u672C\u5730\u793A\u4F8B\u573A\u666F\u4E0D\u662F\u5408\u6CD5 JSON:${file}`);
+  }
+}
+function deriveExampleSceneId(payload) {
+  const root = payload ?? {};
+  const id = root?.objs?.map((o) => o.sceneId).find((s) => typeof s === "string" && s.length > 0);
+  return id ?? "local";
+}
+async function exampleSceneSummary(exampleFile) {
+  return { id: deriveExampleSceneId(await loadExampleScene(exampleFile)), name: MOCK_SCENE_NAME };
+}
+async function listScenes(client, options = {}) {
+  if (client.mock) return [await exampleSceneSummary(options.exampleFile)];
   const data = await client.request(ENDPOINTS.scenes, { method: "GET" });
   return normalizeSceneList(data);
 }
-async function pullScene(client, id) {
+async function pullScene(client, id, options = {}) {
+  if (client.mock) {
+    const payload = await loadExampleScene(options.exampleFile);
+    const sceneId = deriveExampleSceneId(payload);
+    if (sceneId !== id) {
+      throw new Error(`\u672C\u5730\u6D4B\u8BD5\u6A21\u5F0F:\u793A\u4F8B\u573A\u666F id \u4E3A ${sceneId},\u6536\u5230 ${id}(\u672C\u5730\u4EC5\u63D0\u4F9B ${EXAMPLE_SCENE_FILE} \u8FD9\u4E00\u4E2A\u573A\u666F)`);
+    }
+    return { id: sceneId, name: MOCK_SCENE_NAME, payload };
+  }
   const data = await client.request(ENDPOINTS.scene(id), { method: "GET" });
   return normalizeSceneDetail(data);
 }
@@ -303,7 +365,16 @@ Content-Type: application/octet-stream\r
 `, "utf8"));
   return Buffer.concat(parts);
 }
+async function mockUpload(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 });
+  options.onProgress?.({ phase: "upload", current: total, total });
+  return { fileCount: files.length, byteCount: total, mock: true };
+}
 async function uploadDirectory(client, dir, options = {}) {
+  if (client.mock) return mockUpload(dir, options);
   const ignore = options.ignore ?? (() => false);
   const files = await collectFiles(dir, ignore);
   const total = files.reduce((sum, f) => sum + f.size, 0);
@@ -326,9 +397,9 @@ async function uploadDirectory(client, dir, options = {}) {
 }
 
 // src/skills.ts
-import { promises as fs4 } from "fs";
+import { existsSync, promises as fs4 } from "fs";
 import path4 from "path";
-import { fileURLToPath } from "url";
+import { fileURLToPath as fileURLToPath2 } from "url";
 var SKILL_NAMES = [
   "easytwin-render",
   "easytwin-core",
@@ -340,8 +411,47 @@ var SKILL_NAMES = [
 var CODEX_MARKER_BEGIN = "<!-- EASYTWIN-SKILLS:BEGIN -->";
 var CODEX_MARKER_END = "<!-- EASYTWIN-SKILLS:END -->";
 var META_FILE_NAME = ".easytwin-meta.json";
+var MINIMAL_TSCONFIG = `${JSON.stringify(
+  {
+    compilerOptions: {
+      target: "ES2022",
+      module: "ESNext",
+      moduleResolution: "bundler",
+      strict: true,
+      skipLibCheck: true,
+      noEmit: true,
+      paths: {
+        "@easytwin/runtime": [".easytwin/types"]
+      }
+    },
+    include: ["src/**/*.ts"]
+  },
+  null,
+  2
+)}
+`;
+var TSCONFIG_PATHS_HINT = `\u5DF2\u6709 tsconfig.json,\u672A\u6539\u52A8\u3002\u8BF7\u5728 compilerOptions \u4E2D\u52A0\u5165:
+  "skipLibCheck": true,
+  "paths": {
+    "@easytwin/runtime": [".easytwin/types"]
+  }`;
+var RUN_CONTEXT_DECL = `
+/** \u9884\u89C8\u9875 Run \u6309\u94AE\u6CE8\u5165\u7684\u8FD0\u884C\u4E0A\u4E0B\u6587(\u89C1 D12)\u3002 */
+export interface EasyTwinRunContext {
+    engine: RuntimeEngine;
+    runtime: typeof import("@easytwin/runtime");
+    sceneJson: SceneJson;
+}
+`;
+function buildRuntimeTypesContent(sourceDts) {
+  const trimmed = sourceDts.replace(/\s+$/, "");
+  if (trimmed.includes("export interface EasyTwinRunContext")) return `${trimmed}
+`;
+  return `${trimmed}
+${RUN_CONTEXT_DECL}`;
+}
 function normalizeTargets(target = "all") {
-  if (target === "all") return ["cursor", "claude", "codex"];
+  if (target === "all") return ["cursor", "claude", "codex", "qoder"];
   if (Array.isArray(target)) return [...new Set(target)];
   return [target];
 }
@@ -349,9 +459,20 @@ 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));
+  const here = path4.dirname(fileURLToPath2(import.meta.url));
   return path4.resolve(here, "..", "skills");
 }
+function resolveRuntimeTypesSourceFile() {
+  if (typeof import.meta.url !== "string" || import.meta.url.length === 0) {
+    throw new Error("\u65E0\u6CD5\u5B9A\u4F4D runtime \u7C7B\u578B:\u63D2\u4EF6(bundle/CJS)\u573A\u666F\u5FC5\u987B\u663E\u5F0F\u4F20\u5165 typesSourceFile");
+  }
+  const here = path4.dirname(fileURLToPath2(import.meta.url));
+  const fromDist = path4.join(here, "runtime-types", "index.d.ts");
+  const fromSrc = path4.resolve(here, "lib", "index.d.ts");
+  if (existsSync(fromDist)) return fromDist;
+  if (existsSync(fromSrc)) return fromSrc;
+  throw new Error(`\u65E0\u6CD5\u5B9A\u4F4D runtime \u7C7B\u578B\u58F0\u660E,\u5DF2\u5C1D\u8BD5:${fromDist}, ${fromSrc}`);
+}
 async function readJson(file) {
   return JSON.parse(await fs4.readFile(file, "utf8"));
 }
@@ -476,6 +597,38 @@ async function syncToCodex(sourceRoot, cwd, version) {
   }
   return { target: "codex", entries: [], codex: { name: "AGENTS.md", action } };
 }
+async function syncRuntimeTypes(cwd, typesSourceFile) {
+  const destDir = path4.join(cwd, ".easytwin", "types");
+  const destFile = path4.join(destDir, "index.d.ts");
+  const content = buildRuntimeTypesContent(await fs4.readFile(typesSourceFile, "utf8"));
+  let exists = true;
+  let current = "";
+  try {
+    current = await fs4.readFile(destFile, "utf8");
+  } catch {
+    exists = false;
+  }
+  const action = actionFor(exists, current === content);
+  if (action !== "unchanged") {
+    await fs4.mkdir(destDir, { recursive: true });
+    await fs4.writeFile(destFile, content, "utf8");
+  }
+  const tsconfigPath = path4.join(cwd, "tsconfig.json");
+  let tsconfig;
+  let pathsHint;
+  try {
+    const existing = await fs4.readFile(tsconfigPath, "utf8");
+    if (existing === MINIMAL_TSCONFIG) tsconfig = "unchanged";
+    else {
+      tsconfig = "manual-paths";
+      pathsHint = TSCONFIG_PATHS_HINT;
+    }
+  } catch {
+    await fs4.writeFile(tsconfigPath, MINIMAL_TSCONFIG, "utf8");
+    tsconfig = "created";
+  }
+  return { action, tsconfig, pathsHint };
+}
 async function syncSkills(options) {
   const targets = normalizeTargets(options.targets ?? "all");
   const sourceRoot = options.sourceDir ?? resolveSkillsSourceDir();
@@ -484,9 +637,106 @@ async function syncSkills(options) {
   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 if (target === "qoder") summaries.push(await syncToDir("qoder", sourceRoot, path4.join(options.cwd, ".qoder", "skills"), version));
     else summaries.push(await syncToCodex(sourceRoot, options.cwd, version));
   }
-  return summaries;
+  const types = await syncRuntimeTypes(options.cwd, options.typesSourceFile ?? resolveRuntimeTypesSourceFile());
+  return { summaries, types };
+}
+
+// src/bundle.ts
+import * as esbuild from "esbuild-wasm";
+import { promises as fs5 } from "fs";
+import path5 from "path";
+var USER_ENTRY = "src/main.ts";
+var DEFAULT_BUNDLE_OUT = "dist/main.js";
+var RUNTIME_MODULE = "@easytwin/runtime";
+var BundleError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "BundleError";
+  }
+};
+function isRelativeOrAbsolute(spec) {
+  return spec.startsWith("./") || spec.startsWith("../") || spec.startsWith("/") || path5.isAbsolute(spec);
+}
+function whitelistPlugin() {
+  return {
+    name: "easytwin-whitelist",
+    setup(build2) {
+      build2.onResolve({ filter: /.*/ }, (args) => {
+        if (args.kind === "entry-point") return void 0;
+        if (isRelativeOrAbsolute(args.path)) return void 0;
+        if (args.path === RUNTIME_MODULE) return { path: args.path, external: true };
+        return {
+          errors: [
+            {
+              text: `\u68C0\u6D4B\u5230\u5916\u90E8\u4F9D\u8D56 ${args.path},\u7528\u6237\u4EE3\u7801\u53EA\u80FD\u4F9D\u8D56 @easytwin/runtime\u3002\u4E0D\u8981 npm install,\u7C7B\u578B\u7531 easytwin skills sync \u5206\u53D1,\u8FD0\u884C\u8D70\u9884\u89C8\u9875 Run \u6216 easytwin bundle\u3002`
+            }
+          ]
+        };
+      });
+    }
+  };
+}
+function formatEsbuildMessages(messages) {
+  return messages.map((m) => {
+    const loc = m.location ? `${m.location.file}:${m.location.line}:${m.location.column}: ` : "";
+    return `${loc}${m.text}`;
+  }).join("\n");
+}
+async function bundleUserCode(options) {
+  const cwd = path5.resolve(options.cwd);
+  const entry = path5.join(cwd, USER_ENTRY);
+  try {
+    await fs5.access(entry);
+  } catch {
+    throw new BundleError(
+      `\u672A\u627E\u5230\u5165\u53E3\u6587\u4EF6 ${entry}\u3002\u8BF7\u5728\u5DE5\u4F5C\u533A\u521B\u5EFA src/main.ts,\u5E76 \`export default async function main(ctx)\`\u3002`
+    );
+  }
+  let result;
+  try {
+    result = await esbuild.build({
+      absWorkingDir: cwd,
+      entryPoints: [entry],
+      bundle: true,
+      write: false,
+      format: "esm",
+      platform: "browser",
+      target: "es2022",
+      sourcemap: "inline",
+      logLevel: "silent",
+      plugins: [whitelistPlugin()]
+    });
+  } catch (err) {
+    const errors = err.errors;
+    if (Array.isArray(errors) && errors.length > 0) {
+      throw new BundleError(formatEsbuildMessages(errors));
+    }
+    throw err instanceof Error ? new BundleError(err.message) : err;
+  }
+  if (result.errors.length > 0) {
+    throw new BundleError(formatEsbuildMessages(result.errors));
+  }
+  const file = result.outputFiles?.[0];
+  if (!file) throw new BundleError("\u6253\u5305\u672A\u4EA7\u51FA\u6587\u4EF6");
+  const code = file.text;
+  const warnings = result.warnings.map((w) => formatEsbuildMessages([w]));
+  if (options.outFile) {
+    const outFile = path5.isAbsolute(options.outFile) ? options.outFile : path5.join(cwd, options.outFile);
+    await fs5.mkdir(path5.dirname(outFile), { recursive: true });
+    await fs5.writeFile(outFile, code, "utf8");
+  }
+  return { code, warnings };
+}
+async function typesMissingHint(cwd) {
+  try {
+    await fs5.access(path5.join(cwd, ".easytwin", "types", "index.d.ts"));
+    return void 0;
+  } catch {
+    return "\u672A\u627E\u5230 .easytwin/types,\u8FD0\u884C `easytwin skills sync` \u4EE5\u5206\u53D1 @easytwin/runtime \u7C7B\u578B\u58F0\u660E\u3002";
+  }
 }
 
 // src/bin.ts
@@ -498,6 +748,7 @@ async function readVersion() {
     return "0.0.0";
   }
 }
+var MOCK_MODE_HINT = "[\u672C\u5730\u6D4B\u8BD5\u6A21\u5F0F] appId/appSecret \u5747\u4E3A test:\u672A\u8BF7\u6C42\u670D\u52A1\u7AEF,\u573A\u666F/\u4E0A\u4F20\u8D70\u672C\u5730 mock";
 async function prompt(question) {
   const rl = createInterface({ input: stdin, output: stdout });
   try {
@@ -509,8 +760,17 @@ async function prompt(question) {
 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}): `);
+  let env = "prod";
+  if (flags.env !== void 0) {
+    env = flags.env.toLowerCase() === "test" ? "test" : "prod";
+  } else if (flags.baseUrl === void 0) {
+    const envRaw = (await prompt("\u73AF\u5883(prod=\u6B63\u5F0F / test=\u6D4B\u8BD5,\u7F3A\u7701 prod): ")).trim().toLowerCase();
+    env = envRaw === "test" ? "test" : "prod";
+  }
+  const defaultUrl = env === "test" ? TEST_BASE_URL : DEFAULT_BASE_URL;
+  const baseUrlInput = flags.baseUrl ?? await prompt(`Base URL(\u7F3A\u7701 ${defaultUrl}): `);
   const input = { appId, appSecret };
+  if (env === "test") input.env = "test";
   if (baseUrlInput.trim().length > 0) input.baseUrl = baseUrlInput.trim();
   const result = await initConfig(input, cwd);
   console.log(`\u5DF2\u751F\u6210 ${result.configFile}`);
@@ -521,10 +781,11 @@ async function runInit(cwd, flags) {
 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));
+  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("--env <prod|test>", "\u670D\u52A1\u73AF\u5883(\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);
+    if (config.mock) console.log(MOCK_MODE_HINT);
     const client = new EasyTwinClient(config);
     const scenes = await listScenes(client);
     if (scenes.length === 0) {
@@ -535,14 +796,16 @@ function buildProgram(cwd, version = "0.0.0") {
   });
   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);
+    if (config.mock) console.log(MOCK_MODE_HINT);
     const client = new EasyTwinClient(config);
     const scene2 = await pullScene(client, id);
-    const out = opts.out ?? path5.join(cwd, `${id}.scene.json`);
+    const out = opts.out ?? path6.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);
+    if (config.mock) console.log(MOCK_MODE_HINT);
     const client = new EasyTwinClient(config);
     await uploadDirectory(client, dir, {
       onProgress: (p) => {
@@ -553,9 +816,16 @@ function buildProgram(cwd, version = "0.0.0") {
     });
     process.stderr.write("\n");
   });
+  program.command("bundle").description("\u6253\u5305\u5DE5\u4F5C\u533A src/main.ts(\u4EC5\u5141\u8BB8\u4F9D\u8D56 @easytwin/runtime)").option("-o, --out <path>", `\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84(\u7F3A\u7701 ${DEFAULT_BUNDLE_OUT})`).action(async (opts) => {
+    const hint = await typesMissingHint(cwd);
+    if (hint) console.warn(hint);
+    const outFile = path6.resolve(cwd, opts.out ?? DEFAULT_BUNDLE_OUT);
+    await bundleUserCode({ cwd, outFile });
+    console.log(`\u5DF2\u6253\u5305\u5230 ${outFile}`);
+  });
   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 });
+  skills.command("sync").description("\u540C\u6B65 skills \u5230\u7528\u6237\u9879\u76EE(cursor/claude/codex/qoder),\u7F3A\u7701 all").option("--target <target>", "cursor|claude|codex|qoder|all", "all").action(async (opts) => {
+    const { summaries, types } = await syncSkills({ cwd, targets: opts.target });
     for (const s of summaries) {
       if (s.codex) {
         console.log(`[codex] AGENTS.md: ${s.codex.action}`);
@@ -563,6 +833,9 @@ function buildProgram(cwd, version = "0.0.0") {
       }
       for (const e of s.entries) console.log(`[${s.target}] ${e.name}: ${e.action}`);
     }
+    console.log(`[types] ${".easytwin/types"}: ${types.action}`);
+    if (types.tsconfig === "created") console.log("[types] \u5DF2\u751F\u6210\u6700\u5C0F tsconfig.json");
+    if (types.pathsHint) console.log(types.pathsHint);
   });
   return program;
 }