dsh-synapse

A visual, non-linear conversation workspace plugin for DeepSeek Harness.

把同一工作区里的会话、追问与分支变成一张可浏览、可拖拽、可放大的对话地图，同时保留 DSH 原生的对话能力。

中文 | English

---

中文

简介

dsh-synapse 是一个独立的 DeepSeek Harness Web 插件。它不替代 DSH 的模型、工具、会话或权限逻辑，而是在原生对话界面上增加一个可视化工作台，将同一工作区内的会话、追问和分支呈现为可浏览的对话地图。

复杂任务往往不是一条直线：你需要保留某个方案、回到第二轮问题尝试另一条路径，或在多个会话之间快速定位上下文。Synapse 让这些关系留在同一张画布上，同时继续使用 DSH 原有的会话能力。

面向学习与研究的定位

• 非线性学习：把追问、回溯和替代解法保留为可浏览的分支，而不是埋在连续消息流里。
• 研究过程梳理：用同一张画布定位关键上下文、记录卡片笔记，并在不同会话之间恢复推理线索。
• 优化的会话地图工作流：围绕 DSH 原生会话与 fork 构建；Synapse 不另起对话系统，只改善复杂会话关系的浏览与组织。

来源与维护范围

本仓库基于上游项目 liangmianya/dsh-synapse 的 MIT 许可代码持续维护，并保留上游署名。Suxeca/dsh-synapse 的发布、Issue 与安装来源均以本仓库为准；当前维护重点包括会话地图的跨设备状态同步、移动端画布体验、分支关系恢复及 /synapse 路由的 Host 信任边界。

功能特性

	功能	说明
🗺️	会话地图	在 DSH 原生对话与可视化画布之间切换
✨	地图内发起会话	在地图顶栏一键“新建对话”，直接在画布上输入首条消息开启新主题，即时上图
📚	地图书架	支持多命名地图管理，顶栏无缝翻页切换、新建、重命名与安全删除，多设备同步当前地图
🚀	视口虚拟化	针对超大型会话网络自动启用视口裁剪渲染，保障上百节点丝滑交互与极低内存占用
🌿	分支可见	通过 DSH 原生 session fork 创建分支，并按真实分叉点连接节点
📁	工作区映射	读取 DSH 工作区与目录归属，便于在正确的项目上下文中创建会话
📥	持续投影	用户消息和助手回复投影到对应卡片；流式回复在详情中持续更新
🔧	工具过程折叠	工具调用与结果按 callId 配对，折叠进对应助手回复卡，不再单独成卡
⚡	会话同步	原生对话与会话地图双向同步当前会话——任一侧切换，另一侧跟随高亮
🎨	画布交互	拖动画布、缩放视图（最高 4×）、移动卡片（位置自动保存）、一键定位当前会话，卡片内平滑滚动
🔒	原生会话不变	打开、追问、创建和归档仍由 DSH 会话系统完成；Synapse 只提供另一种查看与组织方式
🛡️	生态规范兼容	符合 dsh-std v0.15 与 dsh-ecosystem-spec 准入标准，内置 dsh-plugin.json 与软探测降级
🖥️	双端伴随协同	支持 Web GUI 沉浸式全屏画布，同时支持在 dsh-tui 终端环境下实时状态感知与副屏推流

快速开始

corepack pnpm dsh plugin --profile web add github:Suxeca/dsh-synapse
corepack pnpm dsh web

打开 http://127.0.0.1:3080/，点击顶部"会话地图"即可进入。

安装

前提：已安装支持 dsh plugin profile 插件机制的 DeepSeek Harness（2026-08 及之后版本），且 Node.js 版本不低于 22.19。

从 GitHub 安装

corepack pnpm dsh plugin --profile web add github:Suxeca/dsh-synapse

GitHub 安装会执行本项目的 prepare 脚本（node --check 语法校验）。

allowBuilds:
  "dsh-synapse@https://codeload.github.com/Suxeca/dsh-synapse/tar.gz/<commit>": true

然后重新执行安装命令。在 pnpm 10.x 上裸包名匹配不到 git 依赖；上游推送新 commit 后该键会变化，届时复制 pnpm 新打印的键即可。

本地开发安装

corepack pnpm dsh plugin --profile web add link:E:\path\to\dsh-synapse

link: 形式会直接链接你的本地 checkout，改代码即时生效。

启动

corepack pnpm dsh web                # 默认 http://127.0.0.1:3080
corepack pnpm dsh web --port 0       # 3080 被占用时，自动分配空闲端口

卸载

corepack pnpm dsh plugin --profile web remove dsh-synapse

配置

插件通过 profile 的 cordis.patch.yml 注入，以下键可在你自己的 patch 中按行 id synapse 覆盖（整体替换 config）：

