openclaw-agent-dashboard 1.0.21 → 1.0.23

package/design_manifest.md

@@ -1,100 +0,0 @@
-# Design Manifest - VERSION_DISPLAY
-
-> **项目名称**: OpenClaw Agent Dashboard  
-> **特性标识**: VERSION_DISPLAY  
-> **编写日期**: 2026-03-19  
-> **编写人员**: 架构师 (SA)  
-> **项目模式**: 增量开发（Incremental Mode）
-
----
-
-## 需求到设计的映射表
-
-| Requirement ID | Target File (Planned) | Change Intent | Allowed Symbols |
-|----------------|----------------------|---------------|-----------------|
-| [REQ_VERSION_DISPLAY_001] | src/backend/data/version_info_reader.py | CREATE | VersionInfoReader class, readVersionInfo(), _readBuildDate(), _readGitCommit() |
-| [REQ_VERSION_DISPLAY_001] | src/backend/api/version.py | CREATE | router, VersionInfo(BaseModel), get_version_info() |
-| [REQ_VERSION_DISPLAY_001] | src/backend/main.py | MODIFY | app.include_router(version_router) |
-| [REQ_VERSION_DISPLAY_002] | frontend/src/components/common/VersionDisplay.vue | CREATE | VersionDisplay component, setup(), fetchVersionInfo() |
-| [REQ_VERSION_DISPLAY_002] | frontend/src/composables/useVersionInfo.ts | CREATE (OPTIONAL) | useVersionInfo() |
-| [REQ_VERSION_DISPLAY_002] | frontend/src/App.vue | MODIFY | import VersionDisplay, <VersionDisplay /> |
-| [REQ_VERSION_DISPLAY_003] | frontend/src/managers/StateManager.ts | MODIFY | versionInfo field, setVersionInfo(), getVersionInfo() |
-| [REQ_VERSION_DISPLAY_003] | frontend/src/managers/RealtimeDataManager.ts | MODIFY | loadVersionInfo(), getVersionInfo() |
-| [REQ_VERSION_DISPLAY_004] | src/backend/data/version_info_reader.py | MODIFY | 环境变量读取逻辑 (DASHBOARD_VERSION, DASHBOARD_BUILD_DATE, DASHBOARD_GIT_COMMIT) |
-| [REQ_VERSION_DISPLAY_004] | scripts/build-plugin.js | MODIFY (OPTIONAL) | 构建时间注入逻辑 |
-
----
-
-## 变更类型统计
-
-- **CREATE（新增文件）**: 4 个
-- **MODIFY（修改文件）**: 4 个
-
-## 文件清单
-
-### 新增文件（4个）
-1. `src/backend/data/version_info_reader.py` - 版本信息读取器
-2. `src/backend/api/version.py` - 版本信息 API 路由
-3. `frontend/src/components/common/VersionDisplay.vue` - 版本显示组件
-4. `frontend/src/composables/useVersionInfo.ts` - 版本信息组合式函数（可选）
-
-### 修改文件（4个）
-1. `src/backend/main.py` - 注册版本信息路由
-2. `frontend/src/App.vue` - 集成版本显示组件
-3. `frontend/src/managers/StateManager.ts` - 新增版本信息状态缓存
-4. `frontend/src/managers/RealtimeDataManager.ts` - 新增版本信息加载逻辑
-
----
-
-## 优先级说明
-
-### P0（必须实现）
-- [REQ_VERSION_DISPLAY_001]: 后端版本信息 API
-- [REQ_VERSION_DISPLAY_002]: 前端版本信息组件
-
-### P1（建议实现）
-- [REQ_VERSION_DISPLAY_003]: 实时数据管理器集成
-
-### P2（可选优化）
-- [REQ_VERSION_DISPLAY_004]: 版本信息配置（环境变量支持）
-- `frontend/src/composables/useVersionInfo.ts`: 组合式函数（可选，取决于是否需要复用逻辑）
-
----
-
-## 实施检查清单
-
-### 阶段 1: 后端 API 实现
-- [ ] 创建 `src/backend/data/version_info_reader.py`
-- [ ] 创建 `src/backend/api/version.py`
-- [ ] 修改 `src/backend/main.py` 注册路由
-- [ ] 单元测试：验证 API 返回正确的版本信息
-
-### 阶段 2: 前端组件实现
-- [ ] 创建 `frontend/src/components/common/VersionDisplay.vue`
-- [ ] 修改 `frontend/src/App.vue` 集成组件
-- [ ] 本地测试：验证组件渲染和版本号显示
-
-### 阶段 3: 实时数据管理集成
-- [ ] 修改 `frontend/src/managers/StateManager.ts` 新增状态缓存
-- [ ] 修改 `frontend/src/managers/RealtimeDataManager.ts` 实现自动加载
-- [ ] 集成测试：验证应用启动时自动加载
-
-### 阶段 4: 配置和构建优化（可选）
-- [ ] 修改 `scripts/build-plugin.js` 确保版本信息正确注入
-- [ ] 测试环境变量覆盖功能
-- [ ] 端到端测试：验证从构建到部署的完整流程
-
----
-
-## 设计文档交叉引用
-
-本 manifest 与以下设计文档配套使用：
-- **设计文档**: `.staging/design/VERSION_DISPLAY_design.md`
-- **需求文档**: `docs/specs/VERSION_DISPLAY_spec.md`
-- **存量代码解剖**: `.staging/legacy_code_anatomy.md`
-
----
-
-**文档版本**: 1.0.0  
-**最后更新**: 2026-03-19  
-**审核状态**: 待审核

