zhujunpeng12/dsh-memory-system1

dsh-memory-system

Local-first persistent memory infrastructure for DeepSeek Harness: bounded hot-memory bootstrap, explainable cold recall (exact + Chinese BM25), lease-lock transactional writes, read-only governance, and trajectory review. Pure Python + Markdown, zero external dependencies.

AI Analysis

核心用途是为 Agent 提供长期、可解释的本地记忆库。适合需要 Agent 记住跨项目经验、历史决策且注重隐私的深度用户。

Package
dsh-memory-system
Version
0.1.0
License
MIT
Last updated
Aug 15, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:zhujunpeng12/dsh-memory-system

2. 配置环境变量

复制 .env.example 并按需设置:

变量默认值说明
MEMORY_VAULT~/Documents/Obsidian Vault记忆库根目录(含 memory/projects/
DSH_HOME~/.dshDSH 家目录(hooks 配置、storages 等)

Windows PowerShell 示例:

$env:MEMORY_VAULT = "C:\Users\you\Documents\Obsidian Vault"
$env:DSH_HOME = "C:\Users\you\.dsh"

使用约定(方法论)

  • 单一真相源:一条事实只有一个家(运行参数 → AGENTS.md;决策历史 → 项目笔记;当日流水 → events;跨项目经验 → rules),其他位置只放指针
  • 写入授权:所有写操作先 dry-run 预览,明确授权后才 --apply;raw 只追加,纠错用 supersedes 而非覆写
  • 治理默认只读govern.py 只收集证据和建议,晋升/归档/删除永远需要人确认