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 的公开检索结果搬过来。
- 版权归属:所有作品与数据来自 Danbooru 公开 API,版权归各画师、权利人与 Danbooru 所有;本项目不存储、不转售、不再分发任何图片。
- 使用范围:仅供个人学习、研究与 AI 绘画提示词参考;请遵守 Danbooru 服务条款与当地法律。插件内置串行限速:匿名 1.1 秒 / 登录后 0.4 秒(仍远低于 D 站约 10 次/秒上限)——别拿它去 D 站刷屏,被限流了自己改
minIntervalMs冷静一下。 - 凭据安全:API key 只存在你本机的 DSH 凭据库(owner-only),插件不收集、不上传、不打印、不写进缓存/仓库/发布包。
- 结果不保证:检索是 tag 频率/收藏数的启发式,可能不准、可能过时、可能「过于写实/有点 3D」——这属于正常波动,不是插件在针对你。
- 侵权处理:如果你是权利人或发现误标,欢迎提 issue 或联系作者;我们会在跑路之前先配合下架/修正(顺序很重要)。
- 跑路条款:若因使用本插件产生任何争议、索赔、限流、封号、世界末日或宇宙热寂,作者(AI Agent 及其人类甲方)将在 0.5 秒内原地跑路,不承担任何责任;届时本免责声明自动升级为「宇宙级」,并保留最终解释权(解释权也会一起跑路)。
—— 祝调参愉快,收藏永涨 📈
大致使用教程(截图版)
⚠️ 这只是「大致教程」:截图来自插件开发调试时的真实会话,仅演示「怎么提问 / 工具输出长什么样」,不是严格步骤文档;具体参数、年份和结果以实际查询为准。
① 以图搜画师:给它一张图,找画风相近的画师

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

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

安装(DSH profile)
本插件是 DSH bundle(纯 Host、零运行时依赖),以下三种方式任选其一。首次装完需重启 DSH;之后更新插件文件只需在 plugin_manager 里关→开热重载,不用重启。
方案 A:下载包(推荐,不需要 git)
- 下载最新 zip:Releases → v0.12.1 →
danbooru-tools-0.12.1.zip - 解压到任意目录,得到
danbooru-tools/ - 安装:对 Agent 说「用
plugin_manager的install_bundle安装<解压目录绝对路径>」,或在 DSH 插件管理界面选择该目录 - 重启 DSH
- 适合:不想装 git、只想能用
- 更新方式:重新下载 zip 覆盖目录 → 关→开热重载
方案 B:Git 克隆 + profile link(推荐长期使用 / 二次开发)
git clone https://github.com/big-fat-fish-agent/danbooru-search-device.git- 在
$DSH_HOME/profiles/<profile>/package.json的dependencies里加:"@local/dsh-danbooru-tools": "link:<克隆路径>" - 把
"@local/dsh-danbooru-tools"加进同一文件的dsh.bundles列表 - 重启 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(默认)或allcolor_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):
- 取种子画师的
related_tag,筛出「对 TA 高频、但全站不算通用」的 general tag(排除1girl、highres、背景色等结构性 tag),作为风格画像(profile_tags,默认取 6 个) - 表情画像:从种子画师的 tag 画像里挑出表情 tag(
smile、blush、open_mouth、half-closed_eyes、tongue_out等,expression_tags默认 4 个),用它们把「表情习惯相近」的画师也拉进候选池 - 对每个画像 tag 查
related_tag&category=artist,收集共享该 tag 的画师,按频率 × tag 稀有度加权累加 - 候选 = 风格画像候选 ∪ 表情画像候选;表情候选必须通过「风格 tag 重叠检查」(同一批
related_tag里能查到种子风格 tag),避免只表情像、画风完全不像 - 最终分数:
(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 实测调优):
- 先跑
danbooru_style_match(整体画风匹配)——它扫全站高分作品、做画风×画风 / 画风×身体细节 / 画风×题材配对(默认不用角色、也不用发色瞳色服装,但允许体型/肤色/乳晕等「身体细节画法」作为次级证据),最贴近「整体观感」;实测比纯 tag 加权更稳(能避开「只靠线条像」的误判,也不会因为「画过同一角色/同一发色」就被当成同手)。用style_tags描述渲染手法、body_tags描述身体细节、genre_tags描述题材。 - 再用
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",默认):
- 全站高分锚点(核心):前两个
style_tag各查一次order:score前 200 张,按名次衰减加权——名次越靠前权重越高。单 tag +order:score只占两个 tag 额度,匿名也能用,而且能覆盖几年前的高分老图;没有 style tag 时才退化为用 body/题材 tag 当锚点。 - pair 查询兜底:
画风×画风、画风×身体细节、画风×题材、身体细节×题材各最多 2 组(每组正好两个真实 tag);pair 只能取最新页,客户端再按分数排序,用来补近期/新画师。不出现角色/发色/瞳色/服装 tag。 - 画风核验:对候选逐个查
画师×锚点画风 tag,统计该画师自己带这个画风的帖子数——直接衡量「他是不是画这种手」;这段查询返回的作品同时就是最好的例图。 - 加权排序(画风模式):
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剔除。 - 返回
verify.checklist(线稿 / 上色 / 色调 / 人体 / 脸 / 构图 六项目视核对清单)与iterate.hint,方便下一轮接着迭代。 - 成品画师串(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 篇/tagdeep_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):
- 渲染:上色/软硬阴影、高光与材质(乳胶、亮面布料)、饱和度与色调
- 体态:胸腰臀/腿比例、肉感与脂肪分布、身高体型、常用姿态
- 面部特征与表情:脸型、眼型/眼距/瞳孔高光、鼻嘴画法、腮红、常用表情(笑/半闭眼/吐舌/害羞等)
- 构图:立绘/多视图/近景裁切等
凭据(登录后解除 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 侧工作流)
- 用
danbooru_search_posts(urls.sample)或danbooru_year_artists(best/newest/style.best里的sample_url)拿到可下载的样图 URL; - 用
curl下载(CDN 有防盗链,必须带 Referer,否则 403):curl.exe -L -e "https://danbooru.donmai.us/" -o sample.jpg "<sample_url>" - 用
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(以图找画师)的交付物改为画师串——新增「六槽职责构成」(body0.85 /skin0.60 /brush0.50 /material0.40 /accent0.20 /theme0.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_tags565、search_posts287、get_tag129、related_tags43、style_match42、similar_artists39、artists_from_image30、year_artists24、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×genrepair 与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_imageperson 模式 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_artists12.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 画像相似画师)
No comments yet. Be the first to write one.