@easytwin/devkit 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -15,9 +15,9 @@ npm i -g @easytwin/devkit # 全局安装 CLI
15
15
  | 命令 | 行为 |
16
16
  | --- | --- |
17
17
  | `easytwin init` | 交互式生成 `easytwin.config.json`,并追加进 `.gitignore`(无则创建) |
18
- | `easytwin scene list` | 列出凭据可见的场景 |
18
+ | `easytwin scene list` | 列出凭据可见的场景,并把摘要写入 `easytwin.config.json.scenes` |
19
19
  | `easytwin scene pull <id> [--out <path>]` | 拉取场景 JSON 到本地 |
20
- | `easytwin upload <dir>` | 全量覆盖上传目录 |
20
+ | `easytwin upload [dir]` | 对照远端全量对齐工作区(缺省 cwd;跳过插件产物) |
21
21
  | `easytwin skills sync [--target cursor\|claude\|codex\|all]` | 同步 skills 到用户项目,缺省 all |
22
22
 
23
23
  ## 配置
@@ -30,11 +30,12 @@ npm i -g @easytwin/devkit # 全局安装 CLI
30
30
  "appSecret": "必填",
31
31
  "env": "可选,prod=正式 / test=测试,缺省 prod",
32
32
  "baseUrl": "可选,缺省按 env 选官方域名",
33
- "ossUrl": "可选,缺省官方 OSS"
33
+ "ossUrl": "可选,缺省官方 OSS",
34
+ "scenes": "可选,由 scene list 写入的场景摘要"
34
35
  }
35
36
  ```
36
37
 
37
- 环境变量 `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)。
38
+ 环境变量 `EASYTWIN_APP_ID` / `EASYTWIN_APP_SECRET` / `EASYTWIN_BASE_URL` / `EASYTWIN_ENV` / `EASYTWIN_OSS_URL` 优先于文件。请求带 `x-app-id`(App ID)与 `x-app-secret`(App Secret),不走 OP 网关。官方 API:正式 `http://saas-twin.k8s.dtstack.cn/`、测试 `http://172.16.125.3:10100/`,缺省按 env 选择。官方 OSS:`https://dt-easyv-test.oss-cn-hangzhou.aliyuncs.com/`,供 twin runtime 加载 webp/draco/组件脚本。文件含密钥,永不入库(`init` 会处理 gitignore)。
38
39
 
39
40
  ## skills
40
41
 
@@ -72,4 +73,4 @@ pnpm -r test
72
73
 
73
74
  ## 已知外部输入(TODO)
74
75
 
75
- 内部 swagger(API 契约)、渲染 API 文档与 d.ts——均未到位,代码中以 `TODO(swagger)` / `TODO(外部输入)` 标记,不臆造;官方 API 域名、官方 OSS 与场景 JSON 格式已定(见上)。
76
+ 渲染 API 文档与 d.ts 仍未到位,skills 中以 `TODO(外部输入)` 标记,不臆造。场景列表/拉取与工作区代码上传已按内部 swagger(SDK 应用场景 / SDK 应用代码)落地;官方 API 域名、官方 OSS 与场景 JSON 格式已定(见上)。