CHIRAL PULSE · 手性脉冲

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

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

如果你是本地源码运行 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)生成;
• 渲染:单 <canvas> 每帧直绘,erase-bar 扫掠 + 冻结像素缓存,帧率无关、零 DOM 抖动。

发布

打 tag(v*.*.*)→ GitHub Actions 自动构建、发布 npm 并创建 GitHub Release。

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

社区与支持

• 反馈与 bug 报告:GitHub Discussions。
• 本仓库已打上 dsh-plugin 话题,可在同话题下被发现。

License

MIT