dsh-book

DSH PLUGIN记忆与知识

仓库 Zhi-yin666/dsh-book · npm dsh-book

记忆与知识 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

dsh-book 是给 DeepSeek Harness 用的本地记忆插件,用笔记本、工作本、日记本三本 Markdown 文件分层存放 AI 记忆,零依赖、无数据库,按时间冷热注入或按需检索。

一句话选型结论

按资料字段整理

dsh-book 是记忆与知识类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类记忆与知识 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-30 创建于 2026-10-30
README 5.4 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:Zhi-yin666/dsh-book
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1 等 2 个;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1、0.2.1-rc.5版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/cordis@^4.0.1需要同时安装的同级依赖
npm 包名dsh-book可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-book:DeepSeek Harness 的本地 Markdown 记忆本

  • 三本 Markdown 记忆分层
  • 笔记本每轮全量注入
  • 工作本近三天自动注入
  • 12 个 book_* 工具读写
  • dream 机制降权沉底不删

适用场景

记忆文件读写存储

上游标签

ai-agentdeepseek-harnessdsh-pluginmarkdownmemorynotebook

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-05): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1 等 2 个),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在记忆与知识场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-book当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 等 2 个 有
ruflo L3 · 安装规范通过 低风险 7.4 万 未标注 无
OpenViking L3 · 安装规范通过 低风险 3.9 万 未标注 无
WeKnora L4 · 沙盒安装通过 低风险 3.3 万 未标注 有
distilly L4 · 沙盒安装通过 低风险 2.5 万 未标注 有
EverOS L4 · 沙盒安装通过 低风险 1.3 万 未标注 有

仓库档案

记忆与知识
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方Zhi-yin666仓库 dsh-book · 默认分支 main
分类记忆与知识knowledge
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-30 · 2026-10-30最后推送 2026-10-30
本站收录2026-10-31首次进入本站目录的时间

README 全文

5.4 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-book(小本本)· 0.1.0 测试版

给 DeepSeek Harness(DSH)用的本地记忆插件。三本书 + 一份交接,全部是磁盘上的 Markdown 文件,
没有数据库、没有嵌入模型、没有 Python、没有网络请求。

> ⚠️ 这是自用插件的 0.1.0 测试版,只在一台 Windows + DSH 桌面版上验证过。
> 请当作「可以装、可以看、可以骂」的版本,不要当作稳定软件。


它解决什么

AI 的记忆通常只有两种做法:模型自己记(会话一关就没了),或者塞进一个检索库(要检索、要模型、要依赖)。

dsh-book 走第三条路:把记忆做成文件,按时间冷热分层,需要时再翻。

本子 干什么 怎么进入上下文
笔记本 人格、底线、说话方式 每轮全量注入,默认 600 字上限
工作本 今天做了什么 最近 3 天自动注入,过期不注入但永不删除,可搜索
日记本 真正记住的事,五支:相处 / 心意 / 教训 / 做成 / 悬着 不自动注入,用工具翻
§〇 交接 换会话接着干的接力棒(我是谁 / 干到哪 / 下一步 / 卡在哪) 注入压缩后的 220 字

外加 dream:30 天没人翻的日记降一级权重,掉到 1 以下搬进 沉底/——只搬不删,「教训」那支永远不衰减。


安装

方式 A:装本地 tgz(推荐)

dsh plugin --profile <你的 profile 名> add file:<解压目录>\dsh-book-0.1.0.tgz

<你的 profile 名> 一般是 desktop 或 web,看 ~/.dsh/profiles/ 下有什么。
装完重启 DSH。新会话里应该能看到 12 个 book_* 工具,左侧栏多一个「笔记本」入口。

方式 B:从源码目录装

dsh plugin --profile  add file:<解压目录>\dsh-book

方式 C:手动(不推荐,容易出错)

解压到 ~/.dsh/profiles//node_modules/dsh-book,然后在 profile 的 package.json 里:

  1. dependencies 加 "dsh-book": "link:<绝对路径>"
  2. dsh.profile.bundles 末尾加 "dsh-book"

手动改 JSON 请用 Node/Python,不要用 PowerShell 的 Set-Content -Encoding utf8
(Windows PowerShell 5.1 会写 BOM,DSH 读到 BOM 会起不来)。


装完怎么用

不用特意配置,直接跟 AI 说:

  • 「记一下今天修了啥」→ 写工作本
  • 「这事我想记住」→ 写日记(选五支之一)
  • 「我要换会话了,写个交接」→ 写交接
  • 「翻翻以前关于 XX 的记录」→ 搜索

