draftgo-cli 3.0.44 → 3.0.48

package/resources/skill/references/api-endpoints.md

@@ -1,180 +0,0 @@
----
-read_when: 需要查具体 API 端点时 · 构造请求时
----
-
-# 后端 API 速查
-
-> 实时契约以 MCP `draftgo_api_search` / `draftgo_api_describe` 为准；CLI 中可用 `draftgo api <keyword>` 查询。
-> 本页只保留领域速查和 OpenAPI 无法表达的约束，不是静态完整契约。自定义服务的运行时路由由 `app.Route`
-> 动态注册，不会出现在底座 OpenAPI 中；按 `<METHOD> /api/x/<slug><route-path>` 推导，保存或发布后必须请求
-> 无副作用 GET Route 验证。
-> 统一响应信封：`{ code: 200, data: <载荷>, message: "success" }`
-> GET 列表端点通常在不传 `page` / `page_size` 时全量返回；自定义服务执行记录是固定分页特例（默认 20，最大 100）。
-> Go 自定义服务使用 `draftgo.DB.Query(type, sdk.QueryOptions{...})`；返回 `sdk.QueryResult`，筛选和分页见 `references/custom-services.md`。
-
-## 认证
-
-```
-POST /api/auth/login, /register, /logout, /refresh
-POST /api/auth/forgot-password, /reset-password
-POST /api/auth/wechat/mp/oauth, /wechat/mini/login
-POST /api/auth/wechat/mp/qr/create  GET /wechat/mp/qr/poll
-```
-
-## 用户 & 角色
-
-```
-GET/PUT  /api/users/me                PUT /api/users/me/password
-GET/POST /api/users                   GET/PUT/DELETE /api/users/{id}
-POST     /api/users/{id}/ban, /unban
-
-GET/POST /api/roles                   GET/PUT/DELETE /api/roles/{id}
-POST     /api/roles/{id}/assign/{uid} DELETE /api/roles/{id}/revoke/{uid}
-```
-
-## 页面
-
-```
-GET/POST           /api/pages/
-GET/PUT/DELETE     /api/pages/{id}
-POST               /api/pages/{id}/reset-system
-GET                /api/pages/by-route?route=/xxx
-GET                /api/pages/{id}/versions
-POST               /api/pages/{page_id}/versions/{version_id}/restore, /star
-```
-
-## 导航栏
-
-```
-GET/POST      /api/navigations
-GET           /api/navigations/{code}
-PUT/DELETE    /api/navigations/{id}
-```
-
-## 动态 DB
-
-```
-GET            /api/db/{type}
-               支持 filters/order_by/order/page/page_size/populate/scope=mine
-               scope=mine 仅 admin 用户的列表 GET 生效：非后台业务页用，后台管理页不用
-               📌 filters 语法 → references/data.md#filters-操作符
-               📌 searchable 模式 → references/data.md#searchable-字段标记
-               📌 ref/populate/onDelete → references/data.md#关联关系ref
-POST           /api/db/{type}       body: { data: {...} } 或数组
-PATCH          /api/db/{type}/batch
-GET/PUT/DELETE /api/db/{type}/{id}
-               DELETE 会按真实引用字段的 ref.onDelete 处理级联 / 置空 / 阻止 / 解除关联
-```
-
-## DB Meta ⚠️
-
-```
-GET/POST         /api/db-meta
-GET              /api/db-meta/{type}   ← 必须用 type，不是 id！
-PUT/DELETE       /api/db-meta/{id}
-POST             /api/db-meta/{type}/reconcile-fields
-```
-
-## 自定义服务
-
-```
-GET/POST         /api/scripts
-GET              /api/scripts/options/roles
-GET/PUT/DELETE   /api/scripts/{id}
-GET              /api/scripts/{id}/routes
-POST             /api/scripts/{id}/enable, /disable, /execute
-GET              /api/scripts/{id}/versions
-POST             /api/scripts/{id}/versions/{version_id}/restore
-GET              /api/scripts/{id}/executions
-GET              /api/scripts/{id}/executions/{execution_id}
-ANY              /api/x/{slug}/{path}   ← 脚本运行时端点
-```
-
-自定义服务要点：
-
-- 自定义服务是结构化远端资源：通过 MCP 查询元数据和实时接口契约，通过 `draftgo_api_call` 创建或更新；不要依赖本地 `index.json` 镜像。
-- 新服务使用 Go `Register(app *sdk.App)`；用 `app.Route` / `app.On` / `app.Schedule` 自动注册。
-- 新服务使用 `mode=mixed`，可同时暴露 HTTP、响应事件和执行 cron。
-- route 注册来自 `app.Route("METHOD", "/path", handler)`；一个服务可声明多个 route，共用同一个 slug 命名空间。
-- event 和 scheduled 分别来自 `app.On(...)` 与 `app.Schedule(...)`；均支持在一个服务内声明多个 handler。
-- 旧 `triggers` 字段不参与注册，CLI 不再创建或推送该字段。
-- route handler 签名：`func handler(draftgo *sdk.Context) (any, error)`；实际字段位于 `draftgo.Input`，用户身份用 `draftgo.Auth.CurrentUser()`。
-- Route 的普通 SDK 调用继承当前调用者资源权限，管理员创建服务不自动提升；需要管理员权限时逐次显式调用 `draftgo.Admin.DB`、`draftgo.Admin.Users` 等。`Admin` 调用以管理员身份执行并自动写入执行审计，但不会向代码暴露 SAT。带 `user_id` / `actor_user_id` 的事件继承该用户，定时任务及无可解析用户的事件才是系统身份。
-- 路径换算：`slug=order` + `app.Route("POST", "/pay", handler)` → `POST /api/x/order/pay`。
-- route 是精确路径匹配，不支持 `/items/{id}` 参数模板；ID 使用 query/body。
-- 动态数据访问使用 `draftgo.DB.Query("order", sdk.QueryOptions{...})`，结果为 `sdk.QueryResult`；筛选与分页见 `references/custom-services.md`。
-- `permission` 控制调用权限；`config.route_security` 控制限流、IP、body 大小和超时。
-- `scripts:*` 控制服务管理权限，和 Route 的调用权限彼此独立；执行列表固定分页，详情日志按单条加载。
-- `config.max_concurrency` / `queue_timeout_ms` 控制服务级退避；Route 饱和返回 429。
-- 完整 SDK、`draftgo`、AIHub、事件、配置与运行限制见 `references/custom-services.md`。
-
-## AIHub & AI推理
-
-```
-GET/POST   /api/aihub                     ← AIHub 资源（模型/Agent 定义）CRUD
-POST       /api/aihub/{id}/sync           ← 同步供应商模型目录
-GET        /api/v1/models
-POST       /api/v1/chat/completions       ← OpenAI 兼容格式（直连模型）
-POST       /api/v1/embeddings             ← 向量嵌入（OpenAI 兼容）
-POST       /api/v1/images/generations     ← 图片生成（OpenAI 兼容）
-```
-
-Agent 调用面（页面/调用方用 agent id 调用，不是直连模型）：
-```
-GET        /api/agents                    ← 列出当前用户可调用的 Agent（拿 id/name/describe）
-GET        /api/agents/{id}/selectable-models  ← { user_selectable, models }
-POST       /api/agents/{id}/chat          ← 对话，见下方 body；stream=true 返回 SSE
-POST       /api/agents/{id}/images        ← 图片模式 Agent（body.prompt 必填）
-POST       /api/agents/{id}/preview-chat  ← 只解析不执行：回 { model, fallback_models, candidate_provider_ids, messages }，用于调试路由
-```
-
-`/api/agents/{id}/chat` 请求体：
-```
-{ messages:[{role,content}] | message:"简写字符串", stream?:bool,
-  model?:"覆盖模型", session_id?:"多轮会话键", context?:{} }
-```
-- `stream:true` → `text/event-stream`，逐帧 `data: {...}`，以 `data: [DONE]` 结束；否则返回 OpenAI 风格完整结果。
-- 传 `session_id` 且 Agent 开启持续对话（checkpoint）时，服务端加载并续写该会话历史；不传即无状态单轮。
-
-AI 运行观测（`/admin/ai-runs` 页数据源）：
-```
-GET        /api/aihub/runs                ← 运行列表，支持 status/model/trace_id/agent_id/event_type/time_start/time_end + 分页
-GET        /api/aihub/runs/{trace_id}     ← 单次运行详情（含 spans / tokens / ttft_ms / 延迟）
-DELETE     /api/aihub/runs                ← 按 trace_ids 或时间范围批量清理
-```
-
-## 文档中心
-
-```
-GET/POST   /api/docs/categories
-GET        /api/docs/articles, /api/docs/articles/{key}, /api/docs/search
-POST       /api/docs/articles    PUT/DELETE /api/docs/articles/{id}
-```
-
-## 系统 & 备份
-
-```
-GET          /api/system/config
-GET/PUT/DELETE /api/system/{key}
-GET/POST     /api/system/backup
-POST         /api/system/restore, /api/system/reset
-POST         /api/system/restore/selective?mode=replace|merge|append
-POST         /api/upload
-GET          /api/system/logs
-```
-
-## 二次认证（高危操作前必须）
-
-restore / reset / undo / cleanup-orphans 需要：
-```
-POST /api/auth/reauth  { password, scope }  → 返回 confirm_token
-请求头加：X-Confirm-Token: <token>
-```
-
-## 不使用信封的端点
-
-| 端点 | 格式 |
-|---|---|
-| `POST /api/v1/chat/completions` | OpenAI SSE / JSON |
-| `GET /api/v1/models` | `{ object:"list", data:[...] }` |
-| `ANY /api/x/{slug}/{path}` | 脚本自定义 |

