device-center 0.1.0-beta.1 → 0.2.0-beta.2

package/CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 Source distributed in the npm beta package is licensed under MIT (see LICENSE). The GitHub repository publication plan and a private security reporting channel are still pending. This remains a prototype, not an audited remote execution system.
 
-Use Node.js 24, `npm run dev`, `npm run check`, and `npm test`. There is no third-party runtime dependency or frontend build step. Native inventory includes the real local Driver by default, with no seeded records. SSH references require explicit user selection. Test fixtures must stay in temporary test directories/databases, never appear in product startup.
+Use Node.js 24, `npm ci --ignore-scripts`, `npm run dev`, `npm run check`, and `npm test`. There is no frontend build step; X509 runtime dependencies are pinned in npm-shrinkwrap.json. Native inventory includes the real local Driver by default, with no seeded records. SSH references require explicit user selection. Test fixtures must stay in temporary test directories/databases, never appear in product startup.
 
 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.
 

package/Dockerfile

@@ -1,10 +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 index.html login.html ./
+COPY --chown=node:node package.json npm-shrinkwrap.json index.html login.html ./
 COPY --chown=node:node server ./server
 COPY --chown=node:node src ./src
-RUN mkdir -p /app/data && chown node:node /app/data
+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
 CMD ["node", "server/index.mjs"]

package/README.md

@@ -1,159 +1,69 @@
 # Device Center
 
-让主力电脑上的智能体，通过一个本机连接器使用自己闲置的 Mac、Windows 或 Linux 电脑。目标用途包括：在 Windows 上构建程序、读取经批准的日志、分担有额度限制的计算。
+让主力电脑上的智能体，使用自己的闲置设备。MIT · Node.js 24 · macOS / Linux · beta。
 
-当前实现的是**本机 Driver + SSH 配置关联 + 按需只读检查**，以及**个人云端登录、管理电脑配对与只读回报**。原生本机部署的这台电脑自动成为设备，展示真实本机内存和用户目录所在卷的磁盘读数；已有 SSH 主机可以关联到清单，按需读取 macOS/Linux 的真实资源快照。云端不会把服务器当作管理电脑；用户在自己的电脑运行接入命令并在面板批准后，才显示真实回报。没有默认示例设备、项目、用量或模拟云环境。指定日志、远程任务、独立设备 Agent 和配置迁移尚未实现。源码采用 [MIT 许可证](LICENSE)，当前为 beta 原型。
+一个本机连接器，加一个可选的云端控制面。真实本机内存、磁盘分别展示；已有 SSH 配置可一键关联并执行固定只读检查；设备 Agent 可通过域名绑定账号，主动回报状态。指定日志经设备主人单独授权后，以双向 TLS 1.3 直连或密文中转读取。没有默认示例设备或虚构在线状态。
 
-## npm 接入
+## 快速使用
 
-本包版本为 `device-center@0.1.0-beta.1`，使用 npm 的 `beta` 分发标签。macOS / Linux 用户安装 Node.js 24，在官方 registry 核对对应版本后，即可在任意目录运行：
+希望交给本机 Agent 安装时，按[Agent 安装指南](docs/agent-install.md)选择本机、官方托管或已有自建服务。“交给 Agent 安装”可直接复制完整说明；登录和设备绑定仍由用户核对。朋友试用从[一页指南](https://devices.owenshen.top/start)开始，无需先登录。
 
-```sh
-# 只看帮助和范围，不产生身份或联网
-npx --yes device-center@0.1.0-beta.1 --help
-npx --yes device-center@0.1.0-beta.1 plan --cloud https://你的控制面域名
-# 用户主动接入；配对码由终端产生，再单独输入面板核对批准
-npx --yes device-center@0.1.0-beta.1 connect --cloud https://你的控制面域名 --confirm
-```
-
-仅本机使用可运行 `npx --yes device-center@0.1.0-beta.1 start`，面板与只读 MCP 默认位于 `http://127.0.0.1:5174/` 和 `/mcp`。数据留在用户应用数据目录。默认不分享 SSH 信息、不安装后台服务；常驻应先固定版本全局安装，不能依赖 npx 缓存。见 [npm 使用与发布说明](docs/npm.md)。当前源码可先用 `node bin/device-center.mjs --help`，Windows 原生管理 Driver 尚未支持。
+0.2.0-beta.2 增加设备命名、类型、用途、标签、手动服务清单及“采集一次”，见[设备说明与手动采集](docs/device-profiles.md)。旧 Driver 需升级后才能响应云端手动采集；服务与应用仍由用户手动登记。
 
-## 从源码在本机用起来
+第一次使用可按 [新用户上手教程](docs/quick-start.md) 完成安装、设备配对和指定日志授权；[验收记录](docs/user-acceptance.md)列出已验证项目与限制。
 
-需要 Node.js 24，无第三方运行依赖、无前端构建步骤。
+只用本机，不注册账号：
 
 ```sh
-npm run dev
+npx --yes device-center@0.2.0-beta.2 start
 ```
 
-打开 [本机面板](http://127.0.0.1:5173)，点“开始使用”，按 **管理电脑 → 智能体 → 设备** 完成设置。本机自动加入设备列表，已有近期接入记录可直接进入导入；复制 MCP 地址到 Codex 设置并 Restart，再一键导入已有 SSH 主机。也可稍后连接智能体、先导入，界面不会伪造接入成功。后续手动新增从“添加设备”进入。见[本机、服务器与新设备的完整流程](docs/onboarding.md)。
-
-已配置不等于已连通。点击导入或关联后，新增设备自动排队检查一次当前 SSH 路径，最多两台并发，标记等待、检查中、连通或失败原因；失败可在卡片点“检查 SSH（只读）”重试。目标机无需安装 Node 或本项目。取得资源后在线五分钟，之后显示“待刷新”（数据较早，不代表设备断线或密钥过期）。SSH 连通性与内存、磁盘采集分别显示：认证已通过但目标不支持采集时，指标为空、设备状态仍未知。刷新列表只读取缓存，不会重连。
-
-每台设备名称下显示访问路径摘要，点击可看跳板、目标入口、认证与密钥说明。路径来自已核验的配置，详情图区分上次成功检查与未知的后段映射；未启用自动局域网选路。参见[访问路径与局域网优先方案](docs/connection-routing.md)。
+打开 `http://127.0.0.1:5174`，将 `/mcp` 添加到本机智能体。侧栏“开始使用”按管理电脑 → 智能体 → 设备引导；导入 SSH 后检查一次连通性。没有可用 Agent/SSH 的设备保持未知；资源快照过期显示“待刷新”，不代表密钥过期。列表刷新不主动连接 SSH。
 
-“开始使用”的设备步骤会检查运行 Driver 的电脑的本用户 SSH 配置，一键导入可用条目。筛选复用当前安全解析器，要求明确且完整的 Host / 命名 ProxyJump、可读取的本机身份文件引用；仅检查文件元数据，不读取私钥内容。缺少参数、身份文件不可用或暂不支持的配置会跳过并说明原因，不删除配置。“可导入”不等于已连通或认证通过，导入只保存别名引用，随后执行固定只读检查；检查成功前保持未知。已有同名引用不会重复创建或再次排队。服务器部署不能自动读取用户正在操作的电脑；管理 Driver 可经域名配对，默认只回报本机资源；SSH 缓存分享需要另行申请和批准，配置迁移仍待实现。Docker 不读取宿主配置，需在宿主运行原生 Driver。
-
-在“连接方式”中，同一台 SSH 设备可同时登记局域网地址/端口和中转方案。中转有三种：用户自建服务器、Device Center 提供的服务、Cloudflare；支持保存局域网优先或仅中转的计划。保存到本机 SQLite，重新打开后恢复；入口仍待验证，中继适配器和自动选路尚未启用，不会修改已有 SSH 配置或托管私钥。
-
-智能体通过 MCP 使用本机 Driver。已有 MCP 配置可以继续使用；首次配置时，从侧栏“智能体连接”复制地址，在 Codex 设置的 MCP servers 中添加 Streamable HTTP 服务并重新启动连接。
-
-也可以在本机终端配置一次：
+需要在外查看设备、使用日志中转：
 
 ```sh
-codex mcp add device-center-connector --url http://127.0.0.1:5173/mcp
-```
-
-回到连接设置点“检查接入”。只有服务收到真实 MCP `initialize` 请求后才显示接入记录；这个记录不证明客户端身份或持续在线，也不表示远端已连接。五分钟后记录显示过期。让 Codex 调用 `device_center_list_resources`，返回本机 Driver 和已关联的 SSH 主机；`device_center_list_ssh_candidates` 返回候选及关联状态。
-
-```mermaid
-flowchart LR
-  AI[本机智能体] --> MCP[MCP]
-  MCP --> Driver[本机 Driver 与真实资源读数]
-  Driver --> Ref[已关联 SSH 主机引用]
-  Ref --> Snapshot[导入后检查或手动重试 · SSH 只读快照]
-  Ref -.后续单独授权.-> Task[指定日志或受限任务]
+npx --yes device-center@0.2.0-beta.2 plan
+npx --yes device-center@0.2.0-beta.2 connect --confirm
+# 自建控制面可指定 --cloud https://devices.example.com
 ```
 
-SSH 发现只读取 `~/.ssh/config` 和受限范围内的无条件 Include（`~/.ssh/` 内的 `config` / `.conf`）。不会读取私钥、密码、ssh-agent 或 known_hosts，不运行 `ssh` / `ssh -G`，不执行 `Match exec`、代理或远程命令；不解析完整生效配置。条件 Include、目录外文件、动态路径和通配 Host 不作为自动发现设备，界面会说明读取限制。依据 [OpenSSH 配置语义](https://man.openbsd.org/ssh_config.5)，解析配置并不等于验证可达性和身份。
+默认 [官方控制面](https://devices.owenshen.top)，登录自己的 App Services／个人站统一账号。在面板输入终端的五分钟配对码，核对完整公钥指纹和回报范围并批准。私钥留在设备，不放进脚本、prompt 或压缩包。默认不分享 SSH 信息、不开 LAN 端口、不安装后台服务。配对只授权资源回报。
 
-**主动检查与配置发现分开。** 检查支持 macOS/Linux 原生管理 Driver，根配置中的完整明确 Host 和命名 ProxyJump；目标需要 POSIX shell 和 macOS/Linux。程序生成临时隔离配置，不完整继承通配、全局或 Include 配置，影响目标或跳板的 Match 条件或自定义命令需要人工审核；仅与它们完全无关的静态 originalhost 条件不会误伤该条目。OpenSSH 使用本机现有身份文件引用和 known_hosts 做认证，程序不读取或导入私钥内容。主机指纹严格校验，不自动接受新主机、不关闭校验。固定采集只用 `uname`、`hostname`、`sysctl`/`vm_stat` 或 `/proc/meminfo`、`df`；不读取普通文件内容、安装服务或接收任意命令。超时 25 秒、输出上限 32 KiB、最多两个并发。SQLite 保存别名、时间、配置摘要及归一化资源结果，不保存配置文件、身份路径或原始输出。见 [排查说明](docs/troubleshooting.md)。
+[远程日志：两端授权、直连与中转](docs/remote-access.md) · [常驻与 npm](docs/npm.md) · [账号模式与自建](docs/hosted-access.md) · [故障排查](docs/troubleshooting.md)
 
-本机“在线”表示服务进程正在本机运行；每次刷新重新采集。内存为系统总量减空闲（含缓存，区别于系统活动监视器的内存压力）；Linux SSH 快照使用总量减 MemAvailable。磁盘为用户目录所在卷，不能相加所有分区或代表单个项目占用。读取失败时对应指标显示失败，不影响另一项。
+## 能做什么
 
-原有 stdio 配置继续可用，但不会在 HTTP 面板里产生接入记录；建议将同名配置改为上面的 HTTP 地址。当前对话不会因修改配置自动加载工具，需要在客户端重启连接或重开会话。接入方法见 [OpenAI 官方 MCP 文档](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)。
-
-端口可用 `PORT=5174 npm run dev` 调整。复制命令会使用当前页面端口，不带数据库路径、密钥或令牌。数据默认为仓库 `data/device-center.sqlite`，可以用 `DEVICE_CENTER_DB_PATH` 指定已有数据库；不会自动清空数据或写入种子。旧版 `is_demo=1` 记录被排除，不自动删除。
-
-## 本机常驻：推荐方向
-
-关闭网页不影响后台服务。现在提供 macOS `launchd` 和 Linux `systemd --user` 安装脚本：
-
-```sh
-npm run service -- plan
-npm run service -- install --confirm
-npm run service -- status
-```
-
-- `plan` 只展示计划，不修改系统。
-- `install --confirm` 是用户主动安装：登记用户级后台服务，登录后启动，失败时由系统服务管理器重启。Node 及仓库必须保留在稳定路径。
-- macOS 数据和日志位于 `~/Library/Application Support/Device Center/`；Linux 数据位于 `~/.local/share/device-center/`，日志由用户 journal 管理。
-- 后台服务使用独立持久数据目录，不自动复制开发数据库。请先停止自己启动的同端口前台进程；脚本不会自动结束其他进程或覆盖已有服务配置。
-- `--port 5174` 可以加在各命令后，安装、状态和卸载应使用相同端口。
-- `npm run service -- uninstall --confirm` 只卸载这份配置对应的用户服务，保留数据目录；修改过的配置须人工处理。
-- Windows 原生 Driver 和后台安装尚未实现；下方 Docker 方案只表示容器资源，不能替代宿主 Driver。
-
-本轮验证仅运行 `plan`、前台预览和接口测试，**没有安装常驻服务**。系统服务安装与 Docker 运行还需在各目标平台实际验证。当前仍是源码运行方式，不是给普通用户分发的签名安装包。
+| 能力 | 当前实现 |
+| --- | --- |
+| 资源清单 | 本机真实资源；已有 SSH 主机经用户触发检查；云端只显示获准回报 |
+| 账号与设备 | 上游核验账号、租户隔离、短期一次性批准、签名防重放、撤销 |
+| 日志 | 指定标签/绝对文件/管理设备/有效期，最大64KiB；本机审计 |
+| 访问路径 | Agent 精确私网入口优先，网络失败回退官方/自建 HTTPS 密文中转；证书错误停止 |
+| 中转额度 | 每账号100MiB/UTC日、全实例1GiB/日，持久计数、并发与速率限制 |
+| 尚未提供 | 任意远程命令、通用文件传输、Windows 原生 Agent、云端 MCP、CF 专用适配器、计费、自动迁移 |
 
-## 已有 Docker 的用户
+日志操作通过 `device_center_read_log` 请求，不能用 MCP 授权自身。用户自己的智能体仍需在目标设备单独配置授权。已有 SSH 路径独立使用，SSH“连接计划”不会自动改成新 Agent 通道。Docker 代表容器自身，不能当作宿主机；宿主运行原生 Driver 与本机智能体交互。
 
-仓库提供可审查的 `Dockerfile` 与 `compose.yaml`，没有在本轮构建镜像或启动容器。后续用户主动选择时可运行：
+## 从源码运行和自建
 
 ```sh
-docker compose up -d --build
-```
-
-本机面板和 MCP 地址仍是 `http://127.0.0.1:5173` 与 `/mcp`；用 `DEVICE_CENTER_PORT=5174` 可调整宿主端口。不要同时占用同一个前台/后台端口。
-
-```mermaid
-flowchart LR
-  AI[宿主机上的 Codex] --> URL[127.0.0.1:端口/mcp]
-  URL --> DC[容器中的 Device Center]
-  DC --> DB[容器数据卷]
+npm ci --ignore-scripts
+npm run dev
+# 默认 http://127.0.0.1:5173
+npm run check
+npm test
+npm run verify:package
 ```
 
-Codex 主动访问容器服务，不需要把 AI、Codex 配置、Docker socket 或宿主机目录挂载进容器。此方向使用本机端口映射；`host.docker.internal` 是容器访问宿主机服务的相反方向，这里不需要。参见 [Docker 网络方向](https://docs.docker.com/desktop/features/networking/networking-how-tos/) 与 [仅发布到回环地址](https://docs.docker.com/get-started/docker-concepts/running-containers/publishing-ports/)。
-
-Compose 只映射 `127.0.0.1`、持久化一个数据卷、设置重启策略，并使用非 root 用户。Docker 引擎需要持续运行，并应使用 28.0.0 或更新版本；旧版本存在同局域网访问回环发布端口的问题，见 [Docker 发布端口说明](https://docs.docker.com/engine/network/port-publishing/)。容器只表示容器 Driver，不显示宿主内存/磁盘，也不读取宿主 SSH 配置。需要宿主设备和已有 SSH 关联时优先在宿主原生运行 Driver；将来可设计独立宿主 Driver 对接容器，不挂载整个 HOME、密钥目录或 Docker socket。不要把没有鉴权的本机模式直接暴露到公网或局域网。
-
-## 个人云端面板
+无前端构建步骤；依赖由 npm-shrinkwrap 固定。仅本机模式监听回环地址，不可直接公开。可选 `docker compose up --build -d` 使用本地回环端口映射与非 root 用户，未挂载宿主 HOME/SSH/Docker socket。容器不能代替用户本机 Driver。
 
-云端模式必须同时设置 `DEVICE_CENTER_RUNTIME=cloud`、明确的 `DEVICE_CENTER_PUBLIC_ORIGIN=https://你的域名` 和 `DEVICE_CENTER_AUTH_FILE`。使用现有 App Services／个人站统一账号时，在仓库外保存权限为 `0600` 的认证配置：
+云端部署必须设置 `DEVICE_CENTER_RUNTIME=cloud`、`DEVICE_CENTER_PUBLIC_ORIGIN=https://你的域名`、`DEVICE_CENTER_AUTH_FILE=/仓库外/private.json`。已有反向代理仅转发至服务回环端口，覆盖 Host 和 X-Forwarded-Proto，提供 HTTPS。认证配置文件0600：
 
 ```json
-{
-  "provider": "app-services",
-  "backendOrigin": "https://appapi.example.com",
-  "accountOrigin": "https://example.com",
-  "ownerEmail": "owner@example.com"
-}
-```
-
-这些值是配置示例。控制面、账号站和 App Services 必须使用同一受信任的父域名，账号站已经设置共享的 HttpOnly `sessionToken` cookie。服务只向配置的 App Services `/v1/me` 验证身份，并检查所有者邮箱；不接受浏览器自报的用户 ID、匿名或手机号会话，不复制账号服务的签名密钥。统一登录只支持这份个人访问限制，不是多用户托管。
-
-用户点击“使用统一账号登录”，在个人站通过邮箱或 Google 登录，回到设备面板会自动继续；个人站已登录时直接进入。退出设备面板仅退出本面板；个人站退出或切换账号会使本面板会话失效。身份结果最多缓存10秒，账号服务不可用时拒绝受保护访问，不回退到密码。
-
-独立部署仍可显式使用 `provider: "password"`（旧配置可省略 provider）：私有文件只保存用户名、16字节盐的十六进制值及 scrypt 哈希，参数 N=32768、r=8、p=1、输出64字节。统一账号模式拒绝本地密码接口；认证配置和凭据不进入源码、部署压缩包或日志。
-
-后端继续只监听回环地址，由 HTTPS 反向代理访问；代理必须保留配置的 Host 并覆盖 `X-Forwarded-Proto=https`，不能转发客户端伪造的值。访问者先登录，网页、设备列表、批准/撤销与下载入口受保护。机器配对申请公开但限速，轮询、回报和断开需独立身份签名。云端 MCP / SSH 操作仍不可用。登录、继续和退出要求同源 Origin；本面板会话使用 Secure、HttpOnly、SameSite=Strict cookie，8小时失效，进程重启后重建。统一登录每个会话凭据每分钟最多8次继续尝试，校验并发/缓存大小有上限。此模式只用于个人访问，没有公开注册或多用户权限管理。
-
-**面板上线不等于设备接通。** 云端不读取服务器 SSH、不复制本机数据库，云端 MCP 与 SSH 操作仍不可用。点“连接我的电脑”，下载源码、复制命令并在自己的电脑运行，再单独输入配对码、核对指纹和范围；批准并首次回报后才显示真实资源。当前支持 Node.js 24、macOS/Linux 源码 Driver，命令不含凭据。详见[域名绑定、常驻与排查](docs/driver-binding.md)及[部署记录与恢复](docs/deployment-readiness.md)。
-
-## 当前真实功能与边界
-
-| 真实本地功能 | 尚未实现 |
-| --- | --- |
-| 内置本机 Driver、真实内存/卷磁盘、状态筛选 | 独立设备 Agent、签名安装包 |
-| SSH 候选、显式关联、严格验钥的一次只读资源检查 | 指定日志、构建/算力任务、任意远程命令 |
-| 同一服务上的 HTTP MCP，四个只读工具 | 任务授权与审计 |
-| 真实 MCP 初始化记录、复制本机地址或命令 | 设备可信启动、系统钥匙串封装 |
-| macOS/Linux 管理 Driver 本机身份、一次性配对、签名回报及撤销 | Windows Driver、独立安装器、中继、网络限速、配置迁移 |
-| 用户服务脚本、Docker 配置、个人统一登录与 HTTPS 入口 | 跨平台实际安装验证、多用户托管 |
-
-项目位置保留在侧栏，目前没有项目管理或示例项目。“添加设备”只关联用户选中的已配置 SSH 主机；导入后执行一次固定只读检查，后续可在卡片重试，数据库保存引用与采集结果。不复制 HostName、私钥路径或凭据，不把关联当成信任或任务授权。候选只是 SSH 配置条目，可能有多个别名指向同一物理主机。删除系统 SSH 配置后，已有引用保留并提示配置不可用。明确移除产品内引用时，同时删除其快照与连接计划，并记录本地排除项，后续读取或一键导入不会重新加入；不修改系统 SSH 配置或身份文件。排除按租户与具体别名记录，不按客户端名称全局过滤。
-
-接入资源设备的后续设计：设备在本机生成身份私钥，服务只登记公钥；短时一次性登记码由用户单独输入，不写入 prompt、脚本、压缩包或日志。Agent 建立安全出站连接。获准的局域网端点可尝试认证直连，失败时回退用户选择的中继。连接与任务授权分开，构建、指定日志和计算各自有目标及额度限制。
-
-## 开发与后续
-
-```sh
-npm run check
-npm test
+{"provider":"app-services","accountMode":"multi-user","backendOrigin":"https://appapi.example.com","accountOrigin":"https://example.com"}
 ```
 
-- [架构](docs/architecture.md) · [接入排查](docs/troubleshooting.md)
-- [访问路径与局域网优先](docs/connection-routing.md)
-- [安全与配置迁移设计](docs/security-and-sync.md) · [路线图](docs/roadmap.md)
-- [安全边界](SECURITY.md) · [贡献说明](CONTRIBUTING.md)
+需要已有受信任 App Services 共享账号服务与同父域会话；不是通用第三方 OAuth。个人部署可选 personal + ownerEmail。旧个人数据切多用户前按[迁移与回退说明](docs/hosted-access.md)核验原所有者映射；不能只切回旧代码而保留多用户数据库。
 
-这些开发检查需要完整源码仓库；npm 运行包不含测试及发布归档。检查不能代替加密协议、远程授权或跨平台安装验证。MIT 源码随 npm 包分发；GitHub 仓库公开与安全报告渠道仍需另外安排。
+当前没有密钥托管、安装时自动联网或远程 shell。安全边界与披露方式见 [SECURITY](SECURITY.md)。npm 包公开不自动改变 GitHub 仓库可见性；本次发布是可追溯工作区快照，不是 main CI 构建。

package/SECURITY.md

@@ -1,23 +1,15 @@
 # Security
 
-Device Center is a single-user Driver prototype with read-only local MCP, explicit SSH-reference association and owner-triggered fixed SSH resource checks. It observes real local metrics and bounded SSH metadata. An opt-in personal cloud panel requires HTTPS and owner login, and supports owner-approved macOS/Linux management Driver pairing, signed read-only telemetry and revocation. It has no multi-user hosting, SSH key custody, resource Agent, encrypted relay, remote task authority or configuration migration. Do not place secrets in its database or expose unauthenticated local mode to a LAN or Internet.
+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.
 
-Native startup binds to loopback. Host/Origin checks reject cross-site requests and JSON input is bounded. Association and check POSTs require explicit same-origin Origin and currently discovered aliases; checks additionally require prior association and accept no command/path. MCP exposes only inventory/status/candidate/description tools and never connects to targets. Initialization traffic is not an authenticated identity or heartbeat. Other local programs can access this unauthenticated endpoint and trigger fixed SSH checks with the service user's existing authentication. Browser isolation and tenant namespaces are not production access control.
+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.
 
-Cloud mode fails closed without an exact HTTPS origin and private owner authentication file. The process remains on loopback behind a proxy that fixes Host and HTTPS scheme. Unknown authentication providers fail startup. Inventory, owner approval/revocation and source download require browser authentication. Machine enrollment start is public and bounded; poll/report/disconnect require independent device signatures. Cloud SSH and MCP routes reject remote operations even after binding; cloud mode never reads server SSH or claims the server is the user's computer. This is personal access protection, not an audited multi-user hosting or device trust protocol.
+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).
 
-The App Services adapter uses the existing shared HttpOnly `sessionToken` cookie. It sends that credential only as a Bearer header to the configured HTTPS `/v1/me`, with a five-second timeout, no redirects and bounded JSON. The verified response must identify a non-anonymous email/Google/Apple session and the configured owner's email. Client `userId`, decoded JWT claims, phone/guest/service sessions and other accounts grant no access. No upstream signing secret, password or token is copied to the configuration, deployment archive, database, URL or localStorage. Tokens are present in request memory during verification; retained session/cache keys contain only their SHA256 digests. The shared cookie makes all participating subdomains part of the existing account trust boundary; this adapter is for a trusted common parent domain, not arbitrary cross-domain SSO.
+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.
 
-Panel sessions last eight hours and use a separate Secure/HttpOnly/SameSite=Strict host-only cookie; in-memory records are bounded to 32. Requests require the same current shared account credential. Removing/changing it revokes the panel session. Verified profiles are cached for at most ten seconds, bounded to 64; upstream outages fail closed after a cached result expires. SSO continuation is limited to eight attempts per token per minute, at most eight concurrent upstream checks, and a bounded attempt cache. Login/continuation/logout require explicit same-origin requests. Panel logout clears only panel state and prevents silent re-entry; central login and other products remain signed in. Restart clears panel sessions, but an existing verified central session can establish a new one. Account/device permissions remain separate.
+Multi-user rollback requires consistent database and private-config restoration; never activate an older unscoped server against multi-account data. See [migration](docs/hosted-access.md). This release has automated isolation/transport tests, not an independent security audit or SLA.
 
-Explicit standalone password mode remains available, using salted scrypt (N=32768, r=8, p=1, 64-byte output), private hashes, eight attempts per minute and the same eight-hour panel session boundary. App Services mode rejects this endpoint before reading password input and never falls back to it during an outage.
+## Report a vulnerability
 
-Passive discovery enumerates exact Host aliases from `~/.ssh/config` and restricted unconditional Includes under `~/.ssh/`. Unsupported Includes are skipped with notices. Discovery never reads keys, passwords, ssh-agent or known_hosts, or invokes ssh/ssh -G/Match exec. Only alias/source metadata is returned; effective options are not resolved. An alias is neither device identity, connectivity nor task authority; several aliases can represent one host.
-
-Active checks use `/usr/bin/ssh` with a temporary isolated configuration for explicit root Host profiles and named ProxyJump aliases. Custom command, conditional and special authentication profiles stop for review; wildcard/global/Include options are not fully inherited. OpenSSH uses existing identity references and known_hosts, strictly verifies host keys, disables new forwarding and host-trust updates, and runs only the fixed macOS/Linux POSIX resource script. No target installation, arbitrary command/path input or key-content import occurs. Checks have a 25-second timeout, 32 KiB output limit and two-operation concurrency cap. SQLite stores alias, timestamp, configuration digest and normalized resources/failure code; raw outputs, identity paths and configuration contents are not stored. Success expires after five minutes; failure or profile changes invalidate online telemetry. This is a one-time observation, not a persistent connection or task grant.
-
-The optional Docker recipe publishes to host loopback only, uses a non-root process and its own data volume, and has no host or Docker socket mounts. Its Driver represents the container, not host telemetry or SSH access. Actual container runtime and user-level background installation have not been validated in this task. `DEVICE_CENTER_RUNTIME=container` is a deployment setting, not proof of isolation.
-
-Management Driver identity keys are generated only when the user explicitly runs `connect --confirm`. Private keys remain in owner-only 0600 files in 0700 directories; this is not OS keychain/TPM protection. The server stores public keys and fingerprints. Ed25519 requests bind origin, path, ID, time, nonce and payload digest; persistent nonce retention and revocation checks reject replay. Owner approval consumes a five-minute request transactionally. No bearer credential is issued. See [protocol, scope and limitations](docs/driver-binding.md). Short-lived single-use enrollment credentials are entered separately, not put into prompts, scripts, archives or diagnostic logs. Remote operations need independent owner grants scoped to a device, capability, path, time and quota. Hosted service key custody and configuration migration remain design work in `docs/security-and-sync.md`.
-
-Tests cover local observations, SSH metadata/profile parsing, fixed checks with injected subprocesses, cache expiry/failures, association, service plans and personal cloud access boundaries. Ephemeral fixture identities exercise signatures, proof boundaries, replay, approval, revocation and expiry through isolated HTTP/SQLite tests. They do not contact real hosts, establish a production identity, validate remote task authority or constitute a protocol audit. External deployment verification is separately recorded in `docs/deployment-readiness.md`. A private security-reporting channel, license and public release plan remain to be selected. Do not post credentials, host metadata or private logs in public issues.
+Do not post private keys, enrollment codes, cookies, logs or live credentials publicly. Contact the maintainer through a private channel before sharing sensitive details. The repository may be private even while the MIT npm package is public; no public issue tracker or bounty is promised. Stop recommending an affected beta and issue a new version rather than overwriting a published artifact.

package/bin/device-center.mjs

@@ -10,9 +10,8 @@ export function parseCli(argv = []) {
     if (argv.length > 1) throw new Error('帮助和版本命令不接受其他参数。');
     return { command: command === '-v' ? '--version' : ['-h', '--help'].includes(command) ? 'help' : command };
   }
-  if (!['start', 'plan', 'connect', 'run', 'status', 'disconnect', 'service'].includes(command)) throw new Error('未知命令。运行 device-center --help 查看用法。');
+  if (!['start', 'plan', 'connect', 'run', 'status', 'disconnect', 'service', 'access'].includes(command)) throw new Error('未知命令。运行 device-center --help 查看用法。');
   const args = argv.slice(1);
-  if (command === 'connect' && !args.includes('--cloud')) throw new Error('请用 --cloud 明确指定自己的 HTTPS 控制面域名。');
   if (command === 'start') {
     let port = 5174;
     if (args.length) {
@@ -44,7 +43,10 @@ device-center service plan|status|install|uninstall [--port 5174] [--confirm]
 
 默认端口5174，数据位于本用户的应用数据目录。关闭网页不会停止前台进程。
 默认回报本机名称、系统、内存和磁盘；--share-ssh 需命令申请及面板另行批准。
-远程任务、自动选路和 Windows Driver 尚未实现。安装包不含身份或配对码。
+本机无需平台注册；connect 默认申请接入 https://devices.owenshen.top，需登录自己的账号核对批准。
+--cloud 可使用自建域名。device-center access help 查看受限日志授权与可选局域网直连。
+支持 TLS 1.3 双向认证的日志读取与密文中转，默认100MiB/账号/日；不会自动获得操作权限。
+任意远程命令、通用文件传输和 Windows 原生 Driver 尚未提供。安装包不含身份或配对码。
 使用 npx 时只运行前台；常驻请先将本包固定版本安装到长期目录，再单独 install。
 `;
 }
@@ -53,6 +55,7 @@ export async function main(argv = process.argv.slice(2)) {
   if (plan.command === 'help') return helpText();
   if (plan.command === '--version') return version();
   if (Number(process.versions.node.split('.')[0]) < 24) throw new Error('需要 Node.js 24 或更高版本。');
+  if (plan.command === 'access') return (await import('../scripts/access.mjs')).main(plan.args);
   if (plan.command === 'service') {
     if (plan.args[0] === 'install' && /(?:^|[\\/])_npx[\\/]/.test(ROOT)) throw new Error('npx 缓存会被清理，不能用作常驻目录。请先 npm install -g device-center@固定版本，再运行 device-center service install --confirm。');
     return (await import('../scripts/service.mjs')).main(plan.args);

package/docs/agent-install.md

@@ -0,0 +1,105 @@
+# 让 Agent 安装 Device Center
+
+用户选择模式后，把完整安装说明交给**正在目标电脑上运行、具备本机安装能力的 Agent**。网页只复制说明，不会远程替浏览器所在电脑安装软件。
+
+`device-center@0.2.0-beta.2` 提供“交给 Agent 安装”、设备说明与手动采集。新用户可在[一页试用指南](https://devices.owenshen.top/start)免登录选择方式并复制完整说明。
+
+## 用户只需要选择一种方式
+
+| 方式 | 运行在哪里 | 需要账号吗 |
+| --- | --- | --- |
+| 本机使用 | 本机 Driver、面板及 MCP | 不需要；全新安装不申请云端绑定 |
+| 官方托管 | Driver 留在设备；官方服务提供控制面与加密中转 | 登录自己的 App Services／个人站账号并核对配对 |
+| 自建服务 | Driver 留在设备；连接用户已有 HTTPS 控制面 | 使用那套控制面的账号；不会自动部署服务器 |
+
+托管的是面板、设备登记与中转服务。设备身份私钥和指定日志授权仍在设备上，不上传私钥，不让服务商代为持有设备登录能力。
+
+## Agent 执行顺序
+
+只有用户明确要求在当前电脑安装并选择模式后，才能执行以下步骤。阅读本文本身不授予安装、配对或访问其他设备的权限。
+
+### 1. 检查现有环境
+
+- 当前版只支持 macOS / Linux，需要 Node.js 24 或更高版本与 npm。缺少运行环境时使用官方来源；系统授权或管理员操作交由用户处理。Windows 原生 Driver 尚未支持，不能假称已安装成功。
+- 检查已有 CLI、用户级服务、本机端口和绑定。已安装在下面固定位置时，可以运行 `"$HOME/.local/bin/device-center" status` 与 `"$HOME/.local/bin/device-center" service status --port 5174`，不要直接打开身份私钥文件。配置一致则复用；版本、控制面或启动方式冲突时解释，让用户选择。保留已有身份、数据库、MCP 配置和其他程序。
+- 默认端口 `5174`。若已被其他程序占用，选择明确的可用本机端口，并同步后面的面板、MCP、服务命令。不要停止其他监听进程，不扫描网络。
+
+### 2. 固定安装到用户可写位置
+
+全新安装可以使用：
+
+```sh
+npm install --global --prefix "$HOME/.local" --ignore-scripts device-center@0.2.0-beta.2
+"$HOME/.local/bin/device-center" --version
+```
+
+无需 `sudo npm install`，不修改全局 npm 配置或 shell 启动文件。后续使用完整命令路径。后台服务必须引用固定安装位置，不能以 `npx` 的临时缓存为常驻目录。
+
+### 3. 后台或前台运行
+
+选择后台模式时，先核对计划中的用户、Node 路径、包路径、数据目录和回环地址：
+
+```sh
+"$HOME/.local/bin/device-center" service plan --port 5174
+"$HOME/.local/bin/device-center" service install --port 5174 --confirm
+"$HOME/.local/bin/device-center" service status --port 5174
+```
+
+macOS 使用当前登录用户的 launchd；Linux 需要可用的 `systemd --user`。不自动启用系统 linger。服务配置已存在、端口冲突或健康检查失败时，保留现场并排查，不自动清理或反复重装。
+
+选择仅前台、本机使用时运行：
+
+```sh
+"$HOME/.local/bin/device-center" start --port 5174
+```
+
+保持进程运行；关闭网页不会停止服务，关闭前台终端会停止。若电脑已有云端绑定，`start` 或后台服务可能恢复它，不能声称已切换成“本机专用”；先说明并让用户选择，不自动解绑。
+
+### 4. 托管模式才申请绑定
+
+官方服务先预览回报范围，再申请配对：
+
+```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
+```
+
+自建模式替换为用户明确提供的 HTTPS 控制面域名，不携带路径、账号或参数。不能自动覆盖其他控制面的绑定。
+
+用户在该控制面登录自己的账号，核对本机终端的完整公钥指纹，再手动批准新增设备。Agent 不代为批准，不读取密码、cookie 或私钥；配对码留在本机终端，不贴进智能体对话、脚本或链接。若 Agent 的执行工具会把终端配对码自动记录进对话，只把这一步交给用户在本机终端执行，Agent 继续其他检查。
+
+前台 `connect` 在批准后启动 Driver；已经运行的用户服务会读取绑定并开始回报。不能仅凭 `configured=true` 宣称云端已收到数据，要核对真实回报和时间。
+
+本机模式跳过这一步，全新安装不生成设备身份或申请账号。
+
+### 5. 连接当前智能体并验收
+
+读取本机 `http://127.0.0.1:5174/api/connector/setup`，通过当前智能体支持的 MCP 配置接口添加 **Streamable HTTP** 地址：
+
+```text
+http://127.0.0.1:5174/mcp
+```
+
+复用一致的配置，不覆盖其他 MCP。不能直接配置时，只需用户粘贴这个地址；不要编造握手成功。
+
+必须检查实际结果：
+
+1. `/api/health` 返回 `ok: true` 且为本机模式；用 CLI `--version` 检查安装版本，并核对服务计划引用的安装目录。健康接口本身不提供版本号。
+2. `/api/overview` 的本机内存、磁盘为真实采集，失败项如实报告。
+3. 选择后台模式时，核实服务实际运行，而不仅是配置文件存在。
+4. 当前智能体实际调用 `device_center_list_resources`。
+5. 托管模式核实绑定与云端收到回报，说明尚需用户完成的步骤。
+
+最终向用户给出面板/MCP 地址、启动方式、绑定结果及未完成项。卸载用户服务仅在用户主动要求时执行；默认保留数据和身份：
+
+```sh
+"$HOME/.local/bin/device-center" service uninstall --port 5174 --confirm
+```
+
+默认不导入或连接 SSH 主机、不分享 SSH、不扫描局域网、不开放设备入站端口、不配置隧道、不授予日志或命令权限。安装与绑定不等于远程操作授权。
+
+## 给 Agent 的公开文档入口
+
+当前源码服务提供固定路径 `GET /install/agent.md`，仅返回本文，不需要登录，不含账号、身份或设备清单。官方入口为 https://devices.owenshen.top/install/agent.md；自建服务使用自己的域名与相同路径。
+
+使用界面复制的完整安装说明无需 Agent 先访问这个入口。需要指定日志与局域网能力时，另见[远程访问](remote-access.md)并由设备主人逐项授权。

package/docs/architecture.md

@@ -1,66 +1,34 @@
 # 架构
 
-## 当前实现
+Device Center 是模块化 Node.js 单体，前端静态文件无构建步骤。Node.js 24 内置 SQLite，Node/OpenSSL 提供 TLS；@peculiar/x509 创建标准证书，依赖由 npm-shrinkwrap 固定。
 
-一个 Node.js 24 进程提供网页、SQLite 设备关联 API 和 `/mcp` Streamable HTTP 端点。MCP 与网页读取同一个库存适配器：实时本机 Driver + 显式保存的 SSH 引用和检查快照 + 既有非示例设备。运行依赖为零，原生 JavaScript/CSS 保留紧凑侧栏。
+## 两个运行位置
 
-- `server/database.mjs` 只建表，不创建任何设备或示例数据，不做自动清理。
-- `server/modules/devices/repository.mjs` 排除旧版 `is_demo=1` 行。在线状态来自回报时间；未回报为未知，超过五分钟为过期。内存与磁盘独立序列化。
-- `server/drivers/local.mjs` 用 Node OS 接口与 `statfs` 读取真实本机指标；进程运行中为在线。内存含缓存，磁盘范围为用户目录所在卷；两项独立处理失败。容器只表示容器 Driver，不报告宿主指标。
-- `server/drivers/sshConfig.mjs` 有界读取配置、枚举明确 Host 别名；不读取密钥，不调用 OpenSSH、解析动态条件或连接目标。最多 32 个配置文件、每文件 128 KiB、总计 512 KiB、递归 5 层、200 个别名；安全范围外 Include 和条件 Include 跳过并提示。
-- `server/drivers/inventory.mjs` 保存用户勾选的 SSH 别名及时间，按租户命名空间隔离，事务内幂等插入。检查成功五分钟内为在线，之后过期；失败、配置缺失或配置摘要改变为未知。GET 和 MCP 只读取缓存，不连接目标。别名不是物理设备唯一身份。
-- `server/drivers/sshProbe.mjs` 对根配置中的完整明确 Host 和命名 ProxyJump 建立隔离 SSH 配置；涉及 Match、条件 Include 或自定义命令的条目停止审核。OpenSSH 复用现有身份引用、严格校验已有 known_hosts，不写主机信任。固定 POSIX 脚本读取 macOS/Linux 基础资源；25 秒超时、32 KiB 输出、最多两个并发，不接受命令或文件路径。
-- `server/connector.mjs` 共享四个只读 MCP 工具：Driver 状态、实际库存、SSH 配置候选、能力边界说明。没有命令、任意文件、日志或设备操作工具。
-- `server/index.mjs` 提供无状态 HTTP MCP 的 JSON 响应，通知返回 202，不创建会话令牌，不提供 SSE（GET 返回 405）。记录最近有效初始化时间；不将记录当成鉴权、持续在线或设备心跳。
-- `server/mcp.mjs` 兼容原有 stdio 配置，只读同一实际库存。stdio 进程与 HTTP 服务不共享运行状态，所以不会出现在面板的 HTTP 初始化记录中。
-- `scripts/service.mjs` 默认只输出计划；用户显式执行安装才登记 macOS/Linux 用户级服务。
-- Docker 是可选的本机运行容器，MCP 仍由宿主智能体主动连接。没有宿主挂载或 Docker socket 权限。
-
-## 请求边界
-
-首次使用界面统一为管理电脑、智能体、设备三步，复用同一组本机状态与 API。原生本机资源可读时自动跳过管理电脑步骤；只有近期真实 MCP 初始化记录才跳过智能体步骤。允许稍后接入后直接导入引用，不生成握手或任务操作授权。点击导入会为新增设备排队执行一次固定 SSH 只读检查。独立管理 Driver 可向 HTTPS 域名申请配对，所有者单独输入码、核对指纹并批准后，按固定字段回报资源；未取得回报仍为未知。完整流程见[使用引导](onboarding.md)。
-
-页面外框固定为视口高度，侧栏与顶部不参与设备列表滚动。设备用紧凑行展示，内存和磁盘仍为独立列；小屏内部换行，空间不足时仅列表滚动。打开/关闭弹窗、刷新和快照过期重绘保留列表位置；改变搜索或状态筛选回到列表顶部。采集口径移到数值提示和可展开状态说明，失败仍明确显示。
-
-`server/drivers/sshRoute.mjs` 从用于只读检查的已核验配置生成非秘密路径节点，面板与 MCP 共用。每台设备显示路径摘要，可打开图示与认证说明；`lastVerifiedRoute` 只在配置摘要与经过认证的检查结果一致时提供，资源采集是否可用单独判断。内部 `expired` 在面板显示“待刷新”，只说明数据时效。当前固定按配置连接，未实现自动 LAN 选路；具体方案与验收见[访问路径与局域网优先](connection-routing.md)。
-
-`server/drivers/connectionPlans.mjs` 校验并保存每台已关联 SSH 设备的本机计划：可同时登记 LAN 地址/端口与用户自建、项目托管或 Cloudflare 中转类型，以及 LAN 优先/仅中转策略。写接口要求明确同源 Origin；不接受凭据、任意 URL 或额外字段。新增表不清理或覆盖已有设备、配置与快照。库存与 MCP 读取 `connections`，其中 `effective: false`；未验证入口及未接入中继不会改变在线状态，现有检查仍仅使用原 SSH 配置。
-
-原生进程固定监听 `127.0.0.1`。仅接受回环 Host 和同源 Origin，拒绝跨站请求；静态内容有 CSP，不启用 CORS。MCP JSON 请求上限 16 KiB，检查类型、Accept、协议版本和工具参数。MCP 协议按 [2025-11-25 transport](https://modelcontextprotocol.io/specification/2025-11-25/basic/transports) 实现本机无状态只读子集。
-
-底层仅保存引用的 `POST /api/devices/ssh`：必须明确同源 Origin、JSON、小于 16 KiB；只接收 aliases 数组，重新核对当前候选，其他字段拒绝。只写本地别名引用，不执行远端操作。MCP 没有关联写入或网络检查工具。
-
-初始化预览 `GET /api/ssh/initialization` 在发现结果上增加本机配置检查：`sshInitialization.mjs` 复用隔离配置解析器，并用 stat/access 检查目标与跳板身份文件的引用是否可读取；不读身份内容，不执行 SSH。返回 importable / reason / routeMode，不返回身份路径或配置原文。`POST /api/ssh/initialize` 要求明确同源 Origin、严格 aliases 字段和最多 200 个别名；提交时重新核对可导入状态，再通过原有关联事务保存引用。同名导入幂等，未通过检查时整批拒绝、提示重读；不写快照、连接计划或主机配置，不自动探测、删去无效条目或授予任务权限。此处的初始化与 MCP initialize 握手是两个独立概念。
-
-面板使用组合写接口 `POST /api/devices/ssh/associate-and-check` 与 `POST /api/ssh/initialize-and-check`，保存引用后只为新增别名启动一次固定检查。`POST /api/devices/ssh/check-batch` 接受严格的 aliases 数组，最多 200 个、必须已关联且当前仍存在；队列按别名去重，所有检查共享两个并发限制。关闭网页不取消队列，进程重启不恢复未完成检查；已完成结果持久化。GET / MCP 不排队、不重试。前端仅在队列有工作时每秒读取库存，失败三次停止读取并提示刷新。
-
-`POST /api/devices/ssh/remove` 也要求明确同源 Origin 和严格 aliases；拒绝移除正在检查或排队的条目。事务内删除指定引用、快照和计划，再写 `ssh_exclusions`。仅排除当前租户指定别名，不改系统配置或身份文件，也不自动删无效候选。排除项跨重启保留，其他租户不受影响。
-
-库存 `ssh.connectivity` 区分 unobserved / queued / checking / passed / failed / stale / configuration-changed，并提供检查时间和失败码。通过认证后资源脚本不支持或失败，仍可标记 SSH 连通，指标与设备状态保持未知。只在已通过验钥的 OpenSSH 检查完成或收到远端命令退出状态时作此判断；SSH 错误、超时和资源错误不混淆。成功资源快照的原有五分钟状态仍保留，检查不授予远程任务权限。
-
-只读 SSH 解析器按独立范围处理 `Match`。明确且纯静态的 `Match originalhost alias[,alias]` 只让它命中的目标或跳板配置进入人工核验；不将这段条件错误归入紧邻的前一个 Host。条件选项不会进入隔离检查配置；动态、通配或其他复杂条件仍按原规则停止核验，不执行条件命令。
-
-`POST /api/devices/ssh/check` 同样要求明确同源 Origin，只接受已关联且当前仍存在的 alias；由所有者主动发起。它会真实执行固定远端只读采集，不能传入任意 shell、路径或命令。仅支持非 Windows 原生管理端；容器没有宿主认证权限。结果保存在独立快照表，原始 stdout/stderr 与私钥内容不进入数据库或响应。
-
-本机模式不实施用户鉴权。可信范围仅是同一用户管理的本机，允许读取指标、登记引用和发起固定 SSH 采集；服务使用运行用户已有 SSH 认证，其他本机程序也可能访问端点并触发该采集。租户命名空间不是认证。初始化名称不用于识别所有者。不能只把监听地址改成 `0.0.0.0`。
-
-个人云端模式由 `cloudAccess.mjs` 提供请求边界和显式认证方式；`unifiedAccess.mjs` 负责 App Services 身份核验。私有配置指定同父域名的账号站、HTTPS `/v1/me` 服务及唯一所有者邮箱。复用共享 HttpOnly 会话，不解码 JWT 作为信任、不复制签名密钥；身份结果缓存10秒，验证超时/异常拒绝访问，不回退密码。面板会话8小时、只存凭据摘要，需匹配当前共享身份；面板退出不退出其他应用，账号站退出/切换则使面板失效。未登录静态登录页与方式接口可访问；机器配对申请公开并限速，轮询/回报/断开要求独立身份签名，其余网页、库存及所有者写入口受保护；继续/退出严格同源，缓存与验证并发有上限。独立密码方式仍需显式私有scrypt配置，未知方式启动失败。后端回环监听，Nginx覆盖Host/协议头。云端库存与本机库存分开，未绑定时返回空设备，拒绝SSH/MCP设备接口，不读取服务器SSH。管理电脑身份、配对与回报由 driverProtocol.mjs、cloudRegistry.mjs、cloudLink.mjs 独立处理；浏览器会话不能代替机器签名。默认本机指标，SSH 名称/缓存分享需双重显式批准，不上传认证配置或私钥。云端不提供远程操作或多用户权限协议。参见[协议与生命周期](driver-binding.md)。
-
-`DEVICE_CENTER_RUNTIME=container` 只供本机 Docker recipe 在容器网络中监听，Compose 对宿主机只发布回环端口。该环境变量并不能证明进程真的位于容器，不是安全鉴权开关；不要在原生启动时设置。Host/Origin 检查仍启用。Docker 默认端口映射经明确 Host IP 限制；实际运行未验证。
-
-## 后续角色
+- 本机 Driver：本机真实资源、已有 SSH 别名引用和缓存、回环 HTTP 面板/MCP；原生模式可显式绑定控制面，运行资源 Publisher 与获准日志 Agent。容器只代表自身。
+- 云端控制面：统一账号鉴权、账号隔离的设备登记/回报/撤销、密文 Relay。不会读取服务器 SSH 或把服务器伪装成管理电脑；没有云端远程 shell/MCP。
 
 ```mermaid
 flowchart LR
-  AI[管理电脑 AI] --> MCP[MCP]
-  MCP --> Driver[本机 Driver]
-  Driver --> Ref[SSH 配置引用]
-  Ref --> Snapshot[显式只读检查与缓存]
-  Snapshot --> Host[已有 SSH 主机]
-  Ref -.单独授权的任务适配器.-> Task[指定日志与受限任务]
-  Driver -.设备主动连接.-> Agent[资源设备 Agent]
-  Agent -.主动安全出站.-> Cloud[控制面与中继]
-  MCP -.获准 LAN 直连或中继.-> Cloud
+  AI[本机智能体] --> MCP[回环 MCP / 管理 Driver]
+  MCP -->|获准精确 LAN 地址 · 双向 TLS| Target[目标 Driver · 日志授权]
+  MCP -->|TLS 密文 / 签名 HTTPS| Relay[官方或自建控制面]
+  Relay -->|目标主动取帧| Target
+  Target -->|签名指标回报| Relay
 ```
 
-虚线能力尚未实现。资源 Agent 本地生成身份私钥，只登记公钥。一次性短期登记码单独交互输入。安全连接只提供可达性，不能授予远程任务权限。首次有效观测后才展示在线和资源读数。线上同步只迁移获准非秘密登记元数据，不能复制设备私钥、任务权限或在线状态。
+## 模块
+
+| 模块 | 职责 |
+| --- | --- |
+| index / cloudAccess / unifiedAccess | 本机请求边界、HTTPS代理验证、固定上游账号核验、会话 |
+| inventory / sshConfig / sshProbe / sshRoute | 被动解析 SSH 元数据、显式只读检查、独立指标和核验路径 |
+| driverProtocol / cloudRegistry | Ed25519 签名上下文、持久防重放、一次性配对、租户归属与资源时效 |
+| certificates | 同设备身份的 X509 创建、指纹与自签验证 |
+| relay | 有界密文帧队列、成员与撤销验证、持久日额度 |
+| access / remote | 本机指纹信任、单文件限时授权、日志尾读、审计、标准双向 TLS、直连及回退 |
+| connector | 四个本机只读工具，另有同账号设备查询和获准日志读取，共六个工具 |
+| scripts/driver / access / service | 显式绑定、端上授权、用户级常驻；不会在 npm 安装钩子中运行 |
+
+两条路径使用同一证书身份和端上授权。云端登记不授予日志权限；peer目录不能替换本机核对过的指纹。只有网络不可达可回退，认证错误停止。现有 SSH 设备的“连接计划”仍只保存元数据，与 Agent 通道分离。
+
+TLS 记录分片经签名 HTTPS 请求转发，不自行设计密码协议。会话60秒，队列有上限；连接失败后不恢复/重放操作。当前仅只读日志，没有通用任务系统。参见[完整协议边界](remote-access.md)。

package/docs/connection-routing.md

@@ -1,5 +1,6 @@
 # 访问路径与局域网优先
 
+> 0.2.0-beta.1 更新：账号隔离、TLS 1.3 双向认证密文中转、独立授权的日志尾读及获准精确 LAN 优先已实现。旧文中的“尚未实现”传输描述属于此前阶段；实际操作与边界以 [远程日志](remote-access.md) 和 README 为准。通用远程命令、文件传输、Windows 原生 Agent 与自动迁移仍未提供。
 ## 当前能做什么
 
 面板的每台设备显示配置路径，点击路径可查看节点、地址和端口。MCP 库存读取同一份信息。原生本机由进程直接采集；SSH 设备的路径来自保守解析并用于检查的配置，读取与展示时不调用 `ssh -G`、不解析动态命令、不探测 DNS 或网络。导入后一次检查、或用户手动重试，才实际访问已配置路径。