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
vectorize-io/hindsight#coding-agents★ 60728
Hindsight, agent memory that learns: long-term project memory with auto recall and retain, knowledge pages, deep reflection, and per-repo memory banks.
volcengine/OpenViking#examples/dsh-memory-plugin★ 42125
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.
MemTensor/MemOS#memos-local-plugin★ 12376
Local-first memory plugin for DeepSeek Harness: layered L1/L2/L3 memory with automatic capture, manual memos_* retrieval tools, and a built-in memory viewer.
agentscope-ai/ReMe#dsh★ 3796
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★ 2866
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★ 1529
Reads the session files forty-two 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).
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.