前言¶
在 DeepSeek Harness（DSH）里跑文生图、图像编辑或多模型推理时，常见做法是手写英文提示词，或对照各模型文档自己拼语法。不同页签、不同模型（FLUX、Midjourney、H3 等）规则不一致，改一版提示词往往要在文档和输入框之间来回切。
下面介绍社区插件 dsh-prompt-assistant（维护者 MJDACK，分类：模型推理）。它挂在 DSH 桌面版 Web UI 侧边栏，用一句话中文产出可直接下游使用的提示词，并支持参考图与结果区对话微调。插件以 bundle 形式接入 DSH 的 Cordis 补丁与 Web 客户端，不单独构建。
这是什么¶
dsh-prompt-assistant 是 DSH 侧边栏里的「提示词助手」：输入中文描述（必要时附带参考图），按当前页签套用对应系统提示词或模型规范，输出结构化结果（英文描述、画幅、编辑指令等）。本地已收录的模型走内置规范库；未收录的可联网查官方指南并缓存在本机。
开发与运行环境以 README 为准：DSH 桌面版（Web UI），开发时使用 0.2.1-rc.x 量级版本，插件 API 使用 ctx.llm、ctx.attachments、ctx.webServer；图像相关能力需要所选模型支持图片输入（README 记载 deepseek-flash 实测可用）。
三个页签分别做什么¶
文生图¶
套用包内或自定义目录下的 system_prompt_t2i.md，输出英文画面描述与画幅比例，字段为 rewritten_prompt、wh_ratio。
图像编辑¶
套用 system_prompt_edit.md，需要上传待编辑图；输出编辑指令与画幅。多图时带 ratio_follow。多图引用在结果里按 <image1>(简短描述) 格式书写，例如 <image1>(穿白裙的女孩)、<image2>(夜晚的城市街道)，便于下游识别每张图。
模型提示词¶
输入格式为 模型名: 中文描述，例如 moss: …、anima：…、h3: …（半角、全角冒号均可，模型名不区分大小写）。插件按该模型的原生语法写英文提示词，并附中文直译。内置 24 个模型 / 97 个别名 的规范（FLUX、Qwen-Image、Seedream、Midjourney、SDXL、Nano Banana、Veo、Kling、Wan、Runway 等）。本地未收录时会联网检索，正文写入 ~/.dsh/prompt-assistant/specs/<model>.md 后下次直接命中；可通过配置关闭联网（见下文 webLookup）。
若本机安装了 h3-prompt-writing skill，h3: / h3-ref: 会自动使用该 skill 的官方指南（T2VA/I2VA/FL2VA/L2VA、Ref2VA 等段式）。H3 完整指南不随本仓库分发，见仓库 NOTICE。
三个页签均可添加参考图；生成结果后可在面板底部继续对话调整（例如「背景换成夜晚」「再短一点」「翻译改口语」），模型返回完整新结果并更新卡片，也可纯问答。切换页签时草稿、参考图、上次结果与对话记录会保留。
图片与模型选择¶
参考图支持拖拽、粘贴或点 + 上传；前端统一重编码为 PNG/JPEG（最长边 2048），WebP、超大图或 MIME 不符会在本地拦截，避免到上游才报错。模型下拉会标出不支持图片的模型；带图提交时前后端都会校验。新增本地模型规范后，可点下拉旁的 ↻ 重新读取（Host 侧缓存约 30 秒，面板每次打开也会刷新），无需重启 DSH。
规范库可展开，点击模型名会自动把 别名: 填入输入框。
安装与启用¶
这是 DSH bundle（package.json 中 dsh.bundle.patch + dsh.client），无需构建。安装前请自行阅读仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，联网查规范时会把模型名发给搜索服务（正文仅缓存在本机）。
方式一：插件管理界面
- 将仓库克隆或下载到本地，例如
D:\plugins\dsh-prompt-assistant。 - 打开 DSH → 插件 → 添加插件 → 选择目录（或「本地安装」），指向该目录。
- 侧边栏出现「提示词助手」。
方式二：命令行
dsh plugin --profile <profile-name> add link:/absolute/path/to/dsh-prompt-assistant
将 <profile-name> 与路径换成你的 profile 与插件目录的绝对路径。若桌面版自行管理的 profile 拒绝命令行写入（提示 profile "…" is managed exclusively by the Electron application），请改用方式一。
修改 Host 侧 index.js 后浏览器不会自动加载新代码：在插件页关闭再打开该 bundle，或重启 DSH。
配置¶
配置写在 bundle 的 cordis.patch.yml 里，在 config 下覆盖即可，例如：
- insert:
- id: prompt-assistant
name: dsh-prompt-assistant
config:
promptDir: 'D:\my-prompts'
specDir: 'D:\my-specs'
learnedDir: 'D:\my-specs-learned'
| 键 | 默认 | 说明 |
|---|---|---|
promptDir |
~/.dsh/prompt-assistant/prompts |
放置 文生图/system_prompt_t2i.md、图像编辑/system_prompt_edit.md；缺失则用包内 prompts/ |
specDir |
~/.dsh/skills/model-prompt-en/references |
模型规范库（含 index.md 与 models/） |
specFallbackDir |
包内 specs/ |
specDir 找不到时使用 |
learnedDir |
~/.dsh/prompt-assistant/specs |
联网学到的模型规范 |
specFiles |
h3 相关路径 | 挂载外部文件作为规范；文件不存在则跳过 |
maxImages / maxImageBytes / maxBodyBytes |
0 / 12MB / 256MB |
图片张数、单张大小、请求体上限（0 表示图片张数不限） |
webLookup |
true |
未收录模型是否联网查询 |
典型用法¶
文生图：在「文生图」页签输入中文画面描述，可选参考图，选模型后提交，使用返回的 rewritten_prompt 与 wh_ratio 对接下游生图。
图像编辑：上传要改的图片，用中文说明改动意图；多图时在结果中确认 <imageN>(描述) 是否与意图一致。
模型提示词：在输入框写 flux: 赛博朋克街景，霓虹雨夜 这类一行，或从规范库点选模型名自动补全前缀；需要对照语法时可展开规范库阅读。
对话调整：结果卡片生成后，在底部输入「背景换成夜晚」等短指令，获取完整新 JSON 结果（对话调整仅携带文本结果，不会把参考图再发一遍）。
本机脚本或同源页面还可调用插件注册的 HTTP 接口（仅回环 Host、同源，无额外 token）：
GET /dsh-prompt-assistant/info
GET /dsh-prompt-assistant/lookup?alias=moss
POST /dsh-prompt-assistant/rewrite {mode, text, images?, model?}
POST /dsh-prompt-assistant/chat {mode, input, result, history, text, model?}
适用场景与注意¶
适合在 DSH 桌面版里频繁写 T2I、图像编辑指令，或需要在 FLUX、MJ、H3 等多套语法间切换的开发者。默认请求只走本机 DSH（127.0.0.1），无独立外部后端；草稿与学到的规范仅存本地。
已知限制（README）：不做流式渲染，需等待模型返回完整 JSON；对话调整不带参考图；模型不支持图片时面板会提示换模型。社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，DSH 生态理念是「一切皆插件」，安装来源以你信任的仓库与目录页为准。
结尾¶
dsh-prompt-assistant 把文生图、图像编辑和模型原生提示词收敛到侧边栏三个页签，用中文输入和可选参考图降低提示词编写成本，并用对话微调减少反复重跑。详情与 issue 见 GitHub 仓库：https://github.com/MJDACK/dsh-prompt-assistant；目录介绍见 https://www.skillhub.cn/plugins/MJDACK/dsh-prompt-assistant。
