DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

songzhou666 /

songzhou666/dsh-spiral

Verified

SemanticNebula · 语义星云 — decorative DSH / DeepSeek Harness plugin: every prompt becomes a rotating four-arm spiral nebula with a local semantic footprint map. No model, no network, under 130 KB. Prompt visualization, canvas2d, generative art.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@9ac47e42

SemanticNebula · 语义星云

English | 中文

dsh-plugin · deepseek-harness · DSH Web GUI · prompt visualization · canvas2d · nebula · generative art · 语义星云 · 提示词可视化

小时候我很喜欢星空。后来每天都在跟 AI 说话,忽然想:不如让每句话,在天上多长出一颗星。

于是有了这个插件。它不提高任何效率——只是让 DSH 的角落里,有一片会自己转的深空。

四臂旋涡星云动图演示:每条提示词都会长成一片自己的星系

SemanticNebula · 语义星云 是一个 纯装饰性 的 DeepSeek Harness (DSH) Web GUI 插件:把你在输入框里提交的每一条提示词,实时投影成一片可以拖动的四臂旋涡星云,并在旁边绘制一张本地语义足迹图。

  • 不拦截、不包装 DSH 的输入框
  • 不读取、不上传任何消息内容
  • 不联网、不调用任何模型(嵌入是本机确定性哈希,见「已知取舍」)
  • 客户端产物约 160 KB(gzip 约 36 KB),无运行时依赖

安装

当前版本 0.7.0(2026-11-13)。本插件尚未发布到 npm,请不要执行 npm install dsh-spiral;目前只通过 GitHub 分发。

v0.6.0 及更早的 tag 是旧快照,不含会话星群、双生轮廓与星图卡片导出。要拿最新版,请认准 main 分支 / v0.7.0 tag / dsh-spiral-0.7.0.tgz。

本仓库已标记 dsh-plugin / deepseek-harness topic,并在 package.json 中声明 dsh.bundle manifest,可被 DSH 社区插件市场自动收录;市场的安装计划会读取仓库根目录的 cordis.patch.yml。手动安装时,先用下面任一方式取包,再做统一的最后一步。

DSH 通过 profile 的 pnpm 依赖 发现插件,所以插件包必须先成为 ~/.dsh/profiles/web 的本地依赖,再在 cordis.patch.yml 中声明。

包名是 dsh-spiral(npm 上的 dsh-nebula 已被另一个同名极光插件占用),项目/产品名仍然叫 SemanticNebula · 语义星云。

方式 A:分发包(推荐)

下载仓库根目录的 dsh-spiral-0.7.0.tgz(约 1.5 MB,已含构建好的 lib/,不必自己编译),然后:

cd ~/.dsh/profiles/web
pnpm add /path/to/dsh-spiral-0.7.0.tgz

方式 B:源码

# 1) 取回源码(已有克隆就直接 git pull)
git clone https://github.com/songzhou666/dsh-spiral.git

# 2) 让 profile 认识这个包(本地目录,不发布到 npm)
cd ~/.dsh/profiles/web
pnpm add /path/to/dsh-spiral

两种方式都要做的最后一步

在 ~/.dsh/profiles/web/cordis.patch.yml 末尾追加仓库自带的片段:

- insert:
    - id: dsh-spiral-bundle
      name: dsh-spiral

重启 DSH Web 服务后,右下角会出现一枚乳白色悬浮球。

说明:dsh plugin --profile web 只负责包管理;真正让宿主加载插件的是 cordis.patch.yml 里的 insert 条目。两者缺一不可。

已装过旧版怎么更新:在克隆目录 git pull,或直接换成 0.7.0 的 tgz,再在 profile 里重新 pnpm add 一次并重启服务。判断是否生效:面板 HUD 出现 CLUSTER / DUAL 字样、右下角有导出按钮,即已是 0.7.0。

使用

  1. 点击右下角悬浮球,展开 520 × 352 的语义星云窗口。
  2. 在 DSH 输入框正常输入并回车;窗口会随之展开并出现新的语义点。
  3. 左侧是 星云视图(四臂螺旋 + 粒子 + 光晕),右侧是 语义足迹图(历史轨迹 + 坐标网格)。
  4. 拖动标题栏移动窗口,拖动右下角缩放,点击「收起为悬浮球」最小化。
  5. 点击播放按钮,按提交顺序做一次 语义漫游;模型回答完成后,会切换为「播放回答语义漫游」。
  6. 鼠标在星云上移动时,整片场会朝指针方向轻微平移;背景星分三层,近层位移最大、远层几乎不动,像隔着舷窗观察。靠近指针的星点会微微发亮。
  7. 在星云上轻点一下,会从落点荡开一圈涟漪,随即散去。
  8. 收起后,悬浮球的图标与光环会染上最近一条提示词的语义色,并有一道高光极缓慢地绕环一周。
  9. 每条提示词由哈希得到一个稳定的星座编号(如 LYRA-7F2),显示在星云 HUD、面板底栏、足迹图标签与悬浮提示里;同一句话永远得到同一个编号,身份仍由消息 id 保证。
  10. 当前提示词占据主星系,本会话最近 12 条历史变成它外围的伴星;提交新提示词时,上一条会「退位」成一颗淡入的伴星,长会话越用越厚。
  11. 模型回答完成后,星云的亮度轮廓会在 1.8 秒里从提问的形状渐变到回答的形状,HUD 右上显示 DUAL 54% 这样的过渡进度。
  12. 点击面板右下角的下载按钮,把当前这一帧导出成 1200 × 900 的星图卡片 PNG(含提示词、编号与本地分析数据);只在本机生成,没有语义点时按钮禁用。

