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

package/CONTRIBUTING.md

@@ -7,3 +7,5 @@ Use Node.js 24, `npm ci --ignore-scripts`, `npm run dev`, `npm run check`, and `
 Preserve the compact sidebar, optional MCP setup, truthful device states, and separate memory/disk observations. The local process represents its machine; a container cannot claim its host. SSH configuration discovery must not execute commands or read keys, and association must not imply connectivity or task authority. Do not restore sample projects, hosted quota displays or simulated cloud synchronization.
 
 Never add real secrets to prompts, packages, fixture data or logs. SSH observation is an explicit owner action using a fixed script, isolated configuration, existing authentication and strict host trust; GET and MCP must never trigger connections. Tests inject subprocess results and do not contact real hosts. Resource enrollment, Agent installation, network discovery, tunnels, cloud deployment and remote tasks require separately scoped implementation and review. Do not run service installation or Docker deployment merely to validate a UI change. Keep user data and unrelated services intact.
+
+Pull requests run the existing checks and tests on GitHub-hosted macOS and Ubuntu. Main pushes additionally validate and build on two dedicated self-hosted macOS runners registered only to this repository. These runners reject PR jobs and hold no production credentials. After the complete main CI succeeds, a separate GitHub-hosted production job builds the exact SHA, deploys through a restricted receiver, verifies public bytes and login protection, and confirms health or restores the previous code. See [delivery configuration](docs/development/delivery-profile.md) for the authorized channel, activation evidence, credentials boundary and recovery. npm publication remains a separate release.

package/Dockerfile

@@ -1,9 +1,10 @@
 # Optional local-only control plane, not a host/resource Agent.
 FROM node:24-bookworm-slim
 WORKDIR /app
-COPY --chown=node:node package.json npm-shrinkwrap.json index.html login.html ./
+COPY --chown=node:node package.json npm-shrinkwrap.json index.html login.html start.html favicon.svg ./
 COPY --chown=node:node server ./server
 COPY --chown=node:node src ./src
+COPY --chown=node:node docs/agent-install.md docs/friend-trial.md docs/remote-access.md docs/device-profiles.md docs/troubleshooting.md ./docs/
 RUN npm ci --omit=dev --ignore-scripts --no-audit --no-fund && mkdir -p /app/data && chown node:node /app/data
 USER node
 ENV PORT=5173 DEVICE_CENTER_RUNTIME=container DEVICE_CENTER_DB_PATH=/app/data/device-center.sqlite

package/README.md

@@ -2,14 +2,31 @@
 
 界面与 Agent 安装说明支持简中、繁中、英、日、韩、西、法、德、巴西葡语。页面顶部可切换，也可分享 `/start?lang=en`、`/start?lang=ja`。详见[多语言说明](docs/i18n.md)。
 
-让主力电脑上的智能体，使用自己的闲置设备。MIT · Node.js 24 · macOS / Linux · beta。
+让主力电脑上的智能体，使用自己的闲置设备。MIT · Node.js 24 · macOS / Linux / Windows 11 预览 · beta。
 
 一个本机连接器，加一个可选的云端控制面。真实本机内存、磁盘分别展示；已有 SSH 配置可一键关联并执行固定只读检查；设备 Agent 可通过域名绑定账号，主动回报状态。指定日志经设备主人单独授权后，以双向 TLS 1.3 直连或密文中转读取。没有默认示例设备或虚构在线状态。
 
 ## 快速使用
 
+### 简化接入（0.2.0-beta.5）
+
+一页指南明确提供 **交给 Agent／手动安装**，目标设备不需要先安装 AI Agent：
+
+```text
+复制安装说明给 Agent（或复制终端脚本）
+    → 自动安装并打开本次绑定页
+    → 本人登录、核对指纹、批准一次
+    → 自动确认资源回报，Agent 继续配置 MCP
+```
+
+有浏览器的设备无需搬运配对码，也不需要回 Agent 回复“已批准”。无浏览器服务器可选手动安装：目标终端运行脚本，在另一台电脑登录控制面，填入终端码、核对指纹并批准。全新安装脚本会配置用户级后台服务；已有安装时停止并保留设置。AI Agent／MCP 仅是管理电脑的可选能力。身份私钥留在设备；安装绑定只允许资源回报，远程日志仍需另外授权。[手动步骤与排查](docs/agent-install.md#手动安装目标设备没有-ai-agent)
+
+本指南固定 **0.2.0-beta.5**，新增 Windows 11 预览接入。无需 AI Agent 或 AD 域，使用普通用户 PowerShell、Node.js 24+，按 [Windows 11 验收](docs/windows-acceptance.md)操作；安装前以公开 npm registry 的版本记录为准。Windows 11 后台与真实绑定仍需实机验收。官方控制面已包含登录恢复修复，旧客户端仍可终端填码。
+
 希望交给本机 Agent 安装时，按[Agent 安装指南](docs/agent-install.md)选择本机、官方托管或已有自建服务。“交给 Agent 安装”可直接复制完整说明；登录和设备绑定仍由用户核对。朋友试用从[一页指南](https://devices.owenshen.top/start)开始，无需先登录。
 
+0.2.0-beta.4 增加 `connect --browser --confirm` 浏览器交接、并列的 Agent／手动安装脚本与图形指引；无浏览器设备仍可终端填码。
+
 0.2.0-beta.3 增加九语言界面与安装说明，语言菜单支持键盘、窄屏与输入保留。长文档和 CLI 仍以中文为主。
 
 0.2.0-beta.2 增加设备命名、类型、用途、标签、手动服务清单及“采集一次”，见[设备说明与手动采集](docs/device-profiles.md)。旧 Driver 需升级后才能响应云端手动采集；服务与应用仍由用户手动登记。
@@ -19,7 +36,7 @@
 只用本机，不注册账号：
 
 ```sh
-npx --yes device-center@0.2.0-beta.3 start
+npx --yes device-center@0.2.0-beta.5 start
 ```
 
 打开 `http://127.0.0.1:5174`，将 `/mcp` 添加到本机智能体。侧栏“开始使用”按管理电脑 → 智能体 → 设备引导；导入 SSH 后检查一次连通性。没有可用 Agent/SSH 的设备保持未知；资源快照过期显示“待刷新”，不代表密钥过期。列表刷新不主动连接 SSH。
@@ -27,12 +44,12 @@ npx --yes device-center@0.2.0-beta.3 start
 需要在外查看设备、使用日志中转：
 
 ```sh
-npx --yes device-center@0.2.0-beta.3 plan
-npx --yes device-center@0.2.0-beta.3 connect --confirm
+npx --yes device-center@0.2.0-beta.5 plan
+npx --yes device-center@0.2.0-beta.5 connect --browser --confirm
 # 自建控制面可指定 --cloud https://devices.example.com
 ```
 
-默认 [官方控制面](https://devices.owenshen.top)，登录自己的 App Services／个人站统一账号。在面板输入终端的五分钟配对码，核对完整公钥指纹和回报范围并批准。私钥留在设备，不放进脚本、prompt 或压缩包。默认不分享 SSH 信息、不开 LAN 端口、不安装后台服务。配对只授权资源回报。
+默认 [官方控制面](https://devices.owenshen.top)，浏览器自动打开本次申请，登录自己的 App Services／个人站统一账号，核对终端的完整公钥指纹和回报范围并批准一次。没有浏览器时去掉 `--browser`，在另一台电脑填写终端的五分钟配对码。私钥留在设备，不放进脚本、prompt 或压缩包。默认不分享 SSH 信息、不开 LAN 端口、不安装后台服务。配对只授权资源回报。
 
 [远程日志：两端授权、直连与中转](docs/remote-access.md) · [常驻与 npm](docs/npm.md) · [账号模式与自建](docs/hosted-access.md) · [故障排查](docs/troubleshooting.md)
 
@@ -45,7 +62,7 @@ npx --yes device-center@0.2.0-beta.3 connect --confirm
 | 日志 | 指定标签/绝对文件/管理设备/有效期，最大64KiB；本机审计 |
 | 访问路径 | Agent 精确私网入口优先，网络失败回退官方/自建 HTTPS 密文中转；证书错误停止 |
 | 中转额度 | 每账号100MiB/UTC日、全实例1GiB/日，持久计数、并发与速率限制 |
-| 尚未提供 | 任意远程命令、通用文件传输、Windows 原生 Agent、云端 MCP、CF 专用适配器、计费、自动迁移 |
+| 尚未提供 | 任意远程命令、通用文件传输、云端 MCP、CF 专用适配器、计费、自动迁移 |
 
 日志操作通过 `device_center_read_log` 请求，不能用 MCP 授权自身。用户自己的智能体仍需在目标设备单独配置授权。已有 SSH 路径独立使用，SSH“连接计划”不会自动改成新 Agent 通道。Docker 代表容器自身，不能当作宿主机；宿主运行原生 Driver 与本机智能体交互。
 
@@ -70,4 +87,4 @@ npm run verify:package
 
 需要已有受信任 App Services 共享账号服务与同父域会话；不是通用第三方 OAuth。个人部署可选 personal + ownerEmail。旧个人数据切多用户前按[迁移与回退说明](docs/hosted-access.md)核验原所有者映射；不能只切回旧代码而保留多用户数据库。
 
-当前没有密钥托管、安装时自动联网或远程 shell。安全边界与披露方式见 [SECURITY](SECURITY.md)。npm 包公开不自动改变 GitHub 仓库可见性；发布包按固定源码提交构建；手工发布不等同主线 CI 自动交付。
+当前没有密钥托管、安装时自动联网或远程 shell。安全边界与披露方式见 [SECURITY](SECURITY.md)。npm 包公开不自动改变 GitHub 仓库可见性；npm 发布独立于 Web 部署。主线验证、自动部署和失败恢复的机制及启用证据见[持续交付](docs/development/delivery-profile.md)。

package/SECURITY.md

@@ -1,10 +1,16 @@
 # Security
 
-Device Center 0.2.0-beta.1 is a beta for macOS/Linux and Node.js 24. Local HTTP/MCP is loopback-only with Host/Origin checks; do not expose it publicly. Cloud deployment requires an exact HTTPS origin, a proxy overwriting Host/scheme, and a private authentication config. App Services identities are verified against the configured upstream; tenant scope comes from verified stable issuer/subject. Authentication outages fail closed.
+Device Center beta.5 supports macOS/Linux and adds Windows 11 preview support with Node.js 24. Check the npm registry for publication status; Windows 11 end-user acceptance is still pending. Local HTTP/MCP is loopback-only with Host/Origin checks; do not expose it publicly. Cloud deployment requires an exact HTTPS origin, a proxy overwriting Host/scheme, and a private authentication config. App Services identities are verified against the configured upstream; tenant scope comes from verified stable issuer/subject. Authentication outages fail closed.
 
 Device keys remain in owner-private local files. Pairing is short-lived, one-time and separately approved after a full fingerprint comparison. Binding permits telemetry, not operations. Remote log access requires local pinned peer certificates plus a target-owned file/label/expiry grant. Node/OpenSSL TLS 1.3 mutually authenticates both devices over an approved LAN endpoint or opaque HTTPS relay; certificate and hostname verification remain enabled. The control plane sees metadata and ciphertext, not log plaintext or private keys. First-use fingerprint verification requires a trusted channel.
 
-Only bounded log tail reads are available. No arbitrary commands, generic file transfer, Windows native Agent or cloud MCP. Symlink/multiple-hardlink/non-regular log files are rejected. Cloud revocation is checked on both routes. Local audit is bounded and fails closed at capacity. OS administrators, compromised endpoints and already-authorized readers remain trust boundaries. Keys are not TPM/Keychain wrapped. See [permissions, quotas, certificate renewal and limitations](docs/remote-access.md).
+Only bounded log tail reads are available. No arbitrary commands, generic file transfer or cloud MCP. Symlink/multiple-hardlink/non-regular log files are rejected. Cloud revocation is checked on both routes. Local audit is bounded and fails closed at capacity. OS administrators, compromised endpoints and already-authorized readers remain trust boundaries. Keys are not TPM/Keychain wrapped. See [permissions, quotas, certificate renewal and limitations](docs/remote-access.md).
+
+## Windows candidate
+
+Windows identity JSON is encrypted using local DPAPI CurrentUser, never LocalMachine; only ciphertext is persisted. The application directory and newly created private files allow the current user and SYSTEM only, with owner and reparse-point checks. Existing insecure directories are rejected rather than silently repaired. POSIX owner/mode checks remain unchanged. Windows ACL checks are refreshed on metadata changes and at least every 30 seconds; decrypted identity is cached only in the running process. This does not defend against malicious software running as the same user or an OS administrator, and copying the file to another computer/user is not a supported migration method. See [Microsoft DPAPI](https://learn.microsoft.com/en-us/dotnet/api/system.security.cryptography.protecteddata.protect).
+
+The optional background task uses the current user's InteractiveToken and Limited run level, at logon only. No passwords, AD domain, elevation, execution-policy changes, firewall changes or boot/SYSTEM service are needed. Existing tasks are not overwritten, and uninstall validates the exact task and checks that its listener stopped before removing the config. A policy restriction fails closed with a foreground option; reports cannot continue during logoff, sleep or loss of network. Windows log grants reject UNC paths and alternate data streams. Windows CI checks PowerShell parsing, DPAPI/NTFS fixtures and isolated npm/foreground installation. Windows 11 task lifecycle, restart and real cloud pairing still require end-user acceptance; CI is not proof of those results.
 
 Telemetry inventory never initiates SSH. Explicit local checks use bounded fixed scripts and strict known-host verification; private-key contents and raw SSH output are not imported. Containers do not read host SSH or claim host metrics.
 

package/bin/device-center.mjs

@@ -30,12 +30,13 @@ export function parseCli(argv = []) {
 export function helpText() {
   return `Device Center ${version()} · 只读管理 Driver 源码原型
 
-需要 Node.js 24；管理 Driver 支持 macOS / Linux。
+需要 Node.js 24；管理 Driver 支持 macOS / Linux / Windows 11（候选，待实机验收）。
 
 device-center start [--port 5174]             启动本机面板与只读 MCP
 device-center plan --cloud https://你的域名    预览回报范围，不生成身份或联网
-device-center connect --cloud https://你的域名 --confirm
-                                            在本机生成身份，申请配对后等待你核对批准
+device-center connect --cloud https://你的域名 --browser --confirm
+                                            打开浏览器核对批准一次，自动等待与核验首次回报
+                                            无浏览器服务器：去掉 --browser，在本机终端手动配对
 device-center status                         查看已有绑定，不显示私钥
 device-center run [--port 5174]               前台恢复已绑定 Driver
 device-center disconnect --confirm           通知云端撤销，保留本机身份
@@ -46,7 +47,8 @@ device-center service plan|status|install|uninstall [--port 5174] [--confirm]
 本机无需平台注册；connect 默认申请接入 https://devices.owenshen.top，需登录自己的账号核对批准。
 --cloud 可使用自建域名。device-center access help 查看受限日志授权与可选局域网直连。
 支持 TLS 1.3 双向认证的日志读取与密文中转，默认100MiB/账号/日；不会自动获得操作权限。
-任意远程命令、通用文件传输和 Windows 原生 Driver 尚未提供。安装包不含身份或配对码。
+Windows 身份由 DPAPI 当前用户保护，后台在当前用户登录后启动；注销或休眠会停止回报。
+任意远程命令和通用文件传输尚未提供。安装包不含身份或配对码。
 使用 npx 时只运行前台；常驻请先将本包固定版本安装到长期目录，再单独 install。
 `;
 }
@@ -62,7 +64,6 @@ export async function main(argv = process.argv.slice(2)) {
   }
   const driver = await import('../scripts/driver.mjs');
   if (plan.command === 'start') {
-    if (process.platform === 'win32') throw new Error('Windows 原生管理 Driver 尚未支持。');
     await driver.runLocal({ port: plan.port }); return;
   }
   return driver.main([plan.command, ...plan.args]);

package/docs/agent-install.md

@@ -1,8 +1,8 @@
-# 让 Agent 安装 Device Center
+# 安装 Device Center：Agent 或手动
 
-用户选择模式后，把完整安装说明交给**正在目标电脑上运行、具备本机安装能力的 Agent**。网页只复制说明，不会远程替浏览器所在电脑安装软件。
+目标设备只需要 Device Center Driver，不要求已经安装 AI Agent。一页指南提供 **交给 Agent** 和 **手动安装** 两个入口。网页只复制内容，安装发生在你执行脚本的目标设备上。
 
-`device-center@0.2.0-beta.3` 提供“交给 Agent 安装”、设备说明与手动采集。新用户可在[一页试用指南](https://devices.owenshen.top/start)免登录选择方式并复制完整说明。
+**本指南固定 `device-center@0.2.0-beta.5`（npm `beta`）**。macOS/Linux 使用下方终端命令；Windows 11 预览版按 [PowerShell 安装图示](windows-acceptance.md)操作。实际发布状态以 npm registry 为准；旧 beta.4 不支持原生 Windows。
 
 ## 用户只需要选择一种方式
 
@@ -14,13 +14,41 @@
 
 托管的是面板、设备登记与中转服务。设备身份私钥和指定日志授权仍在设备上，不上传私钥，不让服务商代为持有设备登录能力。
 
+## 手动安装：目标设备没有 AI Agent
+
+新版指南选择使用方式后，点 **手动安装**，复制 **终端安装脚本**。主面板的“安装 Device Center”中也有手动指南入口，会带入当前选择的控制面。
+
+复制按钮下方的三张窗口示意按选择切换：**目标电脑的终端／Agent 对话 → 浏览器绑定（本机模式为安装检查）→ 设备列表**。点“看下一步”可预看后续动作；切图不会执行安装、批准绑定或表示操作成功。无浏览器模式会画出“目标终端 → 另一台电脑的浏览器”；本机面板地址则明确要求在刚安装的那台电脑打开。
+
+1. **准备环境**：macOS / Linux、Node.js 24+ 和 npm。缺少 Node.js 时先从官方来源安装；Windows 11 使用指南中的 PowerShell 脚本（无需管理员或 AD），不要粘贴下方 macOS/Linux 命令。脚本只支持全新安装，发现已有 CLI 会停止，不覆盖身份或配置。
+2. **在目标设备执行**：Mac 打开“终端”；Linux 使用终端，或你已经建立的 SSH 会话。粘贴整块脚本并执行。不需要把它发给 AI Agent，也不会替你建立 SSH 连接。
+3. **本机使用**：不登录、不申请云端绑定。安装结束后在这台设备打开 `http://127.0.0.1:5174` 查看资源。
+4. **托管／自建接入**：复制前选择目标设备有没有浏览器：
+
+   | 目标设备 | 接下来的操作 |
+   | --- | --- |
+   | 有浏览器 | 脚本执行 `connect --browser --confirm`，自动打开本次申请。登录自己的账号，对照终端完整公钥指纹并批准一次。程序自动等待结果并核验首次回报。 |
+   | 无浏览器／服务器 | 脚本执行不带 `--browser` 的 `connect --confirm`。保持终端打开，在另一台有浏览器的电脑登录同一控制面，点“连接我的电脑”，输入终端的五分钟配对码，对照完整公钥指纹并批准。设备自动继续；云端列表首次收到数据后显示在线。 |
+
+5. **查看结果**：后台用户服务应为运行状态，云端要有新的实际回报时间；“已绑定”与“已收到资源回报”是两件事。无需回到 Agent 回复“已批准”。不要重复绑定来解决未回报。
+
+AI Agent 和 MCP 是管理端的可选能力：只有以后想让某台电脑上的 AI Agent 使用 Device Center 时，才在**那台管理电脑**配置本机 MCP。目标设备没有 AI Agent，照样可以常驻回报并作为另行授权的日志读取目标。服务器的 `127.0.0.1` 指服务器自己，不能作为另一台电脑的远程 MCP 地址。
+
+### 手动模式遇到问题
+
+- **已有安装**：脚本停止是保留现有设置，不是安装成功。使用已有 CLI 的 `status`、`service status --port 5174` 核对版本、绑定与服务，再明确选择复用或升级。不要直接重装或解绑。
+- **没有浏览器／打开失败**：预先选择“无浏览器／服务器”。若已经运行过浏览器模式且打开失败，可以在目标终端重新运行同一条 `connect` 命令并去掉 `--browser`，以新申请为准。不要把配对码贴进 AI Agent 对话或共享截图。
+- **端口冲突**：保留其他程序，选明确可用的本机端口，并同步脚本里的服务、配对和面板地址。
+- **后台服务失败**：macOS 需要登录用户的 launchd；Linux 需要 `systemd --user`。脚本不会自动改系统权限或启用 linger。无人登录也要常驻的服务器，需管理员单独配置合适的服务生命周期；不满足时可按下面的前台方式使用。
+- **绑定后未回报**：检查 Driver 是否运行、设备是否休眠、到控制面域名的 HTTPS 出站连通性与系统时间。首次回报可能需约 30 秒；在面板核对真实时间，不把仅有本地绑定当作在线。不需要对公网开放设备端口。
+
 ## Agent 执行顺序
 
 只有用户明确要求在当前电脑安装并选择模式后，才能执行以下步骤。阅读本文本身不授予安装、配对或访问其他设备的权限。
 
 ### 1. 检查现有环境
 
-- 当前版只支持 macOS / Linux，需要 Node.js 24 或更高版本与 npm。缺少运行环境时使用官方来源；系统授权或管理员操作交由用户处理。Windows 原生 Driver 尚未支持，不能假称已安装成功。
+- 下方命令用于 macOS / Linux，需要 Node.js 24 或更高版本与 npm。缺少运行环境时使用官方来源；系统授权或管理员操作交由用户处理。Windows 11 预览版请按专用指南选择 PowerShell；不能假称未执行的安装已成功。
 - 检查已有 CLI、用户级服务、本机端口和绑定。已安装在下面固定位置时，可以运行 `"$HOME/.local/bin/device-center" status` 与 `"$HOME/.local/bin/device-center" service status --port 5174`，不要直接打开身份私钥文件。配置一致则复用；版本、控制面或启动方式冲突时解释，让用户选择。保留已有身份、数据库、MCP 配置和其他程序。
 - 默认端口 `5174`。若已被其他程序占用，选择明确的可用本机端口，并同步后面的面板、MCP、服务命令。不要停止其他监听进程，不扫描网络。
 
@@ -29,7 +57,7 @@
 全新安装可以使用：
 
 ```sh
-npm install --global --prefix "$HOME/.local" --ignore-scripts device-center@0.2.0-beta.3
+npm install --global --prefix "$HOME/.local" --ignore-scripts device-center@0.2.0-beta.5
 "$HOME/.local/bin/device-center" --version
 ```
 
@@ -61,12 +89,18 @@ macOS 使用当前登录用户的 launchd；Linux 需要可用的 `systemd --use
 
 ```sh
 "$HOME/.local/bin/device-center" plan --cloud 'https://devices.owenshen.top' --port 5174
-"$HOME/.local/bin/device-center" connect --cloud 'https://devices.owenshen.top' --port 5174 --confirm
+"$HOME/.local/bin/device-center" connect --cloud 'https://devices.owenshen.top' --port 5174 --browser --confirm
 ```
 
 自建模式替换为用户明确提供的 HTTPS 控制面域名，不携带路径、账号或参数。不能自动覆盖其他控制面的绑定。
 
-用户在该控制面登录自己的账号，核对本机终端的完整公钥指纹，再手动批准新增设备。Agent 不代为批准，不读取密码、cookie 或私钥；配对码留在本机终端，不贴进智能体对话、脚本或链接。若 Agent 的执行工具会把终端配对码自动记录进对话，只把这一步交给用户在本机终端执行，Agent 继续其他检查。
+Agent 直接执行带 `--browser` 的命令并保持进程。命令自动打开本机默认浏览器，申请自动带入；未登录时先登录，之后自动回到同一申请。用户只需核对命令输出的完整公钥指纹，并在浏览器批准一次。Agent 不代为批准，不读取密码、cookie、私钥或带凭据的浏览器链接。
+
+浏览器模式不向 stdout/stderr 输出配对码或临时登记票据。票据仅通过系统浏览器打开，放在 URL fragment 中，页面立即移除，暂存在同标签页的 sessionStorage 供登录跳转使用；五分钟有效、一次批准，服务端仅存摘要。不要复制、分享或记录该链接。票据不进入提示词、安装脚本或压缩包。
+
+用户批准后，命令自动继续并等待首次资源回报，返回 `firstReport.verified`。**不要让用户去终端重新执行，也不要要求用户回复“已批准”。** Agent 持续观察自己启动的进程，`firstReport.verified=true` 后继续 MCP 配置；前台模式进程会继续运行，不必等它退出。`false` 表示绑定成功但回报未证实，检查服务、网络与时钟，不要重新绑定。
+
+仅当目标机没有浏览器、打开失败或系统阻止打开时，再让用户在目标机终端运行去掉 `--browser` 的同一条 connect 命令。配对码只留在本机终端与登录后的面板，不进入 Agent 对话。旧控制面需要先升级；命令不会自动降级并打印凭据。
 
 前台 `connect` 在批准后启动 Driver；已经运行的用户服务会读取绑定并开始回报。不能仅凭 `configured=true` 宣称云端已收到数据，要核对真实回报和时间。
 
@@ -84,7 +118,7 @@ http://127.0.0.1:5174/mcp
 
 必须检查实际结果：
 
-1. `/api/health` 返回 `ok: true` 且为本机模式；用 CLI `--version` 检查安装版本，并核对服务计划引用的安装目录。健康接口本身不提供版本号。
+1. `/api/health` 返回 `ok: true` 且为本机模式，其中 `version` 应与 CLI `--version` 一致；并核对服务计划引用的安装目录。npm 安装的 `sourceSha` 为 `null`，属正常。
 2. `/api/overview` 的本机内存、磁盘为真实采集，失败项如实报告。
 3. 选择后台模式时，核实服务实际运行，而不仅是配置文件存在。
 4. 当前智能体实际调用 `device_center_list_resources`。
@@ -98,7 +132,7 @@ http://127.0.0.1:5174/mcp
 
 默认不导入或连接 SSH 主机、不分享 SSH、不扫描局域网、不开放设备入站端口、不配置隧道、不授予日志或命令权限。安装与绑定不等于远程操作授权。
 
-## 给 Agent 的公开文档入口
+## 公开文档入口
 
 当前源码服务提供固定路径 `GET /install/agent.md`，仅返回本文，不需要登录，不含账号、身份或设备清单。官方入口为 https://devices.owenshen.top/install/agent.md；自建服务使用自己的域名与相同路径。
 

package/docs/driver-binding.md

@@ -1,10 +1,20 @@
 # 通过域名连接管理电脑
 
-> 0.2.0-beta.1 更新：账号隔离、TLS 1.3 双向认证密文中转、独立授权的日志尾读及获准精确 LAN 优先已实现。旧文中的“尚未实现”传输描述属于此前阶段；实际操作与边界以 [远程日志](remote-access.md) 和 README 为准。通用远程命令、文件传输、Windows 原生 Agent 与自动迁移仍未提供。
-当前支持个人控制面与 macOS / Linux 管理 Driver 的配对、只读资源回报和撤销。它不是远程终端或隧道；Windows Driver、独立安装器、系统钥匙串封装、远程任务和自动选路仍待实现。
+> 0.2.0-beta.1 更新：账号隔离、TLS 1.3 双向认证密文中转、独立授权的日志尾读及获准精确 LAN 优先已实现。旧文中的“尚未实现”传输描述属于此前阶段；实际操作与边界以 [远程日志](remote-access.md) 和 README 为准。通用远程命令、文件传输、自动迁移仍未提供；Windows 11 提供 beta.5 预览接入，见 [Windows 验收](windows-acceptance.md)。
+当前支持个人控制面与 macOS / Linux 管理 Driver 的配对、只读资源回报和撤销。它不是远程终端或隧道；Windows 11 候选的 PowerShell 安装、DPAPI/NTFS 身份与用户登录任务已实现，实机验证待完成；系统钥匙串/TPM封装与任意远程任务仍未实现。
 
 ## 三步接入
 
+### beta.4 简化接入（已发布）
+
+新版一页指南并列提供 Agent 说明和手动安装脚本。目标设备有浏览器时共用 `connect --browser --confirm`：自动打开 `/pair`，本人登录并核对完整公钥指纹、批准一次；CLI 自动检测结果并核验首次回报。无需手动搬运配对码，也不用回 Agent 回复“已批准”。手动模式还可选“无浏览器／服务器”，脚本生成不带 `--browser` 的命令，通过另一台电脑完成下面的填码流程。目标设备不需要 AI Agent 或 MCP。已有安装脚本停止保留设置；Agent 可核对后复用已有绑定，不重复登记。
+
+浏览器模式使用独立的 256 位随机登记票据，五分钟有效，服务端只存 SHA256 摘要。CLI 不输出它，仅通过默认浏览器打开 `/pair#ticket=…&expires=…`。fragment 不发送到 HTTP 服务器或 Referer；页面立即移除，仅在同标签页 sessionStorage 暂存以跨过登录，批准、取消、过期时移除。不把它放进提示词、安装脚本或归档；它不是账号登录或远程任务权限。拥有票据仍需登录并本人核对批准，设备领取结果仍必须证明持有私钥。不要分享绑定链接或批准陌生请求。
+
+自动打开失败时明确转手动，不自动输出凭据。自建控制面必须升级后才支持浏览器交接。`firstReport.verified=false` 会明确区分“已绑定”和“首次回报未确认”，不应重新绑定。
+
+### 手动兼容流程
+
 1. 登录自己的 HTTPS 控制面，点 **连接我的电脑**。下载 Driver 源码包，在管理电脑解压到长期保留的目录；需要 Node.js 24，无第三方运行依赖。已有最新版源码仓库可直接使用。
 2. 在该目录的终端运行面板复制的命令。下面是占位域名，请替换为自己的 HTTPS 域名。npm 分发候选见 [npm 使用与发布说明](npm.md)：
 
@@ -64,6 +74,6 @@ npm run service -- install --confirm --port 5174
 
 当前测试验证隔离环境中的协议和 HTTP 接口。实际身份生成、用户批准、目标平台常驻、真实网络下连续回报需要由使用者执行接入后验收；不能以测试数据冒充已绑定设备。远程命令、文件传输与中继任务权限没有因配对而授予。
 
-## 账号归属与候选版本
+## 账号归属与版本兼容
 
-当前源码 beta.2 增加显式多用户账号隔离，未发布或部署；npm beta.1 客户端的机器配对/签名协议保持兼容。个人模式仍为默认；多用户的面板批准需同时提交码与完整指纹，归属只取服务核验的账号，不接受客户端 tenantId。历史个人记录不自动转移；多账号数据不能交给旧的无隔离服务器读取。详见[托管接入、迁移与回退](hosted-access.md)。
+显式多用户隔离已在 beta.3 上线；beta.4 浏览器交接已随 npm 与官方控制面发布，旧客户端的手动配对与签名协议保持兼容。个人模式仍为默认；多用户批准需同时提交配对码或短时浏览器票据，以及完整指纹，归属只取服务核验的账号，不接受客户端 tenantId。历史个人记录不自动转移；多账号数据不能交给旧的无隔离服务器读取。详见[托管接入、迁移与回退](hosted-access.md)。

package/docs/friend-trial.md

@@ -1,8 +1,8 @@
 # Device Center · 朋友试用指南
 
-让本机 Agent 看见自己的电脑与闲置设备：真实内存、磁盘、设备用途，以及单独授权的指定日志。当前为 `0.2.0-beta.3` 公开试用版。
+让本机 Agent 看见自己的电脑与闲置设备：真实内存、磁盘、设备用途，以及单独授权的指定日志。本指南版本 `0.2.0-beta.5`，发布状态以 npm registry 为准。
 
-**入口：https://devices.owenshen.top/start**。支持 macOS / Linux，需要 Node.js 24+；Windows 原生版尚未支持。
+**入口：https://devices.owenshen.top/start**。支持 macOS / Linux，需要 Node.js 24+；Windows 11 提供 PowerShell 预览版，可选择“手动安装”，不需要 AI Agent 或 AD。
 
 ## 1. 把安装交给本机 Agent
 
@@ -14,11 +14,11 @@
 
 Agent 按说明检查已有配置、固定版本安装、设置用户级后台服务、配置 MCP 并核验结果。已有配置冲突时解释并让你选择，不自动覆盖。系统授权或当前 Agent 无法配置 MCP 时，会请你完成对应一步。
 
-不使用 Agent 时，可在全新环境运行 `npx --yes device-center@0.2.0-beta.3 start` 体验本机面板；这是前台方式，终端关闭后停止。长期使用按[完整安装指南](https://devices.owenshen.top/install/agent.md)固定安装。
+不使用 Agent 时，可在全新环境运行 `npx --yes device-center@0.2.0-beta.5 start` 体验本机面板；这是前台方式，终端关闭后停止。长期使用按[完整安装指南](https://devices.owenshen.top/install/agent.md)固定安装。
 
 ## 2. 托管模式才需要登录绑定
 
-在官方面板使用**自己的 App Services／个人站账号**登录；没有账号时在账号页注册。终端给出五分钟配对码和完整公钥指纹，在面板输入并核对后批准。
+在官方面板使用**自己的 App Services／个人站账号**登录；没有账号时在账号页注册。有浏览器的设备会自动打开本次绑定页，登录后核对完整公钥指纹并批准一次；无浏览器的设备在终端给出五分钟配对码和完整公钥指纹，在另一台电脑的面板输入并核对后批准。
 
 密码、私钥和配对码不发给朋友、不放入 Agent 对话。若 Agent 工具会把终端配对码记录进对话，仅在本机终端自行完成 `connect` 这一步。绑定只允许说明中的资源回报，不授予远程命令或日志权限。
 
@@ -39,4 +39,4 @@ Agent 按说明检查已有配置、固定版本安装、设置用户级后台
 
 把**系统、版本、所选模式、失败步骤、预期与实际结果**发给邀请你的人。附错误或截图前去掉私钥、配对码、cookie、设备地址及日志正文。
 
-**当前边界：**未提供任意远程命令、通用文件传输、Windows 原生 Driver、自动扫描、离线局域网授权、本机与云端说明同步。官方试用中转每账号每日 100 MiB（UTC），每方向 16 KiB/s。MIT npm 源码包公开；GitHub 仓库可见性独立管理。
+**当前边界：**未提供任意远程命令、通用文件传输、自动扫描、离线局域网授权、本机与云端说明同步。官方试用中转每账号每日 100 MiB（UTC），每方向 16 KiB/s。MIT npm 源码包公开；GitHub 仓库可见性独立管理。

package/docs/hosted-access.md

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

package/docs/npm.md

@@ -1,16 +1,20 @@
 # npm / npx 分发
 
-MIT，Node.js 24，macOS/Linux。当前版本 `0.2.0-beta.3`，使用 npm `beta` 渠道；是否上架以公开 registry 为准。
+MIT，Node.js 24。本指南固定 `0.2.0-beta.5`，支持 macOS/Linux，并提供 Windows 11 预览接入。使用 npm `beta` 渠道；`latest` 仍可能是旧版本，安装请写明版本，实际发布状态以公开 registry 为准。
+
+beta.5 新增 PowerShell 安装、DPAPI CurrentUser 身份保护与当前用户登录后台任务，详见 [Windows 验收](windows-acceptance.md)。发布先后顺序是新 CLI → 匿名下载验包 → 对应指南与控制面上线。旧客户端的终端填码仍兼容；回退网页或旧 CLI 不删除既有身份。
 
 ```sh
-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.3 connect --confirm
+npx --yes device-center@0.2.0-beta.5 --help
+npx --yes device-center@0.2.0-beta.5 plan
+# 主动接入默认官方服务；有浏览器时加 --browser 自动打开本次绑定页
+npx --yes device-center@0.2.0-beta.5 connect --browser --confirm
+# 无浏览器：在终端与另一台电脑的面板之间核对配对码
+npx --yes device-center@0.2.0-beta.5 connect --confirm
 # 自建服务
-npx --yes device-center@0.2.0-beta.3 connect --cloud https://你的控制面域名 --confirm
+npx --yes device-center@0.2.0-beta.5 connect --cloud https://你的控制面域名 --confirm
 # 仅本机，无账号要求
-npx --yes device-center@0.2.0-beta.3 start
+npx --yes device-center@0.2.0-beta.5 start
 ```
 
 安装与无参/help/version/plan 不生成身份，不配对，不自动启动后台进程。复制命令不含凭据。只有 connect --confirm 才生成本机身份并申请绑定；默认官方地址不会自动批准，用户需登录自己的账号。SSH 缓存分享须 --share-ssh 与面板再次批准。
@@ -18,13 +22,13 @@ npx --yes device-center@0.2.0-beta.3 start
 面板和本机 MCP：`http://127.0.0.1:5174/`、`/mcp`。常驻先固定安装：
 
 ```sh
-npm install -g device-center@0.2.0-beta.3
+npm install -g device-center@0.2.0-beta.5
 device-center service plan --port 5174
 # 自行停止同端口前台进程，再主动安装
 device-center service install --port 5174 --confirm
 ```
 
-数据在用户应用数据目录，更新包不重置身份或数据库；npx 缓存不得用作常驻目录。Windows 原生身份存储和用户服务尚未提供。
+数据在用户应用数据目录，更新包不重置身份或数据库；npx 缓存不得用作常驻目录。Windows 11 候选使用本机 DPAPI CurrentUser 加密及 NTFS ACL、当前用户任务计划程序；注销或休眠时不回报，实机验收待完成。
 
 远程指定日志需两端各自明确授权，见[远程日志](remote-access.md)。无通用远程命令或文件传输。
 

package/docs/onboarding.md

@@ -1,6 +1,6 @@
 # 从首次使用到添加设备
 
-> 0.2.0-beta.1 更新：账号隔离、TLS 1.3 双向认证密文中转、独立授权的日志尾读及获准精确 LAN 优先已实现。旧文中的“尚未实现”传输描述属于此前阶段；实际操作与边界以 [远程日志](remote-access.md) 和 README 为准。通用远程命令、文件传输、Windows 原生 Agent 与自动迁移仍未提供。
+> 0.2.0-beta.1 更新：账号隔离、TLS 1.3 双向认证密文中转、独立授权的日志尾读及获准精确 LAN 优先已实现。旧文中的“尚未实现”传输描述属于此前阶段；实际操作与边界以 [远程日志](remote-access.md) 和 README 为准。通用远程命令、文件传输与自动迁移仍未提供；Windows 11 预览接入见 [PowerShell 指南](windows-acceptance.md)。
 目标是让用户只完成必要的复制、粘贴和确认。面板统一用“管理电脑 → 智能体 → 设备”三步引导；部署、协议、常驻服务和排查放到文档或展开说明。下面区分已实现与待实现，不能把目标流程当成已接通。
 
 ## 当前本机原型
@@ -13,6 +13,8 @@
 
 ## 服务器 / Docker 部署后的接入
 
+0.2.0-beta.4（已发布到 npm `beta`，官方控制面已上线）提供并列的 Agent／手动安装入口，目标设备不要求 AI Agent 或 MCP。手动安装可选有浏览器自动交接，或无浏览器终端填码。有浏览器时申请自动带入，本人登录、核对指纹并批准一次；CLI 自动等待与验证首次回报，不要求用户回 Agent 回复“已批准”。无浏览器服务器和旧版 CLI 在另一台电脑完成下列手动流程。
+
 控制面与管理电脑可能是两台机器。当前服务只读取自己所在机器的配置；服务器配置不能代替用户电脑的配置，Docker 也不会取得宿主 SSH 权限。
 
 当前支持 macOS/Linux 管理 Driver，需要 Node.js 24，操作收敛为：
@@ -23,7 +25,7 @@
 
 Driver 主动建立获准的安全出站连接。短时一次性登记凭据应由用户单独交互输入，不嵌入 prompt、脚本、压缩包或日志。身份私钥在设备生成并保留，SSH 私钥、身份路径、局域网端点与认证留在管理电脑。云端只同步经用户批准的非秘密登记信息和明确可见范围的回报；导入不转移任务权限、主机信任或在线状态。
 
-个人云端面板的 HTTPS、所有者登录、管理 Driver 配对、签名回报与撤销已经实现；未绑定时显示空列表，不读取服务器 SSH。默认仅回报本机指标，SSH 名称与缓存状态需要双重显式批准。**尚未实现：** 独立资源设备 Agent、Windows Driver、签名安装包、系统钥匙串封装与配置迁移。完整操作与排查见[域名绑定](driver-binding.md)。没有演示绑定成功。管理电脑离线时，依赖它的 SSH 路径不可用；云端面板在线不会替代它完成认证。
+个人云端面板的 HTTPS、所有者登录、管理 Driver 配对、签名回报与撤销已经实现；未绑定时显示空列表，不读取服务器 SSH。默认仅回报本机指标，SSH 名称与缓存状态需要双重显式批准。**尚未实现：** 独立资源设备 Agent、签名安装包、系统钥匙串封装与配置迁移。完整操作与排查见[域名绑定](driver-binding.md)。没有演示绑定成功。管理电脑离线时，依赖它的 SSH 路径不可用；云端面板在线不会替代它完成认证。
 
 本机侧栏也可点“云端面板”，选择官方控制面或自己的 HTTPS 域名后复制命令。0.2 系列已支持显式多账号隔离，官方服务使用 multi-user 模式。账号模式和历史数据迁移见[托管接入说明](hosted-access.md)。
 
@@ -32,7 +34,7 @@ Driver 主动建立获准的安全出站连接。短时一次性登记凭据应
 | 目标设备条件 | 用户最少操作 | 结果条件 |
 | --- | --- | --- |
 | 管理电脑已有可用 SSH 配置 | 一键导入引用 | 导入后自动检查一次，取得真实资源后才显示近期在线与资源 |
-| 目标设备已有智能体 | 复制安装指导，交给目标机智能体；确认安装与绑定 | 0.2.0-beta.3 可复制完整安装说明，本机生成身份并核对配对与真实回报；签名安装器待实现 |
+| 目标设备已有智能体 | 复制安装指导，交给目标机智能体；确认安装与绑定 | 0.2.0-beta.4 可复制完整安装说明，本机生成身份，有浏览器时自动交接批准并核验真实回报；签名安装器待实现 |
 | 目标设备没有智能体 | 下载对应平台的验签安装包，在目标机运行并批准绑定 | 与智能体辅助方式使用同一接入协议；待实现 |
 | 不能安装 Agent，也没有可用 SSH | 明示缺少接入条件 | 保持未知，不伪装接通 |
 

package/docs/remote-access.md

@@ -1,13 +1,13 @@
 # 远程日志：明确授权后使用
 
-本版本 0.2.0-beta.3 支持 macOS / Linux、Node.js 24。两台设备主动连接同一 HTTPS 控制面，默认使用 `https://devices.owenshen.top`；可用 `--cloud https://你的域名` 替换。安装或查看帮助不会产生身份、配对或运行远程操作。
+本指南版本 0.2.0-beta.5，下方命令用于 macOS / Linux、Node.js 24；Windows 11 预览版见 [专用指南](windows-acceptance.md)，跨平台日志仍需实机验收。两台设备主动连接同一 HTTPS 控制面，默认使用 `https://devices.owenshen.top`；可用 `--cloud https://你的域名` 替换。安装或查看帮助不会产生身份、配对或运行远程操作。
 
 ## 最短流程
 
 在管理电脑和目标设备分别运行：
 
 ```sh
-npm install -g device-center@0.2.0-beta.3
+npm install -g device-center@0.2.0-beta.5
 device-center connect --confirm
 ```
 

package/docs/roadmap.md

@@ -20,10 +20,22 @@
 - 统一语言菜单、浏览器偏好和分享链接，切换保留未保存输入；命令与设备数据保持原样。
 - 长文档和 CLI 仍以中文为主，翻译尚待母语者校对。
 
+## 0.2.0-beta.4
+
+- `connect --browser --confirm`：自动打开本次绑定页，登录后本人核对指纹并批准一次，CLI 自动核验首次回报；无浏览器设备与旧客户端保留终端填码。
+- 指南并列“交给 Agent／手动安装”，手动安装提供普通终端脚本；目标设备不需要 AI Agent 或 MCP。
+- 接入步骤的窗口示意图；主面板提供手动指南入口。
+
+## 0.2.0-beta.5 预览
+
+- Windows 11 PowerShell 手动安装与图形指引，不需要 AI Agent 或 AD。
+- 本机 DPAPI CurrentUser 身份保护、NTFS 私有数据目录、当前用户登录后台任务。
+- Windows CI 验证脚本、安全存储与隔离 npm/前台启动；Windows 11 实机后台/重启/配对仍待验收。
+
 ## 后续候选
 
 1. 验证各平台真实常驻、升级和恢复；减少 Node 与终端依赖。
-2. Windows 原生身份安全存储与用户服务；签名安装器。
+2. Windows 11 真实后台生命周期验收与签名安装器。
 3. 本机与云端非秘密说明的同步及冲突处理，不迁移私钥或自动扩大授权。
 4. 更多单独授权的能力，例如 Windows 构建验收；当前没有任意远程命令或通用文件传输。
 5. 公开 GitHub 仓库与私密安全报告渠道，由项目主人分别决定。

package/docs/security-and-sync.md

@@ -6,6 +6,10 @@
 
 App Services 账号由固定 HTTPS `/v1/me` 核验，不解码自报 JWT 作为信任。稳定 issuer/subject 摘要派生租户，所有查询和撤销按服务端已核验租户限定。上游不可用时拒绝；密码认证只支持个人模式。旧个人归属与回退见[托管接入](hosted-access.md)。
 
+云端允许从个人站或其它网站打开 `/`、`/index.html`、`/login`、`/start` 和 `/start.html`，仅限浏览器顶层 GET 页面导航（`Sec-Fetch-Mode: navigate`、`Sec-Fetch-Dest: document`）。面板仍需登录，匿名根页面跳转登录；API、脚本、iframe 和写请求不适用此例外。同父域 `same-site` 也不等于 `same-origin`，不能用于跨来源操作设备。Host、HTTPS 代理标记与显式 Origin 校验始终保留，本机模式不变。
+
+`GET /api/health` 免登录，只返回 `ok`、`mode`、`runtime`、包版本 `version` 和部署源码 `sourceSha`（部署归档 `release.json` 中的完整提交 SHA；npm 或源码安装为 `null`），用于部署核验与外部拨测；不含账号、设备、配置或数据库信息。跨站请求仍按上面的规则拒绝。
+
 远程日志使用 Node/OpenSSL TLS 1.3 双向认证，两端固定经核对的证书/指纹。目标本机 grant 只允许指定管理身份、标签、规范化文件路径和截止时间；每次最多64KiB。禁止任意命令、任意路径、符号链接/多硬链接/非普通文件。直连和云中转都核验当前云端成员，撤销后拒绝新操作。
 
 云端中转只见密文与账号/设备/流量元数据。配额每日持久计数，队列、帧、会话、速率和并发均有界。两端本机审计不保存日志内容；超容量拒绝，不自动清理。详见[授权与额度](remote-access.md)。

package/docs/troubleshooting.md

@@ -1,5 +1,16 @@
 # 接入排查
 
+## 官方控制面登录后又回到登录页
+
+先在控制面的原标签页点击“进入控制面”。已有统一账号会话会先恢复并验证，无需反复从个人站应用中心打开新标签页。
+
+- **账号服务连接失败或校验超时**：这是控制面向统一账号服务核验身份失败，不等于密码错误。程序合并同一会话的并发核验，并对短暂网络故障最多重试一次；仍失败时留在当前页面，稍后点击“进入控制面”重试。不会因为故障放行或改用其它账号。
+- **登录会话未能保存**：核对账号页与控制面是否在同一个浏览器、同一浏览器配置中，检查本站 Cookie 是否被阻止。登录请求成功后还会做一次受保护的会话核验；核验失败不会继续跳转。
+- **进入后立即退回登录页**：短时回跳保护会暂停自动跳转。它只在当前标签页存一个时间戳，不存凭据，也不清除设备配对申请。确认网络恢复后主动点击“进入控制面”重试。
+- **提示先登录或账号无权限**：按页面提示完成邮箱／Google 等受支持的统一登录；个人部署仍只允许配置的面板所有者。服务不可用与身份拒绝分别处理。
+
+排查时只提供失败提示、发生时间和页面路径；不要分享 Cookie、访问令牌或带设备配对票据的链接。服务端核验诊断不记录凭据。
+
 ## 本机智能体没接上
 
 1. 面板是否还能打开？打不开时先确认前台进程或后台服务在运行。

package/docs/windows-acceptance.md

@@ -0,0 +1,57 @@
+# Windows 11 手动接入验收
+
+**0.2.0-beta.5 · Windows 11 预览版。** 安装前可用 `npm.cmd view device-center@0.2.0-beta.5 version` 确认发布状态。Windows CI 的脚本、安全存储及安装检查不能替代你的 Windows 11 实机验收。
+
+## 准备与安装
+
+需要 Windows 11、当前普通用户、Windows PowerShell 5.1+、官方 [Node.js 24+](https://nodejs.org/)（含 npm），能访问 npm registry 和选定 HTTPS 控制面。无需 AI Agent、MCP、AD 域或管理员窗口；不使用 WSL。
+
+在**目标 Windows 电脑**打开[手动安装指南](https://devices.owenshen.top/start?lang=zh-CN&method=manual&mode=official&os=windows#install-title)，选择官方托管、Windows 11、手动安装，再复制 PowerShell 脚本。不需要下载 ZIP，也不需要目标电脑有 AI Agent。
+
+```text
+在目标 Windows 电脑打开手动安装指南、复制脚本
+  → 开始菜单搜索 PowerShell，点“打开”（不用管理员）
+  → 粘贴到 PowerShell，回车
+  → 浏览器自动打开本次绑定申请
+  → 登录自己的账号，对照终端完整指纹，批准一次
+  → 终端自动确认首次资源回报；无需回 Agent 说“已批准”
+```
+
+选择“本机使用”只安装本机面板，不申请云端绑定。已有 CLI、服务配置、任务或占用端口时停止，保留原状态；不要反复运行安装脚本。缺少 Node.js 时从官网安装后重开 PowerShell。安装需要联网访问 npm；复制文本执行不需要修改 PowerShell 执行策略。
+
+**电脑在国内公司、不在身边：** 把上述指南发给能操作它的同事。可选“无浏览器／服务器”，让同事在那台 Windows 的 PowerShell 执行脚本，保持窗口打开；你在自己的电脑登录官方控制面，输入终端配对码，核对完整指纹并批准。代码只在实际运行时生成，不预放在脚本里，也不要发给 AI Agent。目标电脑仍需出站 HTTPS、npm 连通；不要求两台电脑在同一局域网或开放入站端口。
+
+## 验收清单
+
+1. `--version` 是 `0.2.0-beta.5`；后台状态显示 `windows-task`，本机面板 `http://127.0.0.1:5174` 正常加载，页面脚本无 404。
+2. 浏览器只批准刚由本机发起的申请；完整指纹与终端一致。终端有“云端已接收首次资源回报”，`firstReport.verified=true`。仅 `configured=true` 不算连通。
+3. 云端出现这台 Windows 电脑，内存和用户目录所在卷磁盘分别显示真实数值；没有测试设备或伪造在线。可填写设备名、用途与标签。
+4. 点击云端“采集一次”，采集时间在约 30–75 秒内更新。关闭安装终端后仍更新；注销/休眠会停止回报，登录/唤醒且网络恢复后继续。
+5. 在 Windows 任务计划程序中查看 `DeviceCenter-…`：当前用户、用户登录时触发、非最高权限。重启并登录后不重新安装也能恢复；长期停在登录界面不会运行。
+6. 本机身份文件在 `%USERPROFILE%\AppData\Local\Device Center\driver-link.json`，只存 DPAPI 密文，目录访问限当前用户与 SYSTEM。**不要打开或分享私钥，也不要把身份文件搬到其他电脑/用户。** DPAPI 不防同账号恶意程序或管理员控制。
+7. 不接 AI Agent 也可使用设备回报。需要管理端 AI 时，在有 Agent 的管理电脑添加它自己的 loopback `/mcp`；目标 Windows 不需要 MCP 客户端。
+
+## 状态与排查
+
+在普通用户 PowerShell 执行：
+
+```powershell
+& "$HOME\AppData\Local\Programs\Device Center\cli\device-center.cmd" --version
+& "$HOME\AppData\Local\Programs\Device Center\cli\device-center.cmd" status
+& "$HOME\AppData\Local\Programs\Device Center\cli\device-center.cmd" service status --port 5174
+```
+
+- **打不开网页**：核对 Node 版本、5174 是否被占用、服务状态；不停止别的程序。若选择另一端口，要让服务与 connect 使用同一端口。
+- **任务被策略阻止**：保留错误。可显式选择 `start --port 5174` 前台运行并保持终端；不改组策略、执行策略或防火墙。
+- **安全存储失败**：确认当前用户、用户目录在支持 NTFS ACL 的本地卷、系统 PowerShell 可用；目录被共享或变为链接时程序会拒绝。不要把权限放宽到 Everyone 来解决。
+- **绑定成功但没有回报**：检查电脑唤醒、网络、系统时间、HTTPS 可达与后台日志。不要重复绑定；没有入站端口要求。
+- **未回报/待刷新**：表示近期没收到状态，不是设备身份私钥过期。睡眠、注销、断网时无法采集。
+- **后续读 Windows 日志**：需两端核对指纹并单独 `access trust` / `access grant`。仅允许显式本地盘文件，例如 `C:\Logs\app.log`，不接受 UNC 共享或备用数据流。绑定不开放任意命令，也不授予日志权限。本轮先验收安装/配对/后台，真实跨平台日志再独立确认。
+
+需要停止并卸载本次后台任务时，由用户明确执行，默认保留数据和身份：
+
+```powershell
+& "$HOME\AppData\Local\Programs\Device Center\cli\device-center.cmd" service uninstall --port 5174 --confirm
+```
+
+卸载仅处理与当前计划完全一致的任务；不能确认监听已停止时保留配置并报错，不杀其他程序。反馈只需系统版本、CLI 版本、失败步骤和已去敏的错误；不附账号凭据、配对码、身份文件或日志正文。

package/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect width="64" height="64" rx="14" fill="#0c0c0e"/>
+  <path d="M12 42V12h30v30H12Zm10 10h30V22H22v30Z" fill="none" stroke="#ff8254" stroke-width="4" stroke-linejoin="round"/>
+</svg>

package/index.html

@@ -7,6 +7,7 @@
     <meta name="description" content="Device Center · 云端控制面与设备 Agent 接入原型" />
     <link rel="stylesheet" href="/src/styles.css" />
     <link rel="stylesheet" href="/src/i18n.css" />
+    <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
     <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 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>
+<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><link rel="icon" href="/favicon.svg" type="image/svg+xml"><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><button id="continue-login" type="button" data-i18n="login.continue">进入控制面</button><p id="unified-message" role="status" aria-live="polite"></p><p class="help" data-i18n="login.help">已有登录会自动进入。需要登录时打开下方账号页，完成后回到这里继续。</p><a id="unified-login" class="login-link" target="_blank" rel="noopener noreferrer" data-i18n="login.link">使用统一账号登录 ↗</a></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>