PixLunaLab/dsh-pixluna

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

Project Overview项目介绍

dsh-pixluna is a native Cordis plugin built exclusively for DeepSeek Harness (DSH). It ports the image fetching functionality from the independent PixLuna project into DSH as model-callable tools, converting original PixLuna commands into named DSH tool parameters. To install the development version, you can run the dsh plugin --profile <target-profile> add dsh-pixluna command in your terminal, which adds the plugin to your DSH profile and applies the included patch configuration automatically. The plugin registers three tools: pixluna_get for general image search, pixluna_get_pixiv for fetching by Pixiv ID, and pixluna_sources to list all available image sources.

This plugin is designed for DSH users who want to fetch images from multiple popular sources directly within their DSH conversation. After installation, users can call the tools through DSH's native tool calling system without needing to memorize chat commands. All original command options are exposed as named tool parameters, so users can specify tags, R18 settings, image sources, and other filters to get exactly the type of images they need. If you have a Pixiv account, you can add your PHPSESSID credential to access restricted Pixiv content right from DSH.

All configuration can be done through the DSH settings UI via the plugin's dedicated config card, no manual YAML editing is required for basic use. Sensitive credentials like Pixiv PHPSESSID and source API keys are stored in DSH's secure credential storage, only a configured/unconfigured status is returned to the browser. The plugin uses the MPL-2.0 license inherited from the original PixLuna project, and requires yarn for local development. To build from source, you run yarn install, yarn lint, and yarn build in sequence before installing to your DSH profile. Any changes to configuration take effect immediately for subsequent tool calls.

dsh-pixluna 是专为 DeepSeek Harness(DSH)开发的原生 Cordis 插件,它将开源项目 PixLuna 的图片获取能力移植为 DSH 大语言模型可调用的工具,把原 PixLuna 的命令转换为带命名参数的 DSH 工具,支持按标签、图源、R18 等级获取图片,也支持按 PID 获取 Pixiv 图片和列出所有可用图源。

该插件面向需要在 DSH 会话中获取指定图源图片的用户,安装完成后即可在 DSH 对话中调用工具获取符合要求的图片。用户可指定获取图片数量、标签、图源,按需开启 R18 内容获取,也可直接通过 Pixiv 作品 ID 获取指定图片,配置好凭据后还能访问 Pixiv 受限内容。

该插件遵循原 PixLuna 项目的 MPL-2.0 开源许可证,开发需要使用 yarn 完成依赖安装、代码检查和项目构建,开发版本可直接作为本地层级安装到目标 DSH profile。插件配置可通过 DSH 设置页面的插件配置卡片完成,敏感凭据会存储在 DSH 凭证区,仅返回配置状态,不会暴露敏感信息。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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-analytics 下一个 Next dsh-canvas →