前言¶
在 DeepSeek Harness 里做联网或内容类任务时，助手往往只能泛泛描述 Pixiv，无法按关键词搜作品、看排行、拉详情，更谈不上把插画、漫画、动图或小说落到本地。自己写爬虫要处理限速、Cookie、多页 PDF 和小说排版，和维护成本都偏高。下面介绍社区插件 elither-gpt/pixiv-skill：把 Pixiv 能力封装成符合 Agent Skills 的技能，DSH 安装后助手可直接按 SKILL.md 调用；同一套 Python 脚本也可在命令行单独使用。
这是什么¶
pixiv-skill 由 elither-gpt 维护，在 SkillHub 分类为「联网工具」。仓库主体是一份 SKILL.md 加 scripts/pixiv.py 及配套模块，通过 Pixiv 网页版接口实现搜索、排行榜、详情与下载。输出面向助手：默认纯文本（可选 --json），下载成功会打印 SAVED: 路径，错误有固定退出码。除 DSH 外，README 还列出 Claude Code、Codex、OpenClaw、Hermes Agent 等技能的常见目录；DSH 侧由 dsh/index.js 负责登记技能。许可证为 MIT（package.json 版本 1.0.1）。项目与 Pixiv 官方无关，接口随站点改版可能失效。
核心功能¶
搜索与排行¶
- 搜索：插画、漫画、小说分开搜；排序支持最新、最旧、热门（男性向 / 女性向）；可按收藏数筛选（
-b）；可限制全年龄或 R-18。 - 排行榜：日榜、周榜、月榜、新人榜、原创榜、AI 榜、R-18 榜等；可按插画、漫画、动图过滤；可查历史日期。
详情与链接识别¶
- 作品、小说、小说系列（含章节目录）、画师（含作品数与最新作品）均可查询。
- 作品 URL、小说、系列、画师主页链接或由助手传入的 ID 形式（如
n:123、s:123）会被脚本识别。
下载¶
- 单张图保存原图。
- 多页作品可合成 PDF（超过 50 页自动分卷），或保存为图片文件夹。
- 动图（ugoira）转为 GIF。
- 小说导出 TXT，注音、章节、插图标记转为可读文字；系列可合并为一个 TXT 或按篇分文件。
不登录也可搜索并下载全年龄内容；R-18 作品与 R-18 榜需本机 Pixiv 凭证（通常只需 PHPSESSID），且账号需开启 R-18 显示。凭证保存在 ~/.config/pixiv-skill/cookie.json（Windows 为 %APPDATA%\pixiv-skill\cookie.json），勿发给 AI 或贴进聊天。
安装与启用¶
环境需要 Python 3.9+。插件装好后技能会自动出现，但 Python 依赖仍需在本机安装。
- 用 DSH 按 profile 添加插件（把
web换成你实际使用的配置名，如tui、headless）：
dsh plugin --profile web add github:elither-gpt/pixiv-skill
- 进入插件目录（或克隆后的仓库根目录）安装依赖：
pip install -r requirements.txt
也可手动把整个文件夹放到 ~/.dsh/skills/pixiv/，与 README 中其他助手的「拷贝技能目录」方式等价。插件以当前 dsh 进程权限 运行，安装前建议浏览 GitHub 仓库 源码与 MIT 许可证，确认可接受联网访问与本地写入下载目录的行为。
典型用法¶
登录（可选）¶
R-18 或需会员排序时，可在本机用临时浏览器窗口登录并保存 Cookie：
python scripts/pixiv.py cookie --login
也可手动设置 PHPSESSID，或查阅仓库内 获取 Cookie 教程。
命令行示例¶
下列命令与 README 一致，助手侧会按 SKILL.md 组织类似参数：
python scripts/pixiv.py search 初音ミク -n 10
python scripts/pixiv.py search 猫 -t novel -o popular
python scripts/pixiv.py rank weekly -t manga
python scripts/pixiv.py info https://www.pixiv.net/artworks/12345678
python scripts/pixiv.py info s:1234567
python scripts/pixiv.py download 12345678 n:23456789 --out ./downloads
python scripts/pixiv.py cookie
下载目录优先级：--out > 环境变量 PIXIV_DOWNLOAD_DIR > 当前目录下 pixiv-downloads。各子命令可加 --help；需要结构化结果时加 --json。
退出码摘要：0 成功；2 参数或目标无效；3 未登录、凭证失效或未开 R-18；4 作品不存在或不公开；5 网络或限流（脚本已做重试）；1 为其他错误或批量下载部分失败。
适用场景与注意¶
适合需要在对话里查 Pixiv 排行、作品信息，并把结果下载到本机做个人欣赏或后续处理的 DSH 用户。README 明确：热门排序需 Pixiv 会员，否则站点可能按最新返回；插画/漫画搜索页用 -b 筛收藏数会逐条查询且仅当前页；脚本默认请求间隔至少 0.7 秒，不宜用于大批量爬取；下载内容版权归原作者所有，未经作者许可请勿转载。
DSH 生态强调「一切皆插件」；SkillHub 目录页 为社区索引，与 DeepSeek / 幻方无官方从属关系。当前 GitHub 星标为 1，维护与 issue 以仓库为准。
结尾¶
经过上面的步骤，你可以在 DSH 里为助手挂上统一的 Pixiv 技能：搜索、排行、详情与多格式下载一条链路完成，全年龄场景无需登录即可起步，R-18 与本机 Cookie 由用户自行保管。进一步参数与开发说明见仓库 README 与 SKILL.md。
- 目录页：https://www.skillhub.cn/plugins/elither-gpt/pixiv-skill
- GitHub：https://github.com/elither-gpt/pixiv-skill
