Repository navigation
Releases
Releases · wjling/dsh-vision-assist
[1.1.0] - 2026-09-22
适配 DSH 0.1.7-alpha.1。
变更
- 配置模型:
settings.yaml命名空间 → Loader 条目config(schemastery volatile 字段 +
loader/volatile-update热更新)。设置页点保存即生效,不再依赖 settings 命名空间服务。 - 请求改写:不再 monkey-patch 私有的
llm.streamWithRegistration,改为包裹公开的
ctx.llm.prepareCall(agent-loop 主路径)与ctx.llm.stream(标题、压缩等直连调用方)。 - 判据来源:改用宿主解析出的
inputModalities(prepareCall的结果 /resolveModelInfo的原始值),
不再自己读llm-pi-ai配置;适配器未声明模态时交给 DSH 原生管线,不干预。 - 设置卡片:改用
ctx.configForms+ Plugins 面板的plugins.item插槽;卡片只在宿主确实提供
vision-assist命名空间时注册。弃用自建 HTTP 桥(/api/dsh-vision-assist-settings)与
settings.plugin.item插槽。 - 设置体验:改为「暂存 + 保存」模型(改动后才可保存,每项可「恢复默认」),与 DSH 内置插件设置页一致。
- 依赖声明:
@deepseek-ai/dsh-llm/dsh-tools/schemastery改为 peerDependencies——DSH 会把
它们路由到运行时安装的那一份,不再需要担心插件目录里的旧副本遮蔽宿主版本;engines.dsh >= 0.1.7-alpha.1。 - 工具注册:
vision_recognize继续跟随总开关热增删,关闭时完全不接管(不注入指引、不提供工具)。
修复
- 插件在 DSH ≥ 0.1.7 上整包加载失败(
The requested module '@deepseek-ai/dsh-settings' does not provide an export named 'settingsNamespace'),现在可以正常激活。
迁移
旧 settings.yaml 里的 vision-assist: 段落作废。把值写到 profile 的 cordis.patch.yml:
# ~/.dsh/profiles/<profile>/cordis.patch.yml
- id: vision-assist
config:
enabled: true
provider: codemaker # 视觉模型所在 provider(llm-pi-ai 里已配置)
model: gemini-3.8-flash # 视觉模型 id(需声明 input: [text, image])
timeoutMs: 300000 # 单次识别超时(毫秒)改完重启 DSH;之后也可以直接在设置页改(两者写的是同一份配置)。
设置入口:侧边栏「插件」面板 → 「官方」分组 → 「视觉助手 vision-assist」。
[1.0.0] - 2026-09-20
首个公开版本,面向 DSH 0.1.0-rc.8 时代(配置在 settings.yaml 的 vision-assist: 命名空间)。
功能
vision_recognize工具:用设置里选定的多模态模型识别本地图片,支持coarse/default/fine
三档精细度,可附加自定义 prompt。- 模型调用边界图片降级:主模型无视觉时,发往该模型的请求被克隆改写(图片块 → 附件仓路径 +
vision_recognize调用指引);GUI 气泡与会话历史始终保留原图。 - 设置页卡片:在 Web 设置页直接选识别模型,热更新生效。
- provider / model 下拉:选项来自
llm-pi-ai的模型目录,优先列出声明了图片输入的模型;切换总开关时
vision_recognize会跟着注册 / 注销。
修复
- 接管
resolveModelInfo,解除 api-proxy 对无视觉模型的发送前拒收(MODEL_DOES_NOT_SUPPORT_IMAGES),
图片得以正常进入会话。 - 图片改写从 inbox 层移到 LLM 调用边界,避免 GUI 气泡被替换成指引文字、会话历史丢图。
- 宿主共享包(
dsh-llm/dsh-settings/dsh-tools)改为 peerDependencies,避免插件目录里的旧副本
遮蔽宿主版本。 - 设置卡片每次打开都重取 provider / 模型列表,修「同步模型后下拉不刷新」。