dsh 插件:跨会话事实记事本,支持关键词召回(/fact save|find|list|rm 加 fact_find 工具)
30.7/100
综合分
1
GitHub 星标
—
npm 周下载
—/5
用户评分
数据截至 2026/10/18 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。
自动兼容检查有告警:未发布到 npm registry,仅可从源码安装。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add 121212165/dsh-plugin-fact-vault该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)
状态速览
判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态信任档位:需留意
是什么
dsh 原生插件 · chat
装得上吗
实装验证未通过(unknown),装前请到仓库确认最近更新与 issue
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
活跃:最近一次提交在 17 天前
档位由哪些信号合成
本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。
⚠︎ 实装验证未通过(unknown · 2026/9/30) ——可能是验证环境差异,装前建议到 GitHub 仓库确认最近更新与 issue。
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查⚠ 装前注意未发布到 npm registry,仅可从源码安装
展开查看检查明细 ↓
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-plugin-fact-vault(未发布到 npm,仅可源码安装)
✓Node 引擎要求 >=22.18 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/8 09:41:02
安全扫描自动 · 静态分析源码v2.7.0🔵 扫描:含敏感能力尚无人工评估展开查看扫描说明与证据 ↓
安全扫描自动 · 静态分析源码
v2.7.0静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。
读写/删除本地文件
查看扫描证据(共 22 处,展示前 22 条)
- 读取本地文件lib/plugin.js:34
if (Date.now() - statSync(lockPath).mtimeMs > LOCK_STALE_MS) - 删除本地文件lib/plugin.js:35
unlinkSync(lockPath); - 删除本地文件lib/plugin.js:46
unlinkSync(lockPath); - 读取本地文件lib/plugin.js:60
if (!existsSync(this.path)) - 读取本地文件lib/plugin.js:62
return parseLibrary(readFileSync(this.path, 'utf8')).items; - 写入本地文件lib/plugin.js:66
mkdirSync(dir, { recursive: true }); - 写入本地文件lib/plugin.js:69
writeFileSync(tmp, items.map((item) => JSON.stringify(item)).join('\n') + '\n', 'utf8'); - 写入本地文件lib/plugin.js:70
renameSync(tmp, this.path); - 写入本地文件lib/plugin.js:75
mkdirSync(dirname(this.path), { recursive: true }); - 写入本地文件lib/plugin.js:76
appendFileSync(this.path, JSON.stringify(item) + '\n', 'utf8'); - 写入本地文件lib/plugin.js:81
mkdirSync(dirname(this.path), { recursive: true }); - 读取本地文件src/plugin.ts:50
if (Date.now() - statSync(lockPath).mtimeMs > LOCK_STALE_MS) unlinkSync(lockPath); - 删除本地文件src/plugin.ts:50
if (Date.now() - statSync(lockPath).mtimeMs > LOCK_STALE_MS) unlinkSync(lockPath); - 删除本地文件src/plugin.ts:61
unlinkSync(lockPath); - 读取本地文件src/plugin.ts:77
if (!existsSync(this.path)) return []; - 读取本地文件src/plugin.ts:78
return parseLibrary(readFileSync(this.path, 'utf8')).items; - 写入本地文件src/plugin.ts:83
mkdirSync(dir, { recursive: true }); - 写入本地文件src/plugin.ts:86
writeFileSync(tmp, items.map((item) => JSON.stringify(item)).join('\n') + '\n', 'utf8'); - 写入本地文件src/plugin.ts:87
renameSync(tmp, this.path); - 写入本地文件src/plugin.ts:93
mkdirSync(dirname(this.path), { recursive: true }); - 写入本地文件src/plugin.ts:94
appendFileSync(this.path, JSON.stringify(item) + '\n', 'utf8'); - 写入本地文件src/plugin.ts:100
mkdirSync(dirname(this.path), { recursive: true });
扫描于 2026/11/3(0 天前) · 范围 入口闭包 + 发布文件清单 · 来源 GitHub 仓库
静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-base@deepseek-ai/schemastery@deepseek-ai/dsh-tools给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个
功能亮点
- 跨会话记录结论
- 关键词召回
- 增删查管理
README
由 DeepSeek 最新模型翻译生成dsh-plugin-fact-vault
🧩 dsh 插件家族(22 件):总目录 dsh-plugin-family | 明星插件:ide-hub 跨 IDE 统一管理 · task-forge 跨窗口无损交接 · quota 实时用量仪表
EN · Cross-session fact notepad: /fact save records a decision with tags, /fact find ranks recall by keyword, and the model can call fact_find itself — so what one window learned, the next can retrieve. · 5 node --test green · live headless sessions proved the model calling fact_find and the full save→find→list→rm cycle on a temp store.
DeepSeek Harness (dsh) 插件:跨会话事实便签库。一句话一条,打标签,之后的任何会话都能按关键词召回——人用 /fact,模型自己用 fact_find 工具。
适合回答:"上周我在这个 harness 里定过的口径是什么?
展开完整文档(README 剩余 1 节)
dsh-plugin-fact-vault
🧩 dsh 插件家族(22 件):总目录 dsh-plugin-family | 明星插件:ide-hub 跨 IDE 统一管理 · task-forge 跨窗口无损交接 · quota 实时用量仪表
EN · Cross-session fact notepad: /fact save records a decision with tags, /fact find ranks recall by keyword, and the model can call fact_find itself — so what one window learned, the next can retrieve. · 5 node --test green · live headless sessions proved the model calling fact_find and the full save→find→list→rm cycle on a temp store.
DeepSeek Harness (dsh) 插件:跨会话事实便签库。一句话一条,打标签,之后的任何会话都能按关键词召回——人用 /fact,模型自己用 fact_find 工具。
适合回答:"上周我在这个 harness 里定过的口径是什么?"——transcript 记录"发生过什么",fact-vault 存"结论是什么"。
同系列:transcript · transcript-search(全文检索原始转录)· pinboard(无条件注入系统提示)。区别:本库是按需召回,不占系统提示预算。
用法
- /fact save <文本[#标签]>:记一条。# 后的部分按 # 分割成多个标签,一条可带多标签。
- /fact find <关键词>:空格分词,标签命中记 3 分、正文命中记 1 分,同分按时间倒序(新先出)。
- /fact list:最近 20 条。
- /fact rm <id>:删除。
- fact_find 工具:同 find,供模型在回答"之前说过/定过什么"时自己调用。
存储为单个 JSONL(默认 ~/.dsh/fact-vault/facts.jsonl),每行 {v:1,id,text,tags,at}。
与其它插件的边界
- 写库是本插件自己的事:读时容错(坏行跳过并计数),永不改写源文件中损坏的行。
- id 是自增数字字符串(max(已存 id)+1),不是哈希,便于 /fact rm 3 这种手敲。
配置
| 字段 | 默认 | 说明 |
| enabled | true | |
| libraryPath | ~/.dsh/fact-vault/facts.jsonl | 库文件路径 |
| limit | 10 | find / fact_find 最多返回几条 |
安装
三步,实测于 @deepseek-ai/dsh@0.1.7-alpha.1(需 pnpm 在 PATH 上):
① 装进 profile:dsh plugin 把参数原样转发给 pnpm,git 包会自动跑 prepare 构建 lib/
dsh plugin --profile web add github:121212165/dsh-plugin-fact-vault
② 把本仓库根目录 cordis.patch.yml 的内容并进 $DSH_HOME/profiles/web/cordis.patch.yml。
该文件默认是 [],所以要么整份替换,要么把 insert 条目并进同一个数组;不要直接追加——追加会形成两个 YAML 文档,启动即报 failed to parse overlay ... end of the stream or a document separator is expected(本机实测踩过)。
③ 重启 dsh。配置层与 client 半都要重启才生效(客户端按 boot 时算出的内容 rev 下发,硬刷新浏览器没用)。
自检挂载:dsh --profile web --dump-config | grep dsh-plugin-fact-vault,应看到该条目。
验证状态
- 纯函数(解析容错、打分排序、id 自增、渲染)5 个 node --test 全绿。
- 本机 live 验证:headless 会话中模型真实调用 fact_find;save→find→list→rm 生命周期在临时库上跑通,非法动词返回 error 而不抛异常。
- 未验证:/fact 在 web UI 里的手动输入体验(headless 无输入通道)。预览分享卡片长什么样 ↓
分享 · DeepSeek Harness Hub
121212165/dsh-plugin-fact-vault
dsh 插件:跨会话事实记事本,支持关键词召回(/fact save|find|list|rm 加 fact_find 工具)
相关插件 · 对话 / 记忆
上下文中枢oceanbase/powercontext
上下文跟着工作走 —— 跨会话、跨智能体、跨人。
★ 1,487已汉化DSH
73
智能体记忆库plastic-labs/honcho
Honcho 是记忆基础设施,用来构建有状态的智能体。这些智能体能理解不断变化的人、智能体、群组、项目和想法。
★ 7,894已汉化DSH
71.7
长程智能体控制面loopx-project/loopx
给 Agent 一个目标,让工作持续向前。
★ 6,358已汉化DSH
71.3
智能体上下文数据库volcengine/OpenViking
给 AI 智能体用的上下文数据库
★ 41,379已汉化DSH
71.3
长效机器人团队Fei2411/DS-Bot
DS Bot 是一个基于 DeepSeek Harness简称 dsh的 bot 插件,插件将 dsh 改造为 bot…
★ 5,084已汉化DSH
71.1
可携带记忆层EverMind-AI/EverOS
为什么选择 EverOS
★ 13,778已汉化DSH
71.1
这是你的仓库?认领条目