wangyihao0001-oss/dsh-task-memory

插件Plugin ⭐ 6 MIT memory

Task-isolated long-term memory for DeepSeek Harness — remember / recall / search stay inside one task boundary.

编辑导读Editor's Brief

## 核心特性
- 将长期记忆条目存储在 ~/.dsh/storages/task-memory/ 下按任务划分的 vault 中,每个 vault 由一个以任务 ID 命名的纯 JSON 文件表示。
- 通过 memory_bind_task 将会话绑定到指定名称的任务 vault,默认任务则根据会话工作目录推导。
- 提供 memory_remembermemory_recallmemory_searchmemory_forgetmemory_current_taskmemory_list_tasksmemory_clear_task 工具,用于管理任务范围内的记忆事实。
- 当启用 injectPrompt 时,按照配置的条目数量和字符预算,将置顶和最近的事实注入当前 agent 会话的系统提示词。
- 强制执行 vault 容量限制:优先淘汰最旧的非置顶条目,永不淘汰置顶条目;当 vault 已满且没有可移除条目时,拒绝新增 key。

## 使用场景
- 将项目特定事实、技术栈决策或任务上下文与其他 DeepSeek Harness 会话隔离保存。
- 在将会话绑定到指定任务后,支持在同一任务 vault 中召回已存储的 key。
- 将置顶任务事实提供给 agent 系统提示词,使活跃会话无需手动重复即可访问持久上下文。

## 技术细节
- 写入操作使用临时文件和原子重命名,按任务进行的变更会通过进程内锁串行化,以保持 vault 快照的一致性。
- 搜索为词法搜索,使用英文 token 和中文二元分词;空查询会列出最近或置顶条目。
- cordis.patch.yml 中的配置可控制注入限制、字符预算、提示词注入开关、最大条目数以及可选存储根目录。
- 该插件通过 dsh.bundle.patch 以 Git bundle 形式安装到 web 等 DSH profile 中,并要求 Node.js 20 或更高版本。

## 注意事项
- 卸载后 vault 文件仍会保留,用户如需备份或删除,必须手动处理 ~/.dsh/storages/task-memory/
- 关键词搜索不使用 embeddings 或向量搜索,该插件也不会为 DeepSeek Harness 的其他部分提供沙箱。
- 记忆条目中不应包含凭据、token 或个人密钥。

## Core Features
- Stores long-term memory entries in per-task vaults under ~/.dsh/storages/task-memory/, with each vault represented by a plain JSON file named after the task ID.
- Binds a session to a named task vault through memory_bind_task, while the default task is derived from the session working directory.
- Provides memory_remember, memory_recall, memory_search, memory_forget, memory_current_task, memory_list_tasks, and memory_clear_task tools for managing task-scoped facts.
- Injects pinned and recent facts into the current agent session system prompt when injectPrompt is enabled, using configured entry limits and character budgets.
- Enforces a vault capacity limit by evicting oldest non-pinned entries first, never evicting pinned entries, and rejecting new keys when a full vault has no removable entries.

## Use Cases
- Keeps project-specific facts, stack decisions, or task context separated from other DeepSeek Harness sessions.
- Supports recalling stored keys within the same task vault after binding a session to a named task.
- Supplies pinned task facts to the agent system prompt so active sessions can access persistent context without manual repetition.

## Technical Details
- Writes use a temporary file and atomic rename, and per-task mutations are serialized with an in-process lock to maintain consistent vault snapshots.
- Search is lexical, using English tokens and Chinese bigrams, and an empty query lists recent or pinned entries.
- Configuration in cordis.patch.yml controls injection limits, character budgets, prompt injection toggle, maximum entries, and optional storage root.
- The plugin installs as a Git bundle through dsh.bundle.patch into a DSH profile such as web, and requires Node.js 20 or newer.

## Notes
- Vault files remain after uninstall, so users must back up or delete ~/.dsh/storages/task-memory/ manually if needed.
- Keyword search does not use embeddings or vector search, and the plugin does not sandbox other parts of DeepSeek Harness.
- Memory entries should not contain credentials, tokens, or personal secrets.

安装Install

dsh plugin --profile web add "github:wangyihao0001-oss/dsh-task-memory"

wangyihao0001-oss/dsh-task-memory 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

上一个 Prev dsh-compact-activity 下一个 Next dsh-updater-ui