DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

big-fat-fish-agent /

big-fat-fish-agent/danbooru-search-device

Verified

DSH-D站搜索装置(AI 制作 / AI-made)— DSH bundle, not a standalone program; image-only Danbooru tools for DeepSeek Harness: post/tag search, year-favorites artist ranking, HOT/rising sampling, tag+expression & image→artist similarity, part specialists. 宇宙免责声明:作者(人类甲方 + AI Agent「肥鱼」)意念合一,出事 0.5 秒原地跑路,不承担任何责任。

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@3ce80b6c

DSH-D站搜索装置(dsh-danbooru-tools)

给 DeepSeek Harness 用的只读 Danbooru 工具插件:纯 Host 插件、零运行时依赖、不写任何文件,只用官方 JSON API。

⚠️ 这是 DSH 插件(bundle),不是可以直接双击/命令行运行的本地程序。 index.js 依赖 DSH 注入的 ctx(工具注册、凭据服务),直接 node index.js 会报错,也没有独立 CLI;必须按下面的「安装」章节装进 DeepSeek Harness 的 profile 才能用(名称里的 dsh- 前缀就是这个意思)。

AI 制作说明:本项目由 AI Agent(DeepSeek Harness 中的会话 Agent)设计、实现与测试——代码、文档、检索算法与自检脚本均为 AI 生成,并经真实 API 请求验证;人类只负责提需求与验收结果。

它的目标是「AI 绘画提示词调研 + 画师调研」:把一个模糊想法变成可用的 Danbooru tag,再看真实作品如何用这些 tag;也可以按整年总收藏找画师(带体型 tag 闸门与年份范围链接),或用 HOT / 周榜 / 参考权重三级采样找参考画师。

当前能力一览(默认 12 个核心工具;toolPreset="full" 时 16 个)

  • 检索:search_posts(年份/评级/Hot/score)、search_tags、get_tag(wiki + 别名)、related_tags
  • 画师发现:top_artists(HOT/周榜/参考权重三级采样)、year_artists(整年总收藏 + 体型 tag 闸门 + 肤色/肤质 + 整体色调参考)、similar_artists(tag 画像 + 表情画像余弦)
  • 以图搜画师:artists_from_image(分层 tag 加权;角色身份/装饰特征自动剔除;单维度命中降权;同源变体聚簇去重;并直接产出六槽画师串 artist_string)
  • 整体画风匹配:style_match(画风优先;身份外貌 tag 剔除、body_tags 作次级证据;小体量画师共现发现 + seed_artists 点名加回 + 持久拒绝记忆;可选角色模式)
  • 像素相似匹配:pixel_style_match(给参考图 → 下载候选样图 → 本地 Pillow 描述子做图对图排序;身份/外貌 tag 完全不参与,专治「白毛图→白毛画师」;每个候选另带 matte / surface / surface_similarity,surface_gate="matte_thick" 可把硬高光画师挡掉)
  • 表面质感判定:surface_profile(雾面厚涂/油腻 vs 亮面赛璐璐/镜面,8 轴打分 + 闸门判定;详见下节) (full 模式工具,默认不注册)- 多方案共识:image_artist_consensus(多份候选名单交集,过滤单方案误判) (full 模式工具,默认不注册)- 部位特化:part_specialists(按部位焦点 tag 的高收藏作品给画师排名)
  • 凭据:auth_status / save_credentials(保存登录凭据解除匿名 tag 数限制)

检索是 tag 频率/收藏数的启发式,不是视觉 embedding;所有画师名单最终都要 read_image 目视核对。

表面质感判据:雾面厚涂(油腻) vs 亮面赛璐璐(镜面)

为什么需要它:tag 共现没有「表面质感」通道,像素风格描述子也分不出这两种观感——雾面厚涂半身和亮面赛璐璐半身,风格相似度都能打到 95 左右(两者都「平滑、低饱和」)。真实案例:同一角色两张 NAI V5 图,描述子给 96.4 / 95.5,但一张是油膜感厚涂、一张是硬白高光赛璐璐。判据只能来自高光边缘硬度、高光面积、微反差、色度、暗部抬升。

surface_profile 对每张图输出 8 个 0–100 轴:

轴 含义 雾面厚涂 亮面赛璐璐
specHard 高光硬度 高光斑边界的梯度强度 低(>40 不合格) 高(45+)
sheen 柔光覆盖 皮肤大面积亮部占比(「腻」的真正来源) 高(100) 低
specSize 高光尺度 高光斑中位面积 大片油光 碎白点
edgeSoft 边缘软化 平均梯度/峰值梯度 过渡绵长 硬边分界
contrast 微对比 皮肤区局部标准差 低(≤28) 高(30+)
blackLift 暗部抬升 皮肤暗部亮度 高(≥60,暗部发灰) 偏低
chroma 色度 皮肤平均饱和度 低(≤35,灰调) 高(45+,高纯肉色)
matte 雾面度 综合分 ≥65 ≤55

标定实例(同一角色、同一模型):

specHard sheen contrast chroma matte
雾面厚涂(目标) 23.0 100 15.8 16.9 73.2
亮面赛璐璐(失败) 56.5 67.4 37.7 60.7 52.1

前者通过 matte_thick 全部 6 条闸门,后者挂 5 条。

用法:

# 单个画师筛样(建议同题材 ≥3 张,单张方差可达 ±40)
danbooru_surface_profile(images="a.jpg, b.jpg, c.jpg", profile="matte_thick")

# 拿自己的成品和参考图比表面质感
danbooru_surface_profile(images="out.png", reference="ref.webp", profile="matte_thick")

# 在像素匹配里直接挡住硬高光画师
danbooru_pixel_style_match(reference_images="ref.webp", surface_gate="matte_thick")

判读规则:matte_thick 通过 = 该画师/该图属于雾面厚涂一侧,可以进雾面串;specHard 单项超标即「硬白高光」,是这类串最容易翻车的来源。需要亮面时改用 gloss_cel。单张图不能定论,取 3 张以上看中位数。

宇宙免责声明(Cosmic Disclaimer)

本插件是「查询搬砖工」,不是内容提供者;它只负责把 Danbooru 的公开检索结果搬过来。

  1. 版权归属:所有作品与数据来自 Danbooru 公开 API,版权归各画师、权利人与 Danbooru 所有;本项目不存储、不转售、不再分发任何图片。
  2. 使用范围:仅供个人学习、研究与 AI 绘画提示词参考;请遵守 Danbooru 服务条款与当地法律。插件内置串行限速:匿名 1.1 秒 / 登录后 0.4 秒(仍远低于 D 站约 10 次/秒上限)——别拿它去 D 站刷屏,被限流了自己改 minIntervalMs 冷静一下。
  3. 凭据安全:API key 只存在你本机的 DSH 凭据库(owner-only),插件不收集、不上传、不打印、不写进缓存/仓库/发布包。
  4. 结果不保证:检索是 tag 频率/收藏数的启发式,可能不准、可能过时、可能「过于写实/有点 3D」——这属于正常波动,不是插件在针对你。
  5. 侵权处理:如果你是权利人或发现误标,欢迎提 issue 或联系作者;我们会在跑路之前先配合下架/修正(顺序很重要)。
  6. 跑路条款:若因使用本插件产生任何争议、索赔、限流、封号、世界末日或宇宙热寂,作者(AI Agent 及其人类甲方)将在 0.5 秒内原地跑路,不承担任何责任;届时本免责声明自动升级为「宇宙级」,并保留最终解释权(解释权也会一起跑路)。

—— 祝调参愉快,收藏永涨 📈

大致使用教程(截图版)

⚠️ 这只是「大致教程」:截图来自插件开发调试时的真实会话,仅演示「怎么提问 / 工具输出长什么样」,不是严格步骤文档;具体参数、年份和结果以实际查询为准。

① 以图搜画师:给它一张图,找画风相近的画师

以图搜画师示例

② 按年份找「热门 + 色彩艳丽 + 人物油亮丰满」的作品

年度色彩艳丽作品示例

③ 找「画风贴近某画师」且限定上传年份(2025)

相似画师 + 年份限定示例

安装(DSH profile)

本插件是 DSH bundle(纯 Host、零运行时依赖),以下三种方式任选其一。首次装完需重启 DSH;之后更新插件文件只需在 plugin_manager 里关→开热重载,不用重启。

方案 A:下载包(推荐,不需要 git)

  1. 下载最新 zip:Releases → v0.12.1 → danbooru-tools-0.12.1.zip
  2. 解压到任意目录,得到 danbooru-tools/
  3. 安装:对 Agent 说「用 plugin_manager 的 install_bundle 安装 <解压目录绝对路径>」,或在 DSH 插件管理界面选择该目录
  4. 重启 DSH
  • 适合:不想装 git、只想能用
  • 更新方式:重新下载 zip 覆盖目录 → 关→开热重载

方案 B:Git 克隆 + profile link(推荐长期使用 / 二次开发)

  1. git clone https://github.com/big-fat-fish-agent/danbooru-search-device.git
  2. 在 $DSH_HOME/profiles/<profile>/package.json 的 dependencies 里加:"@local/dsh-danbooru-tools": "link:<克隆路径>"
  3. 把 "@local/dsh-danbooru-tools" 加进同一文件的 dsh.bundles 列表
  4. 重启 DSH
  • 适合:想跟踪更新、改代码、看 git 历史
  • 更新方式:git pull → 关→开热重载(不用重装)