键	默认值	说明
dataFile	$DSH_HOME/synapse/workspaces.json	旧版工作区数据路径；首次启用地图书架时只读复制为“默认地图”，原文件不被删除或覆盖
mapDirectory	$DSH_HOME/synapse/maps	地图书架目录：保存共享的活动地图索引和每张命名地图；可覆盖为你的研究项目目录
autoProjection	true	是否自动把已提交的 DSH 会话事件投影为画布卡片
projectionWorkspaceTitle	DSH 任务	投影工作区的标题
trustedHosts	[]	额外放行的 Host（主机名或 主机:端口）；localhost 与 127.0.0.1 始终放行。局域网访问需在此加入你的主机

# 在 profile 的 cordis.patch.yml 中覆盖（需重述全部键）
- id: synapse
  config:
    dataFile: !!js dshHomePath('synapse/my-workspaces.json')
    mapDirectory: 'E:\Research\SynapseMaps' # choose a writable map-library directory
    autoProjection: true
    projectionWorkspaceTitle: 我的任务

使用方式

1. 在 DSH 中选择工作目录，或打开一个已有会话。
2. 点击顶部"会话地图"进入画布；顶部的地图选择器可像翻书一样切换命名地图，+ 可新建空白地图。
3. 导入 .synapse 文件时会写入当前地图；切换地图不会清空其他地图。使用同一 DSH profile 的设备共享当前选择和地图内容。
4. 浏览画布卡片：点击卡片或侧边栏会话即可切换当前会话（原生页同步跟随）；"分支"操作保留一条替代路径。
5. 点击卡片底部"详情"查看完整对话记录；点击顶部"对话"切换或卡片"在 DSH 中打开"，回到原生对话。

数据、隐私与边界

• 持久化内容：画布工作区、卡片位置、笔记、已加载会话及分支锚点保存在 DSH Home 的 synapse/workspaces.json（当前 schema v4，自动迁移旧版数据）。
• 会话内容归属：对话正文仍由 DSH session log 保存和管理；Synapse 仅从已提交的会话事件读取信息以渲染地图。
• 保留与删除：卸载插件不删除画布元数据；删除 workspaces.json 会删除地图布局和笔记，但不会删除 DSH 对话日志。
• 访问边界：默认仅信任 localhost 与 127.0.0.1。局域网访问必须显式将主机加入 trustedHosts；请只填写你实际控制的主机。
• 本插件不启动第二个 Web 服务、不创建第二套 Agent，也不改变 DSH 的模型或工具执行行为。

模型影响

无直接模型影响：插件只读取已提交的会话事件并渲染成画布，不向任何模型请求添加系统提示、工具 schema 或请求上下文，也不影响 KV 缓存复用。

已知限制与后续

• 仅支持 web profile。
• 画布元数据与会话日志分离：删除 workspaces.json 会丢失画布布局与分支锚点，但不会丢失会话。
• 两个 dsh web 实例共享同一 profile 时会写同一个 workspaces.json：运行时已加跨进程写锁与外部修改警告，但最后写入覆盖的风险仍在——请只运行单个实例。
• 旧版（v3）数据迁移时工具卡片按顺序配对（每条调用配下一条结果）；实时事件按 callId 配对。

---

English

dsh-synapse is a standalone DeepSeek Harness Web plugin. It does not replace DSH models, tools, sessions, or permissions. Instead, it adds a visual workspace on top of the native conversation UI, turning related sessions, follow-ups, and forks into an explorable conversation map.

Complex work is rarely linear. You may need to preserve one approach, return to an earlier turn, and explore another path without losing context. Synapse keeps those relationships on one canvas while leaving DSH's native session behavior intact.

Learning and research focus

• Non-linear learning: keep follow-up questions, revisits, and alternative approaches as browsable branches rather than burying them in one message stream.
• Research-process navigation: locate decisive context, keep card notes, and recover lines of inquiry across related sessions on one canvas.
• An optimized conversation-map workflow: build on DSH-native sessions and forks; Synapse does not create a second conversation system, but improves how complex session relationships are explored and organized.

Upstream and maintenance scope

This repository continues the MIT-licensed work of liangmianya/dsh-synapse with upstream attribution preserved. Releases, issues, and installation for the maintained variant are provided by this repository; its current focus includes cross-device map-state synchronization, responsive mobile canvas behavior, branch-relationship recovery, and a Host trust boundary for /synapse routes.

Features

	Feature	Description
🗺️	Session map	Switch between the native DSH chat and a visual canvas
✨	Start session on map	One-click "New Conversation" directly on the canvas with an interactive draft card
📚	Map Library	Manage named maps with instant switching, creation, renaming, and deletion; synced across devices
🚀	Viewport Virtualization	Windowed rendering for large canvas graphs, ensuring smooth 60fps pan/zoom across hundreds of cards
🌿	Visible branches	Create forks through DSH native session forks and connect them at their actual branching turn
📁	Workspace-aware	Reflect DSH workspaces and directory ownership when creating or browsing sessions
📥	Live projection	Project user messages and assistant replies into cards, with streaming updates in the detail view
🔧	Folded tool process	Tool calls and results pair by callId and fold into the assistant reply card instead of becoming standalone cards
⚡	Session sync	The native chat and the session map sync the current session bidirectionally — switching on either side highlights the other
🎨	Canvas interaction	Pan, zoom (up to 4×), move cards (positions persist), one-click focus on the current session, and smooth scrolling inside each card
🔒	Native sessions stay native	Opening, prompting, creating, and archiving sessions remains DSH-owned; Synapse only changes how they are viewed and organized

