npm - draftgo-cli - Versions diffs - 3.0.1 → 3.0.33 - Mend

draftgo-cli 3.0.1 → 3.0.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (68) hide show

package/LICENSE +21 -0
package/README.md +73 -124
package/package.json +21 -8
package/resources/skill/SKILL.md +62 -89
package/resources/skill/init/SKILL.md +18 -67
package/resources/skill/manifest.json +27 -0
package/resources/skill/pull/SKILL.md +18 -44
package/resources/skill/push/SKILL.md +30 -247
package/resources/skill/references/aihub.md +86 -0
package/resources/skill/references/api-endpoints.md +178 -0
package/resources/skill/references/api.json +20248 -0
package/resources/skill/{quickref → references}/app-api.md +44 -14
package/resources/skill/{core → references}/architecture.md +6 -26
package/resources/skill/references/chat-sdk.md +201 -0
package/resources/skill/references/custom-services.md +308 -0
package/resources/skill/references/data.md +298 -0
package/resources/skill/references/db-relations.md +227 -0
package/resources/skill/references/frontend.md +788 -0
package/resources/skill/references/modules.md +66 -0
package/resources/skill/references/parallel.md +48 -0
package/resources/skill/{specs → references}/runtime.md +31 -1
package/resources/skill/{specs → references}/security.md +3 -3
package/resources/skill/references/ui-protocol.md +99 -0
package/resources/skill/scripts/draftgo_delete.py +0 -2
package/resources/skill/scripts/draftgo_init.py +15 -3
package/resources/skill/scripts/draftgo_pull.py +154 -87
package/resources/skill/scripts/draftgo_push.py +440 -183
package/resources/skill/story/SKILL.md +13 -23
package/src/cli.js +22 -7
package/src/commandRegistry.js +34 -0
package/src/commands/api.js +204 -0
package/src/commands/autoPush.js +41 -0
package/src/commands/check.js +27 -17
package/src/commands/delete.js +6 -4
package/src/commands/deploy.js +31 -0
package/src/commands/help.js +41 -28
package/src/commands/init.js +34 -20
package/src/commands/local.js +9 -3
package/src/commands/map.js +18 -7
package/src/commands/sync.js +11 -4
package/src/commands/update.js +39 -52
package/src/commands/verifyUi.js +199 -0
package/src/index.js +13 -46
package/src/localdev/compose.js +48 -197
package/src/localdev/index.js +116 -216
package/src/localdev/mysqlClient.js +12 -9
package/src/localdev/services.js +163 -0
package/src/platforms.js +3 -3
package/src/projectConfig.js +12 -2
package/src/projectMap.js +240 -68
package/src/skill.js +113 -29
package/src/updateCheck.js +37 -15
package/resources/skill/core/modules.md +0 -54
package/resources/skill/practices/anti-patterns.md +0 -70
package/resources/skill/practices/best-practices.md +0 -41
package/resources/skill/practices/dev-declaration.md +0 -94
package/resources/skill/quickref/api-endpoints.md +0 -130
package/resources/skill/quickref/api.json +0 -17675
package/resources/skill/quickref/dg-components.md +0 -198
package/resources/skill/rules/dev-workflow.md +0 -652
package/resources/skill/rules/frontend.md +0 -210
package/resources/skill/rules/parallel.md +0 -263
package/resources/skill/specs/data.md +0 -108
package/resources/skill/specs/ui-protocol.md +0 -68
package/src/commands/doctor.js +0 -54
package/src/commands/new.js +0 -183
package/src/commands/projectScript.js +0 -37
/package/resources/skill/{rules → references}/debugging-syntax.md +0 -0

package/resources/skill/rules/frontend.md DELETED Viewed