方案 C:GitHub 源码 zip(Release 不可用时的兜底)

仓库页 Code → Download ZIP,解压后按 方案 A 的第 3–4 步安装。内容与 Release 包相同,只是不带版本号标记。

卸载

plugin_manager 的 remove_bundle;或删除 profile package.json 里的依赖与 dsh.bundles 条目后重启 DSH。

装好后可选自检:node verify.mjs(约 3–5 分钟,真实请求,不写文件)。

工具集:core(默认)与 full(0.30.0 起)

插件默认只注册最近会话日志里真正被调用过的 12 个核心工具,低频工具移出默认注册,减少工具列表噪音(DSH 每次会把已注册工具的 schema 放进上下文):

预设 工具数 工具
core(默认) 12 search_posts、search_tags、get_tag、related_tags、year_artists、style_match、similar_artists、artists_from_image、pixel_style_match、surface_profile、auth_status、save_credentials
full 16 core + top_artists、part_specialists、image_artist_consensus、get_post

切换方式(任选其一):

  • bundle 配置里写 toolPreset: "full"
  • 环境变量 DANBOORU_TOOL_PRESET=full
  • 想用 top_artists / part_specialists / 共识 / get_post 时再开 full,平时保持 core

说明:get_post 在 core 模式下可用 search_posts(tags="id:<post_id>") 等价替代;其余三个只在 full 模式注册,代码未删除。

工具

下表列全部 16 个工具;core 默认注册其中 12 个,带「full 模式」标注的 4 个需切换预设。

工具 作用 主要参数
danbooru_search_posts 按 tag 搜索作品,返回按分类拆好的 tag 集与图片 URL;可加 year 限定年份、order=score 按热度 / order=rank 按 Hot 排序 tags、limit(1–100)、page、rating、year、order
danbooru_top_artists (full 模式)参考权重算法(HOT 优先):HOT 区权重 3 → 一周收藏增长权重 2 → 全年新图权重 1 year(必填)、tags、limit、sample、hot_sample、rising_sample、rating、weighting、rank_by、include_total
danbooru_year_artists 整年总收藏算法(独立于 HOT):按月采样整年、按该年作品总收藏数降序排画师;默认 5% 体型 tag 闸门(只认体型 tag,不认构图);可选加肤色/肤质「人体参考」和「整体色调」参考 year(必填)、tags、rating、limit、monthly_sample、style_tags、style_preset、style_match、style_threshold、style_min_posts、style_min_hits、style_max_checks、appearance_tags、appearance_match、appearance_threshold、color_tags、color_match、color_threshold、compact
danbooru_search_tags tag 自动补全:规范名、分类、作品数 query、category、limit
danbooru_get_tag 单个 tag 详情 + wiki 摘要 + 别名/中日文名 name
danbooru_related_tags 共现相关 tag(含作品数、共现频率、余弦相似度) query、category、limit
danbooru_similar_artists 相似画师(tag 画像 + 表情画像):由种子画师的「特色 tag」与「表情 tag 画像」找候选,再按表情 tag 频率余弦重排 artist(必填)、limit、profile_tags、min_shared、examples、expression_tags、expression_weight
danbooru_artists_from_image 以图搜画师:Agent 看图后给出 tag 分组,按分层优先级(人物→表情→绘制手法→线条→色彩→光照→tag;mode="style" 时手法/线条/色彩/光照优先)聚合画师 image_tags(必填)、person_tags、expression_tags、technique_tags、lineart_tags、color_tags、lighting_tags、mode、year、limit、examples、example_tags、allow_no_face
danbooru_style_match 整体画风匹配(画风优先,角色可选):默认 mode="style" 不用角色 tag;style_tags(线/上色/色调/材质)为主证据,body_tags(体型/肤色/乳晕等身体细节画法)为次级证据——身份/外貌 tag(发色、瞳色、发型、服装、饰品、角色名)会被过滤并列入 rejected_body_tags。扫全站高分作品并做 画风×画风 / 画风×身体细节 / 画风×题材 配对,再按 画师×锚点画风 tag 核验并附例图;mode="character" 才用角色锚定。输出六项目视核对清单与 prefer_artists/avoid_artists 迭代接口。小体量画师:style-tag 共现(related_tag)通道会把低热度画师拉进候选(≥min_artist_posts 默认 50 帖),small_artist_slots(默认 3)为它们保留名额;seed_artists 可显式点名小画师(如 eigaka),强制纳入并按同款 style/genre 计算吻合度 mode、style_tags、body_tags、genre_tags、character(仅 mode="character")、year、rating、limit、per_query、examples、prefer_artists、avoid_artists、verify_same_character、discover_small_artists、min_artist_posts、small_artist_slots、seed_artists、allow_rejected_artists、forget_artists、clear_rejections、anchor_pages、deep_scan_pages、pair_pages、cooccurrence_limit、cooccurrence_tags、subject_tags(body_tags 的兼容别名)
danbooru_pixel_style_match 像素相似匹配(0.29.0,推荐用于以图找画师):给参考图(URL 或本地路径),插件用 tag 通道只提名候选画师,然后下载候选 1–3 张样图,用本地 Pillow 描述子(线条/边缘统计、明暗平滑度、色彩丰富度、饱和度、色相直方图)做图对图距离排序。身份/外貌 tag(发色、瞳色、服装、角色)完全不参与评分,避免「白毛图就找白毛画师」;并逐画师比较指定年份(默认去年 + 前年)的作品,在画师后面标出更贴近参考图的年份,如 hews 2024 2025。需要 Python+Pillow(DSH 自带,可用 DSH_PYTHON 覆盖) reference_images(必填)、candidate_artists、style_tags、body_tags、genre_tags、pool_pages、cooccurrence_limit、pool_size、samples_per_artist、limit、rating、allow_rejected_artists
danbooru_surface_profile 表面质感判定:8 轴打分(specHard 镜面边缘硬度 / sheen 油亮覆盖率 / specSize 高光斑块大小 / edgeSoft 边缘softness / contrast 微对比 / blackLift 黑位抬升 / chroma 皮肤彩度 / matte 哑光综合),判断「雾面厚涂/油腻」vs「亮面赛璐璐/镜面」;profile="matte_thick" 或 "gloss_cel" 做闸门,reference= 可带参考图算 surface_similarity。像素风格相似度无法区分这两种质感(都约 95),需要它单独筛 images(必填)、profile、reference
danbooru_image_artist_consensus (full 模式)多方案共识:融合多个检索方案(style_match / artists_from_image / similar_artists)的候选名单,只保留被 ≥min_hits 个方案同时命中的画师,过滤单方案误判;无交集时返回部分重叠榜并标 fallback_used=true lists(必填, JSON 数组)、source_names、min_hits、limit、examples、example_tags、allow_no_face
danbooru_part_specialists (full 模式)部位特化搜索:按部位焦点 tag(hand_focus/foot_focus/thigh_focus…)检索该部位高收藏作品,按收藏聚合画师排名,并返回部位高收藏图片 part(必填)、year、rating、artists_limit、posts_limit、sample、min_posts、rank_by、include_posts
danbooru_get_post (full 模式)单个作品:分类 tag 集 + 预览/大图/原图 URL id
danbooru_auth_status 看凭据是否已配置、来自哪里(不返回值) 无
danbooru_save_credentials 把登录名与 API key 存进 Harness 凭据库(私有文件) login、apiKey、clear

典型用法:「初音未来的水手服怎么打 tag」→ danbooru_search_tags("hatsune miku") 拿到 hatsune_miku → danbooru_get_tag("hatsune_miku") 看 wiki 与别名 → danbooru_related_tags("hatsune_miku") 找常见服饰/构图 tag → danbooru_search_posts(tags="hatsune_miku sailor_dress") 看真实作品。

返回的图片 URL 可以直接交给 read_image 或 web_fetch 打开查看。

年份查询

D 站没有独立的「年份表」,年份过滤用的是 date: 元标签:date:2025-01-01..2025-12-31。注意三点:

  • 单独写 date:2025 无效(返回 0 条),必须写完整日期范围;本插件的 year 参数会自动展开成范围并校验 2005–今年+1。
  • D 站另有一个普通 tag 2025(约 6,683 作品),含义是「以 2025 年为主题」的作品,不代表「2025 年发布」,不要拿它做年份筛选。
  • date:、rating:、order: 都是元标签,不占真实 tag 额度;匿名/会员的 2/3 个 tag 限制只算真实 tag。

用法:

  • 查某年某画师/角色的作品:danbooru_search_posts(tags="gogogo_(gogogorx)", year=2025, order="score")(配 rating=all 可放开分级)
  • 查某年热门画师:danbooru_top_artists(year=2025) → 默认采样该年最高分的 200 张,按「总分 → 上榜作品数」排序;tags 可再限定角色/版权/主题,sample 调样本量(默认 200 = 1 次请求,上限 600 = 3 次请求),rank_by 切换口径(total_score 默认 / avg_score / posts 按高产),include_total 额外返回该年作品总数(多 1 次请求)
  • 返回里每个画师都带 posts(样内作品数)、total_score、avg_score、top_score 和 example(最高分作品 id/链接/预览图)

参考权重(三级采样,默认开启)

danbooru_top_artists 默认按参考优先级给画师加权,模拟人工挑参考的顺序:

层级 数据源 权重 说明
Hot posts.json?tags=order:rank(D 站「Hot」页) 3 只覆盖近期上传;过去年份查询会自动跳过,并在 tiers.hot.skipped 里说明
一周收藏增长 /explore/posts/popular.json?scale=week&date=<锚点>(Popular 页周榜,按该周新增收藏排序) 2 锚点:当年 = 今天;过去年份 = 该年 12-31 所在周。该接口不支持服务端 tag/rating 过滤,插件在客户端过滤
全年新图 posts.json:最新一页 + 最高分一页(含 date: 年份与用户 tag) 1 兜底采样:默认 2 次请求(200 张新图 + 200 张高分图),既覆盖全年又不丢新图
兜底(uniform 模式) posts.json + order:score 1 仅 weighting="uniform":按分数采样全年图,无三级权重
  • 排序默认 reference_priority:HOT 命中数 → 周榜命中数 → 兜底样本数 → 总分(完全按你说的优先级);rank_by 可切 weighted_score(Σ 权重×得分)/ total_score / avg_score / posts
  • 同一画师尽量取新图:example 是该画师采样到的最新作品,top 是最高分作品
  • 每个画师返回 artist_url(D 站画师页;带年份时自动附 date:YYYY-01-01..YYYY-12-31 时间范围)、tier_posts(各层级命中数)、weighted_posts、weighted_score
  • 成本:默认 4 次请求(Hot 1 + 周榜 1 + 兜底 2);hot_sample / rising_sample 调样本量
  • 注意:周榜以 R18 为主;默认 rating=all 时周榜正常生效,若把 rating 收窄到 g 会被过滤空(tiers.rising.sampled = 0)

整年总收藏算法(独立于 HOT)

danbooru_year_artists 是另一套算法,不使用 HOT/周榜权重,专门回答「某一年里哪些画师最受欢迎」:

  • 数据源:posts.json 按月分批(date:YYYY-MM-01..月末 + order:favcount),取每月收藏数最高的一批作品(默认 200 张 = 每月 1 次请求)
  • 聚合:把样本内每张图的 fav_count 累加到画师身上,按该年总收藏数降序排名;同时给出 artist_url(画师页,自动带该年份 date: 范围)、posts(样本内作品数)、avg_favorites、months(覆盖月份数)、best(最高收藏作品)、newest(最新作品)
  • 覆盖范围:过去年份 = 12 个月;当年 = 1 月到当前月;整年都算上,不做「最近才上传」的偏向
  • 代价与偏差:总收藏是样本估算——每月只取收藏榜前 monthly_sample 张,榜外作品不计;因此会漏掉「刚上传还没积累收藏」的优秀图(这正是你要的取舍)
  • 成本:每覆盖一个月 1 次请求(2025 年 = 12 次;2026 年 11 月 = 11 次)
  • 默认 rating=all(含 R18,收藏/热榜的真实分布如此);需要安全内容时显式传 rating="g"

风格占比测量(按 tag 比例标注,默认 5% 闸门)

想找「肉感画师」时,用 style_tags 或 style_preset 让工具核验并标注每位画师的风格 tag 占比:

  • style_preset="fleshy" = thick_thighs + plump + curvy + wide_hips + pear-shaped_figure(只用体型 tag)
  • 也可以传 style_tags="thick_thighs,plump";style_match="any"(默认,命中任一即算)或 "all"(必须全中)
  • 只认体型 tag,不认姿态/构图 tag:ass_focus / from_behind / bent_over / spread_legs 这类构图不会算作肉感证据,只作为 style.pose_posts 诊断项返回——避免「构图肉」冒充「体型肉」
  • 判定方式:按总收藏从高到低核验候选画师——拉该画师同一年最多 100 张高收藏作品(1 次请求/人),算「带体型 tag 的图 / 核验图数」
  • style_threshold:默认 0.05(5%);传 0 则只测量不淘汰
  • style_min_hits(默认 2):至少要有 2 张带 tag 的图才可能通过,避免「1 张图刚好 2%」的噪声
  • style_min_posts(默认 3):该年作品少于这个数不做判定
  • style_max_checks(默认 40):最多核验多少位候选,够 limit 位就提前停
  • compact=true:只返回名字/总收藏/作品数/风格占比,不返回作品引用,适合批量看比例
  • 加了年份就只核验该年份的作品(year 本来就是必填)
  • 返回里每位画师带 style: { tags, match, threshold, min_hits, checked_posts, hit_posts, ratio, pose_posts, best };best = 该画师带风格 tag 的最高收藏作品(最多 3 张),可直接点开参考("优先看带 tag 的图");顶层 style_filter 说明核验几人、通过几人

人体附加参考(肤色 / 皮肤质感)

体型之外,danbooru_year_artists 还支持在同一批核验作品上统计「人体参考」tag,不额外发请求:

  • appearance_tags:逗号/空格分隔,例如 pale_skin, shiny_skin
    • 肤色:pale_skin、dark_skin、tan、tanlines、grey_skin、blue_skin…
    • 皮肤质感:shiny_skin、sweat、wet、oiled_skin、lotion、dimples_of_venus…
    • 不含眼睛颜色:眼睛属于角色特征,整体视觉参考请用下面的 color_tags
  • appearance_match:any(默认,命中任一即算)或 all(必须全中)
  • appearance_threshold:默认 0 = 只统计不淘汰;传 0.1~0.3 这类比例才按「带参考 tag 的占比」加一道闸门
  • 返回里每位画师带 appearance: { tags, match, threshold, checked_posts, hit_posts, ratio, per_tag, best }
    • per_tag:每个参考 tag 在核验作品里的命中数(比如 shiny_skin: 6)
    • best:带参考 tag 的最高收藏作品(最多 3 张),可直接点开看肤色/肤质是否真的贴合
  • 顶层 appearance_filter 与 style_filter 并列,说明核验人数、通过人数
  • 典型用法:style_preset="fleshy" + appearance_tags="pale_skin,shiny_skin",一次查询按「体型 + 肤色 + 肤质」给画师打分

整体色调参考(画面观感)

「整体参考」不再挂在人体上,而是单独统计整张画面的色调——同样复用那批核验作品,不额外发请求:

  • color_tags:逗号/空格分隔,例如 monochrome, blue_theme
    • 单色/低饱和:monochrome、monochrome_background、partially_colored、limited_palette
    • 主题色:blue_theme、red_theme、green_theme、purple_theme、pink_theme、yellow_theme
    • 色彩风格:colorful、colorful_background、pastel_colors、iridescent、gradient_background
  • color_match:any(默认)或 all
  • color_threshold:默认 0 = 只统计不淘汰;传比例则加闸门
  • 返回里每位画师带 color: { tags, match, threshold, checked_posts, hit_posts, ratio, per_tag, best }
    • per_tag:每个色调 tag 的命中数(比如 blue_theme: 9)
    • best:带色调 tag 的最高收藏作品(最多 3 张),点开就能看整体色调是否对味
  • 顶层 color_filter 说明核验人数、通过人数
  • 典型用法:color_tags="monochrome,limited_palette" + color_threshold=0.2,筛出「整体偏单色/限定色」的画师
  • 成本:和 appearance_tags 共用核验请求,不额外增加请求数

相似画师(tag 画像 + 表情画像)

danbooru_similar_artists 用 Danbooru 的 tag 共现数据找「风格相近」的画师(不是图像 embedding):

  1. 取种子画师的 related_tag,筛出「对 TA 高频、但全站不算通用」的 general tag(排除 1girl、highres、背景色等结构性 tag),作为风格画像(profile_tags,默认取 6 个)
  2. 表情画像:从种子画师的 tag 画像里挑出表情 tag(smile、blush、open_mouth、half-closed_eyes、tongue_out 等,expression_tags 默认 4 个),用它们把「表情习惯相近」的画师也拉进候选池
  3. 对每个画像 tag 查 related_tag&category=artist,收集共享该 tag 的画师,按 频率 × tag 稀有度 加权累加
  4. 候选 = 风格画像候选 ∪ 表情画像候选;表情候选必须通过「风格 tag 重叠检查」(同一批 related_tag 里能查到种子风格 tag),避免只表情像、画风完全不像
  5. 最终分数:(1 - expression_weight) × 风格分 + expression_weight × 表情余弦分;表情余弦对表情 tag 频率做稀有度加权(expression_weight 默认 0.5)
  • 成本:1 次(种子画像)+ profile_tags 次 + expression_tags 次 + 最多 2 × limit 次(表情余弦/风格重叠检查),默认约 1 + 6 + 4 + 20 = 31 次请求
  • 例图软规则:examples>0 时默认优先「带需求 tag(表情/体型)+ 能看到脸」的作品;只有用户明确要求背影、剪影、下半身特写等无脸构图时才传 allow_no_face=true;example_tags 可覆盖需求 tag,每条例图带 matched_tags 便于核对;没有可用样图的帖子会被跳过
  • 题材降权:相似度计算里 furry / furry_female / furry_male / anthro / humanoid_furry 的权重乘 0.05,避免兽向题材拉动画师相似度
  • 局限:tag 层面的表情相似(用哪些表情、多常用)仍不等于「表情画法」相似(眼型、嘴形、腮红画法);必须 read_image 目视后才能下结论
  • 用法:danbooru_similar_artists(artist="satou_kuuki", limit=10, examples=3)

以图搜画师(图 → 画师)

