diff --git a/plugins/deta/.codex-plugin/plugin.json b/plugins/deta/.codex-plugin/plugin.json
index ba75481..6df57d9 100644
--- a/plugins/deta/.codex-plugin/plugin.json
+++ b/plugins/deta/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "deta",
-  "version": "0.2.3",
-  "description": "DETA \u5efa\u7b51\u6027\u80fd\u8bbe\u8ba1\u63d2\u4ef6\uff1a\u4ee5 AML \u4e3a\u552f\u4e00\u4e8b\u5b9e\u6e90\u7f16\u8f91\u5efa\u7b51\u6a21\u578b\uff0c\u7ecf GSA \u7f16\u8bd1\u4e3a\u5efa\u7b51\u6a21\u578b\u5e76\u505a\u89c4\u5219\u6821\u9a8c\u3002",
+  "version": "0.2.4",
+  "description": "DETA 建筑性能设计插件：以 AML 为唯一事实源编辑建筑模型，经 GSA 编译为建筑模型并做规则校验。",
   "author": {
     "name": "DETA",
     "url": "https://deta.city"
@@ -18,9 +18,9 @@
   ],
   "skills": "./skills/",
   "interface": {
-    "displayName": "DETA \u5efa\u7b51\u6027\u80fd\u8bbe\u8ba1",
-    "shortDescription": "AML \u5efa\u7b51\u6a21\u578b\u8bfb\u5199\u3001\u7f16\u8bd1\u4e0e\u6821\u9a8c",
-    "longDescription": "\u5728\u7f16\u7801\u4ee3\u7406\u4e2d\u76f4\u63a5\u64cd\u4f5c\u5efa\u7b51\u6a21\u578b\uff1a\u8bfb\u53d6\u4e0e\u7f16\u8f91 AML \u8bbe\u8ba1\u6e90\u7801\uff0c\u7ecf\u7f16\u8bd1\u5668\u7f16\u8bd1\u4e3a\u5efa\u7b51\u6a21\u578b\uff0c\u6267\u884c\u8bed\u6cd5\u4e0e\u89c4\u5219\u6821\u9a8c\u3001\u56f4\u62a4\u7ed3\u6784\u7edf\u8ba1\u4e0e\u7a7a\u95f4\u90bb\u63a5\u67e5\u8be2\u3002AML \u662f\u5efa\u7b51\u8bed\u4e49\u7684\u552f\u4e00\u4e8b\u5b9e\u6e90\uff0c\u6240\u6709\u51e0\u4f55\u7f16\u8f91\u5747\u843d\u5230 AML \u6587\u672c\u3002",
+    "displayName": "DETA 建筑性能设计",
+    "shortDescription": "AML 建筑模型读写、编译与校验",
+    "longDescription": "在编码代理中直接操作建筑模型：读取与编辑 AML 设计源码，经编译器编译为建筑模型，执行语法与规则校验、围护结构统计与空间邻接查询。AML 是建筑语义的唯一事实源，所有几何编辑均落到 AML 文本。",
     "developerName": "DETA",
     "category": "Education & Research",
     "capabilities": [
@@ -31,9 +31,9 @@
     "brandColor": "#2F6F4E",
     "websiteURL": "https://deta.city",
     "defaultPrompt": [
-      "\u8bfb\u53d6\u5f53\u524d AML \u8bbe\u8ba1\u6e90\u7801\u5e76\u8bf4\u660e\u5efa\u7b51\u6784\u6210\u3002",
-      "\u5728 AML \u4e2d\u4fee\u6539\u6307\u5b9a\u7a7a\u95f4\u7684\u5c42\u9ad8\uff0c\u7136\u540e\u91cd\u65b0\u7f16\u8bd1\u6821\u9a8c\u3002",
-      "\u7edf\u8ba1\u5f53\u524d\u6a21\u578b\u7684\u56f4\u62a4\u7ed3\u6784\u9762\u79ef\u4e0e\u5916\u7a97\u9762\u79ef\u3002"
+      "读取当前 AML 设计源码并说明建筑构成。",
+      "在 AML 中修改指定空间的层高，然后重新编译校验。",
+      "统计当前模型的围护结构面积与外窗面积。"
     ]
   }
 }
diff --git a/plugins/deta/skills/aml-design/SKILL.md b/plugins/deta/skills/aml-design/SKILL.md
index 5cb3988..a79ddb4 100644
--- a/plugins/deta/skills/aml-design/SKILL.md
+++ b/plugins/deta/skills/aml-design/SKILL.md
@@ -69,7 +69,11 @@ Studio 就是 ant-model（deta.city 上的建筑性能应用）。在 Codex 右
 
 前置与故障：
 
-- 面板未登录 deta.city：先在面板里登录一次（门户把登录态写进 `ant_token` cookie 后，Studio 才会自动加载项目）。
+- 面板未登录 deta.city：**面板是独立的浏览器上下文**，系统浏览器里的登录态带不过来。处置：
+  在面板里打开 `https://deta.city/login` 完成一次登录（登录态写入该浏览器的 `ant_token` cookie 与
+  `ant-model-auth` localStorage，之后长期有效）；若宿主的 MCP 授权页恰好开在面板里，
+  `codex mcp login deta_mcp` 一步即可同时建立门户会话（授权成功时授权页会写入该浏览器）。
+  登录完成后重新打开 `studioUrl` 即自动加载项目。
 - 没有 `projectId`：Studio 打开的是空项目。先在门户创建云项目拿到 ID，再 `push_project(…, projectId)` 绑定。
 - 宿主没有内置浏览器（CLI 等形态）：直接把 `studioUrl` 给用户，让他自己打开，不要假装已经打开。