Quick start

corepack pnpm dsh plugin --profile web add github:Suxeca/dsh-synapse
corepack pnpm dsh web

Open http://127.0.0.1:3080/ and use the top "Session Map" switch.

Installation

Prerequisites: a DeepSeek Harness with the dsh plugin profile plugin mechanism (2026-08 or later) and Node.js >= 22.19.

Install from GitHub

corepack pnpm dsh plugin --profile web add github:Suxeca/dsh-synapse

GitHub installs run this package's prepare script (node --check syntax validation).

allowBuilds:
  "dsh-synapse@https://codeload.github.com/Suxeca/dsh-synapse/tar.gz/<commit>": true

Then rerun the install command. On pnpm 10.x a bare package name does not match a git-hosted dependency; the key changes when the upstream repository pushes a new commit, so copy the newly printed key then.

Install a local checkout

corepack pnpm dsh plugin --profile web add link:E:\path\to\dsh-synapse

The link: form points at your local checkout, so edits take effect immediately.

Boot

corepack pnpm dsh web                # default http://127.0.0.1:3080
corepack pnpm dsh web --port 0       # pick a free port when 3080 is taken

Uninstall

corepack pnpm dsh plugin --profile web remove dsh-synapse

Configuration

The plugin is injected through the profile's cordis.patch.yml. Override any key in your own patch by targeting the row id synapse (the whole config is replaced):

Key	Default	Description
dataFile	$DSH_HOME/synapse/workspaces.json	Canvas metadata persistence path
autoProjection	true	Automatically project committed DSH session events into canvas cards
projectionWorkspaceTitle	DSH 任务	Title of the projection workspace
trustedHosts	[]	Extra authorities (host or host:port) the /synapse Host check accepts; localhost and 127.0.0.1 are always allowed. LAN access must add your host here

# Override in the profile's cordis.patch.yml (restate every key)
- id: synapse
  config:
    dataFile: !!js dshHomePath('synapse/my-workspaces.json')
    mapDirectory: 'E:\Research\SynapseMaps' # choose a writable map-library directory
    autoProjection: true
    projectionWorkspaceTitle: My tasks

Usage

1. Select a working directory or open an existing DSH session.
2. Open "Session Map" from the top switch. Use the map selector like turning a page; + creates an empty named map.
3. Importing a .synapse file writes it to the selected map, and switching maps never clears another map. Clients using the same DSH profile share the active map and its contents.
4. Browse the canvas: clicking a card or a sidebar session switches the current session (the native page follows); the "branch" action keeps an alternative path.
5. Open "Details" at the bottom of a card for the full conversation; return to the native chat with the top "Dialogue" switch or a card's "Open in DSH" button.

Data, privacy, and scope

• Persisted data: canvas workspaces, card positions, notes, loaded sessions, and branch anchors are stored in synapse/workspaces.json under DSH Home (schema v4; old data migrates automatically).
• Session-content ownership: DSH remains the owner of session-log content. Synapse reads committed session events only to render the map.
• Retention and deletion: uninstalling does not remove canvas metadata. Deleting workspaces.json removes map layout and notes, never DSH conversation logs.
• Access boundary: only localhost and 127.0.0.1 are trusted by default. LAN access requires explicitly adding a host to trustedHosts; add only hosts you control.
• This plugin starts no second web server, creates no second agent, and does not modify model or tool execution.

---

Development

corepack pnpm install
corepack pnpm run build
corepack pnpm test
corepack pnpm pack

npm pack --dry-run --json is useful for reviewing the files that will be published before creating a release archive.

License

MIT

Model Experience

None, as dsh-synapse only reads committed session events and renders them; it adds no system-prompt prose, tool schemas, or request-context content to any model request.

KV Cache effect

Does not invalidate. The plugin never changes request headers, system prompts, or tool registries, so an already-reusable KV prefix stays reusable; canvas projection consumes session logs only after they are committed.

Known Limitations and Deferred Work

• Only the web profile is supported; the patch inserts into the web composition and no other profile template declares it.
• Canvas metadata is separate from session logs: deleting workspaces.json loses canvas layout and fork anchors, never conversations.
• Two dsh web instances sharing one profile write the same workspaces.json: a cross-process write lock and external-modification warnings are in place, but last-writer-wins clobbering remains possible — run a single instance.
• Legacy v3 data migrates tool cards by order (each call paired with the next result); live events pair by callId.