diff --git a/dokploy-gitea-deploy/SKILL.md b/dokploy-gitea-deploy/SKILL.md
index c0b794e..5d44cf3 100644
--- a/dokploy-gitea-deploy/SKILL.md
+++ b/dokploy-gitea-deploy/SKILL.md
@@ -305,6 +305,7 @@ Agent **不要**在 MCP 路径下再调 Dokploy `domain.create`（避免双绑/
 | git push 权限 / Permission denied / 要配 SSH | **错误路径**。改用 `ensure_repository` → `agentHint.pushUrl` 推送；禁止给用户配 SSH |
 | `nest: not found` / `vite: not found` | build 阶段在装依赖前设了 `NODE_ENV=production`；先全量 `npm ci` 再设 production |
 | `JavaScript heap out of memory` | Dockerfile build 加 `NODE_OPTIONS=--max-old-space-size=3072`；避免并行 npm ci；机器内存过小则升配 |
+| `FORCE_AUTHN_INNERAPI_DOMAIN` / 平台模式需要基础域名 | 妙搭模板自部署缺 env；控制面 apply 会注入；老应用再 apply 或 Dokploy 手动补公网 URL |
 | 运行中项目达上限 | `get_my_quota`；停/删旧应用后再部署 |
 | Forbidden 看他人项目 | 非管理员；加 `ADMIN_OPEN_IDS` 或只查自己的 |
 | 有部署无 HTTPS | 等 LE；查 DNS/80；控制面证书配置 |
diff --git a/dokploy-gitea-deploy/references/stack-profiles.md b/dokploy-gitea-deploy/references/stack-profiles.md
index c0be005..a61a15e 100644
--- a/dokploy-gitea-deploy/references/stack-profiles.md
+++ b/dokploy-gitea-deploy/references/stack-profiles.md
@@ -9,6 +9,37 @@
 5. 健康检查：实现 `/healthz` 或约定路径，写入 `spec.healthcheckPath`。  
 6. Dokploy **不要每次 cleanCache**。  
 7. **有状态数据写挂载路径**（见下），不要只写容器可写层。  
+8. **本控制面 = 自部署（self-host）**，不是飞书妙搭/TCE 平台托管。  
+
+### 飞书 APaaS / 妙搭模板（`@lark-apaas/*`）自部署
+
+模板里的 `PlatformModule.forRoot()` 会启用平台 HttpClient（`platform.enabled: true`），启动时**必须**有：
+
+```text
+FORCE_AUTHN_INNERAPI_DOMAIN=<基础域名>
+```
+
+否则：
+
+```text
+Error: 平台模式需要基础域名，请设置环境变量 FORCE_AUTHN_INNERAPI_DOMAIN
+```
+
+**控制面在 `apply` 时自动注入**（无需用户填妙搭平台域名）：
+
+| 变量 | 值 |
+|------|-----|
+| `FORCE_AUTHN_INNERAPI_DOMAIN` | 应用公网 URL（`https://buxi*****.DOMAIN_ROOT`） |
+| `FORCE_FRAMEWORK_DISABLE_DATAPASS` | `true`（关掉 TCE datapass 中间件） |
+| `FORCE_FRAMEWORK_ENVIRONMENT` | 默认 `development` |
+| `SERVER_HOST` / `SERVER_PORT` / `PORT` | `0.0.0.0` + `spec.port` |
+| `COMPANY_DEPLOY_SELF_HOST` | `true` |
+
+说明：
+
+- 这只保证 **进程能启动**；飞书开放平台能力（多维表格等）仍需业务侧配置 `FEISHU_*` / 应用凭证。  
+- 若应用硬依赖妙搭登录态，自部署还需业务改登录（本地账号 / 自建 OAuth），与控制面注入无关。  
+- 已上线的老应用：再 `apply` 一次，或 Dokploy 手动补上表中变量后 Redeploy。
 
 ---