2.1.2

Release Notes

来源：2.1.1..HEAD 的 merged PR，commit 用于补充核对。

概览

• 本版本包含 1 个 merged PR，完善 Codex 自定义 provider 的模型发现与凭据配置，并同步 DeepSeek 模型元数据测试。
• 本次为配置改进和测试修正，无破坏性变更。

PR 详情

#46 Update Codex provider auth and model discovery config

• 链接：#46
• 作者：MarvekG；合并时间：2026-09-23 06:21:51 UTC
• 类型：改进优化 / 问题修复
• 变更内容：
  • Codex 自定义 provider 配置现在会写入 model_catalog_url 和 experimental_bearer_token，并启用 features.api_key_model_discovery，供 Codex 发现 API Key provider 的模型。
  • 应用配置时，生成的 auth.json 与 config.toml 使用仅所有者可读写的权限。
  • 按当前下载的 models.dev 数据更新 DeepSeek V4 Flash 的能力测试，包含图像输入能力。
• 影响说明：
  • Codex provider 会从端点地址派生模型目录地址（例如 /v1/models），并使用已配置的 API Key 作为 bearer token。
  • 生成的 Codex 凭据和配置文件权限更严格；DeepSeek 元数据测试与当前上游数据保持一致。

分类摘要

改进优化

• 完善 Codex API Key provider 的模型发现和凭据配置生成（#46）。

问题修复

• 修正与 models.dev 下载快照不一致的 DeepSeek V4 Flash 元数据测试（#46）。

破坏性变更

• 无。

2.1.1

Release Notes

来源：2.1.0..HEAD 的 merged PR，commit 用于补充核对。

概览

• 本版本包含 1 个 merged PR，修复保存测试模型时 OpenCode SDK 包被重置的问题。
• 本次为兼容性问题修复，无破坏性变更。

PR 详情

#45 Preserve OpenCode SDK package when saving test models

• 链接：#45
• 作者：MarvekG；合并时间：2026-08-29 12:55:24 UTC
• 类型：问题修复
• 变更内容：
  • 保存测试模型时，更新请求现在会携带当前端点的 opencode_sdk_package。
  • 抽出端点更新请求构造逻辑，并新增回归测试，覆盖 @ai-sdk/openai 端点保存模型的场景。
• 影响说明：
  • 使用 @ai-sdk/openai 的 OpenCode 端点，在测试弹窗保存模型或拉取最新模型后，不会再被错误改写为默认的 @ai-sdk/openai-compatible。
  • 现有端点名称、URL、API Key 和模型选择更新行为保持不变。

分类摘要

问题修复

• 修复 OpenCode SDK 包在测试模型保存流程中被重置为默认值的问题。

破坏性变更

• 无。

2.1.0

概览

• 本次版本包含 1 个 merged PR：模型元数据来源切换到 models.dev，支持运行时缓存与后台刷新。

PR 详情

#44 Load model metadata from models.dev

• 链接：#44
• 作者：MarvekG；合并时间：2026-08-21T11:56:38Z
• 类型：新功能 / 改进优化
• 变更内容：
  • 移除内置的硬编码模型元数据文件（model_metadata.json），改为从 models.dev 获取数据；仓库内附带一份 resources/models_dev_api.json 快照作为构建期兜底。
  • 构建时尝试下载最新元数据并写入 OUT_DIR，内容不变时不重复写入；下载失败或数据无效时回退到仓库快照。
  • 打开“测试模型”页面时在后台刷新元数据，不阻塞页面操作；成功下载的结果缓存到 ~/.TestModelAlive/models_dev_api.json，下次优先使用有效缓存，最后才用内嵌快照。
  • OpenCode 的上下文限制、推理档位变体和 DeepSeek Harness 的模型能力描述（contextWindow/maxTokens/输入类型/reasoningEfforts）全部由校验后的 models.dev 数据推导，官方 provider 记录优先。
  • 只输出同时具备 context 和 output 的完整 limit，避免生成不符合 OpenCode schema 的配置；推理档位按 none → minimal → low → medium → high → xhigh → max 排序。
• 影响说明：
  • 新模型不再依赖发版更新：只要 models.dev 有记录，第三方端点返回的模型即可自动获得正确的容量和推理参数。
  • 离线环境下仍可正常生成配置（依次使用运行时缓存、内嵌快照）；完全无数据时相关字段优雅缺省。
  • 元数据随 models.dev 更新，个别模型的档位列表可能与旧版硬编码值不同（例如 deepseek-v4-flash 现为 low/high/max）。

分类摘要

重点更新

• 模型元数据切换到 models.dev 并支持运行时缓存与后台刷新（#44）：解决新模型缺少上下文/输出限制和推理档位、必须等发版才能识别的问题。

改进优化

• OpenCode 配置只生成完整有效的 limit 对象，推理档位排序规范化（#44）。

破坏性变更

• 无标记为破坏性的变更；但模型元数据以 models.dev 为准，个别模型的档位列表与旧版硬编码不同，依赖旧行为的用户需留意。

