Skip to content

MindForge v5.8.13

Latest

Choose a tag to compare

@opok-ops opok-ops released this 03 Oct 03:32
· 13 commits to master since this release

MindForge v5.8.13

本地优先、端到端加密的 AI Agent 终身记忆系统 —— 四层记忆生命周期 · 知识图谱 · 混合检索 · MCP / CLI / REST / SDK 全接口 · 全部数据留在本机。

🎯 本版本核心变更

1. 全源码迁入 mindforge.* 命名空间(消除顶层包冲突)

  • core / modules / mcp / api / cli / adapters 全部移入 mindforge/ 子包,不再以顶层包名进入 site-packages,消除与官方 mcp SDK 等三方库的冲突
  • 仓库根保留 MindForge.py 向后兼容入口(from MindForge import MindForge 仍可用),新代码统一 from mindforge import ...

2. 版本号唯一真值

  • pyproject.toml 改为 dynamic = ["version"],通过 [tool.setuptools.dynamic] 读取 mindforge/core/version.py 的 __version__;发版只需改一处

3. PyPI 发行名 mindforge-memory

  • 规范名 mindforge 已被第三方客户端占用(PyPI 项目名大小写不敏感),发行名定为 mindforge-memory;Python 模块名 mindforge.* 与 CLI 命令均不变

4. 打包与文档一致性

  • setup.py 收敛为薄壳;README 导入示例统一为 mindforge.*;check_docs_consistency 适配 dynamic version 校验

5. CI 依赖升级与 Dependabot 收口

  • actions/checkout v4/v5 → v7(仓库无 pull_request_target,不存在 fork PR 检出风险);合并 #9(sentence-transformers ≥2.7.0),关闭冲突 PR #8

6. 全量 938 项测试通过(Python 3.9–3.13 × CI 矩阵)

🚀 master 后续动态(尚未打新 tag)

  • 测试性能优化:test_v568_fixes 守卫用例 _code_text 加缓存后 -43%(42.6s → 24.2s),938 项仍全绿
  • DeepSeek Harness 插件 v0.5.0(plugins/dsh):9 个记忆工具 + turn/start 自动召回 + turn/end 自动捕获 + auto-start 后端;修复 v5.8.13 命名空间下的 auto-start 启动命令,依赖对齐 DSH 0.2.0-rc 线
  • RELEASE.md:PyPI Trusted Publisher 一键发布指南(owner opok-ops / repo MindForge / workflow publish-pypi.yml / env pypi)

📦 安装

git clone https://github.com/opok-ops/MindForge.git
cd MindForge
pip install -e .
from mindforge import MindForge

m = MindForge(db_path="./data/memory.db", encrypted=False)
m.add("User prefers type-hinted Python code", category="preferences", importance="HIGH")
result = m.search("coding preferences")
print(result.chunks[0].content)

📚 资源