@wanghaopeng1148/deskpet 2.0.0 → 2.0.2

package/README.md

@@ -101,7 +101,10 @@ npm run dev:watch       # 同上，但后端带 --watch 热重载（改 server/
 │   └── utils/                 # 路径 / 资源 URL / 剪贴板 / 打开外部 / 原生通知
 ├── src/dashboard/             # 管理台前端 (唯一前端入口)
 ├── shared/                    # 前后端共享纯逻辑 (类型)
-└── tests/unit/                # 单元测试 (node:test)
+├── tests/unit/                # 单元测试 (node:test)
+└── dist/                      # 构建产物（不入版本库）
+    ├── web/                   #   前端产物，由 vite 生成
+    └── node/                  #   后端编译产物，由 tsc 生成（发布包必须带上）
 ```
 
 ## 开发辅助命令
@@ -110,16 +113,32 @@ npm run dev:watch       # 同上，但后端带 --watch 热重载（改 server/
 
 | 命令 | 作用 |
 | --- | --- |
-| `npm run build` | 构建前端到 `dist/web`（发版前必须跑） |
+| `npm run build` | 构建全部产物（前端 `dist/web` + 后端编译 `dist/node`），发版前必须跑 |
+| `npm run build:web` | 只构建前端 |
+| `npm run build:server` | 只编译后端（`tsconfig.build.json` → `dist/node`） |
 | `npm run typecheck` | TS 类型检查（`tsconfig.node.json` + `tsconfig.web.json` 各一遍） |
 | `npm test` | 单元测试（内存 SQLite，不触碰真实数据） |
+| `npm run verify:package` | 把打好的包装进临时 `node_modules` 真跑一遍，验证发布形态可用 |
 | `npm run dev:server` | 只起后端（带 `--watch`） |
 | `npm run dev:web` | 只起 Vite（⚠️ 单独跑会因后端没起而报 `Failed to fetch`） |
-| `npm run serve` | 直接起后端，不做任何依赖/产物检查 |
+| `npm run serve` | 直接跑源码后端（`.ts`），不做任何依赖/产物检查 |
 
 目录约定：后端在 `server/`，前端在 `src/`，两侧共享的纯逻辑放 `shared/`
 （那里**不要** import 任何 Node 或浏览器专有 API）。
 
+### 为什么后端必须编译成 JS（重要）
+
+发布包里的后端**不能**是 `.ts` 源码：Node 明确禁止对 `node_modules` 下的文件做类型擦除
+（`ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING`）。而 `npx` 安装/缓存的位置正在
+`node_modules` 里，所以「本地跑源码一切正常、用户 `npx` 一启动就崩」——**这个坑只在发布形态下出现**。
+
+因此流程是：`tsc -p tsconfig.build.json` 把 `server/` 与 `shared/` 编译到 `dist/node`
+（保持相对层级，并用 `rewriteRelativeImportExtensions` 把导入后缀从 `.ts` 改写成 `.js`，
+因此不需要任何打包器），`bin/deskpet.mjs` 优先启动编译产物，只有源码形态才回退到 `.ts`。
+
+验证方式就是 `npm run verify:package`——它把 tarball 装进临时 `node_modules` 再启动，
+**只有这样才能复现上面那个报错**。
+
 ## 服务重启与任务中断（重要）
 
 任务执行期间如果后端进程退出，会出现两类结果，管理台会区分显示：
@@ -296,8 +315,8 @@ TASK_PARAMS = [
 ### 发布步骤（一键）
 
 ```bash
