draftgo-cli 3.0.1 → 3.0.29

package/src/updateCheck.js

@@ -1,15 +1,43 @@
 'use strict';
 
 // Fetch the latest draftgo-cli version from the npm registry.
-// No cache — every call hits the network. Returns null on any failure so
-// callers can gracefully fall back.
+// Results are cached for 24 hours so doctor/update stay fast and deterministic.
 
 const https = require('https');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
 const { getPackageVersion } = require('./skill');
 
 const REGISTRY_URL = 'https://registry.npmjs.org/draftgo-cli/latest';
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const CACHE_FILE = path.join(os.homedir(), '.draftgo-cli', 'update-check.json');
 
-function fetchLatestVersion(timeoutMs = 3000) {
+function readCache() {
+  try {
+    const cached = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'));
+    if (!cached.version || !cached.checkedAt) return null;
+    if (Date.now() - Number(cached.checkedAt) > CACHE_TTL_MS) return null;
+    return String(cached.version);
+  } catch {
+    return null;
+  }
+}
+
+function writeCache(version) {
+  try {
+    fs.mkdirSync(path.dirname(CACHE_FILE), { recursive: true });
+    fs.writeFileSync(CACHE_FILE, JSON.stringify({ version, checkedAt: Date.now() }) + '\n', 'utf8');
+  } catch {
+    // Cache failures must never block CLI work.
+  }
+}
+
+function fetchLatestVersion(timeoutMs = 3000, opts = {}) {
+  if (!opts.force) {
+    const cached = readCache();
+    if (cached) return Promise.resolve(cached);
+  }
   return new Promise((resolve) => {
     let req;
     try {
@@ -22,7 +50,11 @@ function fetchLatestVersion(timeoutMs = 3000) {
           res.setEncoding('utf8');
           res.on('data', (c) => { body += c; });
           res.on('end', () => {
-            try { resolve(JSON.parse(body).version || null); }
+              try {
+                const version = JSON.parse(body).version || null;
+                if (version) writeCache(version);
+                resolve(version);
+              }
             catch { resolve(null); }
           });
         }
@@ -55,4 +87,4 @@ async function getFreshness() {
   return { current, latest, outdated: cmpSemver(latest, current) > 0 };
 }
 
-module.exports = { fetchLatestVersion, cmpSemver, getFreshness };
+module.exports = { fetchLatestVersion, cmpSemver, getFreshness, readCache, CACHE_TTL_MS };

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

@@ -1,198 +0,0 @@
----
-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" />
-```