Go 模型同步 writeCasually/dsh-opencode-go-models

dsh-opencode-go-models

DSH 插件 – 同步 OpenCode Go 套餐的模型清单，并基于精确的家族配置标记多模态（图像/视频）支持。

🌏 语言 / Language：中文 · English

⚠️ 范围声明：本插件仅覆盖 OpenCode Go 订阅套餐（端点 https://opencode.ai/zen/go/v1）。OpenCode Zen 另有主套餐（端点 https://opencode.ai/zen/v1），其模型清单、每 1M tokens 按量价格、计费模式（按量付费 vs Go 的订阅制）和弃用节奏均与 Go 不同——本插件不处理 Zen 主套餐，请勿将本插件的模型/价格数据套用到 /zen/v1。

功能

- 拉取 https://opencode.ai/zen/go/v1/models 获取最新模型列表
- 与 pi-ai 安装 catalog（data/opencode-go.json）对比，计算新增/下线模型
- 新增模型直接写入 catalog JSON（dsh 运行时经 pi-ai 包装模块在加载时 import 该 JSON，重启即生效）：
- 协议准确：每个模型记录自带上 api 字段，按 opencode.ai 文档端点分配 anthropic-messages / openai-completions / openai-responses，绝不强制统一协议
- 容量/价格优先取内置模板表（文档定价表 + 同族容量），未知模型回退同族/家族配置
- 精确区分多模态模型：input: ['text', 'image'] 仅授予官方确认的视觉模型
- 原子写入遵循官方 @deepseek-ai/dsh-atomic-write：withFileLock 跨进程写锁 + writeFileAtomic（排除性临时文件 + rename 原子提交），任何失败旧文件保持完好
- 注意：catalog 在 dsh 启动时加载进内存，同步后需重启 dsh 才能看到新模型

安装与加载

从 npm 安装（推荐，已发布 dsh-opencode-go-models）

npx @deepseek-ai/dsh plugin --profile web add dsh-opencode-go-models

- 装完重启 dsh 生效（bundle 层变更）；发布包内含 cordis.patch.yml， dsh.bundle 声明随包生效，无需手工 patch
- 升级/指版本：npx @deepseek-ai/dsh plugin --profile web add dsh-opencode-go-models@<版本>
- 国内网络若等不到镜像同步，用官方源（同样经由 CLI，无需手工进目录）：

npx @deepseek-ai/dsh plugin --profile web add dsh-opencode-go-models --registry=https://registry.npmjs.org

从源码安装（开发/贡献）

git clone <your-repo-url>
cd dsh-opencode-go-models
pnpm install # 或 npm install
pnpm run build
npx @deepseek-ai/dsh plugin --profile web add /path/to/dsh-opencode-go-models

对本机已有运行实例做热加载（开发模式）

本地安装后，编辑 ~/.dsh/profiles/web/cordis.patch.yml 追加：

- insert:
- id: dsh-opencode-go-models
name: 'dsh-opencode-go-models'

patch 层经 HMR 热生效，无需重启；但模型列表的同步结果仍需重启 dsh（catalog 启动时加载）。

使用

在 DSH 对话中：

- 同步模型：请帮我同步 opencode-go 的模型列表
- 预览变更：请预览 opencode-go 模型同步的变更
- 查询多模态支持：kimi-k3 支持图片输入吗？
- 恢复原样：恢复 opencode-go 模型清单（撤销插件对 catalog 的全部修改）

自动同步

插件默认在加载时自动同步，但受冷却窗口节制（默认 12 小时，可配置）：冷却期内启动零网络、零写盘；超窗才拉取线上清单比对，仅在确有差异时 写入 catalog 并提示"重启后生效"。凭据缺失/网络失败只记日志跳过，不影响插件加载。

手动同步（sync_opencode_models）始终可用，与自动同步共享同一套原子写路径；冷却期在自动检查与手动同步后都会刷新。

调整自动同步的 patch 配置示例：