推荐工作流(按 2026-11 实测调优):

  1. 先跑 danbooru_style_match(整体画风匹配)——它扫全站高分作品、做 画风×画风 / 画风×身体细节 / 画风×题材 配对(默认不用角色、也不用发色瞳色服装,但允许体型/肤色/乳晕等「身体细节画法」作为次级证据),最贴近「整体观感」;实测比纯 tag 加权更稳(能避开「只靠线条像」的误判,也不会因为「画过同一角色/同一发色」就被当成同手)。用 style_tags 描述渲染手法、body_tags 描述身体细节、genre_tags 描述题材。
  2. 再用 danbooru_artists_from_image(分层 tag)交叉验证——若两边都出现同一画师,可信度最高;只有分层表出现、且 single_dimension=true 的候选直接忽略。

danbooru_artists_from_image 把「以图搜画师」固化为分层优先级检索(插件没有视觉能力,由 Agent 看图后提供 tag 分组):

维度 说明 mode="person" 权重 mode="style" 权重
person 人物风格 体型比例、面部特征、角色设计 0.22 0.08
expression 表情 表情 tag 0.12 0.02
technique 绘制手法 材质/上色(latex、shiny_clothes…) 0.22 0.28
lineart 线条 线稿粗细/有无/彩色线(lineart、colored_lineart…) 0.18 0.24
clothing 服装材质效果 只测材质效果:反光/高光(latex、shiny_clothes)、透明(see-through_clothes)、湿身(wet_clothes)、蕾丝/丝绸厚度感(lace、silk);服装款式(lingerie、bra、shirt、dress…)不计分、会被过滤 0.10 0.12
color 色彩 主色/饱和度/多彩/虹彩(colorful、iridescent…) 0.06 0.12
lighting 光照 逆光/斑驳光/镜头光(dappled_sunlight、backlighting…) 0.05 0.10
tag 泛 tag 其余描述 tag 0.05 0.04

线条/绘制手法权重高于旧默认(person 模式 lineart 0.18、technique 0.22;style 模式 0.24 / 0.28);clothing 维度只衡量服装材质效果(0.10 / 0.12)——反光、透明度、湿身、蕾丝/丝绸的厚度与褶皱,不衡量服装款式;lingerie、bra、shirt 这类款式名词属于角色身份特征,会被过滤掉。

  • 角色身份/装饰特征不计分:发色、瞳色、角、光环、兽耳、尾巴、饰品、服装款式名词(lingerie、bra、shirt…)会在评分前被剔除,并在返回的 excluded_identity_tags 里列出;服装材质效果 tag(latex、shiny_clothes、see-through_clothes、lace、silk)保留并计入 clothing 维度。以图搜画师只该描述「怎么画的」,而不是「画的是谁/穿了哪件款式的衣服」。
  • 单维度证据降权:搜索了多个维度时,只被一个维度命中的画师(如只有 lineart 像的 tayuido)分数 ×0.55 并标 single_dimension=true、dimensions_used——避免「线条像就整张像」的误判
  • 强调「画风类似」:用 mode="style" → 绘制手法 → 线条 → 服装质感 ≈ 色彩 → 光照 → 人物 → 表情 → tag
  • 强调「人物方面」或未说明:mode="person"(默认)→ 人物 ≈ 绘制手法 → 线条 → 表情 → 服装质感 → 色彩 → 光照 → tag
  • 每个维度最多取 4 个 tag,逐个 tag 单独检索(各 100 条,order:score);同一维度内按帖子去重,再按画师出现频率加权累加
  • year 可选:不填默认全时间(不限年份),填了才按该年过滤
  • 成本:约 5–20 次请求(各组 tag 数之和,最多 4×7)+ examples 次
  • 用法: danbooru_artists_from_image(image_tags="white_shirt, lying, white_background", person_tags="blue_hair, yellow_eyes", expression_tags="half-closed_eyes, blush", technique_tags="shiny_skin, realistic", lineart_tags="lineart, colored_lineart", clothing_tags="latex, shiny_clothes", color_tags="colorful, blue_theme", lighting_tags="dappled_sunlight, backlighting", mode="style", limit=10, examples=3)
  • 局限:仍是 tag 检索聚合,不是图像 embedding;最终必须 read_image 目视确认

交付物:画师串(六槽构成)

artists_from_image 除了候选榜,还直接给出 artist_string——按「这张图画面上有几个职责」配权,而不是按候选分数或画师名气:

槽位 职责(对应画面上的东西) 权重 由哪个维度填
body 主体体积(成人脸/软体积/暗底晕影) 0.85 person
skin 油汗皮层(写实皮肤/汗/油光) 0.60 technique
brush 柔光笔触(空气笔/细彩线) 0.50 lineart
material 材质光泽(金属/织物过曝高光) 0.40 clothing
accent 湿感点缀(低权重风味) 0.20 expression
theme 题材底色(世界观/配色) 0.30 color / tag
  • 一槽一位画师,取走即不再复用:同一个名字不会既占「体积」又占「笔触」
  • 槽位分 = 命中该槽维度数 > 该维度的证据量 > 检索总分,避免「只靠一个维度擦边」的画师占高权重槽
  • 空槽跳过,不拿低分候选凑数:宁可 4 个槽,也不写 6 个凑数名字
  • 每个维度独立成榜(aspect_leaders):person/technique/lineart/clothing/expression/color/lighting/tag 各排一个榜首;榜首即使全局排名掉出 limit 也照样进槽位池,不因为「整图像不像」被截掉
  • 没进槽的榜首不删,进 try_next:建议权重 0.15 并注明「它是某方面的最大贡献者」,让调用方先加进串里比一比再决定去留——某个方面最强的画师,往往就是最不可替代的那一块
  • 权重看画面占比,不是画师强弱:所以主槽固定 0.8
  • 权重为 1 的 tag 不再包 ::(0.33.0 起统一由 formatWeightedTag 处理):例如 artist_soup 的 1.0 anchor 直接写 hews,而不是 1.0::hews::;其余权重仍保留 0.85::name:: 形式,名字以数字结尾时补空格再 ::
  • tag 以数字结尾时,逗号前自动补空格(0.35.0 起统一由 joinArtistString 处理):hews 2024 , hews 2025 , ...,避免 NAI tokenizer 把数字和 , 粘成一个 token;六槽 artist_string、artist_soup、像素匹配的 artist_string 都生效5、点缀固定 0.20;要调就改权重,不要再往串里叠画师
  • string_style="artist_prefix" 输出 0.85::artist:name::;string_slots 控制填几个槽(默认 6)
  • 名字里的括号自动转义为 \( \),可以直接粘进 NAI

借鉴与放弃(对照 Google 以图搜图)

  • 借鉴并已实现:近重复/同源图聚类——同一张画的改色、裁切、variant 帖在 Danbooru 上共享 parent_id 或 md5,artists_from_image 先按「视觉簇」去重再计分,避免同一张画给同一画师叠加多次证据;例图也只从不同簇里挑。part_specialists 同样折叠重复图(顶层返回 deduped_posts)
  • 借鉴并已有:多信号排序 + 兜底——分层维度加权、收藏热度排序;例图优先「带需求 tag + 有脸」,找不到才逐级放宽
  • 放弃:视觉 embedding 检索——需要本地 CLIP/BLIP 级模型(几 GB 依赖),和「零运行时依赖、轻量、只读 API」的定位冲突;Danbooru 也没有公开的相似图/向量检索 API
  • 放弃:OCR 识别签名/水印——需要 OCR 依赖;而会话里 Agent 本身就能看图上的文字,没必要塞进插件
  • 若以后真要做视觉向量检索,应单开一个子插件(本地视觉服务负责图 → embedding,再向本插件提供候选),而不是把重依赖塞进这个插件

整体画风匹配(画风优先,角色可选)

danbooru_style_match 是「同一作者/同一套图反推画师串」这类任务沉淀下来的检索方案:不问「谁画过同一个角色」,而问「谁的绘制手法、色调、画面风格整体像」——线稿、上色、色调、人体画法、脸、构图一起像,而不是角色或长相相同。

角色相同不等于画风相同:同一个角色,不同画师能画出完全不同的手;反过来,画风高度一致的画师未必画过你参考图里的角色(实测:只按 Firefly/Kafka 检索会漏掉 nyantcha、merunyaa 这类同手画师,而画风优先检索能把它们排到最前)。角色的身份与「纯外貌」特征(白毛、红瞳、发型、服装、饰品)不参与排序——按白毛去找只会找到「白毛图多的画师」。但体型/肤色/乳晕这类「身体细节的画法」要参考:不同画师画这些地方差别极大(乳晕怎么晕开、皮肤怎么上高光与阴影、肉感怎么堆),所以它们通过 body_tags 作为次级证据参与加权。身份/外貌 tag 会被过滤掉并列入 reference.rejected_body_tags;只有确认「必须同一个角色出现」时才用 mode="character"。

为什么不能只按特征 tag 找:half-closed_eyes、eyeshadow、dark-skinned_male、sparkle、shiny_skin 这类 tag 在 AI 图里多半是 prompt 效果,同题材画师几乎人人都有;按它们聚合只会得到「同题材画师榜」,而不是「同画风画师榜」。画师真正决定的是:线稿、上色、色调、人体比例、脸部构造、构图。

