DeepSeek Harness Plugin

fishcg/dsh-music

Stars ★ 0 Category Just for Fun Added 2026-11-16

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

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:fishcg/dsh-music

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

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; Esc also closes it.

Requirements

  • DSH desktop with the profile patched to load this package.
  • ffmpeg and ffprobe on PATH for 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:

  1. ACGAY_IMPORT_TOKEN environment variable.
  2. config.importToken / config.token in the plugin row.
  3. ACGAY_IMPORT_TOKEN_FILE environment variable (path to a file).
  4. ~/.acgay-import-token.
  5. ~/.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/state returns imports: false.
  • Per-row import buttons and the “抓取并入库” action are hidden.
  • A direct POST to /dsh-music/import returns 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

  1. The client asks acgay for online catalog candidates along with the normal site search.
  2. Clicking “导入”, or “抓取并入库”, calls the plugin host route POST /dsh-music/import with { query }; a catalog item id may be sent instead.
  3. The host starts scripts/import-one.mjs as a short-lived child process.
  4. scripts/import-direct.mjs selects one candidate, downloads it, converts it to 192 kbps mp3 with ffmpeg, and POSTs a multipart request to acgay’s /api/plugin/import with the token.
  5. acgay writes the audio/cover to OSS, inserts a published lab_music row and an lab_import_log row, 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; forwards window.__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

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.