前言¶
在 DSH 里跑陪伴类智能体,常见需求是让模型不只说话,还能按「此刻穿什么、人在哪」出一张图,并在 QQ 等桥里用 markdown 路径直接发图。自己拼 prompt、对接生图 API、还要和剧本插件对齐上下文,步骤多且容易和旧版工具链脱节。dsh-feiyu-image(维护者 Vansnc,社区分类:模型推理)把这件事收成模型可调的一个工具 shoot:自动拼固定角色特征、可变穿着与场景,落盘 PNG,回复里写  即可。
这是什么¶
dsh-feiyu-image 是 DeepSeek Harness 的 npm 插件(当前版本 0.5.0,MIT,要求 Node.js ≥ 22)。定位为「给陪伴角色一个相机」:模型调用 shoot 即可生成并保存图片。生图默认走火山方舟 Seedream 5.0(doubao-seedream-5-0-pro-260628,2048×2048),并保留百炼 Token Plan 的 wan2.7-image 作为备用后端。与已停在 0.1.7、依赖旧版 dsh-tools 的 dsh-image-studio 不同,作者针对当前 dsh 0.2.x 单独实现了单一工具方案。
配套生态上,安装 dsh-feiyu-life 后,提示词会读取「今日剧本」里的穿着与场景;未装仍可用,只是提示词少这两项。
核心功能¶
下面介绍插件向模型暴露的能力和运行约束,均来自仓库 README。
工具 shoot¶
| 参数 | 说明 |
|---|---|
提示 |
可选,画面里还想要什么 |
类型 |
selfie 自拍,或 scene 只拍场景 |
生成流程要点:
- 提示词自动拼接:固定特征(长相、发色、耳、尾、瞳色等,每次一字不差带上)、可变服装(默认女仆装;睡衣、浴巾、外出服等以画面描述为准)、此刻穿着(来自
dsh-feiyu-life剧本,若已安装)、场景、光线与画风。 - 硬比例约束:日系成人向、七头身、非 Q 版;画风为二次元(日系成人向动画、赛璐璐上色)。文档中的角色设定为鲸鱼娘(蓝发、鲸鱼鳍耳、鲸鱼尾、女仆装等),同一角色靠固定特征与固定
seed跨场景保持同一张脸,服装为可变量。 - 出图保存路径:
~/.dsh/feiyu-image/feiyu-<时间戳>.png。 - 节流:默认每天最多 8 张、两次调用至少间隔 30 秒(可在配置中调整)。
- 生图失败会返回原因,不会卡住整轮对话。
与 QQ 桥的衔接¶
回复中使用 markdown 图片语法,例如 ,QQ 桥会把路径抽成图片段发送。
成本与耗时(文档记载)¶
单张约 18–22 秒,2048×2048 PNG(约 7MB);按 Token Plan 的图片额度计费,一张一次。
安装与启用¶
先做插件安装,再确认百炼 Token Plan 配置文件存在(与 bailian-tp 插件共用)。
dsh plugin --profile web add dsh-feiyu-image
需要 ~/.dsh/bailian-tp/config.json(Token Plan 的 key 和 base)。
DSH 插件在当前 dsh 进程权限下运行;安装前建议在 GitHub 查看源码与 MIT 许可证,确认符合你的环境与合规要求。社区目录页:https://www.skillhub.cn/plugins/Vansnc/dsh-feiyu-image;仓库:https://github.com/Vansnc/dsh-feiyu-image。
配置¶
配置文件路径:~/.dsh/feiyu-image-config.json(不存在则使用默认)。示例字段如下:
{
"总开关": true,
"模型": "wan2.7-image",
"外观": "中国大陆 21 岁女大学生,素颜淡妆,黑色齐肩发,皮肤偏白,身形偏瘦",
"风格": "手机随手拍,自然光,轻微胶片颗粒,真实质感,不过度磨皮",
"每日上限": 8,
"最短间隔秒": 30,
"存图目录": ""
}
文档另提到:可将参考图放在 ~/.dsh/feiyu-image/角色设定/正面.jpg,用于锁定脸、发色渐变、鲸鱼鳍耳、呆毛、鲸鱼尾、女仆装款式等;改设定时也可对照 ~/.dsh/feiyu-image/角色-设定.png。
典型用法¶
模型侧调用示例:
shoot 类型=selfie 提示="把刚取到的画册摊在桌上,低头看画面"
shoot 类型=scene 提示="宿舍窗台上的绿萝,傍晚的光"
用户侧在模型回复里用  引用落盘文件即可发图。
适用场景与已知边界¶
适合谁: 已在 DSH web profile 下跑陪伴角色、需要「剧本上下文 + 生图 + QQ 发图」一条链路的开发者;愿意使用火山方舟 Seedream 5.0 或百炼 wan2.7-image 并完成 bailian-tp 配置的用户。
需要注意:
- 文档记载当前部分接口不接受同时传文本与参考图(传参考图可能 400:
Either 'text' or 'image' must be provided, but not both),因此无法完全用「角色参考图 + 指令」锁脸;现方案靠固定设定与固定seed保持「同一人」观感,细节仍可能漂移;要更强锁定需 LoRA 或支持 image-edit 的接口。 - 画面中的中文文字(黑板、书页等)容易糊成乱码,尽量避免需要辨认的字。
- 穿着与场景自动衔接依赖
dsh-feiyu-life。
反馈¶
问题可到 GitHub 开 issue(https://github.com/Vansnc/dsh-feiyu-image/issues),附上插件版本与相关图片。
经过上面的步骤,dsh-feiyu-image 把生图收敛为模型的一个 shoot 调用:上下文从剧本插件读取,图片落盘到 ~/.dsh/feiyu-image/,再通过 markdown 路径对接 QQ。目录与源码分别以 SkillHub 与 GitHub 为准维护与迭代。