device-center 0.2.0-beta.2 → 0.2.0-beta.3

package/README.md

@@ -1,5 +1,7 @@
 # Device Center
 
+界面与 Agent 安装说明支持简中、繁中、英、日、韩、西、法、德、巴西葡语。页面顶部可切换，也可分享 `/start?lang=en`、`/start?lang=ja`。详见[多语言说明](docs/i18n.md)。
+
 让主力电脑上的智能体，使用自己的闲置设备。MIT · Node.js 24 · macOS / Linux · beta。
 
 一个本机连接器，加一个可选的云端控制面。真实本机内存、磁盘分别展示；已有 SSH 配置可一键关联并执行固定只读检查；设备 Agent 可通过域名绑定账号，主动回报状态。指定日志经设备主人单独授权后，以双向 TLS 1.3 直连或密文中转读取。没有默认示例设备或虚构在线状态。
@@ -8,6 +10,8 @@
 
 希望交给本机 Agent 安装时，按[Agent 安装指南](docs/agent-install.md)选择本机、官方托管或已有自建服务。“交给 Agent 安装”可直接复制完整说明；登录和设备绑定仍由用户核对。朋友试用从[一页指南](https://devices.owenshen.top/start)开始，无需先登录。
 
+0.2.0-beta.3 增加九语言界面与安装说明，语言菜单支持键盘、窄屏与输入保留。长文档和 CLI 仍以中文为主。
+
 0.2.0-beta.2 增加设备命名、类型、用途、标签、手动服务清单及“采集一次”，见[设备说明与手动采集](docs/device-profiles.md)。旧 Driver 需升级后才能响应云端手动采集；服务与应用仍由用户手动登记。
 
 第一次使用可按 [新用户上手教程](docs/quick-start.md) 完成安装、设备配对和指定日志授权；[验收记录](docs/user-acceptance.md)列出已验证项目与限制。
@@ -15,7 +19,7 @@
 只用本机，不注册账号：
 
 ```sh
-npx --yes device-center@0.2.0-beta.2 start
+npx --yes device-center@0.2.0-beta.3 start
 ```
 
 打开 `http://127.0.0.1:5174`，将 `/mcp` 添加到本机智能体。侧栏“开始使用”按管理电脑 → 智能体 → 设备引导；导入 SSH 后检查一次连通性。没有可用 Agent/SSH 的设备保持未知；资源快照过期显示“待刷新”，不代表密钥过期。列表刷新不主动连接 SSH。
@@ -23,8 +27,8 @@ npx --yes device-center@0.2.0-beta.2 start
 需要在外查看设备、使用日志中转：
 
 ```sh
-npx --yes device-center@0.2.0-beta.2 plan
-npx --yes device-center@0.2.0-beta.2 connect --confirm
+npx --yes device-center@0.2.0-beta.3 plan
+npx --yes device-center@0.2.0-beta.3 connect --confirm
 # 自建控制面可指定 --cloud https://devices.example.com
 ```
 
@@ -66,4 +70,4 @@ npm run verify:package
 
 需要已有受信任 App Services 共享账号服务与同父域会话；不是通用第三方 OAuth。个人部署可选 personal + ownerEmail。旧个人数据切多用户前按[迁移与回退说明](docs/hosted-access.md)核验原所有者映射；不能只切回旧代码而保留多用户数据库。
 
-当前没有密钥托管、安装时自动联网或远程 shell。安全边界与披露方式见 [SECURITY](SECURITY.md)。npm 包公开不自动改变 GitHub 仓库可见性；本次发布是可追溯工作区快照，不是 main CI 构建。
+当前没有密钥托管、安装时自动联网或远程 shell。安全边界与披露方式见 [SECURITY](SECURITY.md)。npm 包公开不自动改变 GitHub 仓库可见性；发布包按固定源码提交构建；手工发布不等同主线 CI 自动交付。

package/docs/agent-install.md

@@ -2,7 +2,7 @@
 
 用户选择模式后，把完整安装说明交给**正在目标电脑上运行、具备本机安装能力的 Agent**。网页只复制说明，不会远程替浏览器所在电脑安装软件。
 
-`device-center@0.2.0-beta.2` 提供“交给 Agent 安装”、设备说明与手动采集。新用户可在[一页试用指南](https://devices.owenshen.top/start)免登录选择方式并复制完整说明。
+`device-center@0.2.0-beta.3` 提供“交给 Agent 安装”、设备说明与手动采集。新用户可在[一页试用指南](https://devices.owenshen.top/start)免登录选择方式并复制完整说明。
 
 ## 用户只需要选择一种方式
 
@@ -29,7 +29,7 @@
 全新安装可以使用：
 
 ```sh
-npm install --global --prefix "$HOME/.local" --ignore-scripts device-center@0.2.0-beta.2
+npm install --global --prefix "$HOME/.local" --ignore-scripts device-center@0.2.0-beta.3
 "$HOME/.local/bin/device-center" --version
 ```
 

package/docs/friend-trial.md

@@ -1,6 +1,6 @@
 # Device Center · 朋友试用指南
 
-让本机 Agent 看见自己的电脑与闲置设备：真实内存、磁盘、设备用途，以及单独授权的指定日志。当前为 `0.2.0-beta.2` 公开试用版。
+让本机 Agent 看见自己的电脑与闲置设备：真实内存、磁盘、设备用途，以及单独授权的指定日志。当前为 `0.2.0-beta.3` 公开试用版。
 
 **入口：https://devices.owenshen.top/start**。支持 macOS / Linux，需要 Node.js 24+；Windows 原生版尚未支持。
 
@@ -14,7 +14,7 @@
 
 Agent 按说明检查已有配置、固定版本安装、设置用户级后台服务、配置 MCP 并核验结果。已有配置冲突时解释并让你选择，不自动覆盖。系统授权或当前 Agent 无法配置 MCP 时，会请你完成对应一步。
 
-不使用 Agent 时，可在全新环境运行 `npx --yes device-center@0.2.0-beta.2 start` 体验本机面板；这是前台方式，终端关闭后停止。长期使用按[完整安装指南](https://devices.owenshen.top/install/agent.md)固定安装。
+不使用 Agent 时，可在全新环境运行 `npx --yes device-center@0.2.0-beta.3 start` 体验本机面板；这是前台方式，终端关闭后停止。长期使用按[完整安装指南](https://devices.owenshen.top/install/agent.md)固定安装。
 
 ## 2. 托管模式才需要登录绑定
 

package/docs/hosted-access.md

@@ -1,6 +1,6 @@
 # 本机、官方与自建接入
 
-本版本 0.2.0-beta.2 使用同一 CLI 支持官方与自建 HTTPS 控制面；每个账号独立管理自己的设备。安装不自动接入，connect --confirm 默认申请官方服务，用户登录并核对批准后才绑定。
+本版本 0.2.0-beta.3 使用同一 CLI 支持官方与自建 HTTPS 控制面；每个账号独立管理自己的设备。安装不自动接入，connect --confirm 默认申请官方服务，用户登录并核对批准后才绑定。
 
 ## 用户流程
 

package/docs/i18n.md

@@ -0,0 +1,32 @@
+# 多语言界面
+
+支持简体中文（`zh-CN`）、繁體中文（`zh-TW`）、English（`en`）、日本語（`ja`）、한국어（`ko`）、Español（`es`）、Français（`fr`）、Deutsch（`de`）、Português do Brasil（`pt-BR`）。繁中采用台湾常用术语，葡语采用巴西用法。
+
+## 使用
+
+页面顶部点击地球图标与当前语言，展开双列菜单；各语言使用自己的原名，当前语言显示勾选。登录页和弹窗复用同一组件。选择后自动收起，点击外部或按 Esc 可关闭；支持方向键、Home / End、回车和 Tab。窄屏下菜单位置保持在视口内。
+
+切换不刷新页面，保留设备说明、搜索与安装地址等当前输入，不触发配对、采集或授权。
+
+首次按浏览器语言选择；之后记住当前浏览器、当前站点的选择。优先级是 URL 的 `lang` → 本机保存的偏好 → 浏览器语言 → 英文。支持地区变体，如 `en-US`、`ja-JP`、`zh-Hant-HK`。本机存储不可用时仍可切换，并通过 URL 保持当前语言。
+
+可以分享指定语言的页面，例如 `/start?lang=en` 或 `/start?lang=ja`。内部导航、登录重定向与退出登录会带上所选语言。
+
+## 覆盖与边界
+
+- 公开试用指南、登录页、设备面板、设备说明、状态与采集提示、SSH 导入与连接计划、配对和日志授权说明。
+- 复制给 Agent 的完整安装说明按所选语言生成；具体命令、版本、域名与参数保持原样。复制不会安装软件。
+- 设备名称、用途、标签、服务、SSH 别名、路径、指纹等用户数据不翻译。状态代码、API、认证、有效期与权限契约不变。
+- 浏览器内使用静态词典，不发送设备数据到外部翻译服务。已有服务端固定诊断仅通过明确的文案映射翻译；未知诊断原样显示。
+- Markdown 长文档与 CLI 输出目前以简体中文为主。外语页面的长文档链接注明中文，不能将界面翻译等同于所有文档与 CLI 已本地化。
+- 九种语言已做目录完整性与交互检查；公开推广前仍欢迎母语使用者改进术语和语气。
+
+## 维护
+
+`src/messages.js` 是词典真源；各语言必须拥有同一组键、相同的 `{placeholder}` 参数，不能把旧键重新分配给不同语义。`panel.N` 是现有面板的稳定文案键；新增文案优先用语义键，如 `count.bound`。
+
+`src/i18n.js` 负责语言归一化、选择与安全插值。文本使用 `t`，HTML 模板使用会转义参数的 `h`。静态页面只翻译显式 `data-i18n` 标记；禁止遍历用户文本或对整个 DOM 做替换。布局选择器使用稳定 class，不能依赖翻译后的 aria-label。
+
+`src/install-prompt.js` 负责说明组装，`src/onboarding.js` 保持命令和验证规则。翻译安全说明时保留本人核对完整指纹、配对码不进入 prompt、私钥留在设备、操作单独授权等约束。
+
+运行 `npm run check`、`npm test`。`tests/i18n.test.mjs` 覆盖词典、占位符、引用、地区语言归一化、安装模式与命令不变性。新增公共脚本时须核对云端静态白名单、未登录 API 隔离和安装包清单。

package/docs/npm.md

@@ -1,16 +1,16 @@
 # npm / npx 分发
 
-MIT，Node.js 24，macOS/Linux。当前版本 `0.2.0-beta.2`，使用 npm `beta` 渠道；是否上架以公开 registry 为准。
+MIT，Node.js 24，macOS/Linux。当前版本 `0.2.0-beta.3`，使用 npm `beta` 渠道；是否上架以公开 registry 为准。
 
 ```sh
-npx --yes device-center@0.2.0-beta.2 --help
-npx --yes device-center@0.2.0-beta.2 plan
+npx --yes device-center@0.2.0-beta.3 --help
+npx --yes device-center@0.2.0-beta.3 plan
 # 主动接入默认官方服务，执行后在终端与面板之间核对配对
-npx --yes device-center@0.2.0-beta.2 connect --confirm
+npx --yes device-center@0.2.0-beta.3 connect --confirm
 # 自建服务
-npx --yes device-center@0.2.0-beta.2 connect --cloud https://你的控制面域名 --confirm
+npx --yes device-center@0.2.0-beta.3 connect --cloud https://你的控制面域名 --confirm
 # 仅本机，无账号要求
-npx --yes device-center@0.2.0-beta.2 start
+npx --yes device-center@0.2.0-beta.3 start
 ```
 
 安装与无参/help/version/plan 不生成身份，不配对，不自动启动后台进程。复制命令不含凭据。只有 connect --confirm 才生成本机身份并申请绑定；默认官方地址不会自动批准，用户需登录自己的账号。SSH 缓存分享须 --share-ssh 与面板再次批准。
@@ -18,7 +18,7 @@ npx --yes device-center@0.2.0-beta.2 start
 面板和本机 MCP：`http://127.0.0.1:5174/`、`/mcp`。常驻先固定安装：
 
 ```sh
-npm install -g device-center@0.2.0-beta.2
+npm install -g device-center@0.2.0-beta.3
 device-center service plan --port 5174
 # 自行停止同端口前台进程，再主动安装
 device-center service install --port 5174 --confirm

package/docs/onboarding.md

@@ -32,7 +32,7 @@ Driver 主动建立获准的安全出站连接。短时一次性登记凭据应
 | 目标设备条件 | 用户最少操作 | 结果条件 |
 | --- | --- | --- |
 | 管理电脑已有可用 SSH 配置 | 一键导入引用 | 导入后自动检查一次，取得真实资源后才显示近期在线与资源 |
-| 目标设备已有智能体 | 复制安装指导，交给目标机智能体；确认安装与绑定 | 0.2.0-beta.2 可复制完整安装说明，本机生成身份并核对配对与真实回报；签名安装器待实现 |
+| 目标设备已有智能体 | 复制安装指导，交给目标机智能体；确认安装与绑定 | 0.2.0-beta.3 可复制完整安装说明，本机生成身份并核对配对与真实回报；签名安装器待实现 |
 | 目标设备没有智能体 | 下载对应平台的验签安装包，在目标机运行并批准绑定 | 与智能体辅助方式使用同一接入协议；待实现 |
 | 不能安装 Agent，也没有可用 SSH | 明示缺少接入条件 | 保持未知，不伪装接通 |
 

package/docs/remote-access.md

@@ -1,13 +1,13 @@
 # 远程日志：明确授权后使用
 
-本版本 0.2.0-beta.2 支持 macOS / Linux、Node.js 24。两台设备主动连接同一 HTTPS 控制面，默认使用 `https://devices.owenshen.top`；可用 `--cloud https://你的域名` 替换。安装或查看帮助不会产生身份、配对或运行远程操作。
+本版本 0.2.0-beta.3 支持 macOS / Linux、Node.js 24。两台设备主动连接同一 HTTPS 控制面，默认使用 `https://devices.owenshen.top`；可用 `--cloud https://你的域名` 替换。安装或查看帮助不会产生身份、配对或运行远程操作。
 
 ## 最短流程
 
 在管理电脑和目标设备分别运行：
 
 ```sh
-npm install -g device-center@0.2.0-beta.2
+npm install -g device-center@0.2.0-beta.3
 device-center connect --confirm
 ```
 

package/docs/roadmap.md

@@ -14,6 +14,12 @@
 - “交给 Agent 安装”：本机、官方托管、已有自建服务；固定版本、用户级后台与 MCP 步骤。
 - 免登录的一页试用指南。登录、完整指纹核对和设备批准仍由用户完成。
 
+## 0.2.0-beta.3
+
+- 简中、繁中、英、日、韩、西、法、德、巴葡九种语言，覆盖指南、登录、面板与 Agent 安装说明。
+- 统一语言菜单、浏览器偏好和分享链接，切换保留未保存输入；命令与设备数据保持原样。
+- 长文档和 CLI 仍以中文为主，翻译尚待母语者校对。
+
 ## 后续候选
 
 1. 验证各平台真实常驻、升级和恢复；减少 Node 与终端依赖。

package/index.html

@@ -6,6 +6,7 @@
     <meta name="theme-color" content="#f4f5f1" />
     <meta name="description" content="Device Center · 云端控制面与设备 Agent 接入原型" />
     <link rel="stylesheet" href="/src/styles.css" />
+    <link rel="stylesheet" href="/src/i18n.css" />
     <title>Device Center · 设备控制面</title>
   </head>
   <body>

package/login.html

@@ -1,5 +1,5 @@
 <!doctype html>
 <html lang="zh-CN">
-<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>登录 · Device Center</title><link rel="stylesheet" href="/src/login.css"></head>
-<body><main><div class="mark">DC</div><h1>Device Center</h1><p>登录你的设备控制面</p><p id="loading" role="status">正在读取登录方式…</p><form id="login" hidden><label>用户名<input name="username" autocomplete="username" required maxlength="64"></label><label>密码<input name="password" type="password" autocomplete="current-password" required maxlength="256"></label><button type="submit">登录</button><p id="message" role="alert"></p></form><section id="unified" hidden><p>使用 App Services／个人站的统一账号。</p><a id="unified-login" class="login-link" target="_blank" rel="noopener noreferrer">使用统一账号登录 ↗</a><p class="help">在新页面用邮箱或 Google 完成登录，回到这里会自动进入设备面板。</p><button id="continue-login" type="button">我已登录，继续</button><p id="unified-message" role="status"></p></section><p class="install-help">还未安装？<a href="/start" target="_blank" rel="noopener noreferrer">查看一页试用指南 ↗</a><br><span>本机使用无需账号；官方托管需登录并核对绑定。</span></p><small id="access-notes">账号登录 · HTTPS 保护</small></main><script type="module" src="/src/login.js"></script></body>
+<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title data-i18n="login.title">登录 · Device Center</title><link rel="stylesheet" href="/src/login.css"><link rel="stylesheet" href="/src/i18n.css"></head>
+<body class="login-page"><main><div class="language-picker" data-language-picker></div><div class="mark">DC</div><h1>Device Center</h1><p data-i18n="login.subtitle">登录你的设备控制面</p><p id="loading" role="status" data-i18n="login.loading">正在读取登录方式…</p><form id="login" hidden><label><span data-i18n="login.username">用户名</span><input name="username" autocomplete="username" required maxlength="64"></label><label><span data-i18n="login.password">密码</span><input name="password" type="password" autocomplete="current-password" required maxlength="256"></label><button type="submit" data-i18n="login.submit">登录</button><p id="message" role="alert"></p></form><section id="unified" hidden><p data-i18n="login.unified">使用 App Services／个人站的统一账号。</p><a id="unified-login" class="login-link" target="_blank" rel="noopener noreferrer" data-i18n="login.link">使用统一账号登录 ↗</a><p class="help" data-i18n="login.help">在新页面用邮箱或 Google 完成登录，回到这里会自动进入设备面板。</p><button id="continue-login" type="button" data-i18n="login.continue">我已登录，继续</button><p id="unified-message" role="status"></p></section><p class="install-help"><span data-i18n="login.notInstalled">还未安装？</span><a href="/start" target="_blank" rel="noopener noreferrer" data-language-link data-i18n="login.guide">查看一页试用指南 ↗</a><br><span data-i18n="login.installHint">本机使用无需账号；官方托管需登录并核对绑定。</span></p><small id="access-notes" data-i18n="login.multi">账号设备隔离 · HTTPS 保护</small></main><script type="module" src="/src/login.js"></script></body>
 </html>

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "device-center",
-  "version": "0.2.0-beta.2",
+  "version": "0.2.0-beta.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "device-center",
-      "version": "0.2.0-beta.2",
+      "version": "0.2.0-beta.3",
       "license": "MIT",
       "dependencies": {
         "@peculiar/x509": "2.1.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "device-center",
-  "version": "0.2.0-beta.2",
+  "version": "0.2.0-beta.3",
   "license": "MIT",
   "type": "module",
   "description": "Local device connector with account-bound pairing, TLS encrypted relay and explicitly authorized log access",
@@ -37,7 +37,8 @@
     "docs/remote-access.md",
     "npm-shrinkwrap.json",
     "start.html",
-    "docs/friend-trial.md"
+    "docs/friend-trial.md",
+    "docs/i18n.md"
   ],
   "publishConfig": {
     "access": "public",

package/server/index.mjs

@@ -82,7 +82,7 @@ export function createDeviceCenterServer({ dbPath = './data/device-center.sqlite
       const url = new URL(request.url ?? '/', origin);
       const path = url.pathname;
       // Public static installation reference only. No identity, configuration or owner API.
-      if (['/start', '/start.html', '/src/start.js', '/src/start.css', '/src/onboarding.js'].includes(path) && request.method === 'GET') return await serveStatic(path, response);
+      if (['/start', '/start.html', '/src/start.js', '/src/start.css', '/src/onboarding.js', '/src/i18n.js', '/src/i18n.css', '/src/messages.js', '/src/install-prompt.js'].includes(path) && request.method === 'GET') return await serveStatic(path, response);
       if (Object.hasOwn(PUBLIC_GUIDES, path) && request.method === 'GET') {
         const body = await readFile(resolve(PROJECT_ROOT, PUBLIC_GUIDES[path]));
         response.writeHead(200, { 'content-type': 'text/markdown; charset=utf-8', 'cache-control': 'no-store', 'x-content-type-options': 'nosniff', 'content-security-policy': "default-src 'none'; frame-ancestors 'none'", 'referrer-policy': 'no-referrer' });
@@ -115,7 +115,7 @@ export function createDeviceCenterServer({ dbPath = './data/device-center.sqlite
         }
         const principal = await cloudAccess.resolvePrincipal(request);
         if (!principal) {
-          if (path === '/' && request.method === 'GET') { response.writeHead(303, { location: '/login', 'cache-control': 'no-store' }); return response.end(); }
+          if (path === '/' && request.method === 'GET') { response.writeHead(303, { location: `/login${/^(zh-CN|zh-TW|en|ja|ko|es|fr|de|pt-BR)$/.test(url.searchParams.get('lang') ?? '') ? '?lang=' + url.searchParams.get('lang') : ''}`, 'cache-control': 'no-store' }); return response.end(); }
           return sendJson(response, 401, { error: 'authentication_required' });
         }
         accountRegistry = registry.forTenant(principal.tenantId);

package/src/api.js

@@ -1,7 +1,8 @@
+import { getLocale } from './i18n.js';
 async function request(path, { timeoutMs = 12000, ...options } = {}) {
   const response = await fetch(path, { ...options, cache: 'no-store', signal: AbortSignal.timeout(timeoutMs) });
   const payload = await response.json().catch(() => ({}));
-  if (response.status === 401) { location.replace('/login'); throw new Error('authentication_required'); }
+  if (response.status === 401) { location.replace('/login?lang=' + getLocale()); throw new Error('authentication_required'); }
   if (!response.ok) throw new Error(payload.error ?? `http_${response.status}`);
   return payload;
 }

package/src/device-state.js

@@ -1,3 +1,4 @@
+import { t } from './i18n.js';
 // Expire displayed SSH snapshots without a network request or a background SSH check.
 export function expireSshSnapshots(overview, now = Date.now()) {
   const expired = device => device.state === 'online' && (device.transport === 'ssh' && now - device.lastHeartbeat > 300_000 || device.source === 'driver-report' && (now - device.managementDriver.lastSeen > 90_000 || now - device.lastHeartbeat > (device.kind === 'management' ? 90_000 : 300_000)));
@@ -8,21 +9,21 @@ export function expireSshSnapshots(overview, now = Date.now()) {
   return { ...overview, devices, stats };
 }
 
-export const DEVICE_TYPE_LABELS = { unspecified: '未分类', personal: '个人电脑', server: '服务器', workstation: '工作站', other: '其他' };
+export const DEVICE_TYPE_LABELS = { get unspecified() { return t("panel.498"); }, get personal() { return t("panel.499"); }, get server() { return t("panel.500"); }, get workstation() { return t("panel.501"); }, get other() { return t("panel.502"); } };
 export function deviceStatus(device, now = Date.now()) {
-  if (device.state === 'unknown') return { label: '未知', title: '尚未取得资源数据；未把设备视为已连接。' };
-  if (device.source === 'driver-report' && (device.managementDriver.lastSeen == null || now - device.managementDriver.lastSeen > 90_000)) return { label: '未回报', title: '超过 90 秒未收到 Driver 回报。请确认设备已唤醒、Driver 正在运行且能连接云端。旧数据保留，不表示密钥过期。' };
-  if (device.state === 'expired') return { label: '待采集', title: '上次资源快照较早，点击采集一次取得新数据；不表示设备断线或密钥过期。' };
-  return { label: '在线', title: device.transport === 'ssh' ? '最近一次 SSH 检查成功，不表示持续连接。' : '最近收到真实资源数据。' };
+  if (device.state === 'unknown') return { label: t("panel.457"), title: t("panel.503") };
+  if (device.source === 'driver-report' && (device.managementDriver.lastSeen == null || now - device.managementDriver.lastSeen > 90_000)) return { label: t("panel.504"), title: t("panel.505") };
+  if (device.state === 'expired') return { label: t("panel.506"), title: t("panel.507") };
+  return { label: t("panel.456"), title: device.transport === 'ssh' ? t("panel.508") : t("panel.509") };
 }
 export function collectionAvailability(device, now = Date.now()) {
   if (device.source === 'driver-report') {
-    if (device.collection?.status === 'pending' && device.collection.expiresAt > now) return { available: false, pending: true, hint: '等待设备采集…' };
-    if (device.kind !== 'management') return { available: false, hint: '请在管理电脑检查 SSH' };
-    if (device.managementDriver.lastSeen == null || now - device.managementDriver.lastSeen > 90_000) return { available: false, hint: '请启动设备上的 Driver' };
-    if (!device.collection?.supported) return { available: false, hint: device.collection?.reason === 'driver_control_unavailable' ? '采集通道暂不可用' : '需更新设备 Driver' };
-    return { available: true, hint: '通知 Driver 重新采集内存与磁盘；不执行远程命令。' };
+    if (device.collection?.status === 'pending' && device.collection.expiresAt > now) return { available: false, pending: true, hint: t("panel.41") };
+    if (device.kind !== 'management') return { available: false, hint: t("panel.510") };
+    if (device.managementDriver.lastSeen == null || now - device.managementDriver.lastSeen > 90_000) return { available: false, hint: t("panel.511") };
+    if (!device.collection?.supported) return { available: false, hint: device.collection?.reason === 'driver_control_unavailable' ? t("panel.512") : t("panel.513") };
+    return { available: true, hint: t("panel.514") };
   }
-  if (device.transport === 'ssh') return { available: Boolean(device.ssh?.checkAvailable && !device.ssh.checking && !device.ssh.queued), hint: '使用当前 SSH 配置进行一次只读检查并采集。' };
-  return { available: device.source === 'local-runtime' && device.scope === 'host', hint: '从当前本机进程重新读取内存与磁盘。' };
+  if (device.transport === 'ssh') return { available: Boolean(device.ssh?.checkAvailable && !device.ssh.checking && !device.ssh.queued), hint: t("panel.515") };
+  return { available: device.source === 'local-runtime' && device.scope === 'host', hint: t("panel.516") };
 }

package/src/i18n.css

@@ -0,0 +1,61 @@
+.header-actions { display: flex; align-items: center; justify-content: flex-end; gap: 20px; flex-wrap: wrap; }
+.language-picker { display: inline-flex; flex: 0 0 auto; min-width: 0; color: #344d3e; font-size: 12px; }
+.language-picker button { font-family: inherit; cursor: pointer; filter: none; }
+.language-picker .language-trigger { display: inline-flex; align-items: center; justify-content: center; gap: 7px; width: auto; height: 34px; min-height: 34px; margin: 0; padding: 0 9px; border: 1px solid transparent; border-radius: 8px; background: transparent; color: inherit; font-size: 12px; font-weight: 500; line-height: 1; white-space: nowrap; transition: background .15s, border-color .15s; }
+.language-trigger > svg { width: 16px; height: 16px; flex-shrink: 0; color: #758375; }
+.language-trigger > .language-chevron { width: 12px; height: 12px; transition: transform .15s; }
+.language-trigger[aria-expanded="true"] > .language-chevron { transform: rotate(180deg); }
+.language-picker .language-trigger:hover, .language-trigger[aria-expanded="true"] { background: #eaf0e6; border-color: #dde6d8; }
+.language-picker button:focus-visible { outline: 2px solid #5c965d; outline-offset: 2px; }
+.language-menu { position: fixed; z-index: 40; width: 304px; max-width: calc(100vw - 24px); max-height: calc(100dvh - 32px); overflow: auto; padding: 8px; border: 1px solid #e0e7dc; border-radius: 13px; background: #fff; color: #344d3e; box-shadow: 0 12px 36px #2035241a, 0 2px 6px #20352409; }
+.language-menu[hidden] { display: none; }
+.language-menu-title { padding: 7px 9px 10px; color: #84907f; font-size: 11px; font-weight: 500; line-height: 1.3; }
+.language-options { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 3px; }
+.language-picker .language-option { display: flex; align-items: center; justify-content: space-between; gap: 5px; width: 100%; height: auto; min-height: 40px; padding: 8px 9px; margin: 0; border: 0; border-radius: 7px; background: transparent; color: #475449; text-align: left; font-size: 12px; font-weight: 400; line-height: 1.4; }
+.language-option > span { min-width: 0; }
+.language-option > svg { width: 14px; height: 14px; flex-shrink: 0; opacity: 0; color: #356c4c; }
+.language-picker .language-option:hover, .language-picker .language-option:focus-visible { background: #f2f5ef; }
+.language-picker .language-option[aria-checked="true"] { background: #eaf2e5; color: #2f6545; font-weight: 600; }
+.language-option[aria-checked="true"] > svg { opacity: 1; }
+.topbar { position: relative; z-index: 4; }
+.login-page main { position: relative; }
+.login-page main > .language-picker { position: absolute; top: 36px; right: 24px; }
+@media (max-width: 560px) { .header-actions { gap: 8px; } }
+@media (prefers-reduced-motion: reduce) { .language-trigger, .language-chevron { transition: none !important; } }
+/* Longer translations must wrap without moving the sidebar or top bar. */
+.modal-heading { gap: 12px; flex-wrap: wrap; }
+.modal-heading h2 { flex: 1 1 140px; min-width: 0; }
+.modal-heading .language-picker { margin-left: auto; }
+.nav-item svg { flex-shrink: 0; }
+.nav-item > span { min-width: 0; overflow-wrap: anywhere; }
+.resource-top { flex-wrap: wrap; }
+.resource-top > span { overflow-wrap: anywhere; white-space: normal; }
+@media (max-width: 760px) {
+  .topbar .environment-badge { display: none; }
+  .topbar .header-actions { flex-wrap: nowrap; gap: 0; }
+  .topbar > span { min-width: 0; }
+  .page-heading { flex-wrap: wrap; align-items: flex-start; gap: 8px; }
+  .page-heading > div:first-child { width: 100%; min-width: 0; }
+  .page-heading h1 { overflow-wrap: anywhere; line-height: 1.25; }
+  .heading-actions { max-width: none; width: 100%; justify-content: flex-start; }
+  .heading-actions > button { white-space: normal; max-width: 100%; }
+  .driver-summary { flex-wrap: wrap; }
+  .driver-summary p { flex-basis: 100%; margin-left: 12px; }
+  .initialize-entry { margin-left: auto; }
+  .filter-tabs { flex-wrap: wrap; }
+  .page-footer { gap: 8px; flex-wrap: wrap; }
+  .method-tabs { flex-wrap: wrap; }
+  .method-tabs button { white-space: normal; min-width: 0; }
+  .start-page header { flex-wrap: wrap; }
+}
+
+@media (max-width: 440px) {
+  .nav-item svg { display: none; }
+  .nav-item > span { overflow-wrap: normal; hyphens: auto; }
+}
+@media (max-width: 560px) {
+  .modal-heading { display: grid; grid-template-columns: minmax(0, 1fr) auto; }
+  .modal-heading h2 { grid-column: 1; grid-row: 1; }
+  .modal-heading .icon-button { grid-column: 2; grid-row: 1; }
+  .modal-heading .language-picker { grid-column: 1 / -1; grid-row: 2; margin-left: 0; }
+}

package/src/i18n.js

@@ -0,0 +1,174 @@
+import { messages } from './messages.js';
+
+export const LANGUAGES = Object.freeze([
+  { code: 'zh-CN', name: '简体中文' }, { code: 'zh-TW', name: '繁體中文' },
+  { code: 'en', name: 'English' }, { code: 'ja', name: '日本語' },
+  { code: 'ko', name: '한국어' }, { code: 'es', name: 'Español' },
+  { code: 'fr', name: 'Français' }, { code: 'de', name: 'Deutsch' },
+  { code: 'pt-BR', name: 'Português (Brasil)' },
+]);
+const STORAGE_KEY = 'device-center.locale';
+export function normalizeLocale(value) {
+  if (typeof value !== 'string') return null;
+  const tag = value.replaceAll('_', '-').toLowerCase();
+  if (/^zh(?:-|$)/.test(tag)) return /(?:hant|tw|hk|mo)(?:-|$)/.test(tag) ? 'zh-TW' : 'zh-CN';
+  if (/^pt(?:-|$)/.test(tag)) return 'pt-BR';
+  return LANGUAGES.find(item => item.code === tag.split('-')[0])?.code ?? null;
+}
+export function resolveLocale({ query, saved, languages = [] } = {}) {
+  return normalizeLocale(query) ?? normalizeLocale(saved) ?? languages.map(normalizeLocale).find(Boolean) ?? 'en';
+}
+export function translate(locale, key, values = {}) {
+  const code = normalizeLocale(locale) ?? 'en';
+  const entry = lang => Object.hasOwn(messages[lang], key) ? messages[lang][key] : undefined;
+  const text = entry(code) ?? entry('en') ?? entry('zh-CN') ?? key;
+  return text.replace(/\{([a-zA-Z0-9_]+)\}/g, (match, name) => Object.hasOwn(values, name) ? String(values[name]) : match);
+}
+let locale = 'zh-CN';
+export const getLocale = () => locale;
+export const t = (key, values) => translate(locale, key, values);
+export const h = (key, values) => t(key, values).replace(/[&<>"']/g, char => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[char]);
+let pickerSequence = 0;
+const globe = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" aria-hidden="true"><circle cx="12" cy="12" r="9"/><path d="M3 12h18M12 3a17 17 0 0 1 0 18 17 17 0 0 1 0-18Z"/></svg>';
+const chevron = '<svg class="language-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4"/></svg>';
+function pickerContents() {
+  const id = `language-menu-${++pickerSequence}`;
+  const current = LANGUAGES.find(item => item.code === locale);
+  return `<button type="button" class="language-trigger" data-language-trigger aria-label="${h('language')}: ${current.name}" aria-haspopup="menu" aria-expanded="false" aria-controls="${id}">${globe}<span>${current.code === 'pt-BR' ? 'Português' : current.name}</span>${chevron}</button>
+    <div class="language-menu" id="${id}" data-language-menu role="menu" aria-label="${h('language')}" hidden><div class="language-menu-title" aria-hidden="true">${h('language')}</div><div class="language-options" role="none">${LANGUAGES.map(item => `<button type="button" class="language-option" data-language-option="${item.code}" role="menuitemradio" aria-checked="${locale === item.code}" tabindex="-1" lang="${item.code}"><span>${item.name}</span><svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.7" aria-hidden="true"><path d="m3 8 3 3 7-7"/></svg></button>`).join('')}</div></div>`;
+}
+export function languagePickerMarkup() {
+  return `<div class="language-picker" data-language-picker>${pickerContents()}</div>`;
+}
+export function applyTranslations(root = document) {
+  for (const element of root.querySelectorAll('[data-i18n]')) element.textContent = t(element.dataset.i18n);
+  for (const attribute of ['placeholder', 'title', 'aria-label', 'content']) {
+    for (const element of root.querySelectorAll(`[data-i18n-${attribute}]`)) element.setAttribute(attribute, t(element.getAttribute(`data-i18n-${attribute}`)));
+  }
+}
+// Only explicit UI markers are translated. User names, tags, code and paths are untouched.
+export function initLanguage({ onChange = () => {} } = {}) {
+  let saved;
+  try { saved = localStorage.getItem(STORAGE_KEY); } catch { /* Private mode can deny storage. */ }
+  const params = new URLSearchParams(location.search);
+  locale = resolveLocale({ query: params.get('lang'), saved, languages: navigator.languages ?? [navigator.language] });
+  if (normalizeLocale(params.get('lang'))) {
+    try { localStorage.setItem(STORAGE_KEY, locale); } catch { /* Share links also work without storage. */ }
+  }
+  const apply = () => {
+    document.documentElement.lang = locale;
+    document.documentElement.dir = 'ltr';
+    applyTranslations();
+    for (const picker of document.querySelectorAll('[data-language-picker]')) picker.innerHTML = pickerContents();
+    // Language links stay on this origin and never include account/pairing information.
+    for (const link of document.querySelectorAll('a[data-language-link]')) {
+      const url = new URL(link.getAttribute('href'), location.origin);
+      if (url.origin === location.origin) { url.searchParams.set('lang', locale); link.setAttribute('href', `${url.pathname}${url.search}${url.hash}`); }
+    }
+    onChange(locale);
+  };
+  const closeMenus = (restoreFocus = false) => {
+    for (const picker of document.querySelectorAll('[data-language-picker]')) {
+      const trigger = picker.querySelector('[data-language-trigger]');
+      const menu = picker.querySelector('[data-language-menu]');
+      if (!menu || menu.hidden) continue;
+      menu.hidden = true; trigger.setAttribute('aria-expanded', 'false');
+      if (restoreFocus) trigger.focus({ preventScroll: true });
+    }
+  };
+  const openMenu = (picker, last = false) => {
+    closeMenus();
+    const trigger = picker.querySelector('[data-language-trigger]');
+    const menu = picker.querySelector('[data-language-menu]');
+    menu.hidden = false; trigger.setAttribute('aria-expanded', 'true');
+    const anchor = trigger.getBoundingClientRect();
+    const size = menu.getBoundingClientRect();
+    menu.style.left = `${Math.max(12, Math.min(anchor.right - size.width, innerWidth - size.width - 12))}px`;
+    const top = anchor.bottom + 8;
+    menu.style.top = `${Math.max(12, top + size.height <= innerHeight - 12 ? top : anchor.top - size.height - 8)}px`;
+    const options = [...menu.querySelectorAll('[data-language-option]')];
+    (last ? options.at(-1) : menu.querySelector('[aria-checked="true"]') ?? options[0])?.focus({ preventScroll: true });
+  };
+  const choose = (value, picker) => {
+    const next = normalizeLocale(value); if (!next) return;
+    const inDialog = Boolean(picker.closest('[role="dialog"]'));
+    closeMenus(true);
+    locale = next;
+    try { localStorage.setItem(STORAGE_KEY, locale); } catch { /* Selection still works in memory. */ }
+    const url = new URL(location.href); url.searchParams.set('lang', locale);
+    try { history.replaceState(null, '', url); } catch { /* Do not prevent language selection. */ }
+    apply();
+    const container = picker.isConnected ? picker : document.querySelector(inDialog ? '[role="dialog"]' : '.topbar') ?? document;
+    container.querySelector('[data-language-trigger]')?.focus({ preventScroll: true });
+  };
+  // Capture events before the page's dialog handlers; Escape closes this menu first.
+  document.addEventListener('click', event => {
+    const trigger = event.target.closest('[data-language-trigger]');
+    const option = event.target.closest('[data-language-option]');
+    if (trigger) {
+      event.stopPropagation();
+      if (trigger.getAttribute('aria-expanded') === 'true') closeMenus(true);
+      else openMenu(trigger.closest('[data-language-picker]'));
+    } else if (option) {
+      event.stopPropagation(); choose(option.dataset.languageOption, option.closest('[data-language-picker]'));
+    } else if (!event.target.closest('[data-language-menu]')) closeMenus();
+  }, true);
+  document.addEventListener('keydown', event => {
+    const picker = event.target.closest('[data-language-picker]');
+    if (!picker) return;
+    const menu = picker.querySelector('[data-language-menu]');
+    if (menu.hidden) {
+      if (event.target.matches('[data-language-trigger]') && ['ArrowDown', 'ArrowUp'].includes(event.key)) {
+        event.preventDefault(); event.stopPropagation(); openMenu(picker, event.key === 'ArrowUp');
+      }
+      return;
+    }
+    if (event.key === 'Escape') { event.preventDefault(); event.stopPropagation(); closeMenus(true); return; }
+    const options = [...menu.querySelectorAll('[data-language-option]')];
+    const index = options.indexOf(document.activeElement);
+    let next;
+    if (event.key === 'Home') next = 0;
+    else if (event.key === 'End') next = options.length - 1;
+    else if (event.key === 'ArrowDown') next = (index + 2) % options.length;
+    else if (event.key === 'ArrowUp') next = (index - 2 + options.length) % options.length;
+    else if (event.key === 'ArrowRight') next = (index + 1) % options.length;
+    else if (event.key === 'ArrowLeft') next = (index - 1 + options.length) % options.length;
+    if (next !== undefined) { event.preventDefault(); event.stopPropagation(); options[next].focus(); }
+    if (event.key === 'Tab') closeMenus(true);
+  }, true);
+  document.addEventListener('focusout', event => {
+    const picker = event.target.closest('[data-language-picker]');
+    if (picker?.isConnected && !picker.contains(event.relatedTarget)) closeMenus();
+  });
+  document.addEventListener('scroll', event => { if (!event.target.closest?.('[data-language-menu]')) closeMenus(); }, true);
+  window.addEventListener('resize', () => closeMenus());
+  apply();
+  return locale;
+}
+
+// Compatibility for server-owned diagnostics only; never pass device names or user input.
+const REPORT_MESSAGE_KEYS = {
+  "容器不能代表宿主内存": "metric.containerMemory",
+  "容器不能代表宿主磁盘": "metric.containerDisk",
+  "无法读取系统内存": "metric.memoryFailure",
+  "无法读取用户目录所在卷": "metric.diskFailure",
+  "尚无有效 SSH 采集": "metric.sshPending",
+  "SSH 内存采集失败": "metric.sshMemory",
+  "SSH 磁盘采集失败": "metric.sshDisk",
+  "容器不读取宿主 SSH 配置。请在宿主运行 Driver。": "notice.container",
+  "本机尚无可读取的 SSH 配置。": "notice.missing",
+  "Include 路径过深，已跳过。": "notice.deep",
+  "Include 目录读取达到上限，候选可能不完整。": "notice.directoryLimit",
+  "已跳过目录外的 Include。": "notice.outside",
+  "部分 Include 无法读取。": "notice.unreadable",
+  "配置读取达到上限，部分候选未列出。": "notice.limit",
+  "已跳过受限目录外或非 config / .conf 的 Include。": "notice.restricted",
+  "已跳过循环 Include。": "notice.loop",
+  "配置文件过大或不是普通文件，已跳过。": "notice.fileSize",
+  "配置文件过大，已跳过。": "notice.large",
+  "文件不是 SSH 配置，已忽略。": "notice.notConfig",
+  "候选数达到上限。": "notice.candidateLimit",
+  "含 Match 条件：仅登记别名，未解析条件或执行命令。": "notice.match",
+  "已跳过 Host / Match 内的条件 Include，候选可能不完整。": "notice.conditional"
+};
+export const reportMessage = value => Object.hasOwn(REPORT_MESSAGE_KEYS, value) ? t(REPORT_MESSAGE_KEYS[value]) : value;

package/src/install-prompt.js

@@ -0,0 +1,19 @@
+import { translate } from './i18n.js';
+
+export function localizedInstallPrompt(plan, locale) {
+  const c = plan.commands;
+  const tr = (key, values) => translate(locale, key, values);
+  return [
+    tr('prompt.intro'),
+    tr('prompt.choice', { mode: tr(plan.mode === 'local' ? 'guide.local' : plan.mode === 'official' ? 'guide.hosted' : 'guide.custom'), version: plan.version, run: tr(plan.background ? 'prompt.background' : 'prompt.foreground') }),
+    plan.controlOrigin ? tr('prompt.private', { origin: plan.controlOrigin }) : '',
+    `1. ${tr('prompt.environment')}`,
+    `2. ${tr('prompt.existing', { url: plan.url, status: c.bindingStatus, service: c.serviceStatus })}`,
+    `3. ${tr('prompt.userInstall')}\n   ${c.install}\n   ${c.version}\n   ${tr('prompt.config')}`,
+    `4. ${plan.background ? `${tr('prompt.bg')}\n   ${c.servicePlan}\n   ${c.serviceInstall}\n   ${c.serviceStatus}` : `${tr('prompt.fg')}${plan.controlOrigin ? '' : `\n   ${c.foreground}`}`}`,
+    `5. ${plan.controlOrigin ? `${tr('prompt.pairBefore')}\n   ${c.pairingPlan}\n   ${c.connect}\n   ${tr('prompt.pairAfter', { origin: plan.controlOrigin })}` : tr('prompt.local')}`,
+    `6. ${tr('prompt.mcp', { url: plan.url, mcp: plan.mcpUrl })}`,
+    `7. ${tr('prompt.verify')}\n   ${tr('prompt.uninstall')}\n   ${c.uninstallService}`,
+    tr('prompt.boundaries'), tr('prompt.end'),
+  ].filter(Boolean).join('\n\n');
+}