PixLunaLab/dsh-pixluna
30Last commit Aug 15, 2026
dsh-pixluna DSH plugin
This plugin ports PixLuna's image fetching as a DSH Cordis plugin. It registers tools like `pixluna_get`, `pixluna_get_pixiv`, and `pixluna_sources` for model invocation. Configuration is exposed via DSH settings and credentials, supporting multiple image sources, R18 control, and Pixiv integration.
How to install the dsh-pixluna DSH plugin
dsh plugin --profile web add dsh-pixlunaCopying does not run this command. Review the repository and version before installing the dsh-pixluna DSH plugin.
dsh-pixluna DSH plugin data source
dsh-pixluna DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-pixluna DSH plugin can do
- Fetch random images from configurable sources (e.g. lolicon, boorus) with tags, count, and R18 filter.
- Retrieve specific Pixiv artworks by PID with page selection.
- List available image sources via `pixluna_sources` tool.
- Support proxy, Pixiv reverse proxy domain, and concurrency limits.
- Exclude AI-generated works when the source supports it.
Where the dsh-pixluna DSH plugin fits
- Let the model get a random anime-style image to illustrate a conversation.
- Fetch a specific Pixiv illustration by its ID for detailed analysis.
- Allow the model to browse available image sources before deciding which to use.
- Control R18 content exposure through plugin-level and per-request settings.
- Integrate image fetching capabilities into a DSH-based agent workflow.
Who the dsh-pixluna DSH plugin is for
- DSH users who want their models to be able to fetch images from various sources.
- Developers building AI assistants that need to retrieve visual content for context.
dsh-pixluna DSH plugin limitations
- Requires a DSH environment with `@deepseek-ai/dsh-tools` service and Cordis.
- Pixiv features (fetch by PID, Discovery, Following) require a valid `phpSESSID` and userId.
- R18 requests require both plugin-level `isR18=true` and the tool parameter or probability to allow it.
- Image processing (flip, blur, compress) from original PixLuna is not carried over; tools return remote URLs only.
dsh-pixluna DSH plugin: from the repository README
Quoted from the PixLunaLab/dsh-pixluna README, the upstream source of the dsh-pixluna DSH plugin. Copyright remains with the original authors.
让 DSH 自己看涩图！ 将 [PixLuna](https://github.com/PixLunaLab/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` | 无 | ## 开发 ```powershell yarn install yarn lint yarn build ``` ## 安装到 DSH profile 开发目录可直接作为带 `dsh.bundle` 清单的本地 profile layer 安装（`web` 可替换为目标 profile）： ```powershell 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` 覆盖整份配置： ```yaml - id: pixluna name: dsh-pixluna config: defaultSourceProvider: - lolicon isR18: false pixiv: phpSESSID: '' userId: '' ``` 注意 DSH patch 对 `config` 是整项替换而非深度合并。插件声明 `inject = ['tool
Read the full READMERepository license: MPL-2.0
dsh-pixluna DSH plugin questions
How do I install dsh-pixluna?
Run `dsh plugin --profile web add dsh-pixluna` in your DSH environment. This adds the package to your profile's bundles and applies the included `cordis.patch.yml`. Make sure you have the `@deepseek-ai/dsh-tools` service available.
How do I enable R18 images?
You need to set both the plugin-level config `isR18: true` and allow it in the tool call (either via the `r18` parameter or through the `r18P` probability). The config can be updated in the DSH settings UI or by editing the profile's `cordis.patch.yml`.
How do I set up Pixiv credentials?
You need to provide a valid Pixiv `phpSESSID` and `userId` in the plugin config. These are stored in DSH credentials (not in plain settings) for security. Go to DSH settings → plugin configuration → dsh-pixluna, and fill in the Pixiv cookie fields. Changes take effect immediately for subsequent tool calls.
Can I change the default image source?
Yes, modify the `defaultSourceProvider` config in the profile's `cordis.patch.yml`. For example, change it to `["danbooru"]` to use Danbooru as default. The tool also accepts a `source` parameter to override per request.
How many images can I fetch at once?
The `pixluna_get` tool accepts a `number` parameter (default 1, max depends on source). You can also set `maxConcurrency` (1–10) to control how many parallel requests are made. The `pixluna_get_pixiv` tool can fetch all pages of a Pixiv artwork if you set `all: true`.