- Home
- Plugins
- Just for Fun
- dsh-music
dsh-music
fishcg/dsh-music
Embeds the acgay music site as a DSH side panel with search, a global mini player, and optional import of missing tracks into acgay when an import token is configured. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Install
dsh plugin --profile web add github:fishcg/dsh-musicREADME
dsh-music
A DeepSeek Harness (DSH) plugin that embeds the online acgay.cn music site in a right-side drawer, with an optional import path for missing tracks.
Features
- A small vinyl button in the DSH top-right corner opens a right drawer.
- The drawer preloads behind the scenes and keeps its iframe mounted, so reopening is instant and the acgay login session is preserved.
- The site header, footer and bottom navigation are hidden inside the drawer. Login is available at the top of the drawer.
- Search queries acgay and an online catalog in parallel; acgay results are always listed first.
- Online catalog rows can be imported into acgay, where they are published immediately (
status = 1). - A compact top player controls play/pause, previous/next, progress, and shows the current cover/title.
- The drawer and the surrounding workspace animate open/closed. Clicking outside closes it;
Escalso closes it.
Requirements
- DSH desktop with the profile patched to load this package.
ffmpegandffprobeonPATHfor imports. Search and playback do not need ffmpeg.- Node.js 20+ (the DSH runtime is normally sufficient).
Install
Add the package to the DSH profile and patch the profile:
// ~/.dsh/profiles/desktop/package.json
{
"dependencies": {
"dsh-music": "link:/absolute/path/to/dsh-music"
},
"dsh": {
"profile": {
"bundles": ["dsh-music"]
}
}
}
# ~/.dsh/profiles/desktop/cordis.patch.yml
- insert:
- id: dsh-music
name: 'dsh-music'
Reload DSH after adding the package. If the client half does not appear on an already-running app, restart DSH once.
Import credential (optional)
Import is disabled when no credential is configured. Search, playback, login, and the mini player still work.
The host resolves the token in this order:
ACGAY_IMPORT_TOKENenvironment variable.config.importToken/config.tokenin the plugin row.ACGAY_IMPORT_TOKEN_FILEenvironment variable (path to a file).~/.acgay-import-token.~/.dsh/profiles/desktop/acgay-import-token(legacy location).
The file contains the raw token, one line. Import is enabled when a non-empty token is found.
When no token is set:
/dsh-music/statereturnsimports: false.- Per-row import buttons and the “抓取并入库” action are hidden.
- A direct POST to
/dsh-music/importreturns HTTP 503.
Do not commit the token. It is a shared write credential for the acgay import endpoint.
Optional environment variables
| Variable | Default | Purpose |
|---|---|---|
ACGAY_BASE_URL | https://www.acgay.cn | Upstream site used by the proxy and the importer. |
ACGAY_IMPORT_TOKEN | unset | Enables import. |
ACGAY_IMPORT_TOKEN_FILE | unset | Read the token from a custom path. |
ACGAY_FFMPEG | ffmpeg | ffmpeg executable. |
ACGAY_FFPROBE | ffprobe | ffprobe executable. |
DSH_ACGAY_NODE_BIN | process.execPath | Node executable used for the import worker. |
How import works
- The client asks acgay for online catalog candidates along with the normal site search.
- Clicking “导入”, or “抓取并入库”, calls the plugin host route
POST /dsh-music/importwith{ query }; a catalog item id may be sent instead. - The host starts
scripts/import-one.mjsas a short-lived child process. scripts/import-direct.mjsselects one candidate, downloads it, converts it to 192 kbps mp3 with ffmpeg, and POSTs a multipart request to acgay’s/api/plugin/importwith the token.- acgay writes the audio/cover to OSS, inserts a published
lab_musicrow and anlab_import_logrow, and returns the production id. The drawer navigates to/sound/{id}.
Nothing is written to a local MySQL database or local OSS client.
Security notes
- The shared import token grants upload + auto-publish permission. Never ship it in a public repository or client bundle.
- The embedded acgay login session is kept in
~/.dsh/dsh-music-cookies.json(mode 0600) by the loopback proxy, so a DSH restart does not force a new acgay login. It contains a session cookie, not a password. Delete the file to drop the saved session locally; the acgay session expiry still applies server-side. - A shared token should only be used in a trusted self-hosted setup. For multi-user deployments, use per-user tokens or a rate-limited endpoint.
- The plugin performs no database, OSS, or catalog account authentication itself; all privileged writes happen in the acgay server endpoint.
Development
index.js: DSH host half; proxy, state, import route.client.js: DSH web client half; vinyl button, drawer, search panel, mini player.assets/bridge.js: injected into proxied pages; forwardswindow.__ACGAY_PLAYER__state and commands.scripts/import-direct.ts: source for the importer.scripts/import-direct.mjs: runtime bundle (generated from the TS source).scripts/lib/*.ts/*.mjs: vendored catalog client used by the importer.
License
MIT
Related plugins
dsh-web-ui (dsh-pet)
zhu1090093659/dsh-web-ui
dsh-pet (dsh-pet)
pc2005-cloud/dsh-pet
dsh-tavern (dsh-tavern)
flizzywine/dsh-tavern
dsh-tavern (dsh-profile-bridge)
flizzywine/dsh-tavern