Mark-SmallCharlie / dsh-screen-roach

dsh-screen-roach 🪳

让一只写实的蟑螂在 DeepSeek Harness (DSH) 的网页界面上四处爬行的动态 Cordis 插件。

纯 Client 端、零依赖：JavaScript + SVG + SMIL 动画 + CSS。加载后蟑螂会在叠加层上随机游走，不挡操作。

效果

• SVG 手绘的写实蟑螂：红棕光泽翅膀、盾状前胸背板、两根长触角、6 条带节的腿、尾部尾须。
• 腿与触角持续摆动、身体轻微起伏（SMIL 动画）。
• 模拟随机游走：碰壁掉头、随机变速变向。
• 点击蟑螂会把它「吓跑」——瞬间加速窜向随机方向，再慢慢恢复。

目录结构

dsh-screen-roach/
├── client.js     # 插件源码（Client 端函数体，可直接粘贴使用）
├── README.md
└── LICENSE

安装 / 运行

本插件是一个 DSH 动态 Cordis 插件，需要在 DSH 运行时里定义并激活。

方式 A：通过 DSH Web GUI（推荐）

1. 打开 DSH Web GUI，让 Agent 创建插件，或直接使用动态插件工具。
2. 把 client.js 的整个内容作为 code.client 传给 cordis_define（定义插件）。
3. 用返回的 pluginId / packageId 调用 cordis_run 激活。

激活后页面会出现批准请求，批准即开始运行。

方式 B：把源码交给 Agent

直接把本仓库的 client.js 内容粘贴给 DSH，让它用 cordis_define + cordis_run 加载。

交互

操作	效果
自动	蟑螂在屏幕上随机爬行
单击蟑螂	把它吓跑（散射）

卸载

• 临时停用：cordis_stop（保留版本，可随时重启）。
• 永久删除：cordis_undefine。

原理

• Slot：shell.overlay（帧级悬浮层，默认点击穿透，只有蟑螂本体可点击）。
• 位置动画：ctx.interval（timer 服务）以约 16ms 步进更新坐标，碰壁反弹 + 随机转向。
• 肢体动画：SVG <animateTransform>（SMIL）让腿做对角步态摆动、触角摆动；CSS @keyframes 做身体起伏。
• 无第三方依赖，全部使用 DSH Client 端提供的 React / styles / slots / timer 能力。

已知限制

• 动画帧率基于 ctx.interval（约 60fps），后台标签页可能被浏览器节流。
• 由于叠加层定位为 position: fixed，在存在 transform 祖先容器的特殊布局下可能出现定位偏差。

License

MIT