luckytri 1.0.0 → 1.0.2

package/docs/zh/npm-release.md

@@ -1,33 +1,33 @@
-# npm 发布与维护
-
-发布复用 LuckyTri 当前 Git 仓库和 `package.json`，包名为 `luckytri`，版本继续由 `server/version.js` 从根 `package.json` 读取。
-
-## 结构与启动
-
-`server/` 是无需转译的 ESM 服务端，运行依赖为 Express、ws 和 sharp；SQLite 使用 Node.js 内置的 `node:sqlite`，最低 Node.js 24.5。`studio-web/` 使用 Vue 与 Vite，发布前构建到 `public/app/`。教程从中英文 `docs/*/guide.md` 生成到 `public/`。
-
-`bin/luckytri.js` 提供全局命令，分派到既有启动、停止、备份、恢复与插件脚本。`scripts/runtime.js` 复用 `scripts/setup.js` 的随机令牌初始化，并保留已有配置。`server/paths.js` 将包内资源与实例数据分开；源码默认继续使用仓库的 `.env` 和 `data/`，npm 安装默认使用独立用户目录。相对数据库和备份路径以实例目录为基准，后台进程和自动备份子进程继承相同的绝对路径。服务身份以实例目录确认，更新程序安装位置后仍能定位原实例。
-
-数据库、心智、聊天、界面配置继续使用原 SQLite 存储与迁移；知识文件、插件安装与插件数据、日志和备份都在实例目录中。启动锁保留到服务退出，阻止重复打开同一实例。Windows、macOS、Linux 分别使用系统浏览器打开方式；无桌面环境可使用 `--no-browser`。
-
-## 包内容边界
-
-`package.json.files` 白名单只包含 CLI、服务端、运行脚本、构建后的 WebUI、教程、插件桥接资源、内置天气插件、SDK 和公开文档。`.npmignore` 再排除敏感及本地文件。安装和卸载没有应用生命周期脚本，普通用户无需前端构建工具。
-
-`npm run pack:check` 使用 npm 实际生成的最终文件清单，先检查路径，再检查经过批准的源码内容，拒绝配置、秘密文件、数据库、聊天、日志、备份、开发文件和意外新增文件。它还校验 CLI shebang、关键资源、WebUI 资源引用及源代码中的常见秘密格式。不要使用 `--ignore-scripts` 从未经验证的源码直接发布。
-
-## 发布流程
-
-维护者需要开发依赖和 Playwright 浏览器。Windows 默认使用已安装的 Edge；Linux/macOS 可用 `npx playwright install chromium` 安装测试浏览器。
-
-```bash
-npm ci
-npm run release:check
-npm publish
-```
-
-`release:check` 构建完整资源、运行全部后端与 WebUI 测试、检查实际包并验证全局安装。`prepublishOnly` 自动执行构建、后端测试和实际包安装测试；`prepack` 自动构建并检查最终包内容。发新版本前同时更新 `package.json` 与 lockfile，并更新版本记录；已发布的版本不可覆盖。
-
-包测试使用临时 npm 全局前缀和模拟数据，检查含空格、中文的任意调用目录、WebUI 浏览器加载、内置插件、数据库备份及恢复检查，再安装测试版本并卸载重装，确认配置、记忆、关系、聊天、知识文件、日志、备份和插件数据保留。测试版本只存在于本机临时压缩包，不发布。测试清单和经过验证的正式压缩包输出到被 Git 忽略的 `workspace/npm-release/`。完成检查后也可直接发布该目录中的正式 `.tgz`，保证上传的是已经检查和安装过的同一份包。
-
-首次发布需要 npm 注册与登录。发布命令使用 npm 自己的登录流程，不读取或输出登录凭据文件；如果 npm 要求二次验证，由账号本人完成认证后继续发布。
+# npm 发布与维护
+
+发布复用 LuckyTri 当前 Git 仓库和 `package.json`，包名为 `luckytri`，版本继续由 `server/version.js` 从根 `package.json` 读取。
+
+## 结构与启动
+
+`server/` 是无需转译的 ESM 服务端，运行依赖为 Express、ws 和 sharp；SQLite 使用 Node.js 内置的 `node:sqlite`，最低 Node.js 24.5。`studio-web/` 使用 Vue 与 Vite，发布前构建到 `public/app/`。教程从中英文 `docs/*/guide.md` 生成到 `public/`。
+
+`bin/luckytri.js` 提供全局命令，分派到既有启动、停止、备份、恢复与插件脚本。`scripts/runtime.js` 复用 `scripts/setup.js` 的本机环境初始化与管理台首次密码设置，并保留已有配置。`server/paths.js` 将包内资源与实例数据分开；源码默认继续使用仓库的 `.env` 和 `data/`，npm 安装默认使用独立用户目录。相对数据库和备份路径以实例目录为基准，后台进程和自动备份子进程继承相同的绝对路径。服务身份以实例目录确认，更新程序安装位置后仍能定位原实例。
+
+数据库、心智、聊天、界面配置继续使用原 SQLite 存储与迁移；知识文件、插件安装与插件数据、日志和备份都在实例目录中。启动锁保留到服务退出，阻止重复打开同一实例。Windows、macOS、Linux 分别使用系统浏览器打开方式；无桌面环境可使用 `--no-browser`。
+
+## 包内容边界
+
+`package.json.files` 白名单只包含 CLI、服务端、运行脚本、构建后的 WebUI、教程、插件桥接资源、内置天气插件、SDK 和公开文档。`.npmignore` 再排除敏感及本地文件。安装和卸载没有应用生命周期脚本，普通用户无需前端构建工具。
+
+`npm run pack:check` 使用 npm 实际生成的最终文件清单，先检查路径，再检查经过批准的源码内容，拒绝配置、秘密文件、数据库、聊天、日志、备份、开发文件和意外新增文件。它还校验 CLI shebang、关键资源、WebUI 资源引用及源代码中的常见秘密格式。不要使用 `--ignore-scripts` 从未经验证的源码直接发布。
+
+## 发布流程
+
+维护者需要开发依赖和 Playwright 浏览器。Windows 默认使用已安装的 Edge；Linux/macOS 可用 `npx playwright install chromium` 安装测试浏览器。
+
+```bash
+npm ci
+npm run release:check
+npm publish
+```
+
+`release:check` 构建完整资源、运行全部后端与 WebUI 测试、检查实际包并验证全局安装。`prepublishOnly` 自动执行构建、后端测试和实际包安装测试；`prepack` 自动构建并检查最终包内容。发新版本前同时更新 `package.json` 与 lockfile，并更新版本记录；已发布的版本不可覆盖。
+
+包测试使用临时 npm 全局前缀和模拟数据，检查含空格、中文的任意调用目录、WebUI 浏览器加载、内置插件、数据库备份及恢复检查，再安装测试版本并卸载重装，确认配置、记忆、关系、聊天、知识文件、日志、备份和插件数据保留。测试版本只存在于本机临时压缩包，不发布。测试清单和经过验证的正式压缩包输出到被 Git 忽略的 `workspace/npm-release/`。完成检查后也可直接发布该目录中的正式 `.tgz`，保证上传的是已经检查和安装过的同一份包。
+
+首次发布需要 npm 注册与登录。发布命令使用 npm 自己的登录流程，不读取或输出登录凭据文件；如果 npm 要求二次验证，由账号本人完成认证后继续发布。

