Repository navigation
MindForge v5.8.13
本地优先、端到端加密的 AI Agent 终身记忆系统 —— 四层记忆生命周期 · 知识图谱 · 混合检索 · MCP / CLI / REST / SDK 全接口 · 全部数据留在本机。
🎯 本版本核心变更
1. 全源码迁入 mindforge.* 命名空间(消除顶层包冲突)
core/modules/mcp/api/cli/adapters全部移入mindforge/子包,不再以顶层包名进入 site-packages,消除与官方mcpSDK 等三方库的冲突- 仓库根保留
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/checkoutv4/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 一键发布指南(owneropok-ops/ repoMindForge/ workflowpublish-pypi.yml/ envpypi)
📦 安装
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)📚 资源
- 文档 / Live Demo:https://opok-ops.github.io/MindForge/
- 仓库:https://github.com/opok-ops/MindForge
- 讨论区:https://github.com/opok-ops/MindForge/discussions
- 许可证:MIT