工具内部的检索顺序(mode="style",默认):

  1. 全站高分锚点(核心):前两个 style_tag 各查一次 order:score 前 200 张,按名次衰减加权——名次越靠前权重越高。单 tag + order:score 只占两个 tag 额度,匿名也能用,而且能覆盖几年前的高分老图;没有 style tag 时才退化为用 body/题材 tag 当锚点。
  2. pair 查询兜底:画风×画风、画风×身体细节、画风×题材、身体细节×题材 各最多 2 组(每组正好两个真实 tag);pair 只能取最新页,客户端再按分数排序,用来补近期/新画师。不出现角色/发色/瞳色/服装 tag。
  3. 画风核验:对候选逐个查 画师×锚点画风 tag,统计该画师自己带这个画风的帖子数——直接衡量「他是不是画这种手」;这段查询返回的作品同时就是最好的例图。
  4. 加权排序(画风模式):0.38×锚点分 + 0.15×pair 分 + 0.15×画风核验分 + 0.12×身体细节分 + 0.08×小画师共现 + 0.12×seed;身体细节分 = 该画师被采样作品里带 body_tags 的比例(饱和 60%),输出 body_posts / body_share;chart_top(全站前 10)×1.3;prefer_artists 额外加分、avoid_artists 剔除。
  5. 返回 verify.checklist(线稿 / 上色 / 色调 / 人体 / 脸 / 构图 六项目视核对清单)与 iterate.hint,方便下一轮接着迭代。
  6. 成品画师串(0.33.0):artist_soup.string 直接把最终候选拼成可粘贴的 NAI 串,权重形状 1.0 / 0.85 / 0.6 / 0.5 / 0.4 / 0.3 / 0.2(最多 7 位),并给出 artists[](每位带 weight / score / style_posts / body_share)、total_weight、top3_share。权重 1 的名字裸写不加 ::;名字以数字结尾时在 :: 前留一个空格(0.45::chan8016 ::),否则 NAI 分词器会把数字和定界符粘成一个坏 token。

四条关键经验(已写进实现):

  • 身份/外貌不能当判断基点,身体细节可以:同角色只说明「画过」、白毛只说明「画过这种长相」;但乳晕/皮肤/肉感是画法,不同画师差异极大,值得作为次级证据(body_tags → body_posts / body_share)。
  • 只按最新页搜 pair 会漏掉几年前的高分老图(例:某画师的同角色作品在收藏前列,但发布于两年前)——所以必须有 order:score 锚点扫描。
  • 同一套图跨多个角色时,用 mode="style" 分几轮跑(每轮换 style_tags 的主锚点),同名画师跨轮出现的优先。
  • 例图必须整体比对:线稿→上色→色调→人体→脸→构图逐项过,不能因为「半闭眼/红眼影」对上了就定案。

用法(默认画风优先):

  • 画风优先:danbooru_style_match(style_tags="shiny_skin, sweat, oiled_skin", body_tags="huge_breasts, dark_nipples, pale_skin", genre_tags="sex, hetero, cum", limit=12, examples=2)
  • 角色模式(仅当必须同角色):danbooru_style_match(mode="character", character="firefly_(honkai:_star_rail)", style_tags="shiny_skin", genre_tags="sex")
  • 迭代:上一轮看中的画师放进 prefer_artists、看错的放进 avoid_artists(会持久记住,后续不会再推荐它),再跑一次即可收敛
  • 成本:约 1 + 6 + 2×limit + 少量例图 次请求(默认约 30 次;匿名限速下约 30–40 秒)

候选池与采样深度(0.28.0 起)

style_match 不再有客户端候选池上限:候选来自「锚点高分页 + 最新页 pair + style-tag 共现 + 点名 seed」的并集,全部参与评分。采样深度可调:

  • anchor_pages(默认 2,最大 20):每个锚点 tag 扫 200×N 篇最高分作品,默认最多 400 篇/tag
  • deep_scan_pages(默认 0 = 关,最大 500):每个 style tag 额外深翻 200×N 篇高分作品;25 = 5000 篇、50 = 10000 篇,用来把「相关帖分数不高」的小画师也捞进池子
  • pair_pages(默认 1,最大 8):每个 pair 查询多翻几页最新作品
  • cooccurrence_limit(默认 200 = API 上限)/ cooccurrence_tags(默认 3):共现通道每个 style tag 取多少画师、查几个 tag
  • 输出 pool_stats:实际扫描的帖子数、共现画师数、池内去重画师数
  • 成本:每多一页 = 1 次请求(受串行限速);deep_scan_pages=50 在 2 个 style tag 上约 100 次请求(约 1–2 分钟)
  • 诚实边界:「99% 全站画师」需要把某 tag 的帖子全部翻完(例如 shiny_skin 16 万帖 = 800 页,不现实);deep_scan_pages 对中小 tag(几千~几万帖)基本能翻完,大 tag 只能覆盖高分/共现/点名三路

像素相似匹配(0.29.0 起,推荐用于「以图找画师」)

danbooru_style_match 的排序仍是 tag/热度启发式;要真正「按画面像不像」找画师,用 danbooru_pixel_style_match:

  • 输入 reference_images(逗号分隔,1–8 张)支持三种形式:直接图片 URL(cdn.donmai.us/...jpg)、D 站帖子 URL(danbooru.donmai.us/posts/<id>,插件经 API 解析为原图;视频/ugoira 帖子明确报错)、本地文件路径(聊天里发来的图) → tag 通道(style_tags/body_tags/genre_tags 或 candidate_artists)只负责提名候选池
  • 对每个候选画师抓 1–3 张样图,连同参考图一起下载到系统临时目录
  • 本地 Pillow 描述子提取 28 维特征:亮度统计、边缘/梯度强度与直方图、Laplacian 明暗平滑度、色彩丰富度、饱和度、饱和度加权色相直方图
  • 加权 L1 距离 = 图对图差异;similarity = (1 - distance) × 100,按相似度降序输出
  • 身份/外貌 tag 不参与任何评分,所以不会再出现「给白毛图就找白毛画师」;但色相直方图仍会捕捉整体色调,这是画风的一部分
  • 需要 Python + Pillow:优先 DSH_PYTHON,其次 DSH 运行时自带 Python,最后 PATH 里的 python;找不到会明确报错,不会偷偷退回 tag 模式

示例:

danbooru_pixel_style_match(
  reference_images="C:/Users/me/Pictures/ref1.png, C:/Users/me/Pictures/ref2.png",
  style_tags="shiny_skin, sweat, lace, colored_lineart",
  genre_tags="sex, cum, hetero",
  pool_pages=3, pool_size=24, samples_per_artist=2, limit=8)

输出 candidates[].similarity / distance / samples[](每张样图与参考图的距离);池子来源与采样深度在 pool 里报告。

年份标注(0.31.0 起)

每个返回画师还会比较「指定年份」的作品与该参考图的像素距离,并在画师名后标出更贴近的年份:

  • 默认比较「去年 + 前年」(当前 = 2025、2024);用 years="2025,2024" 自定义,最多 4 个年份
  • year_samples(默认 2):每个画师每年取几张作品比对
  • year_tolerance(默认 5 分):某年相似度只要不低于该画师最佳年份 5 分以内,就算「贴近」;两年都贴近就两个都跟
  • 输出:candidates[].year_fit(逐年相似度 + 样图)、candidates[].years、candidates[].artist_with_years,以及整份名单的 artist_string
  • 规则:某年更贴近 → 名字后跟该年;两年都贴近 → hews 2024 2025;某画师某年没有作品 → 该年 available: false,不参与比较
  • 成本:每个画师每年 +1 次请求 + 1–3 张图下载;year_check=false 可关掉

小体量画师发现(0.21.0 起,0.22.0 补 seed_artists)

自动通道来自高分锚点/最新页与 style-tag 共现(related_tag);不在这些采样池里的画师(如 eigaka:167 帖)可能被漏掉,直接用 seed_artists 点名即可纳入——候选不再受采样池限制。插件用 style-tag 共现把所有画这个手法的画师列出来,作为第三条通道:

danbooru_style_match(style_tags="shiny_skin, sweat, lace, colored_lineart",
                     genre_tags="sex, cum", discover_small_artists=true,
                     min_artist_posts=50, small_artist_slots=3,
                     seed_artists="eigaka", limit=12)
  • min_artist_posts(默认 50)过滤过小账号;small_artist_slots(默认 3)为小画师保留名额;候选带 discovered_via_style_cooccurrence / artist_posts / small_artist / reserved_slot。
  • seed_artists 可显式点名(如 eigaka):先校验 ≥min_artist_posts,再抓其作品算 style/genre 吻合度,输出 seed_artist / seed_style_overlap,并强制进入最终名单。
  • 代价:共现每个 style tag +1 请求(最多 3 次);每个 seed +2 请求(帖数 + 作品吻合度)。

拒绝记忆与替代推荐(0.26.0 起)

用户否掉的画师不该在后面的轮次里换着理由回来。avoid_artists 现在会写入持久拒绝记忆(插件实例内有效,DSH 重载后清空):

  • 后续任何一次 style_match / similar_artists / artists_from_image / 共识调用,都会把记得的画师从自动发现里过滤掉,空出的名额由下一个最接近的替代画师补上——这就是「同一个效果、换一个不同画师」
  • 但点名即加回:seed_artists="hiten" 会重新把该画师加进候选(用 reinstated_from_rejection / rejection_memory.reinstated_this_call 标记)——拒绝记忆只拦自动发现,不会彻底封死
  • 输出 rejection_memory:remembered_artists(记忆总数)、excluded_this_call(本次被自动过滤的画师名)、reinstated_this_call(本次点名加回的画师名)
  • allow_rejected_artists=true:仅本次忽略拒绝记忆(记忆仍保留,供你重新检查)
  • forget_artists="hiten":从记忆里释放某个画师(改变主意时用);clear_rejections=true 清空全部

