liangmianya/dsh-synapse

dsh-synapse

Name: dsh-synapse
Author: liangmianya

UIWeb UI184 GitHub stars· updated 2026-08-21

A visual, non-linear conversation workspace plugin for DeepSeek Harness ; A canvas-based session explorer and branching workspace for DeepSeek Harness.

Install

npx @deepseek-ai/dsh plugin --profile web add github:liangmianya/dsh-synapse

Restart `dsh web` after install. Bundle APIs can change during the developer preview.

README badge

[![DSH Hub](https://dshhub.dev/badge/dsh-synapse.svg)](https://dshhub.dev/plugins/dsh-synapse)

Paste this into your README. The star count updates with every catalog sync.

GitHub Install guide

From the README

Excerpt from liangmianya/dsh-synapse, cleaned of badges and images.

dsh-synapse

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

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

中文 | English

中文

简介

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

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

功能特性

	功能	说明
🗺️	会话地图	在 DSH 原生对话与可视化画布之间切换
🌿	分支可见	通过 DSH 原生 session fork 创建分支，并按真实分叉点连接节点
📁	工作区映射	读取 DSH 工作区与目录归属，便于在正确的项目上下文中创建会话
📥	持续投影	用户消息和助手回复投影到对应卡片；流式回复在详情中持续更新
🔧	工具过程折叠	工具调用与结果按 `callId` 配对，折叠进对应助手回复卡，不再单独成卡
⚡	会话同步	原生对话与会话地图双向同步当前会话——任一侧切换，另一侧跟随高亮
🎨	画布交互	拖动画布、缩放视图（最高 4×）、移动卡片（位置自动保存）、展开/折叠后续对话子树、一键定位当前会话，卡片内平滑滚动
🔒	原生会话不变	打开、追问、创建和归档仍由 DSH 会话系统完成；Synapse 只提供另一种查看与组织方式

快速开始

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

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

安装

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

[!NOTE] 本插件仅支持 web profile：它的 patch 只向 Web 组合插入自身，复用 DSH 现有 Web 服务，不启动第二个应用进程。

从 GitHub 安装

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

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

[!IMPORTANT] pnpm ≥10 默认阻止 git 依赖的构建脚本。若安装被拦截，请把 pnpm 打印的确切键（包名加其拉取的 tarball 地址，内含 commit，不是裸包名）复制进 DSH profile 的 pnpm-workspace.yaml：

allowBuilds:
  "dsh-synapse@https://codeload.github.com/liangmianya/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

[!NOTE] remove 只移除插件依赖与 profile 激活层，不会删除画布数据（$DSH_HOME\synapse\workspaces.json）。重装后旧数据会自动迁移恢复。

彻底清理：手动删除 $DSH_HOME\synapse\ 目录；pnpm-workspace.yaml 中残留的 allowBuilds 键无害，可一并删掉。

配置

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

键	默认值	说明
`dataFile`	`$DSH_HOME/synapse/workspaces.json`	画布元数据持久化路径
`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')
    autoProjection: true
    projectionWorkspaceTitle: 我的任务