@@ -1,210 +0,0 @@
----
-name: draftgo-frontend-rules
-description: DraftGo frontend page development rules.
-version: 2.0.0
----
-# DraftGo 前端开发规范
-> 本文件只规定前端**操作性规则**，已剥离的内容见：
-> 架构原理 → `{{SKILL_DIR}}/core/architecture.md`
-> App API / Token / 路由 / 运行时 → `{{SKILL_DIR}}/specs/runtime.md` · `{{SKILL_DIR}}/quickref/app-api.md`
-> dg-* 映射 → `{{SKILL_DIR}}/specs/ui-protocol.md` · `{{SKILL_DIR}}/quickref/dg-components.md`
-> 动态 DB / filters → `{{SKILL_DIR}}/specs/data.md`
-> 开发禁区 → `{{SKILL_DIR}}/specs/security.md`
-若本地 Agent 存在前端 UI Skills，前端界面开发时优先调用。
----
-## 页面开发强制规则
-### 真实闭环（强制）
-- 页面必须有可访问 route，从真实入口可达（导航/首页/后台菜单/相关按钮至少一处）
-- 按钮、表单、搜索、筛选、分页、提交、删除等交互默认真实有效
-- 必须有加载态/空态/错误态/成功态，不能只堆静态卡片
-- 展示可维护内容时主动判断是否需要后台管理页 + 同一份真实数据
-- 无法实现真实闭环时停止开发，向用户说明阻塞点，写入 `.draftgo/lessons/`
-### 操作型页面布局（强制）
-后台管理、表格、列表等操作型页面用**工作台布局**，不用文档流堆叠：
-```css
-.workbench-page { min-height:100vh; display:flex; flex-direction:column; overflow:hidden; }
-.workbench-toolbar { flex-shrink:0; }
-.workbench-body { flex:1; min-height:0; display:flex; flex-direction:column; }
-.workbench-data { flex:1; min-height:0; overflow:auto; }
-.workbench-footer { flex-shrink:0; }
-```
-- 分页/操作栏/保存栏固定在工作区底部，不随数据量上浮
-- 滚动发生在数据区，不是整页
-### 新增页面绑定（强制）
-- 公开页 → 顶部/侧边导航、首页入口、相关按钮之一
-- 后台页 → 后台导航、管理菜单或现有后台入口
-- 多页面功能：列表/详情/新建/编辑/管理必须互相走通
-- 导航链接必须用 `data-page-route`：`<a href="/orders" data-page-route="/orders">订单</a>`
-- 用户明确要求"隐藏页/草稿页"才可不绑定，但必须在 changelog / Task 说明原因
-### `page_1_root.html` 首页特例（强制）
-- 仍是默认内置首页 → 按用户需求和本地 UI Skills 重新实现，不沿用内置文案和结构
-- 已被用户改过 → 只做要求范围内的修改，不强制重做
-- 判断依据：看 HTML 内容是否保留 DraftGo 默认文案/系统介绍/未定制品牌，不要只凭文件名判断
----
-## 必须 / 禁止
-### 必须
-- 完整 HTML 文档结构（`<html><head><body>`）
-- 静态资源用本地路径（见下方资源清单）
-- 颜色全用语义 token `var(--dg-*)`
-- 弹窗用 `App.confirm()` / `App.toast()`，禁止 `window.alert/confirm/prompt`
-- 页面初始渲染展示默认状态（骨架屏），不能因请求延迟空白
-- 需要组件能力时用对应 `dg-*` 标签
-### 禁止
-- ❌ 境外 CDN（googleapis / jsdelivr / cdnjs / unpkg）→ ✅ 国内镜像或本地资源
-- ❌ 外部 CDN 引入图标 → ✅ `/assets/icons/{name}.svg`
-- ❌ `window.alert/confirm/prompt`
-- ❌ `App()` 写法 → ✅ `const App = window.parent?.App`
-- ❌ `window.location.search` 读参数 → ✅ `window.__DG_ROUTE_CONTEXT__.query`
-- ❌ 页面内 `window.location.href=...` 跳转 → ✅ `window.parent.location.href=...`
-- ❌ TSX/React 版 shadcn 组件写进数据库 HTML
-- ❌ `dg-*` 当 daisyUI / Bootstrap / Ant Design
-- ❌ 硬编码颜色值 → ✅ `var(--dg-*)`
-- ❌ 在业务页面实现全局浮窗/客服/统计脚本 → ✅ `frontend_global_*` 固定槽位
----
-## 本地静态资源清单
-| 路径 | 说明 |
-|---|---|
-| `/assets/tailwindcss.js` | Tailwind CSS 运行时 |
-| `/assets/fontawesome/css/all.min.css` | FontAwesome 6 |
-| `/assets/icons/{name}.svg` | 内置精选 SVG 图标库（kebab-case 命名） |
-| `/assets/icons/manifest.json` | 图标库映射清单 |
-| `/assets/fonts/inter.css` | Inter 字体 |
-| `/assets/fonts/lexend.css` | Lexend 字体 |
-| `/assets/fonts/plus-jakarta-sans.css` | Plus Jakarta Sans |
-| `/assets/fonts/plus-jakarta-sans-jetbrains-mono.css` | Plus Jakarta Sans + JetBrains Mono |
-| `/assets/vendor/marked/marked.min.js` | Markdown 解析 |
-| `/assets/vendor/prism/prism.min.js` | 代码高亮 |
-| `/assets/vendor/gsap/gsap.min.js` | GSAP 核心 |
-| `/assets/vendor/gsap/ScrollTrigger.min.js` | GSAP ScrollTrigger |
-| `/assets/vendor/gsap/ScrollToPlugin.min.js` | GSAP ScrollTo |
-| `/assets/vendor/gsap/Draggable.min.js` | GSAP Draggable |
-| `/assets/vendor/gsap/Flip.min.js` | GSAP Flip |
-| `/assets/vendor/gsap/SplitText.min.js` | GSAP SplitText |
-| `/assets/vendor/gsap/CustomEase.min.js` | GSAP CustomEase |
-**图标用法**：
-```html
-<!-- 跟随文字颜色（推荐） -->
-<span aria-hidden="true" style="width:16px;height:16px;display:inline-block;background:currentColor;-webkit-mask:url('/assets/icons/fingerprint.svg') center/contain no-repeat;mask:url('/assets/icons/fingerprint.svg') center/contain no-repeat;"></span>
-<!-- 保留原色 -->
-<img src="/assets/icons/fingerprint.svg" alt="" width="16" height="16">
-```
-GSAP：禁止引用任何境外 CDN，必须用本地路径，注册插件后才能使用：`gsap.registerPlugin(ScrollTrigger, CustomEase)`
----
-## 颜色 Token（强制）
-| 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` | 功能色 |
-例外：品牌色、图表色。硬编码时必须同时提供 `[data-theme="dark"]` 覆盖，对比度达 WCAG AA（文字 4.5:1）。
-主题机制：壳层注入时已把 CSS 变量写入 `<head>`，页面无需初始化，直接用 `var(--dg-*)` 即可。
-```javascript
-// 读取（仅需 JS 分支时才读）
-const theme = App?.theme;          // 'light' | 'dark'
-const scheme = App?.colorScheme;   // 'dark-gray-white' | 'deep-blue-white' | ...
-// 切换
-App.applyTheme('dark');
-App.setColorScheme('deep-blue-white');
-```
----
-## 导航栏开发
-| 属性 | 说明 |
-|---|---|
-| `data-nav-position="top\|side"` | 根元素必填 |
-| `data-nav-width="220px"` | 侧边栏展开宽度（可选，默认 260px） |
-| `data-nav-collapsed-width="64px"` | 收起宽度（可选，默认 72px） |
-```html
-<aside data-nav-position="side" data-nav-width="220px">
-  <a href="/dashboard" data-page-route="/dashboard">仪表盘</a>
-</aside>
-```
-所有导航链接必须用 `data-page-route`，不要硬编 `onclick` 跳转。
----
-## AIHub 页面 SDK
-```javascript
-// 聊天
-const text = await DraftGoAI.chat(agentId, '你好', (delta, full) => render(full));
-// 图片生成（必须用 /images 接口，不要用 /chat）
-const result = await DraftGoAI.images(agentId, '生成主图', { size: '1024x1024', n: 1 });
-// 用户选模型
-const { user_selectable, models } = await DraftGoAI.getSelectableModels(agentId);
-await DraftGoAI.chat(agentId, '你好', handler, { model: selectedModel });
-```
----
-## 退出登录
-```javascript
-window.parent.location.href = '/login';  // ✅ 完整刷新，导航栏重新加载
-// App.navigate('/login') ❌ 导航栏不会更新
-```
----
-## 加载体验
-- 初始渲染必须先展示骨架屏，再异步填数据
-- 禁止因请求失败导致整页空白
-- 空态必须有明确文案 + 后续操作入口，不能留空或只有 loading
-- 若父级是 flex 工作区，空态容器应 `flex:1` 承接剩余空间，避免高度塌陷
----
-## 平台能力调用快速参考
-```javascript
-const App = window.parent?.App;
-// 响应信封：{ code: 200, data: <载荷>, message: "success" }
-const res = await App.get('pages', { page: 1, page_size: 20 });
-if (res.code !== 200) { App.showError(res.message); return; }
-const items = res.data.items;
-// URL 参数（三阶回落）
-const q = (window.__DG_ROUTE_CONTEXT__ || window.__DG_GET_ROUTE_CONTEXT__?.() || App?.getCurrentRouteContext?.() || { query: {} }).query;
-```
-完整 API 表 → `{{SKILL_DIR}}/quickref/app-api.md`

package/resources/skill/rules/parallel.md DELETED Viewed

@@ -1,263 +0,0 @@
----
-name: draftgo-parallel-execution
-description: DraftGo 并行开发协议。当 Task 清单中存在无依赖关系的任务组时，主代理可将其分发给子代理并行执行，显著提升开发效率。
-version: 1.0.0
----
-# DraftGo 并行开发协议
-> 本协议是 dev-workflow.md 执行门的扩展。启用条件：计划门产出的 Task 清单中存在 **2 个及以上无依赖任务**。
----
-## 核心模型
-```
-主代理（Orchestrator）
-├── 完成 Story门 → 需求门 → 计划门
-├── 分析任务依赖图
-├── 分发无依赖任务组给子代理
-├── 收集子代理结果
-├── 统一推送（batch push）
-└── 闭环门
-子代理（Worker）
-├── 接收：单个 Task + 上下文包
-├── 执行：读 → 改 → 验（TDR 的 Tiny + Demo）
-├── 产出：修改后的文件 + changelog 条目 + 验证证据
-└── 不推送、不闭环（交回主代理）
-```
----
-## 依赖分析规则
-计划门产出 Task 清单时，为每个任务标注 `depends` 字段：
-```markdown
-- [ ] T1. 用户列表页增加导出按钮  ⬜
-  - depends: []
-  - resource_lock: pages/admin-users.html
-- [ ] T2. 用户详情页增加操作日志  ⬜
-  - depends: []
-  - resource_lock: pages/admin-user-detail.html
-- [ ] T3. 导出 API 脚本编写  ⬜
-  - depends: []
-  - resource_lock: custom_scripts/user-export.py
-- [ ] T4. 导出按钮对接 API  ⬜
-  - depends: [T1, T3]
-  - resource_lock: pages/admin-users.html
-```
-### 依赖判定标准
-| 关系 | 判定为依赖 | 判定为独立 |
-|------|-----------|-----------|
-| 同一文件 | T4 改 admin-users.html，T1 也改 → T4 depends T1 | - |
-| 数据依赖 | T4 需要 T3 产出的 API slug → T4 depends T3 | - |
-| 不同文件 | T1 改页面 A，T2 改页面 B | 无依赖，可并行 |
-| 不同类型 | T1 改 page，T3 写 script | 无依赖，可并行 |
-| 导航引用页面 | 导航加链接 → 目标页面必须先存在 | 页面和不相关导航 |
-### resource_lock 规则
-- 每个任务声明它要修改的文件路径（`resource_lock`）
-- **同一 resource_lock 的任务不可并行**，必须串行或合并
-- 一个任务可以锁多个资源：`resource_lock: [pages/a.html, pages/b.html]`
----
-## 并行分发协议
-### 主代理职责
-1. **计划门结束后**，按依赖图将任务分为并行批次（waves）：
-   ```
-   Wave 1: [T1, T2, T3]  — 全部 depends: []，可并行
-   Wave 2: [T4]           — depends T1+T3，等 Wave 1 结束
-   ```
-2. **为每个子代理打包上下文**（Context Pack）：
-   ```
-   - task_id: T1
-   - task_description: <从 Task 文档摘取该任务的完整定义>
-   - resource_files: <该任务涉及的当前文件内容>
-   - story_context: <story.yaml 的关键约束摘要>
-   - dev_rules: <frontend.md / debugging-syntax.md 的关键禁区摘要>
-   - project_config: <.draftgo/config.json 的 server 地址（不含 token）>
-   ```
-3. **分发时的指令模板**：
-   ```
-   你是 DraftGo 子代理，负责执行单个开发任务。
-   ## 你的任务
-   {task_description}
-   ## 当前文件内容
-   {resource_files}
-   ## 强制规则
-   - 只修改 resource_lock 声明的文件，禁止动其他文件
-   - 遵守 DraftGo 前端禁区（见下方摘要）
-   - 修改完成后输出：
-     1. 修改后的完整文件内容
-     2. changelog 条目（格式：- [HH:MM] [操作类型] 描述）
-     3. 验证证据（你做了什么验证、结果如何）
-   - 不要推送、不要更新 Task 文档、不要写 lessons
-   ## 禁区摘要
-   {dev_rules_summary}
-   ```
-4. **收集结果后**：
-   - 将子代理产出的文件内容写入对应路径
-   - 汇总所有 changelog 条目，按时间排序写入 changelog.md
-   - 批量推送：`python draftgo_push.py --batch pages 1,2,3 nav 4`
-   - 统一更新 Task 文档标记
-   - 进入闭环门
-### 子代理职责
-1. 接收上下文包，理解任务边界
-2. 执行 TDR 循环的 Tiny + Demo：
-   - 读取当前文件
-   - 做最小改动
-   - 在能力范围内验证（语法检查、逻辑自审）
-3. **产出三件套**：修改后文件 + changelog 条目 + 验证报告
-4. **不做**：推送、Task 标记、lessons 记录、闭环声明
-### 子代理边界红线
-```
-禁止：
-- 修改 resource_lock 之外的任何文件
-- 调用推送 API 或推送脚本
-- 修改 .draftgo/Task/ 文档
-- 安装新依赖或引入新库
-- 修改 .draftgo/config.json
-- 做出超出 task_description 范围的"顺手"改动
-允许：
-- 读取其他文件以理解上下文（只读）
-- 在验证阶段用 console.log 调试
-- 发现阻塞时报告给主代理（而非自行绕过）
-```
----
-## 平台适配
-不同 AI 平台实现并行的方式不同，主代理根据当前平台选择策略：
-| 平台 | 并行实现方式 | 子代理能力 |
-|------|-------------|-----------|
-| Claude Code | `Agent` tool（subagent） | 完整文件读写 + Bash |
-| Cursor | Background Agent / Composer | 文件读写 |
-| Codex CLI | 多 sandbox 实例 | 完整隔离环境 |
-| Windsurf | Cascade 多步 | 有限并行 |
-| Kiro | Agent tool | 完整文件读写 |
-| 其他 | 退化为串行 | - |
-### 退化策略
-当平台不支持子代理或任务数 ≤ 2 时，**静默退化为串行执行**，不需要告知用户。并行协议的 Task 依赖标注仍保留（对执行顺序有指导意义）。
----
-## 批量推送
-并行执行完毕后，主代理使用批量推送减少网络开销：
-```bash
-python {{SKILL_SCRIPTS}}/draftgo_push.py --batch pages 1,2,3 nav 4 custom_scripts 7
-```
-等价于依次推送 pages 1、2、3 + nav 4 + custom_scripts 7，但一次加载 config、一次建立连接。
----
-## 错误处理
-### 子代理失败
-- 子代理报告阻塞 → 主代理判断：能否由自己接手修复？
-  - 能：主代理接手该 Task，其余子代理结果不受影响
-  - 不能：暂停该 Task（⏸），其余继续
-- 子代理产出与禁区冲突 → 主代理拒收，自行修复或重新分发
-### Wave 间传递
-- Wave 1 中某个 Task 失败 → Wave 2 中依赖该 Task 的任务自动暂停
-- Wave 1 中其他 Task 成功 → Wave 2 中不依赖失败任务的照常执行
-### 资源冲突检测
-主代理收集子代理结果时，如果发现两个子代理意外修改了同一文件（违规）：
-1. 比对两份输出，取变更不重叠的部分合并
-2. 如果重叠 → 丢弃后执行的那份，由主代理手动合并
-3. 记入 lessons：子代理 resource_lock 定义不够精确
----
-## Task 文档并行标注格式
-启用并行后，Task 文档的任务清单增加 `depends` 和 `resource_lock` 字段，进度总览增加 `wave` 列：
-```markdown
-## 任务清单
-- [ ] T1. 用户列表页增加导出按钮  ⬜
-  - depends: []
-  - resource_lock: pages/admin-users.html
-  - wave: 1
-- [ ] T2. 用户详情页增加操作日志  ⬜
-  - depends: []
-  - resource_lock: pages/admin-user-detail.html
-  - wave: 1
-- [ ] T3. 导出 API 脚本编写  ⬜
-  - depends: []
-  - resource_lock: custom_scripts/user-export.py
-  - wave: 1
-- [ ] T4. 导出按钮对接 API  ⬜
-  - depends: [T1, T3]
-  - resource_lock: pages/admin-users.html
-  - wave: 2
-## 进度总览
-| 任务 | Wave | 状态 | 执行方式 | 完成时间 | 证据摘要 |
-|-----|------|------|---------|---------|---------|
-| T1  | 1    | ⬜   | 子代理   |         |         |
-| T2  | 1    | ⬜   | 子代理   |         |         |
-| T3  | 1    | ⬜   | 子代理   |         |         |
-| T4  | 2    | ⬜   | 主代理   |         |         |
-```
----
-## 启用条件与判断
-主代理在计划门结束时自动判断：
-```
-IF 无依赖任务数 >= 2
-   AND 平台支持子代理
-   AND 任务间无 resource_lock 冲突
-THEN 启用并行分发
-ELSE 串行执行（静默，不告知用户）
-```
-不需要用户显式启用。用户也可以在需求门显式说"串行做"来关闭并行。
----
-## 一句话总结
-> **主代理管脑子（计划 + 闭环），子代理管手脚（单 Task 执行），resource_lock 防冲突，batch push 收全场。**

package/resources/skill/specs/data.md DELETED Viewed

@@ -1,108 +0,0 @@
----
-read_when: 操作动态 DB 之前 · 设计数据结构时 · 使用 filters 检索时
----
-# 动态 DB & 数据层
-## 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" },
-      "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"`（数组包含）
----
-## 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;
-// 创建（业务字段必须放在 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 |
-| `contains` | 数组字段包含某值 | contains |
-- 省略操作符（`filters: ['name:张三']`）默认 `like`
-- 多个 filters 为 AND
-- 字段未标 searchable 或操作符不匹配 → 后端返回 400
----
-## db_meta 本地文件
-开发前先读 `.draftgo/db_meta/index.json` 了解可用 type 和字段：
-```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` | 分页（不传返回全量，超 10000 条后端拒绝） |
-| `search` | 全文搜索（动态 DB 不用此参数） |
-| `status` | 状态过滤 |
-| `type` / `tag` | 类型/标签过滤 |

