dsh-talk-map · Talk Map
English | 中文
A visual conversation map plugin for DeepSeek Harness (dsh): every session becomes a card on an infinite whiteboard.
Derived from Tasihi89/dsh-talk-map (MIT). This repository is a heavily reworked fork: slot layout, resizable workspaces, the overflow drawer and the routed links are additions or rewrites here.
Workspaces, pinned cards and live status
Cards connected by links, with running / waiting / unread lamps
-
Spatial memory instead of working memory: free placement + grid snapping, and nothing ever rearranges your cards — if you remember "that conversation was bottom-left", it stays bottom-left. Designed for ADHD users, useful for everyone.
-
Folders stay readable: a workspace becomes a frame that auto-expands or folds its overflow into a stack cell you can open as a drawer; pinned cards stay in front.
-
Double-click to chat: double-click empty canvas to start a new session; the card is born exactly where you clicked.
-
Draw an edge to fork: drag a line from a card onto empty space, preview (and edit) the context digest to inject, confirm — a new session starts knowing the old conversation.
-
Card front = resume surface: title, the last thing you said, relative time and a status lamp (running / finished / unread / waiting / interrupted). One glance tells you what to do next.
-
Lines mean something: a link whose context is still up to date disappears; one that has fallen behind stays visible as a dashed line with an arrow. Fork lineage is always drawn.
-
Automatic digests: a three-field digest (summary / key findings / next step) is generated on demand through your deployment's default model; hit ⟳ on a card to regenerate.
-
Bilingual interface: the map's own copy renders in Chinese or English. The pill in the map header cycles Auto → 中文 → English; Auto follows dsh's own language, and the choice is remembered across restarts.
-
Status rail: a collapsible strip on the left edge lists only the cards that carry a lamp (running / waiting / unread / interrupted). A card whose status changes jumps to the top, the order is yours to drag, a card that settles drops out, and the rail remembers whether you left it open.
Install
# npm (recommended)
dsh plugin add dsh-talk-map
# or straight from GitHub — built artifacts are committed, so there is no build step
dsh plugin add github:Da0Mine/dsh-talk-map
Restart dsh web; a map button appears at the sidebar foot.
Usage
| Action | Effect |
|---|
| Sidebar map button / Esc | toggle the map |
| Drag a card | place it (16px grid snap, persisted) |
| Double-click empty space | create a session there and enter it |
| Double-click a card | open that session |
| Drag from a card handle to empty space | preview injection → fork a new session |
| Click a stack cell | open the drawer listing the folded conversations |
| ⟳ on a card | regenerate the digest |
| Right-click a card / a line / a folder | pin, rename, mark unread, archive, delete, push switch, delete line |
| Language pill in the map header | cycle Auto → 中文 → English |
Where data lives
- Canvas data (positions, edges, digests):
$DSH_HOME/storages/talk_map.json via dsh's official storage-domain, atomically persisted.
- Sessions themselves stay fully owned by dsh — this plugin reads them, and creates new ones only through official APIs when forking.
- Digests use your configured default model through dsh's local LLM channel; there are no other external requests.
Compatibility
Built and tested against DeepSeek Harness 0.2.1-rc.3. The structural contracts live in src/client/dsh.ts and src/host/dsh-host.ts — start there when upgrading.
Roadmap
Multi-board shelf (project = board, WIP limit) · whole-board archive/shelve · timeline view (camera fly-back) · alias cards · multi-parent merge UI · selection-level injection · quick-ask on card.
Development
pnpm install
pnpm run build # host → lib/, client → client/client.js
pnpm run probe # headless end-to-end probe (150 checks)
dsh plugin --profile dev add /abs/path/dsh-talk-map
MIT License.