package/resources/skill/references/debugging-syntax.md

@@ -1,308 +0,0 @@
----
-name: draftgo-debugging-syntax
-description: 页面代码量大时，语法/逻辑缺陷导致页面静默失效的排查指南。页面功能不执行、无报错或报错误导时，先按此清单逐项检查。
-version: 1.0.0
----
-
-# DraftGo 页面排错指南
-
-> **为什么需要这份文档：** DraftGo 页面是完整 HTML 运行在 iframe.srcdoc，业务逻辑、DOM 操作、API 调用全部混在单个文件里。代码量大之后，某些语法/逻辑缺陷不会触发控制台报错，也不会弹出异常，但功能就静默失效了。这份清单帮 AI 快速定位这类"查不到报错"的致命缺陷。
-
----
-
-## 核心排错原则
-
-**页面功能不执行时，按这个顺序排查，不要漫无目的地读代码：**
-
-1. 先看浏览器控制台有没有红色报错，有就按报错定位
-2. 没有报错 → 用本文档逐项检查（最常见的就是下面列出的几类）
-3. 在关键位置加 `console.log('=== A 点到达 ===')` 二分定位死在哪一步
-4. 仍找不到 → 用二分法注释掉一半代码，缩小范围
-
----
-
-## 致命缺陷速查清单（按出现频率排序）
-
-以下每一项都可能导致页面**完全静默失效**——无报错、无异常、功能就是不动。
-
-### 1. 模板字符串未闭合（最常见！）
-
-在 iframe.srcdoc 环境中，`</script>` 出现在模板字符串里会**提前关闭 script 标签**，导致后续所有 JS 代码被当 HTML 解析。这种问题**没有任何报错**。
-
-```javascript
-// ❌ 致命：模板字符串中的 </script> 终止了外层 <script> 标签
-const html = `
-  <script>
-    console.log('inner');
-  </script>   // ← 这里！浏览器解析器看到 </script> 就关闭了外层 script
-`;
-
-// ✅ 安全：把 </ 拆开
-const html = `
-  <script>
-    console.log('inner');
-  <` + `/script>
-`;
-```
-
-**排查方法：** 检查所有模板字符串，搜索 `</script>` 是否出现在 JS 字符串中。同时检查 `</style>` 是否出现在模板字符串中（同理）。
-
----
-
-### 2. await 用在了非 async 函数里
-
-浏览器对顶层 `await` 支持有限（取决于环境）。如果在普通函数里用了 `await`，**整个 script 块可能不执行**。
-
-```javascript
-// ❌ 致命：init 不是 async 函数
-function init() {
-  const data = await App.get('db/patients');  // SyntaxError，后续代码全死
-  render(data);
-}
-
-// ✅ 正确
-async function init() {
-  const data = await App.get('db/patients');
-  render(data);
-}
-```
-
-```javascript
-// ❌ 致命：DOMContentLoaded 回调忘了 async
-document.addEventListener('DOMContentLoaded', () => {
-  const data = await App.get('db/patients');  // 回调不是 async！
-});
-
-// ✅ 正确
-document.addEventListener('DOMContentLoaded', async () => {
-  const data = await App.get('db/patients');
-});
-```
-
-**排查方法：** 搜索文件中所有 `await`，逐个人工确认外层函数是否标了 `async`。
-
----
-
-### 3. App.confirm() 忘了 await
-
-`App.confirm()` 返回 `Promise<boolean>`。忘了 `await`，变量是 Promise 对象（**始终 truthy**），条件判断永远通过。
-
-```javascript
-// ❌ 致命：ok 是 Promise 对象，不是 boolean，if 永远为 true
-const ok = App.confirm('确认删除？');
-if (ok) { /* 永远执行 */ }
-
-// ✅ 正确
-const ok = await App.confirm('确认删除？');
-if (ok) { /* 用户点了确定才执行 */ }
-```
-
-**排查方法：** 搜索 `App.confirm(`，检查返回值是否用了 `await`。
-
----
-
-### 4. 对 null/undefined 调用方法
-
-API 返回数据不存在时，链式调用会抛出 TypeError，**打断后续所有代码执行**。
-
-```javascript
-// ❌ 致命：data 可能是 null
-const name = App.get('db/patients/999').full_name.toUpperCase();
-
-// ❌ 致命：items 可能是 undefined
-items.forEach(item => render(item));  // TypeError: Cannot read properties of undefined
-
-// ✅ 安全
-const patient = await App.get('db/patients/999');
-if (!patient) { App.showError('未找到'); return; }
-const name = patient.full_name?.toUpperCase() || '';
-
-// ✅ 安全
-(items || []).forEach(item => render(item));
-```
-
-**排查方法：** 搜 `.forEach(`、`.map(`、`.filter(` 等数组方法，确认调用者不会是 undefined。
-
----
-
-### 5. getElementById 拿到 null 后操作
-
-```javascript
-// ❌ 致命：如果 DOM 中不存在 #form，直接 TypeError，后续代码全死
-document.getElementById('form').addEventListener('submit', handler);
-
-// ✅ 安全
-const form = document.getElementById('form');
-if (form) { form.addEventListener('submit', handler); }
-```
-
-**排查方法：** 搜索 `document.getElementById(`，检查返回值是否判空。
-
----
-
-### 6. 变量重复声明 / 提前引用
-
-```javascript
-// ❌ 致命：const 重复声明
-const App = window.parent?.App;
-// ... 500 行后 ...
-const App = window.parent?.App;  // SyntaxError: Identifier 'App' has already been declared
-
-// ❌ 致命：TDZ 死区
-console.log(app);  // ReferenceError
-const app = window.parent?.App;
-```
-
-**排查方法：** 搜索 `const App`、`let App`、`var App` 看是否重复。搜索 `const ` 全局看是否有同名声明。
-
----
-
-### 6.5 display 类型冲突（JS 覆盖 CSS flex/grid）
-
-JS 通过 `el.style.display = 'block'` 切换显隐时，如果元素 CSS 声明了 `display:flex` 或 `display:grid`，inline style 会覆盖，导致布局塌陷——子元素的居中、分布全部失效。
-
-```javascript
-// ❌ 致命：CSS 里 .empty { display:flex; align-items:center; justify-content:center }
-//   但 JS 把它改成 block，flex 布局被杀死
-function showState(name) {
-  ['skeleton','emptyState','tableWrap'].forEach(id => {
-    document.getElementById(id).style.display = id === name ? 'block' : 'none';
-  });
-}
-
-// ✅ 方案1：匹配元素实际需要的 display 类型
-document.getElementById(id).style.display = id === name ? 'flex' : 'none';
-
-// ✅ 方案2（推荐）：用 class 切换，不操作 inline display
-function showState(name) {
-  ['skeleton','emptyState','tableWrap'].forEach(id => {
-    document.getElementById(id).classList.toggle('hidden', id !== name);
-  });
-}
-// CSS: .hidden { display: none !important; }
-```
-
-**排查方法：** 搜索 `style.display = 'block'`，逐个确认目标元素是否有 flex/grid 布局。空态、居中容器、card-grid 最易中招。
-
----
-
-### 7. JSON.parse 静默失败
-
-```javascript
-// ❌ 如果 str 不是合法 JSON，直接抛异常
-const config = JSON.parse(App.config.some_setting);
-
-// ✅ 安全
-let config = {};
-try { config = JSON.parse(App.config.some_setting || '{}'); } catch (e) {}
-```
-
----
-
-### 8. 对象字面量尾部逗号（极少见但存在）
-
-虽然现代浏览器大多容忍，但在某些内嵌环境中尾部逗号仍可能出错。
-
-```javascript
-// 某些严格解析场景可能报错
-const obj = {
-  name: 'test',
-  age: 30,  // ← 尾逗号
-};
-```
-这道一般不是问题，但如果其他都排除了仍找不到 bug，可以检查。
-
----
-
-### 9. innerHTML 中的 HTML 片段提前闭合
-
-```javascript
-// ❌ 如果 row.name 包含特殊字符，可能破坏 HTML 结构
-el.innerHTML = `<div>${row.name}</div>`;
-
-// ✅ 安全：至少做基本转义
-const esc = s => String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
-el.innerHTML = `<div>${esc(row.name)}</div>`;
-```
-
-**排查方法：** 搜索 `innerHTML =`，确认插入内容做了转义。
-
----
-
-### 10. 正则表达式灾难性回溯
-
-大文本上运行复杂正则，页面卡死，看起来像挂了。
-
-```javascript
-// ❌ 多个 .* 叠加可能导致回溯爆炸
-const matches = hugeText.match(/(.*)<div>(.*)<\/div>(.*)/gs);
-
-// ✅ 用具体选择器或限制范围
-```
-
----
-
-## 系统性排查法
-
-当你查了上面清单还是找不到 bug 时：
-
-### 步骤 1：确认代码是否在跑
-
-在 `<script>` 最开头加：
-```javascript
-console.log('=== SCRIPT START ===');
-```
-如果这行没输出 → script 根本没加载（检查 HTML 结构、script 标签闭合）
-
-### 步骤 2：二分定位死点
-
-在疑似问题区域两侧加 log：
-```javascript
-console.log('A');
-// ... 代码 ...
-console.log('B');
-```
-如果 A 输出但 B 没输出 → bug 在两者之间
-
-### 步骤 3：检查全局错误处理
-
-```javascript
-window.addEventListener('error', e => console.error('全局错误:', e.message, e.filename, e.lineno));
-window.addEventListener('unhandledrejection', e => console.error('未处理 Promise:', e.reason));
-```
-
-### 步骤 4：检查异步代码是否真执行了
-
-很多"没反应"是因为异步函数抛了异常但没 catch：
-```javascript
-// ❌ 异步异常链断裂
-async function load() {
-  const data = await App.get('db/patients');  // 如果这里 reject，外面感知不到
-  render(data);
-}
-load();  // 没有 .catch()
-
-// ✅ 加错误边界
-load().catch(err => console.error('load 失败:', err));
-```
-
----
-
-## HTML 结构层面的静默缺陷
-
-以下缺陷不会触发任何 JS 错误，但会导致页面空白或样式错乱：
-
-| 缺陷 | 后果 | 排查方法 |
-|---|---|---|
-| `</script>` 前缺少闭合引号 | 后续 HTML 全被当 JS 解析 | 检查 `<script>` 内容中是否有未闭合的字符串 |
-| `<style>` 中有 `</style>` | CSS 提前结束，后续样式丢失 | 检查内联 CSS 中是否有 `</style>` 文本 |
-| 属性值引号不匹配 `id="xxx'` | HTML 解析错位 | 搜 `=".*'` 或 `='.*"` 正则 |
-| `<` 出现在 JS 比较符中没转义 | HTML 解析器误解 | 在 inline JS 中 `if (a < b)` 可能导致问题，改用 `if (b > a)` |
-
----
-
-## 总结：查不到 bug 时的三板斧
-
-1. **搜索 `</script>`**——如果在 JS 字符串里出现，查！这是最最常见的静默杀手。
-2. **搜索 `await`**——确认所有 await 都在 async 函数内。
-3. **二分注释**——注释掉一半代码，看功能能不能跑，逐次缩小范围。不要用眼睛硬读。

