文档与注释错误（关于 AI 插画过滤参数）

[ouhongtao2024]

问题描述

在使用 Pixivpy 的 AppPixivAPI.search_illust 方法时，发现关于 search_ai_type 参数的注释和文档存在错误，可能导致用户误将人类原创插画排除在搜索结果之外。

相关代码

result = api.search_illust(
    keyword,
    search_target="partial_match_for_tags",
    search_ai_type=1
)

当前部分注释错误地写作：

search_ai_type=0 # 过滤 AI 作品（错误）

正确说明

根据 Pixiv 官方 API 的行为及实际测试结果，search_ai_type 参数的值含义应如下：

建议在 Pixivpy 文档中对该参数添加明确注释，防止误导用户。

附加建议：说明返回字段 illust_ai_type 的含义

Pixiv 的插画返回数据中包含字段 illust_ai_type，用于区分作品是否为 AI 生成。

目前观察到的字段取值如下：

实测发现 illust_ai_type=0 和 1 都是由用户手绘上传的原创插画，而 2 表示使用 AI 工具（如 NovelAI、Diffusion 等）生成的作品。

建议在文档中加入此字段说明，方便用户结合结果做二次筛选判断。

建议的文档示例修改

search_ai_type 参数说明（建议添加）

# search_ai_type:
#   0 = 全部作品（包括 AI）
#   1 = 仅原创（排除 AI）
#   2 = 仅 AI 作品

调试信息（用来参考）

• 一份下载前保存的搜索到的插图的信息 log.json

[upbit]

可以帮忙提交个MR，修正下README和代码注释的内容。 另外，我记得 search_ai_type 外还有个网页用户设置的开关，会屏蔽全部AI作品。不知道这个开关是否受该总开关的影响？