ycp424c/dsh-luna-vision-bridge1

@ycp424c/dsh-luna-vision-bridge

DSH LLM adapter that transcribes native image attachments with Codex Luna before delegating to DeepSeek

AI 分析

核心用途是为纯文本模型赋予“视觉”能力。适合使用不支持图片输入的模型、但仍需处理图片附件的用户,支持在设置中联动配置下游模型。

パッケージ
@ycp424c/dsh-luna-vision-bridge
バージョン
0.1.0
ライセンス
MIT
最終更新
2026/08/17

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:ycp424c/dsh-luna-vision-bridge

ドキュメント

README 全文を読む ↗

配置下游模型:Web 设置界面(推荐)

插件把整份配置注册为 DSH 用户设置段 luna-vision-bridge,并带一个浏览器端设置区块(settings.section)。无需编辑任何配置文件

  1. 打开 Web 界面的 设置 → "Luna Vision Bridge"(设置面板左侧导航,模型页同组)
  2. 表单会预填一行当前默认组合(未配置时默认 DeepSeek / DeepSeek-V4-Flash),在表单里编辑:
    • Provider 显示名:桥接 provider 在模型选择器里的显示名,默认 Luna Vision Bridge
    • 下游模型:一行一个组合,每行:
      • provider下拉选择(来自 DSH 模型目录,已过滤桥接自身),如 DeepSeek
      • model下拉选择(按所选 provider 的模型目录联动),如 DeepSeek-V4-Pro
      • 显示名(可选):模型选择器显示名,默认 + Luna
      • 高级(可选折叠):桥接模型 id,默认 -,必须互不相同
    • 用"+ 添加下游模型"增加组合、"删除"移除、"恢复默认"清空用户覆盖
    • 模型目录不可用时自动降级为手动输入框
  3. 点击保存即生效(无需重启,模型选择器立即出现新组合)

浏览器端表单通过 settings.update 写入用户设置层,Host 端仍会做完整校验(重复 bridgeModelproviderbridgeProvider 相同等会被拒绝并提示)。表单字段也可在 settings.yamlluna-vision-bridge: 段手动编辑,两者等价。其余字段(Luna 转写、缓存等)与下游无关,全局共用,一般保持默认即可。

无 settings 服务挂载的 DSH 环境自动回退到 cordis 配置;两者可并存,Web 设置里保存的值优先。

配置文件方式(可选)

所有字段都有默认值;零配置即得到单个 DeepSeek 下游。多下游示例(~/.dsh/profiles/web/cordis.patch.yml):

- id: luna-vision-bridge
  name: '@ycp424c/dsh-luna-vision-bridge'
  inject: [llm, attachments]
  config:
    providerName: Luna Vision Bridge
    targets:
      - provider: deepseek-official
        model: deepseek-v4-flash
        name: DeepSeek V4 Flash + Luna
        bridgeModel: deepseek-v4-flash
      - provider: deepseek-official
        model: deepseek-v4-pro
        name: DeepSeek V4 Pro + Luna
      - provider: codex-official   # 任意已注册的纯文本 provider
        model: gpt-5.6

完整字段:

    bridgeProvider: luna-vision-bridge
    providerName: Luna Vision Bridge
    targets: []                     # 见上;缺省或为空时回退旧字段
    # 旧单下游字段(仍兼容,targets 非空时忽略):
    targetProvider: deepseek-official
    targetModel: deepseek-v4-flash
    bridgeModel: deepseek-v4-flash
    bridgeModelName: DeepSeek V4 Flash + Luna
    # Luna 转写与缓存(全局):
    # 默认自动解析为插件包内的 scripts/read-image-luna.sh;通常无需配置
    # lunaCommand: /absolute/path/to/read-image-luna.sh
    codexCommand: codex
    lunaModel: gpt-5.6-luna
    timeoutMs: 180000
    cacheDescriptions: true
    cacheDir: ~/.dsh/cache/luna-vision-bridge
    cacheNamespace: v1
    includeUserText: true
    maxUserTextChars: 4000

cacheNamespace 是人工缓存版本。更换 Luna 模型、脚本逻辑或识图提示词后,将它改为 v2 即可避免复用旧描述。缓存只与图片和提示词有关,切换下游模型不会导致重复识图。