package/resources/skill/specs/ui-protocol.md DELETED Viewed

@@ -1,68 +0,0 @@
----
-read_when: 开发数据库页面时需要 dg-* 组件 · 了解 shadcn 映射关系时
----
-# dg-* 完整映射表
-## 核心认知
-```
-dg-* ≠ 自研组件库
-dg-* = shadcn/ui 在数据库 HTML 页面里的协议化表达
-```
-数据库页面不进入 Vite/React 编译链，不能写 TSX；改用 `dg-*` 标签，runtime 解析并渲染对应 shadcn 语义。
----
-## shadcn → dg-* 完整映射
-| shadcn 组件 | dg-* 标签 | 说明 |
-|---|---|---|
-| Button | `dg-button` | variant/size/disabled 属性对齐 |
-| Card | `dg-card` + `dg-card-header/title/description/content/footer` | |
-| Badge | `dg-badge` | variant: default/secondary/destructive/outline |
-| Skeleton | `dg-skeleton` | 骨架屏 |
-| Input | `dg-input` | type/placeholder/value/disabled |
-| Textarea | `dg-textarea` | |
-| Select | `dg-select` + `dg-select-item` | |
-| Checkbox | `dg-checkbox` | |
-| Switch | `dg-switch` | |
-| RadioGroup | `dg-radio-group` + `dg-radio-item` | |
-| Form | `dg-form` + `dg-form-item` + `dg-form-message` | |
-| Table | `dg-table` | source 属性拉取数据，columns via data-dg-props |
-| Tabs | `dg-tabs` + `dg-tabs-list/trigger/content` | default-value 属性 |
-| Dialog | `dg-dialog` + `dg-dialog-trigger/content/header/title/footer` | |
-| Sheet | `dg-sheet` + `dg-sheet-trigger/content/header/title` | side: right/left/top/bottom |
-| DropdownMenu | `dg-dropdown-menu` + `dg-dropdown-menu-trigger/content/item/separator` | |
-| Tooltip | `dg-tooltip` | content 属性 |
-| Popover | `dg-popover` + `dg-popover-trigger/content` | |
-| Alert | `dg-alert` + `dg-alert-title/description` | variant: default/destructive |
-| Progress | `dg-progress` | value/max 属性 |
-| Separator | `dg-separator` | orientation: horizontal/vertical |
-| ScrollArea | `dg-scroll-area` | |
-| Avatar | `dg-avatar` + `dg-avatar-image/fallback` | |
----
-## 属性约定
-`dg-*` 属性命名跟随 shadcn 语义：
-- `variant`、`size`、`disabled`、`default-value`、`data-state`、`aria-*` 保持原意
-- 复杂组件使用 `data-dg-props='{"key":"value"}'` 传递结构化配置
----
-## 禁止混淆
-- ❌ `dg-*` 不是 daisyUI
-- ❌ `dg-*` 不是 Bootstrap
-- ❌ `dg-*` 不是 Ant Design / Element Plus
-- ❌ `dg-*` 不是任意相似样式的泛称
-- ✅ `dg-*` 只能是 shadcn 的 DraftGo HTML 协议形态
----
-## 使用示例速查
-完整带代码的示例见 `{{SKILL_DIR}}/quickref/dg-components.md`