ezllm 0.0.38 → 0.0.40

package/README.md

@@ -21,7 +21,7 @@
 - **订阅插件**：接社区 OpenCode 插件（订阅账号当供应商用：CodeBuddy、智谱 Coding Plan 等），插件目录与开关在管理台「插件」页维护
 - **管理界面**：供应商管理、连通性测试、用量统计、请求日志，开箱即用零学习成本
 - **配置即文件**：所有功能设置（供应商、路由、密钥、端口、界面与安全）集中在一个可读的 `ezllm.config.json`（应用目录内）——管理界面就是它的编辑器，改动内存热更新、无需重启；CLI 只管进程生命周期，没有散落在命令行的隐藏开关。配置可备份、可整份迁移，排障时直接看文件即可
-- **开机自启**：三平台支持，登录即启动，免管理员权限。**默认不注册**——自启是显式动作：装的时候加 `--autostart`，或装完后在管理台设置页打开
+- **开机自启**：三平台支持，登录即启动，免管理员权限。**默认注册**——`npx ezllm install` 装完即随登录自启，装完再嫌多余就在管理台设置页关掉；不想注册则装的时候加 `--no-autostart`
 - **自动更新**（手动触发）：管理台发现新版本只**提示**，不代你应用——在终端执行 `npx ezllm update` 完成升级；安装失败或安装后版本与目标不符时**不自动回退**——清掉待更新标记、把原因记入 `lastApply.error`，服务以旧版本继续运行（日志里会给出回退用的命令）
 
 ## 安装
@@ -52,7 +52,7 @@ npx ezllm install    # 装配到用户目录下的 ~/.ezllm（幂等；装完自
 | `--node-mirror=<url>` | `ELLM_NODE_MIRROR` | 引导期：托管 Node 的下载镜像（目录结构需同 nodejs.org/dist） |
 | `--node-bin=<路径>` | `ELLM_NODE_BIN` | 引导期：跳过下载与解压，直接指定 node 可执行文件 |
 
-例：装到别处 —— `npx ezllm install --app-dir=D:\work\ezllm`；换端口并顺便开机自启 —— `npx ezllm install --port=3001 --autostart`。
+例：装到别处 —— `npx ezllm install --app-dir=D:\work\ezllm`；换端口 —— `npx ezllm install --port=3001`；不想注册开机自启 —— `npx ezllm install --no-autostart`。
 
 **端口怎么改**：`--port` 会把端口写进配置文件（配置是唯一数据源），所以在跑着的实例上改端口需要重启主进程——`npx ezllm start --port=3001` 会自动先停再起，之后所有命令（含状态显示）看到的都是新端口。也可以直接编辑配置文件里的 `port` 再 `npx ezllm restart`。（`--port` 只对 `start` / `install` 生效；`restart --port=…` 这类用法会被忽略并提示。另外：shell 里长期导出 `ELLM_PORT` 会在每次 `start` / `install` 时被写进配置文件——要长期以配置管理端口，请勿在 shell 里长期导出它。）
 
@@ -81,16 +81,16 @@ npx ezllm install    # 装配/修复运行环境（幂等）
 npx ezllm uninstall  # 卸载（停服 → 注销自启 → 备份应用目录 → 删除它）
 ```
 
-**升级**：在终端执行 `npx ezllm update`——查最新版本并装配（由新版本自己完成装配，装配逻辑单点复用）。管理台「服务与更新」页只提示「有新版本」，不代你应用。
+**升级**：在终端执行 `npx ezllm update`——查最新版本并装配（由新版本自己完成装配，装配逻辑单点复用）。**只替换程序产物**：配置、日志、运行数据与插件登录态都不动（更新不带 `--force`，无清空动作）。管理台「服务与更新」页只提示「有新版本」，不代你应用。
 
 **卸载**：`npx ezllm uninstall`——停服 → 注销开机自启 → 备份应用目录 → 删除应用目录（配置与数据先备份到同级的 `<应用目录>.backup-<时间戳>`）；**不再注销 PATH**（新版本来就不写它），只有旧版本留下的 PATH 条目才需要你手工清理。
 
-环境坏掉时要「推倒重来」，加 `--force` 重装：它会先停服务、清空应用目录（清理日志与数据、
-重置运行时记录），再重新装配。**保留** `ezllm.config.json` 与 `hook.*` 用户钩子，
-故配置与自写逻辑不丢：
+环境坏掉时要「推倒重来」，加 `--force` 重装：它会先停服务、清空应用目录里的**程序产物与运行时记录**，
+再重新装配。**保留** `ezllm.config.json`、`services.json`、`hook.*` 用户钩子、`data/`（日志库与运行数据）、
+`logs/`、`plugin-auth.json`（插件登录态）与托管 `node/`——配置、数据与日志都不丢：
 
 ```bash
-npx ezllm install --force   # 重装（清理应用目录后重新装配）
+npx ezllm install --force   # 重装（清空程序产物后重新装配）
 ```
 
 ## 应用目录里有什么