package/docs/CHANGELOG_AGENT_MODIFICATIONS.md

@@ -1,132 +0,0 @@
-# OpenClaw Agent Dashboard — 修改点汇总
-
-本文档汇总近期对 **openclaw-agent-dashboard** 工程的修改，便于他人评审与追溯。  
-修改范围：TPM/RPM 统计、连接状态、Windows 启动、调试能力及文档。
-
----
-
-## 一、TPM 趋势无值 / 多接口 usage 兼容
-
-### 问题
-- 性能监控中 **TPM 趋势** 一直为 0，RPM 趋势有值。
-- 原因：TPM 仅依赖 `usage.totalTokens`，而不同大模型/网关返回的 usage 格式不一（如 `input`/`output`、`input_tokens`/`output_tokens` 等），或上游未写入 totalTokens 导致为 0。
-
-### 修改策略
-- **不再枚举字段名**：采用两段逻辑——
-  1. 若有明确总量字段（`totalTokens` / `total_tokens` / `total`）且 > 0，直接使用；
-  2. 否则对 `usage` 内**所有数值**求和作为总 token 数，兼容任意命名。
-- 避免对同一用量重复计算：有总量时只返回总量，不再参与求和。
-
-### 涉及文件
-| 文件 | 修改内容 |
-|------|----------|
-| `plugin/dashboard/api/performance.py` | `_tokens_from_usage()` 重写；新增 `GET /api/performance/debug-usage` 调试接口 |
-| `src/backend/api/performance.py` | 同上（与 plugin 保持一致的逻辑与调试接口） |
-| `plugin/dashboard/performance.py` | `_tokens_from_usage()` 与 plugin api 一致 |
-| `src/backend/performance.py` | 同上 |
-
-### 调试接口
-- **GET** `/api/performance/debug-usage?limit=5`
-- 返回：`openclaw_path`、`agents_path_exists`、`samples[]`（含 `usage_raw`、`tokens_computed`）。
-- 用于确认 session 中实际 usage 结构及 TPM 为 0 是否因上游未写入 token 数。
-
-### 说明
-- 若 session 中 `usage` 各字段均为 0（如部分 vLLM/本地模型未回传 token），TPM 仍会为 0，需在**写 session 的上游**（OpenClaw/网关/模型适配层）补齐 usage 写入。
-
----
-
-## 二、右上角「连接错误」与 WebSocket 回退
-
-### 问题
-- Dashboard 右上角连接状态显示「连接错误」。
-- 原因：WebSocket `ws://localhost:38271/ws` 连接失败或建立后因发送初始状态异常而断开；前端未及时进入 HTTP 轮询。
-
-### 后端修改
-- **发送初始状态失败时**：捕获异常后仍发送最小 `full_state` payload（空列表/空对象），保持连接不因异常关闭。
-- **心跳协议**：同时支持纯文本 `ping` 与 JSON `{"type":"ping",...}`，并统一以 JSON 回复 `{"type":"pong",...}`，与前端一致。
-
-### 前端修改
-- **WebSocket onerror**：除设置状态为 error 外，调用 `handleDisconnect()`，进入重连或 HTTP 轮询，避免一直停在「连接错误」。
-- **重连次数**：默认由 5 次改为 3 次，更快 fallback 到 HTTP 轮询。
-
-### 涉及文件
-| 文件 | 修改内容 |
-|------|----------|
-| `plugin/dashboard/api/websocket.py` | 初始状态异常时发最小 payload；心跳支持 JSON ping/pong |
-| `src/backend/api/websocket.py` | 同上 |
-| `frontend/src/managers/RealtimeDataManager.ts` | onerror 时调用 handleDisconnect()；reconnectMaxAttempts 默认 3 |
-
----
-
-## 三、Windows 下 `npm run start` 报错
-
-### 问题
-- 在 Windows PowerShell 执行 `npm run start` 报错：`'OPENCLAW_HOME' 不是内部或外部命令`。
-- 原因：`package.json` 的 start 脚本使用 Linux/Mac 环境变量语法（`OPENCLAW_HOME=${OPENCLAW_HOME:-$HOME/.openclaw} ...`），在 Windows CMD 下无法解析。
-
-### 修改
-- 新增 **Node 跨平台启动脚本** `scripts/start.js`：
-  - 根据 `OPENCLAW_HOME`、`DASHBOARD_PORT` 环境变量或默认值设置；
-  - Windows 使用 `python`，非 Windows 使用 `python3`；
-  - 在 `src/backend` 目录下执行 `uvicorn main:app --host 0.0.0.0 --port <port>`。
-- **package.json**：`start` 脚本改为 `node scripts/start.js`。
-
-### 涉及文件
-| 文件 | 修改内容 |
-|------|----------|
-| `scripts/start.js` | 新增，跨平台启动 Dashboard 后端 |
-| `package.json` | `"start": "node scripts/start.js"` |
-
-### 说明
-- 不影响 Ubuntu/Debian 等 Linux 行为；若已设置 `OPENCLAW_HOME`、`DASHBOARD_PORT`，仍会生效。
-
----
-
-## 四、文档与运维
-
-### 新增/更新文档
-| 文件 | 用途 |
-|------|------|
-| `RESTART_AND_BUILD.md` | 重启服务、是否需重新打包、一条龙命令（含 Windows PowerShell）；插件部署与独立运行两种方式 |
-| `docs/CHANGELOG_AGENT_MODIFICATIONS.md` | 本修改汇总文档，供他人评审 |
-
----
-
-## 五、修改文件清单（便于 diff / code review）
-
-```
-openclaw-agent-dashboard-main/
-├── package.json                              # start 改为 node scripts/start.js
-├── RESTART_AND_BUILD.md                      # 新增：重启与打包说明
-├── scripts/
-│   └── start.js                              # 新增：跨平台启动脚本
-├── docs/
-│   └── CHANGELOG_AGENT_MODIFICATIONS.md      # 本文件
-├── frontend/src/managers/
-│   └── RealtimeDataManager.ts               # WebSocket 失败回退与重连次数
-├── plugin/dashboard/api/
-│   ├── performance.py                       # _tokens_from_usage + debug-usage
-│   └── websocket.py                          # 初始状态容错 + JSON 心跳
-├── plugin/dashboard/
-│   └── performance.py                        # _tokens_from_usage 与 api 一致
-├── src/backend/api/
-│   ├── performance.py                       # 同 plugin/dashboard/api/performance
-│   └── websocket.py                          # 同 plugin/dashboard/api/websocket
-└── src/backend/
-    └── performance.py                        # _tokens_from_usage 与 api 一致
-```
-
----
-
-## 六、建议评审关注点
-
-1. **TPM 逻辑**：`_tokens_from_usage` 先取总量、再对 usage 全数值求和的策略是否满足业务（有无误把非 token 数字加进去的风险）。
-2. **WebSocket**：初始状态失败时发最小 payload 是否与前端约定一致；JSON ping/pong 与现有客户端兼容性。
-3. **前端**：onerror 时立即 handleDisconnect 与 onclose 的重复调用是否会导致双重重连定时器（当前实现中 scheduleReconnect 会先 stopReconnect，一般只保留一个定时器）。
-4. **Windows 启动**：`scripts/start.js` 中 `OPENCLAW_HOME` 默认路径、`python`/`python3` 选择在目标环境是否均可用。
-
----
-
-**文档版本**：v1.0  
-**整理日期**：2026-03-13  
-**工程**：openclaw-agent-dashboard（含 plugin 与 src/backend 两套路径）