氛围细节(都属于可选的「感觉」层,不参与任何语义计算):

  • 呼吸:整个星盘以约 30 秒的周期做 ±1.6% 的缩放,静止时画面不会像贴图。
  • 光点外移:四条旋臂各有一颗微光点向外缓行,随图案一起旋转,读作密度波里的恒星形成,方向永远与自转一致。
  • 臂间尘埃:旋臂之间的空隙不是空的 —— 那里铺着一层细粉状光点,切变比旋臂软得多(WIND * 0.34),读作随盘一起漂的稀薄气体,而不是第二道密度波。数量跟着嵌入维度走(220 / 380 / 560),所以档位越高,空隙填得越满。
  • 三层背景星:200 颗背景星按深度分三层,视差系数 2.6 / 1.4 / 0.6,尺寸与亮度逐层递减;鼠标移动时近层漂得最明显,远层几乎不动,星场因此有了纵深。三层按轮转混排,任何细节档位下比例都一致。
  • 回答回波:提问时是向外扩的冲击环;模型回答完成后,一道纯亮度脉冲从臂外缘向核心扫回,只调各层的 alpha,不碰 angle 或任何半径,所以自转与拖尾的物理约束完全不受影响。减少动画时关闭。
  • 流星:平均每 10 秒左右,一颗流星斜掠画面一角,只占一条渐变线 + 一个精灵。
  • 柔光核心:中心是一团宽而暗的光晕加一枚亮核,四道光芒做成朝尖端收窄的菱形;每层都压在叠加合成的饱和阈值以下,所以读作一颗星,而不是一块边缘生硬的白盘加十字衍射。旋臂同理:从宽到窄叠几道带径向渐隐的描边,不再有被剪断的平直丝带。
  • 胶片颗粒:一张 128² 噪声贴图以 overlay 合成,既给暗部一点质感,也顺手压掉 8 bit 渐变可能出现的色带。

会话星群、双生轮廓与星图卡片

这三层共用一条约束:不新增采集入口、不联网,也不碰 angle、WIND 与任何半径。物理回归测到的仍是原来那片盘。

会话星群 —— 开头那句「让每句话,在天上多长出一颗星」,现在是真的。当前提示词占据主星系,本会话最近的 12 条历史各成为主盘外围的一颗伴星:方位取自该点在语义足迹图上的落点(mapX / mapY),颜色取它自己的色族,星等按新旧递减,最亮的几颗带十字星芒,每颗脚下是一小段轨道弧而非指向核心的射线。伴星以 angle * 0.8 * 0.86 同向缓行,略慢于主盘,读作外盘的较差自转。新提交时,上一条提示词才从主星系「退位」成伴星并淡入 1.1 秒;历史数据一个字节都没多存,HUD 左上角显示 CLUSTER n/12。减少动画时伴星静态显示、不淡入。

双生轮廓 —— 模型回答完成时,除了向内扫的亮度回波,还会把回答文本跑一次 analyze(),得到另一条 256 段亮度轮廓,与提问的轮廓做 1.8 秒 smoothstep 插值;配色在两套色族之间按 16 级量化混合(mixHex 结果缓存,不逐帧解析色值),HUD 右上显示 DUAL 54%,第一行标签变成 CRYO/IRIS。只改 profile、颜色与 magnitude;angle、缠绕、半径、透视一律不动。新提问到来时把插值基轮廓交给新问题、混合量再退回 0,所以不会闪回上一片星系。漫游播放时由漫游帧接管,回答被清空则平滑还原;减少动画直接落到终态,不做过渡。

星图卡片 —— 面板右下角的下载按钮把当前这一帧装裱成 1200 × 900 的 PNG。导出时先让画布以 2.5 倍 DPR 同步重绘一帧并复制进离屏画布,再叠上标题、星座编号、提示词原文、TOK / ENERGY / MAP / VEC / 配色 / 时间、取景框角标与「本地生成」水印,文件名带编号与时间戳。全程 canvas.toBlob → 本地下载,零依赖、零请求。画框用 contain 留白而不是拉满裁切,所以帧内的 HUD 文字也完整保留 —— 它本来就是那一帧的一部分。

