dsh-galaxy-view:把 DSH 工作区与对话画成三维星系

前言

在 DeepSeek Harness(DSH)里,工作区和会话往往以列表或侧边栏呈现:路径一多,很难一眼看出「哪个工作区最重、哪条对话从哪 fork 出来」。Obsidian 社区里有 Galaxy View 一类做法,用电影感的 3D 图把笔记关系摊开。维护者 dialling 的 dsh-galaxy-view 把类似思路接到 DSH 上——工作区是旋臂上的恒星,对话是周围的小星点,fork 与子智能体之间拉出细线;再配一层空心球壳、八种几何布局,以及独立的「记忆库」视图。下面介绍它是什么、能做什么,以及如何装进 profile 并日常使用。

这是什么

dsh-galaxy-view 是 DSH 的前端插件(纯前端加一个 host 半包,无原生依赖),在 Harness Desktop 的 main 面板槽位里提供「银河」全屏视图。它读取宿主里的工作区与会话关系,渲染成可交互的三维场景;顶栏一键可回到原版界面。视觉方向参照 Obsidian 的 Galaxy View(NASA Eyes 式深空、硬边点阵球壳、冷暖相间星点、极细连线)。

核心功能

星系视图:关系怎么画在图上

图上元素 含义
带色恒星 一个工作区;颜色按工作区顺序固定,星越大表示对话越多
恒星周围星点 该工作区下的对话;运行中的会话会「呼吸」
细丝 归属关系;fork / 子智能体与父会话之间是更亮的弯丝
白色硬点球壳 三维点阵球面,与星系共用摄像机;钻进某颗星时是穿过球壳,而非整张背景跟着走
漂浮星尘 旋臂与弥散盘面(「尘埃带」滑杆,默认关),纯背景不可点

当前会话有一圈白环;已归档星点更暗,仅在打开「归档」时出现。八种布局(银河、星环、浑天、太阳系、双螺旋、矩阵、方阵、星树)切换的是整套几何,不只是参数——星体位置、尘埃与骨架线都会跟着变。

记忆库:指令与技能的另一张图

顶栏 记忆库 按钮把星系换成第二张图:塑造智能体行为的指令文件、可加载的技能,以及各技能被调用的次数。两个视图共用同一面板,选择会被记住。

画面 含义
内核金色星体 指令文件(如 AGENTS.md、CLAUDE.md、prompt-inject.md、rules/*.md、工作区 README.md)
旋臂青色星体 一个技能;色相表示来源,大小随调用次数增长
绕技能的小星 某次会话加载该技能的记录(超过 16 次只计数不再画点)
细线 调用 → 被加载的技能

点星体或左侧列表可选中;打开 会把文件读进右侧编辑器,支持 Ctrl+S / ⌘S 写回磁盘。Node 端在宿主 web 服务上提供带鉴权的 RPC 通道 /dsh-galaxy-view。已运行的 DSH 安装或更新此视图后需要重启——Node 端随宿主进程挂载,不随页面热更新。

交互与动效

拖拽绕轨旋转(松手约 1.6 秒后恢复自动环绕),滚轮推拉镜头。点击星点或恒星会俯冲并弹出卡片(标题、路径、时间与状态),卡片内 打开 / 进入工作区 播放跃迁过场进入目标;双击可跳过卡片直接跃迁。Tab / Shift+Tab 在星体间切换,F / R 飞向选中星或回到总览,顶栏搜索可按标题或路径跳转。Harness 侧边栏里点对话时,若银河已打开,镜头会飞到对应星而不退出银河模式。

进入银河时左侧导航栏会自动收起以让出宽度,离开时按原宽度还原。开启「减弱动态效果」时,飞行改为淡入淡出。

控制栏与持久化

左侧控制栏(☰ 可收起,宽度约 240–480 px)提供八张外观预设卡、工作区过滤(支持 Galaxy View 式语法)、状态透镜、七套主题、连线样式、深空背景、辉光、旋臂形态、力导向力学层、导航与动效等。设置写入 localStorage;外观类设置带版本号(现为 3),大版本升级时会重置外观默认值,筛选与语言等会保留。

安装与启用

需要 DeepSeek Harness Desktop。插件市场(发布后)可搜 dsh-galaxy-view。

从 npm 装进某个 profile(资料原文命令):

cd "$DSH_HOME/profiles/web"
pnpm add dsh-galaxy-view        # 或者:npm install dsh-galaxy-view

dsh.bundle.patch 会把插件行插入层栈;重启 Harness 或重开窗口 后生效。

本地开发挂载(改仓库时用,非普通用户必需):

node scripts/install-into-profile.mjs            # 默认 web profile
node scripts/install-into-profile.mjs --profile "$DSH_PROFILE_DIR"

脚本会把包 symlink 进 <profile>/node_modules/,并在 <profile>/cordis.patch.yml 末尾插入一行 insert(执行前自动备份,重复执行无副作用)。

装好后打开任意会话,顶栏右侧会出现 银河 按钮;点它进入视图,原版界面 或星体内的 回到星系 胶囊可返回对话。想换外观可从左侧预设卡挑选。

典型用法

  1. 安装并重启 DSH 后,在会话顶栏点 银河,先总览所有工作区与对话的分布。
  2. 用控制栏 过滤 隐藏无关工作区,或 状态 透镜只看「运行中 / 当前 / 子智能体」。
  3. 点击一颗对话星,看卡片里的路径与状态,再 打开 进入该会话;需要快速跳转时用顶栏搜索或侧边栏对话列表。
  4. 点 记忆库 查看 AGENTS.md、技能目录与调用关系,在编辑器里改指令后保存。
  5. 在 外观 里切换「浑天」「星环」「星树」等布局,或存为「我的预设」(最多 8 个)。

开发者在仓库根目录可跑自检:

npm run check     # build(含语法门禁)+ selfcheck

适用场景与注意

适合谁: 经常在 DSH 里切换多个工作区、维护 fork 链或子智能体会话的开发者;希望用空间关系而不是纯列表理解项目结构的人;需要可视化浏览指令文件与技能调用来源时,记忆库视图比翻目录更直观。

注意:

  • 插件以当前 DSH 进程权限运行;记忆库会扫描 DSH home、~/.agents、各工作区技能目录等,安装前请阅读 源码与 LICENSE,确认符合你的安全策略。
  • 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系;DSH 生态理念是「一切皆插件」,本文事实以仓库 README 与 package.json 为准。
  • WebGL2 渲染失败时会回落到 Canvas 2D;「移动」质量档会关闭辉光与云雾并限制星数,低配设备可手动调 高级 → 质量。

结尾

dsh-galaxy-view 把 DSH 的工作区与会话映射成可旋转、可俯冲的三维星系,并附带指令与技能的记忆库视图;装包后重启,顶栏 银河 即可进入。详情与截图见 GitHub README,插件条目见 SkillHub 目录页 与 GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye