draftgo-cli 4.0.23 → 4.0.24

package/resources/skill/references/data.md

@@ -1,7 +1,7 @@
----
-read_when: 操作动态 DB 之前 · 设计数据结构时 · 使用 filters 检索时 · 定义关联关系时
----
-
+---
+read_when: 操作动态 DB 之前 · 设计数据结构时 · 使用 filters 检索时 · 定义关联关系时
+---
+
 # 动态 DB & 数据层
 
 ## 最短管理流程
@@ -20,180 +20,180 @@ draftgo api search "dynamic db record"
 完成条件：schema 可按 `type` 回读，目标角色的最小 CRUD 与筛选行为通过；批量写入还要验证失败时整批回滚。
 
 ## DB Meta 结构
-
-```json
-{
-  "type": "order",
-  "label": "订单",
-  "schema": {
-    "type": "object",
-    "properties": {
-      "name":   { "type": "string",  "title": "姓名",   "required": true,  "searchable": "fuzzy" },
-      "status": { "type": "string",  "title": "状态",   "required": false, "searchable": "exact" },
-      "amount": { "type": "number",  "title": "金额",   "required": false, "searchable": "range" },
-      "paid_at": { "type": "datetime", "title": "支付时间", "required": false, "searchable": "range" },
-      "tags":   { "type": "array",   "title": "标签",   "required": false, "searchable": "contains" },
-      "note":   { "type": "string",  "title": "备注",   "required": false, "searchable": false }
-    }
-  },
-  "permission": {
-    "public":  { "read": "none",  "create": "none",  "update": "none",  "delete": "none" },
-    "login":   { "read": "all",   "create": "all",   "update": "owner", "delete": "owner" },
-    "admin":   { "read": "all",   "create": "all",   "update": "all",   "delete": "all" }
-  }
-}
-```
-
-**searchable 模式**：`false`（不可检索）/ `"exact"`（精确）/ `"fuzzy"`（模糊）/ `"range"`（数值/时间范围）/ `"contains"`（数组包含）
-
-`date` 字段保存为 `YYYY-MM-DD`；`datetime` 字段保存为 ISO 8601 字符串，带时区的输入会规范化为 UTC。`searchable: true` 对 `number` / `date` / `datetime` 会自动推断为 `range`。
-
-**系统字段**：以下系统字段**无需在 schema 中定义**，可直接用于检索和排序：
-
-| 字段 | 类型 | 检索模式 | 说明 |
-|---|---|---|---|
-| `id` | number | range | 记录 ID，支持 `eq` / `gte` / `lte` / `gt` / `lt` / `in` |
-| `userid` | number | range | 所属用户 ID，支持 `eq` / `gte` / `lte` / `gt` / `lt` / `in` |
-| `created_at` | datetime | range | 创建时间，支持 `eq` / `gte` / `lte` / `gt` / `lt` / `in` |
-| `updated_at` | datetime | range | 更新时间，支持 `eq` / `gte` / `lte` / `gt` / `lt` / `in` |
-
-⚠️ **注意**：虽然 DB 表有 `status` 系统列（1=正常 0=禁用 -1=删除），但由于业务常用此字段名，**需在 schema 中显式声明 `status` 的 searchable 才可检索**。
-
----
-
+
+```json
+{
+  "type": "order",
+  "label": "订单",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name":   { "type": "string",  "title": "姓名",   "required": true,  "searchable": "fuzzy" },
+      "status": { "type": "string",  "title": "状态",   "required": false, "searchable": "exact" },
+      "amount": { "type": "number",  "title": "金额",   "required": false, "searchable": "range" },
+      "paid_at": { "type": "datetime", "title": "支付时间", "required": false, "searchable": "range" },
+      "tags":   { "type": "array",   "title": "标签",   "required": false, "searchable": "contains" },
+      "note":   { "type": "string",  "title": "备注",   "required": false, "searchable": false }
+    }
+  },
+  "permission": {
+    "public":  { "read": "none",  "create": "none",  "update": "none",  "delete": "none" },
+    "login":   { "read": "all",   "create": "all",   "update": "owner", "delete": "owner" },
+    "admin":   { "read": "all",   "create": "all",   "update": "all",   "delete": "all" }
+  }
+}
+```
+
+**searchable 模式**：`false`（不可检索）/ `"exact"`（精确）/ `"fuzzy"`（模糊）/ `"range"`（数值/时间范围）/ `"contains"`（数组包含）
+
+`date` 字段保存为 `YYYY-MM-DD`；`datetime` 字段保存为 ISO 8601 字符串，带时区的输入会规范化为 UTC。`searchable: true` 对 `number` / `date` / `datetime` 会自动推断为 `range`。
+
+**系统字段**：以下系统字段**无需在 schema 中定义**，可直接用于检索和排序：
+
+| 字段 | 类型 | 检索模式 | 说明 |
+|---|---|---|---|
+| `id` | number | range | 记录 ID，支持 `eq` / `gte` / `lte` / `gt` / `lt` / `in` |
+| `userid` | number | range | 所属用户 ID，支持 `eq` / `gte` / `lte` / `gt` / `lt` / `in` |
+| `created_at` | datetime | range | 创建时间，支持 `eq` / `gte` / `lte` / `gt` / `lt` / `in` |
+| `updated_at` | datetime | range | 更新时间，支持 `eq` / `gte` / `lte` / `gt` / `lt` / `in` |
+
+⚠️ **注意**：虽然 DB 表有 `status` 系统列（1=正常 0=禁用 -1=删除），但由于业务常用此字段名，**需在 schema 中显式声明 `status` 的 searchable 才可检索**。
+
+---
+
 ## 自定义服务内的 ctx.DB.Query
 
 Go 自定义服务使用 `ctx.DB.Query(type, sdk.QueryOptions{...})` 操作动态 DB，返回 `sdk.QueryResult`：
 
 ```go
 result, err := ctx.DB.Query("order", sdk.QueryOptions{
-    Filters: map[string]any{"status": "paid"},
-    Page: 1, PageSize: 20, OrderBy: "id", Order: "desc",
-})
-items := result.Items
-```
-
-| 参数 | 说明 |
-|---|---|
-| `filters` | 字典形式结构化过滤；默认 `{field: value}` 是 `eq` 精确匹配 |
-| `Page` / `PageSize` | 分页参数；零值交由平台使用默认列表行为 |
-| `order_by` / `order` | 按 searchable 字段排序，`order` 为 `asc` / `desc` |
-
-⚠️ 返回结构为 `sdk.QueryResult{Items, Total, Page, PageSize}`。需要完整数据时必须按 `Total` 分页读取，不能用超大 `PageSize` 假装全量。
-
-普通用户调用时只读 `status=1` 数据；系统身份/管理员脚本可读全部状态数据，但仍受 db_meta permission 约束。不要把“拿不到禁用数据”和分页截断混在一起排查。
-
-`filters` 操作符示例：
-
-```go
+    Filters: map[string]any{"status": "paid"},
+    Page: 1, PageSize: 20, OrderBy: "id", Order: "desc",
+})
+items := result.Items
+```
+
+| 参数 | 说明 |
+|---|---|
+| `filters` | 字典形式结构化过滤；默认 `{field: value}` 是 `eq` 精确匹配 |
+| `Page` / `PageSize` | 分页参数；零值交由平台使用默认列表行为 |
+| `order_by` / `order` | 按 searchable 字段排序，`order` 为 `asc` / `desc` |
+
+⚠️ 返回结构为 `sdk.QueryResult{Items, Total, Page, PageSize}`。需要完整数据时必须按 `Total` 分页读取，不能用超大 `PageSize` 假装全量。
+
+普通用户调用时只读 `status=1` 数据；系统身份/管理员脚本可读全部状态数据，但仍受 db_meta permission 约束。不要把“拿不到禁用数据”和分页截断混在一起排查。
+
+`filters` 操作符示例：
+
+```go
 ctx.DB.Query("order", sdk.QueryOptions{Filters: map[string]any{
-    "status": "paid",
-    "customer_name": map[string]any{"op": "like", "value": "张"},
-    "amount": map[string]any{"op": "gte", "value": 100},
-    "id": map[string]any{"op": "in", "value": []int{1, 2, 3}},
-}})
-```
-
-字段必须在 db_meta schema 中标记 `searchable`，系统字段 `id/userid/created_at/updated_at` 可直接检索和排序。`status` 若作为业务字段检索，仍需在 schema 中显式声明。
-
----
-
+    "status": "paid",
+    "customer_name": map[string]any{"op": "like", "value": "张"},
+    "amount": map[string]any{"op": "gte", "value": 100},
+    "id": map[string]any{"op": "in", "value": []int{1, 2, 3}},
+}})
+```
+
+字段必须在 db_meta schema 中标记 `searchable`，系统字段 `id/userid/created_at/updated_at` 可直接检索和排序。`status` 若作为业务字段检索，仍需在 schema 中显式声明。
+
+---
+
 ## 关联关系（ref）
 
 关系只在需要时读取 `references/db-relations.md`。核心不变量：`many-to-one` 与 `many-to-many` 在真实持有引用 ID 的字段上配置 `ref` 和 `onDelete`；`one-to-many` 是用于 `populate` 的虚拟反向关系。级联继承当前用户权限并在同一事务中执行，不要在前端用多次 DELETE 模拟。
-
----
-
-## CRUD 操作范式
-
-```javascript
-// 查询（分页 + 结构化检索）
-const res = await App.get(`db/order`, {
-  page: 1, page_size: 20,
-  filters: ['name:like:张', 'status:eq:paid', 'amount:gte:100'],
-  order_by: 'amount', order: 'desc',
-});
-const { items, total } = res.data;
-
-// 非后台管理页面读取业务列表时，如果当前用户含 admin 角色，带 scope=mine
-// 这只影响 GET /api/db/{type} 列表，让管理员业务视角只看自己的 owner 数据
-const ownOrders = await App.get(`db/order`, {
-  page: 1,
-  page_size: 20,
-  scope: 'mine',
-});
-
-// 系统字段检索和排序（无需在 schema 中定义）
-const res = await App.get(`db/order`, {
-  filters: ['created_at:gte:2024-01-01', 'userid:eq:123'],
-  order_by: 'created_at', order: 'desc',
-});
-
-// 创建（业务字段必须放在 data 包裹里）
-await App.post(`db/order`, { data: { name: '张三', amount: 200 }, status: 1 });
-
-// 更新
-await App.put(`db/order/${id}`, { data: { amount: 250 } });
-
-// 删除
-await App.delete(`db/order/${id}`);
-
-// 批量更新（原子事务，任一失败全批回滚）
-await App.patch(`db/order/batch`, [
-  { id: 1, data: { status: 'paid' } },
-  { id: 2, data: { status: 'paid' } },
-]);
-```
-
----
-
-## filters 操作符
-
-| 操作符 | 含义 | 适用 searchable 模式 |
-|---|---|---|
-| `eq` | 精确等于 | exact / fuzzy / range |
-| `like` | 模糊包含 | fuzzy |
-| `gte` / `lte` / `gt` / `lt` | 数值/时间范围 | range |
-| `in` | 枚举命中（值逗号分隔：`status:in:paid,pending`） | exact / fuzzy / range |
-| `contains` | 数组字段包含某值 | contains |
-
-- 省略操作符（`filters: ['name:张三']`）默认 `like`
-- 多个 filters 为 AND
-- 字段未标 searchable 或操作符不匹配 → 后端返回 400
-- **系统字段**（`id` / `userid` / `created_at` / `updated_at`）无需在 schema 中声明，可直接使用
-- `scope=mine` 只对拥有 admin 角色的用户在 `GET /api/db/{type}` 列表请求中生效；非后台管理页面若当前用户是管理员，读取动态 DB 业务列表时应带该参数；后台管理页不要带，详情和写操作也不要带
-
----
-
-## db_meta 实时契约
-
+
+---
+
+## CRUD 操作范式
+
+```javascript
+// 查询（分页 + 结构化检索）
+const res = await App.get(`db/order`, {
+  page: 1, page_size: 20,
+  filters: ['name:like:张', 'status:eq:paid', 'amount:gte:100'],
+  order_by: 'amount', order: 'desc',
+});
+const { items, total } = res.data;
+
+// 非后台管理页面读取业务列表时，如果当前用户含 admin 角色，带 scope=mine
+// 这只影响 GET /api/db/{type} 列表，让管理员业务视角只看自己的 owner 数据
+const ownOrders = await App.get(`db/order`, {
+  page: 1,
+  page_size: 20,
+  scope: 'mine',
+});
+
+// 系统字段检索和排序（无需在 schema 中定义）
+const res = await App.get(`db/order`, {
+  filters: ['created_at:gte:2024-01-01', 'userid:eq:123'],
+  order_by: 'created_at', order: 'desc',
+});
+
+// 创建（业务字段必须放在 data 包裹里）
+await App.post(`db/order`, { data: { name: '张三', amount: 200 }, status: 1 });
+
+// 更新
+await App.put(`db/order/${id}`, { data: { amount: 250 } });
+
+// 删除
+await App.delete(`db/order/${id}`);
+
+// 批量更新（原子事务，任一失败全批回滚）
+await App.patch(`db/order/batch`, [
+  { id: 1, data: { status: 'paid' } },
+  { id: 2, data: { status: 'paid' } },
+]);
+```
+
+---
+
+## filters 操作符
+
+| 操作符 | 含义 | 适用 searchable 模式 |
+|---|---|---|
+| `eq` | 精确等于 | exact / fuzzy / range |
+| `like` | 模糊包含 | fuzzy |
+| `gte` / `lte` / `gt` / `lt` | 数值/时间范围 | range |
+| `in` | 枚举命中（值逗号分隔：`status:in:paid,pending`） | exact / fuzzy / range |
+| `contains` | 数组字段包含某值 | contains |
+
+- 省略操作符（`filters: ['name:张三']`）默认 `like`
+- 多个 filters 为 AND
+- 字段未标 searchable 或操作符不匹配 → 后端返回 400
+- **系统字段**（`id` / `userid` / `created_at` / `updated_at`）无需在 schema 中声明，可直接使用
+- `scope=mine` 只对拥有 admin 角色的用户在 `GET /api/db/{type}` 列表请求中生效；非后台管理页面若当前用户是管理员，读取动态 DB 业务列表时应带该参数；后台管理页不要带，详情和写操作也不要带
+
+---
+
+## db_meta 实时契约
+
 db_meta 是结构化远端资源，不 checkout，也不生成本地索引。未知 operation 才通过 MCP
 `draftgo_api_search` 定位；首次使用或 registry revision 变化时 `draftgo_api_describe`，再用
 `draftgo_api_call` 查询目标 type 和 schema。
-典型返回条目如下：
-
-```json
-[
-  {
-    "id": 1,
-    "type": "order",
-    "label": "订单",
-    "schema": { ... }
-  }
-]
-```
-
-⚠️ **GET `/api/db-meta/{type}` 用 type（如 `order`），不是 id。PUT/DELETE 才用 id。**
-
----
-
-## 通用筛选参数（非动态 DB）
-
-用于 users / roles / pages / navigations / feedback 等标准资源：
-
-| 参数 | 说明 |
-|---|---|
-| `page` / `page_size` | 分页（不传返回全量且无上限；任一传入则分页，缺失项按 `page=1` / `page_size=20` 兜底） |
-| `search` | 全文搜索（动态 DB 不用此参数） |
-| `status` | 状态过滤 |
-| `type` / `tag` | 类型/标签过滤 |
+典型返回条目如下：
+
+```json
+[
+  {
+    "id": 1,
+    "type": "order",
+    "label": "订单",
+    "schema": { ... }
+  }
+]
+```
+
+⚠️ **GET `/api/db-meta/{type}` 用 type（如 `order`），不是 id。PUT/DELETE 才用 id。**
+
+---
+
+## 通用筛选参数（非动态 DB）
+
+用于 users / roles / pages / navigations / feedback 等标准资源：
+
+| 参数 | 说明 |
+|---|---|
+| `page` / `page_size` | 分页（不传返回全量且无上限；任一传入则分页，缺失项按 `page=1` / `page_size=20` 兜底） |
+| `search` | 全文搜索（动态 DB 不用此参数） |
+| `status` | 状态过滤 |
+| `type` / `tag` | 类型/标签过滤 |

package/resources/skill/references/methods.md

@@ -60,6 +60,7 @@ DataRange     = 作用域内记录策略：none / own / all
 
 platform AccessGrant 可跨空间，但只覆盖角色中显式列出的权限；space Grant 只能覆盖同根的 self/subtree。请求 header 只是候选上下文。
 创建、读取、更新、删除都必须由服务端同时校验动作权限、持久化 ResourceOwnership 和 DataRange。
+用户注册成功时，服务端会授予所有启用的注册默认平台 Role，并将用户加入系统默认工作区及其 `default_members` 用户组；前者创建 AccessGrant，后者创建成员关系，两者互不替代。
 
 ### 空间化最短流程
 
@@ -84,6 +85,8 @@ platform AccessGrant 可跨空间，但只覆盖角色中显式列出的权限
 
 适用场景：修改已有 page/navigation/article 完整正文，或创建后继续编辑正文。
 
+`docs/articles` 是系统说明使用的平台资源，只接受 platform scope；不要为文档传 `scope_type=space` 或 `space_id`。
+
 ```bash
 draftgo map --type pages --route /admin/channel-ops --output json
 draftgo checkout pages <id>

