提问指南与常见问题入口

[apuos-admin]

什么问题适合发在这里

不确定如何配置、对操作含义有疑问、遇到现象但暂时无法稳定复现，都可以先在这里提问。标题尽量包含模块和目标，例如“设备同步：手机配对成功后如何选择接收目录”。提供当前系统和应用版本、设备型号、访问方式，以及已经尝试过的方法。

常见问题先查这些

1. 设备从哪里进入？ 从设备所在局域网打开实际 NAS 地址，默认 Web API/桌面端口为18080；不要把 SSH 密码、SMB 凭据和 NAS 网页会话混为一谈。
2. 刚安装的应用打不开？ 检查安装是否真正完成、所需服务是否启动、硬件架构及依赖是否满足，查看对应应用的错误记录。
3. 同步上传返回503？ 新版接口会在配置的数据卷离线时禁止写入缓存，不会偷偷改写系统盘。先检查挂载，再核对文件管理/文件互传套件与账号权限。
4. 远程直连失败？ 配对服务在线不代表双方网络一定能通过 UDP 直连。记录连接阶段和脱敏错误，不要通过关闭证书或权限校验解决。
5. AI没有回答？ 核对所选模型、连接配置、可用内存和调用错误；云端模型与本地模型具有不同运行条件。

怎样得到有效帮助

使用编辑器提供的提纲。描述希望完成的任务、实际表现和已做检查；提供完整错误码并遮蔽敏感信息。确认是可复现缺陷后，可在 Bug 与 Issue 板块创建一个缺陷主题，并在两个主题之间保留链接。可参考开始使用、常见问题。

发布前检查

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

投稿审核与发送限制

社区保留新用户审核和发送频率限制。新用户或符合审核条件的主题/回复会先进入审核队列，审核通过后才出现在公开板块；“已提交待审核”不等于已经公开，也不是丢帖。可以在本人的待审内容中查看进度，不要连续重复提交。普通用户不能审核他人内容或发布官方公告；维护者通过原生审核操作处理真实投稿。