package/docs/MAINTAINER_RELEASE_WORKFLOW.md

@@ -1,211 +0,0 @@
-# 维护者全量发布流程
-
-从「新增功能」到 **npm 发布**、**Git 推送与 GitHub Release**、**本机与其他环境更新插件** 的完整操作清单（与当前仓库结构一致：`plugin/` 为 npm 发布根、`npm run publish:npm`、推送 `v*` 标签触发 Release）。
-
----
-
-## 一、开发阶段
-
-1. 在仓库内修改代码（`frontend/`、`src/backend/`、`plugin/index.js` 等）。
-2. 本地验证：
-   ```bash
-   npm run pack
-   ```
-   必要时使用 `npm run deploy` 装到本机 OpenClaw 做联调，并重启 Gateway 验证行为。
-
----
-
-## 二、发版前：统一版本号
-
-新版本号在三处保持一致（示例 `1.0.18`）：
-
-| 文件 | 字段 |
-|------|------|
-| `plugin/package.json` | `"version"` |
-| `plugin/openclaw.plugin.json` | `"version"` |
-| 根目录 `package.json` | `"version"`（与上保持一致，便于对照） |
-
-> GitHub Actions 中 Release 使用的版本来自 **`plugin/openclaw.plugin.json`**。Git 标签建议使用 **`v` + 该版本号**（如 `v1.0.18`），与 CI 一致。
-
----
-
-## 三、打包自检（发布前必跑）
-
-```bash
-cd /path/to/openclaw-agent-dashboard
-npm run pack
-```
-
-确认无报错。`plugin/dashboard`、`plugin/frontend-dist`、`plugin/scripts` 由 `build-plugin.js` 生成；`plugin/scripts/` 已在 `.gitignore` 中，无需提交。
-
----
-
-## 四、发布到 npm
-
-用户执行 `openclaw plugins install openclaw-agent-dashboard@…` 时，会从 **npm 公共仓库** 拉取已发布的包。
-
-```bash
-npm login    # 若尚未登录
-npm run publish:npm
-```
-
-等价于：先执行 `pack`，再 `npm publish --prefix plugin`。
-
-发布后自检：
-
-```bash
-npm view openclaw-agent-dashboard version
-```
-
----
-
-## 五、Git：推送代码 + 打标签（触发 GitHub Release）
-
-```bash
-git add -A
-git commit -m "feat: 功能说明（v1.0.18）"
-git push origin main
-
-git tag -a v1.0.18 -m "Release 1.0.18"
-git push origin v1.0.18
-```
-
-- **`main`**：保存源码与文档。
-- **`v1.0.18`**：推送后触发 `.github/workflows/release.yml`，构建并上传 **GitHub Release** 及 `openclaw-agent-dashboard-v*.tgz`（以仓库内 workflow 为准）。
-
-在 GitHub **Actions** 中确认 Release 工作流成功结束。
-
----
-
-## 六、本机 / 服务器：更新已安装的插件
-
-插件已通过 **npm** 安装到 `~/.openclaw/extensions/openclaw-agent-dashboard` 时，推荐：
-
-```bash
-openclaw plugins update openclaw-agent-dashboard
-# 若 CLI 支持更新全部 npm 插件：
-# openclaw plugins update --all
-```
-
-然后重启 Gateway：
-
-```bash
-openclaw gateway restart
-```
-
-若 **`requirements.txt` 有变更**，在扩展目录下再执行一次 Python 依赖安装：
-
-```bash
-PLUGIN="$HOME/.openclaw/extensions/openclaw-agent-dashboard"
-node "$PLUGIN/scripts/install-python-deps.js" "$PLUGIN"
-```
-
-**Windows（PowerShell）**：
-
-```powershell
-$plugin = "$env:USERPROFILE\.openclaw\extensions\openclaw-agent-dashboard"
-node "$plugin\scripts\install-python-deps.js" $plugin
-```
-
-> **不要用** `openclaw plugins install …@latest` **代替**「升级」：已安装时可能被判定为全新安装且目录已存在而失败。升级以 `plugins update` 为准；若 CLI 不支持，再查阅 `openclaw plugins --help` 或 README「迁移 / 升级」章节。
-
----
-
-## 七、一页顺序（速查）
-
-```
-改代码
-→ 三处版本号 +1
-→ npm run pack
-→ npm run publish:npm
-→ git commit & push main
-→ git tag vX.Y.Z && git push origin vX.Y.Z
-→ 确认 GitHub Actions Release 成功
-→ 本机：plugins update + gateway restart +（必要时）install-python-deps
-```
-
----
-
-## 八、其他环境下的安装与升级
-
-- 在 **npm 已发布新版本** 之后，在其他机器上执行：
-  ```bash
-  openclaw plugins update openclaw-agent-dashboard
-  ```
-  或指定版本：
-  ```bash
-  openclaw plugins install openclaw-agent-dashboard@1.0.18
-  ```
-  然后重启 Gateway；依赖有变时同样执行 `install-python-deps.js`。
-- **从 path 安装迁到 npm**、或出现 `plugin already exists` 时，见仓库根目录 **README**「从 path / 旧版安装迁移到 npm」。
-
----
-
-## 九、Windows 下怎么处理
-
-开发与发布命令（`npm run pack`、`npm run publish:npm`、`git`、`openclaw`）在 **PowerShell** 或 **CMD** 中与 macOS/Linux **相同**，注意路径与删除方式即可。
-
-### 9.1 环境
-
-- 安装 [Node.js LTS](https://nodejs.org/)，并确保 `node`、`npm` 在 PATH。
-- 安装 [Python 3](https://www.python.org/downloads/)，勾选 **Add python.exe to PATH**。
-- 安装 [Git for Windows](https://git-scm.com/download/win)，使用自带的 **Git Bash** 或系统里的 `git`。
-- 全局安装 OpenClaw：`npm install -g openclaw`（保证 `openclaw` 在 PATH）。
-
-### 9.2 插件目录位置
-
-扩展目录一般为：
-
-```text
-%USERPROFILE%\.openclaw\extensions\openclaw-agent-dashboard
-```
-
-PowerShell 中：
-
-```powershell
-$plugin = "$env:USERPROFILE\.openclaw\extensions\openclaw-agent-dashboard"
-```
-
-### 9.3 安装 / 升级插件（与其他平台一致）
-
-```powershell
-openclaw plugins install openclaw-agent-dashboard@latest
-# 或
-openclaw plugins update openclaw-agent-dashboard
-
-openclaw gateway restart
-```
-
-### 9.4 Python 依赖（venv 在 `dashboard\.venv`）
-
-```powershell
-$plugin = "$env:USERPROFILE\.openclaw\extensions\openclaw-agent-dashboard"
-node "$plugin\scripts\install-python-deps.js" $plugin --verbose
-```
-
-### 9.5 迁移时出现 `plugin already exists`（删扩展目录）
-
-**PowerShell：**
-
-```powershell
-openclaw plugins uninstall openclaw-agent-dashboard --force
-Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw\extensions\openclaw-agent-dashboard"
-openclaw plugins install openclaw-agent-dashboard@latest
-```
-
-### 9.6 仓库内 `npm run deploy` / `npm run pack`
-
-在仓库根目录打开 PowerShell，`cd` 到项目路径后执行即可；**不要依赖 bash** 即可完成打包与发布。
-
-- **`npm run bundle`** 若调用 `bash scripts/bundle.sh`，在 Windows 上可改用 **Git Bash** 执行，或仅用 `npm run pack` + `publish:npm`，由 **GitHub Actions** 生成 Release 压缩包。
-
-### 9.7 可选：WSL
-
-在 **WSL2（Ubuntu 等）** 里开发时，路径与 Linux 文档一致（`~/.openclaw/...`）；注意 WSL 与 Windows 两套 OpenClaw 配置**不共用**同一 `~`，按你实际运行 Gateway 的环境选择一套即可。
-
----
-
-## 十、相关文档
-
-- 用户安装与迁移：**[README.md](../README.md)**
-- 历史发布说明：**[release-guide.md](./release-guide.md)**（若与本文冲突，以本文与当前 `package.json` / workflow 为准）

package/docs/Openclaw-Agent-Dashboard/345/217/221/345/270/203/344/270/216/346/233/264/346/226/260.md

@@ -1,147 +0,0 @@
-# 维护者全量发布流程
-
-从「新增功能」到 **npm 发布**、**Git 推送与 GitHub Release**、**本机与其他环境更新插件** 的完整操作清单（与当前仓库结构一致：`plugin/` 为 npm 发布根、`npm run publish:npm`、推送 `v*` 标签触发 Release）。
-
----
-
-## 一、开发阶段
-
-1. 在仓库内修改代码（`frontend/`、`src/backend/`、`plugin/index.js` 等）。
-2. 本地验证：
-   ```bash
-   npm run pack
-   ```
-   必要时使用 `npm run deploy` 装到本机 OpenClaw 做联调，并重启 Gateway 验证行为。
-
----
-
-## 二、发版前：统一版本号
-
-新版本号在三处保持一致（示例 `1.0.18`）：
-
-| 文件 | 字段 |
-|------|------|
-| `plugin/package.json` | `"version"` |
-| `plugin/openclaw.plugin.json` | `"version"` |
-| 根目录 `package.json` | `"version"`（与上保持一致，便于对照） |
-
-> GitHub Actions 中 Release 使用的版本来自 **`plugin/openclaw.plugin.json`**。Git 标签建议使用 **`v` + 该版本号**（如 `v1.0.18`），与 CI 一致。
-
----
-
-## 三、打包自检（发布前必跑）
-
-```bash
-cd /path/to/openclaw-agent-dashboard
-npm run pack
-```
-
-确认无报错。`plugin/dashboard`、`plugin/frontend-dist`、`plugin/scripts` 由 `build-plugin.js` 生成；`plugin/scripts/` 已在 `.gitignore` 中，无需提交。
-
----
-
-## 四、发布到 npm
-
-用户执行 `openclaw plugins install openclaw-agent-dashboard@…` 时，会从 **npm 公共仓库** 拉取已发布的包。
-
-```bash
-npm login    # 若尚未登录
-npm run publish:npm
-```
-
-等价于：先执行 `pack`，再 `npm publish --prefix plugin`。
-
-发布后自检：
-
-```bash
-npm view openclaw-agent-dashboard version
-```
-
----
-
-## 五、Git：推送代码 + 打标签（触发 GitHub Release）
-
-```bash
-git add -A
-git commit -m "feat: 功能说明（v1.0.18）"
-git push origin main
-
-git tag -a v1.0.18 -m "Release 1.0.18"
-git push origin v1.0.18
-```
-
-- **`main`**：保存源码与文档。
-- **`v1.0.18`**：推送后触发 `.github/workflows/release.yml`，构建并上传 **GitHub Release** 及 `openclaw-agent-dashboard-v*.tgz`（以仓库内 workflow 为准）。
-
-在 GitHub **Actions** 中确认 Release 工作流成功结束。
-
----
-
-## 六、本机 / 服务器：更新已安装的插件
-
-插件已通过 **npm** 安装到 `~/.openclaw/extensions/openclaw-agent-dashboard` 时，推荐：
-
-```bash
-openclaw plugins update openclaw-agent-dashboard
-# 若 CLI 支持更新全部 npm 插件：
-# openclaw plugins update --all
-```
-
-然后重启 Gateway：
-
-```bash
-openclaw gateway restart
-```
-
-若 **`requirements.txt` 有变更**，在扩展目录下再执行一次 Python 依赖安装：
-
-```bash
-PLUGIN="$HOME/.openclaw/extensions/openclaw-agent-dashboard"
-node "$PLUGIN/scripts/install-python-deps.js" "$PLUGIN"
-```
-
-**Windows（PowerShell）**：
-
-```powershell
-$plugin = "$env:USERPROFILE\.openclaw\extensions\openclaw-agent-dashboard"
-node "$plugin\scripts\install-python-deps.js" $plugin
-```
-
-> **不要用** `openclaw plugins install …@latest` **代替**「升级」：已安装时可能被判定为全新安装且目录已存在而失败。升级以 `plugins update` 为准；若 CLI 不支持，再查阅 `openclaw plugins --help` 或 README「迁移 / 升级」章节。
-
----
-
-## 七、一页顺序（速查）
-
-```
-改代码
-→ 三处版本号 +1
-→ npm run pack
-→ npm run publish:npm
-→ git commit & push main
-→ git tag vX.Y.Z && git push origin vX.Y.Z
-→ 确认 GitHub Actions Release 成功
-→ 本机：plugins update + gateway restart +（必要时）install-python-deps
-```
-
----
-
-## 八、其他环境下的安装与升级
-
-- 在 **npm 已发布新版本** 之后，在其他机器上执行：
-  ```bash
-  openclaw plugins update openclaw-agent-dashboard
-  ```
-  或指定版本：
-  ```bash
-  openclaw plugins install openclaw-agent-dashboard@1.0.18
-  ```
-  然后重启 Gateway；依赖有变时同样执行 `install-python-deps.js`。
-- **从 path 安装迁到 npm**、或出现 `plugin already exists` 时，见仓库根目录 **README**「从 path / 旧版安装迁移到 npm」。
-
----
-
-## 九、相关文档
-
-- 用户安装与迁移：**[README.md](../README.md)**
-- 历史发布说明：**[release-guide.md](./release-guide.md)**（若与本文冲突，以本文与当前 `package.json` / workflow 为准）