-npm run release                  # 一键：校验 → 类型检查 → 测试 → 构建 → 打包核对 → 发布
-npm run release -- --dry-run     # 只跑到打包预演，不真正发布（首次发版建议先跑一遍）
+npm run release                  # 一键：校验 → 类型检查 → 测试 → 构建 → 打包核对 → 真实安装验证 → 发布
+npm run release -- --dry-run     # 一路跑到真实安装验证，但不发布（首次发版建议先跑一遍）
 npm run release -- --bump patch  # 同上，并先把版本号升一档（patch/minor/major）
 ```
 
@@ -309,19 +328,32 @@ npm run release -- --bump patch  # 同上，并先把版本号升一档（patch/
 | ② 校验登录状态 | `npm whoami`，并核对包名 scope 与当前账号是否一致 |
 | ③ 校验版本 | 该版本是否已经发过（避免 409 覆盖失败） |
 | ④ 质量门禁 | `npm run typecheck` + `npm test`，不通过就不发 |
-| ⑤ 构建 | `npm run build` —— 发布包靠它带上最新的 `dist/web` |
-| ⑥ 打包核对 | `npm pack --dry-run`，并确认 `bin` / `server` / `shared` / `dist/web` 都真的在包里 |
-| ⑦ 发布 | 确认后执行 `npm publish --access public`；开了 2FA 会提示输入验证码 |
+| ⑤ 构建 | `npm run build` —— 前端 `dist/web` + 后端编译 `dist/node`，**两者缺一使用者都跑不起来** |
+| ⑥ 打包核对 | `npm pack --dry-run`，并确认 `bin` / `dist/node/server/main.js` / `dist/web` 都真的在包里 |
+| ⑦ 真实安装验证 | 把 tarball 装进临时 `node_modules` 启动一次，校验 `/dashboard/` 与接口（见下） |
+| ⑧ 发布 | 确认后执行 `npm publish --access public`；开了 2FA 会提示输入验证码 |
+
+其它参数：`--otp 123456`（直接带验证码）、`--yes`（跳过确认）、`--skip-checks`（跳过类型检查与测试）、`--skip-build`（跳过构建）、`--skip-verify`（跳过真实安装验证，**不推荐**）。
 
-其它参数：`--otp 123456`（直接带验证码）、`--yes`（跳过确认）、`--skip-checks`（跳过类型检查与测试）、`--skip-build`（跳过构建）。
+> **第 ⑦ 步为什么不能省**：本地跑的是源码，使用者跑的是装进 `node_modules` 的包，两者环境不同。
+> 详见上面「为什么后端必须编译成 JS」——那个坑在本地跑源码时完全看不出来，
+> 只有把包装进 `node_modules` 再启动才能暴露。第 ⑦ 步就是干这个的。
+
+单独跑验证（不发布）：
+
+```bash
+npm run verify:package              # 打包 → 装进临时 node_modules → 启动 → 查接口 → 回收
+npm run verify:package -- --keep    # 保留临时目录，便于排查
+```
 
 <details>
 <summary>手动发布（不想用脚本时）</summary>
 
 ```bash
 npm login
-npm run build                # ⚠️ 必须先构建：发布包要靠它带上最新的 dist/web
-npm pack --dry-run           # 先看会发出去哪些文件（正常应为 70+ 文件、3~4 MB）
+npm run build                # ⚠️ 必须先构建（前端 dist/web + 后端 dist/node），少一个都不行
+npm run verify:package       # ⚠️ 强烈建议：确认装进 node_modules 后真的能起来
+npm pack --dry-run           # 先看会发出去哪些文件（正常应为 120+ 文件、约 4 MB）
 npm version patch            # 升版本号
 npm publish --otp=123456     # ⚠️ 换成认证器里的 6 位码；access=public 已写在 publishConfig 里
 ```
@@ -356,13 +388,18 @@ npx @wanghaopeng1148/deskpet                  # 真正启动
 
 ```
 bin/        命令行入口 —— npx 执行的就是它
-server/     后端全部源码（以 .ts 直接运行，无需编译）
-shared/     前后端共享的纯逻辑
+dist/node/  后端编译产物 ← 关键：运行的是这里的 JS，不是 server/ 下的 .ts
 dist/web/   前端构建产物 ← 关键：带上它，使用者才不必自己构建
