方式 C：直接通过 npm 安装到 ~/.dsh/plugins 并配置

powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 -FromNpm

脚本做的事：
1. 找到 `cordis.patch.yml`（`~/.dsh/profiles/*/`，自动排除 node_modules 里的副本）
2. 若已配置 imgpost → 直接提示跳过，不重复写入
3. 否则**先备份**，再在文件末尾追加一个独立的 `- insert:` 块
4. 写入后校验，失败则恢复备份
5. 提示你重启 DSH

> 想完全手动？看下一节"加载到 DSH"。

### 加载到 DSH

DSH 通过 Cordis 插件机制加载（本插件是一个宿主端 host 插件）。在你的 DSH 配置（`cordis.patch.yml` / profiles 的补丁文件）里加一行即可，例如：

```yaml
- id: imgpost
  name: '../../plugins/imgpost/src/host.js'

启动 DSH 后，agent 会自动获得 send_image / generate_image / imgpost_read_image 三个工具。

DSH 是什么？DeepSeek Harness —— 一个基于 Cordis 的可编程 AI 智能体工作台。imgpost 就是为它写的一个能力插件。

⚙️ 配置（全部可选，默认不绑定任何具体厂商）

不配也能用 send_image（发本地图/网页图）；生图和识图需要凭据，但不限厂商、逢我们只读你显式给的配置。

生图：任一

环境变量：DSH_IMAGE_API_KEY / DSH_IMAGE_API_BASE / DSH_IMAGE_API_MODEL
或文件：   ~/.dsh/image-sender.json  { "apiKey", "baseURL", "model" }

识图：任一

文件：     ~/.dsh/vision-sender.json
样式：
{
  "primary":  { "baseURL": "...", "apiKey": "...", "model": "...", "format": "openai|anthropic" },
  "fallback": { "baseURL": "...", "apiKey": "...", "model": "...", "format": "openai|anthropic" }
}
环境变量：DSH_VISION_API_KEY / DSH_VISION_API_BASE / DSH_VISION_API_MODEL

format 支持 openai（OpenAI 兼容 /chat/completions）和 anthropic（/messages）两种风格，兼容大多数视觉服务。

（可选）对外图片基址

想在 LAN / Tailscale 等让手机或别的设备也看到图片，配置 publicBaseUrl（插件加载时传入），否则自动探测 GUI 端口。

🧩 技术要点

• 零依赖：核心逻辑直接用宿主端 Service（attachments / fs / subprocess / webServer / tools / llm），不引入第三方包。
• 磁盘证据缓存：识图结果按图片 SHA-256 缓存在 ~/.dsh/imgpost-vision-cache/，同一张图只描述一次，跨重启不重读。
• 跨电脑通用：没有写死的本机路径 / 盘符 / 端口 / 厂商模型名，克隆即用。

📄 License

MIT

---

imgpost —— 让你的 DSH 会发图、更会看图。

⚙️ 配置（全部可选，默认不绑定任何具体厂商）

不配也能用 send_image（发本地图/网页图）；生图和识图需要凭据，但不限厂商、逢我们只读你显式给的配置。

生图：任一

环境变量：DSH_IMAGE_API_KEY / DSH_IMAGE_API_BASE / DSH_IMAGE_API_MODEL
或文件：   ~/.dsh/image-sender.json  { "apiKey", "baseURL", "model" }

识图：任一

文件：     ~/.dsh/vision-sender.json
样式：
{
  "primary":  { "baseURL": "...", "apiKey": "...", "model": "...", "format": "openai|anthropic" },
  "fallback": { "baseURL": "...", "apiKey": "...", "model": "...", "format": "openai|anthropic" }
}
环境变量：DSH_VISION_API_KEY / DSH_VISION_API_BASE / DSH_VISION_API_MODEL

format 支持 openai（OpenAI 兼容 /chat/completions）和 anthropic（/messages）两种风格，兼容大多数视觉服务。

（可选）对外图片基址

想在 LAN / Tailscale 等让手机或别的设备也看到图片，配置 publicBaseUrl（插件加载时传入），否则自动探测 GUI 端口。