- insert:
- id: dsh-opencode-go-models
name: 'dsh-opencode-go-models'
config:
autoSync: true # 默认 true；false 关闭自动同步 autoSyncIntervalHours: 12 # 冷却窗口（小时）

卸载与恢复原样

官方文档（develop/basic）规定：通过 ctx 注册的监听/工具/定时器在插件卸载时会被自动清理；需要手动管理的资源用 ctx.effect() 注册清理函数。本插件修改的是持久文件（catalog），采用备份 + 卸载恢复方案：

- 插件首次修改 catalog 前把原文件整体备份到 opencode-go.json.dsh-backup.json （内容含 original 原文件与 ours 插件写入版本）
- 卸载时自动恢复：dispose 时检查 profiles 目录是否仍有配置文件（cordis.patch.yml / package.json）引用本插件——patch 层被移除或依赖被删除（真卸载）→ 把备份整体写回；HMR 重载 / 普通关停 / 换 profile（仍被引用）→ 不恢复，避免每次重启丢失已同步模型
- 随时手动恢复：恢复 opencode-go 模型清单 → reset_opencode_models 工具
- 防护：当前文件若已不含插件写入的模型 id（例如被 pi-ai 升级整体替换）→ 跳过恢复并清理备份，避免回退升级结果
- 语义说明（整体备份方案）：恢复会回退到「首次同步前」的完整文件——同步之后的手工改动会一并回退；需要只撤销插件改动时请在恢复前自行确认

已知限制

- 同步后需重启 dsh 才能看到新模型（catalog 在启动时加载进内存）
- 升级 pi-ai 会覆盖其 data/.json（含本插件写入的模型），升级后重新同步即可
- 未收录的未知新模型，其容量/价格/多模态等元数据取同族模型估值或保守默认值，请按厂商官方文档校准
- 文档未收录「模型 ID ↔ 端点协议」对照时按 openai-completions 兜底（/v1 端点原生 OpenAI 兼容）

English Version

DSH 插件——同步 OpenCode Go 套餐的模型清单，并按准确的家庭配置标注多模态（图像/视频）支持。

⚠️ 适用范围：本插件只覆盖 OpenCode Go 订阅套餐（端点 https://opencode.ai/zen/go/v1）。OpenCode Zen 还有一个主套餐（端点 https://opencode.ai/zen/v1）；它的模型列表、每百万 token 用量价格、计费模式（按量付费 vs Go 的订阅制）和弃用节奏都与 Go 不同——本插件不处理 Zen 主套餐；不要把本插件的模型/价格数据套用到 /zen/v1。

功能

- 拉取 https://opencode.ai/zen/go/v1/models 获取最新模型列表
- 与 pi-ai 安装目录的 catalog（data/opencode-go.json）做差异比对，报告新增/移除的模型
- 新模型直接写入 catalog JSON（dsh 加载时通过 pi-ai 包装模块导入该 JSON——重启后生效）：
- 协议准确：每条模型记录都带自己的 api 字段，按 opencode.ai 文档中的端点分别赋值为 anthropic-messages / openai-completions / openai-responses——绝不强行统一成一种协议
- 容量/价格优先取内置模板表（文档中的价格表 + 同族容量）；未知模型回退到同族/默认配置
- 精确标注多模态：只有官方确认的视觉模型才赋予 input: ['text', 'image']
- 原子写入遵循官方 @deepseek-ai/dsh-atomic-write：withFileLock 跨进程写锁 + writeFileAtomic（独占临时文件 + 原子 rename 提交）；任何失败都保持旧文件完好
- 注意：catalog 在 dsh 启动时加载进内存——同步后重启 dsh 才能看到新模型

安装

从 npm 安装（推荐；dsh-opencode-go-models 已发布）

npx @deepseek-ai/dsh plugin --profile web add dsh-opencode-go-models