+server/     后端源码（供阅读/调试用；运行时不加载它）
+shared/     前后端共享的纯逻辑（同上）
 resources/  皮肤、图标等随包资源
 ```
 
-不会发出去：`src/`（前端源码）、`scripts/`、`tests/`、`node_modules/`、`dist/web_prev_*`。
+> ⚠️ **发布包里必须有 `dist/node`**。`server/*.ts` 只是随包附带，**不能**作为运行入口：
+> Node 禁止对 `node_modules` 下的文件做类型擦除，用户 `npx` 时会直接崩。
+> `npm run release` 的第 ⑤⑥⑦ 步会分别从构建、打包清单、真实安装三个角度挡住这种情况。
+
+不会发出去：`src/`（前端源码）、`scripts/`、`tests/`、`node_modules/`。
 
 ### 依赖的三类归属（别搞混）
 
@@ -374,13 +411,15 @@ resources/  皮肤、图标等随包资源
 
 ### 发版检查清单
 
-`npm run release` 已经自动覆盖了大部分（构建、测试、打包核对、`private` 检查、关键文件校验），
+`npm run release` 已经自动覆盖了大部分（构建、typecheck、测试、打包核对、真实安装验证、`private` 检查、关键文件校验），
 **剩下这几件需要人工把关**：
 
 - [ ] 版本号已升（用 `--bump patch` 或手动改 `version`）—— 不升的话 npm 会拒绝重复发布
 - [ ] 依赖声明的改动已用 `npm install --package-lock-only` 同步到 `package-lock.json`
 - [ ] 发布后 `git commit` + `git tag v<版本>`，别只提交代码不打标签
 - [ ] 改了 scope / 包名时，README 里出现的包名一并更新
+- [ ] **手动改过 `server/` 下代码后发版**：确认走的是 `npm run release`（内含 `build:server`），
+      别绕过脚本直接 `npm publish` —— 那样发出去的可能是旧的 `dist/node` 产物
 
 ## 说明
 
@@ -391,4 +430,19 @@ resources/  皮肤、图标等随包资源
   （执行中 / 排队 N），列表里排队任务显示 `#序号`，点「取消排队」可撤销；仪表盘横幅也会显示执行中与排队数。
   前端通过 `GET /api/queue` 拉取，并用 WebSocket `queue-changed` 实时更新。
 - 通知通道：系统原生通知（osascript / PowerShell Toast / notify-send）+ 管理台页面内提示 + 微信。
-- 开机自启：Windows 写入 `HKCU\...\Run`，macOS 写入 `~/Library/LaunchAgents`，Linux 暂不支持。
+- **开机自启**：管理台「设置」页有开关（对应配置项 `system.autoStart`）。开启后各平台的落地方式：
+
+  | 平台 | 写到哪里 |
+  | --- | --- |
+  | Windows | 启动文件夹 `DeskPet.cmd`（不依赖 reg / schtasks，受管控的机器也能用） |
+  | macOS | `~/Library/LaunchAgents/DeskPet.plist` |
+  | Linux | `~/.config/autostart/DeskPet.desktop`（XDG 标准） |
+
+  注册的命令统一是 `bin/deskpet.mjs --no-open` —— 它内部用当前 node 拉起服务（不依赖 PATH），
+  也不会在开机时弹浏览器。**想临时停用，直接删掉对应文件即可**，或把设置页开关关掉。
+  服务启动时也会按配置同步一次（关闭时会移除文件）。
+
+  > 历史坑：本项目早期是 Electron 应用，自启是启动文件夹里的 `DeskPet.lnk`
+  > （指向旧的 `pet\dist\DeskPet.exe`）。改成 Node 服务、目录改名后，那个快捷方式不会自动失效消失，
+  > 结果就是「以为自启开着，实际每次开机拉起的是旧程序，新服务仍要手动启动」。
+  > 所以开启自启时会**主动清理**同名的旧 `.lnk`。

package/bin/deskpet.mjs

@@ -15,7 +15,7 @@
  *   npx deskpet --check         只做环境自检，不启动服务
  */
 import { spawn, spawnSync } from 'node:child_process'
