前言¶
在 DeepSeek Harness（DSH）里做智能体或日常对话时，若需要文生图、按本地文件改图或一次跑多条提示词，常见做法是切到浏览器或单独脚本调图像 API，再把文件拖回工作区。中间多一步上下文切换，结果也不一定能 inline 显示在会话里。
下面介绍社区插件 Cture Image（npm 包 @cikian/dsh-cture-image）：它把 POST /images/generations 与 POST /images/edits 封装成 DSH 工具，生成图以会话内图片块展示，原图字节同时写入当前工作区。维护者为 Cikian；在 SkillHub 目录中归类为「模型推理」。项目采用 MIT 许可证，GitHub 仓库当前约 2 stars。
这是什么¶
Cture Image 是面向 DSH 0.2.x（桌面端或 dsh web）的 bundle 插件：通过任意 OpenAI 兼容 图像接口完成 text-to-image、image-to-image / inpainting（可选 mask）以及带并发上限的批量生成，无需离开对话。
与「自己写脚本调 API」相比，差异主要在集成方式：配置在 Plugins → Installed 页面完成（含连通性探测）；智能体通过 generate_image、imagegen_config 驱动；每张图既有 durable attachment 内联展示，也有工作区路径可下载。
核心功能¶
资料中明确列出的能力如下。
- 三种任务合一 —
generate_image的action支持generate（默认）、edit（本地image_paths，可选mask_path）、batch（多prompts，并发受concurrency设置约束）。 - 对话内看图 — 结果以真实 image content block 返回，并写入工作区原始字节；工具结果会报告实际像素尺寸、字节大小、attachment id 与路径。
- 参数可控 — 模型、quality、分辨率档位（1K / 2K / 4K）、宽高比、单次数量（1–8）、保存目录、是否追加渲染指引（
optimize_prompt）等。 - Plugins 页配置 — 自带设置表单与连通性测试（逐步
✓/✕）；API key 保存在 host，不回传浏览器。 - 智能体可改配置 —
imagegen_config可get/set/models，与表单改的是同一套有效配置。 - 标准 DSH bundle — 出现在 Installed 列表，可开关，对所有 preset 与会话生效。
运行环境要求（来自 README）：DSH 0.2.x；Node.js ≥ 20 仅用于仓库开发脚本，插件本体在 DSH 内运行；需自备兼容 images API 的 endpoint 与 key。
安装与启用¶
安装后需 重启 DSH。README 说明：host 半部会立即挂载，但 client 半部（设置表单、图片视图）在启动时注入；在已打开的页面里安装可能出现「显示 running 但 UI 缺失」——属已知情况。
从 npm 安装¶
桌面端与 CLI Web 使用不同 profile：
# Desktop app (profile: desktop)
dsh plugin --profile desktop add @cikian/dsh-cture-image
# CLI web app (profile: web)
dsh plugin --profile web add @cikian/dsh-cture-image
从 Release 离线包¶
在 Releases 下载 cikian-dsh-cture-image-1.0.0.tgz，再指向该文件：
dsh plugin --profile desktop add .\cikian-dsh-cture-image-1.0.0.tgz
两条路径安装的是同一 npm 包（当前发布版本 1.0.0）；tarball 仅含运行时文件，不含 API key。
验证：打开 Plugins → Installed，应看到 Cture Image 且为开启状态；详情页出现配置表单。
配置说明¶
路径：Plugins → Installed → Cture Image。表单字段含义如下（与 README 表格一致）。
| 字段 | 含义 |
|---|---|
| Base URL | OpenAI 兼容 images API 根地址；默认指向 https://api.cikhub.com/v1，可换任意兼容 endpoint |
| API key | 密钥；存于 host，界面仅显示 ***set*** |
| Model | 默认模型；下拉来自 GET /models，也接受手输 |
| Quality | low · medium · high · xhigh · max |
| Resolution | 1K · 2K · 4K |
| Aspect ratio | 1:1 · 2:3 · 4:3 · 3:4 · 16:9 · 9:16 · 21:9 · 9:21 |
| Count | 每条 prompt 生成张数，1–8 |
| Save directory | 相对工作区的原图目录，默认 saved-images |
| Test connectivity | 用草稿值探测 endpoint，不保存 |
| Test with one image | 生成一张 1024×1024 图验证模型与配额 |
持久化位置（不在发布包内，避免随包泄露 key）：
<profile>/node_modules/@cikian/dsh-cture-image/config.json
优先级：config.json → bundle patch 行的 config → lib/host.js 内置默认。修改方式：设置表单、imagegen_config action:"set" fields:{…}，或直接编辑该文件。
典型用法¶
无需记 CLI：在对话里用自然语言描述即可。README 示例：
画一只戴眼镜的猫，插画风格
把 saved-images/20261014-085102-readme-1.png 的背景换成夜晚
批量出 3 个封面候选
智能体侧对应工具 generate_image（节选默认与常用参数）：
| 参数 | 默认 | 说明 |
|---|---|---|
action |
generate |
另有 edit、batch |
prompt |
— | 多语言；默认会追加渲染指引，除非 optimize_prompt: false |
model |
gpt-image-2.5-sunburst |
文档还提到 gpt-image-2.5-flare（批量草图/封面）、gpt-image-2.5（通用） |
quality |
high |
同上 quality 枚举 |
resolution |
1K |
映射为 16 倍数像素尺寸 |
aspect_ratio |
16:9 |
八种比例 |
count |
1 |
1–8 |
save_dir |
saved-images |
工作区相对路径 |
每张图会：写入 <workspace>/saved-images/<timestamp>-<slug>-<n>.png；作为 attachment 内联返回；在工具结果中给出真实像素尺寸等信息。
imagegen_config：get 查看有效配置；set 校验并持久化；models 列出 endpoint 宣告的图像模型。
端点兼容与注意¶
插件按 OpenAI images API 设计，各 relay / 厂商细节可能不同。README「Endpoint compatibility」中已观察到的行为包括：请求侧发送具体像素尺寸而非仅 tier 名；部分 provider 约 1.6MP 上限会静默缩小，工具会回报实际尺寸；极端宽高比可能被服务端钳制；edit 需要 endpoint 支持 multipart 的 /images/edits。
适用对象：已在 DSH 0.2.x 中工作、并持有 OpenAI 兼容生图/修图 key 的开发者或写作者；希望封面、插画、批量候选在同一 workspace 与对话流里完成的人。
安全与信任：插件以当前 DSH 进程权限运行，会向配置的 Base URL 发送 prompt 与（在 edit 时）本地图像；安装前请阅读 GitHub 源码 与 MIT 许可证，自行评估 endpoint 与 key 的归属。SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
Cture Image 把 OpenAI 兼容文生图、修图与批量生成收进 DSH bundle：配置在 Plugins 页、执行在对话里、文件落在工作区 saved-images。若要查分类与简介，可看目录页 skillhub.cn/plugins/Cikian/dsh-cture-image；安装命令、字段说明与 changelog 以 GitHub 为准：github.com/Cikian/dsh-cture-image。
