前言¶
在 DeepSeek Harness（DSH）里做多模态生图或对照参考出图时，常见做法是在浏览器里开图库、手动保存图片、再贴进对话框并手写提示词。步骤多、容易漏图或词不对齐。油猴脚本《AI 生图参考图一键填充》已经验证了「选图 + 拼提示词 + 写入输入框」的工作流，但依赖用户脚本管理器和页面匹配声明。
dsh-ref-autofill 是同一思路的 DSH 插件版：保留原有 UI 与数据层逻辑，由 dsh plugin 安装、在 dsh web 客户端内加载，不再需要油猴运行时。下面介绍它做什么、怎么装、怎么用，以及使用时需要注意的数据与授权边界。
这是什么¶
dsh-ref-autofill（维护者 dddaniel1）是 DeepSeek Harness 的参考图一键填充插件，分类属于联网工具。它在 dsh web 里提供中文 AI 参考图库浏览面板，选中脸 / 服装 / 姿势等参考后，把高清原图写入对话框附件区、把生成的提示词写入编辑器；是否发送由你自己决定。
插件由原油猴脚本 dsh-ref-autofill.user.js 插件化而来：站点适配与交互原样保留，存储从 GM_getValue 改为 localStorage（键名不变）。参考库数据运行时从公开 CDN 按需读取，不打包进插件仓库。
核心功能¶
已核实的能力如下（数量以 README 记载、安全模式开启时姿势库为准）：
- 三个参考库：脸（1499 项）、服装（3224 项）、姿势（153 项）。
- 搜索与筛选：中文 / English / 编号全文检索；脸可按发长·发型过滤，服装可按大类·分类，姿势可按体系·动作分类。
- 姿势多视角：正面 / 俯视 / 仰视 / 侧面 / 斜侧；可在 3D 白模与深度图（ControlNet Depth）之间切换。
- 提示词生成：按所选图拼出「图1 人像参考 / 图2 服装参考 / 图3 姿势参考」，支持风格预设、补充描述、改写与一键复制。
- 本地图片：托盘未选槽位可上传本地图，与图库混搭。
- 一键填充：高清原图进 DSH 输入框附件区，提示词进编辑器；重复填充自动去重。
- 交互细节：安全模式、参考图数量上限、面板可拖动/缩放/吸附、跟随 DSH 明暗主题、
Alt+Shift+R呼出面板。
网络请求走浏览器 fetch；三个数据源均返回 Access-Control-Allow-Origin: *，插件仅在 DSH 客户端内运行，无需 @match / @connect 类声明。
安装与启用¶
从 GitHub 安装（命令来自项目 README）：
dsh plugin --profile web add github:dddaniel1/dsh-ref-autofill
dsh web
本地开发或调试时，可将仓库路径直接加入 web 配置：
dsh plugin --profile web add /path/to/dsh-ref-autofill
启动 dsh web 后，页面右下角出现「参考库」按钮，点击展开面板；也可使用快捷键 Alt+Shift+R。
package.json 声明引擎要求：node >= 20，dsh >= 0.2.1-rc.5 且 < 0.3.0。插件当前版本为 1.0.0，许可证 MIT。
典型用法¶
按 README 的可复现步骤操作即可：
- 在「脸 / 服装 / 姿势」标签里点卡片选参考图；姿势库可按需切换角度或深度图。
- 需要时用本地上传填满未使用的槽位。
- 检查自动生成的提示词，按需换风格预设或补充描述。
- 点「填充到对话框」，核对输入框中的图片与文字，确认无误后再自行点击发送。
插件不会替你发消息；填充只是把素材与文字准备好，发送时机仍由你控制。
适用场景与注意¶
适合谁：在 DSH Web 里做 AI 生图、需要系统化对照脸 / 服 / 姿势参考，并希望减少「找图 → 下载 → 粘贴 → 写词」重复劳动的开发者或创作者。
数据与授权：参考库数据来自开源项目 anhao/ai-pose-gallery-zh。人像脸库与中国历代服饰为 CC0；姿势库与其余服装库图片禁止二次分发。插件运行时按需从 CDN 读取，不转储、不再分发图片。使用前请阅读上游仓库与 README 中的署名与限制。
安全与信任：插件以当前 DSH 进程及浏览器上下文权限运行，会发起对外 fetch。安装前建议查看 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。DSH 社区插件目录（如 SkillHub 目录页）为独立生态站点，与 DeepSeek / 幻方无官方从属关系；「一切皆插件」是 DSH 的设计取向，不代表官方应用商店审核。
仓库提供 test/e2e.js，可在真实 DSH 页面控制台调用 runE2E() 做自检（见 README「插件结构」一节）。
结尾¶
dsh-ref-autofill 把中文 AI 参考图库嵌进 dsh web，用一键填充把高清参考图与结构化提示词同步到对话框，同时去掉对油猴的依赖。若你的工作流已经在 DSH 里，可按上文命令安装，用「参考库」面板或 Alt+Shift+R 开始选图。
