aoyamabf-max/dsh-obsidian-memory ↗★ 0
dsh-obsidian-memory
Store DSH agent memory as Markdown notes in an Obsidian vault: sidebar panel, 7 agent tools, BM25 recall with token budgets, decay and archiving, and GitHub Contents API sync.
安裝
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:aoyamabf-max/dsh-obsidian-memory說明文件
閱讀完整 README ↗Configuration
All settings live in the plugin's Config schema, so they show up in DSH's own settings UI. Every field has a default; an empty config is valid.
| Field | Default | Meaning |
|---|---|---|
vaultPath | "" | Absolute path to the vault. Empty = auto-discover from Obsidian. |
folder | "Memories" | Subfolder for memory notes, relative to the vault root. |
maxNoteBytes | 262144 | Notes longer than this are truncated (hard cap; raising it has no effect). |
repo | "" | owner/name to sync to. Empty = no sync. |
branch | "main" | Branch to push to. |
tokenFile | "" | File holding a GitHub token. Empty = ~/.dsh/dsh-obsidian-memory/token. |
denyFile | "" | Secret blacklist, one literal per line. Empty = ~/.dsh/dsh-obsidian-memory/deny.txt. |
syncEnabled | true | Whether the timer runs. |
syncMinutes | 30 | Sync interval in minutes (minimum 5). |
forgettingEnabled | false | Allow decay/archive to actually write. Preview works either way. |
decayFactor | 0.9 | Multiplier applied per decay pass. |
pruneThreshold | 0.15 | Below this importance, a note becomes eligible for archiving. |
Setting up GitHub sync (optional)
- Create a private repository. Memory can contain hostnames, paths and internal decisions.
- Create a fine-grained token with Contents: read and write on that repo only.
- Save it:
mkdir -p ~/.dsh/dsh-obsidian-memory && printf '%s' '' > ~/.dsh/dsh-obsidian-memory/token - Set
repotoowner/namein the plugin config.
The token is never written into the plugin config or the repository. Sync state (a path → sha256 map) lives in ~/.dsh/dsh-obsidian-memory/sync-state.json, so only changed notes are pushed.
Keeping secrets out
The plugin refuses to push a note containing a secret, and counts it under blocked rather than failed — the two mean different things. Two layers:
- Built-in patterns (ship with the code):
github_pat_,gh[pousr]_,AKIA,sk-,BEGIN … PRIVATE KEY,密码[:=是]…. - Your own blacklist at
~/.dsh/dsh-obsidian-memory/deny.txt— one literal string per line,#for comments. Put your own server addresses, passwords and key names here. This file stays on your machine and is never read into the source tree.