package/resources/skill/references/parallel.md

@@ -1,56 +0,0 @@
-# DraftGo 并行执行
-
-主 Agent 在任务开始时只执行一次 `draftgo context --task <task> --output json`，随后维护共享契约和资源 owner。并行是按依赖和资源边界选择的执行方式，不是每个任务的固定要求。
-
-## 资源依赖
-
-先为每个工作单元记录：
-
-- `depends`：开始前必须完成的工作单元。
-- `resource_lock`：本单元会修改的文件或 DraftGo 资源。
-- `evidence`：完成后返回的验证证据。
-
-按以下关系建立依赖：
-
-| 资源关系 | 执行顺序 |
-|---|---|
-| 多个实现依赖同一 schema、API、权限或路由 | 先确定共享契约，再并行实现消费者。 |
-| 多个工作单元涉及同一文件或 DraftGo 资源 | 全程分配给同一个修改 owner；其他 Agent 只能只读分析并回传建议。 |
-| 页面与对应导航入口 | 页面 route 确定后接入导航。 |
-| 不同文件且没有数据或接口依赖 | 放入同一 wave 并行执行。 |
-
-单页面、强依赖任务，或拆分后仍共享主要文件/资源的任务由一个 Agent 完成，不强行并行。
-
-## 工作单元
-
-分发内容包括：
-
-```yaml
-objective: 要完成的结果
-inputs: 当前资源和共享契约
-resource_lock: [允许修改的文件或资源]
-evidence: 返回的检查或运行证据
-delivery_owner: main
-```
-
-工作单元返回修改结果、验证证据和阻塞信息。主 Agent 独占资源 owner 分配、共享契约维护、wave 推进、汇总回读、统一验证、commit 和 changelog 职责；子 Agent 不写 changelog。
-
-## Wave 执行
-
-1. 主 Agent 执行一次 context，确定 schema、服务端点、权限、route 和导航结构等共享契约，并建立唯一资源 owner 表。
-2. 将 `depends` 已满足且 `resource_lock` 不冲突的工作单元放入同一 wave。
-3. 并行执行当前 wave，汇总后回读所有变更资源。
-4. 处理接口接线和入口绑定，再启动依赖已满足的下一 wave。
-5. 主 Agent 统一运行一次 `draftgo check` 和必要的 API/UI 验证；只对已 checkout 的 pages/nav/docs 执行 commit，结构化资源通过 MCP 实时 API 交付。
-6. 全部验证和交付成功后，由主 Agent 执行一次 `draftgo changelog add "<完成结果>"`。
-
-某个工作单元失败时，其依赖项等待处理；其余独立分支继续汇总。发现资源锁冲突时，将相关实现重新归并给既有唯一 owner，不得通过移动到后续 wave 改由另一个 Agent 修改。
-
-已 checkout 长正文的批量交付示例：
-
-```bash
-draftgo commit pages 1 2 3
-draftgo commit nav 4
-```
-
-不同类型分开提交。发生 409/412 时当前 wave 必须停止并保留冲突材料，不得继续自动提交后续依赖项。统一验证失败、409/412 或任何交付失败时都不得执行 `changelog add`。

