前言¶
在 DeepSeek Harness（DSH）裏做智能體或自動化流程時，常需要在同一會話裏生成或改圖，並把結果掛回對話上下文。若自行接 HTTP、落盤、再註冊附件，步驟分散且容易和 Harness 的 Cordis 上下文脫節。社區插件 dsh-agnes-image（維護者 foolfu86，分類：模型推理）向 Host 暴露單一工具 agnes_image，對接 Agnes 圖像接口，並把輸出寫入 Session 工作目錄、註冊爲附件，便於在對話中內聯展示。
這是什麼¶
dsh-agnes-image 是面向 DeepSeek Harness 的插件：增加 Host 工具 agnes_image，用於基於 Agnes Image 2.5 Flash 的圖像生成與圖像編輯。實現上刻意無額外依賴：僅使用 Node 內置模塊，通過注入的 Cordis 上下文（ctx.tools、ctx.credentials、ctx.attachments、ctx.workingDirectory）工作；無構建步驟、無 @deepseek-ai/* 對等依賴，按官方說明通過 git 安裝時無需 allowBuilds 審批。
生態上 DSH 主張「一切皆插件」；目錄頁位於社區站點 skillhub.cn，與 DeepSeek / 幻方無官方從屬關係，下文安裝與配置均以倉庫 README 爲準。
核心功能¶
agnes_image 調用 Agnes 圖像端點，將結果保存到 Session 工作目錄（默認子目錄 agnes-images/），註冊爲附件以便在會話中內聯顯示，並返回持久化文件路徑。
默認參數（每次調用均可覆蓋）如下：
| 選項 | 默認值 |
|---|---|
model |
agnes-image-2.5-flash（亦可 2.1-flash、2.0-flash） |
size |
1K（2K、3K、4K） |
ratio |
1:1（及常見 3:4 / 4:3 / 16:9 / 9:16 / 2:3 / 3:2 / 21:9 等） |
baseURL |
https://apihub.agnes-ai.com/v1 |
apiKeyEnv |
AGNES_API_KEY |
outputDir |
agnes-images |
支持傳入本地參考圖（png / jpg / jpeg / webp / gif），用於編輯與多圖合成。
倉庫佈局：package.json 聲明 dsh.bundle.patch；cordis.patch.yml 將 bundle 插入 profile 層棧；index.js 實現 agnes_image 工具。許可證爲 MIT（package.json 版本 1.1.0）。
安裝與啓用¶
下面以 README 中的 demo profile 爲例；請按你的實際 profile 替換 --profile 參數。
1、添加插件：
dsh plugin --profile demo add github:foolfu86/dsh-agnes-image
2、確認配置層已出現插件片段：
dsh --profile demo --dump-config # expect a "# == dsh-agnes-image" layer
3、使用該 profile 啓動 DSH：
dsh --profile demo
卸載：
dsh plugin --profile demo remove dsh-agnes-image
憑證配置¶
插件運行時需要 Agnes API Key。運行時查找憑證引用 AGNES_API_KEY（先 process.env，再 profile 的 credential store）。倉庫不保存任何密鑰，需自行配置，例如：
export AGNES_API_KEY=your_key_here
或寫入 ~/.dsh/.credentials.yaml。
典型用法¶
安裝並完成憑證配置後，在已加載該插件的 DSH 會話中，由模型或編排邏輯調用 Host 工具 agnes_image：純文生圖時傳入提示與可選的 model / size / ratio 等；編輯或合成時傳入本地參考圖路徑。工具完成後可在對話中通過附件查看圖片，並使用返回的持久路徑做後續步驟。
具體參數字段與調用形態以 GitHub README 及當前 index.js 爲準；本文不列舉未在資料中給出的示例請求體。
適用場景與注意¶
適合希望在 DSH 內統一完成「調 Agnes 生圖 / 改圖 → 落盤 → 會話附件」鏈路的開發者，尤其是希望避免單獨維護 SDK 與構建流程的場景。
安裝前建議閱讀插件源碼與 MIT 許可證。插件以當前 dsh 進程權限 運行，會訪問你配置的 API Key、工作目錄與本地參考圖路徑；僅安裝你信任的社區插件。
結尾¶
dsh-agnes-image 用單一 Host 工具把 Agnes Image 2.5 Flash 接入 DSH 會話工作流，依賴面小、與 Cordis 附件機制對齊。更多信息見目錄頁 foolfu86/dsh-agnes-image 與源碼倉庫 github.com/foolfu86/dsh-agnes-image。