v2.0.0

Release Notes

来源：v1.9.0..HEAD 的 merged PR，commit 用于补充核对。

概览

• 本次版本包含 1 个 merged PR，简化 DeepSeek Harness 配置并支持在应用时选择端点 API 协议。

PR 详情

#43 Configure DeepSeek Harness API protocol

• 链接：#43
• 作者：MarvekG；合并时间：2026-08-14 08:54:27 UTC
• 类型：改进优化
• 变更内容：移除 DeepSeek V4 拆分到 llm-deepseek 的配置路径，统一使用 llm-pi-ai。
• 变更内容：应用 DeepSeek Harness 配置时可选择 openai-completions、openai-responses 或 anthropic-messages，并在后端校验协议值。
• 影响说明：第三方网关可按实际兼容协议生成配置，避免误用 DeepSeek 原生适配器导致工具调用兼容问题。
• 影响说明：移除了原生拆分、输出上限及恢复官方配置入口，已有用户应重新应用配置以使用新的通用协议路径。

分类摘要

重点更新

• DeepSeek Harness 现支持按端点选择 API 协议，并统一经通用 llm-pi-ai provider 生成配置。

v1.9.0

Release Notes

来源：v1.8.0..HEAD 的 merged PR，commit 用于补充核对。

概览

• 本次版本包含 1 个 merged PR，修复了 DeepSeek Harness 在 macOS/Linux 上因凭据文件权限过宽而无法启动的问题。

PR 详情

#42 Fix DSH credential file permissions

• 链接：#42
• 作者：MarvekG；合并时间：2026-08-14 07:38:39 UTC
• 类型：问题修复
• 变更内容：应用写入 DeepSeek Harness .credentials.yaml 时，会在 macOS/Linux 上设置为仅文件所有者可读写的 0600 权限。
• 影响说明：使用应用“应用到 DeepSeek Harness”更新凭据后，dsh web 不会再因凭据文件为 644、可被其他用户读取而拒绝启动。
• 验证与文档：新增 Unix 权限回归测试，并在中英文 README 中说明该安全要求。
• 注意：已存在的权限过宽文件不会自动修复；需执行 chmod 600 ~/.dsh/.credentials.yaml，或重新应用一次 DeepSeek Harness 配置。

分类摘要

问题修复

• 修复 DSH 凭据文件权限不符合安全校验的问题，保障 DeepSeek Harness 能正常加载本地凭据。

v1.8.0

Release Notes

来源：已拉取最新 v1.7.0，范围为 v1.7.0..HEAD 的 merged PR。

概览

• 本次包含 2 个合并 PR。
• 重点新增 DeepSeek Harness 配置管理，并补充 OpenCode 模型推理档位。

PR 详情

#40 Add requested OpenCode model variants

• 链接：#40
• 作者：MarvekG；合并时间：2026-08-14T01:39:18Z
• 类型：改进优化
• 为 hy3、laguna-s-2.1、ling-3.0-flash、north-mini-code 补充已声明的推理档位。
• 对没有可选推理档位的指定模型保留空映射，避免前端展示不受支持的选项。
• 增加回归测试，保障模型变体映射稳定。

#41 Add DeepSeek Harness configuration management

• 链接：#41
• 作者：MarvekG；合并时间：2026-08-14T07:03:25Z
• 类型：新功能
• 新增 DeepSeek Harness 端点管理、配置预览、备份、还原、隔离测活与当前配置测试能力。
• 支持将 DeepSeek V4 Flash/Pro 按需拆分至原生 llm-deepseek；可选择官方 384000 或第三方 131072 最大输出限制。
• 增加“恢复官方配置”和“删除当前配置”操作，后者会清理对应 provider、默认模型引用和 API Key 凭据。
• 凭据引用改为可读的 TMA_DSH_<端点名称>_API_KEY。
• 前端提供中英文提示，并将部分 DeepSeek 配置错误码翻译为用户可读信息。
• 隔离测活固定使用 131072 输出上限，不读取已有 DSH 配置。

分类摘要

新功能

• DeepSeek Harness 全流程配置与测活支持，覆盖自定义端点、原生 V4 路由、配置恢复和删除。

改进优化

• OpenCode 可为更多模型提供正确的推理档位选择。

v1.7.0

Release Notes

来源：v1.6.0..HEAD 的 merged PR。

PR 详情

#39 Add OpenCode model context limits

• 链接：#39
• 类型：改进优化
• 变更内容：为已知模型生成 OpenCode 自定义 provider 配置时，写入 limit.context、limit.input（适用时）和 limit.output。
• 影响说明：OpenCode 可正确估算上下文占用并自动压缩长会话；未知模型仍不写入限制，保持原有行为。
• 验证：增加已知与未知模型的单元测试。

v1.6.0

Release Notes

来源：v1.5.0..HEAD 的 merged PR，commit 用于补充核对。

概览