package/resources/skill/references/modules.md

@@ -1,27 +1,27 @@
----
-read_when: 评估功能可行性时 · 选择开发路径时 · 进入新项目做全局了解时
----
-
-# DraftGo 模块地图
-
-## 可开发模块（开发者负责实现）
-
-| 模块 | 开发方式 | 入口 |
-|---|---|---|
+---
+read_when: 评估功能可行性时 · 选择开发路径时 · 进入新项目做全局了解时
+---
+
+# DraftGo 模块地图
+
+## 可开发模块（开发者负责实现）
+
+| 模块 | 开发方式 | 入口 |
+|---|---|---|
 | 页面 | 数据库 HTML（`page.value.html`） | 已有页面由 MCP 定位后 `checkout pages` / `commit pages`；新页面先按实时 API 契约创建并取得 ID |
-| 导航栏 | 数据库 HTML（`navigation.html`） | MCP 定位，`checkout nav` / `commit nav` 编辑正文 |
+| 导航栏 | 数据库 HTML（`navigation.html`） | MCP 定位，`checkout nav` / `commit nav` 编辑正文 |
 | 动态 DB | db_meta 定义 schema 并操作结构化记录 | MCP `api_search` / `api_describe` / `api_call` |
 | 文件资产 | 文件夹、文件元数据、绑定、下载、回收站和对象存储 | MCP 实时 API；文件字节不进入普通 tool result |
 | 自定义服务 | 单一 Go `Register` 服务；后端从注册代码自动发现 Route/Event/Scheduled handler | MCP 定位/创建；正文用 `checkout custom-services` / `commit custom-services` |
