Skip to content
Back to search

dsh-shiori-shore

Bilibili hands for DeepSeek Harness: 59 tools through a self-contained Python MCP server. MIT.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lh1314-china--dsh-shiori-shore/badge.svg)](/listings/lh1314-china--dsh-shiori-shore)

HTML

<a href="/listings/lh1314-china--dsh-shiori-shore"><img src="/api/listings/lh1314-china--dsh-shiori-shore/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# npm
dsh plugin --profile desktop add dsh-shiori-shore

# 或直接装 GitHub 仓库
dsh plugin --profile desktop add github:Lh1314-China/dsh-shiori-shore

装完**重启 DSH**(app 只在启动时读 profile,热加载不生效)。 工具出现后先调一次 `shore_check_credential` 验登录。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 103 lines
  1. # 汐岸 · dsh-shiori-shore
  2. 给 DeepSeek Harness 的 **B 站手**:内置一个 Python MCP 子进程,把 B 站的常用操作
  3. 注册成 `shore_*` 工具(**59 个**:52 个基础 + 6 个监听 + 1 个取帧)。
  4. Python 侧**原创实现**:HTTP 用标准库,WBI 签名、cookie、412 退避、弹幕解压都是自写的;
  5. 运行时依赖只有 `mcp`,**不依赖** `bilibili-api-python`(GPL),也不包含第三方代码。
  6. > 设计取向:**无信任闸**——不要求理由、不限制额度、不限制收件人、不强制 @ 谁。
  7. > 它是一双手,不是审批流。代价是账号权限很高,见文末「已知限制」。
  8. ## 前提
  9. | 需要 | 说明 |
  10. |---|---|
  11. | Node **≥ 22** | 插件宿主侧 |
  12. | DSH **≥ 0.2.1-rc.2** | 见 `dsh.compatibility` |
  13. | Python **≥ 3.10** + `mcp` | `pip install -r python/requirements.txt` |
  14. | `ffmpeg`(可选) | 只有 `shore_frames` 取视频画面时需要(`SHORE_FFMPEG` 或 PATH) |
  15. Python 解释器怎么找:`pythonPath` 显式配了就用它;留默认 `python` 时依次探测
  16. `SHORE_PYTHON` → `python` → `py -3` → `python3`。找不到能 `import mcp` 的解释器时,
  17. 插件照常加载,只是没有工具(日志里写明原因)。
  18. ## 安装
  19. ```powershell
  20. # npm
  21. dsh plugin --profile desktop add dsh-shiori-shore
  22. # 或直接装 GitHub 仓库
  23. dsh plugin --profile desktop add github:Lh1314-China/dsh-shiori-shore
  24. ```
  25. 装完**重启 DSH**(app 只在启动时读 profile,热加载不生效)。
  26. 工具出现后先调一次 `shore_check_credential` 验登录。
  27. ## 配置
  28. 设置页可改,或在 profile 的 `cordis.patch.yml` 里覆盖:
  29. | 键 | 默认 | 含义 |
  30. |---|---|---|
  31. | `enabled` | `true` | 总开关 |
  32. | `pythonPath` | `python` | Python 解释器;空/默认则自动探测 |
  33. | `dataDir` | `''` | 数据目录;空 = `~/.dsh/shiori-shore` |
  34. | `toolPrefix` | `shore_` | 工具名前缀 |
  35. | `toolsAllow` | `[]` | 只放开部分工具;空 = 全部 |
  36. | `startupTimeoutMs` | `60000` | MCP 子进程启动超时 |
  37. | `ledger` | `true` | 本地账本(工具调用流水) |
  38. | `wakeEnabled` | `false` | 新消息唤醒:有私信/AT/回复才叫醒模型 |
  39. | `wakeSessionId` | `''` | 唤醒投递到哪个会话 |
  40. | `wakeIntervalSec` | `45` | 轮询间隔 |
  41. ## 凭证与数据
  42. - 登录:`shore_login` 出二维码 → `shore_login_check` 确认。凭证写到
  43. `<dataDir>/bili_credential.json`(你自己的账号,**不随包分发、不上传**)。
  44. - 数据目录默认 `~/.dsh/shiori-shore`:账本、本地凭证副本、取帧缓存都在这里。
  45. - 删掉这个目录只是丢账本和本地副本,不影响 DSH 启动。
  46. ## 工具
  47. - **52 个基础工具**:视频/用户/评论/私信/动态/收藏/关注/投币等(见 `test/schemas.json`)
  48. - **6 个监听工具**:`shore_inbox_pending` 等,只读队列、不自动发
  49. - **1 个取帧工具**:`shore_frames` —— 取 B 站视频真实画面(需要 ffmpeg)
  50. ⚠️ 无闸意味着这些工具能对你的账号做真实操作;装之前想清楚谁能使唤它。
  51. ## 冒烟测试
  52. ```powershell
  53. $env:SHORE_PYTHON = "<你的 venv>\Scripts\python.exe"
  54. node test/smoke.mjs
  55. ```
  56. 期望:工具数 52,`shore_check_credential` 返回 `logged_in: true`,最后一行 `SMOKE OK`。
  57. ## 回滚
  58. 1. `dsh plugin --profile desktop remove dsh-shiori-shore`(或从 `dsh.profile.bundles` 删掉)。
  59. 2. 重启 DSH,`shore_*` 工具消失。
  60. 3. 数据目录可保留;删了只丢账本与本地凭证副本。
  61. ## 已知限制
  62. - **只在启动时读 profile**:装完或改配置必须重启 DSH。
  63. - **登录二维码**会往 `python/` 写 `qrcode_login.png`;插件目录只读时会失败——
  64. 把 `dataDir` 指到可写目录,或先把凭证放进 `<dataDir>/bili_credential.json`。
  65. - **平台风控不归我们管**:-352 / -412 / 禁言 / 弹幕 20 字 / 投稿实名 / 每日投币关注上限,
  66. 都是 B 站侧限制,撞上就退,别硬刚。
  67. - **`BILI_MCP_TOOLS` 会被插件清空**:父进程带这个白名单会裁工具;插件置空 = 全放。
  68. - **无闸不等于无边界**:改密码、换绑、实名、注销、大额消费、删视频这类不可回滚操作,
  69. 建议不要交给自动流程。
  70. ## 来源与许可
  71. - 本包 **MIT**,见 [LICENSE](./LICENSE)。
  72. - 宿主侧两个文件来自 MIT 项目:`lib/hostdeps.mjs` 与 `lib/mcp.mjs`
  73. (`dsh-bili-pond` / `dsh-bili-scroll`,Copyright (c) 2026 YOYOLnFu and
  74. dsh-bili-duty contributors)。署名与完整许可见 [NOTICE.md](./NOTICE.md) 与
  75. [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md)。
  76. - `python/` 侧为原创实现,不含第三方代码,也不依赖 GPL 的 `bilibili-api-python`。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.