前言¶
在 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。
