# 设备发现与共享

设备共享在测试阶段默认关闭，先在“管理应用 → 设备共享 → 应用设置”启用，再从“应用 →
设备共享”或管理列表的“打开”进入。当前首期连接本地未认证
ShareServer 元数据服务，默认地址为 `http://127.0.0.1:8787`，可注册本机、浏览设备与发布目录、
发布能力或知识的元数据并撤销本机 ID 的条目。设备 ID 只用于识别，不是所有权认证。

当前实现不执行远程能力，不读取、搜索或下载知识正文；来源模式和权限均为元数据声明。
局域网发现、配对、组织网关和远程调用仍是后续设计，不是首期交付内容。

## 文档导航

| 文档 | 权威职责 |
| --- | --- |
| [PRD](./prd.md) | 用户问题、范围、功能需求和产品验收 |
| [功能逻辑](./logic-design.md) | 不变量、状态、授权优先级和失败结果 |
| [UI 设计](./ui-design.md) | 当前应用入口、单页表单与列表，以及后续发现、配对界面 |
| [技术设计](./technical-design.md) | Desktop 进程边界、持久化、IPC、网络和验证 |
| [实施进度](./progress.md) | 首期实现、检查命令、真实 Electron 联调证据及未测范围 |
| [共享网络总体设计](../../architecture/share-network-architecture.md) | 跨端身份、能力、授权、任务、更新和协议权威 |

当前没有单独的 User Stories：首期验收见 PRD 的 `FR-M1` 至 `FR-M5`；后续场景仍在原有
需求与逻辑决策表中保留。下列 Peer、配对、网关术语仅用于后续设计。

## 术语

- **附近设备**：同一局域网内主动广播 GoodBuddy 共享服务的设备。
- **已配对设备**：双方确认设备指纹后建立点对点信任的设备。
- **网关连接**：本机与某个 ShareServer 中特定组织身份的连接。
- **本机共享**：由本机作为提供者发布给 Peer 或组织的能力。
- **远端能力**：由其他设备或组织提供、本机可以查看或调用的能力。

SSH 远程项目是用户明确配置 Host 后操作远端工作区的独立功能，不自动进入设备发现与共享，
详见[远程主机与远程执行](../remote-host/README.md)。