-import { existsSync, readFileSync } from 'node:fs'
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
 import net from 'node:net'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
@@ -25,6 +25,69 @@ const pkgRoot = dirname(dirname(fileURLToPath(import.meta.url)))
 const isWin = process.platform === 'win32'
 /** 前端入口产物（vite 的 root 是 src、入口是 src/dashboard/index.html，故多一层 dashboard） */
 const distEntry = join(pkgRoot, 'dist', 'web', 'dashboard', 'index.html')
+/**
+ * 后端入口。
+ *
+ * 必须优先用编译产物：Node **禁止对 node_modules 下的文件做类型擦除**
+ * （ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING），而 npm 安装 / npx 缓存里的包
+ * 正位于 node_modules 下 —— 若直接跑 .ts，使用者一启动就会崩。
+ * 源码形态（git clone 下来跑）才回退到 .ts + --experimental-strip-types。
+ */
+const compiledEntry = join(pkgRoot, 'dist', 'node', 'server', 'main.js')
+const sourceEntry = join(pkgRoot, 'server', 'main.ts')
+
+/** 递归取目录下最新修改时间 */
+function newestMtime(dir) {
+  let newest = 0
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const p = join(dir, entry.name)
+    newest = Math.max(newest, entry.isDirectory() ? newestMtime(p) : statSync(p).mtimeMs)
+  }
+  return newest
+}
+
+/**
+ * 源码是否比编译产物更新。
+ *
+ * 为什么需要：bin 优先跑编译产物，若改了 `server/` 却没重新编译，
+ * 就会**静默跑旧代码**（开机自启走的正是这条路径，最不容易发现）。
+ * 发布包里 npm 会把所有文件时间统一，两者相等 → 视为产物可用，不受影响。
+ */
+function sourceIsNewer() {
+  try {
+    const compiledTime = statSync(compiledEntry).mtimeMs
+    for (const dir of ['server', 'shared']) {
+      if (newestMtime(join(pkgRoot, dir)) > compiledTime) return true
+    }
+  } catch {
+    /* 读不到就按「不更新」处理，退回产物 */
+  }
+  return false
+}
+
+/** 返回 { entry, args }：编译产物无需额外参数 */
+function resolveServerEntry() {
+  const hasCompiled = existsSync(compiledEntry)
+  const hasSource = existsSync(sourceEntry)
+
+  if (hasCompiled && !(hasSource && sourceIsNewer())) {
+    return { entry: compiledEntry, args: [], compiled: true, stale: false }
+  }
+  if (hasSource) {
+    return {
+      entry: sourceEntry,
+      args: ['--experimental-strip-types'],
+      compiled: false,
+      // 有产物但源码更新：说明忘了重新编译，提示一下（本次按源码跑，保证跑的是最新代码）
+      stale: hasCompiled
+    }
+  }
+  console.error('[deskpet] 找不到后端入口。')
+  console.error(`          已尝试：${compiledEntry}`)
+  console.error(`                  ${sourceEntry}`)
+  console.error('          源码方式请先执行：npm install && npm run build')
+  process.exit(1)
+}
 
 const argv = process.argv.slice(2)
 const hasFlag = (name) => argv.includes(name)
