docs(skill): 新建项目改走 create_project(云端唯一工具入口),studio 0.3.5
CI / contract (push) Has been cancelled

原指引「先在门户创建云项目拿到 ID,再 push_project 绑定」在工具面补上 create_project 之后已过时:模型会因此拿 push_project 去绑定不存在的 ID,或让用户去门户手工建。改为:先 create_project({name}) 拿 projectId 与 Studio 深链,再 build_model / push_project 把模型放进去。
This commit is contained in:
ringo
2026-09-20 13:32:13 +08:00
parent 5778962ba5
commit 36347f3222
4 changed files with 8 additions and 5 deletions
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "studio", "name": "studio",
"version": "0.3.4", "version": "0.3.5",
"description": "DETA Studio 插件:以 AML 为唯一事实源编辑建筑模型,编译为建筑模型并执行规则校验。", "description": "DETA Studio 插件:以 AML 为唯一事实源编辑建筑模型,编译为建筑模型并执行规则校验。",
"author": { "author": {
"name": "DETA", "name": "DETA",
+2 -2
View File
@@ -1,12 +1,12 @@
{ {
"name": "deta-studio-plugin", "name": "deta-studio-plugin",
"version": "0.3.4", "version": "0.3.5",
"lockfileVersion": 3, "lockfileVersion": 3,
"requires": true, "requires": true,
"packages": { "packages": {
"": { "": {
"name": "deta-studio-plugin", "name": "deta-studio-plugin",
"version": "0.3.4", "version": "0.3.5",
"license": "Proprietary" "license": "Proprietary"
} }
} }
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "deta-studio-plugin", "name": "deta-studio-plugin",
"version": "0.3.4", "version": "0.3.5",
"description": "DETA Studio:AML 建筑模型读写与编译校验(Codex 插件 / dsh 组合包 双壳)", "description": "DETA Studio:AML 建筑模型读写与编译校验(Codex 插件 / dsh 组合包 双壳)",
"type": "module", "type": "module",
"license": "Proprietary", "license": "Proprietary",
+4 -1
View File
@@ -145,7 +145,10 @@ Studio 就是deta.city 上的建筑性能应用。在 Codex 右侧内置浏览
- **面板侧的 deta.city 登录**:靠 `open_studio` 的一次性链接自动完成,登录态写在该浏览器的 - **面板侧的 deta.city 登录**:靠 `open_studio` 的一次性链接自动完成,登录态写在该浏览器的
`ant_token` cookie 与 `ant-model-auth` localStorage,之后长期有效。 `ant_token` cookie 与 `ant-model-auth` localStorage,之后长期有效。
两者互不替代——拿到云令牌不等于面板已登录,反之亦然。 两者互不替代——拿到云令牌不等于面板已登录,反之亦然。
- 没有 `projectId`:Studio 打开的是空项目。先在门户创建云项目拿到 ID,再 `push_project(…, projectId)` 绑定。 - 没有 `projectId`(用户要"新建项目"):**先调 `create_project({ name })`** ——这是云端建项目的唯一工具入口,
返回 `projectId` 与 Studio 深链(`studioUrl`);随后用 `build_model`(写 AML → 编译 → 写入云项目工作区)
或 `push_project(…, projectId)` 把模型放进去。**不要**拿 `push_project` 去绑定一个不存在的 ID,
也不要让用户先去门户手工建项目。
- 宿主没有内置浏览器(CLI 等形态):直接把 `studioUrl` 给用户,让他自己打开,不要假装已经打开。 - 宿主没有内置浏览器(CLI 等形态):直接把 `studioUrl` 给用户,让他自己打开,不要假装已经打开。
## 铁律 ## 铁律