draftgo-cli 3.0.33 → 3.0.38

package/resources/skill/references/data.md

@@ -267,9 +267,11 @@ await App.patch(`db/order/batch`, [
 
 ---
 
-## db_meta 本地文件
+## db_meta 实时契约
 
-开发前先读 `.draftgo/db_meta/index.json` 了解可用 type 和字段：
+db_meta 是结构化远端资源，不 checkout，也不生成本地 `index.json`。开发前先通过 MCP
+`draftgo_api_search` / `draftgo_api_describe` 确认接口，再用 `draftgo_api_call` 查询目标 type 和 schema。
+典型返回条目如下：
 
 ```json
 [

package/resources/skill/references/frontend.md

@@ -30,7 +30,6 @@ version: 2.0.0
 ### 操作型页面布局（强制）
 
 后台管理、表格、列表等操作型页面用**工作台布局**，不用文档流堆叠：
-强烈建议直接使用antd的组件
 ```css
 .workbench-page { min-height:100vh; display:flex; flex-direction:column; overflow:hidden; }
 .workbench-toolbar { flex-shrink:0; }
@@ -42,11 +41,51 @@ version: 2.0.0
 - 分页/操作栏/保存栏固定在工作区底部，不随数据量上浮
 - 滚动发生在数据区，不是整页
 
+### 表格工作区布局
+
+所有数据表格页面，无论使用原生表格、AntD 或其他组件库，都遵守同一布局契约：
+
+- 页面根容器占满可用视口或 iframe 内容区，使用 `height: 100%`、`height: 100vh` 或已知导航高度的 `calc(...)`；不能由表格内容决定页面高度。
+- 表格内容区占据工具栏和底部控制区以外的所有剩余空间：`flex: 1; min-height: 0`。
+- 纵向和横向滚动只能发生在表格内容区。横向滚动条必须紧贴在分页或批量操作栏上方，不能落在长列表的末尾。
+- 分页、批量操作栏、保存栏等底部控制区使用 `flex-shrink: 0`，始终停在工作区底部；数据只有一行或没有数据时也不向上漂移。
+- 禁止使用 `min-height` 加自然文档流模拟该布局，也不要让 `body`、页面根和表格内容区同时滚动。
+
+通用骨架：
+
+```html
+<main class="table-workspace">
+  <header class="table-toolbar">...</header>
+  <section class="table-viewport">
+    <table>...</table>
+  </section>
+  <footer class="table-footer">...</footer>
+</main>
+```
+
+```css
+.table-workspace {
+  height: 100%;
+  min-height: 0;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+.table-toolbar,
+.table-footer { flex-shrink: 0; }
+.table-viewport {
+  flex: 1;
+  min-height: 0;
+  overflow: auto; /* X scrollbar remains immediately above .table-footer */
+}
+.table-viewport > table { min-width: max-content; }
+```
+
 ### 表格数据区与分页钉底
 
 当页面主体是表格、日志列表、后台数据管理页时，必须先做固定高度的 flex column 容器，再放表格。不要让分页跟随表格内容高度往下跑，也不要让整页滚动。
 
-推荐骨架：
+参考骨架：
 
 ```css
 /* 整页表格页 */
@@ -87,7 +126,7 @@ version: 2.0.0
 }
 ```
 
-antd Table 推荐结构：
+AntD Table 示例结构：
 
 ```javascript
 h('div', { className: 'table-page' },
@@ -160,17 +199,6 @@ h(antd.Table, {
 })
 ```
 
-硬性验收：
-
-- 最外层容器高度明确：整页用 `height:100vh`；有顶部导航时用 `calc(100vh - 顶部导航高度)`；嵌在已固定高度的工作区时用 `height:100%; min-height:0`。
-- 布局必须是 `display:flex; flex-direction:column`。
-- 顶部筛选区 / toolbar 若存在，使用自适应高度并 `flex-shrink:0`。
-- 中间表格区域必须是 `flex:1; min-height:0; overflow:auto`。
-- 分页区域必须在容器最底部，使用 `flex-shrink:0; margin-top:auto`。
-- 禁止分页随数据内容高度下移；数据很多时只滚动 `.table-data`。
-- 表格列多时使用 antd `scroll.x` 或内部横滚，禁止撑出整页横向滚动条；需要随时可横向滑动时，横向滚动条必须固定在分页上方。
-- 不要同时让 `body`、页面容器、表格容器三层都滚动；最多保留表格数据区滚动。
-
 ### 文本与图标换行控制（强制）
 
 按钮、标签、导航项、状态徽章等**小范围整体区域**内的文本和图标，**禁止自动换行**：
@@ -315,7 +343,7 @@ antd Modal：`width="min(90vw, 520px)"`；抽屉窄屏优先 `placement="bottom"
 
 ### 导航与系统页边界（强制）
 
-- 顶部导航已有内置资源时，通常先读 `.draftgo/navigations/index.json` 和对应 HTML；需要新导航时优先复制/复刻一份再改造，而不是直接改坏内置导航。
+- 顶部导航已有内置资源时，先通过 MCP 查询导航元数据；需要分析或编辑完整 HTML 时执行 `draftgo checkout nav <id>`，读取 worktree 文件。需要新导航时优先基于现有结构创建或复刻，而不是直接改坏内置导航。
 - 导航栏通常要同时考虑未登录 / 已登录 / 管理员三种状态，以及收起 / 展开状态；普通用户不显示管理后台入口，管理员额外显示管理后台入口。
 - 管理端侧边栏通常基于现有内置侧边栏修改，新增业务管理路由优先追加或局部调整；删除系统内置页面入口前先确认影响。
 - 业务页面内可以做局部二级导航或侧边栏，但必须考虑外部导航已存在且可单独配置，避免重复渲染全局导航。
@@ -360,6 +388,51 @@ antd Modal：`width="min(90vw, 520px)"`；抽屉窄屏优先 `placement="bottom"
 
 ---
 
+## 前端底座与组件库清单
+
+### 运行形态
+
+- **壳层前端**位于 DraftGo 基座的 `frontend/`，技术栈为 React 19 + Vite 8 + Tailwind CSS 4；这是维护壳层代码时使用的构建链路。
+- **业务页面和导航 HTML**存储在数据库资源中，由壳层以 iframe 运行。它们必须是完整的原生 HTML 文档，不能写入 TSX、ESM import、npm 依赖或 Vite 构建产物。
+- 数据库页面需要 React 时，只能使用下方内置的 React 18 UMD 资源和 `window.React` / `window.ReactDOM`。不要把壳层的 React 19 npm 依赖、外部 CDN 或其他 React 版本混入页面。
+- 新建页面先确认是“壳层源码修改”还是“数据库 HTML 页面”。二者的组件、构建和资源加载方式不同，不能混用。
+
+### 内置组件库清单
+
+| 名称 | 版本 | 运行形态 | 本地资源 |
+|---|---:|---|---|
+| Ant Design | 5.29.3 | React 18 UMD，导出 `window.antd` | `/assets/antd/reset.css`、`/assets/react/react.min.js`、`/assets/react-dom/react-dom.min.js`、`/assets/dayjs/dayjs.min.js`、`/assets/antd/antd.min.js` |
+| Basecoat UI | 1.0.2 | HTML + CSS/JS，导出 `window.basecoat` | `/assets/vendor/basecoat/basecoat.min.css`、`/assets/vendor/basecoat/basecoat.min.js` |
+| Oat UI | 0.7.0 | Web Components，导出 `window.ot` | `/assets/vendor/oat/oat.min.css`、`/assets/vendor/oat/oat.min.js` |
+
+此清单不规定组件库选择或场景对应关系；根据页面需求自行决定是否使用其中任一库。
+
+### 主题适配与标准加载方式
+
+基座提供两个适配资源：`/assets/adapters/draftgo-ui.js` 和 `/assets/adapters/draftgo-theme.css`。
+
+- `draftgo-ui.js` 暴露 `window.DraftGoUI`，其中 `DraftGoUI.load(name)` 接受 `antd`、`basecoat`、`oat`，按资源清单加载对应库；加载 AntD 后会为 React 根节点接入 DraftGo 的主题 token。
+- `draftgo-theme.css` 用于 Basecoat 和 Oat，将其语义变量映射到 DraftGo 的 `--dg-*` token。它必须在对应组件库 CSS **之后**加载。
+- 页面手工引入 AntD 时，必须严格遵守下方的依赖顺序；不要附加第三方 AntD CSS，也不要使用 ESM/CDN 版本。
+
+```html
+<!-- Basecoat：组件 CSS 在前，DraftGo 主题适配层在后 -->
+<link href="/assets/vendor/basecoat/basecoat.min.css" rel="stylesheet">
+<link href="/assets/adapters/draftgo-theme.css" rel="stylesheet">
+<script src="/assets/adapters/draftgo-ui.js"></script>
+<script src="/assets/vendor/basecoat/basecoat.min.js" defer></script>
+
+<!-- 或由适配器按清单加载：await DraftGoUI.load('basecoat') -->
+```
+
+```html
+<!-- Oat：同样让主题适配层位于组件 CSS 之后 -->
+<link href="/assets/vendor/oat/oat.min.css" rel="stylesheet">
+<link href="/assets/adapters/draftgo-theme.css" rel="stylesheet">
+<script src="/assets/adapters/draftgo-ui.js"></script>
+<script src="/assets/vendor/oat/oat.min.js" defer></script>
+```
+
 ## 本地静态资源清单
 
 | 路径 | 说明 |
@@ -370,6 +443,10 @@ antd Modal：`width="min(90vw, 520px)"`；抽屉窄屏优先 `placement="bottom"
 | `/assets/react-dom/react-dom.min.js` | ReactDOM 18 UMD → `window.ReactDOM` |
 | `/assets/dayjs/dayjs.min.js` | dayjs → antd DatePicker 依赖 |
 | `/assets/antd/antd.min.js` | Ant Design 5.29.3 UMD → `window.antd` |
+| `/assets/adapters/draftgo-ui.js` | DraftGo UI 适配器；提供 `window.DraftGoUI`、组件库按需加载和 AntD 主题接入 |
+| `/assets/adapters/draftgo-theme.css` | Basecoat / Oat 到 DraftGo `--dg-*` 主题 token 的 CSS 映射；应后于对应组件 CSS 加载 |
+| `/assets/vendor/basecoat/basecoat.min.css` + `basecoat.min.js` | Basecoat UI 1.0.2，原生 HTML 组件库 |
+| `/assets/vendor/oat/oat.min.css` + `oat.min.js` | Oat UI 0.7.0，Web Components 组件库 |
 | `/assets/fontawesome/css/all.min.css` | FontAwesome 6 |
 | `/assets/icons/{name}.svg` | 内置精选 SVG 图标库（kebab-case 命名） |
 | `/assets/icons/manifest.json` | 图标库映射清单 |
@@ -416,11 +493,10 @@ AI 模型 / Provider 品牌图标可以使用 LobeHub 静态图标的 npmmirror
 
 ---
 
-## Ant Design 使用规范
+## Ant Design 运行契约
 
-Ant Design 5.29.3 已内置为 UMD 包（`window.antd`），可优先选择使用。
+Ant Design 5.29.3 已内置为 UMD 包（`window.antd`）。
 
-> `Segmented` 的默认样式视觉厚重、组件库感过强，禁止原样用于成品界面；优先根据语义改用 `Tabs`、`Radio.Group` 等更合适的控件，确需使用时必须通过 `ConfigProvider`、design token 或组件公开 API 调整为与页面一致的轻量样式。
 
 ### ① 依赖加载顺序（缺一不可，顺序不可乱）
 
@@ -434,7 +510,7 @@ Ant Design 5.29.3 已内置为 UMD 包（`window.antd`），可优先选择使
 
 > 资源版本固定为 5.29.3。只加载 `/assets/antd/reset.css` 和 UMD JS；组件样式由 UMD 运行时注入，禁止额外加载或引用 `/assets/antd/antd.min.css`，也禁止混用其他版本的 Ant Design CSS。
 
-### ② 强烈建议：跟随 DraftGo 系统主题
+### ② DraftGo 主题接入
 
 用 `antd.ConfigProvider` 包裹根组件，读取 `App.theme` 和 CSS 变量 `--dg-accent`，实现 dark/light 自动切换和主题色联动：
 
@@ -475,9 +551,9 @@ ReactDOM.createRoot(document.getElementById('root')).render(React.createElement(
 - 自建组件时，业务页才是状态样式的所有者；状态规则必须收敛到该组件的专有类或页面根容器内，不能影响其他组件或页面。
 - 改动前先确认所有权；同一状态属性不得同时由 token/API 和 CSS 覆盖定义。若必须接管第三方组件样式，先移除或禁用原有对应效果，再用有作用域的规则完整接管。
 
-### ④ 强烈建议：弹窗和 Toast 走 DraftGo 系统
+### ④ DraftGo 平台反馈 API 对照
 
-| antd 原生 | 改用 |
+| antd 原生 | 对应平台 API |
 |-----------|------|
 | `Modal.confirm(...)` | `await App.confirm(msg, title)` |
 | `Modal.info / warning(...)` | `App.showModal(msg, title)` |
@@ -512,7 +588,7 @@ h('div', { style: { textAlign: 'center' } },
 )
 ```
 
-### ✅ antd 页面：用 `antd.Empty`（首选）
+### antd 页面：`antd.Empty` 示例
 
 ```javascript
 const { Empty } = antd;
@@ -565,7 +641,7 @@ h('div', { style: { display:'flex', flexDirection:'column', alignItems:'center',
 
 ## GSAP 动效规范
 
-**做页面时，尽可能引入 GSAP 提升体验感**。GSAP 是 DraftGo 内置动效库，适合入场动画、滚动交互、状态切换、数字滚动等所有需要"动起来"的场景。
+GSAP 是 DraftGo 内置动效库。使用时遵守以下加载和清理约束。
 
 加载规则：
 - 核心 `gsap.min.js` 必须首先加载，其余插件按需选加

package/resources/skill/references/mcp.md

@@ -0,0 +1,101 @@
+---
+read_when: 配置或诊断 DraftGo MCP 时 · 查询实时资源或 API 契约时 · 判断宿主支持范围时
+---
+
+# DraftGo MCP
+
+> 根 `SKILL.md` 在 Skill 触发时会自动加载。使用本文件前，先完成根 Skill 的“强制预读：Reference 优先于 MCP”任务路由。本文件只说明实时 MCP 的边界和调用顺序，不能替代页面、前端、运行时、安全或模块资料。
+
+## 边界
+
+DraftGo MCP 用于实时发现、结构化查询和普通 API 操作。完整 pages、navigations、docs/articles 正文不通过
+MCP tool result 或参数传输；需要全文时使用 `draftgo checkout`，提交时使用 `draftgo commit`。MCP 返回
+`artifact` / `omitted` 时保留该语义，不要尝试重新展开长内容。
+
+标准发现顺序：
+
+1. `draftgo_project_overview`
+2. `draftgo_resource_search` 或 `draftgo_resource_list`
+3. 按需调用 `draftgo_resource_get_metadata` 或 `draftgo_resource_read_fragment`
+4. 需要实时 API 契约时调用 `draftgo_api_search`、`draftgo_api_describe`
+5. 结构化资源读写使用 `draftgo_api_call`
+
+结构化资源包括 db_meta、AIHub、system_config、roles、users、doc_categories 和自定义服务元数据。
+这些资源不 checkout，也不生成 `.draftgo/*/index.json` 镜像。
+
+## CLI
+
+```bash
+draftgo mcp setup [target...]
+draftgo mcp status [target...]
+draftgo mcp test
+draftgo mcp serve
+```
+
+- `setup` 写入项目级宿主配置，只替换 `draftgo` MCP 条目并保留其他配置。
+- `status` 检查配置是否存在、格式是否有效，以及是否误写了凭据或远端 URL。
+- `test` 从 `.draftgo/config.json` 读取连接，验证 initialize、tools/list 和关键 tools/call。
+- `serve` 启动 stdio bridge，把宿主请求代理到当前项目配置的远端 Streamable HTTP `/mcp`。
+
+`draftgo connect` 保存并验证 server/SAT、探测 `/mcp` 和关键工具，并可提示宿主 setup；它不下载业务资源，
+也不创建 pages、navigation、docs、db_meta 等本地镜像。底座仍在开发或暂不可达时，报告诊断结果即可，
+不得回退到 `pull --all`。
+
+## 宿主配置
+
+| 宿主 | 项目配置 | MCP setup |
+|---|---|---|
+| Codex | `.codex/config.toml` | 支持 |
+| Claude Code | `.mcp.json` | 支持 |
+| Cursor | `.cursor/mcp.json` | 支持 |
+| Gemini CLI | `.gemini/settings.json` | 支持 |
+| Kiro | `.kiro/settings/mcp.json` | 支持 |
+| GitHub Copilot | `.vscode/mcp.json` | 支持 |
+| Windsurf | 无可靠的项目级适配 | 不支持，CLI 必须明确提示 |
+| Antigravity | 无可靠的项目级适配 | 不支持，CLI 必须明确提示 |
+
+Codex 配置：
+
+```toml
+[mcp_servers.draftgo]
+command = "draftgo"
+args = ["mcp", "serve"]
+```
+
+Claude Code、Cursor、Gemini CLI 和 Kiro 使用各自文件中的 `mcpServers`：
+
+```json
+{
+  "mcpServers": {
+    "draftgo": {
+      "command": "draftgo",
+      "args": ["mcp", "serve"]
+    }
+  }
+}
+```
+
+GitHub Copilot 使用 `servers`，并声明 stdio：
+
+```json
+{
+  "servers": {
+    "draftgo": {
+      "type": "stdio",
+      "command": "draftgo",
+      "args": ["mcp", "serve"]
+    }
+  }
+}
+```
+
+配置中不得出现 SAT、token、Authorization、headers、远端 `/mcp` URL、`env` 或带凭据的命令行。
+bridge 必须从当前工作目录的 `.draftgo/config.json` 读取 server/SAT。
+
+## 协议与安全
+
+- stdio 只输出 MCP JSON-RPC 帧；普通日志写入 stderr，且不得包含 SAT。
+- 代理 initialize、tools/list、tools/call、通知、取消、错误和流式响应，不改写底座 schema 或结构化错误。
+- HTTP 401/403、协议错误和工具缺失必须清晰失败；输出前对 SAT 和 Authorization 值做脱敏。
+- `.draftgo/config.json`、`.draftgo/worktree/` 和 `.draftgo/conflicts/` 必须加入 `.gitignore`。
+- MCP 不可用时运行 `draftgo mcp test` 收集证据；不要读取旧索引作为替代事实来源。

package/resources/skill/references/modules.md

@@ -8,13 +8,13 @@ read_when: 评估功能可行性时 · 选择开发路径时 · 进入新项目
 
 | 模块 | 开发方式 | 入口 |
 |---|---|---|
-| 页面 | 数据库 HTML（`page.value.html`） | `.draftgo/pages/` |
-| 导航栏 | 数据库 HTML（`navigation.html`） | `.draftgo/navigations/` |
-| 动态 DB | db_meta 定义 schema + `/api/db/{type}` 操作数据 | `.draftgo/db_meta/` |
-| 自定义服务 | Go `Register` 服务，支持 route/event/scheduled 混合注册 | `.draftgo/custom_scripts/` |
-| AIHub | 配置 AI Agent（模型/编排/能力/子智能体/记忆）；页面对话使用 `<dg-chat>`，图片模式使用 `DraftGoAI.images`；见 `references/chat-sdk.md` 与 `references/aihub.md` | `.draftgo/aihub/` |
-| 文档中心 | Markdown 文章 + 分类树 | `.draftgo/docs/articles/` |
-| 系统配置 | KV 存储，含全局前端层槽位 | `.draftgo/system_config/` |
+| 页面 | 数据库 HTML（`page.value.html`） | MCP 定位，`checkout pages` / `commit pages` 编辑正文 |
+| 导航栏 | 数据库 HTML（`navigation.html`） | MCP 定位，`checkout nav` / `commit nav` 编辑正文 |
+| 动态 DB | db_meta 定义 schema + `/api/db/{type}` 操作数据 | MCP `api_search` / `api_describe` / `api_call` |
+| 自定义服务 | Go `Register` 服务，支持 route/event/scheduled 混合注册 | MCP 实时 API；不创建本地镜像 |
+| AIHub | 配置 AI Agent（模型/编排/能力/子智能体/记忆）；页面对话使用 `<dg-chat>`，图片模式使用 `DraftGoAI.images`；见 `references/chat-sdk.md` 与 `references/aihub.md` | MCP 实时 API；不创建本地镜像 |
+| 文档中心 | Markdown/HTML 文章 + 分类树 | 正文用 `checkout docs` / `commit docs`；分类用 MCP |
+| 系统配置 | KV 存储，含全局前端层槽位 | MCP 实时 API；不创建本地镜像 |
 
 ## 平台内置模块（开箱即用，不需实现）
 
@@ -56,7 +56,7 @@ read_when: 评估功能可行性时 · 选择开发路径时 · 进入新项目
 ## 自定义服务边界
 
 - 新服务使用 Go `Register(app *sdk.App)` 自动注册路由、事件和定时任务；完整语言、`draftgo` 和 SDK 契约见 `references/custom-services.md`。
-- `route`：对外暴露 HTTP 端点，运行时路径为 `/api/x/{slug}/{path}`；同一 Go 服务可用多个 `app.Route(method, path, handler)` 注册多个端点，推送后要真实请求验证。
+- `route`：对外暴露 HTTP 端点，运行时路径为 `/api/x/{slug}/{path}`；同一 Go 服务可用多个 `app.Route(method, path, handler)` 注册多个端点，保存或发布后要真实请求验证。
 - `event`：响应平台事件，如 `db.created` / `db.updated` / `user.registered`；用 `app.On(event, handler)` 注册，可为同一事件注册多个 handler。
 - `scheduled`：用 `app.Schedule("分 时 日 月 周", handler)` 注册 cron；同一服务可声明多个定时 handler。
 - 新 Go 服务的 `Register` 是唯一触发器事实来源；旧 `triggers` 字段不参与注册。

package/resources/skill/references/parallel.md

@@ -37,12 +37,15 @@ delivery_owner: main
 2. 将 `depends` 已满足且 `resource_lock` 不冲突的工作单元放入同一 wave。
 3. 并行执行当前 wave，汇总后回读所有变更资源。
 4. 处理接口接线和入口绑定，再启动依赖已满足的下一 wave。
-5. 统一运行 `draftgo check`、必要的 API/UI 验证，并按交付意图执行批量推送。
+5. 统一运行 `draftgo check`、必要的 API/UI 验证；只对已 checkout 的 pages/nav/docs 执行 commit，结构化资源通过 MCP 实时 API 交付。
 
 某个工作单元失败时，其依赖项等待处理；其余独立分支继续汇总。发现资源锁冲突时，将冲突单元合并或移到后续 wave。
 
-批量交付示例：
+已 checkout 长正文的批量交付示例：
 
 ```bash
-draftgo auto-push --batch pages 1,2,3 nav 4 custom_scripts 7
+draftgo commit pages 1 2 3
+draftgo commit nav 4
 ```
+
+不同类型分开提交。发生 409/412 时当前 wave 必须停止并保留冲突材料，不得继续自动提交后续依赖项。

package/resources/skill/references/runtime.md

@@ -113,16 +113,13 @@ const orderId = query.orderId;  // "42"
 
 规则：**不能在业务页面内重复实现全局层能力；不允许新增槽位，只能编辑内置槽位。**
 
-### 修改和推送方法
+### 修改方法
 
-本地修改来自 `.draftgo/system_config/index.json`。修改前先执行 `/draftgo pull system_config` 获取最新值，改完后执行：
+system_config 是结构化远端资源。修改前通过 MCP `draftgo_api_search` / `draftgo_api_describe` 获取实时契约，
+再用 `draftgo_api_call` 读取并更新目标键；不要 checkout、pull 或维护本地索引。
 
-```bash
-python {{SKILL_SCRIPTS}}/draftgo_push.py system_config frontend_global_toast_opacity
-```
-
-也可以通过 skill 命令使用 `/draftgo push system_config frontend_global_toast_opacity`。
-
-前端全局层是系统默认配置。通过 API 或脚本更新现有全局配置时，只发送 `config_value`；不要带 `description`、`category`、`value_type`、`status` 等元信息，否则旧基座或旧索引容易触发“系统默认字段不允许修改字段描述/分类/状态”。`draftgo_push.py system_config` 已对 `frontend_global_*` 自动只推值。
+前端全局层是系统默认配置。更新现有全局配置时只发送 `config_value`；不要带 `description`、`category`、
+`value_type`、`status` 等元信息，避免触发“系统默认字段不允许修改字段描述/分类/状态”。
 
-页面管理中 Toast 时长以秒输入，`sys_config` 中仍以毫秒存储。例如 UI 中 `错误 Toast 时长(s) = 4.5`，本地索引应写 `frontend_global_toast_duration_error.config_value = 4500`。
+页面管理中 Toast 时长以秒输入，`sys_config` 中仍以毫秒存储。例如 UI 中
+`错误 Toast 时长(s) = 4.5` 对应 `frontend_global_toast_duration_error.config_value = 4500`。

package/resources/skill/scripts/README.md

@@ -0,0 +1,8 @@
+# Skill scripts
+
+DraftGo execution is provided by the installed `draftgo` CLI. Legacy Python pull, push, init, and delete helpers were
+removed because they depended on full local mirrors and bypassed the MCP plus checkout/commit safety model.
+
+Do not add a script that downloads `.draftgo/*/index.json`, embeds SAT credentials, sends full pages/nav/docs content
+through MCP, or retries version conflicts with force. Reusable helpers added here must preserve the workflows in
+`references/mcp.md` and `references/checkout.md`.

package/resources/skill/story/SKILL.md

@@ -93,9 +93,9 @@ now:
 ### 路径选择（先判断再走）
 
 ```
-扫描 .draftgo/ 下的数据，判断走哪条路径：
+通过 MCP 实时摘要和项目内可保留的决策记录判断走哪条路径：
 
-├─ 存在用户自建内容（非 tag="系统" 的页面、db_meta、custom_scripts）→ 路径 A
+├─ MCP 显示存在用户自建内容（非 tag="系统" 的页面、db_meta、custom_scripts）→ 路径 A
 ├─ 用户提供了设计文档（PRD、原型图描述、需求文档等）→ 路径 A（以文档为分析素材）
 └─ 只有内置系统页面，无用户自建内容，无设计文档 → 路径 B（对话采集）
 ```
@@ -105,11 +105,11 @@ now:
 ```
 输出：[ Story 文件生成中...正在分析项目 ]
 
-1. 扫描项目结构（以及用户提供的设计文档，如有）：
-   - .draftgo/pages/index.json → 现有页面（跳过 tag="系统" 的内置页）
-   - .draftgo/navigations/index.json → 导航结构
-   - .draftgo/db_meta/index.json → 数据模型
-   - .draftgo/custom_scripts/index.json → 自定义脚本
+1. 查询项目结构（以及读取用户提供的设计文档，如有）：
+   - MCP project_overview/resource_list → 资源总览
+   - MCP resource_search/get_metadata → 页面与导航元数据（跳过 tag="系统" 的内置页）
+   - MCP api_search/api_describe/api_call → db_meta 与自定义服务结构
+   - 只有必须分析完整 pages/nav/docs 正文时才 checkout；不要要求 MCP 返回全文
    - .draftgo/changelog.md → 更新日志
    - .draftgo/lessons/ → 开发经验记录
    - .draftgo/Task/ → 历史任务文档
@@ -248,7 +248,7 @@ AI 在开发过程中检测到"方向性决策"时，主动提议沉淀：
 ### 构建 Story
 
 1. 检查 `.draftgo/story.yaml` 是否存在
-2. 不存在 → 判断路径 A 还是 B（看 `.draftgo/pages/index.json` 是否有数据）
+2. 不存在 → 根据 MCP project_overview/resource_list 和用户提供的设计材料判断路径 A 还是 B
 3. 走对应构建流程
 4. 落盘 → 回到用户原始请求
 

package/src/cli.js

@@ -20,6 +20,11 @@ const VALUE_FLAGS = new Set([
   'delivery',
   'assignee',
   'assignee-id',
+  'timeout',
+  'operation-id',
+  'params',
+  'input',
+  'type',
 ]);
 
 function parse(argv) {

package/src/commandRegistry.js

@@ -10,7 +10,13 @@ const commands = [
   { name: 'map', run: (dir, _args, flags) => require('./commands/map')(dir, flags) },
   { name: 'check', run: (dir, _args, flags) => require('./commands/check')(dir, flags) },
   { name: 'verify-ui', aliases: ['verifyui'], run: (dir, args, flags) => require('./commands/verifyUi')(dir, args, flags) },
-  { name: 'api', run: (_dir, args, flags) => require('./commands/api')(args, flags) },
+  { name: 'mcp', run: (dir, args, flags) => require('./commands/mcp')(dir, args, flags) },
+  { name: 'checkout', run: (dir, args, flags) => require('./commands/checkout')(dir, args, flags) },
+  { name: 'commit', run: (dir, args, flags) => require('./commands/commit')(dir, args, flags) },
+  { name: 'diff', run: (dir, args, flags) => require('./commands/diff')(dir, args, flags) },
+  { name: 'conflicts', run: (dir, args, flags) => require('./commands/conflicts')(dir, args, flags) },
+  { name: 'conflict', run: (dir, args, flags) => require('./commands/conflict')(dir, args, flags) },
+  { name: 'api', run: (dir, args, flags) => require('./commands/api')(dir, args, flags) },
   { name: 'delete', aliases: ['del', 'rm'], run: (dir, args, flags) => require('./commands/delete')(dir, args, flags) },
   { name: 'deploy', run: (dir, args, flags) => require('./commands/deploy')(dir, args, flags) },
   { name: 'auto-push', aliases: ['autopush'], run: (dir, args, flags) => require('./commands/autoPush')(dir, args, flags) },