draftgo-cli 2.0.9 → 3.0.0

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

@@ -0,0 +1,110 @@
+---
+read_when: 页面开发时需要查 App API · 忘记某个方法签名时
+---
+
+# App 对象速查表
+
+```javascript
+const App = window.parent?.App;
+```
+
+## 请求
+
+| 方法 | 签名 | 说明 |
+|---|---|---|
+| `App.get` | `(path, params?)` | GET，params 为 query 参数 |
+| `App.post` | `(path, body?)` | POST |
+| `App.put` | `(path, body?)` | PUT |
+| `App.patch` | `(path, body?)` | PATCH |
+| `App.delete` | `(path)` | DELETE |
+| `App.uploadFile` | `(file, onProgress?)` | 文件上传，返回标准信封 |
+
+**响应格式**：`{ code: 200, data: <载荷>, message: "success" }`  
+**消费范式**：
+```javascript
+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;  // 分页列表
+```
+
+## 反馈
+
+| 方法 | 签名 | 说明 |
+|---|---|---|
+| `App.showSuccess` | `(msg)` | 成功 Toast 3s |
+| `App.showError` | `(msg)` | 错误 Toast 4s |
+| `App.showWarning` | `(msg)` | 警告 Toast 3s |
+| `App.showInfo` | `(msg)` | 信息 Toast 3s |
+| `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.isAuthenticated` | boolean | 是否已认证 |
+| `App.hasToken` | boolean | 是否有 token（含未验证） |
+| `App.config` | object | 系统配置 KV |
+| `App.theme` | `'light'` \| `'dark'` | 当前显示模式 |
+| `App.colorScheme` | string | 当前配色方案 |
+
+## 主题
+
+```javascript
+App.applyTheme('dark');                           // 切换显示模式
+App.setColorScheme('deep-blue-white');            // 切换预设配色
+App.setColorScheme('custom', customVarsObject);   // 自定义配色
+App.getColorScheme();                             // 获取方案详情
+```
+
+## 外部 API
+
+```javascript
+App.listApis();                     // 列出可调用 API（含 code/name/schema）
+App.callApi('weather-now', {
+  path_params: { city: 'beijing' },
+  query_params: { unit: 'metric' },
+  // body: {...}                     // POST/PUT/PATCH 才生效
+});
+// 返回：{ status_code, headers, body, duration_ms, error }
+```
+
+## 其他
+
+```javascript
+App.logout();                       // 登出并跳转登录页
+App.setAuthTokens({ access_token, refresh_token });  // 登录后写入 token
+App.reloadGlobalLayer();            // 重载全局层
+App.openGlobalWidget(name);         // 触发全局挂件打开
+App.t(key, fallback?);              // 国际化文本
+```
+
+## Token 存储
+
+| key | 说明 |
+|---|---|
+| `localStorage.dg_access_token` | 访问 token |
+| `localStorage.dg_refresh_token` | 刷新 token |

package/resources/skill/quickref/dg-components.md

