PixLunaLab/dsh-pixluna

dsh-plugin-pixluna | 让 DSH 自己看涩图!

Project Overview项目介绍

dsh-pixluna is a Cordis plugin that ports PixLuna's image retrieval into DeepSeek Harness. It registers three model-callable tools, pixluna_get, pixluna_get_pixiv, and pixluna_sources, so DSH models can fetch images by count, tag, or Pixiv PID. Config covers default providers, R18 probability, AI exclusion, proxy, concurrency, Pixiv cookies, and booru keyPairs, editable via the built-in plugin settings card. Use it when a DSH session needs direct, tool-based image lookup. Tools only return remote URLs to keep binary data out of session logs, and R18 requires both plugin-level isR18=true and tool-level opt-in.

dsh-pixluna 是将 PixLuna 图片获取能力移植为 DeepSeek Harness 的 Cordis 插件。它向 DSH 注册 pixluna_getpixluna_get_pixivpixluna_sources 三个模型可调用的工具,支持按数量、标签、PID 检索图片,并可在配置中切换默认图源、排除 AI 作品、设置 R18 概率与代理。适用于让 DSH 模型直接调用工具获取图片。工具仅返回远程 URL,避免大体积二进制进入会话日志。R18 内容需插件级 isR18=true 与工具参数同时启用。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-pixluna

PixLunaLab/dsh-pixluna 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-pixluna

让 DSH 自己看涩图!

PixLuna 的图片获取能力移植为 DeepSeek Harness(DSH)Cordis 插件。插件不再注册聊天命令,而是注册模型可调用的工具;原命令选项均转换为具名工具参数。

工具映射

原 PixLuna command DSH tool 参数
pixluna pixluna_get number, source, tag, r18
pixluna.get.pixiv <pid> pixluna_get_pixiv pid, pages, all
pixluna.source pixluna_sources

开发

yarn install
yarn lint
yarn build

安装到 DSH profile

开发目录可直接作为带 dsh.bundle 清单的本地 profile layer 安装(web 可替换为目标 profile):

dsh plugin --profile web add dsh-pixluna

dsh plugin 会把本包加入 profile 的 dsh.profile.bundles,并自动应用包内 cordis.patch.yml。默认配置使用 lolicon 且关闭 R18;如需覆盖配置,可在该 profile 的用户 cordis.patch.yml 中按稳定 row id pixluna 覆盖整份配置:

- id: pixluna
  name: dsh-pixluna
  config:
    defaultSourceProvider:
      - lolicon
    isR18: false
    pixiv:
      phpSESSID: ''
      userId: ''

注意 DSH patch 对 config 是整项替换而非深度合并。插件声明 inject = ['tools'],Cordis 会在 @deepseek-ai/dsh-tools 服务可用后激活它。

插件同时将 Config 注册为 pixluna 用户设置命名空间,并向 DSH 自带的“设置 → 插件 → 插件配置”注册配置卡片。全部配置均可在卡片中设置;常规字段写入 DSH settings,Pixiv Cookie 和各图源 keyPairs 则参照模型 API Key 的做法写入 DSH credentials,只向浏览器返回“已配置/未配置”状态。修改会实时作用于后续工具调用。

主要配置

  • defaultSourceProvider: 默认图源数组。
  • isR18 / r18P: 是否允许 R18 及随机请求概率。
  • excludeAI: 向支持该选项的图源请求排除 AI 作品。
  • isProxy / proxyHost: 为 HTTP 请求启用代理。
  • baseUrl: Pixiv 图片反代域名,默认 i.pixiv.re
  • maxConcurrency: 单次 pixluna_get 的并发上限,1–10。
  • apiDelay: 各请求批次之间的延迟。
  • pixiv.phpSESSID: Pixiv Discovery、Following 和按 PID 获取所需凭据。
  • 各 booru 的 keyPairs: 可选或必需的图源凭据。

与原项目的差异

  • 移除了 Koishi Context.http、消息发送、@ 用户、转发消息、自动撤回和 Koishi h 元素依赖。
  • 使用 undici 发起可取消请求,并转发 DSH ToolRunContext.signal
  • 图片处理(翻转、混淆、压缩)未带入 DSH 工具输出;工具返回远程图片 URL,避免把大体积二进制数据写入会话日志。
  • R18 请求须同时满足插件级 isR18=true 与工具参数/概率选择。

许可证沿用原 PixLuna 的 MPL-2.0。

上一个 Prev dsh-usage-dashboard 下一个 Next deepseek-desk-rsi