示例(对应「hiten 已被否掉,后面又要同一效果」的场景):

第 1 轮:  style_match(..., avoid_artists="hiten")         → hiten 被拒并记住
第 N 轮:  style_match(style_tags="<hiten 同款效果>", ...)  → hiten 不再出现,返回下一个最接近的画师
需要复看:  style_match(..., allow_rejected_artists=true)   → hiten 临时可见
彻底放行:  style_match(..., forget_artists="hiten")        → hiten 可再次正常推荐

多张参考图 / 多角色(0.18.0 起,仅 mode="character")

同一作者的一套图常常横跨好几个角色。注意:这只在 mode="character" 下生效——画风优先模式本来就不需要角色;只有当你确实要「同一个角色」时才用多角色锚定。character 接受逗号分隔的多个角色(最多 3 个,前两个会各跑一次全站高分锚点并参与同角色核验):

  • 多角色输入:danbooru_style_match(character="firefly_(honkai:_star_rail), kafka_(honkai:_star_rail)", style_tags="shiny_skin, sweat", genre_tags="sex, hetero", limit=10, examples=2)
  • 输出:reference.characters 是解析后的角色列表;anchor_scans 每个角色一条;每个候选多带 same_character_breakdown(逐角色作品数),same_character_posts 是各角色之和。
  • 推荐流程(本轮实测收敛最快):① 参考图按角色/服装分组,每组挑最接近的 style_tags 各跑一次;② 汇总多轮候选,同名画师跨轮出现的优先;③ 对 finalist 抓 2–3 张代表作和参考图拼图,按六项清单整体比对;④ 用 prefer_artists 把入选者带回再跑一轮;⑤ 最后才写画师串权重。
  • 成本:每多一个角色约多 1 + 2 + 2×limit 次请求(前两个角色参与核验)。

本轮案例(15 张同一 AI 作者参考图):Firefly 9 张、蓝发泳装 3 张,棕发蓝挑染 / 深紫发 / 红发军装 / 粉发和服各 1 张。

  • 0.17–0.18 用角色锚定得到的结论是 hews / 0haribo0 / harin_05 / greem_bang——它们确实画这些角色,但是「同角色」筛出来的,不是「同画风」筛出来的。
  • 0.23.0 改成画风优先后,同样的 15 张图跑出 nyantcha(97.6,全站前 10 + 画风核验 27–97 帖)、piutahayo、mochirong、elocca、norza、merunyaa;nyantcha / merunyaa 这类「同手但没画过 Firefly/Kafka」的画师,旧方案完全看不到。
  • 0.24.0 进一步剔除外貌权重后,候选只由画风决定;最终画师串按「画风优先候选 ∪ 角色模式候选」的交集与六项目视核对决定,详见 docs/case-2026-11-15-15refs.md。

多方案共识(0.20.0 起)

danbooru_image_artist_consensus 解决「单方案总会有误判」的问题:对同一张参考图跑 2–3 个不同方案,各自取短名单,再只保留被 ≥2 个方案同时命中的画师。

danbooru_style_match(...)            → ["elocca,mignon,piutahayo"]
danbooru_artists_from_image(...)     → ["hews,nyantcha,asou"]
danbooru_similar_artists(artist=...) → ["m-da_s-tarou,sincos,hara"]

danbooru_image_artist_consensus(
  lists='["elocca,mignon,piutahayo","hews,nyantcha,asou","m-da_s-tarou,sincos,hara"]',
  source_names="style_match,artists_from_image,similar_artists",
  min_hits=2, limit=10, examples=3)
  • 每个候选人带 hits(被几个方案命中)、hit_sources(命中方案名)、avg_rank(各方案内的平均名次,越小越靠前)
  • 排序:hits 降序 → avg_rank 升序 → 画师名
  • 没有画师达到 min_hits 时:返回按 hits 排序的部分重叠榜,并设 fallback_used=true,提示换更相近的方案或降低门槛
  • 它本身不发检索请求(只为例图发请求),所以很快;先跑各方案再喂给它
  • 局限:共识只能降低随机误判,不能证明画风真的像——最终仍要 read_image 目视核对

部位特化搜索(画手 / 画脚 / 画腿…)

danbooru_part_specialists 用 D 站的部位焦点 tag 检索「该部位 + 高收藏」作品,再按画师聚合,专门回答「谁画手/脚/腿/眼睛画得好」这类问题。

  • part 可选:hands、feet、thighs、legs、ass、breasts、hips、eyes、mouth、back、armpits、navel、belly、abs、hair、neck、pectorals
  • 每个部位取前两个 tag(如 hand_focus + hands),按 order:favcount 各扫一遍(默认 100 条),统计画师在该部位作品上的收藏总数
  • rank_by:total_favorites(默认,收藏总量)/ avg_favorites(单图均值)/ posts(作品数量)
  • min_posts:画师至少要有几张部位作品才入榜(默认 2)
  • 同时返回 posts:该部位 tag 下收藏最高的图片(默认 6 张,含 sample_url)
  • 只选图片,视频自动过滤;year 可限定年份(默认全时间)
  • 用法:danbooru_part_specialists(part="hands", year=2025, rank_by="total_favorites", artists_limit=10, posts_limit=8)
  • 局限:依赖作者打了部位焦点 tag,没打 tag 的好图会漏;最终仍需目视确认部位画法

输出约定(画师 vs 图片)

  • 画师列表:每位画师保留 3 张例图(不同作品),并分行纵向排版(每人一个块:渲染 / 体态 / 面部 / 主页 / 例图),不要用宽表格,避免被横向裁切
  • 例图软规则:默认优先取「带需求 tag(表情/体型)+ 能看到脸」的作品;只有用户明确要求背影、剪影、下半身特写等无脸构图时,才传 allow_no_face=true 允许无脸例图;example_tags 可覆盖需求 tag。danbooru_similar_artists 的 examples 会返回 matched_tags 便于核对
  • 气质降权:相似度计算里 furry / furry_female / furry_male / anthro / humanoid_furry 的权重乘 0.05,避免兽向题材拉动画师相似度
  • 避免过度写实/3D:3d、photorealistic、faux_3d 这类 tag 在相似度中降权到 0.05;以图搜画师会按候选的 3D 作品占比扣分(返回 three_d_share);例图和部位特化结果优先排除 3D 作品(找不到 2D 图时才回退)
  • 图片列表:每张图保留 1 张样图即可
  • 画风相似判定维度(目视,不只看 tag):
    1. 渲染:上色/软硬阴影、高光与材质(乳胶、亮面布料)、饱和度与色调
    2. 体态:胸腰臀/腿比例、肉感与脂肪分布、身高体型、常用姿态
    3. 面部特征与表情:脸型、眼型/眼距/瞳孔高光、鼻嘴画法、腮红、常用表情(笑/半闭眼/吐舌/害羞等)
    4. 构图:立绘/多视图/近景裁切等

凭据(登录后解除 2-tag 限制)

调用 danbooru_save_credentials 提供 login 与 apiKey:值写入 DSH 凭据库($DSH_HOME/.credentials.yaml,仅当前系统用户可读),不会出现在插件配置或工具返回值里。插件每次请求都会重新解析凭据,保存后立即生效、无需重启。

  • 查看状态:danbooru_auth_status(只报 configured / source / writable,不返回值)
  • 移除:danbooru_save_credentials({ clear: true })
  • 也可以用环境变量 DANBOORU_LOGIN / DANBOORU_API_KEY(启动环境或 $DSH_HOME/.env);凭据库中的值优先。

合规与限速(内建)

  • 每个请求都带可识别 User-Agent:dsh-danbooru-tools/0.36.0 (DeepSeek Harness; <contact>)。
  • 所有请求走单一串行闸门:匿名默认间隔 1.1 秒;检测到已保存凭据时自动切成 0.4 秒(约 2.5 次/秒,仍只有 D 站 10 次/秒上限的 1/4,多请求工具整体快约 2–2.7 倍);遇到 429 会按 Retry-After 退避重试一次。
  • 结果有内存 TTL 缓存(作品 5 分钟 / 自动补全 6 小时 / 相关 tag 1 小时 / wiki 24 小时),减少重复请求。
  • 对 Danbooru 只读:只发 GET 请求,不点赞、不收藏、不上传、不写 profile;不产生任何对站点的写入。

配置

全部可选。可用环境变量或 bundle patch 的 config 提供:

键 默认 说明
contact 空 加进 User-Agent 的身份说明,建议填 user #12345 或邮箱
minIntervalMs 1100 匿名请求的启动间隔(毫秒)
minIntervalMsAuthenticated 400 已保存凭据时的启动间隔(毫秒),必须小于站点限速
timeoutMs 20000 单请求超时
cacheTtlMs 600000 内存缓存寿命;0 关闭缓存
defaultRating all 默认分级;all 含 R18,g 只看全年龄
maxWikiChars 4000 danbooru_get_tag 返回的 wiki 摘要上限

环境变量:

变量 说明
DANBOORU_LOGIN Danbooru 用户名;与 API key 同时提供时提高限额(匿名最多 2 个 tag)
DANBOORU_API_KEY 个人页的 API key
DANBOORU_USER_AGENT 完整覆盖 User-Agent(仍要保留可识别身份)
DANBOORU_CONTACT 等同 contact 配置项
DANBOORU_MIN_INTERVAL_MS 等同 minIntervalMs
DANBOORU_MIN_INTERVAL_AUTH_MS 等同 minIntervalMsAuthenticated

改 config 需要改本目录的 cordis.patch.yml 并重装 bundle;改环境变量则重启 DSH 即可。

自检

node verify.mjs

会真实请求各查询工具(工具注册、凭据降级、年份过滤、三级加权、整年总收藏、风格闸门、人体附加参考、整体色调参考、表情画像与余弦、例图软规则、部位特化、线条/手法/服装材质效果权重、角色身份过滤、单维度降权、整体画风匹配的锚点/同角色/清单、画风优先忽略身份外貌但保留身体细节、小体量画师共现与 seed 点名、多方案共识等 83 项检查)并校验返回结构与排序,约 3–5 分钟(受串行限速影响)。不产生写入。

已知限制

  • 匿名搜索最多 2 个 tag(Danbooru 服务端限制);错误信息会提示加凭据。
  • 只读 ≠ 不能看图:插件只读 Danbooru、不提供图片下载工具,但返回作品/样本 URL(urls.sample、preview_url 等)。目视核验时由 Agent 用 curl / pwsh 从这些 URL 临时下载到本地、看完即删;插件自身不发起图片下载。

图片核验(Agent 侧工作流)

  1. 用 danbooru_search_posts(urls.sample)或 danbooru_year_artists(best / newest / style.best 里的 sample_url)拿到可下载的样图 URL;
  2. 用 curl 下载(CDN 有防盗链,必须带 Referer,否则 403): curl.exe -L -e "https://danbooru.donmai.us/" -o sample.jpg "<sample_url>"
  3. 用 read_image 查看;核验完删除临时文件(不进入插件目录、不长期保存)。
  • 插件没有「批量下载图片」的工具;下载发生在 Agent 的 shell 侧,属于会话临时操作,不是插件能力。
  • 内容分级默认返回全部(含 R18);需要全年龄内容时显式传 rating="g",结果可能不适合所有场景。
  • 只返回图片:所有工具都会过滤掉视频与动画作品(mp4/webm/mkv/mov/avi/m4v、ugoira 的 zip,以及 meta 里带 ugoira/video 的帖子),搜索、画师参考图、例图都只给静态图;danbooru_get_post 按 id 查询除外(显式请求仍可看到原帖信息)
  • wiki 摘要是截断后的纯文本,保留了 Danbooru 的 wiki 标记(如 [[tag]]),不是渲染后的富文本。

