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 已验证 MIT TypeScript 未知

★ 1 在 GitHub 查看

版本未知

语言TypeScript

许可证MIT

在 GitHub 查看

预览

功能介绍

全局知识库桥：kb_add/kb_search/kb_show/kb_timeline 读写与 Codex 共享的 D:\knowledge（格式逐字节兼容）。

适合

需要让 DSH 与 Codex kb.cmd CLI 共享全局 Markdown 知识库的用户。
需要确定性创建、搜索、展示分类笔记并记录时间线的工作流。
需要绕开 shell 编码转换、直接处理中文内容的工作流。

不适合

没有兼容 Markdown 知识库工作流，或尚未配置 kbRoot 的用户。
要求插件内部执行 ask、reflect、map 或 ingest 等重型读取操作的工作流；这些能力仍由配套 Python CLI 提供。
当前必须使用已发布 npm 包的用户；文档中的安装方式是直接从代码仓库安装。

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).

安装

dsh plugin --profile default add github:ICCuse/dsh-knowledge

卸载：dsh plugin --profile default remove github:ICCuse/dsh-knowledge

常见问题常见问题

在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:ICCuse/dsh-knowledge。命令会解析公开 package 元数据，并保持插件与本页展示的目录身份一致。

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

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件：pre-step 自动召回与画像注入、会话捕获、`viking://` URI 防护，以及对接 OpenViking 服务端的 recall/write 记忆工具。

AGPL-3.0

vectorize-io/hindsight · coding-agents★ 20,126

Hindsight：会学习的 Agent 长期记忆系统，自动召回/保存、知识页、深度反思与按仓库隔离的记忆银行。

MIT

Ikalus1988/MisakaNet★ 404

失败恢复记忆库：从真实工程会话中搜索和记录失败恢复教训，支持 BM25 + 语义 RAG 检索和知识库管理。

Apache-2.0

text2future/flowix · dsh-flowix-memory★ 316

将本地 flowix-cli 注册为 MCP 服务，让 agent 可以搜索、读取、创建和编辑 Flowix 备忘与思维导图产物。

MIT