外观

面板本身跟随 DSH 的浅色 / 深色外观:表面、文字、分隔线、输入控件与选中态都取自宿主的设计令牌(--dsw-alias-bg-layer-1、--dsw-alias-label-primary、--dsw-alias-border-l2 等),浅色是白玻璃、深色是深玻璃,自定义主题同样会被跟随。适配只用 CSS —— 宿主在 <body> 上挂 data-ds-dark-theme,插件读这个属性,既不订阅主题事件,也不会多触发一次渲染。

两块画布在两种外观下都保持深色:舷窗之外永远是太空,只有窗框换漆。星云的颜色仍由配色方案(深空 / 极光 / 日冕 / 银盐 / 超新星)决定,不被主题改写;后两套分别是去饱和的银盐黑白与金红爆发的超新星,前三套的映射保持原样,换口味不会重涂已有的语义足迹。

旋转与物理

画面遵循旋涡星系的两条基本约束,任何图层都不会反向自转:

  • 拖尾旋臂:angle 单调递增(屏幕上是顺时针),而旋臂的 theta 越往外越小(WIND = -4),外端永远比内端落后一个相位,所以臂是拖在旋转后面的尾迹。反过来说,若越往外 theta 越大,外端就会先于内端扫过任意一个方位角 —— 那是前导臂,等于让旋臂抢在自转前面跑。
  • 刚性图案 + 差速物质:作为密度波的整体图案以同一角速度刚性旋转;内圈细丝略快(angle * 1.12)、外圈浮尘略慢(angle * 0.25),体现「内快外慢」的差速旋转,又不会把旋臂越缠越紧。

为什么不选前导臂:真实旋涡星系(M51、M101 这些都算)几乎全是拖尾的。经典论证很直白 —— 差速旋转(内快外慢)会把一条径向辐条越剪越弯,剪出来的形状只有一个手性,就是拖尾;要得到前导臂得靠外部扰动,是 NGC 4622 那样的特例。所以拖尾同时也是「看起来最像星系」的那一手。

此前 iris / ember 两个族按 scheme.id 翻转方向、以逆时针自转与顺时针缠绕的旋臂对冲,而且漫游跨帧(mix 过 0.5)与切换配色时会瞬间反转角速度;现在 angle 是唯一的角速度来源,逐帧单调累加,方向不再依赖当前配色。缠绕方向也不再是分散在各处的一堆 t * 4,而是集中在 WIND 一个常量上,物理回归测试直接断言这个符号。

每个亮点会沿轨道方向留下一小段 尾迹(theta − 0.022),不看 HUD 也能读出拖尾方向;默认「完整动效」,若把动效切到「跟随系统」且系统要求减少动画,尾迹、视差、呼吸、流星、光点与涟漪全部关闭,颗粒也不再叠加,只保留约 1°/s 的缓慢自转 —— 不至于冻成静图,让人以为插件坏了。

这些氛围层刻意控制在「每帧最多几次额外绘制」:颗粒是一次图案填充、流星是一条渐变线、涟漪是两条圆弧、光点是四个精灵,实测 520 × 352 画布(DPR 2)仍稳定 60 fps。

设置

窗口右上角的齿轮打开设置面板:

设置 说明
启用输入语义可视化 总开关;关闭后立即休眠,不再采集任何提交
提交后自动展开 只在当前会话的新提交上触发一次
保存语义足迹 写入本机 localStorage,仅本设备可见
嵌入维度 8192 标准 / 16384 精细 / 32768 极致(只影响绘制多少细节,含臂间尘埃的填充量;不改变几何)
配色 深空 / 极光 / 日冕 / 银盐 / 超新星
动效 完整动效(默认)/ 跟随系统
转速 低 / 中(默认)/ 高

清空按钮需要点击两次确认。

转得太快 / 太慢

自转速度在 ⚙ 设置 → 转速 里分三档,默认「中」:

档位 大约速度 一圈
低 2.5°/s 约 140 秒
中 5°/s 约 70 秒
高 9.5°/s 约 37 秒

只改自转与旋臂推进,不改星云形状。移动鼠标时星云会轻微加速并跟着视差偏移,所以实测值会在标称值上下浮动。

想要更安静的画面

默认是「完整动效」。如果你(或这台机器)希望少动一点,选 ⚙ 设置 → 动效 → 「跟随系统」:系统开了「减少动画」(Windows:设置 → 辅助功能 → 视觉效果 → 动画效果)时,插件会退到约 1°/s 的缓慢漂移,并关掉视差、尾迹、流星、涟漪和颗粒。

