dsh-session-workbench — Search past sessions, recall them as @references, and manage the conversation tab bar

[PolinniZhong]

dsh-session-workbench brings a search-and-recall workflow to DeepSeek Harness: full-text search across all your past sessions — down to the exact sentence — then insert up to 3 sessions into the current input as @references. On send, the platform injects read-only snapshots into the model context — the AI answers with your historical context, no re-explaining needed.

v1.0.3 — DSH 0.1.7-rc.2 compatibility (plugin settings API re-model: Config + settings.describe/update; archive storages path probing; client inject cleanup).

v1.0.0 — renamed & merged. dsh-session-kb became dsh-session-workbench: one plugin, three entry points (sidebar Session KB + Settings Session KB / Conversation views).

v1.2 (0.3.0) — same-session hits: expanding a fragment card shows the session's other matches (keyword-highlighted); Locate now uses composite anchors (hit sentence + preceding text) so repeated wording lands on the right occurrence.

v1.1 (0.3.0) — snippet-level retrieval: fragment cards (hit + context) + Locate.

Why it matters

DSH ships with a full-text search engine (SQLite FTS5) and cross-session references, but neither has a UI. Until now there was no way to find a past session by keyword, and no way to insert one as a reference without hand-typing @[label](dsh-session:…). This plugin adds the missing discover → browse → insert layer — and v1.1 goes one step further: find the sentence, not just the session.

Features

• Fragment hits (v1.1) — results are per-session best-hit fragment cards: the matched sentence highlighted with its surrounding context (lazy-loaded), so you see the sentence, not just which session
• Same-session hits (v1.2) — expanding a fragment card shows a "More hits in this session" fold with the other matches (first 5, then load more), each with keyword highlighting
• Locate (v1.1 + v1.2 composite anchors) — click Locate to open the session, page back, and scroll to the exact message; v1.2 matches the hit sentence plus its preceding text so repeated wording lands on the right occurrence
• Search — full-text search across all past sessions (all workspaces), workspace / time-range / archive filters, cursor pagination, relevance or latest-first sort
• Recall — pick up to 3 sessions, one-click insert into the input as reference chips; on send the platform injects ## Referenced sessions snapshots
• Recent — recent-sessions list without searching
• Archives — search includes archived sessions by default (with an "Archived" badge and all / active-only / archived-only filters); the Recent list excludes archived sessions by default
• Conversation views (v1.0.0) — manage the session tab bar: show/hide each custom view and reorder by drag-and-drop, from either Settings → Session Workbench → Conversation views or a right-click / double-click panel on the tab bar itself
• Settings — one 会话工作台 entry with two partitions: Session KB (enable/disable + default search scope + privacy) and Conversation views (per-view toggle + drag reorder)

The UI is native-feeling: every color, spacing, radius, and interaction is measured from DSH's own design system (better-sidebar, workspace sidebar, settings sections) — it looks and behaves like a built-in feature.

Screenshots

Fragment search (v1.1) — searching "Vibe Coding" returns per-session fragment cards:

Locate (v1.1) — the session opens and scrolls to the exact hit message:

Pick & insert

Settings

Conversation views (v1.0.0) — reorder in Settings (drag the ⋮⋮ handle):

Conversation views — reorder from the tab-bar panel (right-click / double-click a tab):

Install

dsh plugin add dsh-session-workbench

One-time setup: the web profile disables the FTS index by default. Override it in <DSH_HOME>/profiles/<your-profile>/cordis.patch.yml with a persistent index (built once on startup — recommended; see the README). ⚠️ Use an absolute path — ~ and env vars are not expanded:

- id: session-query-sqlite
  config:
    path: '/Users/<you>/.dsh/session-query.sqlite'
    openAt: startup

Then restart the DSH app.

Links

• GitHub: PolinniZhong/dsh-session-workbench
• npm: dsh-session-workbench (1.0.3)
• Privacy: PRIVACY.md

Fully local, zero network requests. MIT licensed. Feedback welcome — open an issue or discussion!

---

Topics: dsh-plugin deepseek-harness session-search snippet-level same-session locate knowledge-base recall conversation-view tab-management

[ylwl1997]

FTS5 is already on the host, but there is no discovery layer — archived sessions especially are stuck behind hand-typed @[label](dsh-session:…) chips. Search → pick at most three → insert as @references is the missing piece.

dsh plugin --profile web add dsh-session-kb

If you want it in the community catalog: https://github.com/ylwl1997/dshbase/issues/new?template=plugin-submission.yml
https://dshbase.com/plugins/directory/

[PolinniZhong]

Thanks for the kind words — and for the dshbase pointer! The plugin is now in the community catalog (dshbase directory, submitted via issue #70).

We also just shipped v0.2.0 (v1.1) with snippet-level retrieval: search results are now per-session fragment cards (matched sentence highlighted + surrounding context), and a Locate button opens the old session and scrolls to the exact message. Release: https://github.com/PolinniZhong/dsh-session-kb/releases/tag/v0.2.0

[PolinniZhong]

🎉 v1.0.1 已发布（DSH 0.1.1-rc.2 兼容修复，无新功能、行为不变）

• 适配 DSH 0.1.1-rc.2 的 client 模块重组：移除已并入 dsh-client-ui-conversation 的旧 dsh-client-ui-slots 注入（旧引用曾致 HARNESS_NOT_READY 启动失败）；
• 功能基线不变：会话库（search → snippet → locate → recall）+ 会话视图（tab 条 show/hide + drag reorder）。

变更详情见 CHANGELOG / tag：https://github.com/PolinniZhong/dsh-session-workbench/tree/v1.0.1

[PolinniZhong]

🎉 v1.0.2 已发布（DSH 0.1.2-rc.1 兼容修复）

• 会话视图的隐藏/排序不再误伤设置弹层内其它插件的同数量 tab 条：applyViewConfig 此前遍历全文档 [role=tablist]，会把其它插件设置页里数量相同的 tab 条当会话视图条按隐藏配置 display:none（曾致 dsh-personal-center 的「外观/宠物」两 tab 消失）；
• 守卫改为类名无关的祖先判定（任一祖先类名含 settings 或位于对话框内即跳过），不依赖具体壳类名，复发路径封死。

详见 Release：https://github.com/PolinniZhong/dsh-session-workbench/releases/tag/v1.0.2

[PolinniZhong]

🎉 v1.0.3 已发布（DSH 0.1.7 兼容修复，无功能变更）

• 插件设置 API 换模型：0.1.7 的 dsh-settings 移除 settingsNamespace 与 SettingsService.register/get → 新增 Config（字段组沿用 session-kb，标 volatile）+ describe/update 适配层，设置分区与写入行为不变；
• 归档 storages 路径修正：0.1.7 起 settings.documentPath 指向 profile 补丁 → storages/workspace.json 改为多候选探测；
• 打开 / 定位会话：ctx.sessions.open 在 0.1.7 已不存在 → 改用外壳导航 ctx.uiWorkspace.openSession；
• 召回插入输入框：conversation 已是会话级服务 → 改为 actx.get("conversation")，span/事件仍走官方 slash/input-insert-reference；
• client inject 清理：移除已不存在的 dsh-client-runtime；≤0.1.6 旧宿主路径保留兼容。

详见 Release：https://github.com/PolinniZhong/dsh-session-workbench/releases/tag/v1.0.3

• npm：dsh-session-workbench@1.0.3
• 同期发布：dsh-personal-center@1.1.2（同批 0.1.7 兼容修复）

排查提示（如果你也用 link: 本地挂载插件）：升级 DSH 后若插件在 UI 里整体消失、日志出现 failed to import，先查插件仓库的 node_modules/@deepseek-ai/* 是否仍指向旧安装目录的悬空软链 —— 它会让宿主 import 直接失败；同时确认 ~/Library/Application Support/dsh-tauri/.store.dat 里的 active_profile 是否已切到新 profile（旧 profile 不生效）。