dsh-music
Manifest validEmbeds 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 acce
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
Comments
Loading…
Similar plugins
DeepSeek Harness Web 本地音乐播放器插件:会话视图「音乐」标签页,flac/mp3 等常见格式,单曲/列表循环,macOS Music 风格 UI
★ 2
MIT
JavaScript
dsh plugin --profile web add @heshuren/dsh-music-playerby xiaoqiezi-china
为Deepseek-Harness开发的音乐播放插件。允许用户播放本地与网易云音乐。支持通过Cookie解锁VIP歌曲。提供了丰富全面的skill允许Agent控制音乐播放,自定义播放器CSS层叠样式表。允许队列结束后自动通知AI来挑选新的歌曲。
★ 0
↓ 244/wk
MIT
JavaScript
Aug 15, 2026
dsh plugin --profile web add dsh-music-playerby hey-ruomei
DeepSeek Harness music player plugin: search and stream legal music from Audius in the web UI, controllable by agent tools.
★ 0
MIT
TypeScript
Aug 19, 2026
dsh plugin --profile web add dsh-music-playerby xiekai886
这是一个可以让你边对话边听歌的 DeepSeek Harness 插件:折叠/展开两种可自由拖动的悬浮窗口形态,利用 Meting API 等解析源接入网易云音乐,支持歌单导入和按歌名或歌手搜索单曲导入。Chat and listen at the same time.
★ 4
MIT
JavaScript
Aug 16, 2026
dsh plugin --profile web add @dsh-external/dsh-musicby wilsonchengassistant
Plays video and audio files in the right Sidebar preview pane, streamed over an authenticated HTTP Range route so a remote browser can play and seek a large file without launching a native player on t
★ 0
MIT
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-media-web-previewby AKS1st
Media player for the DSH dock: plays audio (music player) and video (fullscreen) files, streamed over HTTP Range.
★ 0
MIT
TypeScript
Sep 11, 2026
dsh plugin --profile web add dock-media