package/package.json

@@ -1,108 +1,110 @@
-{
-  "name": "luckytri",
-  "version": "1.0.0",
-  "description": "让由技术诞生的她，在时间、记忆、相遇与选择中逐渐形成自己的方向",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/TodayYueC/LuckyTri.git"
-  },
-  "bugs": {
-    "url": "https://github.com/TodayYueC/LuckyTri/issues"
-  },
-  "homepage": "https://github.com/TodayYueC/LuckyTri",
-  "type": "module",
-  "bin": {
-    "luckytri": "bin/luckytri.js"
-  },
-  "files": [
-    "bin/luckytri.js",
-    "server/**/*.js",
-    "server/plugins/runner/*.mjs",
-    "scripts/launch.js",
-    "scripts/start-server.js",
-    "scripts/stop.js",
-    "scripts/setup.js",
-    "scripts/runtime.js",
-    "scripts/service.js",
-    "scripts/browser.js",
-    "scripts/proxy-config.js",
-    "scripts/backup.js",
-    "scripts/recover.js",
-    "scripts/plugin.js",
-    "public/app/index.html",
-    "public/app/assets/*.js",
-    "public/app/assets/*.css",
-    "public/app/assets/*.png",
-    "public/plugin-kit/v1/bridge.js",
-    "public/plugin-kit/v1/kit.css",
-    "public/guide.html",
-    "public/guide.en.html",
-    "public/tutorial.md",
-    "public/tutorial.en.md",
-    "plugins/weather/index.js",
-    "plugins/weather/luckytri-plugin.json",
-    "plugins/sdk/index.d.ts",
-    "plugins/sdk/testing.js",
-    "docs/zh/*.md",
-    "docs/en/*.md",
-    "docs/brand/*.png",
-    ".github/SECURITY.md",
-    "README.en.md",
-    "LICENSE"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "keywords": [
-    "qq",
-    "onebot",
-    "chatbot",
-    "ai",
-    "memory",
-    "webui"
-  ],
-  "engines": {
-    "node": ">=24.5"
-  },
-  "scripts": {
-    "launch": "node scripts/launch.js",
-    "start": "node scripts/start-server.js",
-    "dev:ui": "vite --config studio-web/vite.config.ts",
-    "build:ui": "vite build --config studio-web/vite.config.ts",
-    "build": "npm run build:ui && npm run docs:build",
-    "test": "node --import ./tests/helpers/awake.mjs --test tests/*.test.js",
-    "test:clock": "node scripts/dev/test-clock.js",
-    "audit:sent": "node --env-file-if-exists=.env scripts/dev/audit-sent.js",
-    "test:ui": "node tests/ui/smoke.js && node tests/ui/ta.mjs && node tests/ui/navigation.mjs && node tests/ui/time.mjs && node tests/ui/time-arrangement.mjs && node tests/ui/performance.mjs && node tests/ui/search.mjs && node tests/ui/storage.mjs && node tests/ui/i18n.mjs",
-    "setup": "node scripts/setup.js",
-    "stop": "node scripts/stop.js",
-    "backup": "node scripts/backup.js",
-    "recovery": "node scripts/recover.js",
-    "docs:build": "node scripts/build-guide.js",
-    "plugin": "node scripts/plugin.js",
-    "pack:check": "node scripts/pack-check.js",
-    "test:package": "node scripts/test-package.js",
-    "test:registry": "node scripts/test-package.js --registry",
-    "prepack": "npm run build && npm run pack:check",
-    "prepublishOnly": "npm run build && npm test && npm run test:package",
-    "release:check": "npm run build && npm test && npm run test:ui && npm run test:package",
-    "format": "prettier --write bin server studio-web scripts tests plugins package.json",
-    "format:check": "prettier --check bin server studio-web scripts tests plugins package.json"
-  },
-  "dependencies": {
-    "express": "^5.1.0",
-    "sharp": "^0.35.5",
-    "ws": "^8.18.3"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.55.0",
-    "@vitejs/plugin-vue": "^6.0.9",
-    "marked": "^18.0.13",
-    "prettier": "^3.9.8",
-    "typescript": "^7.0.2",
-    "vite": "^8.3.0",
-    "vue": "^3.5.43"
-  }
-}
+{
+  "name": "luckytri",
+  "version": "1.0.2",
+  "description": "让由技术诞生的她，在时间、记忆、相遇与选择中逐渐形成自己的方向",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TodayYueC/LuckyTri.git"
+  },
+  "bugs": {
+    "url": "https://github.com/TodayYueC/LuckyTri/issues"
+  },
+  "homepage": "https://github.com/TodayYueC/LuckyTri",
+  "type": "module",
+  "bin": {
+    "luckytri": "bin/luckytri.js"
+  },
+  "files": [
+    "bin/luckytri.js",
+    "server/**/*.js",
+    "server/plugins/runner/*.mjs",
+    "scripts/launch.js",
+    "scripts/start-server.js",
+    "scripts/stop.js",
+    "scripts/reset-password.js",
+    "scripts/setup.js",
+    "scripts/runtime.js",
+    "scripts/service.js",
+    "scripts/browser.js",
+    "scripts/proxy-config.js",
+    "scripts/backup.js",
+    "scripts/recover.js",
+    "scripts/import-data.js",
+    "scripts/plugin.js",
+    "public/app/index.html",
+    "public/app/assets/*.js",
+    "public/app/assets/*.css",
+    "public/app/assets/*.png",
+    "public/plugin-kit/v1/bridge.js",
+    "public/plugin-kit/v1/kit.css",
+    "public/guide.html",
+    "public/guide.en.html",
+    "public/tutorial.md",
+    "public/tutorial.en.md",
+    "plugins/weather/index.js",
+    "plugins/weather/luckytri-plugin.json",
+    "plugins/sdk/index.d.ts",
+    "plugins/sdk/testing.js",
+    "docs/zh/*.md",
+    "docs/en/*.md",
+    "docs/brand/*.png",
+    ".github/SECURITY.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "qq",
+    "onebot",
+    "chatbot",
+    "ai",
+    "memory",
+    "webui"
+  ],
+  "engines": {
+    "node": ">=24.5"
+  },
+  "scripts": {
+    "launch": "node scripts/launch.js",
+    "start": "node scripts/start-server.js",
+    "dev:ui": "vite --config studio-web/vite.config.ts",
+    "build:ui": "vite build --config studio-web/vite.config.ts",
+    "build": "npm run build:ui && npm run docs:build",
+    "test": "node --import ./tests/helpers/awake.mjs --test tests/*.test.js",
+    "test:clock": "node scripts/dev/test-clock.js",
+    "audit:sent": "node --env-file-if-exists=.env scripts/dev/audit-sent.js",
+    "test:ui": "node tests/ui/access.mjs && node tests/ui/smoke.js && node tests/ui/ta.mjs && node tests/ui/navigation.mjs && node tests/ui/time.mjs && node tests/ui/time-arrangement.mjs && node tests/ui/performance.mjs && node tests/ui/search.mjs && node tests/ui/storage.mjs && node tests/ui/data-transfer.mjs && node tests/ui/i18n.mjs",
+    "setup": "node scripts/setup.js",
+    "stop": "node scripts/stop.js",
+    "backup": "node scripts/backup.js",
+    "recovery": "node scripts/recover.js",
+    "docs:build": "node scripts/build-guide.js",
+    "plugin": "node scripts/plugin.js",
+    "pack:check": "node scripts/pack-check.js",
+    "test:package": "node scripts/test-package.js",
+    "test:registry": "node scripts/test-package.js --registry",
+    "prepack": "npm run build && npm run pack:check",
+    "prepublishOnly": "npm run build && npm test && npm run test:package",
+    "release:check": "npm run build && npm test && npm run test:ui && npm run test:package",
+    "format": "prettier --write bin server studio-web scripts tests plugins package.json",
+    "format:check": "prettier --check bin server studio-web scripts tests plugins package.json"
+  },
+  "dependencies": {
+    "express": "^5.1.0",
+    "sharp": "^0.35.5",
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.55.0",
+    "@vitejs/plugin-vue": "^6.0.9",
+    "marked": "^18.0.13",
+    "prettier": "^3.9.8",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.0",
+    "vue": "^3.5.43"
+  }
+}

