前言¶
在 DeepSeek Harness（DSH）里做智能体或日常对话时，经常需要「说一句话就出一张图」：插图、海报草图、界面 mock 等。若每次切到浏览器 Playground、再手动下载保存，会话上下文和本地归档都会断档。社区插件 dsh-moss-image（维护者 Akashyc）把 MOSS-Image 文生图接口接到 DSH：模型调用 image_generate 工具，图以附件出现在会话里，并写入你指定的本地目录；2.x 起还带侧栏图库、相册与画风等能力。本文按仓库 README 说明定位、安装与用法；插件为 MIT 社区作品，非 DeepSeek 或 Moss 官方出品。
这是什么¶
dsh-moss-image 是 DSH bundle 插件：在对话中描述画面，由模型调 Moss 文生图接口生成 PNG，展示在会话中并落盘。当前 package 版本为 2.1.0（2026-11-03）。依赖自备 Moss API Key，调用费用由使用者承担。
核心功能¶
下面列出的行为均来自项目 README，装好后可在 设置 → 侧栏 Moss 生图 与 Moss 图库 中验证。
对话生图¶
- 模型调用工具
image_generate，图片以附件显示，可点开查看。 - 一次只出一张 PNG；单张可能需几十秒到数分钟，属接口常态。
- 输入框左侧有「生图」按钮，会把「画一张图：」 prepend 到草稿，保留已有文字。
提示词与布局¶
- 服务端智能改写（默认开）：与 Moss 官方 Playground 一致，描述可原文照传；画面里要出现的文字会原样保留。
- 可选 让 DeepSeek 优化提示词、转成英文提示词；与智能改写同时开会互相限制，布局生图开启时智能改写会自动关闭。
- 布局生图（默认开）：海报、精确文字位置时，模型按左上角原点给出元素框，插件换算成接口所需的中心坐标 layout JSON。
种子与改图¶
- 同一会话内迭代改图默认 沿用上一张种子，只改提示词相关表述；说「换一张」才换新种子。
- 会话种子只在内存中，重启 DSH 后每个会话的第一张重新随机。
- 同种子可保持构图与大样，但改尺寸或模型会得到不同结果。
本地保存与校验¶
- 全部图片写入同一 绝对路径 目录（默认
~/Pictures/Moss）；设置页「试生成」也进同一目录。写失败会先放缓存并说明，同名加序号不覆盖。 - 尺寸本地拦截：每边 256–2048、16 的倍数、总像素 ≤ 2097152，不合格不发请求、不计费。
- 不自动重试：超时后服务端可能仍在生成，自动重发会导致重复计费。
Moss 图库（2.x）¶
侧栏 Moss 图库 以文件夹方式管理：相册排在列表前、双击进入、面包屑或 Backspace 返回；支持单击选中、Ctrl/Shift 多选、框选、右键菜单、Delete 删除；双击图片打开大图。元数据在保存目录下的 library.json（v2 格式，旧格式自动兼容）。
画风与配置¶
- 设置里可选画风，选中后固定提示词拼在描述最前面；默认不追加。扩展画风需改仓库
lib/styles.js。 - API Key 存入 DSH 凭据服务（键名
MOSS_API_KEY），不写配置文件、不回显。默认接口地址https://api.mosi.cn，默认模型moss-image-sft-1.0。
安装与启用¶
安装从 GitHub 直接解析，不打包 npm、不用 tgz。github: 前缀由 pnpm 解析，公开仓库无需登录；安装的是默认分支当前提交。装完需 重启 DSH，并在 设置 → 插件 → Moss 生图（README 中亦写设置侧栏 Moss 生图）填写 API Key（在 platform.moss.cn 申请）。
让 Agent 安装（推荐）¶
对 agent 说明：
安装插件 github:Akashyc/dsh-moss-image
插件管理页¶
路径：插件 → 添加插件，地址填：
github:Akashyc/dsh-moss-image
然后安装。
安装脚本¶
在仓库目录执行（ --apply 才会真正改 profile）：
node install.mjs --apply
不加 --apply 仅打印将要修改的内容。更新时可重跑上述命令（脚本会额外执行 pnpm update）；或先卸载再按同一地址安装。
手动写 profile¶
编辑 ~/.dsh/profiles/<profile>/package.json（默认 profile 为 desktop），在 dependencies 与 dsh.profile.bundles 中加入插件（bundles 已有项则追加，勿整段替换）：
{
"dependencies": {
"dsh-moss-image": "github:Akashyc/dsh-moss-image"
},
"dsh": {
"profile": {
"bundles": ["dsh-moss-image"]
}
}
}
随后在 profile 目录执行：
pnpm install
重启 DSH 后，设置侧栏应出现 Moss 生图。
装后自检¶
README 建议：在 Moss 生图设置页点 测试连接（只查模型列表，不计费），再点 试生成；侧栏打开 Moss 图库 查看落盘文件。
典型用法¶
对话里直接描述¶
例如：
画一只橘猫坐在窗边，雨后的花园，柔和的自然光
需要尺寸或种子时可在同一句说明，例如「9:16，种子 42」。尺寸也可在设置里选预设（如默认 1024x1024）或手填宽×高。
卸载（节选）¶
对 agent：卸载插件 dsh-moss-image。或插件管理页卸载，或：
node install.mjs --uninstall --apply
卸载不会删除凭据里的 API Key、~/.dsh/dsh-moss-image/ 下的设置与缓存、已保存图片；需手动清理。
适用场景与注意¶
适合：已在 DSH 里对话、希望模型按需出图并本地归档的开发者或重度用户；需要相册式管理 Moss 出图结果时，可用 2.x 图库。
注意：
- 插件以当前 DSH 进程权限运行；安装前请阅读 GitHub 源码 与 MIT 许可证，自行评估信任边界。
- 生成内容需遵守 Moss 平台政策与所在地法律；提示词与参数仅发往所配置的 Moss 接口。
- 升级自旧版：
pathMode已移除，相对目录配置会丢弃并回落默认~/Pictures/Moss；升级后建议重启一次 DSH。
结尾¶
dsh-moss-image 把 Moss 文生图、会话工具调用、本地落盘和图库收到一个 DSH 插件里，减少在 Playground 与 IDE 之间来回切换。社区目录页：skillhub.cn/plugins/Akashyc/dsh-moss-image；源码与完整配置表见 github.com/Akashyc/dsh-moss-image。