@@ -0,0 +1,198 @@
+---
+read_when: 页面开发时需要使用 dg-* 组件时 · 确认某组件属性/用法时
+---
+
+# dg-* 组件速查卡
+
+> `dg-*` = shadcn/ui 的 DraftGo HTML 协议表达。完整映射说明见 `{{SKILL_DIR}}/specs/ui-protocol.md`
+
+## 基础组件
+
+### dg-button
+```html
+<dg-button variant="default|destructive|outline|secondary|ghost|link"
+           size="default|sm|lg|icon"
+           disabled>
+  按钮文字
+</dg-button>
+```
+
+### dg-card
+```html
+<dg-card>
+  <dg-card-header>
+    <dg-card-title>标题</dg-card-title>
+    <dg-card-description>描述</dg-card-description>
+  </dg-card-header>
+  <dg-card-content>内容</dg-card-content>
+  <dg-card-footer>底部</dg-card-footer>
+</dg-card>
+```
+
+### dg-badge
+```html
+<dg-badge variant="default|secondary|destructive|outline">标签</dg-badge>
+```
+
+### dg-skeleton
+```html
+<dg-skeleton style="width:200px;height:20px;"></dg-skeleton>
+```
+
+---
+
+## 表单组件
+
+### dg-form
+```html
+<dg-form>
+  <dg-form-item label="字段名" required>
+    <dg-input name="field" placeholder="请输入" />
+    <dg-form-message></dg-form-message>
+  </dg-form-item>
+  <dg-button type="submit">提交</dg-button>
+</dg-form>
+```
+
+### dg-input / dg-textarea / dg-select
+```html
+<dg-input type="text|password|email|number" placeholder="" value="" disabled />
+<dg-textarea placeholder="" rows="4" />
+<dg-select value="" placeholder="请选择">
+  <dg-select-item value="a">选项 A</dg-select-item>
+  <dg-select-item value="b">选项 B</dg-select-item>
+</dg-select>
+```
+
+### dg-checkbox / dg-switch / dg-radio-group
+```html
+<dg-checkbox checked>同意条款</dg-checkbox>
+<dg-switch checked />
+<dg-radio-group value="a">
+  <dg-radio-item value="a">选项 A</dg-radio-item>
+  <dg-radio-item value="b">选项 B</dg-radio-item>
+</dg-radio-group>
+```
+
+---
+
+## 数据展示
+
+### dg-table
+```html
+<dg-table source="db/order" data-dg-props='{"columns":[{"key":"name","title":"名称"},{"key":"status","title":"状态"}]}'></dg-table>
+```
+
+### dg-tabs
+```html
+<dg-tabs default-value="tab1">
+  <dg-tabs-list>
+    <dg-tabs-trigger value="tab1">标签一</dg-tabs-trigger>
+    <dg-tabs-trigger value="tab2">标签二</dg-tabs-trigger>
+  </dg-tabs-list>
+  <dg-tabs-content value="tab1">内容一</dg-tabs-content>
+  <dg-tabs-content value="tab2">内容二</dg-tabs-content>
+</dg-tabs>
+```
+
+---
+
+## 覆盖层组件（trigger/content 协议）
+
+### dg-dialog
+```html
+<dg-dialog>
+  <dg-dialog-trigger>
+    <dg-button>打开弹窗</dg-button>
+  </dg-dialog-trigger>
+  <dg-dialog-content>
+    <dg-dialog-header>
+      <dg-dialog-title>标题</dg-dialog-title>
+    </dg-dialog-header>
+    <p>内容</p>
+    <dg-dialog-footer>
+      <dg-button variant="outline" data-close-dialog>取消</dg-button>
+      <dg-button>确认</dg-button>
+    </dg-dialog-footer>
+  </dg-dialog-content>
+</dg-dialog>
+```
+
+### dg-sheet
+```html
+<dg-sheet side="right|left|top|bottom">
+  <dg-sheet-trigger><dg-button>打开</dg-button></dg-sheet-trigger>
+  <dg-sheet-content>
+    <dg-sheet-header><dg-sheet-title>标题</dg-sheet-title></dg-sheet-header>
+    <p>内容</p>
+  </dg-sheet-content>
+</dg-sheet>
+```
+
+### dg-dropdown-menu
+```html
+<dg-dropdown-menu>
+  <dg-dropdown-menu-trigger><dg-button variant="ghost">操作</dg-button></dg-dropdown-menu-trigger>
+  <dg-dropdown-menu-content>
+    <dg-dropdown-menu-item>编辑</dg-dropdown-menu-item>
+    <dg-dropdown-menu-separator />
+    <dg-dropdown-menu-item variant="destructive">删除</dg-dropdown-menu-item>
+  </dg-dropdown-menu-content>
+</dg-dropdown-menu>
+```
+
+### dg-tooltip
+```html
+<dg-tooltip content="提示文字">
+  <dg-button variant="ghost" size="icon">?</dg-button>
+</dg-tooltip>
+```
+
+### dg-popover
+```html
+<dg-popover>
+  <dg-popover-trigger><dg-button>打开</dg-button></dg-popover-trigger>
+  <dg-popover-content>内容</dg-popover-content>
+</dg-popover>
+```
+
+---
+
+## 布局组件
+
+### dg-separator
+```html
+<dg-separator orientation="horizontal|vertical" />
+```
+
+### dg-scroll-area
+```html
+<dg-scroll-area style="height:400px;">
+  长内容...
+</dg-scroll-area>
+```
+
+### dg-avatar
+```html
+<dg-avatar>
+  <dg-avatar-image src="/path/to/img.jpg" alt="用户名" />
+  <dg-avatar-fallback>UN</dg-avatar-fallback>
+</dg-avatar>
+```
+
+---
+
+## 状态 / 反馈
+
+### dg-alert
+```html
+<dg-alert variant="default|destructive">
+  <dg-alert-title>标题</dg-alert-title>
+  <dg-alert-description>描述</dg-alert-description>
+</dg-alert>
+```
+
+### dg-progress
+```html
+<dg-progress value="60" max="100" />
+```