手性脉冲 MoonShadow1976/chiral-pulse

CHIRAL PULSE · 手性脉冲

npm
GitHub Release

Death Stranding 皮肤 + BB 生命体征监护仪，挂在 DeepSeek Harness Web 界面。

- 全局皮肤——整个界面都是死亡搁浅：暗色 DS 蓝黑机身 + 琥珀发丝线，亮色冥滩白变体；全屏扫描线、手性晶格、四角渐晕氛围层（全部 pointer-transparent，不挡操作）；DeepSeek 鲸鱼品牌蓝原样保留。
- 心跳走纸——输入区上方一条 26px 监护仪走纸：滚动 ECG 波形是主角，BPM 实时跟随 Agent 活动（思考 +38、工具执行 +52、回合进行 +10、空闲回落至 42）。数据全部来自会话快照，不重复 StatsLine 已有的 turns/tokens。

CHIRAL PULSE

如果你是本地源码运行 DSH（pnpm dsh web），下面所有命令都把开头 dsh 替换成 pnpm dsh 执行。

安装

发布版（推荐）：

dsh plugin --profile web add chiral-pulse

包内声明了 dsh.bundle（cordis.patch.yml roster 行）与 dsh.client（浏览器半边），安装后自动进入 profile 的 bundle 层，无需手写配置。

旧写法 dsh plugin --profile web chiral-pulse（无 add）一并保留。

也可以直接从 GitHub 装：

dsh plugin --profile web add github:MoonShadow1976/chiral-pulse

仓库里提交了构建产物 lib/（见 lib/ 为什么要进版本库），所以 git 直装能拿到 package.json 声明的入口。想锁版本就加分支出处的后缀，例如 github:MoonShadow1976/chiral-pulse#v1.3.3。

本地开发安装

把包链接进 profile 的 node_modules，再在 $DSH_HOME/profiles/web/cordis.patch.yml 追加一行：

- insert:
- id: ui-chiral-pulse
name: 'chiral-pulse'

New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\chiral-pulse" -Target "D:\path\to\chiral-pulse"

用户 patch 层热加载：无需重启 dsh web，刷新浏览器页面即可生效。

更新

dsh plugin --profile web update chiral-pulse

卸载

dsh plugin --profile web remove chiral-pulse

本地开发安装则移除 patch 行与 junction。

构建

pnpm bundle # tsdown → lib/index.js + lib/client.js
pnpm typecheck # tsc --noEmit
pnpm test # bundle + node --test tests/.test.cjs

lib/ 为什么要进版本库

lib/ 是构建产物，但它必须跟着源码一起提交。

DSH 装插件走的是包管理器的 git 依赖（dsh plugin --profile web add github:...），pnpm 把仓库原样取下来就结束，不会执行任何构建脚本。而 package.json 的 main 与 exports["./client"] 指向 lib/index.js 和 lib/client.js —— 这两个文件不在版本库里，装出来的包就既没有宿主入口也没有浏览器半边：宿主行照样挂在 cordis 树里（空 apply，不报错），浏览器端却永远不会注册心跳走纸，现象就是“装成功了但界面上什么都没有”。

构建产物约 102 KB（client.js + client.js.map + index.js），所以直接提交是划算的：git 直装与 npm 安装从此等价。修订产物时永远改 src/ 再跑 pnpm bundle，不要手改 lib/；CI（.github/workflows/ci.yml）会重新构建并比对提交内容，不一致就失败。

工作原理

- 主题：ui-theme 设计平台里只重映射 body[data-ds-dark-theme] / body:not([data-ds-dark-theme]) 两套静态色，全应用自动跟随；brand 蓝（鲸鱼）刻意不动；
- 数据：useProjection('sessionStats') 提供活动窗口，useSession 快照驱动 BPM 加成，波形由纯函数 ECG 合成器（src/client/ecg.ts）生成；
- 渲染：单 每帧直绘，erase-bar 扫掠 + 冻结像素缓存，帧率无关、零 DOM 抖动。

发布

打 tag（v..）→ GitHub Actions 自动构建、发布 npm 并创建 GitHub Release。

打 tag 前先在 main 上跑 pnpm bundle 并提交 lib/：release job 会重新构建并与该 tag 里提交的产物比对，不一致直接失败，避免 tag 的源码与它自己的入口文件不一致。

社区与支持
- 反馈与 bug 报告：GitHub Discussions。
- 本仓库已打上 dsh-plugin 话题，可在同话题下被发现。

许可证

MIT