Bridge into a global Markdown knowledge base shared with the Codex kb.cmd CLI: kb_add/kb_search/kb_show/kb_timeline tools with byte-compatible frontmatter.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:ICCuse/dsh-knowledge
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
中文 | English
Bridge the agent into the user's global knowledge base at D:\knowledge — the same Markdown + YAML frontmatter library the Codex kb.cmd CLI writes. Knowledge accumulated by either tool is visible to both: one library, two agents.
Tools
| Tool | Behavior |
|---|---|
kb_add |
Write one typed note (lesson/pattern/preference/project/reference/concept/moc/decision/note), byte-compatible with the Python CLI: slugified unique filename, typed directory, YAML frontmatter (title/type/tags/aliases/status/created/updated + project/domain). |
kb_search |
Keyword scan over notes (title > tags > content), returns path/title/type + snippet. |
kb_show |
Locate a note by title/path/tag and return its full text. |
kb_timeline |
Append a timestamped line to notes/99_时间线.md — mandatory after every writeback ("失联等于白写"). |
The heavy read side (ask/reflect/map/ingest) stays on the Python CLI; this package owns the deterministic write + quick-read surface so no shell encoding ever touches your Chinese content.
Config
| Field | Default | Meaning |
|---|---|---|
kbRoot |
D:\knowledge |
Knowledge base root. |
maxSearchResults |
8 |
Search result cap. |
Companion discipline: the knowledge-writeback skill (writeback three questions + retrieval protocol + causal-paradigm worldview).
Notes on compatibility
slugifyreplicateskb/ingest.py: NFKC normalize, collapse chars outside[\w\u4e00-\u9fff], 60-char cap,untitledfallback.unique_pathreplicatesstem.md→stem-2.mddedup.- Frontmatter is emitted as quoted-YAML scalars and flow arrays, readable by python-frontmatter. If
kb/frontmatter.pychanges, update this package to match.
Install
Not on npm yet - install from this repository:
npm install github:ICCuse/dsh-knowledge
# or: pnpm add github:ICCuse/dsh-knowledge
Then mount the bundle (declared in package.json 'dsh.bundle') and point it at your knowledge base:
- id: knowledge
name: 'dsh-knowledge'
config:
kbRoot: 'D:\knowledge'
Companion discipline: the 'knowledge-writeback' skill (writeback three questions + retrieval protocol).
Links
More in this category
volcengine/OpenViking#examples/dsh-memory-plugin★ 38815
OpenViking memory and context bundle for DeepSeek Harness: pre-step auto-recall and profile injection, session capture, `viking://` URI guarding, and recall/write memory tools backed by an OpenViking server.
vectorize-io/hindsight#coding-agents★ 37670
Hindsight, agent memory that learns: long-term project memory with auto recall and retain, knowledge pages, deep reflection, and per-repo memory banks.
agentscope-ai/ReMe#dsh★ 3526
Connects DeepSeek Harness to ReMe's local-first, self-evolving personal knowledge base: automatically captures completed main-agent conversations as user-owned Markdown memory, searches conversations and source material through reme_search with BM25, optional embeddings, and wikilink expansion, and schedules daily memory consolidation.
zilliztech/memsearch#MemSearch★ 2670
Shared Markdown memory for DSH and other coding agents, with automatic capture, pre-step context injection, searchable recall, and memory-to-skill self-evolution through a review panel.
vshulcz/deja-vu#extensions/dsh★ 1074
Reads the session files thirty-three other coding agents on this machine already wrote — Claude Code, Codex, Cursor, VS Code Copilot Chat, opencode, OpenClaw, Hermes, Kimi, Cline, Zed and more — including sessions from before it was installed: six tools (deja_recall, deja_session, deja_blame, deja_fix, deja_how, deja_remember), a /deja command, and optional automatic recall added to the runtime context. Local BM25 index, no LLM, no embeddings, no network (dsh plugin --profile web add dsh-deja).
adoresever/graph-memory★ 630
Traceable, searchable cross-session memory for DeepSeek Harness — conversation knowledge as typed graph nodes (TASK/SKILL/EVENT) and typed edges.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.