@mcd0luo/celes-dsh-eye

dsh 伪多模态插件（Celestea 系列）：DeepSeek 模型只接受文本，图片附件不直接 发送给 LLM，而是落盘到本地 attachment store，由模型按需调用 dsh_eye_read_image 工具（携带分析指令）通过视觉模型读取。

特性

• 发送带图消息时拦截：image 块 → 本地持久化 + 替换为 markdown 图片链接 （![名称](http://host:port/api/dsh-eye/image/<attachmentId>)）
• 模型按需识图：dsh_eye_read_image(attachmentId, instruction?)，指令由模型 生成（"提取报错"、"OCR 全文"等），可多轮追问
• 描述缓存：按 (attachmentId, instruction) 缓存，TTL 可配
• 前端：用户消息中的图片链接渲染为缩略图，点击全屏查看
• 配置：设置 → Celestea → celes-dsh-eye（模型/地址/API Key/缓存等全部可改， 顶部显示"当前生效"状态）

安装

Celestea 系列由基座 @mcd0luo/dsh-celestea 的 bundle 统一挂载（基座补丁给 每个成员预留带条件的挂载行，本包装进 profile 后下次启动自动启用）。

⚠️ 基座必须显式安装一次。 虽然本包把基座列为依赖、pnpm 会自动把它 装进 node_modules，但 dsh plugin 只会把 profile 的直接依赖挂进 dsh.profile.bundles——不显式装基座，挂载行就不存在，本包装了也不会被 挂载。

# 1. 一次性：安装基座（设置中心 + 系列挂载点）
dsh plugin --profile web add @mcd0luo/dsh-celestea
# 2. 安装本包，重启后自动挂载
dsh plugin --profile web add @mcd0luo/celes-dsh-eye

不装基座、单独使用本包时（不推荐），需要手动两步：装依赖后在 ~/.dsh/profiles/web/cordis.patch.yml 添加：

- insert:
    - id: celes-dsh-eye
      name: "@mcd0luo/celes-dsh-eye"

走了基座 bundle 路线就不要再加这行，否则 loader 会报 duplicate loader entry id。

凭据：设置页直接填 API Key，或在 ~/.dsh/.credentials.yaml 配置 VISION_API_KEY: sk-...（默认凭据名，可在设置页改）。

配置（设置页可改）

| 字段 | 默认 | 说明 | |---|---|---| | visionBaseUrl | https://opencode.ai/zen/go/v1 | OpenAI 兼容端点 | | visionModel | mimo-v2.5 | 识图模型（实测支持：mimo-v2.5 / qwen3.5-plus） | | apiKeyEnv | VISION_API_KEY | 凭据名（credentials 服务） | | apiKey | — | 直接填写时优先（secret 字段） | | maxTokens | 2048 | 单次识图输出上限 | | detail | high | 图片细节级别 | | cacheTtlMs / cacheMaxEntries | 1h / 500 | 描述缓存 |

License

MIT