draftgo-cli 4.0.22 → 4.0.24

package/resources/skill/references/aihub.md

@@ -1,7 +1,7 @@
----
-read_when: 创建或调优 AI Agent 时 · 需要工具/子智能体/记忆/多轮/结构化输出/多模态时
----
-
+---
+read_when: 创建或调优 AI Agent 时 · 需要工具/子智能体/记忆/多轮/结构化输出/多模态时
+---
+
 # AIHub / Agent 资源
 
 ## 最短管理流程
@@ -24,86 +24,86 @@ AIHub 与知识库是独立权限域：Agent、模型和 AI 运行使用 `aihub:
 
 AIHub 是结构化远端资源，不 checkout，也不生成本地镜像。先使用 MCP `draftgo_resource_search`/`draftgo_resource_list`
 定位资产；未知 operation 才用 `draftgo_api_search`，首次使用或 registry revision 变化时 `draftgo_api_describe`，然后通过 `draftgo_api_call` 读写。
-更新 AIHub 资产时只发送实时契约允许的字段；常见字段包括
-`type, name, data, priority, version, tags, describe, permission, status`。供应商和模型使用各自的实时接口，
-不要经旧 AIHub 资产接口写入。任何输出、工作区文件或调用参数都不得保存 API Key 或 header 值；只可处理
-“是否已配置”以及 header 名称等非秘密元数据。
-**Agent 的全部行为都在 `data`（尤其 `data.spec`）里**——本页就是 `data.spec` 的字段地图。
-
-## 条目骨架
-
-```jsonc
-{
-  "type": "agent",                 // AIHub 资产类型
-  "name": "产品顾问",
-  "describe": "面向用户的产品答疑助手",
-  "status": "active",
-  "data": {
-    "mode": "chat",                // chat | image_generation
-    "spec": { /* 见下表 */ }
-  }
-}
-```
-
-页面对话 UI 使用 `<dg-chat protocol="draftgo-agent" agent-id="AGENT_ID">` 或 `DraftGoChat.create()`；
-旧代码/无 UI 文本调用可用 `DraftGoAI.chat(...)`，图片模式使用 `DraftGoAI.images(...)`。调用前都必须加载
+更新 AIHub 资产时只发送实时契约允许的字段；常见字段包括
+`type, name, data, priority, version, tags, describe, permission, status`。供应商和模型使用各自的实时接口，
+不要经旧 AIHub 资产接口写入。任何输出、工作区文件或调用参数都不得保存 API Key 或 header 值；只可处理
+“是否已配置”以及 header 名称等非秘密元数据。
+**Agent 的全部行为都在 `data`（尤其 `data.spec`）里**——本页就是 `data.spec` 的字段地图。
+
+## 条目骨架
+
+```jsonc
+{
+  "type": "agent",                 // AIHub 资产类型
+  "name": "产品顾问",
+  "describe": "面向用户的产品答疑助手",
+  "status": "active",
+  "data": {
+    "mode": "chat",                // chat | image_generation
+    "spec": { /* 见下表 */ }
+  }
+}
+```
+
+页面对话 UI 使用 `<dg-chat protocol="draftgo-agent" agent-id="AGENT_ID">` 或 `DraftGoChat.create()`；
+旧代码/无 UI 文本调用可用 `DraftGoAI.chat(...)`，图片模式使用 `DraftGoAI.images(...)`。调用前都必须加载
 `/assets/draftgo-chat.js`，完整用法见 `references/chat-sdk.md`。后端 operation 与可调用 Agent 列表通过 MCP 实时确认；已知契约可复用项目缓存。
-
-## `data.spec` 字段地图
-
-留空即维持默认/旧行为；除标注外都是可选。运行时统一在 `parseOrchestrationConfig` + 就地读取时带默认值与 clamp。
-
-| 字段 | 类型 / 取值 | 说明 |
-|---|---|---|
+
+## `data.spec` 字段地图
+
+留空即维持默认/旧行为；除标注外都是可选。运行时统一在 `parseOrchestrationConfig` + 就地读取时带默认值与 clamp。
+
+| 字段 | 类型 / 取值 | 说明 |
+|---|---|---|
 | `mode` | `chat` / `image_generation` | 决定主要交互形态；具体 Responses、Embedding、Rerank、TTS、ASR、Video operation 以 MCP 和模型 capability 为准 |
-| `model` | string | 主模型（逻辑模型名，映射到供应商路由） |
-| `fallback_models` | string[] | 主模型失败后按序回退（跨模型 failover） |
-| `model_selection.user_selectable` | bool | 是否允许调用方在请求里覆盖 `model`（配合 `selectable-models`） |
-| `ttft_timeout` | number（秒，1–600，空=不启用） | 首字超时 failover：首个 SSE data 事件超时即跨模型+跨供应商切换，推理模型不误杀 |
+| `model` | string | 主模型（逻辑模型名，映射到供应商路由） |
+| `fallback_models` | string[] | 主模型失败后按序回退（跨模型 failover） |
+| `model_selection.user_selectable` | bool | 是否允许调用方在请求里覆盖 `model`（配合 `selectable-models`） |
+| `ttft_timeout` | number（秒，1–600，空=不启用） | 首字超时 failover：首个 SSE data 事件超时即跨模型+跨供应商切换，推理模型不误杀 |
 | `sync_request_timeout` | number（秒，1–600，默认 100） | 非流式请求上限 |
 | `stream_ttl` | number（秒，1–3600，默认 600） | 流式请求上限 |
 | `max_tokens` | number / 空 | 最大输出 token；留空时不写入请求，即不由 Agent 额外限制 |
 | `reasoning_effort` | `off`/`minimal`/`low`/`medium`/`high` | `off`/留空均不透传；其它值仅 OpenAI 系模型生效 |
-| `system_prompt_template` | string | 系统提示模板 |
-| `context.max_history` | number（默认 20） | 工作窗口：保留最近 N 条；关闭持续对话时即滑动窗口硬上限 |
-| `output_format.mode` | `text` / `json` | JSON 时按 `output_format.json.{schema,schema_name,strategy}` 约束/校验/降级 |
-| `capabilities.vision.{enabled,input,max_mb}` | 见值 | 图片/视觉输入（`image_url` part），`input`⊂{base64,url}，默认 5MB |
-| `capabilities.files.{enabled,allowed_ext,max_mb}` | 见值 | 文件附件抽取成文本注入；白名单 `.txt .md .docx .pdf .xlsx .json .csv`（pptx 不支持），默认 8MB |
-| `tools.max_iterations` | 1–50（默认 10） | ReAct 工具循环步数上限 |
-| `tools.sources[].{type,id}` | `mcp` / `custom_script` | 绑定 MCP 与「自定义服务作为工具」 |
-| `knowledge_base_ids` | int[] | 绑定知识库，生成检索工具 |
-| `skills` | 见运行时 | 绑定 Skill |
-| `sub_agent_ids` | int[] | 子智能体：为每个 id 生成 `agent_{id}` 委派工具（用法同 `knowledge_base_ids`） |
+| `system_prompt_template` | string | 系统提示模板 |
+| `context.max_history` | number（默认 20） | 工作窗口：保留最近 N 条；关闭持续对话时即滑动窗口硬上限 |
+| `output_format.mode` | `text` / `json` | JSON 时按 `output_format.json.{schema,schema_name,strategy}` 约束/校验/降级 |
+| `capabilities.vision.{enabled,input,max_mb}` | 见值 | 图片/视觉输入（`image_url` part），`input`⊂{base64,url}，默认 5MB |
+| `capabilities.files.{enabled,allowed_ext,max_mb}` | 见值 | 文件附件抽取成文本注入；白名单 `.txt .md .docx .pdf .xlsx .json .csv`（pptx 不支持），默认 8MB |
+| `tools.max_iterations` | 1–50（默认 10） | ReAct 工具循环步数上限 |
+| `tools.sources[].{type,id}` | `mcp` / `custom_script` | 绑定 MCP 与「自定义服务作为工具」 |
+| `knowledge_base_ids` | int[] | 绑定知识库，生成检索工具 |
+| `skills` | 见运行时 | 绑定 Skill |
+| `sub_agent_ids` | int[] | 子智能体：为每个 id 生成 `agent_{id}` 委派工具（用法同 `knowledge_base_ids`） |
 | `call_permissions` | 角色配置 | 哪些角色可以调用此 Agent；调用接口与筛选条件以 MCP 实时契约为准 |
 | `billing_mode` | `disabled` / `inherit_model` / `per_call` / `usage` | Agent 零售计费；公开 Agent 强制 `disabled`，订阅/会员额度由业务服务管理 |
-
-### `orchestration.*`（编排开关）
-
-| 字段 | 默认 | 说明 |
-|---|---|---|
-| `tool_concurrency` | 8（1–32） | 单步内并发执行工具数 |
-| `on_max_steps` | `error` | 达步数上限：`error` 报错 / `stop` 返回最后一条 |
-| `tool_disclosure.{mode,threshold_tools}` | `off` | 工具渐进披露：`off`/`auto`/`always`，首轮只给目录+`load_tools` |
-| `planning.{enabled,prompt}` | false | 规划层：执行前先让模型列步骤，提示折叠进 system |
-| `memory.{enabled,scope}` | false / `user_agent` | 长期记忆：对话后自动提炼、下轮召回注入；作用域 `agent`/`user`/`user_agent` |
-| `compaction.{enabled,keep_recent,trigger_messages,trigger_tokens,preset}` | 关闭 | **持续对话/上下文闭环**：见下 |
-| `checkpoint_input_mode` / `checkpoint_max_messages` / `checkpoint_ttl_seconds` | 全量 / 100 / 86400 | 会话历史持久化（配合请求 `session_id`） |
+
+### `orchestration.*`（编排开关）
+
+| 字段 | 默认 | 说明 |
+|---|---|---|
+| `tool_concurrency` | 8（1–32） | 单步内并发执行工具数 |
+| `on_max_steps` | `error` | 达步数上限：`error` 报错 / `stop` 返回最后一条 |
+| `tool_disclosure.{mode,threshold_tools}` | `off` | 工具渐进披露：`off`/`auto`/`always`，首轮只给目录+`load_tools` |
+| `planning.{enabled,prompt}` | false | 规划层：执行前先让模型列步骤，提示折叠进 system |
+| `memory.{enabled,scope}` | false / `user_agent` | 长期记忆：对话后自动提炼、下轮召回注入；作用域 `agent`/`user`/`user_agent` |
+| `compaction.{enabled,keep_recent,trigger_messages,trigger_tokens,preset}` | 关闭 | **持续对话/上下文闭环**：见下 |
+| `checkpoint_input_mode` / `checkpoint_max_messages` / `checkpoint_ttl_seconds` | 全量 / 100 / 86400 | 会话历史持久化（配合请求 `session_id`） |
 | `delegation.{max_depth,max_total_calls}` | 2 / 8 | 最大嵌套层数与整棵调用树共享的子 Agent 调用次数；并行分支也从同一预算扣减 |
 
 同一模型步骤返回多个子 Agent 工具调用时，运行时立即按 `tool_concurrency` 并发执行；不同步骤自然串行，由模型自行决定编排方式。委派成功后，子 Agent 的每个模型回合 token 会汇总到入口 run，总量也写入对应委派 span。一次入口请求只创建一条主 run，Agent 列归属入口 Agent，委派链路从 span 查看。
-
-### 持续对话（上下文闭环）
-
-- `compaction.enabled=true` = 闭环：填满工作窗口后把溢出旧消息**摘要成一条滚动 summary** 续接，
-  而非直接丢弃。此时后端**跳过 `context.max_history` 硬砍**，让完整 checkpoint 历史进入压缩器蒸馏。
-- 触发为双通道任一命中：`trigger_messages`（条数）或 `trigger_tokens`（估算 token，256–2000000）。
-- `keep_recent`：保留最近 N 条不压缩。`preset`（`aggressive`/`balanced`/`conservative`）是管理台档位回显，
-  后端只认 `keep_recent`/`trigger_messages`/`trigger_tokens` 三个底层字段。
-- 配合请求体 `session_id` 才会加载/续写会话历史；`<dg-chat>` 为每个 UI thread 自动维护该值，兼容门面可通过 `DraftGoAI.chat(..., {sessionId})` 显式传入。不传即无状态单轮。
-- 关闭时逐字回退为 `max_history` 滑动窗口（旧行为，零影响）。
-
-## 观测
-
+
+### 持续对话（上下文闭环）
+
+- `compaction.enabled=true` = 闭环：填满工作窗口后把溢出旧消息**摘要成一条滚动 summary** 续接，
+  而非直接丢弃。此时后端**跳过 `context.max_history` 硬砍**，让完整 checkpoint 历史进入压缩器蒸馏。
+- 触发为双通道任一命中：`trigger_messages`（条数）或 `trigger_tokens`（估算 token，256–2000000）。
+- `keep_recent`：保留最近 N 条不压缩。`preset`（`aggressive`/`balanced`/`conservative`）是管理台档位回显，
+  后端只认 `keep_recent`/`trigger_messages`/`trigger_tokens` 三个底层字段。
+- 配合请求体 `session_id` 才会加载/续写会话历史；`<dg-chat>` 为每个 UI thread 自动维护该值，兼容门面可通过 `DraftGoAI.chat(..., {sessionId})` 显式传入。不传即无状态单轮。
+- 关闭时逐字回退为 `max_history` 滑动窗口（旧行为，零影响）。
+
+## 观测
+
 每次调用都开一条 AI run，管理台 `/admin/ai-runs` 展示状态、tokens、延迟、`ttft_ms` 与 span 链路。
 运行记录接口通过 MCP 实时发现，不维护静态路径表；已知 operation 复用 registry revision 未变化的契约缓存。
 
@@ -112,5 +112,5 @@ profile、transport readiness 和实际 route；不要只根据供应商名称
 能力名大小写敏感，使用实时 describe 返回的 canonical 值，不使用历史别名。
 
 Agent 对外响应（`/api/agents/{id}/chat`、图片接口、Go/Script SDK Agent 调用）不返回内部 `model`、`fallback_models` 或 `upstream_model`；错误也不暴露内部模型名、供应商名称、服务地址或运行时实现名。只有显式启用 `model_selection.user_selectable` 后，`/selectable-models` 才作为授权的模型选择目录返回可选逻辑模型名。运行日志仍在服务端保留真实模型、供应商与链路信息用于定位。
-
+
 > 权威细节以 DraftGo `docs/modules/ai-platform/agent-runtime.md` 和实时 MCP schema 为准；本页是基座开发者视角的字段速查。

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

@@ -1,77 +1,77 @@
----
-read_when: 页面开发时需要查 App API · 忘记某个方法签名时
----
-
-# App 对象速查表
-
-```javascript
-const App = window.parent?.App;
-```
-
-## 请求
-
-| 方法 | 签名 | 说明 |
-|---|---|---|
+---
+read_when: 页面开发时需要查 App API · 忘记某个方法签名时
+---
+
+# App 对象速查表
+
+```javascript
+const App = window.parent?.App;
+```
+
+## 请求
+
+| 方法 | 签名 | 说明 |
+|---|---|---|
 | `App.get` | `(path, params?, headers?)` | GET，params 为 query 参数 |
 | `App.post` | `(path, body?, headers?)` | POST |
 | `App.put` | `(path, body?, headers?)` | PUT |
 | `App.patch` | `(path, body?, headers?)` | PATCH |
 | `App.delete` | `(path, params?, headers?)` | DELETE |
-| `App.uploadFile` | `(file, onProgress?)` | 文件上传，返回标准信封 |
-
-**响应格式**：`{ code: 200, data: <载荷>, message: "success" }`  
-**消费范式**：
-```javascript
-const res = await App.get('pages'); // 不传分页参数时全量返回
-if (res.code !== 200) { App.showError(res.message); return; }
-const items = res.data.items;
-
-const paged = await App.get('pages', { page: 1, page_size: 20 }); // 显式分页
-```
-
-## 反馈
-
-| 方法 | 签名 | 说明 |
-|---|---|---|
+| `App.uploadFile` | `(file, onProgress?)` | 文件上传，返回标准信封 |
+
+**响应格式**：`{ code: 200, data: <载荷>, message: "success" }`  
+**消费范式**：
+```javascript
+const res = await App.get('pages'); // 不传分页参数时全量返回
+if (res.code !== 200) { App.showError(res.message); return; }
+const items = res.data.items;
+
+const paged = await App.get('pages', { page: 1, page_size: 20 }); // 显式分页
+```
+
+## 反馈
+
+| 方法 | 签名 | 说明 |
+|---|---|---|
 | `App.showSuccess` | `(msg)` | 成功 Toast |
 | `App.showError` | `(msg)` | 错误 Toast |
 | `App.showWarning` | `(msg)` | 警告 Toast |
 | `App.showInfo` | `(msg)` | 信息 Toast |
-| `App.toast` | `(msg, type?)` | 通用 Toast，type: success/error/warning/info |
-| `App.confirm` | `(msg, title?)` | 确认弹窗，返回 `Promise<boolean>` |
-| `App.showModal` | `(msg, title?)` | 信息模态框（替代 alert） |
-| `App.showLoading` | `()` | 全局 loading 蒙层 |
-| `App.hideLoading` | `()` | 关闭 loading |
-
-## 路由
-
-| 方法 | 说明 |
-|---|---|
-| `App.navigate(route)` | 路由跳转（pushState） |
-| `App.getCurrentRoute()` | 当前路径字符串 |
-| `App.getCurrentRouteContext()` | 完整路由上下文，含 `query` |
-
-**读取 URL 参数**（必须用此方式，不能用 `window.location.search`）：
-```javascript
-const routeContext =
-  window.__DG_ROUTE_CONTEXT__
-  || window.__DG_GET_ROUTE_CONTEXT__?.()
-  || window.parent?.App?.getCurrentRouteContext?.()
-  || { query: {} };
-const { patientId, visitId } = routeContext.query;
-```
-
-## 状态
-
-| 属性 | 类型 | 说明 |
-|---|---|---|
-| `App.currentUser` | object \| null | 当前用户，未登录为 null |
+| `App.toast` | `(msg, type?)` | 通用 Toast，type: success/error/warning/info |
+| `App.confirm` | `(msg, title?)` | 确认弹窗，返回 `Promise<boolean>` |
+| `App.showModal` | `(msg, title?)` | 信息模态框（替代 alert） |
+| `App.showLoading` | `()` | 全局 loading 蒙层 |
+| `App.hideLoading` | `()` | 关闭 loading |
+
+## 路由
+
+| 方法 | 说明 |
+|---|---|
+| `App.navigate(route)` | 路由跳转（pushState） |
+| `App.getCurrentRoute()` | 当前路径字符串 |
+| `App.getCurrentRouteContext()` | 完整路由上下文，含 `query` |
+
+**读取 URL 参数**（必须用此方式，不能用 `window.location.search`）：
+```javascript
+const routeContext =
+  window.__DG_ROUTE_CONTEXT__
+  || window.__DG_GET_ROUTE_CONTEXT__?.()
+  || window.parent?.App?.getCurrentRouteContext?.()
+  || { query: {} };
+const { patientId, visitId } = routeContext.query;
+```
+
+## 状态
+
+| 属性 | 类型 | 说明 |
+|---|---|---|
+| `App.currentUser` | object \| null | 当前用户，未登录为 null |
 | `App.isAdmin` | boolean | 是否管理员 |
 | `App.permissions` | string[] | 当前用户有效 permission grant 的展示投影；仅用于页面显隐，不替代服务端授权 |
 | `App.isAuthenticated` | boolean | 是否已认证 |
-| `App.hasToken` | boolean | 是否有 token（含未验证） |
-| `App.config` | object | 系统配置 KV |
-| `App.theme` | `'light'` \| `'dark'` | 当前显示模式 |
+| `App.hasToken` | boolean | 是否有 token（含未验证） |
+| `App.config` | object | 系统配置 KV |
+| `App.theme` | `'light'` \| `'dark'` | 当前显示模式 |
 | `App.colorScheme` | string | 当前配色方案 |
 | `App.scopeContext` | object | null | 当前候选范围；`scope_type` 为 `platform` / `space` |
 | `App.availableSpaces` | object[] | 当前用户可选择的工作区与递归空间 |
@@ -118,22 +118,22 @@ await App.get('business-items', { page: 1 });
 const platformHeaders = { 'X-DraftGo-Scope-Type': 'platform' };
 await App.get('roles', {}, platformHeaders);
 ```
-
-## 主题
-
-```javascript
-App.applyTheme('dark');                           // 切换显示模式
-App.setColorScheme('deep-blue-white');            // 切换预设配色
-App.setColorScheme('custom', customVarsObject);   // 自定义配色
-App.getColorScheme();                             // 获取方案详情
-```
-
-## 其他
-
-```javascript
+
+## 主题
+
+```javascript
+App.applyTheme('dark');                           // 切换显示模式
+App.setColorScheme('deep-blue-white');            // 切换预设配色
+App.setColorScheme('custom', customVarsObject);   // 自定义配色
+App.getColorScheme();                             // 获取方案详情
+```
+
+## 其他
+
+```javascript
 await App.logout();                 // 服务端登出、清理状态并跳转配置的登录页
-App.setAuthTokens({ access_token, refresh_token });  // 登录后写入 token
-App.reloadGlobalLayer();            // 重载全局层
+App.setAuthTokens({ access_token, refresh_token });  // 登录后写入 token
+App.reloadGlobalLayer();            // 重载全局层
 App.openGlobalWidget(name);         // 触发全局挂件打开
 App.getScopeContext();              // 读取当前作用域
 App.setScopeContext({ scope_type: 'space', space_id: '120' });
@@ -141,5 +141,5 @@ App.clearScopeContext();             // 清除手工选择，恢复服务端默
 App.t(key, fallback?, values?);      // 页面级国际化文本，values 保留 ICU 占位符
 App.formatDateTime(value, options?); // 按 system_timezone 格式化 API 返回的 UTC 时间
 ```
-
+
 Token、刷新、路由上下文和认证事件见 `references/runtime.md`。AI 对话、图片和兼容门面的完整契约见 `references/chat-sdk.md`，Agent 能力见 `references/aihub.md`。

package/resources/skill/references/architecture.md

@@ -1,46 +1,46 @@
----
-read_when: 进入陌生 DraftGo 项目时 · 理解平台机制时（3 分钟速读）
----
-
-# DraftGo 架构认知
-
-## 核心概念（30 秒）
-
-DraftGo **不是传统 SPA**，是「数据库驱动的页面资产运行时」：
-
-- 壳层（React + Vite）负责平台前端、runtime 编排、管理界面
-- 业务页面 HTML 存在数据库 `page.value.html`，运行在 `iframe.srcdoc`
-- 导航栏 HTML 存在数据库 `navigation.html`，壳层按需加载
-- 页面与壳层通过 `window.parent.App` 通信
-
----
-
-## 为什么这样设计（1 分钟）
-
-| 问题 | 传统 SPA | DraftGo 方案 |
-|---|---|---|
-| 页面内容更新 | 需要重新编译部署 | 直接改数据库 HTML，秒级生效 |
-| 多租户/多项目 | 需要多套工程 | 一套壳层，数据库隔离内容 |
-| 权限控制 | 路由守卫 + 条件渲染 | `page.permission` 字段控制，壳层统一拦截 |
+---
+read_when: 进入陌生 DraftGo 项目时 · 理解平台机制时（3 分钟速读）
+---
+
+# DraftGo 架构认知
+
+## 核心概念（30 秒）
+
+DraftGo **不是传统 SPA**，是「数据库驱动的页面资产运行时」：
+
+- 壳层（React + Vite）负责平台前端、runtime 编排、管理界面
+- 业务页面 HTML 存在数据库 `page.value.html`，运行在 `iframe.srcdoc`
+- 导航栏 HTML 存在数据库 `navigation.html`，壳层按需加载
+- 页面与壳层通过 `window.parent.App` 通信
+
+---
+
+## 为什么这样设计（1 分钟）
+
+| 问题 | 传统 SPA | DraftGo 方案 |
+|---|---|---|
+| 页面内容更新 | 需要重新编译部署 | 直接改数据库 HTML，秒级生效 |
+| 多租户/多项目 | 需要多套工程 | 一套壳层，数据库隔离内容 |
+| 权限控制 | 路由守卫 + 条件渲染 | `page.permission` 字段控制，壳层统一拦截 |
 | 导航定制 | 改代码重部署 | MCP 定位后 checkout navigation.html，commit 即生效 |
-
-**核心推论**：在 DraftGo 里「修改页面」= 修改数据库里的 HTML 字符串，不是修改 `.tsx` 文件。
-
----
-
+
+**核心推论**：在 DraftGo 里「修改页面」= 修改数据库里的 HTML 字符串，不是修改 `.tsx` 文件。
+
+---
+
 ## App 对象是什么（1 分钟）
 
 壳层将能力对象赋值给 `window.App`，数据库页面通过 `window.parent.App` 使用带认证的请求、反馈、路由、当前用户和主题能力。方法签名见 `references/app-api.md`；iframe 注入、认证事件和路由参数见 `references/runtime.md`。
-
----
-
-## 技术栈（30 秒）
-
-| 层 | 技术 |
-|---|---|
-| 后端 | Go 1.26 · 标准库 `net/http` · `database/sql`（go-sql-driver/mysql）· MySQL · Redis |
-| 壳层前端 | React · Vite |
+
+---
+
+## 技术栈（30 秒）
+
+| 层 | 技术 |
+|---|---|
+| 后端 | Go 1.26 · 标准库 `net/http` · `database/sql`（go-sql-driver/mysql）· MySQL · Redis |
+| 壳层前端 | React · Vite |
 | 数据库页面 | HTML 文档运行时 · Tailwind CSS 4 · Basecoat UI（默认）· Oat UI（可选）· Font Awesome · GSAP · 内置 SVG 图标库 |
-| CLI | Node.js（draftgo-cli） |
-
+| CLI | Node.js（draftgo-cli） |
+
 数据库页面以完整 HTML 文档运行，直接加载平台提供的本地资源；壳层源码按 React + Vite 工程构建。开发时按目标所属层使用上表对应技术栈。