Back to home

Lesleyshi1015

timeweave-harness-plugin

TimeWeave Memory MCP plugin for DeepSeek Harness - 4 tools, SQLite persistence, BM25 fallback, optional Nemotron embedding

Stars
0
Language
Created
Aug 16, 2026
Updated
Aug 16, 2026

Introduction

🧠 TimeWeave Memory — DeepSeek Harness 插件

给 Harness(一切皆插件)装上"长期记忆"——TimeWeave 五层记忆引擎的标准 MCP 接入。 零 TS 代码、零内部泄露(只暴露 4 个 MCP 工具)、用户自装模型(BM25 降级兜底)。

为什么用 TimeWeave

对比点TimeWeave其他记忆插件
架构五层(时间线/图谱/预测/rawdata)多为单层文件记忆
检索L1 混合检索(语义+词法,紧凑摘要)通常全量重读
TokenL1 摘要 ~82 tokens 替代全量无此压缩
持久化SQLite 跨进程不丢(写读一致)文件/内存
语言中文友好多为英文
降级无模型自动 BM25 关键词依赖完整环境

TimeWeave Memory MCP 接入

TimeWeave 记忆引擎以标准 MCP Server 提供 4 个工具,任何 MCP 客户端/Agent 框架即插即用:

工具用途
bootstrap_context新会话加载核心上下文(替代全量重读历史)
memory_searchL1 混合检索(语义+词法,返回紧凑摘要)
memory_store写入记忆(时间线打点 + 原始数据归档)
memory_recall按 memory_id 取回完整内容(含时间线上下文)

特性

  • 标准 stdio 协议(FastMCP),零框架绑定
  • 写读一致 + SQLite 持久化(跨进程不丢)
  • 优雅降级:无向量模型时自动 BM25 关键词检索
  • 可选增强:安装 Nemotron embedding → 启用 L1 混合检索(2048 维)

启动

python path/to/timeweave-memory-mcp/server.py

用户侧最小安装

pip install mcp
# (可选增强)pip install sentence-transformers
# (可选增强,下载 Nemotron 模型)python -c "from sentence_transformers import SentenceTransformer; SentenceTransformer('nvidia/Nemotron-3-Embed-1B-BF16')"

Harness 接入配置

Harness 内置 MCP 客户端(@deepseek-ai/dsh-mcp-client),在 cordis.patch.yml 中配置:

# cordis.patch.yml
- name: '@deepseek-ai/dsh-mcp-client'
  config:
    servers:
      - serverName: 'timeweave'
        transport: 'stdio'
        command: 'python'
        args: ['F:/MCP集合/timeweave-memory-mcp/server.py']  # ⚠️ 替换为你的实际绝对路径
        toolCallTimeoutMs: 30000

Windows 提示:确保 python 在 PATH 中(或把 command 写成 python 的绝对路径,如 'C:/Python313/python.exe')。

启用后,Harness 的 agent 即可调用 bootstrap_context / memory_search / memory_store / memory_recall 四个工具,获得跨会话长期记忆。


安全边界(内部结构零泄露)

  • 只暴露 MCP 工具:4 个工具是全部对外接口
  • 不暴露内部:五层架构 / 检索融合策略 / 压缩细节 / embedding 配置 均不可见
  • 本地运行:MCP server 在用户本机运行,数据不出机器
  • 用户自装模型:Nemotron-3-Embed-1B 是 HF 公开模型,用户自行下载(非我们资产)

文档

License

Apache-2.0