更新记录

  • 0.36.0:新增 danbooru_surface_profile(表面质感判定)——8 轴打分区分「雾面厚涂/油腻」与「亮面赛璐璐/镜面」,profile 可做闸门、reference 算 surface_similarity;danbooru_pixel_style_match 每个候选附带 matte / surface / surface_similarity 并支持 surface_gate="matte_thick"|"gloss_cel";同时画师串分隔符修正——tag 以数字结尾时逗号前自动补空格(hews 2024 , hews 2025 , ...),六槽 artist_string、artist_soup、像素 artist_string 全部生效;verify.mjs 增加分隔符自检(共 83 项)
  • 0.35.0:画师串分隔符修正——tag 以数字结尾时,逗号前自动补一个空格(hews 2024 , hews 2025 , ...),避免 NAI tokenizer 把数字与 , 粘成一个 token;统一由 joinArtistString 处理,六槽 artist_string、artist_soup、像素匹配 artist_string 全部生效;verify.mjs 增加分隔符自检(共 83 项)
  • 0.34.0:danbooru_artists_from_image 修正「全局排名截断会剔除单方面专精画师」——新增逐维度榜首榜 aspect_leaders(person / expression / technique / lineart / clothing / color / lighting / tag 各一名,带 evidence / global_rank / in_string):某个方面最强的画师即便全局排名掉出 limit,也照样进入槽位池;没抢到槽位的榜首不删除,改为进入 try_next(建议权重 0.15 + 理由「它是某方面的最大贡献者,先加再比」);artist_string_slots 增加 from_aspect_leader 标记。实测 limit=5 时,原本会被截掉的 tayuido(全局第 9)、mdf_an(16)、optionaltypo(22)、valtor(133)里,3 位直接拿到槽位、1 位进入 try_next;verify.mjs 增加 4 项自检(现共 81 项 check());同时补齐参考图下载:danbooru_pixel_style_match 的 reference_images 现在接受直接图片 URL / D 站帖子 URL(/posts/,经 API 解析)/ 本地文件路径,下载带 UA+Referer(CDN 防盗链),非图片响应与视频帖子给出明确错误,verify.mjs 增加帖子 URL 参考图自检(共 82 项)
  • 0.33.0:danbooru_style_match 新增成品画师串 artist_soup(并加入本轮改动:权重为 1 的 tag 裸输出,不再被 :: 权重框包裹——artist_soup 的 1.0 anchor 直接是 hews;buildArtistString / naiWeightedName 统一走 formatWeightedTag,权重 1 判定支持 1 与 1.0),——按 1.0 / 0.85 / 0.6 / 0.5 / 0.4 / 0.3 / 0.2 的权重形状(最多 7 位、top3_share 约 0.65~0.70)把最终候选拼成可直接粘贴的 NAI 串,输出 string / artists[] / total_weight / top3_share;两条 NAI 书写规则内置:权重 1 不加 :: 框、名字以数字结尾时在 :: 前补空格。该形状来自 2026-11-15 的实测回归:没有 1.0 锚的串会向「所有人的平均」漂移,而 ≤0.3 的长尾(0.24 / 0.16 / 0.12)只增加噪声;删掉排第一的名字来「清理」画师串会让画面明显跑偏
  • 0.32.0:danbooru_artists_from_image(以图找画师)的交付物改为画师串——新增「六槽职责构成」(body 0.85 / skin 0.60 / brush 0.50 / material 0.40 / accent 0.20 / theme 0.30),一槽一位画师、同一位不重复占槽,权重按「该职责在画面里的占比」而不是检索分或画师名气给;输出 artist_string(NAI 语法,括号自动转义)与 artist_string_slots(每槽命中的维度证据),新增 string_style(plain / artist_prefix)与 string_slots;空槽跳过不凑数;verify.mjs 增加 4 项自检(脚本现共 77 项 check())
  • 0.31.0:danbooru_pixel_style_match 新增年份标注——对每个返回画师比较指定年份(默认去年+前年,如 2025/2024)的作品与参考图的像素相似度,在画师名后追加更贴近的年份:单年贴近 → hews 2025,两年都贴近 → hews 2024 2025;输出 year_fit / years / artist_with_years 与整份 artist_string;year_check / years / year_samples / year_tolerance 可调;verify.mjs 增加年份标注自检(共 68 项)
  • 0.30.0:按最近 72 小时会话日志的真实调用量精简工具集——默认只注册 11 个核心工具(search_tags 565、search_posts 287、get_tag 129、related_tags 43、style_match 42、similar_artists 39、artists_from_image 30、year_artists 24、pixel_style_match、凭据×2);低频的 top_artists(11)、part_specialists(10)、image_artist_consensus(2)、get_post(18)移入 toolPreset="full"(或 DANBOORU_TOOL_PRESET=full),代码保留;verify.mjs 增加 core/full 预设自检(共 67 项)
  • 0.29.0:新增 danbooru_pixel_style_match(像素相似匹配)——不再用 tag 共现排序:tag 通道只提名候选画师,候选样图与参考图下载后由本地 Pillow 描述子(线条/边缘、明暗平滑度、色彩丰富度、饱和度、色相直方图)做图对图距离排序;身份/外貌 tag 完全不参与,解决「白毛图→白毛画师」问题;需要 Python+Pillow(DSH_PYTHON 可覆盖),15 个工具,verify.mjs 增加像素自检(共 66 项)
  • 0.28.0:删除客户端候选池上限,新增采样深度控制——anchor_pages(默认 400 篇/tag)、deep_scan_pages(默认 0,最大 500 页 = 10 万篇,可把中小 tag 的画师基本翻完)、pair_pages、cooccurrence_limit(默认 200 = API 上限)、cooccurrence_tags;输出 pool_stats 报告实际池子;诚实说明 99% 全站覆盖需翻完大 tag(不可行),deep_scan_pages 覆盖中小 tag;verify.mjs 增加宽池自检(共 65 项)
  • 0.27.2:删除「检索器只能在高分/热榜/共现前 100 里筛选」的旧限制描述——自动通道仍按高分/热榜/共现采样,但 seed_artists 可点名纳入任意画师,候选不再受采样池限制;工具参数说明、输出 note 与 README 同步
  • 0.27.1:更新插件介绍——DSH 描述、package.json 描述与 README 开头同步为当前 14 个工具与能力(画风优先匹配、小体量画师、seed_artists、拒绝记忆、多方案共识、服装材质效果、身份特征过滤、单维度降权等);清理旧版本安装包与调试用对比图
  • 0.27.0:拒绝记忆的语义修正——只拦自动发现,点名即加回:avoid_artists 记住的画师仍会被自动检索过滤(换下一个最接近的替代者),但 seed_artists 显式点名时会重新加进候选并标记 reinstated_from_rejection / rejection_memory.reinstated_this_call;allow_rejected_artists / forget_artists / clear_rejections 行为不变;verify.mjs 断言同步为「自动过滤 + 点名加回」(共 64 项)
  • 0.26.0:新增持久拒绝记忆与替代推荐——avoid_artists 会记住被否的画师,后续轮次自动过滤,空出的名额由下一个最接近的画师补上(不再用同一个名字凑数);allow_rejected_artists 仅本次忽略、forget_artists 释放单个、clear_rejections 清空;style_match / similar_artists / artists_from_image / 共识均生效,输出 rejection_memory / rejected_excluded;verify.mjs 增加 2 项自检(共 64 项)
  • 0.25.0:style_match 引入 body_tags(身体细节次级证据)——体型/肤色/乳晕/肉感这类「身体细节的画法」是合法画风证据(不同画师差别极大),以 style×body、body×genre pair 与 body_posts/body_share 参与排序(画风模式权重 0.38 锚点 + 0.15 pair + 0.15 画风核验 + 0.12 身体细节 + 0.08 共现 + 0.12 seed);同时过滤身份/外貌 tag(发色、瞳色、发型、饰品、服装名、角色名)并列入 reference.rejected_body_tags;subject_tags 改为 body_tags 的兼容别名;verify.mjs 改成断言「身体细节进入查询、发色被拒绝」;README 同步
  • 0.24.0:style_match 初步剔除外貌权重——角色外貌(白毛/红瞳/服装)不再参与锚点、pair、核验与排序;style 模式锚点改为前两个 style tag(无 style 时退化为题材),pair 只保留 画风×画风 / 画风×题材;README 从 0.20.0 干净版本重建并补回 0.21–0.23 文档
  • 0.23.0:style_match 改为画风优先(style-first)——默认 mode="style" 不使用角色 tag(同角色≠同画风;实测旧的角色锚定漏掉 nyantcha/merunyaa 这类同手画师),mode="character" 才用角色锚点;pair 改为 画风×画风/画风×题材,核验改为 画师×锚点画风 tag(style_posts);输出新增 reference.mode / candidates[].style_posts
  • 0.22.0:style_match 新增 seed_artists 显式点名称——共现 API 只覆盖每个 style tag 前 100 名画师,eigaka 这种「相关帖分数低、共现频率低」的 167 帖小号仍会漏;现在可 seed_artists="eigaka" 强制纳入(先校验 ≥min_artist_posts,再抓其作品算 style/genre 吻合度,输出 seed_artist / seed_style_overlap);同时修正小画师保留名额只分配给 <1000 帖的账号,并在 small_artist_discovery.top 列出共现发现的小画师前 10
  • 0.21.0:style_match 新增小体量画师发现——style-tag 共现(related_tag)通道把低于热度门槛的小画师(如 eigaka,167 帖)拉进候选;min_artist_posts(默认 50)过滤过小账号,small_artist_slots(默认 3)保证它们不被挤出名单,候选输出 discovered_via_style_cooccurrence / artist_posts / small_artist / reserved_slot
  • 0.20.0:新增 danbooru_image_artist_consensus(多方案共识)——融合 style_match / artists_from_image / similar_artists 等多份候选名单,只保留被 ≥min_hits 个方案命中的画师;带 hits/hit_sources/avg_rank,无交集时返回部分重叠榜并标 fallback_used;verify.mjs 增加 1 项自检(共 59 项)
  • 0.19.1:clothing 维度明确改为「服装材质效果」——只衡量反光/高光、透明度、湿身、蕾丝/丝绸厚度与褶皱;服装款式名词(lingerie、bra、shirt…)作为身份特征被过滤,不再影响该项权重;文档与参数说明同步
  • 0.19.0:按「整体画风匹配(style_match)」的实测结论优化识图——README 把 danbooru_style_match 定为以图搜画师首选、artists_from_image 降为交叉验证;artists_from_image 新增单维度证据降权(多维度搜索时 ×0.55,输出 single_dimension / dimensions_used),修掉「只靠 lineart 像就上榜」的问题
  • 0.18.1:artists_from_image 不再把角色身份/装饰特征当成画风证据——发色、瞳色、角、光环、兽耳、尾巴、饰品、服装名词(lingerie、bra、shirt…)在评分前剔除并返回 excluded_identity_tags;材质 tag(latex、lace、see-through_clothes)保留。全部 tag 都是身份特征时明确报错,提示改传绘制手法类 tag
  • 0.18.0:danbooru_style_match 支持多角色——character 可传逗号分隔的多个角色(最多 3 个,前两个各跑全站高分锚点并参与同角色核验);新增 reference.characters 与 same_character_breakdown(逐角色作品数,总数仍为 same_character_posts);verify.mjs 增加多角色自检;README 增加「多张参考图 / 多角色」工作流与 15 图案例
  • 0.17.0:新增 danbooru_style_match(整体画风匹配):角色锚定 + 全站高分 order:score 扫描(名次衰减加权)+ 角色×题材/画风、画风×题材 pair 兜底 + 画师×角色 同角色核验 + 例图;输出六项目视核对清单与 prefer_artists/avoid_artists 迭代参数,返回新增 anchor_scans、anchor_score/pair_score/chart_top 字段(全站前 10 名作品额外 ×1.3);verify.mjs 增加 5 项自检
  • 0.16.1:README 在「宇宙免责声明」与「安装」之间新增「大致使用教程(截图版)」三张示例图(以图搜画师 / 按年份找色彩艳丽作品 / 相似画师+年份限定),图片存于 docs/tutorial/
  • 0.16.0:artists_from_image 新增 服装质感 维度 clothing_tags(person 0.10 / style 0.12,专吃 latex、leather、shiny_clothes、see-through_clothes 等材质 tag);线条/手法权重微调(person 0.18/0.22、style 0.24/0.28),其余维度等比下调,总和仍为 1
  • 0.15.2:加强线条与绘制手法的参考权重——artists_from_image person 模式 lineart 0.12→0.20、technique 0.20→0.24;style 模式 lineart 0.18→0.26、technique 0.26→0.30(其余维度等比下调,总和仍为 1)
  • 0.15.1:性能优化——登录后自动使用 0.4 秒限速间隔(匿名仍 1.1 秒),多请求工具整体快约 2–2.7 倍(实测 12 请求的 year_artists 12.8s → 6.4s);新增 minIntervalMsAuthenticated / DANBOORU_MIN_INTERVAL_AUTH_MS;其他行为、输出与排序不变
  • 0.15.0:借鉴以图搜图的「近重复聚类」——以 parent_id/md5 把同一张画的不同变体(改色、裁切、variant 帖)归为一个视觉簇;artists_from_image 按簇去重后再聚合证据,例图只取不同簇;part_specialists 也按簇折叠重复图;输出增加 dedupe 与每组 unique_clusters / deduped_posts
  • 0.14.0:眼睛色彩从「人体附加参考」中移除;新增「整体色调参考」color_tags / color_match / color_threshold(monochrome、limited_palette、pastel_colors、blue_theme、colorful、iridescent 等),返回 color.per_tag 与 color.best 参考图
  • 0.13.0:danbooru_year_artists 新增「人体附加参考」appearance_tags / appearance_match / appearance_threshold:在同一批核验作品上统计肤色、皮肤质感 tag(per_tag 命中数 + ratio + appearance.best 参考图),可只统计或按比例加闸门
  • 0.12.2:插件标题/介绍统一加 DSH- 前缀,并明确标注「DSH bundle,不是可独立运行的程序」
  • 0.12.1:仓库转为公开;README 与插件介绍标注「AI 制作」;安装章节拆分为「下载包 / git clone + link / 源码 zip」三种方案;新增「宇宙免责声明」(跑路条款)
  • 0.12.0:过滤/降权 3D 渲染(3d/photorealistic/faux_3d):相似度降权 0.05、以图搜画师按 three_d_share 扣分、例图与部位图优先排除 3D
  • 0.11.0:以图搜画师新增 lineart_tags(线条)与 lighting_tags(光照)维度,且每个维度最多 4 个 tag 全部参与检索(之前只查前两个),线条/色彩/光照正式进入评分
  • 0.10.1:以图搜画师默认不限年份(year 不填=全时间),修复输出里的非 JSON 值导致 not lossless JSON 的问题
  • 0.10.0:新增 danbooru_part_specialists(部位特化:按部位焦点 tag 的高收藏作品聚合画师排名 + 部位高收藏图片)
  • 0.9.1:全工具只返回图片(过滤 mp4/webm 等视频;搜索、画师参考图、例图均跳过视频)
  • 0.9.0:新增 danbooru_artists_from_image(以图搜画师,分层优先级:人物→表情→绘制手法→色彩→tag;mode="style" 时手法/色彩优先)
  • 0.8.3:清理过时文档(重复的安装章节、旧的自检耗时、工具数量),DSH 内与仓库说明同步为当前能力(表情画像/余弦、例图软规则、furry 降权)
  • 0.8.2:例图改为软规则(默认优先带脸,allow_no_face=true 放行无脸构图);furry 类 tag 相似度权重 ×0.05;过滤无 sample_url 的例图
  • 0.8.1:例图强制匹配需求 tag 并跳过隐藏脸的构图(已由 0.8.2 改为软规则)
  • 0.8.0:相似画师新增表情画像、表情 tag 扩展、稀有度加权表情余弦与风格重叠检查
  • 0.7.2:例图按需附带样图 URL(examples)
  • 0.7.0:新增 danbooru_similar_artists(tag 画像相似画师)
—/ 5

No ratings yet

Verified DSH bundle

Commit 3ce80b6c1eaa

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout