DeepSeek Harness 插件

fishcg/dsh-music

Star 数 ★ 0 分类 娱乐 收录于 2026-11-16

把 acgay 音乐站嵌入 DSH 侧边栏,支持搜索、全局迷你播放器;配置导入 token 后可把站点缺的曲目导入 acgay。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。

安装

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

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

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。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

该插件的 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

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。