dsh-reverie

Reverie 是 DeepSeek Harness 里的一次独立、只读、开放式的联想实验：给它一个语料源——笔记目录、JSON/JSONL 导出、或者你自己的会话历史——让模型自己选主题、检索、展开原文、任联想走下去，最后只留下两样东西：一份报告和一张有界的私人纸条。

它不是待办系统，也不是画像生成器。允许走神、允许死路、允许「这一趟没有发现」。

reverie_status    源、语料规模、模型线路一眼看完
reverie_sources   列出声明的源与分组
reverie_search    词法检索，返回 <源>/<内部定位> 证据 locator
reverie_read      按 locator 展开原文
reverie_run       跑一趟（默认 mock，不调用模型）
reverie_report    回看报告 / 纸条 / 轨迹
reverie_config    查看或修改运行设置与 `sources`

为什么是插件

Reverie 的原始实现长在一个私人陪伴系统里：语料是那个系统的记忆层，用户只有一个。做成 DSH 插件之后机制保留，但语料变成可配置的：

folder：一个 markdown/txt 目录（Obsidian 库、日记目录、导出的笔记）；
json：JSON / JSONL 导出（稍后读队列、书签、逐日记录）；
dsh-sessions：Harness 自己的会话历史（只读已关闭的会话）。

每趟运行只读、不写回任何存储，产物落在 ~/.dsh/reverie/runs/。mock 模式完全不需要 API key：先装、先看产物，再决定要不要花 token。

安装

DSH Desktop：设置 → 插件里安装 @kleinkross/dsh-reverie。

CLI：

dsh plugin --profile web add @kleinkross/dsh-reverie

本地开发（不发布也能装）：

dsh plugin --profile web add /path/to/dsh-reverie

快速开始

reverie_status —— 看哪些源挂上了、各自贡献多少文档。
用 reverie_config 配一个源（或直接编辑 ~/.dsh/reverie/config.json）：

"sources": [
  { "id": "notes",   "kind": "folder", "root": "D:/notes", "extensions": ["md", "txt"] },
  { "id": "journal", "kind": "json",   "path": "D:/data/journal.jsonl" }
]

不配置 sources 时，语料默认是本工作区的会话历史。

reverie_run —— 跑一趟 mock。不调用模型，只验证语料、检索、产物写入与报告形状。
reverie_report —— 读报告与 handoff.md。
想真跑：reverie_config 设 mode: "live"（或在调用时传 live: true），再跑一次。会产生 API 费用。

面板

装好之后，Web 端会多出一个 Reverie 区块，提供两个可切换的主题：

采样（默认）：整库按天排成一条暗色密度条，这一趟真正读过的文档点亮为琥珀色；配 点亮 N / 全库（x%） 统计、步骤轨迹与私人纸条卡片。它说的是一句诚实的话——绝大部分语料一直是黑的。
路书：旅程选择、统计与四个标签页（报告 / 纸条 / 轨迹 / 证据 locator）。

两个主题都只是查看器：背后的路由只做「列出/读取已记录运行」，刷新页面永远不可能触发一趟运行或花掉预算。配色与信息架构沿用原版 Reverie「夜路手记」；地图那层（蜿蜒夜路上的路标）仍是下一步。

适合谁

给那些档案太大、自己翻不动的人：Obsidian / Logseq 库、日记目录、读后摘录导出、逐日记录的 JSONL。如果你曾经打开自己的笔记想「这里面肯定有点什么，但我搜不出来」，这就是目标用户。

不适合想被总结、被做仪表盘、被自动抽待办的人。Reverie 不对你的档案下任何结论；它只是走一趟，留下一点可核查的痕迹。

不想先暴露自己的库？

examples/tiny-memory-library/ 是专为本仓库写的虚构语料；docs/sample-report.md 是对它跑出的 mock 报告（不调用模型、不花 API 钱），可以直接看输出形状再决定要不要试。怎么跑、怎么换成自己的目录见 examples/README.md。

语料源

kind	读什么	locator 形状
`folder`	`root` 下的 markdown/txt，按标题切 section，超长段按段落切块	`notes/dir/note.md#L12-L40`
`json`	`.json`（数组，或每个数组键一组）或 `.jsonl`；文本/标题/时间字段可配	`journal/entries#3`
`dsh-sessions`	本工作区（或 `scope: "all"` 的全部）已持久化、非活跃会话	`dsh/session-id#96`

单个源失败只贡献一条问题记录，其余源照常加载。

