docs: align repository names and bilingual entry points; remove obsolete reports

2026-10-18 17:53:43 +08:00
parent ddcf53504f
commit efdff94626
15 changed files with 53 additions and 110 deletions
@@ -1,5 +0,0 @@
-# 树莓派接入插件 v1.2.0
-
-2026-10-14 已部署。主网络卡片主文字改为“有线网络 · 链路速率”；接口/IP/状态与上下行速率独立两行，与群晖 v1.4.0 一致。Wi-Fi 信号与告警语义保留。Agent v3.8.0 提供 rx_bytes_per_second/tx_bytes_per_second，映射到标准历史指标；旧 Agent 缺少数值时不伪造速率，非数值、布尔和非有限值不写入历史。两项指标回归测试通过，核心全页三尺寸、中英文主题浏览器回归通过；真实生产快照额外验证两处网络卡片三尺寸与两语言，桌面截图已查看。
-
-生产实际插件 1.2.0、Agent 3.8.0，两设备在线，树莓派上下行采集与标准历史指标通过认证 API 核验，临时会话删除。停服一致性备份 `/volume1/homes/way/pigway-console-backup-network-align-20261014/data.tar.gz`，目录 0700；旧插件在数据卷 adapter-backups/network-align-20261014。Console 镜像保持原版。
@@ -1,5 +0,0 @@
-# 网络卡片 v1.2.1
-
-2026-10-14 已部署。网络主文字改为下载/上传速率，删除 ETH/有线网络文字；下方保留 eth0、1000 Mbps、IP 和状态，不重复显示速率。两处网络卡片使用一致布局。模拟及真实设备快照三尺寸、中英文浏览器检查通过，无溢出，桌面截图已查看。生产认证 API 确认两设备在线、树莓派实时流量与历史标准指标有效。Agent 保持 v3.8.0，未再次升级。
-
-停服一致性数据备份 /volume1/homes/way/pigway-console-backup-network-rates-layout-20261014/data.tar.gz，目录 0700；旧插件在数据卷 adapter-backups/network-rates-layout-20261014。Console 镜像及 NAS 每日存储采集保持。
@@ -1,5 +0,0 @@
-# 树莓派接入插件 v1.2.2
-
-2026-10-14 网络卡片改为按 network.link 显示已连接/已断开，字段缺失显示状态未确认，与 NAS 的接口连接语义一致。页面不再把 network.internet 用作接口状态文案。Agent 的既有互联网探测和告警逻辑不修改。两项后端测试及全页三尺寸中英文主题浏览器验证通过。部署使用停服一致性数据备份 /volume1/homes/way/pigway-console-backup-synology-vpi-link-v1.2.2-20261014/data.tar.gz，目录 0700；旧树莓派插件保存在数据卷 adapter-backups/vpi-link-v1.2.2/pigway-agent。
-
-生产安装并启用 1.2.2，实际 UI 已使用 network.link 且不存在“互联网正常”文案；认证 API 两设备在线，实时流量和历史指标保留。验证会话删除。Tea ZIP 与 SHA256 附件下载校验一致。
@@ -1,5 +0,0 @@
-# pigway-console-adapter-raspberry-pi v1.3.0
-
-2026-10-15 已与 Console v2.4.0 部署。声明每秒缓存读取并透传 Agent 的 system/network 真实采样时间。树莓派网络仍每 5 秒采样，历史去重验证通过。
-
-生产两设备在线。认证 API 连续观测确认树莓派缓存每秒、网络 5 秒、NAS 实时约 10 秒；最近三个网络 10 秒历史桶各 2 个样本，没有每秒重复入库。Console 保留原名称、证书、存储缓存和一年历史策略。部署详情见 Console [生产记录](https://tea.pigway.com/way/pigway-device-console/src/branch/main/docs/DEPLOYMENT-v2.4.0-2026-10-15.md)。
@@ -1,7 +0,0 @@
-# pigway-console-adapter-raspberry-pi v1.3.2 实测调优
-
-2026-10-15 生产调优结论：统一 4 秒读取 CPU、内存、温度及网络速率。曾试 2 秒，但这台 DSM 的 utilization 实际采样时间通常每 4 秒更新，连续细粒度观察 CPU 时间为 7853/7857/7861/7865 等相差 4 秒的样本；不能把两次相同样本当成更快采样。只读接口测量 System.info 约 0.05–0.07 秒、Utilization.get 约 1.03–1.09 秒，请求耗时与真实样本周期不同。
-
-最终 40 秒连续观测：两设备各 10 个独立实时样本、10 个网络样本，中位间隔均 4 秒；无离线或缺失采集组，缓存 API 最大耗时 0.032 秒（这是 Console 缓存读取，不是 DSM 接口耗时）。Pi 本地 CPU 等继续 1 秒，网络配置已从 5 秒改为 2 秒；Console 每 4 秒读取，覆盖更快缓存。NAS 网络配置 60 秒、存储 24 小时保持。
-
-插件生产版本 Pi 1.3.2、NAS 1.6.1，Console 仍 2.4.0、Agent 仍 3.9.0。3 项 Pi 回归和 14 项 NAS 回归通过。停服一致性数据备份 /volume1/homes/way/pigway-console-backup-balanced-4s-20261015/data.tar.gz，目录 0700；旧插件在数据卷 adapter-backups/balanced-4s-20261015。Pi 原配置备份 /home/way/pigway-timing-backup-20261015.conf，权限 0600。仅保留 Console 原 latest 镜像，没有新增镜像。
@@ -1,7 +0,0 @@
-# v1.3.3 指标语义统一
-
-2026-10-15 已部署。运行状态与历史趋势统一处理器负载、内存占用、磁盘占用及英文名称；主网络英文统一 Primary network，无告警与状态未确认提示一致。缺失百分比显示 --，不显示孤立百分号或假零值进度条。温度、内存可用量/存储剩余量按数据来源保留，不改用户资源名称。
-
-全页、历史五范围和三尺寸中英文主题浏览器验证通过；真实设备公开快照在本地渲染两处卡片，三尺寸两语言名称检查和缺失读数检查通过。生产认证 API 核对 Console 2.4.1、Pi 插件 1.3.3、NAS 插件 1.6.2，两设备在线、原名称保持，4 秒声明不变，验证会话删除。生产实际 UI 和历史名称代码核对通过。
-
-停服一致性备份 /volume1/homes/way/pigway-console-backup-v2.4.1-20261015/{program,data}.tar.gz，目录 0700；旧插件在数据卷 adapter-backups/semantics-v2.4.1。实际镜像 sha256:127d80530abc728add1eb947e304387f7f941f8fa570386d951c6f9ae6eabc0e，仅保留 latest 标签，候选标签与旧镜像清理。没有主动刷新磁盘。Tea 三个 Release 附件下载校验一致。
@@ -1,48 +1,30 @@
-# PIGWay Raspberry Pi Console Plugin
+# PIGWay Raspberry Pi Console Adapter

-磁盘呈现统一版本已上线，需要 Console v2.7.0：默认按设备返回顺序，同组支持上移/下移、显示名称及隐藏，所有显示偏好保存到 Console，首页与配置页共用。Agent 的名称和隐藏定义继续作为设备默认值保留。扫描仍只由配置页按钮触发。生产验证见相邻 Console 的 docs/STORAGE-PRESENTATION-v2.7.0-2026-10-15.md。
+[简体中文](README.zh-CN.md) | English

-当前 v1.6.10 支持统一磁盘显示设置与手动扫描，需要 Console v2.7.0、Agent v3.11.1；新磁盘仅手动发现，已知磁盘容量继续刷新。见 [生产验证](STORAGE-DISCOVERY.md)。
+An independently maintained Device Console adapter for the PIGWay Raspberry Pi Agent. It installs no extra process on the Pi and retains adapter ID `pigway-agent` for existing devices.

-独立维护的树莓派接入插件：连接现有 PIGWay Raspberry Pi Agent，不在树莓派安装新进程。设备 API、状态转换、配置字段、服务/进程监控、硬件界面及其翻译均由本仓库维护。
+## Requirements and installation

-依赖 Python 标准库；接入 Console JSON-RPC v1 与可信前端扩展 `console-ui-v1`。插件 ID 保持 `pigway-agent`，已有设备可直接继续使用。
+The storage display and manual discovery integration requires Console v2.7.0 and Agent v3.11.1 or later. The shared UI semantics require Console v2.7.30. Runtime uses the Python standard library, JSON-RPC v1 and `console-ui-v1`.

-打包：
+Build the ZIP below, upload it under Machine management and enable it. Register the Agent API URL and device token. Use HTTPS or a trusted tunnel across untrusted networks. For local development, set `PIGWAY_ADAPTER_PATH` to this repository's absolute `plugin` directory. Production Docker installations keep installed plugins in the persistent Console data volume.
+
+## Features and boundaries
+
+- Host status, hardware integration, services/processes, network metrics and Console-managed history.
+- Disk discovery runs only from Storage settings → Scan disks. Known disk capacity continues to refresh; display order, names and visibility use the shared Console settings.
+- The adapter retains existing API and service identifiers, including `pigway-pi-control`; a repository rename does not change those interfaces. Other Linux platforms are outside its support claim.
+
+Install only trusted plugins: frontend code shares the page JavaScript environment, and the backend process is not a security sandbox. The ZIP contains the manifest, worker and UI, not Console internals or Git metadata.
+
+See [storage behavior](STORAGE-DISCOVERY.md), [release notes](RELEASE_NOTES.md), and the [Console UI semantics](https://tea.pigway.com/way/pigway-device-console/src/branch/main/docs/UI_SEMANTICS.md). Dated deployment records describe historical validation, not a fresh online check.
+
+## Build
+
+Current adapter version: **1.6.10**.

 ```sh
 mkdir -p dist
-python3 package.py plugin dist/pigway-agent-1.1.0.zip
+python3 package.py plugin dist/pigway-agent-1.6.10.zip
 ```
-
-在控制中心的机器管理页面安装 ZIP，再启用。开发时可用 `PIGWAY_ADAPTER_PATH=/absolute/path/pigway-console-adapter-raspberry-pi/plugin` 加载源码；Docker 推荐使用持久化数据卷中的安装包。
-
-包根目录只有 manifest、worker 与 ui；打包工具、文档和 Git 元数据不进入插件包。前端扩展通过 Console 的共享状态、请求、翻译与基础显示函数接入，不注入额外安装步骤。只应安装可信插件：前端模块与主页面共享 JavaScript 执行环境，加载失败、同步异常及 Promise 拒绝可降级，但不能隔离死循环或恶意代码；后端独立进程的隔离也不是安全沙箱。
-
-正式仓库：https://tea.pigway.com/way/pigway-console-adapter-raspberry-pi 。首次独立版本为 v1.0.0，需要 Console v2.0.0。与 Console 的集成回归使用后者 tests 下的模拟 Agent，不操作真实设备。
-
-## Naming and compatibility
-
-This project targets Raspberry Pi. Other Linux platforms are not covered by its support claim and may have separately maintained adapters. Repository naming does not change the existing `pigway-agent` adapter ID or `pigway-pi-control` service, configuration and API identifiers.
-
-## v1.1.0 历史指标
-
-将现有 Agent API 的内存/磁盘字节数、开机时长与链路速度补充到标准 metrics，Console v2.1.0 可直接统一记录历史。不需要更新或新增树莓派进程。现有设备端没有上传下载流量计数，因此本版没有实际流量曲线；链路速度仅代表协商速率。
-
-v1.1.0 已与 Console v2.1.0 部署，真实树莓派在线并开始记录历史；设备端 Agent 保持原版本。[部署验收记录](https://tea.pigway.com/way/pigway-device-console/src/branch/main/docs/DEPLOYMENT-v2.1.0-2026-10-11.md)。
-
-生产已升级至 v1.2.0，网络卡片与上下行历史指标见 [部署记录](DEPLOYMENT-v1.2.0-2026-10-14.md)。
-
-当前网络卡片以实时上下行速率为主文字，详见 [v1.2.1 部署记录](DEPLOYMENT-v1.2.1-2026-10-14.md)。
-
-网络连接文案统一为接口链路状态，见 [v1.2.2](DEPLOYMENT-v1.2.2-2026-10-14.md)。
-
-生产 v1.3.0 与按设备周期采集的核验见 [部署记录](DEPLOYMENT-v1.3.0-2026-10-15.md)。
-
-当前生产实时指标统一 4 秒读取，实测及版本 v1.3.2 见 [调优记录](DEPLOYMENT-v1.3.2-2026-10-15.md)。
-
-当前生产 v1.3.3 的指标用词、状态与缺失百分比统一见 [部署记录](DEPLOYMENT-v1.3.3-2026-10-15.md)。
-
-## Console UI 语义统一
-
-本次界面需要 Console v2.7.30 的公共语义模块：在线、运行中使用绿色，健康正常使用蓝色，警告/故障/未知分别使用黄/红/灰色；状态采用14px/20px纯文字。完整规则见相邻 Console 项目的 `docs/UI_SEMANTICS.md`。
@@ -0,0 +1,28 @@
+# PIGWay Raspberry Pi Console Plugin
+
+简体中文 | [English](README.md)
+
+磁盘呈现统一版本已上线，需要 Console v2.7.0：默认按设备返回顺序，同组支持上移/下移、显示名称及隐藏，所有显示偏好保存到 Console，首页与配置页共用。Agent 的名称和隐藏定义继续作为设备默认值保留。扫描仍只由配置页按钮触发。
+
+当前 v1.6.10 支持统一磁盘显示设置与手动扫描，需要 Console v2.7.0、Agent v3.11.1；新磁盘仅手动发现，已知磁盘容量继续刷新。见 [磁盘发现说明](STORAGE-DISCOVERY.md)。
+
+独立维护的树莓派接入插件：连接现有 PIGWay Raspberry Pi Agent，不在树莓派安装新进程。设备 API、状态转换、配置字段、服务/进程监控、硬件界面及其翻译均由本仓库维护。
+
+依赖 Python 标准库；接入 Console JSON-RPC v1 与可信前端扩展 `console-ui-v1`。插件 ID 保持 `pigway-agent`，已有设备可直接继续使用。
+
+打包：
+
+```sh
+mkdir -p dist
+python3 package.py plugin dist/pigway-agent-1.6.10.zip
+```
+
+在控制中心的机器管理页面安装 ZIP，再启用。开发时可用 `PIGWAY_ADAPTER_PATH=/absolute/path/pigway-console-adapter-raspberry-pi/plugin` 加载源码；Docker 推荐使用持久化数据卷中的安装包。
+
+包根目录只有 manifest、worker 与 ui；打包工具、文档和 Git 元数据不进入插件包。前端扩展通过 Console 的共享状态、请求、翻译与基础显示函数接入，不注入额外安装步骤。只应安装可信插件：前端模块与主页面共享 JavaScript 执行环境，加载失败、同步异常及 Promise 拒绝可降级，但不能隔离死循环或恶意代码；后端独立进程的隔离也不是安全沙箱。
+
+正式仓库：https://tea.pigway.com/way/pigway-console-adapter-raspberry-pi 。首次独立版本为 v1.0.0，需要 Console v2.0.0。与 Console 的集成回归使用后者 tests 下的模拟 Agent，不操作真实设备。
+
+## 命名与兼容性
+
+本项目面向 Raspberry Pi，不承诺支持其他 Linux 平台。仓库名称不改变现有 `pigway-agent` 适配器 ID，以及 `pigway-pi-control` 服务、配置和 API 标识。
@@ -1,18 +1,7 @@
 3cfd361f7663a9a9c93b507d17bb1c7e98003d61316826f0a4ba4a93594f72d4  .gitignore
-8ef77455daa560a7f25a1d8a4684c9e8ce9232745d844b0e3703c7f57830c85f  DEPLOYMENT-v1.2.0-2026-10-14.md
-176127d6a7c5abf61112ea019ccc8f62819d1b94c5084ae51b99cbe0369cc22f  DEPLOYMENT-v1.2.1-2026-10-14.md
-d4938f4fb971fb665e377ba966b523250401138cf7e1186cb57da55fbf904f3b  DEPLOYMENT-v1.2.2-2026-10-14.md
-ec04c97e0271455a41328b8d68e8e4a5d0e3ef5782ddb8fc62a08b7bfff2ef9d  DEPLOYMENT-v1.3.0-2026-10-15.md
-136db6c02d7181085f18c54bf1ca2b0bc56e3aa43e3a71a0e59926fc7fa7b18f  DEPLOYMENT-v1.3.2-2026-10-15.md
-d0870015c81d16af20cf38b775fa95b5ac1619cc5144fcda5007cb2f832e0e33  DEPLOYMENT-v1.3.3-2026-10-15.md
-19d484544782cc4d6f2a47113cf0954c07b83113d3f856cd84156854fbff5e6e  README.md
+610c8e95de327f99e89236ffe6ed33add00dd4ed85344008dceeacf0e6d4af9c  README.md
 291ec4f06dcf990843d8403a0c431a1346f9ab430ebcdaccef4b4b08a76a3c40  RELEASE_NOTES.md
 a669ccb22bf3aafec6fa558fd84108dca013cb8dc2988206b7b5fe58a1eb2035  STORAGE-DISCOVERY.md
-0cf93f3b3d3219ab8229b59e98cbd82e42647a461231f7c767ea3d120f8e0910  docs/AUDIT-FIXES-2026-10-16.md
-1eec71f194bfdd51b6ae5a9063a0760ccf24b46474901defdf19503a680b8fcd  docs/HOME-CARD-ORDER-2026-10-17.md
-b47aafb725706a03837aceabd1ac59b302ead066bf12bf947326a98cb38963ef  docs/OVERVIEW-DISCLOSURES-2026-10-16.md
-f0df601aafe839cfe06c069471071023158beced81c5d0b802fa0bb4ed3528bc  docs/OVERVIEW-SUMMARY-BADGES-2026-10-16.md
-d3528d8fd4eed197942e2c9a72d62e6c9ff6b3ab00f4be98c337b6e306d6e177  docs/STATUS-ALIGNMENT-2026-10-16.md
 d081c599d821149853368b1a8637c57a16995344406ff5ec9d7619b66e0479b3  package.py
 97cb3cd8119147da93a73c5ad82faedd99daab5093a1aa0fb6b855d1df1c65a4  plugin/manifest.json
 d6a342605426357da7d2e65daa435e99d7234549cffa52e1a9229ef5bc36f33c  plugin/ui/config.js
@@ -26,6 +15,7 @@ af631694fcd7da21b77b554e6ee1bf2eaa93bd46a0b8b543e367f032d3236ecb  plugin/ui/inde
 061f5011b78cedcd0c69a32aa5106889d38f6863f4c613ae326cc9d16f90e2dd  plugin/ui/styles.css
 0b79b9c5b5f23727164e05b127caca72255416309166ba200ccbd15a9667473c  plugin/ui/translations.js
 d5b22366a2c7b375e6f3e35cefb9f95da0ea3b8390b3ec4d1000492f00128f6e  plugin/worker.py
-173d0a6fad2f7b3cc70c81162c882675b16d581b762a5f86441613fdd5ece74e  tests/browser_alert_semantics.cjs
+494c90f6d154edc64aad3169653cc08c7f5fd4a6613341b4c0ff10dd7e0e1cb5  tests/browser_alert_semantics.cjs
 40c038aa7689c127c0d90ddf390674f534a2bdee8fd3c344d09f8fb6d4bb3964  tests/test_metrics.py
 40d10555aef08f8132f576976b7205b3e1c16d330196a11c6cc1c5cbc167c670  tests/test_storage_metrics.py
+5a231d6208b15565361ccdb8fb24480c6eb56a0b7c7095e2e989378e7512ae9d  README.zh-CN.md
@@ -1,5 +0,0 @@
-# 2026-10-16 主要告警展示（1.6.2）
-
-概览把 Agent owner 的标题从“显示状态”改为“主要告警”，明确告警按严重程度排序、实际屏幕见硬件插件。避免未连接硬件或 OLED 轮播时把 Agent 告警摘要误认为屏幕实况。
-
-原四项 Python 测试通过；tests/browser_alert_semantics.cjs 验证中英文及桌面、平板、手机布局，使用真实组件及 CSS、隔离硬件和网络依赖。运行需 PLAYWRIGHT_MODULE 指向可用 Playwright；PIGWAY_WEB_ROOT 可指定控制台 web 目录。已安装至生产控制台 2.7.23，API 确认版本 1.6.2，设备在线与显示偏好保持一致；备份：`/volume1/homes/way/pigway-console-log-zh-backup-1792125044`。
@@ -1,7 +0,0 @@
-# 首页设备卡片统一约定
-
-所有主机（包括 Server、Gateway、NAS 及后续新增设备）使用顺序：处理器负载 → 内存占用 → 主网络 → 存储分区，再显示设备专属信息。
-
-NAS 系统温度放在处理器负载进度条下方，不单独占卡片；保留系统温度的原始含义。管理跳转图标紧跟设备名称，布局间距 2px，新标签页打开。Docker 管理入口使用 Server 的 DPanel 88 端口。
-
-本次发布为增量更新，保留线上已有功能与配置。发布附件仅包含本次更新的运行时文件，不是可直接导入 Console 的完整适配器安装 ZIP。
@@ -1,5 +0,0 @@
-# 概览折叠区块 1.6.3
-
-“服务与进程监控”或“已读取范围内的告警”采用默认收起的 details/summary，沿用 SMART 展开样式。data-overview-details 配合 Console 2.7.24 保留每台设备在自动刷新中的展开状态。内容和监控行为保持不变。
-
-已部署至生产；中英文、桌面/平板/手机验收通过。部署回执及验证详见控制台 docs/OVERVIEW-DISCLOSURES-2026-10-16.md。
@@ -1,3 +0,0 @@
-# 概览汇总标签
-
-折叠标题增加正常/异常数量/未确认汇总，暂无监控不视为正常。共享 Console 2.7.25 overview-health.js 判定，过期数据不显示绿色正常。已部署，中英文桌面/平板/手机及各状态模拟验收通过。完整回执见控制台 docs/OVERVIEW-SUMMARY-BADGES-2026-10-16.md。
@@ -1,3 +0,0 @@
-# 概览状态纯文字展示
-
-汇总调用改为 summaryStatus，配合 Console 2.7.26 的统一纯文字与对齐规则。已部署；中英文、深浅主题、桌面/平板/手机及长文本实际展开测量均通过。判断逻辑不变。详见控制台 docs/STATUS-ALIGNMENT-2026-10-16.md。
@@ -1,7 +1,7 @@
 const {chromium}=require(process.env.PLAYWRIGHT_MODULE || 'playwright');
 const fs=require('fs');const path=require('path');
 const adapter=path.resolve(__dirname,'..');
-const web=process.env.PIGWAY_WEB_ROOT || path.resolve(adapter,'../pigway-web-manager/web');
+const web=process.env.PIGWAY_WEB_ROOT || path.resolve(adapter,'../pigway-device-console/web');
 const output=adapter+'/.data/audit-validation';fs.mkdirSync(output,{recursive:true});
 (async()=>{const browser=await chromium.launch({headless:true});const page=await browser.newPage();let errors=[];page.on('pageerror',e=>errors.push(e.message));
 await page.route('http://audit.local/**',async route=>{const u=new URL(route.request().url());let body,type='text/javascript';