dsh-minigames
Manifest validAdd a mini-games box tab to the DSH right sidebar with Gomoku against an AI in three difficulties, a WeChat-style sky shooter and an underwater Flappy-whale game, with synthesized sounds and a victory
dsh-minigames · 游戏盒子
Listed in the Open Plugin Market
as a community plugin (index source: https://dshopen.org/index.json).
A mini-games box for the DSH Web right sidebar. It ships two games:
- Gomoku (五子棋) against the built-in AI in three difficulties; winning triggers a frame-wide celebration with confetti, fireworks and a trophy card.
- Sky battle (飞机大战) — a WeChat-style arcade shooter: drag your plane, dodge the descending enemies, auto-fire, chase a personal best.
- Chubby fish adventure (肥鱼大冒险) — an underwater Flappy-Bird style game where the DSH whale is the chubby fish: click or press Space to swim up through the coral gaps.
Install
Requires DSH 0.2.2-rc.1 or newer with the Web client (the right-sidebar plugin
seats). The plugin is not on npm yet, so pick one of these sources:
From the Open Plugin Market (recommended): open the market page and install there — the listing pins a reviewed Git commit: https://dshopen.org/zh/plugins/dsh-minigames/
From GitHub (Git URL):
dsh plugin --profile web add 'github:feiniao1933/dsh-minigames'
Pin a revision for a reproducible install (tag or commit):
dsh plugin --profile web add 'github:feiniao1933/dsh-minigames#v1.4.4'
dsh plugin --profile web add 'github:feiniao1933/dsh-minigames#<commit-sha>'
From the prebuilt tarball (no Git required): every release ships the packed plugin as an asset, so any HTTPS tarball URL works:
dsh plugin --profile web add 'https://github.com/feiniao1933/dsh-minigames/releases/download/v1.4.4/dsh-minigames-1.4.4.tgz'
Restart dsh web if the running page does not pick the new bundle up. The
plugin's row id is minigames-box; it can be disabled again with
dsh plugin --profile web remove dsh-minigames.
Version note: the market listing may lag behind this repository while a new version waits for review.
v1.4.4fixes a startup freeze in the third game; older pinned commits (e.g.v1.4.3) still have it.
Screenshots
The game box in the right sidebar (dark theme) with Gomoku: game shelf, difficulty selector, sound toggle, local tally, board, and the restart/undo controls.

Captures of the two arcade games and the victory celebration are still to come. The repository ships no mock-up images.
Where it lives
The plugin contributes one right-sidebar tab type and one Start-page capsule, so it behaves like the rest of the right sidebar rather than floating above it:
Two ways in, both backed by the same tab type:
- Composer toolbar (fastest): click the small board icon at the left of the composer tool row (next to the attach controls). It opens the right sidebar and the game box in one click, even when the panel is closed.
- Start page: open the right sidebar (the panel button in the conversation header), then on the Start page pick the 游戏盒子 / Mini games box capsule. If the panel is parked on another tab, the "+" control in its tab strip reopens the Start page.
The game opens as a tab in the right sidebar: a game shelf at the top (五子棋 / 飞机大战 / 肥鱼大冒险), the selected game below it, and "more games" placeholder row. Switching games keeps every game's state while the tab stays open.
Because it is a regular tab type, it can be split, floated or moved between panes with the sidebar's own controls, and it stays mounted while hidden.
Gomoku
- You play black and move first; the AI plays white.
- Difficulty is selectable in the page (
简单 / 普通 / 困难, default困难) and remembered inlocalStorage. It is a search ladder over one engine: easy = 2-ply, normal = 4-ply, hard = 6-ply; every level still takes its own wins and blocks an immediate loss. - Placement sounds are synthesized with the Web Audio API (a short wooden clack, slightly lower for white) — no audio assets. The speaker button in the page header mutes them and remembers the choice; a muted game also skips the victory chime.
- Click an intersection, or focus the board and use the arrow keys plus Enter.
- 重新开始 / New game starts over, 悔棋 / Undo takes back your last move and the AI reply. The difficulty switch applies from the AI's next move and keeps the current board.
- Progress is remembered: the board, move history, result and elapsed time
are saved to
localStorageafter every move, so closing the tab or reloading the page resumes the same game (a finished game reopens on its result, and a restart clears the save). A malformed save falls back to a fresh board. - The win/loss/draw tally is kept per browser in
localStorage. - Winning shows the victory layer: falling confetti, three firework bursts, a rotating golden halo, the trophy card with move/time stats, and Play again. It dismisses itself after a few seconds, on Escape, or on its own buttons. Reduced-motion preferences turn the animation off.
All UI copy is routed through the Client locale service (English and Chinese
dictionaries); every non-artwork colour is a --dsw-alias-* theme token, so the
page follows light/dark themes. The board wood, stones, trophy and confetti
palette are artwork colours.
Sky battle (飞机大战)
A compact remake of the classic WeChat airplane game, rendered on a <canvas>
inside the same right-sidebar page.
- Drag anywhere on the screen to move your plane (arrow keys / WASD work too); bullets fire automatically.
- Enemies descend in waves — small scouts, drifting fighters and slow heavy bombers with a health bar. Shooting one scores 10 / 35 / 120 points.
- Enemies shoot back: fighters fire a single aimed bullet every ~1.5–2.4 s; heavies fire a three-way spread every ~2–3 s. Their reload shortens as the run goes on. Dodge the warm-orange dots — the player hitbox against bullets is deliberately smaller than the plane.
- You have 3 lives; a collision or an enemy bullet costs one and grants
brief invulnerability. At zero lives the run ends and the best score is
kept in
localStorage. - A short pause overlay appears when you switch games or the tab is hidden; resume or restart from there. Mute silences arcade sound effects (including the enemy-fire blip) too.
Chubby fish adventure (肥鱼大冒险)
An underwater Flappy-Bird remake where the chubby fish is the DSH whale.
- Click / tap anywhere on the screen or press Space / ↑ / W to swim up; the whale sinks under gravity between taps. Arrow keys on the board work too.
- Swim through the gaps between coral columns; each gap passed scores one point and the current speed slowly increases. Touching a column or the seabed ends the run.
- The scene is underwater: light shafts, rising bubbles, a wavy seabed with seagrass, and a whale that drifts rather than darts — slower gravity, a softer flap, an eased nose tilt, an idle bob before you start and trailing wake bubbles behind the tail.
- Best score is kept in
localStorage; pause/resume, restart, auto-pause when the tab is hidden, and muted audio all work like the other arcade game.
Implementation
| File | Role |
|---|---|
package.json | Bundle manifest: dsh.bundle.patch plus the dsh.client web declaration. |
cordis.patch.yml | Inserts one Host entry (minigames-box). |
index.js | Host half; no Host behaviour, the Client module owns the rendering. |
src/engine.js | Pure Gomoku engine: board helpers, win detection, heuristic eval, negamax + iterative deepening with tactical checks and a time budget. |
src/plane.js | Pure sky-shooter simulation: fixed 540×600 world, seeded RNG, auto-fire, waves and enemy types, enemy aimed/spread fire, AABB collisions, particles, lives/score, pause/over phases. |
src/flappy.js | Pure chubby-fish (flappy) simulation: fixed 540×600 world, seeded RNG, gravity/flap physics, paired coral pipes, exactly-once scoring, bubbles, pause/over phases. |
src/ui.js | Client half: tab-type registration, Start capsule, tab title, composer-toolbar launcher, game shelf, Gomoku board + difficulty selector, GOMOKU AI loop, canvas games (sky battle incl. enemy bullets, underwater whale leap), synthesized audio, record + preference persistence, shell.overlay celebration. |
client.js | Generated single-file browser bundle (the loader can only serve one file per package). |
build.mjs | Concatenates src/engine.js + src/plane.js + src/flappy.js + src/ui.js into client.js inside one module-loader factory. |
locale/*.json | Plugin title/description shown by Plugin Manager and Settings (8 locales). |
icon.svg | Bundle artwork: a white game controller on a deep-blue tile. |
Registration path (public extension seats only):
ctx.sidebarRightTabs.register({ id: 'dsh-minigames', kind: 'minigames', title, guide })
ctx.slots.register({ name: 'sidebar.right.pane.tab', key: 'dsh-minigames' }, GameBoxBody)
ctx.slots.register({ name: 'sidebar.right.pane.tab.title', key: 'dsh-minigames' }, GameBoxTitle)
ctx.slots.register({ name: 'conversation.input.left', id: 'dsh-minigames-launcher' }, Launcher)
ctx.slots.register({ name: 'shell.overlay', id: 'dsh-minigames-celebration' }, CelebrationLayer)
Tested
- DSH
0.2.2-rc.1, macOS, Web client (dsh web). - Gomoku engine: 156 assertions; sky battle: 6400+ checks plus 31 enemy-fire checks; UI smoke test: registration + server-rendered page + celebration + win/lose/draw/undo state machine + arcade step/pause/input through the built bundle + Gomoku save/restore round-trips and corrupt-save fallbacks.
Privacy
The plugin makes no network requests and sends nothing anywhere. It stores only
these browser-local preferences in localStorage:
dsh.minigames.record.v1– Gomoku win/loss/draw tallydsh.minigames.difficulty.v1– selected Gomoku difficultydsh.minigames.sound.v1– sound on/offdsh.minigames.game.v1– last selected gamedsh.minigames.plane.best.v1– sky-shooter best scoredsh.minigames.gomoku.save.v1– Gomoku move list, result and elapsed time (removed when a fresh board is started)dsh.minigames.flappy.best.v1– chubby-fish best score
License
MIT © 2026 Poboy. See LICENSE.
Development
node build.mjs # rebuild client.js
node build.mjs --test # bundle with internals exposed, for smoke/ui.smoke.mjs
node test/engine.test.mjs # Gomoku engine unit + self-play tests
node test/plane.test.mjs # sky-shooter simulation tests
node test/plane-enemy-bullets.test.mjs # enemy fire, aimed shots, bullet damage
node test/flappy.test.mjs # flappy-whale physics, pipes, scoring
node smoke/ui.smoke.mjs # registration + SSR render + both games' state
smoke/ui.smoke.mjs needs React in a scratch directory (it is a browser
dependency of DSH, not of this package):
npm install --prefix /tmp/dsh-minigames-testdeps react@18.3.1 react-dom@18.3.1
Comments
Loading…
Similar plugins
Floating, browser-local whale arcade with three score games and ocean-themed Gomoku for breaks while waiting on the agent.
★ 0
↓ 68/wk
dsh plugin --profile web add dsh-whale-arcadeby huangxn29
A top-down arena shooter that opens as a full panel from a left sidebar entry in DeepSeek Harness.
★ 1
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-shooterby ZSeven-W
Describe a small game in one sentence, play it in the DeepSeek Harness sidebar, swap in AI art, export one HTML file.
★ 569
↓ 1.3k/wk
MIT
TypeScript
Nov 9, 2026
dsh plugin --profile web add @zseven-w/dsh-game-studioby Yuuyuko-uu
鱼搭子:桌面小鲸鱼挂件 + DSH 插件(语音送话、陪看字幕、游戏弹幕、截图)
★ 68
↓ 2.9k/wk
NOASSERTION
Python
Nov 16, 2026
dsh plugin --profile web add dsh-fish-buddyby casteadelqui
围棋模式 for DeepSeek Harness — a playable Go (Weiqi/Baduk) board tab, complete rules engine, five AI levels, and a tutor that plays with you.
★ 0
MIT
JavaScript
Oct 10, 2026
dsh plugin --profile web add dsh-go-modeby Gorkaseto
A lightweight, pixel-art companion plugin for DeepSeek Harness (DSH) that adds an animated whale pet above the input composer during new sessions.
★ 0
Apache-2.0
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-whale-pet