dsh-thread
dsh 的线程会话记忆——无损事件捕获 + 状态卡注入（dsh 插件，独立仓库）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-thread@1.2.0Thread 以 dsh-thread 发布，当前版本为 1.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Thread's deep-integration plugin for DeepSeek Harness — session memory with lineage for coding agents, using the base's native channels end to end.
session/event; the full event stream
lands in dual SQLite databases with stable origins (idempotent append).query_session_memory registered through
ctx.tools.register into the model's tool schema, with filesystem-style
navigation ls / cd / cat / grep. The embedded MCP server remains as a
fallback channel. Retrieval is deterministic BM25 over the lossless stream
(jieba word segmentation for Chinese) with citation pull-back — no embedding
dependency by default; a hybrid layer can be added at the integration
boundary (evaluated against the BM25 baseline on the eval suite, not bundled).thread skill is registered into the base's
skill catalog ("need details → call the tool") and injected at anchors, so the
model does not rely on memory to know it has memory.knowledge_assets with lineage edges on write; /thread-reg ast covers
explicit registration./thread-reg dec (user, --supersedes <id> for chain evolution) or the
model's record_decision tool (the behavior contract instructs the model to
call it when the user settles a decision or it commits to one). Preferences
and lessons are recorded through /thread-reg fdb (auto-classified as
correction when phrased as "don't"). Natural-language extraction of
decisions/preferences is off — zero text-heuristic false positives; the
lossless event stream remains the backstop for anything unrecorded. (Goal
detection from short imperative messages and completion detection stay on,
guarded against pasted/multi-line text.)/thread-cfm is the single pending-work inbox: todos (t#id) and
candidates (c#id) in one view — do completes/promotes (candidates accept a
corrected text), cnl discards, cnl all clears both. The status card
surfaces the top candidates so they cannot pile up silently.c# entries only ever hold pre-existing rows until the post-release
extraction layer arrives; todos are produced actively (closing sediment +
goal-completion self-healing). Decisions never expire on their own — close
out time-bound ones with --supersedes. Goal completion detection is
conservative (≥4 non-ASCII / ≥8 pure-ASCII overlap; short English goals are
missed rather than mis-judged — abandon them with /thread-rev gol).
See the Thread README "Honest
boundaries" section for the full list./thread-rev <ast|dec|fdb|gol> <ids|all> revokes
registrations: decisions/preferences/assets are deleted (the event stream
keeps the text), goals are abandoned through the state machine with their
todos self-healed. Every structured row carries a visible #id on the status
card, so memory stays human-editable end to end./thread-iso / /thread-uniso, and
/thread-pub <ast|dec|fdb|gol> <ids|all> shares rows produced while isolated.THREAD_AUTO_COMPACT=1 the plugin
monitors token pressure at turn boundaries and triggers compactNow silently;
state re-anchors after every compaction either way.batch0-probe module
used for contract smoke-testing during development; it is inert unless
THREAD_B0_PROBE=1 is set, so normal sessions are unaffected.Local-first, no daemon — everything runs in-process: embedded SQLite stores, no background service, no cloud dependency. Headless and web profiles of the same machine share the same store, and offline sessions behave identically.
Verified: dsh 0.1.5-rc.1 (current; the dsh CLI and its SDK packages ship version-locked — the 0.1.5-rc.1 CLI resolves its SDK sub-packages to 0.1.5-rc.2). 0.1.1-rc.2, the previous baseline, is no longer declared.
The plugin pins its SDK peers to ^0.1.5-rc.1
(dsh-tools/dsh-agent/dsh-session/dsh-user-questions); within the
0.1.x train, upgrades are expected to be compatible and are verified by an
isolated contract probe plus the CI compat matrix
(.github/workflows/ci.yml) before this table is updated.
No promise is made for future major releases (0.2+); each new dsh release is evaluated and the matrix extended before support is claimed.
dsh plugin add dsh-thread
dsh plugin add dsh-thread@latest # 升级：同命令重装最新版（core 经 ^1.0.0 依赖自动跟随）
The plugin pulls its kernel (@thread-memory/core) through a ^1.0.0 range,
so new installs and re-adds pick up the latest core automatically. The runtime
logs the resolved core version at startup ([dsh-thread] thread core vX.Y.Z)
and the embedded MCP server reports it in its handshake.
All dsh plugins must be referenced in a profile's bundles to take effect. In
~/.dsh/profiles/<your-profile>/package.json:
{
"name": "dsh-profile-my",
"private": true,
"dependencies": {},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-headless",
"dsh-thread"
]
}
}
}
Zero configuration beyond that: @thread-memory/core + better-sqlite3 resolve
as dependencies; capture and injection start as soon as the plugin is activated.
Note (native module): if the plugin fails to start with "Could not locate the bindings file", pnpm 10 ignored the
better-sqlite3build script during install. Fix with one command in the profile directory:cd ~/.dsh/profiles/<your-profile> pnpm rebuild better-sqlite3This is a pnpm 10
onlyBuiltDependenciespolicy, not a plugin bug.
| Config | Default | Meaning |
|---|---|---|
budgetLines | 200 | Status card line budget |
feedbackRows | 50 | Feedback rows consulted by the tool guard |
busyRetries / busyRetryDelayMs | 20 / 100 | SQLITE_BUSY retry policy |
compactPressureTokens | 0 | Active-compaction token threshold (0 = off; requires THREAD_AUTO_COMPACT=1 to pull the compaction service) |
Registered as real dsh commands — visible in the command palette, /-completable,
and executed directly (no model round-trip). The same lines also work as plain
messages where no command UI exists. One grammar, six commands:
| Command | Effect |
|---|---|
/thread-reg <ast|dec|fdb|gol> | List that resource's rows (ids for rev/supersede) |
/thread-reg <ast|dec|fdb|gol> <text> | Register: ast = path (directories expand recursively, cap 50) · dec = decision (active immediately; --supersedes <id> evolves the chain) · fdb = preference/lesson (auto-classified by "don't" phrasing) · gol = goal |
/thread-rev <ast|dec|fdb|gol> | List that resource's rows |
/thread-rev <ast|dec|fdb|gol> <ids|all> | Revoke: dec/fdb/ast are deleted (event stream keeps the text) · gol is abandoned (state machine + todos self-heal) |
/thread-cfm | Pending-work inbox: todos (t#id) + candidates (c#id) |
/thread-cfm do <id> [text] | t# complete a todo · c# promote a candidate to an active decision (optional corrected text) |
/thread-cfm cnl <id> / cnl all | Discard one item / clear the inbox |
/thread-iso / /thread-uniso | Silence / restore a session |
/thread-pub | List isolated rows (all resources, ids for sharing) |
/thread-pub <ast|dec|fdb|gol> <ids|all> | Share isolated rows |
The package ships an embedded MCP server (bin: dsh-thread) exposing the same
query_session_memory contract over MCP for bases and setups where native tool
registration is unavailable. See the Thread Memory
Protocol.
This repository hosts the dsh deep-integration plugin. The base-agnostic kernel
(@thread-memory/core) and the Qoder adapter live in the main
Thread repository.
MIT