• 本次版本（v1.5.0 之后）共合并 1 个 PR，主要是为 OpenCode 补齐 grok-4.6 的推理变体。

PR 详情

#38 Add Grok 4.6 model variants

• 链接：#38
• 作者：MarvekG；合并时间：2026-08-13
• 类型：新功能
• 变更内容：在默认 OpenCode 模型变体表中新增 grok-4.6，并复用与 grok-4.5 相同的 low / medium / high 推理档位。已有本地设置会在下次读取时自动补齐缺失项。
• 影响说明：选择 grok-4.6 时可以直接使用标准推理变体，无需再手工补配置。

分类摘要

重点更新

• 为 grok-4.6 补齐 OpenCode 推理变体，使用体验与 grok-4.5 一致（#38）。

新功能

• grok-4.6 现已支持 low / medium / high 变体（#38）。

v1.5.0

来源：v1.4.0..HEAD 的 merged PR，commit 用于补充核对。

Release Notes

概览

• 本次版本（v1.4.0 之后）共合并 2 个 PR，主要涉及 OpenCode 模型配置的生成优化：变体（variants）排序由低到高展示，以及限制 -fast 别名只应用于 GPT 模型。

PR 详情

#36 变体排序由低到高

• 链接：#36
• 作者：MarvekG；合并时间：2026-08-13
• 类型：改进优化
• 变更内容：为 serde_json 启用 preserve_order 以保留 JSON 键的插入顺序，并在生成 OpenCode 模型配置时，将标准推理变体按 none → low → medium → high → xhigh → max → ultra 从低到高重排；未识别的自定义变体会以名称稳定排在标准等级之后。同时补充了排序回归测试。
• 影响说明：OpenCode 配置文件中变体不再按字母序或混乱顺序排列，用户在配置预览中能以直觉的强弱顺序浏览和选择推理档位。
• 关联内容：附带将仓库本地 SSH 密钥使用规则写入 AGENTS.md，并将 id_ed25519、id_ed25519.pub 加入 .gitignore，避免密钥被提交。

#37 限制 -fast 别名仅用于 GPT 模型

• 链接：#37
• 作者：MarvekG；合并时间：2026-08-13
• 类型：问题修复
• 变更内容：此前只要选择 @ai-sdk/openai，任何模型都会生成 -fast 别名；现改为仅当模型 ID 以 gpt- 开头时才生成 fast 变体，并新增非 GPT 模型不生成别名的回归测试。
• 影响说明：Claude、DeepSeek、GLM 等非 GPT 模型在使用 @ai-sdk/openai 时不再产生错误的 -fast 配置条目，避免指向不存在的模型 ID。

分类摘要

重点更新

• OpenCode 模型配置的变体现在按由低到高排列，配置更清晰易读（#36）。
• 修复了非 GPT 模型错误生成 -fast 别名的问题（#37）。

改进优化

• 变体顺序从低到高输出，未识别变体按名称稳定排序（#36）。

问题修复

• 使用 @ai-sdk/openai 时，非 GPT 模型不再生成 -fast 别名（#37）。

破坏性变更

• 无。

v1.4.0

Release Notes

来源：v1.3.0..HEAD 的 merged PR，commit 用于补充核对。

概览

• 本次版本包含 1 个 merged PR，主要新增 OpenAI 快速模型别名，并调整 OpenCode 超时配置默认值。
• 未发现破坏性变更或关联 issue。

PR 详情

#35 Add OpenAI fast model aliases

• 链接：#35
• 作者：MarvekG；合并时间：2026-07-31 06:10 UTC
• 类型：新功能、改进优化
• 变更内容：使用 @ai-sdk/openai 的端点现在会为每个已选模型额外生成 <模型名>-fast 条目。该条目仍使用原始模型 ID 请求 API，并通过 serviceTier: "priority" 启用优先服务层。
• 变更内容：快速模型条目会继承原模型已有的 variants 配置，用户切换到 -fast 模型后仍可使用原有推理强度等变体。
• 影响说明：OpenCode 用户可直接从模型列表选择 -fast 入口，无需创建独立的 API 模型名称；其他 SDK package 不会生成这些别名。
• 影响说明：OpenCode 超时配置改为默认启用，响应头和数据块超时默认统一为 120 秒；用户仍可在应用配置时关闭或修改这些设置。
• 开发者影响：新增仓库分支规则，要求通过 feature 或 fix 分支及评审流程合并变更，避免直接向 main 提交。
• 验证信息：PR 正文记录已运行 npm run build、cargo test、cargo fmt --check 和 git diff --check；GitHub 未报告该分支的 CI checks。

分类摘要

重点更新

• OpenAI 模型现在可生成保留原始 API ID 的 -fast 别名，通过优先服务层提供新的 OpenCode 模型入口。

新功能

• 为 @ai-sdk/openai 模型自动添加快速别名，并完整保留原模型 variants。

改进优化

• OpenCode 超时配置默认启用，响应头及数据块超时默认调整为 120 秒。
• 明确仓库分支和评审工作流。