内容
# Rifugio 社区
一个可自行托管的 AI 对话、长期记忆和 MCP 工具的家园。
这是一个干净的社区版：仅包含应用程序代码和空模板。生产环境中的记忆、聊天记录、健康数据、媒体、凭证、私有域和私有 Git 历史不属于这里。
## 私有内容
- `.env`: 凭证和加密密钥
- `private/profile.json`: 姓名和关系身份
- `private/features.json`: 可选的个人集成
- `private/persona.md`: 可选的私有角色提示
- `data/`: SQLite 数据库和生成的文件
所有这些都已被 Git 忽略。
## 快速开始（计算机或 NAS）
```sh
node scripts/setup.mjs
# 编辑 private/profile.json
npm run privacy:scan
docker compose up -d --build
```
打开 `http://localhost:8080`。API 在首次启动时创建空数据库和模式。其健康检查端点执行回滚的 SQLite 读取/写入探测，因此它在不留下测试数据的情况下验证存储。
仅限 Android 手机托管的文档请参见 [Termux 部署](docs/TERMUX.md)。请参阅 [部署](docs/DEPLOYMENT.md)、[架构](docs/ARCHITECTURE.md) 和 [安全发布检查清单](docs/PUBLISHING.md)。
## 布局
- `apps/web` — 可安装的 PWA 前端
- `apps/api` — HTTP API 和提供者编排
- `packages/mcp` — 规范的远程 MCP 服务器
- `config` — 公共示例配置
- `private` — 被忽略的本地身份和密钥
- `data` — 被忽略的数据库和生成的媒体
## 安全默认值
任意 shell 执行不是社区 MCP 的一部分。健康检查、无线电、图像、语音、玩具和 CLI 桥接集成默认关闭。API 桥接使用允许列表。MCP 在 `/mcp` 处接受 bearer token；旧版 token-in-path 传输保持兼容，但不应放置在代理访问日志中。
## 许可证和归属
Rifugio 作者的代码在 [LICENSE](LICENSE) 中以 Apache License 2.0 许可。可能从 [SullyOS / 手抓糯米机](https://github.com/qegj567-cloud/SullyOS) 改编的 UI 或虚拟手机部分仍然受 PolyForm Noncommercial License 1.0.0 约束。请参阅 [NOTICE](NOTICE) 和 [包含的 PolyForm 许可证](LICENSES/PolyForm-Noncommercial-1.0.0.md)。
必填声明：版权 (c) 2024-2026 NMJ (SullyOS / 手抓糯米机)
重新分发者必须保留这三个文件和必填声明。商业使用未经单独许可或来源审核而移除/替换 SullyOS 衍生部分的情形是不允许的。
社区版本发布时附带表情符号/字符应用启动器默认值，而不是第三方照片图标。可安装的 PWA 图标是单独的项目资产。
MCP 市场