draftgo-cli 3.0.1 → 3.0.33

package/src/updateCheck.js

@@ -1,15 +1,42 @@
 '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 update stays fast and deterministic.
 
 const https = require('https');
-const { getPackageVersion } = require('./skill');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
 
 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 +49,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); }
           });
         }
@@ -46,13 +77,4 @@ function cmpSemver(a, b) {
   return 0;
 }
 
-// Report-only helper used by doctor. Never throws.
-async function getFreshness() {
-  if (process.env.DRAFTGO_NO_UPDATE_CHECK === '1') return null;
-  const current = getPackageVersion();
-  const latest = await fetchLatestVersion();
-  if (!latest) return null;
-  return { current, latest, outdated: cmpSemver(latest, current) > 0 };
-}
-
-module.exports = { fetchLatestVersion, cmpSemver, getFreshness };
+module.exports = { fetchLatestVersion, cmpSemver, readCache, CACHE_TTL_MS };

package/resources/skill/core/modules.md

@@ -1,54 +0,0 @@
----
-read_when: 评估功能可行性时 · 选择开发路径时 · 进入新项目做全局了解时
----
-
-# DraftGo 模块地图
-
-## 可开发模块（开发者负责实现）
-
-| 模块 | 开发方式 | 入口 |
-|---|---|---|
-| 页面 | 数据库 HTML（`page.value.html`） | `.draftgo/pages/` |
-| 导航栏 | 数据库 HTML（`navigation.html`） | `.draftgo/navigations/` |
-| 动态 DB | db_meta 定义 schema + `/api/db/{type}` 操作数据 | `.draftgo/db_meta/` |
-| 自定义服务 | Python/JS/TS/Shell/Go 脚本，支持 route/event/scheduled 三种模式 | `.draftgo/custom_scripts/` |
-| 外部 API | 管理端注册 + 页面调用 `App.callApi(code, ...)` | `.draftgo/external_apis/` |
-| AIHub | 配置 AI Agent，页面调用 `DraftGoAI.chat/images` | `.draftgo/aihub/` |
-| 文档中心 | Markdown 文章 + 分类树 | `.draftgo/docs/articles/` |
-| 系统配置 | KV 存储，含全局前端层槽位 | `.draftgo/system_config/` |
-
-## 平台内置模块（开箱即用，不需实现）
-
-| 模块 | 能力 | 调用方式 |
-|---|---|---|
-| 认证 | 注册/登录/刷新/找回密码/微信登录/手机邮箱验证 | `POST /api/auth/*` |
-| 角色权限 | 多角色 RBAC，页面/DB/API 均支持角色级权限 | `App.isAdmin` / `App.currentUser.role_code` |
-| 通知公告 | 发布公告，支持类型/状态/分页 | `GET/POST /api/notices` |
-| 工单反馈 | 用户提交问题，支持类型/状态跟踪 | `GET/POST /api/feedback` |
-| 备份恢复 | 完整/选择性备份，JSON/.dgbak 格式，支持 dry-run | `POST /api/system/backup` |
-| 系统管理 | 系统配置 KV、存储健康、全局前端层、通知测试 | `GET/PUT /api/system/*` |
-
-## 模块选型决策
-
-```
-要存储业务数据？
-  → 有固定结构 → 动态 DB（db_meta 定义 schema）
-  → 仅需 KV → sys_config（category 自定义）
-
-要调用 AI？
-  → 聊天/问答 → AIHub + DraftGoAI.chat()
-  → 图片生成 → AIHub + DraftGoAI.images()
-
-要调用第三方服务？
-  → 纯 HTTP 调用 → 外部 API（管理端注册，App.callApi 调用）
-  → 需要服务端逻辑（定时/事件/加工） → 自定义服务
-
-要展示内容文档？
-  → 文档中心（Markdown + 分类树）
-
-要做定时任务或事件响应？
-  → 自定义服务（mode: scheduled / event）
-
-要做后台管理页？
-  → 业务页面 + 动态 DB + 角色权限
-```

package/resources/skill/practices/anti-patterns.md

@@ -1,70 +0,0 @@
----
-read_when: 开发前检查思路 · Code Review 时
----
-
-# 反模式清单
-
-## 功能完成度反模式
-
-| 反模式 | 问题 | 正确做法 |
-|---|---|---|
-| 静态卡片充当功能 | 按钮点击无效，数据硬编码 | 默认按真实落地闭环实现；用户说"先看效果"才允许 mock |
-| 只建页面不绑入口 | 页面存在但无法访问 | 创建页面后必须绑定至少一个入口 |
-| 只做前台不做后台 | 展示数据没有维护入口 | 展示可维护内容时主动判断是否需要管理侧页面 |
-| 伪功能写入 lessons 前不说明 | 用户不知道功能不完整 | 无法实现真实闭环时停止开发，向用户说明阻塞点 |
-
----
-
-## 架构理解反模式
-
-| 反模式 | 问题 |
-|---|---|
-| 在数据库页面写 TSX / React 组件 | 数据库页面不进入 Vite 编译链 |
-| 把 `dg-*` 当 daisyUI / Bootstrap | `dg-*` 是 shadcn 协议，不是别的库 |
-| 在业务页面渲染系统 Header / 导航 | Header 属于壳层，页面渲染会重复 |
-| 修改壳层 `.tsx` 文件来改页面内容 | 页面内容在数据库里，改壳层源码不对 |
-
----
-
-## API 调用反模式
-
-| 反模式 | 问题 | 正确做法 |
-|---|---|---|
-| 不检查 `res.code` 直接用 `res.data` | 报错时会访问 null | 先 `if (res.code !== 200)` 处理错误 |
-| GET 列表不传分页参数 | 数据超 10000 条后端返回 400 | 始终传 `page` + `page_size` |
-| `GET /db-meta/{id}` 用 id 查 type | 返回"元数据不存在" | 用 type 查：`GET /db-meta/{type}` |
-| 动态 DB POST 时字段平铺到 body 顶层 | 字段被忽略 | 业务字段必须放在 `data: {}` 里 |
-| 在页面里写死 API Key / Bearer | 密钥暴露在前端 | 管理端注册外部 API，用 `App.callApi` 调用 |
-
----
-
-## 路由 & DOM 反模式
-
-| 反模式 | 问题 | 正确做法 |
-|---|---|---|
-| `window.location.search` 读参数 | iframe 里取不到壳层 URL | `window.__DG_ROUTE_CONTEXT__.query` |
-| `window.location.href = '/path'` 跳转 | 只跳 iframe 自身，壳层不感知 | `window.parent.location.href = '/path'` |
-| `window.alert/confirm/prompt` | 阻塞主线程，iframe 行为不可预期 | `App.showModal` / `App.confirm` |
-
----
-
-## 开发流程反模式
-
-| 反模式 | 问题 |
-|---|---|
-| 高风险任务没有 Story 就动手 | 方向错了才发现，返工代价大 |
-| 小修也走完整 Story 门 | 拖慢速度，过度流程化 |
-| 发现与 Story 冲突时静默执行 | 覆盖已确认的需求 |
-| 页面改了但没更新导航入口 | 用户找不到新功能 |
-| 每次开发都从头读全部规则 | 按任务规模渐进读取，小修只读最小必要规则 |
-
----
-
-## 性能 & 体验反模式
-
-| 反模式 | 问题 |
-|---|---|
-| 请求完成前页面空白 | 先渲染骨架屏，再异步填数据 |
-| 操作型页面用文档流堆叠 | 分页/操作栏随少量数据上浮 | 
-| 硬编码颜色 | 亮暗切换后颜色异常 |
-| 引入境外 CDN | 国内访问慢/超时 |

package/resources/skill/practices/best-practices.md

@@ -1,41 +0,0 @@
----
-read_when: 开发过程中做决策时 · Code Review 时
----
-
-# 最佳实践
-
-## 服务设计
-
-- **优先用平台能力**：动态 DB → 自定义服务 → 外部 API，按复杂度递进，不要绕过平台直接硬编码
-- **db_meta 先于代码**：操作动态 DB 前先读 `.draftgo/db_meta/index.json`，不要硬编码 type 值
-- **权限跟数据一起设计**：创建 db_meta 时同时设计 `permission` 字段，不要事后补
-- **schema_validation 开启**：动态 DB 数据写入时建议开启 `schema_validation: 1`，及早发现数据问题
-
-## 页面开发
-
-- **先分配空间，再放组件**：操作型页面用工作台布局（flex column + 主体 flex:1 min-height:0），不用文档流堆叠
-- **四态必须都有**：加载态（dg-skeleton）/ 空态（明确文案 + 操作入口）/ 错误态（Toast + 重试）/ 成功态
-- **初始渲染不能空白**：先展示骨架屏，再异步填数据；不能因为网络延迟导致整页白屏
-- **新页面必须绑定入口**：导航栏 / 首页模块 / 后台菜单 / 相关页面按钮至少一个；只建文件不绑入口不算完成
-
-## API 调用
-
-- **统一信封消费**：始终检查 `res.code !== 200`，再从 `res.data` 取载荷；不要假设 200
-- **分页参数显式传**：列表请求必须传 `page` + `page_size`，超 10000 条后端拒绝
-- **外部 API 用 App.callApi**：不要在页面里写 API Key / Bearer，认证由管理端注册、后端注入
-
-## 资源路径
-
-- **静态资源用本地路径**：`/assets/tailwindcss.js`、`/assets/fontawesome/css/all.min.css`、`/assets/icons/{name}.svg`
-- **图标用内置库**：先查 `/assets/icons/manifest.json`，已有的直接用，不要引外部图标
-
-## 主题适配
-
-- **颜色全用语义 token**：`var(--dg-accent)`、`var(--dg-bg-surface)` 等，避免亮暗切换时颜色失效
-- **品牌色 / 图表色例外**：需要同时提供 `[data-theme="dark"]` 选择器覆盖，且确保对比度达 WCAG AA
-
-## 推送收尾
-
-- **修改页面同时推导航**：如果页面新增了导航入口，导航 HTML 也要一起 push
-- **changelog 按影响写**：影响可见功能、跨资源、已发布时写 `.draftgo/changelog.md`，纯小修可跳过
-- **用 draftgo check 验收**：涉及路由、入口绑定的改动，用 `draftgo check` 确认没有悬空入口

package/resources/skill/practices/dev-declaration.md

@@ -1,94 +0,0 @@
----
-read_when: 开始任何标准功能/高风险开发任务之前 · 用户意图模糊需要澄清时
----
-
-# 开发声明协议
-
-开发声明是在正式动代码前，AI 向用户同步「我理解的任务边界」，确保方向对齐、避免返工。
-
----
-
-## 触发条件
-
-满足以下任一条件时，输出开发声明：
-
-- 标准功能或高风险任务（按 `dev-workflow.md` 分级）
-- 涉及 2 个以上资源（页面 + 导航、多页面联动、DB + 页面等）
-- 用户描述包含模糊词（「做一个...」「帮我整一个...」「类似...的功能」）
-- 实现路径有分叉点（多种技术方案可选）
-- 用户意图与现有 Story 存在潜在冲突
-
-**不触发**：小修、单文件纯改、用户已提供完整规格的任务。
-
----
-
-## 信息充分性判断
-
-输出声明前，检查是否掌握以下信息：
-
-| 必须已知 | 可推断 | 需要追问 |
-|---|---|---|
-| 功能目标（做什么） | 技术实现路径 | 数据来源（DB类型/字段） |
-| 目标页面/路由 | 权限配置 | 是否需要管理侧页面 |
-| 核心交互流程 | UI 风格偏好 | 与已有功能的关系 |
-
-信息充分 → 直接输出声明  
-关键信息缺失 → 先追问（最多 3 个问题），再输出声明
-
----
-
-## 追问格式（适配选择式交互）
-
-追问必须带 AI 的推测和选项，不能空问：
-
-```
-我准备这样理解这个任务，请确认或调整：
-
-1. **数据来源**（我的推测：用动态 DB 新建 `order` 类型）
-   A. 用动态 DB 新建（推荐）
-   B. 复用已有 DB 类型：___
-   C. 用系统配置 KV 存储
-
-2. **管理侧**（我的推测：需要一个后台管理页）
-   A. 需要，用户提交 + 管理员审核
-   B. 不需要，纯用户自助
-   C. 后续再做
-
-3. **入口位置**（我的推测：加到顶部导航）
-   A. 顶部导航
-   B. 首页模块入口
-   C. 仅通过链接/按钮访问，不加导航
-```
-
----
-
-## 开发声明输出格式
-
-```markdown
-## 开发声明
-
-**任务**：[一句话描述目标]
-
-**我将要做的事**：
-- [ ] [资源 1]：[具体内容]
-- [ ] [资源 2]：[具体内容]
-- [ ] [入口绑定]：[绑定位置]
-
-**数据方案**：[DB类型 / 字段设计 / 权限配置]
-
-**不做的事**：[明确排除的内容，避免范围蔓延]
-
-**风险点**：[如有，说明；无则省略]
-
-确认后开始。
-```
-
----
-
-## 关键原则
-
-1. **声明是同步，不是审批**——输出后等用户一句确认（「可以」「没问题」「开始」均算确认），不必等用户逐条review。
-2. **推测要带自信**——「我推测」不是「我不确定」，是「我基于上下文的最优判断」；若用户不纠正则视为接受。
-3. **一次声明，不反复确认**——声明输出后开始执行，中途不再停下来二次确认细节，除非遇到破坏性操作。
-4. **小修不触发**——小修直接定位改，拖慢节奏的声明反而是反模式。
-5. **声明后发现冲突**——若执行中发现与 Story 或现有资源冲突，停止并显式提示，不静默执行。

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

@@ -1,130 +0,0 @@
----
-read_when: 需要查具体 API 端点时 · 构造请求时
----
-
-# 后端 API 速查
-
-> 完整 OpenAPI 规范见 [api.json](./api.json)  
-> 统一响应信封：`{ code: 200, data: <载荷>, message: "success" }`
-
-## 认证
-
-```
-POST /api/auth/login, /register, /logout, /refresh
-POST /api/auth/forgot-password, /reset-password
-POST /api/auth/wechat/mp/oauth, /wechat/mini/login
-POST /api/auth/wechat/mp/qr/create  GET /wechat/mp/qr/poll
-```
-
-## 用户 & 角色
-
-```
-GET/PUT  /api/users/me                PUT /users/me/password
-GET/POST /api/users                   GET/PUT/DELETE /users/{id}
-POST     /users/{id}/ban, /unban
-
-GET/POST /api/roles                   GET/PUT/DELETE /roles/{id}
-POST     /roles/{id}/assign/{uid}     DELETE /roles/{id}/revoke/{uid}
-```
-
-## 页面
-
-```
-GET/POST           /api/pages/
-GET/PUT/DELETE     /pages/{id}
-POST               /pages/{id}/reset-system
-GET                /pages/by-route?route=/xxx
-GET                /pages/{id}/versions
-POST               /versions/{vid}/restore, /star
-```
-
-## 导航栏
-
-```
-GET/POST      /api/navigations
-GET           /navigations/{code}
-PUT/DELETE    /navigations/{id}
-```
-
-## 动态 DB
-
-```
-GET            /api/db/{type}   支持 filters/order_by/order
-POST           /db/{type}       body: { data: {...} } 或数组
-PATCH          /db/{type}/batch
-GET/PUT/DELETE /db/{type}/{id}
-```
-
-## DB Meta ⚠️
-
-```
-GET/POST         /api/db-meta
-GET              /db-meta/{type}   ← 必须用 type，不是 id！
-PUT/DELETE       /db-meta/{id}
-POST             /db-meta/{type}/reconcile-fields
-```
-
-## 自定义服务
-
-```
-GET/POST         /api/scripts
-GET/PUT/DELETE   /scripts/{id}
-POST             /scripts/{id}/enable, /disable, /execute
-ANY              /api/x/{slug}/{path}   ← 脚本运行时端点
-```
-
-## 外部 API
-
-```
-GET    /api/external-apis/available        ← 页面可调用列表（优先用 App.callApi）
-GET/POST /api/external-apis               ← 管理端
-PATCH  /external-apis/{id}/status
-POST   /external-apis/{id}/test
-```
-
-## AIHub & AI推理
-
-```
-GET/POST   /api/aihub
-POST       /aihub/{id}/sync
-GET        /api/v1/models
-POST       /v1/chat/completions      ← OpenAI 兼容格式
-POST       /api/agents/{id}/chat, /images
-```
-
-## 文档中心
-
-```
-GET/POST   /api/docs/categories
-GET        /docs/articles, /docs/articles/{key}, /docs/search
-POST       /docs/articles    PUT/DELETE /docs/articles/{id}
-```
-
-## 系统 & 备份
-
-```
-GET          /api/system/config
-GET/PUT/DELETE /system/{key}
-GET/POST     /api/system/backup
-POST         /system/restore, /reset
-POST         /system/restore/selective?mode=replace|merge|append
-POST         /api/upload
-GET          /api/logs
-```
-
-## 二次认证（高危操作前必须）
-
-restore / reset / undo / cleanup-orphans 需要：
-```
-POST /api/auth/reauth  { password, scope }  → 返回 confirm_token
-请求头加：X-Confirm-Token: <token>
-```
-
-## 不使用信封的端点
-
-| 端点 | 格式 |
-|---|---|
-| `POST /v1/chat/completions` | OpenAI SSE / JSON |
-| `GET /v1/models` | `{ object:"list", data:[...] }` |
-| `POST /external-apis/call/{code}` | 上游原始响应 |
-| `ANY /api/x/{slug}/{path}` | 脚本自定义 |