v0.1.0:统一安装引导、Docker 一体化分发与浏览器首配闭环
首个公开版本。Memory Platform 是本地优先、可审计、可治理的 AI 长期记忆平台:Memory Gateway 负责长期记忆与知识治理,Model Gateway 负责模型渠道、用途路由、故障切换、归因和费用。
安装
一键脚本(推荐,macOS / Linux,无需 Python/Node,也不用 clone 仓库):
curl -fsSL https://raw.githubusercontent.com/SparkHello/Memory_Platform/main/deploy/install.sh | sh脚本会检查 Docker、下载用户版 Compose、自动避开被占用的端口、等待首启就绪,并打印 GATEWAY_API_KEY、admin key 和客户端接入信息。重复运行即升级到最新镜像,数据保留在卷中。
手工方式(Windows,或想自己控制每一步):
curl -O https://raw.githubusercontent.com/SparkHello/Memory_Platform/main/deploy/docker-compose.user.yml
docker compose -f docker-compose.user.yml up -d
docker compose -f docker-compose.user.yml logs memory-platform # 查看一次性打印的 GATEWAY_API_KEY 与 admin key镜像:ghcr.io/sparkhello/memory-platform:v0.1.0(linux/amd64 + linux/arm64)。全部运行数据在 memory-platform-data 卷,升级为 docker compose pull && up -d。
一键脚本在 v0.1.0 发布之后加入,安装时从
main获取,与本版本镜像配合使用没有问题。
源码(macOS/Linux,Python ≥ 3.12 + Node 22):
git clone https://github.com/SparkHello/Memory_Platform.git
cd Memory_Platform
scripts/setup.sh首次配置
- 浏览器:打开
http://127.0.0.1:2026/ui/→「模型与路由」→ 粘贴安装时打印的 admin key →「新建渠道」向导(选预设、填渠道 key、从自动发现的模型列表选择),无需任何 CLI 操作。 - 命令行:
modelgw quickstart(内置 DeepSeek / Kimi 中国区 / 小米 MiMo / 阿里云百炼预设)。 - AI 辅助:见
docs/ai-install.md,配置契约docs/ai-quickstart.schema.json。
客户端接入
Chatbox / RikkaHub / FLIT 等任意 OpenAI 兼容客户端,填三项即可:http://<地址>:2026/v1 + GATEWAY_API_KEY + 模型名固定 memory-auto。详见 docs/client-setup.md(含常见坑速查表)。MCP 端点 /mcp 用于知识库与模型自助记忆管理。
本版本主要内容
- 根
scripts/setup.sh一键安装双服务运行栈;AI 辅助 quickstart(不含密钥的 JSON recipe + stdin 密钥输入)。 - 单容器 Docker 分发:首启自动接线、密钥一次性打印、
/data卷持久化;GHCR 多架构镜像与 CI smoke test。 memgw stack install自动生成并各打印一次GATEWAY_API_KEY与 Model Gateway admin key。- Web Console「新建渠道」分步向导;Model Gateway 新增
POST /admin/connections、POST /admin/deployments(revision 冲突检测、dry_run、整图校验、原子写入热加载);discovery check 返回可见模型列表。 - 面向个人用户的
docs/client-setup.md接入指南。
边界
面向个人、本机或可信家庭网络;不要把默认部署当作公网多租户 SaaS。详见 README 的「配置与安全边界」。