反过来,如果系统开着「减少动画」但你希望星云照常转,把 动效 设为「完整动效」即可,不需要改系统设置,也不需要重启。

「播放」按钮是回放语义漫游序列的,不控制自转。

隐私与数据

  • 采集入口只有 提交:SessionSnapshot.pendingSubmissions 与 user/message 事件。
  • 不监听 onInput,不抓取输入框内容,不处理流式 token。
  • 持久化只保存:提示词原文、时间、以及本地生成的 256 段量化轮廓。
  • 所有计算都在浏览器本地完成,没有任何网络请求。
  • 导出卡片只把已采集的提示词与本地计算结果画进 PNG,由浏览器直接下载,不上传、不写服务端。

架构

src/
  index.ts              宿主侧:无副作用
  client/
    index.ts            客户端入口:挂载 body 级悬浮层
    controller.ts       提交捕获 / 会话绑定 / 可见性状态机
    store.ts            语义点存储、去重、localStorage 持久化
    engine.ts           本地确定性嵌入、序列帧与伴星轨道
    motion.ts          动效策略(完整 / 跟随系统)与转速档位
    canvas.ts           绘图工具、颜色混合、高分辨率抓帧事件
    exportCard.ts       离线星图卡片排版与 PNG 导出
    Panel.tsx           窗口内容(双视图 + 设置面板)
    NebulaCanvas.tsx    左侧星云(2D 加色混合、会话星群、双生轮廓)
    NebulaMap.tsx       右侧语义地图
    Floating.tsx        拖动 / 缩放 / 收起悬浮球
    styles.ts           乳白玻璃质感样式
scripts/
  build.mjs             esbuild 打包(CJS → lib/client.js)
  test-engine.mjs       嵌入不变量
  test-controller.mjs   控制器状态机
  test-companions.mjs   伴星轨道 / 颜色混合 / morph 前提
  verify-physics.mjs    离线物理回归:把真实组件挂到空白页,从画面反算运动

开发

pnpm install
pnpm build          # 产出 lib/index.js 与 lib/client.js
pnpm watch          # 增量构建
pnpm test           # 嵌入不变量 + 控制器状态机 + 伴星/morph 不变量

本地调试可以用 dev.patch.yml 直接指向构建产物,不需要安装(先把里面的 name 改成你本机 lib/index.js 的绝对路径):

dsh web --patch /path/to/dsh-spiral/dev.patch.yml --port 3081 --host 127.0.0.1 --no-open

需要本机 Playwright Chromium 才能跑视觉回归脚本(pnpm add -D playwright && npx playwright install chromium;若 Playwright 装在别处,用 PLAYWRIGHT_MODULE / CHROMIUM_PATH 指过去):

node scripts/verify-answer.mjs 'http://127.0.0.1:3081/?token=…'    # 回答漫游链路
node scripts/verify-render.mjs 'http://127.0.0.1:3081/?token=…'    # 面板渲染 + 旋臂计数
node scripts/verify-hmr.mjs    'http://127.0.0.1:3081/?token=…'    # 重建产物是否被宿主热感知

不用打开浏览器也能确认线上服务到底在跑哪份构建(/plugins/events 会广播插件图):

node scripts/check-live-bundle.mjs 'http://127.0.0.1:3080'

自转方向与旋臂缠绕是这套装饰的硬约束:改动角度系数或绘制顺序后,跑一遍离线物理回归即可(不需要 token,也不需要起服务——脚本把真实组件挂到空白页上渲染,再从画面里反算运动):

pnpm verify        # 自转方向 / 旋臂拖尾 / 指针视差 / 帧率
node scripts/verify-physics.mjs --reduced               # 减少动画下仍在缓慢自转
node scripts/verify-physics.mjs --reduced --motion=full  # 设置覆盖系统偏好
node scripts/verify-physics.mjs --speed=low             # 低速档实测
node scripts/verify-physics.mjs --speed=high            # 高速档实测

它按「整圈角向均值相关」量自转角速度、按「四阶角向谐波相位随半径的斜率」量旋臂缠绕,并断言两者同向(否则旋臂会读成迎风张开);最后再量一段帧率,确认氛围层没有吃掉帧预算。报告与截图写入 .shots/physics-report.json 与 .shots/physics-nebula.png。

已知取舍

原始设想中的 bge-small-zh-v1.5-int8.onnx 本地嵌入与预计算 UMAP 地形,在当前交付中简化为 确定性本地哈希嵌入 与 固定投影几何:不加载任何模型文件,因此语义精度有限,但零网络、零模型开销、体积约 160 KB(gzip 约 36 KB)。若之后需要更强的语义分组,可以在 engine.ts 中替换 analyze(),其余视图层无需改动。

License

MIT

—/ 5

No ratings yet

Verified DSH bundle

Commit 9ac47e427c24

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout