# Device Center · 朋友试用指南

让本机 Agent 看见自己的电脑与闲置设备：真实内存、磁盘、设备用途，以及单独授权的指定日志。本指南版本 `0.2.0-beta.9`，发布状态以 npm registry 为准。

**入口：https://devices.owenshen.top/start**。支持 macOS / Linux，需要 Node.js 24+；Windows 11 提供 PowerShell 预览版，可选择“手动安装”，不需要 AI Agent 或 AD。

## 1. 把安装交给本机 Agent

在入口选择 **本机使用** 或 **官方托管**，复制安装说明，粘贴给正在目标电脑上运行、具备软件安装能力的 Agent。

- 本机：无需账号，安装本机 Driver、面板和 MCP。
- 托管：设备上运行 Driver；官方服务提供账号面板与加密中转，私钥留在设备。
- 自建：填写已有 HTTPS 控制面域名，复用同一 CLI，不自动部署服务器。

Agent 按说明检查已有配置、固定版本安装、设置用户级后台服务、配置 MCP 并核验结果。已有配置冲突时解释并让你选择，不自动覆盖。系统授权或当前 Agent 无法配置 MCP 时，会请你完成对应一步。

不使用 Agent 时，可在全新环境运行 `npx --yes device-center@0.2.0-beta.9 start` 体验本机面板；这是前台方式，终端关闭后停止。长期使用按[完整安装指南](https://devices.owenshen.top/install/agent.md)固定安装。

## 2. 托管模式才需要登录绑定

在官方面板使用**自己的 App Services／个人站账号**登录；没有账号时在账号页注册。被添加的设备会显示五分钟有效的验证码和设备识别码（浏览器页、终端，或由 Agent 在对话里转告），那台设备不需要登录；在你自己已登录的电脑或手机打开 `/link`（或面板“添加设备”）输入验证码，核对识别码后批准。

密码和私钥不发给任何人。验证码只给发起安装的本人看，不发给朋友或群聊：五分钟内任何已登录的人输入它，都可能把这台设备加到自己的账号。绑定只允许说明中的资源回报，不授予远程命令或日志权限。

在另一台自己的电脑重复安装，绑定同一账号。两端需要持续运行 Driver。云端不代替目标设备上的进程。

## 3. 请重点试这四件事

1. **资源**：内存、磁盘分开展示，数据和采集时间是否真实、清楚。
2. **命名**：在“设备说明”填写名字、用途、类型和标签，让 Agent 知道各设备适合做什么。服务与应用由你手动登记。
3. **刷新**：点“采集一次”，观察真实更新时间。旧 Driver 需更新；设备休眠或进程停止时应显示未回报，不伪装在线。
4. **MCP**：让本机 Agent 调用 `device_center_list_resources`，检查是否能读到资源和用途。

指定日志尾读属于可选进阶能力，需两端核对身份和目标设备单独授权，详见[远程日志](https://devices.owenshen.top/install/remote-access.md)。首次试用不需要授予它。

## 遇到问题与反馈

先检查 Node.js 24+、Driver 运行、设备唤醒、网络和系统时间。“待采集／未回报”指数据时效，不是私钥过期；刷新列表不会唤醒已停机设备。端口冲突时改用空闲本机端口，不停止其他程序。

把**系统、版本、所选模式、失败步骤、预期与实际结果**发给邀请你的人。附错误或截图前去掉私钥、配对码、cookie、设备地址及日志正文。

**当前边界：**未提供任意远程命令、通用文件传输、自动扫描、离线局域网授权、本机与云端说明同步。官方试用中转每账号每日 100 MiB（UTC），每方向 16 KiB/s。MIT npm 源码包公开；GitHub 仓库可见性独立管理。