返回目录
Agent 与会话 插件

dsh-timem-memory

auuduu/dsh-timem-memory

TiMEM 长期记忆的 DeepSeek Harness 插件:MCP 桥(凭证走 ctx.credentials)+ 内置 5 个记忆 skill

Stars
0
Forks
0
Issues
0
更新
1 天前

PROJECT TOPICS

项目标签

INSTALL REFERENCE

安装参考

未验证
dsh plugin --profile web add github:auuduu/dsh-timem-memory

该命令指向仓库当前默认分支;尚无绑定当前 commit 的完整验证结果。

PROJECT README

README

dsh-timem-memory

TiMEM 长期记忆的 DeepSeek Harness(DSH)插件。 一条 cordis 条目装好两件事:

  1. MCP 桥 —— 通过 @deepseek-ai/dsh-mcp-client 连接 TiMEM 云端 MCP (https://api.timem.cloud/mcp),把 17 个工具以 mcp__timem__* 命名注册给模型 (记忆 4 个、规则 8 个、知识库 4 个、ready 1 个);
  2. 记忆 skill —— 把 5 个内置 skill 注册进 DSH skill 体系(runtime 层,rank 250), 让模型自动执行「每回合先搜记忆 → 干活 → 写记忆」的工作流,无需用户理解 S0–S6 分级。

凭证通过 ctx.credentials 解析(TiMEM_API_KEY / TiMEM_USER_ID),不在任何配置 文件里硬编码密钥;凭证变更会触发事件自动重挂 MCP 桥,无需重启。

安装

前置:DSH 已安装,pnpm 在 PATH 上(dsh plugin 依赖它)。

# 1. 把插件装进目标 profile(任意名字,web / headless / 自定义皆可)
#    GitHub 渠道(当前即可用):
dsh plugin --profile web add git+https://github.com/auuduu/dsh-timem-memory.git
#    npm 官方商店渠道(发布后):
# dsh plugin --profile web add dsh-timem-memory

# 2. 在 <DSH_HOME>/profiles/web/cordis.patch.yml 中插入一条目(保存即热生效)
- insert:
    - id: timem-memory
      name: 'dsh-timem-memory'

小白版原理讲解(包是什么、安装装到哪、DSH 怎么“叫醒”它): docs/principles.zh.md

配置凭证

凭证存在凭证存储(~/.dsh/.credentials.yaml,权限 0600,可在 DSH 网页端凭证页管理), 或环境变量 / ~/.dsh/.env(启动时加载)。以 .credentials.yaml 为例:

DEEPSEEK_API_KEY: sk-…
TiMEM_API_KEY: sk-…          # https://console.timem.cloud/settings/api-key
TiMEM_USER_ID: usr_…         # TiMEM 控制台个人资料页

写入后插件会自动重挂 MCP 桥(无需重启 DSH)。若 TiMEM 凭证缺失,插件只跳过桥接并 记录错误日志,skill 仍会注册。

配置项

字段 默认值 说明
serverName timem MCP 命名空间,模型看到的工具名 mcp__<serverName>__<tool>
url https://api.timem.cloud/mcp TiMEM 云端 MCP 端点
apiKeyRef TiMEM_API_KEY ctx.credentials 中的 API Key 引用名
userIdRef TiMEM_USER_ID ctx.credentials 中的 User ID 引用名
enableSkills true 是否注册内置 skill
skillNames 5 个内置 skill 要注册的 skill 列表
toolCallTimeoutMs 60000 透传给 MCP 客户端
failOnStartupError false 透传给 MCP 客户端
reconnect.* 客户端默认 透传给 MCP 客户端

验证

重启/热生效后,在对话里问模型「TiMEM 接好了吗」——它会调用 mcp__timem__ready 并确认 17 个工具可见;或到 设置 → 插件 页面查看 timem-memory 条目状态。

工作原理

  • lib/index.js:cordis 插件本体(inject: ['credentials', 'skills'])。 激活时:① 解析凭证 → 用 ctx.plugin(mcpClient, …) 挂载 MCP 桥; ② 读取包内 skills/*/SKILL.mdctx.skills.register() 注册(随上下文自动销毁)。
  • skills/:5 个 skill 包(TiMEM 官方 skill 的 DSH 适配版,工具名按 mcp__timem__* 重写,自带可用性检查与 S3/S0/S6 分级)。
  • 凭证热更新:监听 credentials/updated,匹配 apiKeyRef / userIdRef 时 释放旧桥并按新凭证重挂。

License

MIT

CLASSIFICATION EVIDENCE

分类依据

项目类型插件
功能分类Agent 与会话
规则置信度

系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。当前命中: agent-memory、mcp、memory。