数据与隐私

只读：从不写入、追加或改写任何会话、笔记、memory 或导出文件。
只收「人说过的话」（会话源）：宿主注入的上下文（AGENTS.md、运行时快照、技能目录）按 source.kind 排除；推理与工具流量不进语料。
只读已关闭的会话：当前活跃会话被排除，正在进行的对话不会成为实验材料。
不联网，除了模型本身：没有遥测、没有上传、没有第三方请求；mock 完全离线。
产物：$DSH_HOME/reverie/runs/<日期>/<run-id>/{run.json,report.md,handoff.md,events.jsonl,usage.json} 与 latest.json；配置在 $DSH_HOME/reverie/config.json。
报告与纸条是模型生成材料（live），不是权威记忆。相信结论之前，按 <源>/<内部定位> 展开原文。

运行设置

{
  "sources": [],            // 语料；空 = 本工作区会话历史
  "scope": "workspace",     // 默认会话源的范围：workspace | all
  "includeSubagents": false,
  "maxSessions": 24,
  "lookbackDays": 0,
  "maxDocuments": 4000,
  "minDocumentChars": 24,
  "cacheTtlMs": 600000,
  "provider": "",           // 空 = 第一个已注册 provider
  "model": "",              // 空 = 该 provider 的第一个模型
  "reasoningEffort": "",
  "mode": "mock",           // mock 不花钱；live 产生费用
  "maxSteps": 8,
  "maxInputTokens": 60000,
  "maxOutputTokens": 2048,
  "timeoutMs": 600000,
  "maxNoteChars": 2000,
  "persona": "",
  "language": "zh"
}

folder 专属：extensions、exclude、maxFileBytes、maxDocChars。 json 专属：textFields（默认 text/content/note/body…）、titleField、timeField。

兼容性

项目	要求
DSH	`>= 0.1.5-rc.1`；已在 0.2.0-rc.2 桌面版开发与测试
Node	`^22.19.0 \|\| >=24.0.0`
宿主服务	`tools`、`systemPrompt` 必需；`llm`（live 运行）与 `sessionQuery`（会话源）可选——只配 folder 时两者都不需要
依赖包	peer：`@deepseek-ai/dsh-tools`、`@deepseek-ai/dsh-llm`

实现概览

sources/{folder,json,dsh}.js ──► corpus.js ──► search.js ──► loop.js ──► artifacts.js
 （归一化文档）                  （locator/上限）  （BM25+CJK）  （工具循环）   （runs/ 产物）
                                                      │
                                                mock.js（确定性，不调模型）

lib/sources/* 适配器只负责把某个存储变成扁平文档；加一种存储 = 一个 create*Source 函数 + SOURCE_KINDS 里加一项。排序、循环、产物写入完全不知道文本来自哪里。
lib/corpus.js 挂载源、给 locator 加源前缀、应用上限并缓存快照。
lib/search.js 与宿主无关：拉丁词 + CJK 二元切词、BM25、字面短语加权。
lib/loop.js 是 Reverie 自己的模型循环：流式步进、block 组装、内部工具（reverie_search/reverie_read/reverie_note）、预算停止原因。
lib/artifacts.js / lib/runs.js 只按白名单 id 与固定文件名写读产物。

设计取舍：

做语料源，不做会话抓取器：Reverie 的机制面向扁平、异构的个人数据，会话历史只是其中一个 adapter。
会话源仍走 ctx.sessionQuery：不携带存储格式知识，读取是重放校验过的。
不复用宿主 agent loop：实验身份要求它拥有自己的消息与预算，不占用日常会话。
mock 是一等公民：没有 API key 也能验证整条链路。

开发与测试

npm install
npm test              # 进程内运行（受限沙箱可用）
npm run test:isolated # 每个文件一个子进程（需要可 spawn）

Roadmap

夜路地图：把原版的蜿蜒路线布局接到本插件的轨迹事件上。
SQL 源（node:sqlite，只读、单条 SELECT/WITH）。
独立 CLI，复用 host-free 核心，让其他 harness 也能跑同样的旅程。
可选的评估闭环：给纸条标「值得跟 / 没用」，让机制积累证据而不是轶事。

MIT License。

dsh-reverie

Install

Source

Tags

Creators

Readme

dsh-reverie

为什么是插件

安装

快速开始

面板

适合谁

不想先暴露自己的库？

语料源

数据与隐私

运行设置

兼容性

实现概览

开发与测试

Roadmap