luckytri 1.0.0 → 1.0.2

package/public/tutorial.md

@@ -16,7 +16,7 @@ luckytri
 
 LuckyTri 在后台启动并打开 <http://127.0.0.1:3210>，首次运行自动生成配置。无需下载仓库或构建 WebUI。终端里的 SQLite 实验性提示不表示启动失败，以能否打开 LuckyTri 为准。
 
-运行 `luckytri paths` 查看本机 `.env`，在本机编辑器中取得 `ADMIN_TOKEN` 并填入管理台。`luckytri --no-browser` 只后台启动，`luckytri start` 前台运行，`luckytri stop` 停止服务。更新使用 `luckytri stop` → `npm install -g luckytri@latest` → `luckytri`，配置与数据会保留；默认目录见 [README](../../README.md#配置数据与隐私)。
+首次进入管理台时设置一个密码即可。`luckytri --no-browser` 只后台启动，`luckytri start` 前台运行，`luckytri stop` 停止服务。更新使用 `luckytri stop` → `npm install -g luckytri@latest` → `luckytri`，密码、配置与数据会保留。
 
 从源码开发时，在仓库中执行 `npm install`、`npm run setup`、`npm run build`、`npm start`。下文的 `npm run setup/stop/backup/recovery/plugin` 面向源码用户；全局用户使用对应的 `luckytri setup/stop/backup/recovery/plugin`。
 
@@ -39,35 +39,11 @@ LuckyTri 是「TA 的小世界」，左侧导航分三组、十个入口：
 
 界面的颜色、天空和动效跟着 TA 的心情与作息变化：开心时暖、低落时灰蓝、睡着后变成夜晚。左下角可以把主题固定成某一种，也可以「减少动画」。右下角的小 TA 戳一下会回应一句，按住是摸摸头，双击或点「聊聊」打开试聊；这些只是界面动画，不会改变 TA 的心智。手机上导航在底部，其余入口在「更多」里。
 
-## 2. 本机令牌
+## 2. 设置管理密码
 
-首次启动已生成配置；也可以提前初始化：
+首次打开管理台时设置一个至少 8 个字符的密码，确认后进入。以后用同一个密码登录，不需要打开 `.env` 查找管理令牌。浏览器登录状态会保留；更新和重装不会重置密码。
 
-```powershell
-luckytri setup
-luckytri paths
-```
-
-没有 `.env` 时，setup 会写入管理令牌和 OneBot 连接令牌。已有 `.env` 会原样保留。
-
-```dotenv
-HOST=127.0.0.1
-PORT=3210
-ADMIN_TOKEN=
-ONEBOT_TOKEN=
-LLM_API_KEY=
-```
-
-| 字段                                | 用途                                                            |
-| ----------------------------------- | --------------------------------------------------------------- |
-| `ADMIN_TOKEN`                       | 打开 LuckyTri 和调用 HTTP API；停止命令也会使用                 |
-| `ONEBOT_TOKEN`                      | OneBot 11 接入端连接 `/onebot/v11/ws`（只用 OneBot 方式时需要） |
-| `LLM_API_KEY`                       | 可选；非空时优先于 LuckyTri 里保存的模型密钥                    |
-| `LUCKYTRI_CHANNEL`                  | 可选；`onebot` 或 `qqbot`。设置后在界面里不能更改连接方式       |
-| `QQBOT_APP_ID` / `QQBOT_APP_SECRET` | 可选；QQ 官方机器人的凭据，优先于界面里保存的                   |
-| `HOST` / `PORT`                     | 监听地址和端口；本机使用保持默认                                |
-
-页面第一次取数据时会弹出窗口要求输入 `ADMIN_TOKEN`。令牌只留在当前标签页。修改 `.env` 后必须重启。不要把 `ADMIN_TOKEN` 填给 QQ 接入端，也不要把 `ONEBOT_TOKEN` 当成管理台密码。
+在「系统 → 运行开关」可以修改密码或退出登录。密码只以加盐校验摘要保存，现有环境配置和模型密钥保留。
 
 ## 3. 先在模拟模式试聊
 
@@ -111,20 +87,20 @@ LLM_API_KEY=
 
 LuckyTri 只实现 OneBot 11 的反向 WebSocket 接口，接入端需要你自行准备和管理。
 
-1. 在本机 `.env` 中设置 `ONEBOT_TOKEN`，修改后重启 LuckyTri。
+1. 本机连接无需单独令牌，保留已有的接入地址和 QQ 登录。
 2. 在接入端自己的网络设置里添加 OneBot 11 反向 WebSocket 客户端：
 
-| 项目          | 本机填写                            |
-| ------------- | ----------------------------------- |
-| 协议          | OneBot 11                           |
-| WebSocket URL | `ws://127.0.0.1:3210/onebot/v11/ws` |
-| Token         | `.env` 里的 `ONEBOT_TOKEN`          |
-| 消息格式      | 数组                                |
-| 启用          | 开启并保存                          |
+| 项目          | 本机填写                                           |
+| ------------- | -------------------------------------------------- |
+| 协议          | OneBot 11                                          |
+| WebSocket URL | `ws://127.0.0.1:3210/onebot/v11/ws`                |
+| Token         | 本机无需填写；远程可使用管理密码，旧远程令牌仍兼容 |
+| 消息格式      | 数组                                               |
+| 启用          | 开启并保存                                         |
 
 3. 在接入端完成 QQ 登录。小号需要已加入目标群；LuckyTri 不保存 QQ 密码。
 
-这里的 `3210` 是 LuckyTri 的端口。接入端和 LuckyTri 不在同一台机器或放在容器里时，`127.0.0.1` 指向各自环境，需要改成 LuckyTri 的实际地址，并先配置 `ADMIN_TOKEN`。
+容器或另一台电脑中的 `127.0.0.1` 指向自身。远程接入使用 LuckyTri 的可达地址，并先在本机设置管理密码；对外提供管理台时使用 HTTPS。
 
 ### 方式二：QQ 官方机器人
 
@@ -192,14 +168,24 @@ TA 的一切都存在这一个数据库里，所以服务运行时会自动备
 
 恢复时先停止服务，把当前 `data/friend.db` 及同名 `-wal`、`-shm` 移开，再把选中的备份复制为 `data/friend.db`。设置了 `DB_PATH` 时操作该路径。不要把旧的 WAL 文件和恢复后的数据库放在一起。更稳妥的做法是用 `npm run recovery` 校验并恢复到一个全新的文件，见 `docs/zh/recovery.md`。
 
+### 从管理台导入与导出
+
+「系统 → 数据与备份」提供「导出数据包」和「选择导入文件」。导出的 `.luckytri` 文件包含数据库内的聊天、记忆、关系、个人状态、日记、待办、作品版本、知识文本和设置，也包含保存在设置中的密钥。管理密码和登录会话不随数据包迁移；插件程序、知识库原始文件及本机 `.env` 不在其中。导出读取一致快照，实例可以继续运行，大文件通过流式传输下载。
+
+导入支持 `.luckytri` 数据包及已有 `.db` / SQLite 备份。默认单个文件最多 10 GiB，可用 `.env` 中的 `DATA_TRANSFER_MAX_GB`（1–100）调整。上传后先校验数据包 SHA-256、数据库完整性、引用和结构，旧版本只在暂存副本上升级，界面会显示姓名、版本和记录数量。此时尚未改变当前数据，可以取消。
+
+确认「导入并重启」后，程序停止实例，保留一份完整的 `luckytri-before-import-*.db` 快照，再替换数据并自动重启。本机管理密码、当前登录、QQ 连接配置和备份整理规则保留。导入后的自动回复关闭，插件执行权限重置；检查连接、模型和待办后可重新开启，插件需重新安装或确认权限。导入是替换整份数据，不与当前记录合并；原有快照可在备份列表手动管理，定时清理完整备份不会删除它。
+
+下载完成后删除服务器导出副本；取消、失效或中断的暂存文件会回收，未使用的预览默认一小时失效。导入失败时保留或恢复原数据，不会把不完整的文件交给实例运行。
+
 ## 9. 常见问题
 
 | 现象                      | 先检查                                                                                             |
 | ------------------------- | -------------------------------------------------------------------------------------------------- |
 | 页面打不开                | Node 是否在运行，地址是否为 `127.0.0.1:3210`                                                       |
 | 端口已被占用              | 先 `npm run stop`，不要结束所有 node 进程                                                          |
-| 令牌错误                  | 使用 `ADMIN_TOKEN`；改 `.env` 后重启                                                               |
-| OneBot 未连接             | 接入端是否登录，URL、端口、路径和 `ONEBOT_TOKEN` 是否一致                                          |
+| 密码错误                  | 使用首次设置的管理密码；可在系统运行开关中修改                                                     |
+| OneBot 未连接             | 确认接入端已登录、反向客户端启用、地址端口路径一致；本机无需额外令牌                               |
 | 官方机器人未连接          | AppID 与 AppSecret 是否正确，机器人是否已开通群聊与单聊消息，网络能否访问 QQ 开放平台              |
 | 官方机器人只收到 @ 的消息 | 在开放平台开启「接收所有消息」；这是平台权限，不是 LuckyTri 的限制                                 |
 | 连接成功但没有会话        | 在 QQ 再发一条新消息；OneBot 方式下检查消息格式是否为数组                                          |