package/resources/skill/references/security.md

@@ -1,74 +0,0 @@
----
-read_when: 开发前检查合规性时 · Code Review 时
----
-
-# 开发禁区（违反必报错）
-
-## 网络资源
-
-| ❌ 禁止 | ✅ 替代 |
-|---|---|
-| 任何境外 CDN（googleapis / jsdelivr / cdnjs / unpkg） | 国内镜像（npmmirror.com / staticfile.net）或本地资源 |
-| 外部 CDN 引入图标 | `/assets/icons/{name}.svg` 内置图标库 |
-
----
-
-## App 对象使用
-
-| ❌ 禁止 | ✅ 替代 |
-|---|---|
-| `App()` 写法（App 是对象不是函数） | `const App = window.parent?.App` |
-| `const App = () => window.parent?.App` | 去掉箭头函数 |
-| `App?.user?.role` 判断权限 | `App.isAdmin` 或 `App.currentUser?.role_code` |
-
----
-
-## 路由 & 导航
-
-| ❌ 禁止 | ✅ 替代 |
-|---|---|
-| `window.location.search` 读参数 | `window.__DG_ROUTE_CONTEXT__.query` |
-| `navigate('/login')` 退出 | `window.parent.location.href = '/login'` |
-| 页面内 `window.location.href = ...` 跳转 | `window.parent.location.href = ...`（页面在 iframe 中） |
-
----
-
-## 弹窗 & 交互
-
-| ❌ 禁止 | ✅ 替代 |
-|---|---|
-| `window.alert(msg)` | `App.showModal(msg, title?)` |
-| `window.confirm(msg)` | `await App.confirm(msg, title?)` |
-| `window.prompt(msg)` | 自建 modal + input |
-
----
-
-## UI 组件
-
-| ❌ 禁止 | ✅ 替代 |
-|---|---|
-| 硬编码 hex / rgb / rgba 颜色 | 优先用系统主题 `var(--dg-*)` 语义 token；品牌/图表/用户指定配色必须同时适配浅色与深色 |
-| 在页面内读 `localStorage.dg_theme` | `App.theme` |
-
----
-
-## 全局层
-
-| ❌ 禁止 | ✅ 替代 |
-|---|---|
-| 在业务页面内实现全局浮窗 / 客服 / 统计脚本 | 使用 `frontend_global_*` 固定槽位 |
-| 在页面内渲染系统 Header / Logo / 用户头像下拉 | 这些属于壳层，不属于业务页面 |
-| 新增全局层槽位 | 只能编辑系统内置固定槽位 |
-
----
-
-## 颜色 Token 参考
-
-默认优先采用系统主题配色：页面直接引用 `var(--dg-*)`，跟随壳层当前浅色 / 深色模式。只有页面不搭配、品牌要求、用户明确指定或图表多系列等场景才允许自主配色；自主配色必须提供浅色与深色两套变量或 `[data-theme="light"]` / `[data-theme="dark"]` 覆盖，并满足 WCAG AA 对比度。
-
-| Token | 用途 |
-|---|---|
-| `--dg-bg-base` / `--dg-bg-page` / `--dg-bg-surface` | 背景层级 |
-| `--dg-text-primary` / `--dg-text-secondary` / `--dg-text-muted` | 文字层级 |
-| `--dg-accent` / `--dg-accent-hover` / `--dg-accent-subtle` | 主题色 |
-| `--dg-border` / `--dg-success` / `--dg-error` / `--dg-warning` | 功能色 |