ICCuse/dsh-knowledge

Bridge the agent into the user global Markdown knowledge base (D:\knowledge, shared with the Codex kb.cmd CLI): kb_add/kb_search/kb_show/kb_timeline tools with byte-compatible frontmatter

Bundle verified MIT TypeScript Unknown
Bundle verified

Listed

1

Memory

Bundle verified

★ 1 View on GitHub
VersionUnknown
LanguageTypeScript
LicenseMIT
View on GitHub

Preview

Preview 1 of 2: ICCuse/dsh-knowledge
Preview 2 of 2: ICCuse/dsh-knowledge

What it does

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.

Best for

  • Users maintaining a global Markdown knowledge base shared between DSH and the Codex kb.cmd CLI.
  • Workflows needing deterministic creation, search, display, and timeline logging of typed notes.
  • Chinese-content workflows that need direct file operations without shell encoding transformations.

Not ideal for

  • Users without an existing compatible Markdown knowledge-base workflow or a configured kbRoot.
  • Workflows requiring heavy ask, reflect, map, or ingest operations inside the plugin; those remain in the companion Python CLI.
  • Users requiring a published npm package today; the documented installation is directly from the repository.

README

@deepseek-ai/dsh-knowledge

中文 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

  • slugify replicates kb/ingest.py: NFKC normalize, collapse chars outside [\w\u4e00-\u9fff], 60-char cap, untitled fallback.
  • unique_path replicates stem.md → stem-2.md dedup.
  • Frontmatter is emitted as quoted-YAML scalars and flow arrays, readable by python-frontmatter. If kb/frontmatter.py changes, 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).

Frequently Asked QuestionsFAQ

Use the verified command dsh plugin --profile default add github:ICCuse/dsh-knowledge in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.

volcengine/OpenViking#examples/dsh-memory-plugin★ 28,960

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.

AGPL-3.0
vectorize-io/hindsight#coding-agents★ 20,126

Hindsight, agent memory that learns: long-term project memory with auto recall and retain, knowledge pages, deep reflection, and per-repo memory banks.

MIT
Ikalus1988/MisakaNet★ 404

Failure-recovery memory: search and record failure-recovery lessons from real engineering sessions, with BM25 + semantic RAG retrieval and a lessons knowledge base.

Apache-2.0
text2future/flowix#dsh-flowix-memory★ 316

Registers the local flowix-cli MCP server so the agent can search, read, create, and edit Flowix memos and mind-map artifacts.

MIT