开发者接入入口与最小联调清单

[apuos-admin]

先选择正确的服务边界

官网客户端开发指南说明云端发现/配对、NAS HTTP 和 WebRTC 直传协议。云端只处理连接协调，文件内容与文件信息不上传到发现服务器。NAS 会话、云端配对 bearer 与旧互传 peer claimToken 不可互换。

推荐的联调顺序

1. 查询目标 NAS 的运行版本和 capabilities，核对所需套件、数据卷和实际账号权限。
2. 先在可信局域网完成登录、目录浏览和隔离文件上传；记录权威received断点与最终receipt。
3. 再实现签名配对、NAS明确审批、SDP/ICE验证和实际DTLS证书核对，文件走直连通道。
4. 覆盖断网、过期重新登录、进程重启、错误摘要、同名冲突和提交结果不确定等情况。

怎样报告接口问题

提供方法、路径、版本、脱敏后的请求/响应与错误码。请使用合成小文件和最小代码示例，保留关键字段类型、字节数、偏移和时间单位。不要上传真实NAS密码、Bearer、PIN、私钥或用户原始文件。

新版持久上传接口与早期Flutter单文件原型的能力不同，文档存在不代表旧客户端已经接入。协议描述、便携测试、真实Linux运行、生产账号文件权限与公网NAT条件要分别验证。社区可讨论接口设计和复现过程，确定缺陷后在Bug板块保留独立记录。

发布前检查

请先搜索已有主题，一帖讨论一个主要问题。截图和日志请遮蔽密码、访问令牌、配对码、许可证私钥、个人文件和设备序列号。社区账号独立于 NAS 账号。涉及存储操作时先备份重要数据，按照实际设备与版本核对说明。