默认数据目录:

~/.dsh/book/
├── card/card.md          # 笔记本(可以手动编辑,格式是 Markdown 的两节:我选的 / 你要的)
├── work/YYYY-MM-DD.md    # 工作本,一天一个文件
├── diary/<分支>/*.md     # 日记本,按五支分目录
├── diary/主干.md          # 长期主线(1500 字上限)
├── diary/交接.md          # §〇 交接(4096 字节上限)
└── config.json           # 可选:改注入字数等

config.json 可选项(不写就用默认):

{
"cardLimit": 600,
"workDays": 3,
"workInjectLimit": 800
}

0.1.0 的已知限制(请先读)

  1. 没有语义检索,只能按关键词子串搜。记得意思、不记得原词的时候搜不到。
  2. 没有项目隔离:多个工作区的记录混在一起。
  3. 会话压缩后不会自动补记忆:模型上轮翻过的日记内容可能丢(笔记本/交接每轮重算,不会丢)。
  4. 左侧栏入口依赖 @deepseek-ai/dsh-client-ui-sidebar:如果你的 DSH 版本没有这个包,
    页面入口不会出现,但插件本体和工具仍然能用(会打一条 warn 日志)。
  5. 界面与文案全中文,没有 i18n。
  6. 只在 Windows 桌面版验证过,headless / 其他系统未测。
  7. 没有权限控制:任何会话都能读写 ~/.dsh/book/。

安装时如果 pnpm 提示 @deepseek-ai/cordis peer 未满足,通常是宿主已自带,可忽略;
如果启动报错,请把 ~/.dsh/logs 里对应时段的日志贴回来。


想要什么反馈

报 bug 的时候,这几样最有帮助:

  1. 你的 DSH 版本(关于页 / dsh --version)
  2. 安装方式(A/B/C 哪个)
  3. 报错全文,不要截半句
  4. ~/.dsh/book/ 的目录树(tree 或 Get-ChildItem -Recurse 输出)
  5. 触发问题的那句话(原话)

想提需求也行,但先说清楚是「记不住」还是「记乱了」——这两种要动的地方完全不同。


卸载

从 profile 的 bundles 里移除 dsh-book(或 dsh plugin remove dsh-book),重启 DSH。
~/.dsh/book/ 是你自己的数据,删不删自己决定——建议留着备份。


文件清单

dsh-book/
├── package.json
├── cordis.patch.yml      # bundle patch
├── client.js             # 左侧栏「笔记本」面板
├── lib/
│   ├── index.js          # 插件入口:12 个工具 + 3 段注入 + 编辑页
│   ├── store.mjs         # 三本书的读写、dream
│   └── hostdeps.mjs      # 宿主包解析兜底
├── tests/
│   ├── check-tools.mjs   # 工具 schema 体检(只读工具实跑)
│   └── smoke*.mjs        # 三本书的冒烟测试,不依赖 DSH
├── LICENSE
├── .gitignore
└── README.md

MIT License.

常见问题

9 问
答案由本站依据条目字段整理,不引用上游原文
dsh-book 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:Zhi-yin666/dsh-book` 即可。对应的 npm 包名是 `dsh-book`。

dsh-book 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-book 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-book 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-book 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1、0.2.1-rc.5。

dsh-book 需要什么运行环境?

需要同时安装 @deepseek-ai/cordis@^4.0.1。环境不满足时安装会失败,建议先确认本机版本。

dsh-book 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-book 有哪些功能?

三本 Markdown 记忆分层、笔记本每轮全量注入、工作本近三天自动注入、12 个 book_* 工具读写、dream 机制降权沉底不删。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

1 条
不同作者的仓库分开列,请确认你要装的是哪一个
记忆与知识
按星标排序,可作替代方案

ruflo

ruflo

L3 · 安装规范通过 7.4 万 星

OpenViking

OpenViking

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`vik

L3 · 安装规范通过 3.9 万 星

WeKnora

WeKnora

把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己

L4 · 沙盒安装通过 3.3 万 星

distilly

distilly

Distilly — Distill how they think into reusable Skills for any Agent o

L4 · 沙盒安装通过 2.5 万 星

EverOS

EverOS

L4 · 沙盒安装通过 1.3 万 星

MemOS

MemOS

L4 · 沙盒安装通过 1.2 万 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-05。