@@ -111,15 +174,20 @@ if (!existsSync(distEntry)) {
 
 const port = resolvePort()
 const url = `http://127.0.0.1:${port}/dashboard/`
+const server = resolveServerEntry()
+if (server.stale) {
+  log('提示：server/ 比编译产物新，本次按源码运行（npm run build:server 可更新产物）')
+}
 
 if (checkOnly) {
+  log(`后端入口：${server.compiled ? '编译产物' : '源码（.ts）'} — ${server.entry}`)
   log(`自检通过：产物就绪、端口 ${port}、入口 ${url}`)
   process.exit(0)
 }
 
 // ── 2. 启动后端 ───────────────────────────────────────────
 log(`启动服务（端口 ${port}）…`)
-const child = spawn(process.execPath, ['--experimental-strip-types', join(pkgRoot, 'server', 'main.ts')], {
+const child = spawn(process.execPath, [...server.args, server.entry], {
   cwd: pkgRoot,
   stdio: 'inherit',
   env: { ...process.env, DESKPET_PORT: String(port) }

package/dist/node/server/db/database.js

@@ -0,0 +1,113 @@
+/**
+ * SQLite 数据库层 — node:sqlite 零依赖
+ * 表结构对齐方案文档 §6.1
+ */
+import { DatabaseSync } from 'node:sqlite';
+import { join } from 'path';
+import { getConfigDir } from "../utils/paths.js";
+/** 数据库文件路径 */
+export function defaultDbPath() {
+    return join(getConfigDir(), 'deskpet.db');
+}
+/** 打开（或创建）数据库并执行迁移 */
+export function openDatabase(path) {
+    const db = new DatabaseSync(path ?? defaultDbPath());
+    db.exec('PRAGMA journal_mode = WAL');
+    db.exec('PRAGMA foreign_keys = ON');
+    migrate(db);
+    return db;
+}
+const MIGRATIONS = [
+    // ── v1: 初始表结构 ──────────────────────────────────────
+    `
+  CREATE TABLE IF NOT EXISTS tasks (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    type TEXT NOT NULL,               -- manual/scheduled/scene
+    action TEXT NOT NULL,             -- python_script/show_reminder/...
+    action_params TEXT DEFAULT '{}',  -- JSON
+    trigger_type TEXT DEFAULT '',     -- once/cron/delay/interval/idle/startup/network
+    trigger_params TEXT DEFAULT '{}', -- JSON
+    script_path TEXT DEFAULT '',
+    interpreter TEXT,
+    script_args TEXT DEFAULT '[]',    -- JSON array
+    script_timeout INTEGER DEFAULT 120,
+    work_dir TEXT,
+    priority INTEGER DEFAULT 1,
+    retry_count INTEGER DEFAULT 0,
+    enabled INTEGER DEFAULT 1,
+    notify_channels TEXT DEFAULT '["desktop"]',  -- JSON
+    chain_next TEXT,
+    chain_condition TEXT,
+    one_time INTEGER DEFAULT 0,
+    status TEXT DEFAULT 'idle',
+    execution_count INTEGER DEFAULT 0,
+    created_at TEXT,
+    updated_at TEXT
+  );
+
+  CREATE TABLE IF NOT EXISTS executions (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    task_id TEXT NOT NULL,
+    task_name TEXT NOT NULL,
+    status TEXT NOT NULL,             -- running/completed/failed/timeout/cancelled
+    started_at TEXT NOT NULL,
+    finished_at TEXT,
+    exit_code INTEGER,
+    duration_ms INTEGER,
+    stdout TEXT DEFAULT '',
+    stderr TEXT DEFAULT '',
+    error TEXT DEFAULT ''
+  );
+  CREATE INDEX IF NOT EXISTS idx_executions_task ON executions(task_id, started_at);
+  CREATE INDEX IF NOT EXISTS idx_executions_started ON executions(started_at);
+
+  CREATE TABLE IF NOT EXISTS snapshots (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    created_at TEXT NOT NULL,
+    reason TEXT NOT NULL,             -- manual/auto
+    data TEXT NOT NULL                -- 完整配置 JSON
+  );
+
+  CREATE TABLE IF NOT EXISTS wechat_messages (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    direction TEXT NOT NULL,          -- in/out
+    content TEXT,
+    created_at TEXT
+  );
+  `,
+    // ── v2: 执行记录补记子进程 pid ────────────────────────────
+    //
+    // 为什么需要：服务被强杀 / 重启后重新启动时，原先只能「有罪推定」——
+    // 库里凡是 running 的执行记录一律收尾为「服务重启，执行被中断」。
+    // 但子进程（python 等）在 Windows 上并不会随父进程退出而死，
+    // 于是会出现「任务被判失败、脚本其实还在后台跑」的错判。
+    // 记下 pid 后，启动时可以先探测进程是否还活着，再决定怎么定性。
+    `
+  ALTER TABLE executions ADD COLUMN pid INTEGER;
+  `
+];
+/** 按 user_version 增量迁移 */
+export function migrate(db) {
+    const row = db.prepare('PRAGMA user_version').get();
+    let version = row?.user_version ?? 0;
+    while (version < MIGRATIONS.length) {
+        db.exec('BEGIN');
+        try {
+            db.exec(MIGRATIONS[version]);
+            version += 1;
+            db.exec(`PRAGMA user_version = ${version}`);
+            db.exec('COMMIT');
+        }
+        catch (err) {
+            db.exec('ROLLBACK');
+            throw err;
+        }
+    }
+}
+/** 便于测试：内存数据库 */
+export function openMemoryDatabase() {
+    const db = new DatabaseSync(':memory:');
+    migrate(db);
+    return db;
+}

package/dist/node/server/db/migrate-legacy.js

@@ -0,0 +1,88 @@
+/**
+ * 旧版数据迁移 — Python 版 tasks.json → SQLite（方案 §6.2 迁移策略）
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { newTaskId } from "./task-repository.js";
+/** 解析旧版 tasks.json 内容为 TaskConfig 数组 */
+export function parseLegacyTasks(rawJson) {
+    let data;
+    try {
+        data = JSON.parse(rawJson);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const t of data.tasks ?? []) {
+        try {
+            out.push(legacyToConfig(t));
+        }
+        catch {
+            // 单条失败不影响整体导入
+        }
+    }
+    return out;
+}
+function legacyToConfig(t) {
+    const tr = t.trigger ?? {};
+    const trigger = {
+        type: String(tr.type ?? 'manual'),
+        datetime: tr.datetime ?? null,
+        cron: tr.cron ?? null,
+        delaySeconds: tr.delay_seconds ?? null,
+        intervalMinutes: tr.interval_minutes ?? null,
+        idleMinutes: tr.idle_minutes ?? null,
+        maxExecutions: typeof tr.max_executions === 'number' ? tr.max_executions : -1,
+        holidayCheck: !!tr.holiday_check
+    };
+    return {
+        name: String(t.name ?? '未命名任务'),
+        type: t.type ?? 'manual',
+        trigger,
+        action: String(t.action ?? 'python_script'),
+        actionParams: t.action_params ?? {},
+        scriptPath: t.script_path ?? '',
+        interpreter: t.interpreter ?? null,
+        scriptArgs: t.script_args ?? [],
+        scriptTimeout: t.script_timeout ?? 120,
+        scriptWorkDir: t.script_work_dir ?? null,
+        retryCount: t.retry_count ?? 0,
+        enabled: t.enabled !== false,
+        notifyChannels: ['desktop'],
+        chainNext: null,
+        chainCondition: null,
+        oneTime: !!t.one_time
+    };
+}
+/**
+ * 从旧版 tasks.json 导入任务到 SQLite。
+ * 仅当任务表为空且文件存在时导入（避免重复导入）。
+ */
+export function migrateLegacyTasksFile(filePath, repo) {
+    if (!existsSync(filePath)) {
+        return { imported: 0, skipped: true, reason: '文件不存在' };
+    }
+    if (repo.count() > 0) {
+        return { imported: 0, skipped: true, reason: '已有任务数据，跳过导入' };
+    }
+    const configs = parseLegacyTasks(readFileSync(filePath, 'utf-8'));
+    const now = new Date().toISOString();
+    let imported = 0;
+    for (const config of configs) {
+        const id = newTaskId();
+        repo.insert({
+            id,
+            config,
+            status: config.enabled ? 'idle' : 'disabled',
+            createdAt: now,
+            executionCount: 0,
+            lastRunAt: null,
+            lastResult: null,
+            lastError: null,
+            nextRunAt: null,
+            currentRetry: 0
+        });
+        imported += 1;
+    }
+    return { imported, skipped: false };
+}