# 设备发现与共享

本功能是 GoodBuddy 桌面端管理附近设备、本机共享和 ShareServer 连接的唯一入口。默认连接
方式是局域网；网关由用户额外添加。功能不包含 ShareServer 的组织管理 Web 界面。

## 文档导航

| 文档 | 权威职责 |
| --- | --- |
| [PRD](./prd.md) | 用户问题、范围、功能需求和产品验收 |
| [功能逻辑](./logic-design.md) | 不变量、状态、授权优先级和失败结果 |
| [UI 设计](./ui-design.md) | 设置入口、四个页签、配对与调用交互 |
| [技术设计](./technical-design.md) | Desktop 进程边界、持久化、IPC、网络和验证 |
| [共享网络总体设计](../../architecture/share-network-architecture.md) | 跨端身份、能力、授权、任务、更新和协议权威 |

当前没有单独的 User Stories：正常、失败、撤销、权限和兼容场景已直接进入 PRD 验收与逻辑
决策表。功能尚未实施，因此不创建 `progress.md`。

## 术语

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

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