- 安装后重启 dsh 生效（bundle 层变更）；已发布的包自带 cordis.patch.yml， dsh.bundle 声明随包生效——无需手动打补丁
- 升级 / 固定版本：npx @deepseek-ai/dsh plugin --profile web add dsh-opencode-go-models@<version>
- 国内网络镜像同步不及时时，改用官方 registry（仍走命令行，无需手动进目录）：

bash
npx @deepseek-ai/dsh plugin --profile web add dsh-opencode-go-models --registry=https://registry.npmjs.org

从源码安装（开发 / 贡献） bash
git clone <your-repo-url>
cd dsh-opencode-go-models
pnpm install # or npm install
pnpm run build
npx @deepseek-ai/dsh plugin --profile web add /path/to/dsh-opencode-go-models

热重载已有的本地实例（开发模式）

本地安装完成后，往 ~/.dsh/profiles/web/cordis.patch.yml 追加： yaml
- insert:
- id: dsh-opencode-go-models
name: 'dsh-opencode-go-models'

补丁层通过 HMR 热应用，无需重启；但同步后的模型列表仍需重启 dsh 才能生效（模型目录在启动时加载）。

用法

在 DSH 会话中：

- 同步模型：请帮我同步 opencode-go 的模型列表
- 预览变更：请预览 opencode-go 模型同步的变更
- 查询多模态支持：kimi-k3 支持图片输入吗？
- 全部恢复：恢复 opencode-go 模型清单（撤销插件对模型目录的所有修改）

自动同步

插件默认在加载时自动同步，受冷却窗口约束（默认 12 小时，可配置）：冷却期内，启动过程零网络 I/O、零磁盘写入；只有过了窗口才会拉取在线列表并做 diff——只有确实存在差异时才写入模型目录，然后提示「重启后生效」。凭据缺失 / 网络失败只记日志并跳过，不影响插件加载。

手动同步（sync_opencode_models）始终可用，与自动同步共用同一条原子写入路径；自动检查和手动同步之后都会刷新冷却时间。

调整自动同步的补丁配置示例： yaml
- insert:
- id: dsh-opencode-go-models
name: 'dsh-opencode-go-models'
config:
autoSync: true # default true; false disables auto-sync
autoSyncIntervalHours: 12 # cooldown window (hours)

卸载与恢复

按官方文档（develop/basic）：通过 ctx 注册的监听器 / 工具 / 定时器，在插件卸载时会自动清理；手动管理的资源应使用 ctx.effect() 注册。
本插件会修改一个持久化文件（模型目录），因此采用备份 + 卸载时恢复的方案：

- 首次修改模型目录之前，插件把原文件整体备份到 opencode-go.json.dsh-backup.json （包含 original——未改动的原文件——和 ours——插件写入的版本）
- 卸载时自动恢复：dispose 阶段会检查 profiles 目录下是否还有配置文件（cordis.patch.yml / package.json）引用本插件——补丁层被移除或依赖被删除（真正的卸载）→ 整体写回备份；HMR 重载 / 正常关闭 / 切换配置档（仍被引用）→ 不恢复，这样同步过的模型不会每次重启都丢失
- 随时手动恢复：恢复 opencode-go 模型清单 → reset_opencode_models 工具
- 防护：如果当前文件里已经没有插件写入的模型 ID（比如被 pi-ai 升级整个替换掉了）→ 跳过恢复，改为清理备份，避免把升级回滚掉
- 语义（整文件备份）：恢复会回滚到「首次同步之前」的完整文件——同步之后做的手动修改也会一并回滚；如果你只想撤销插件做的改动，恢复前请自行确认

已知限制

- 同步后重启 dsh 才能看到新模型（模型清单在启动时加载进内存）
- 升级 pi-ai 会覆盖它的 data/.json（包括插件写入的模型）——升级后重新同步即可
- 模板里没有的未知新模型，元数据（容量/价格/多模态）按同系列模型估算，或取保守默认值——请对照厂商官方文档校准
- 文档里没有「模型 ID ↔ 端点协议」映射时，回退到 openai-completions（/v1 端点原生兼容 OpenAI）