从 DSH 会话打开的三维美式 8 球球台:9ft 比赛台,三段式摩擦物理让低杆、高杆与左右塞都是算出来的而非预设动画,按 WPA 规则与 AI 对手对局,画面与音效全部由代码生成。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:lizzkkafei/my-projects#path:/desktop-pool-plugin
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
一个以 DSH Web UI 插件 形式发行的三维美式 8 球台球桌:从任意会话的输入框左侧点「台球」进入全屏球台;点右上角「返回会话」或按 ⌥P 回到对话。

玩法
- 9ft 比赛台:2.54 × 1.27 m 标准台面、Ø57.15 mm 用球、六袋口按真实尺寸建模
- 真实杆法:低杆回拉、高杆跟进、左右塞吃库变线——都是三段式摩擦模型算出来的,不是预先写死的动画
- WPA 规则:开球、分组(全色 1-7 / 花色 9-15)、犯规判定、手中球、8 号球胜负
- AI 对手:枚举「目标球 × 袋口」的可行击球并评分,带难度误差,会做走位
- 全程序化音效:撞球、吃库、落袋、皮头、犯规、胜负全部用 Web Audio 实时合成,没有任何音频文件
- 胜利礼花:打进 8 号时满屏礼花与奖杯
操作
| 操作 | 说明 |
|---|---|
| 在台面上按住拖动 | 旋转瞄准(可转到任意角度) |
按住 Space |
蓄力,松开击球 |
| 单击台面 | 以当前力度直接击球 |
| 滚轮 | 微调力度 |
← → / A D |
瞄准粗调 0.10° |
Shift + ← → |
瞄准细调 0.01° |
, . |
超精调 0.001° |
| 拖动左下角白球 | 杆法(高杆 / 低杆 / 左右塞) |
| 点击台面 | 摆放母球(手中球时) |
T / 右键 |
切换俯视视角 |
G |
辅助线开关 |
R |
重开一局 |
F / Esc |
规则与操作说明 |
⌥P |
在会话里随时打开 / 收起球台 |
安装
市场收录后可在 设置 → 插件 → 插件市场 搜索 zhizhen-pool 一键安装;也可以从源码装:
dsh plugin --profile <profile> add github:lizzkkafei/my-projects#path:/desktop-pool-plugin
装完刷新 DSH 页面(⌘R)即可在会话输入框左侧看到「台球」按钮。
实现
- 单文件 Client bundle(
client.js,由scripts/build.mjs生成),通过conversation.input.left注册入口、shell.overlay注册全屏球台 - 游戏本体跑在 shadow root 里:样式和元素 id 不会污染 DSH 界面
- 关闭覆盖层时会回收:所有
requestAnimationFrame、窗口监听器、AudioContext - 物理常数取自
pooltool与tailuge/billiards的实测值(Han 2005 / Mathavan 2007 碰撞模型)
自检
node scripts/check.mjs # 包结构检查(插件管理器与市场 CI 看的东西)
cd game && node selftest.mjs # 26 项物理/规则断言
cd game && node gametest.mjs 10 # 10 局 AI 自动对战
链接
同类插件
PC2005-cloud/dsh-pet#dsh-pet★ 6367
DSH Web UI 桌面宠物,Windows / macOS / Linux 三端可用:浏览器浮层或透明置顶桌面窗口,106 个透明动画、带挤压与粒子的甩抛反弹物理、随会话事件实时联动的工作状态气泡、碎碎念与带持久记忆的对话、余额展示、表情包配图、多开同屏,并支持直接放入的自定义动画与宠物种类(pet pack)。
flizzywine/dsh-tavern#dsh-tavern★ 1636
基于 DeepSeek Harness 的 Agent 酒馆,兼容 SillyTavern 生态,人物卡导入即玩,支持多种模型和手机游玩。桌面端从「设置 → 酒馆启动器」安装酒馆。 基于 2NF/dsh-profile-bridge(MIT)改造的启动器:把酒馆下载到独立 DSH 配置并在重启时切换。与上游插件不能同装——两者都占用 /profile-bridge 通道。
Alterssss/dsh-bili-whale★ 1062
一条按自己作息过日子的 B 站插件:宿主里每 60 秒一次心跳,在设定的作息窗口里随机挑一个时刻叫醒专用会话(今天不想看是按概率跳过),再交给自带的 38 个子命令——信息流、字幕、弹幕、评论、ffmpeg 抽帧、两本日记。每天最多发 N 条评论/动态并 @ 主人(默认 3,按配额账本计数,撞到限流或验证码就停手)。同时轮询评论回复、私信和直播间弹幕;除主人以外的回复先入队,等主人在设置页批准。设置 → 养鱼 写 ~/.dsh/bili-whale.config.json;cookie 单独在 ~/.bili-ai/credentials.json,只写不回显。HTTP 路由只认回环地址并过 DSH 信任栅栏。抽帧需要 Node 18+ 与 ffmpeg。
Nagi-ovo/dsh-ads★ 728
2005 年中文站点风格的整活广告插件:侧栏广告/信息流/角落弹窗 + 假关闭叉,素材全虚构。
yyh-001/dsh-meme★ 581
聊天表情包:纯文本斗图、情绪主动发图、像 QQ/微信 一样发图、AI 自动学图、自定义表情包。
vlln/whale-girl★ 409
桌面宠物(QQ 宠物形态):右下角悬浮、可拖拽/投喂/玩耍。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。