-| AIHub | 配置 AI Agent（模型/编排/能力/子智能体/记忆）；页面对话使用 `<dg-chat>`，图片模式使用 `DraftGoAI.images`；见 `references/chat-sdk.md` 与 `references/aihub.md` | MCP 实时 API；不创建本地镜像 |
-| 文档中心 | Markdown/HTML 文章 + 分类树 | 正文用 `checkout docs` / `commit docs`；分类用 MCP |
+| AIHub | 配置 AI Agent（模型/编排/能力/子智能体/记忆）；页面对话使用 `<dg-chat>`，图片模式使用 `DraftGoAI.images`；见 `references/chat-sdk.md` 与 `references/aihub.md` | MCP 实时 API；不创建本地镜像 |
+| 文档中心 | 平台级 Markdown/HTML 系统文章 + 分类树 | 正文用 `checkout docs` / `commit docs`；分类用 MCP；不传 space scope |
 | 系统配置 | KV 存储，含全局前端层槽位 | MCP 实时 API；不创建本地镜像 |
 | 商业与计费 | 账本、余额、权益、支付订单、退款、套餐、订阅和 AI 计费 | 管理任务用 MCP 实时 API；自定义服务用 `ctx.Billing` / `ctx.Admin.Billing`；不要用动态 DB 重建金钱状态 |
-
-## 平台内置模块（开箱即用，不需实现）
-
-| 模块 | 能力 | 调用方式 |
-|---|---|---|
+
+## 平台内置模块（开箱即用，不需实现）
+
+| 模块 | 能力 | 调用方式 |
+|---|---|---|
 | 认证 | 注册/登录/刷新/找回密码/微信登录/手机邮箱验证 | 页面使用 `App`；服务端操作通过 MCP 实时描述接口 |
 | 角色权限 | 无作用域 Role 模板 + 带 `platform` / `space` 范围的 AccessGrant | 页面可用 `App.permissions` 辅助显隐；服务端按资源授权 |
 | 工作区与空间 | 根工作区成员、用户组和递归 Space；成员关系本身不授权 | `App.scopeContext` + MCP space/group/grant operations；资源保存直接归属 |
@@ -33,7 +33,7 @@ read_when: 评估功能可行性时 · 选择开发路径时 · 进入新项目
 
 `App.currentUser.role_code` 是展示投影，不是用户表中的可写字段。真正的资源/API 授权由服务端根据 ResourceOwnership 与有效 AccessGrant 决定；platform Grant 也只能使用角色中显式声明的权限。
 
-用户 API Key 只是一种用户认证方式；它不改变 AccessGrant、ResourceOwnership、DataRange 或管理员边界。服务身份是平台运行时主体。
+用户 API Key 只是一种用户认证方式；它不改变 AccessGrant、ResourceOwnership、DataRange 或管理员边界。无人值守任务由平台运行时以 system 身份执行。
 
 ## 新模块权限接入检查表
 
@@ -47,12 +47,12 @@ AI 新建或扩展受保护模块时，按以下最小闭环逐项确认；缺
 - [ ] 保留最小拒绝证据：无 Grant、space Grant 跨根、伪造归属；支持 own/all 时再覆盖他人记录拒绝。不要为同一规则复制一套测试框架。
 
 实现位置和具体 API 以目标 DraftGo 服务端仓库的现有 Catalog、ResourceOwnership 与 WorkspaceAuthorizer 模式为准；本 Skill 不复制服务端动态 schema。
-
-## 模块选型决策
-
-```
+
+## 模块选型决策
+
+```
 要存储业务数据？
-  → 有固定结构 → 动态 DB（db_meta 定义 schema）
+  → 有固定结构 → 动态 DB（db_meta 定义 schema）
   → 仅需 KV → sys_config（category 自定义）
 
 要保存文件？
@@ -60,35 +60,35 @@ AI 新建或扩展受保护模块时，按以下最小闭环逐项确认；缺
 
 要做余额、支付、会员或订阅？
   → 管理操作走 money/payment/subscription/billing 的 MCP 实时契约；自定义服务读 `.draftgo-sdk/billing.go` 并使用 Billing SDK，不自行实现账本或扣费一致性
-
-要调用 AI？
-  → 聊天/问答 UI → AIHub + `<dg-chat>`（自动隔离 thread/session）
-  → 无 UI 的旧代码文本调用 → AIHub + DraftGoAI.chat()（兼容门面）
+
+要调用 AI？
+  → 聊天/问答 UI → AIHub + `<dg-chat>`（自动隔离 thread/session）
+  → 无 UI 的旧代码文本调用 → AIHub + DraftGoAI.chat()（兼容门面）
   → 图片生成 → AIHub + DraftGoAI.images()
   → Responses、Embedding、Rerank、TTS、ASR 或 Video → AIHub capability 与 provider readiness；先确认模型的 canonical capability 和 transport
-  → 需要工具/子智能体/记忆/结构化输出/多模态 → 都是 Agent spec 开关，见 references/aihub.md
-
-要调用第三方服务？
+  → 需要工具/子智能体/记忆/结构化输出/多模态 → 都是 Agent spec 开关，见 references/aihub.md
+
+要调用第三方服务？
   → 自定义服务（用 `ctx.HTTP` 请求；在同一 Go 服务中按需注册 Route/Event/Scheduled handler）
-
-要展示内容文档？
-  → 文档中心（Markdown + 分类树）
-
-要做定时任务或事件响应？
+
+要展示内容文档？
+  → 文档中心（Markdown + 分类树）
+
+要做定时任务或事件响应？
   → 自定义服务（用 `app.Schedule` / `app.On` 注册；后端自动识别定时任务和事件 handler）
-
-要做后台管理页？
-  → 业务页面 + 动态 DB + 角色权限
-```
-
-## 自定义服务边界
-
-- 新服务使用 Go `Register(app *sdk.App)` 自动注册路由、事件和定时任务；完整语言、`draftgo` 和 SDK 契约见 `references/custom-services.md`。
+
+要做后台管理页？
+  → 业务页面 + 动态 DB + 角色权限
+```
+
+## 自定义服务边界
+
+- 新服务使用 Go `Register(app *sdk.App)` 自动注册路由、事件和定时任务；完整语言、`draftgo` 和 SDK 契约见 `references/custom-services.md`。
 - `Route`：对外暴露 HTTP 端点；同一 Go 服务可用多个 `app.Route(method, path, handler)` 注册多个端点，实际路径通过 MCP 实时发现，草稿行为先用 `draftgo test custom-services` 验证。
 - `Event`：响应平台事件，如 `db.created` / `db.updated` / `user.registered`；用 `app.On(event, handler)` 注册，可为同一事件注册多个 handler。
 - `Scheduled`：用 `app.Schedule("分 时 日 月 周", handler)` 注册 cron；同一服务可声明多个定时 handler。
-- 新 Go 服务的 `Register` 是唯一触发器事实来源；旧 `triggers` 字段不参与注册。
+- 新 Go 服务的 `Register` 是唯一触发器事实来源；旧 `triggers` 字段不参与注册。
 - 管理面由角色 RBAC 的 `scripts:*` 动作控制；Route 不再读取服务级 `permission`，由宿主认证、持久化 ownership 和 `scripts:execute` AccessGrant 统一控制。
-- Go 服务在独立子进程中构建/运行；只有可信角色才能获得 `scripts:create` / `scripts:update`。
-- 自定义服务适合服务端加工、鉴权后聚合、第三方回调、定时任务和事件响应；普通 CRUD 管理界面优先用“页面 + 动态 DB”，不要把所有业务后台都塞进 route 脚本。
+- Go 服务在独立子进程中构建/运行；只有可信角色才能获得 `scripts:create` / `scripts:update`。
+- 自定义服务适合服务端加工、鉴权后聚合、第三方回调、定时任务和事件响应；普通 CRUD 管理界面优先用“页面 + 动态 DB”，不要把所有业务后台都塞进 route 脚本。
 - 脚本内读动态 DB 用 `ctx.DB.Query(type, sdk.QueryOptions{...})`；返回 `sdk.QueryResult`，分页和筛选见 `references/custom-services.md`。