FAQ 与反馈

需求

适用于确认常见边界或在排查后提交可复现问题。反馈前先阅读 快速诊断 与 已知限制，并删除所有密钥、令牌、QQ 二维码、账号隐私和世界敏感数据。

架构

反馈应能回答“哪个版本、哪个组件、执行了什么、预期什么、实际发生什么”。最小材料包括：

• Alice 版本与 Windows 版本；
• Java/Bedrock/QQ 中受影响的接入类型及版本；
• 是否同机运行，相关本机端口；
• 完整复现步骤、发生时间和原始错误文本；
• 已尝试的诊断步骤；
• 必要且已脱敏的日志片段。

执行

常见问题

Alice 有 macOS 或 Linux 正式安装包吗？
当前没有确认；正式桌面发布边界是 Windows NSIS。见 下载与支持平台。

可以把 Minecraft Adapter 放在另一台机器吗？
当前不应这样部署。Java 与 Bedrock Adapter 实际连接 127.0.0.1:27541，按同机限制处理。见 连接问题。

Chroma 不可用会丢失记忆吗？
不会因此阻止 SQLite 记忆原文写入；语义查询失败会降级为 SQLite 关键词搜索。备份仍应以 SQLite 数据为基础。见 记忆与地图索引。

Bedrock 配置里的 host/port 可以改成远程地址吗？
不能据此作保证。当前入口实际按固定 127.0.0.1:27541 使用。见 Bedrock 问题。

QQ 一定要 Docker 吗？
不需要。普通 Windows 用户的默认路径是 Alice 应用内 NapCat desktop；Docker 和外部 OneBot 属于高级方式。见 QQ 智能体与权限。

为什么文档不写固定工具数量？
可用工具由 Alice 版本、工作区、Adapter 类型和扩展动态决定，以当前工作区注册列表为准。见 工具索引。

提交反馈

1. 用 安装验证 重现一次并记录失败步骤。
2. 按本页“架构”清单整理环境与错误，所有敏感值替换为 [REDACTED]。
3. 在项目现有问题反馈渠道提交；标题写明组件与现象，例如“Java：/alice status 已连接但工作区无工具”。
4. 若是文档问题，附页面 URL、错误段落、当前源码或运行结果依据，以及建议改法。

不要上传完整数据库、完整配置目录、QQ 数据目录或未经筛选的诊断包。