package/plugins/sdk/index.d.ts

@@ -1,155 +1,155 @@
-// LuckyTri Plugin API v1. A later API can be added beside this one;
-// v1 stays available through the 1.x line.
-
-export interface PluginManifest {
-  id: string;
-  name: string;
-  version: string;
-  pluginApi: "1.0";
-  luckytri?: string;
-  description?: string;
-  author?: string;
-  license?: string;
-  entry?: string;
-  permissions?: string[];
-  network?: string[];
-  settings?: PluginSetting[];
-  contributes?: PluginContributes;
-}
-
-export interface PluginSetting {
-  key: string;
-  type:
-    "text" | "secret" | "number" | "boolean" | "select" | "textarea" | "urls";
-  label: string;
-  required?: boolean;
-  default?: unknown;
-  allowNetwork?: boolean;
-}
-
-export interface PluginContributes {
-  senses?: string[];
-  channels?: {
-    type: string;
-    label?: string;
-    capabilities?: Record<string, boolean>;
-  }[];
-  activities?: {
-    kind: string;
-    label?: string;
-    describe?: string;
-    keywords?: string;
-    minutes?: number;
-    energy?: boolean;
-  }[];
-  actions?: {
-    name: string;
-    label?: string;
-    describe?: string;
-    risk?: "low" | "high";
-    confirm?: "none" | "owner";
-    where?: "private" | "any";
-    dailyLimit?: number;
-  }[];
-  perceive?: string[];
-  ui?: { page?: boolean };
-}
-
-export interface PluginContext {
-  plugin: { id: string; version: string; dataDir: string };
-  api: { version: "1.0"; has(feature: string): boolean };
-  now(): Promise<number>;
-  log: {
-    info(...parts: unknown[]): Promise<void>;
-    warn(...parts: unknown[]): Promise<void>;
-    error(...parts: unknown[]): Promise<void>;
-  };
-  settings: {
-    get(): Promise<Record<string, unknown>>;
-    onChange(fn: () => void): void;
-  };
-  storage: {
-    get(key: string): Promise<unknown>;
-    set(key: string, value: unknown): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix?: string): Promise<string[]>;
-  };
-  net: { fetch(url: string, init?: RequestInit): Promise<Response> };
-  mind: {
-    state(): Promise<Record<string, unknown>>;
-    observe(input: {
-      summary: string;
-      detail?: string;
-      discretion?: "open" | "private";
-    }): Promise<{ ref?: string; rejected?: string }>;
-    on(event: string, fn: (payload: unknown) => void): void;
-  };
-  senses: {
-    set(
-      key: string,
-      sense: {
-        text: string;
-        discretion?: "open" | "private";
-        ttlMinutes?: number;
-      },
-    ): Promise<void>;
-    clear(key?: string): Promise<void>;
-  };
-  knowledge: {
-    offer(doc: {
-      title: string;
-      text: string;
-      url?: string;
-    }): Promise<{ id: string }>;
-  };
-  activities: {
-    handle(
-      kind: string,
-      prepare: (input: unknown) => Promise<unknown>,
-    ): Promise<void>;
-    setAvailable(kind: string, reason?: string): Promise<void>;
-  };
-  actions: {
-    handle(
-      name: string,
-      run: (input: unknown) => Promise<unknown>,
-    ): Promise<void>;
-  };
-  perceive: {
-    handle(
-      type: string,
-      run: (input: unknown) => Promise<{ text?: string }>,
-    ): Promise<void>;
-  };
-  channel: {
-    provide(type: string, impl: Record<string, unknown>): Promise<void>;
-    receive(type: string, message: Record<string, unknown>): Promise<void>;
-    status(type: string, status: { online?: boolean }): Promise<void>;
-    reachable(type: string, sessionKey: string, ok: boolean): Promise<void>;
-  };
-  models: { call(req: { system: string; input: unknown }): Promise<unknown> };
-  http: {
-    route(
-      method: string,
-      path: string,
-      handler: (input: unknown) => Promise<unknown>,
-    ): Promise<void>;
-    hook(
-      method: string,
-      path: string,
-      handler: (input: unknown) => Promise<unknown>,
-    ): Promise<void>;
-  };
-  status: {
-    set(status: {
-      text: string;
-      tone?: "ok" | "warn" | "error";
-    }): Promise<void>;
-  };
-  notify(notice: { title: string; text: string }): Promise<void>;
-}
-
-export interface LuckyTriPlugin {
-  activate(ctx: PluginContext): void | Promise<void>;
-  deactivate?(): void | Promise<void>;
-}
+// LuckyTri Plugin API v1. A later API can be added beside this one;
+// v1 stays available through the 1.x line.
+
+export interface PluginManifest {
+  id: string;
+  name: string;
+  version: string;
+  pluginApi: "1.0";
+  luckytri?: string;
+  description?: string;
+  author?: string;
+  license?: string;
+  entry?: string;
+  permissions?: string[];
+  network?: string[];
+  settings?: PluginSetting[];
+  contributes?: PluginContributes;
+}
+
+export interface PluginSetting {
+  key: string;
+  type:
+    "text" | "secret" | "number" | "boolean" | "select" | "textarea" | "urls";
+  label: string;
+  required?: boolean;
+  default?: unknown;
+  allowNetwork?: boolean;
+}
+
+export interface PluginContributes {
+  senses?: string[];
+  channels?: {
+    type: string;
+    label?: string;
+    capabilities?: Record<string, boolean>;
+  }[];
+  activities?: {
+    kind: string;
+    label?: string;
+    describe?: string;
+    keywords?: string;
+    minutes?: number;
+    energy?: boolean;
+  }[];
+  actions?: {
+    name: string;
+    label?: string;
+    describe?: string;
+    risk?: "low" | "high";
+    confirm?: "none" | "owner";
+    where?: "private" | "any";
+    dailyLimit?: number;
+  }[];
+  perceive?: string[];
+  ui?: { page?: boolean };
+}
+
+export interface PluginContext {
+  plugin: { id: string; version: string; dataDir: string };
+  api: { version: "1.0"; has(feature: string): boolean };
+  now(): Promise<number>;
+  log: {
+    info(...parts: unknown[]): Promise<void>;
+    warn(...parts: unknown[]): Promise<void>;
+    error(...parts: unknown[]): Promise<void>;
+  };
+  settings: {
+    get(): Promise<Record<string, unknown>>;
+    onChange(fn: () => void): void;
+  };
+  storage: {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string): Promise<string[]>;
+  };
+  net: { fetch(url: string, init?: RequestInit): Promise<Response> };
+  mind: {
+    state(): Promise<Record<string, unknown>>;
+    observe(input: {
+      summary: string;
+      detail?: string;
+      discretion?: "open" | "private";
+    }): Promise<{ ref?: string; rejected?: string }>;
+    on(event: string, fn: (payload: unknown) => void): void;
+  };
+  senses: {
+    set(
+      key: string,
+      sense: {
+        text: string;
+        discretion?: "open" | "private";
+        ttlMinutes?: number;
+      },
+    ): Promise<void>;
+    clear(key?: string): Promise<void>;
+  };
+  knowledge: {
+    offer(doc: {
+      title: string;
+      text: string;
+      url?: string;
+    }): Promise<{ id: string }>;
+  };
+  activities: {
+    handle(
+      kind: string,
+      prepare: (input: unknown) => Promise<unknown>,
+    ): Promise<void>;
+    setAvailable(kind: string, reason?: string): Promise<void>;
+  };
+  actions: {
+    handle(
+      name: string,
+      run: (input: unknown) => Promise<unknown>,
+    ): Promise<void>;
+  };
+  perceive: {
+    handle(
+      type: string,
+      run: (input: unknown) => Promise<{ text?: string }>,
+    ): Promise<void>;
+  };
+  channel: {
+    provide(type: string, impl: Record<string, unknown>): Promise<void>;
+    receive(type: string, message: Record<string, unknown>): Promise<void>;
+    status(type: string, status: { online?: boolean }): Promise<void>;
+    reachable(type: string, sessionKey: string, ok: boolean): Promise<void>;
+  };
+  models: { call(req: { system: string; input: unknown }): Promise<unknown> };
+  http: {
+    route(
+      method: string,
+      path: string,
+      handler: (input: unknown) => Promise<unknown>,
+    ): Promise<void>;
+    hook(
+      method: string,
+      path: string,
+      handler: (input: unknown) => Promise<unknown>,
+    ): Promise<void>;
+  };
+  status: {
+    set(status: {
+      text: string;
+      tone?: "ok" | "warn" | "error";
+    }): Promise<void>;
+  };
+  notify(notice: { title: string; text: string }): Promise<void>;
+}
+
+export interface LuckyTriPlugin {
+  activate(ctx: PluginContext): void | Promise<void>;
+  deactivate?(): void | Promise<void>;
+}