Skip to content

Releases: SparkHello/Memory_Platform

Release list

Memory Platform v0.5.1

Memory Platform v0.5.1 Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 13 Aug 12:09
v0.5.1
860f931

Signed Memory Platform release artifacts.

Assets 3
Loading

Memory Platform v0.4.0

Memory Platform v0.4.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 12 Aug 05:14
v0.4.0
bd1b17a

Signed Memory Platform release artifacts.

Loading

Memory Platform v0.2.0

Memory Platform v0.2.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 10 Aug 05:47
v0.2.0
419a08a

Signed Memory Platform release artifacts.

Loading

v0.1.2：修正容器日志中的接入端口

v0.1.2：修正容器日志中的接入端口

Choose a tag to compare

View all tags
@SparkHello SparkHello released this 08 Aug 14:43
v0.1.2
3b4b900

修正一处会把改过端口的用户带偏的安装引导问题。建议所有 Docker 用户升级。

升级

curl -fsSL https://raw.githubusercontent.com/SparkHello/Memory_Platform/main/deploy/install.sh | sh

重新运行即可，数据保留在 memory-platform-data 卷中。镜像：ghcr.io/sparkhello/memory-platform:v0.1.2（linux/amd64 + linux/arm64）。

修复

容器日志里的「接入信息」此前打印的是容器内部固定的 2026 端口，而不是宿主机上实际映射的端口：

接入信息
------------------------------------
Web Console            http://127.0.0.1:2026/ui/     ← 端口不对
OpenAI 兼容 base URL   http://127.0.0.1:2026/v1

只要端口不是 2026，这份地址就是连不上的。这不是罕见路径：一键脚本在 2026 被占用时会自动顺延到 2027、2028……而文档恰恰引导用户回到 docker compose logs 里找密钥和接入地址，他们看到的就是这段。

用户版 compose 现在通过新的 MEMORY_PUBLIC_PORT 把实际映射端口告诉容器，日志里给出的是真正能访问的地址。非数字值回退到原有行为；源码安装（scripts/setup.sh）不设该变量，行为不变。

同时给「接入信息」里的 Model Gateway base URL 补上标注：

Model Gateway base URL http://127.0.0.1:2030/v1
                       ↑ 内部接线地址，不要填进客户端

与 Web Console 横幅的说法保持一致，避免有人把内部接线地址填进客户端。

完整改动见 CHANGELOG。

Loading

v0.1.1：一键安装脚本、自带密钥与安装引导修复

v0.1.1：一键安装脚本、自带密钥与安装引导修复

Choose a tag to compare

View all tags
@SparkHello SparkHello released this 08 Aug 14:12
v0.1.1
816332b

面向安装体验的一个小版本：一键安装脚本正式进入发布镜像，支持自带密钥，并修掉三处会把新用户带偏的安装引导问题。

安装

curl -fsSL https://raw.githubusercontent.com/SparkHello/Memory_Platform/main/deploy/install.sh | sh

脚本会检查 Docker、下载用户版 Compose、自动避开被占用的端口、等待首启就绪，并打印 GATEWAY_API_KEY、admin key 和客户端接入信息。首次启动需要 1–2 分钟完成容器内部安装。

镜像：ghcr.io/sparkhello/memory-platform:v0.1.1（linux/amd64 + linux/arm64）。从 v0.1.0 升级重新运行上面的命令即可，数据保留在 memory-platform-data 卷中。

两枚密钥分别用在哪

安装会打印两枚密钥，用途不同：

  • GATEWAY_API_KEY —— 客户端（含手机）和 Web Console 登录用。只有这一枚需要填进客户端。
  • admin key —— 权限更高，只在这台电脑的浏览器里解锁模型渠道与路由配置时用，不需要填进任何客户端，也不需要传到手机上。

新增：可以自己指定密钥

不想用自动生成的随机串，可以在首次安装时自带（至少 16 个字符、不含空白）：

GATEWAY_API_KEY=你自己的密钥 sh -c "$(curl -fsSL https://raw.githubusercontent.com/SparkHello/Memory_Platform/main/deploy/install.sh)"

MEMORY_CONSOLE_ADMIN_KEY 同理。两者对用户版 compose 和源码安装的 scripts/setup.sh 一样生效，留空则维持原来的自动生成。密钥只经进程环境传递，不会写进安装目录的 .env。

安装完成后更换密钥用 memgw secret set gateway / modelgw secret set memory-console-admin。

提醒：不要用聊天软件或剪贴板同步工具把密钥传到手机——那等于交给了第三方。自己设一个记得住的强密码更稳妥。

修复

  • scripts/setup.sh 结束时没有打印客户端最需要的 /v1 Base URL，只给了管理台地址，容易让人把 /ui/ 地址填进客户端；端口也不再硬编码 2026，改为读取实际配置。
  • 通过环境变量传入的 GATEWAY_API_KEY 现在会持久化到 settings.env。此前只有自动生成的分支才写盘，自带密钥在服务重启后会丢失。
  • 端口被占用时给出的重试命令用了 $0，而通过 curl | sh 运行时 $0 是 sh，用户复制到的是跑不起来的 sh sh。
  • 一键脚本此前无法区分「重复安装」和「首装但日志解析失败」，会对首次安装的用户谎称"检测到已有安装、密钥沿用旧的"，把人引向根本不存在的旧密钥。现在改为在启动容器前精确匹配本 compose 项目的数据卷。

完整改动见 CHANGELOG。

Loading

v0.1.0：统一安装引导、Docker 一体化分发与浏览器首配闭环

v0.1.0：统一安装引导、Docker 一体化分发与浏览器首配闭环

Choose a tag to compare

View all tags
@SparkHello SparkHello released this 08 Aug 04:15
v0.1.0
cbe8c83

首个公开版本。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 的「配置与安全边界」。

Loading