dsh-continuity
Verified@theseus-whale/dsh-continuity · v4.12.9 · MIT · Web UI
Band-controlled compaction with session-scoped pointer indexes, persona-scoped A/B/C/K memory, verifiable pass receipts, and read-only retrieval for DeepSeek Harness
Install
dsh plugin add @theseus-whale/dsh-continuity Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Creators
Readme
dsh-continuity 4.12.8
4.12.8 T/TAG 与 turnGate 清理
彻底删除 T/TAG header、打标提醒、tag-debt 写入、turn-stopping 注册与 turnGate 配置。autoTagCompletedTurn 也删除,不再自动写 turn-tags;旧 turn-tags 仅只读兼容。说明书不再提 T/TAG。
rules/habits carrier 在重启后扫描 surface 中的全文消息;发现多份时保留最早一份,其余原位清空,避免重启一次多一份。
4.12.6 rules/habits 全文保持一份最新
4.12.5 已发布,不能覆盖;4.12.6 承载 rules 全文修复。
4.12.5 A 锚的 onboarding
onboarding 与 base-rules 明确:A 表不自动生成,也不自动增长;每轮系统会做 B 标注,但 A 空时 B 只会是 weak。实例识别出新话题时,需要手动往 concepts.md 追加一行。
没有新增一次性提醒机制;A 的行为由 rules 承担。
rules/habits 全文:pointersOnly: false。carrier 仍在 surface 时内容变化用 surfaceOp: replace 原位换掉;carrier 被 fold 走才 append;hash 不变不注入。
Band (config-only) 已从生产菜单移除;不再提供
bandpreset,只保留内部 baseline 代码。
4.12.4 Continuity 默认 PTC
continuity 保留原 id,composition 改为原生 @deepseek-ai/dsh-tool-executor-ptc。
continuity-ptc 只保留为临时别名,等已有会话切回 continuity 后删除。
continuity -> PTC(新会话默认)
continuity-ptc -> 过渡别名,内容相同
已验证:run_code 可调用 ptc_handoff、session_log、child_asset;asset 复制与取回正常。
4.12.3 修复 DSH 0.2.2 preset broken
DSH 0.2.2 不再提供 @deepseek-ai/dsh-tool-subagent-control/list-agents 子路径。4.12.3 从 preset-band 和 preset-continuity 移除 tool-subagent-list-agents 行,保留主 tool-subagent-control。
否则 preset 会被标记为:
broken: tool-subagent-list-agents ... never started
模式菜单不显示 Continuity,已有 continuity session 也无法载入。
给 DSH 的长上下文连续性插件。每个 session 拥有自己完整的一套记忆; persona 只是身份/启用标签。
session = 哪一段对话
persona = 哪个身份被允许运行(启用开关)
它做什么
compaction 压缩带控制;session 内 pass 回执 + passes.jsonl
index 每个完成的人类轮次一条指针
A 每个 session 自己的概念表,分 topic / workflow
B 每轮标签(展示、特征材料)
C 每个 session 自己的用户词表
K 每个 session 自己的精确名
rules/habits 每个 session 自己的规则/偏好,从插件根模板起
recall A / B / C / K + 字面,只查当前 session
panel 每个 session 自己的 A/B/C/K
peer_message 明确投递给另一个 live session
不包含额外的提示词分类或自动标注;本包只负责记忆索引、压缩和检索。
每个 session 的完整一套
~/.dsh/continuity/sessions/<sessionId>/
bc-index.jsonl
bc-index-state.json
audit-state.json
expand-hint.jsonl
concepts.md A 表(名字 | 描述词 | 覆盖 | kind)
cmap.md C 表
keywords.md K 表
aliases.md 别名
rules.md 硬规则,从 templates/rules.md 起
habits.md 软偏好,从 templates/habits.md 起
rebuild.md 本地重建说明
dropped-ranges.json 本 session 的合并覆盖(seq 空间只属于本 session)
共享/诊断:
~/.dsh/continuity/
session-persona.json sessionId -> 身份
personas/<pid>/persona.json {"enabled": true}
folds.json
passes.jsonl
context-log.jsonl
- A/C/K/rules/habits 不继承另一个 session。
- 新 session:A/C/K 空,rules/habits 从插件根模板起。
personas/是弃用归档,已经不是读取路径。session-persona.json只决定身份/启用,不决定词表路径。
安装
dsh-continuity-4.12.2.tgz
装进目标 profile,备份 ~/.dsh/continuity,重启 DSH。
进程是快照:只复制包不重启,运行时行为不变。
4.12.2 水位恢复
4.12.2 = 4.12.0 的水位线 + maxPerBatch = high−protect;native LLM summary 保留,不启用 mechanical note。
setpoint .76
high .76
low .38
emergency .85 -> .62
protect .20
maxPerBatch 443843
mechanicalNote false
protectCalibration 不再显式关闭,回到 4.12.0 的默认行为。
maxPerBatch 443843 覆盖 high-protect 的 443,842.56:
实际 budget 仍是 min(est − low, maxPerBatch),正常高线折约 301k,overshoot 不被 cap 截成二次小折。
recall_exact / recall / ABCK / gist / history-map 都不动。
4.13.x 的 mechanical note 只保留为实验代码,4.12.2 不启用。
4.12.0 新增
recall_exact
字面搜索,独立于 recall 的语义路径;只读、不排序、不写。
recall_exact({ query: "0.2.17" })
recall_exact({ query: "stage19", since: 2200 })
recall_exact({ query: "coo-read-side", near: 2300, window: 20 })
规则:
只搜 user + assistant 的 text
不搜 reasoning / tool-call
排除 continuity / 规则 / 系统注入文本
ASCII 用 [0-9A-Za-z] 边界;中文按子串
单个中文字必须白名单(目前只放“创”)
返回 totalTurns / totalIntervals / shown / turnShare
没有 path 参数;只查当前 session。
native summary 是默认中间层
fold 仍由 DSH 原生 compaction 完成:
系统选段 -> LLM 写 checkpoint -> replace 原区间
旧 summary 下次折入新 summary
history-map 默认关闭:
默认不注入 map
默认中间层就是 native checkpoint
auto / observe 只作实验档
需要时看 docs/history-map.md。
summary-index / window 工具
# 建当前 session 的摘要索引
node bin/summary-index.mjs --raw <session.v4.jsonl.zstd> \
--session-dir <continuity session dir> --apply
# 有 pending window 时生成抽取式摘要
node bin/summary-index.mjs ... --extract-pending --apply
默认不自动跑;pendingWindows=0 时不需要。
recall
recall()
recall({ query: "跑团", recent: true })
recall({ query: "A标签" }) // 只看 topic
recall({ query: "A标签:topic" })
recall({ query: "A标签:workflow" })
recall({ query: "A标签:跑团叙事" }) // 任意 A 概念
recall({ query: "B标签" })
recall({ query: "C标签" })
recall({ query: "K标签" })
- 索引和 A/C/K 只读当前 session 的目录。
- A 直接查是“区域浏览”;B/C/K/字面是“精确点位”。
via是A | B | C | K | live。- 候选不是事实;必须打开对应 turn/seq。
词表刷新
concepts.md/cmap.md的 mtime 会在下一次 pre-step 检查,变了就重建本 session 的 labeler/cmap;不需要重启。keywords.md在索引时读取,下一轮生效。aliases.md由 recall 每次读取。- 旧记录不会自动重标;新规则只作用于新轮次。
注入前缀
[continuity:boot] 引导
[continuity:audit] 审计
[continuity:fold] 压缩回执
插件注入的 role=user 消息都以 [continuity:*] 开头。[追忆] 是 recall 的 tool result,不是 user 通道注入。
rules 头部
rules.md 按 H2 标题汇总。截断时写:
…(共 18 节,仅显示前 13 节)
数字从当前文件现算,不硬编码。
session 启用 / 面板
session-persona.json:
<sessionId> -> continuity | <pid>
default -> continuity
personas/<pid>/persona.json:
{"enabled": true} -> 面板 + pre-step 启用
缺失/禁用 -> persona-disabled,关闭 tab
continuity 在旧安装里没文件也默认启用。
非 continuity session 也可以启用,但它的 A/C/K/rules/habits 仍然是
session-local,不继承 Continuity 的。
隔离边界
插件路径是 session-local。宿主还装了一个 best-effort 工具守卫:
session 只能碰自己的 sessions/<id>/,不能碰别的 session 的 continuity 文件。
这不是 OS 安全边界。拥有完整文件权限的任意代码可以绕过;强隔离需要 OS ACL/容器。守卫用于普通 edit/write/shell 工具。
标签版本
新记录用 labelVersion: 2:
genericTopic [top topic]
topicScore top topic 分数
topicConfidence normal | low | weak(仅展示)
genericWorkflow [top1, top2]
generic topic + workflow 并集
conceptScores 选中的候选分数
旧记录是 labelVersion: 1,没有 topicScore;不原地回填。
代码地图
src/index.mjs 宿主路由、面板 JSON、安装
src/engine.mjs 压缩带、pass 回执、gist/fold
src/state.mjs pass log、dropped-ranges
src/policy.mjs 压缩带数学与 floor
src/recall-tool.mjs A/B/C/K 检索,session 路径
src/memory/bc-pre-step.mjs 每 session 调度
src/memory/bc-index.mjs JSONL 指针编解码
src/memory/bc-index-updater.mjs 标签 + 追加一轮
src/memory/bc-panel-state.mjs 面板投影
src/memory/concepts-file.mjs A 解析(kind: topic|workflow)
src/memory/persona.mjs session -> 身份/路径
src/memory/onboarding.mjs boot marker/空壳
src/memory/bc-audit.mjs 审计 + 待注入提示
src/threads-store.mjs 每 session rules/habits
src/folds-store.mjs folds.json 历史
src/session-guard.mjs best-effort 工具路径守卫
client.js 右侧面板
cordis.patch.yml bundle patch
文档
README.md 本文件
RELEASE-NOTES.md 验收状态与已知限制
PANEL.md 面板排错与诊断
bin/panel-check.mjs 面板/宿主路由自检
docs/README.md 现行/历史文档索引
docs/SESSION-LAYOUT.md 权威路径、角色、权限
docs/ARCHITECTURE.md 当前架构
docs/NEW-INSTANCE-HANDOFF.md 新实例交接
guides/00-READ-FIRST.md 经典 00–07 说明书
guides/01-INSTALL.md
guides/02-TABLES.md
guides/03-AUDIT.md
guides/04-REBUILD.md 九步重建
guides/05-FIRST-RUN.md
guides/06-EMBEDDING.md 本地嵌入
guides/07-PTC-AND-ASSETS.md PTC / 子 agent / assets
templates/rebuild.md 当前布局的重建流程
docs/*.md 全部随包发布;docs/README.md 区分现行与历史。
历史文档是设计档案,不是现行操作说明。
安全
不要从 session 内修改已安装的插件、cordis.patch.yml、package 文件或
lockfile。插件变更走独立副本、测试、备份、替换。