升级到 0.2.1-rc.1 后模型列表为空：profile 残留旧版 models 字段导致 llm-deepseek-account 加载失败（UI 无错误提示）

[Run-HaJi]

升级到 0.2.1-rc.1 后模型列表为空：profile 中残留旧版 models 字段导致 llm-deepseek-account 加载失败，且 UI 无错误提示

环境

• DSH Desktop：0.2.1-rc.1（Windows x64）
• 升级前版本：0.2.0-rc.2
• 系统：Windows 11
• 使用的 profile：desktop
• 账号状态：已登录 DeepSeek 账号（非 API Key 模式）

现象

升级到 0.2.1-rc.1 后，模型选择器显示 “暂无可用模型”，无法选择任何模型。

已尝试但均无效的动作：

1. 退出登录 → 重新登录（凭据文件时间戳更新，说明重登成功）
2. 重启应用（多次）
3. 检查网络与代理（正常）
4. 检查账号凭据（完整有效）

排查证据

1. 账号 token 有效，模型接口正常

使用本机凭据文件中的账号 token 直接请求：

GET https://api.deepseek.com/models
x-dsh-auth-token: <账号 token>
User-Agent: deepseek-harness

返回 HTTP 200，并正确列出 2 个模型：

{"object":"list","data":[
  {"id":"deepseek-flash","name":"DeepSeek-V4.1-Flash",...},
  {"id":"deepseek-v4-pro","name":"DeepSeek-V4-Pro",...}
]}

2. 排除网络与 Node 运行时因素

使用桌面端自带 Node（resources/runtime/primary-runtime/dependencies/node/bin/node.exe）发起同样的请求，同样返回 HTTP 200。

因此可排除：网络不通、代理拦截、DNS、Node 运行时差异。

3. 凭据文件完整

$DSH_HOME/.credentials.yaml 中 deepseek-account-platform/default 记录完整存在（token 与 issuer 均在）。

4. 定位到 profile 配置中的旧字段

$DSH_HOME/profiles/desktop/cordis.patch.yml 中存在以下配置：

- id: llm-deepseek-account
  name: "@deepseek-ai/dsh-llm-deepseek-account"
  config:
    models:
      - id: deepseek-flash
        name: DeepSeek-V4.1-Flash
        contextWindow: 1000000
        inputModalities:
          - text
          - image
        systemPromptUpdate: in-history
        toolUpdate: addition-only
      - id: deepseek-v4-pro
        name: DeepSeek-V4-Pro
        description: Stronger agentic coding, knowledge, and difficult reasoning; suited
          to complex or quality-critical tasks at higher cost.
        contextWindow: 1000000
        inputModalities:
          - text

5. 与官方文档冲突

packages/llm/llm-deepseek-account/README.zh.md 明确说明：

此路由没有 models 字段；配置里仍写了它时，加载即失败并提示改用 modelOverrides。

根因

1. 旧版本（0.2.0 及更早）将账号模型目录物化写入了 profile 的 cordis.patch.yml。该段配置包含 systemPromptUpdate、toolUpdate 等协议能力字段，这些字段无法在 UI 中手工编辑，可确认是程序写入而非用户输入。
2. 0.2.1 起账号路由改为服务端动态下发模型目录，配置中不再允许 models 字段。
3. 升级过程未清理/迁移旧格式配置，导致 llm-deepseek-account 插件加载校验失败，账号路由未注册。
4. 插件加载失败后，UI 仅显示“暂无可用模型”，未展示任何配置错误信息，将排查方向误导至“账号未登录/网络异常”。

期望行为

1. 升级时自动迁移或清理旧版 models 字段（转换为 modelOverrides，或直接移除并在日志中提示）。
2. 配置校验失败时在 UI 明确报错，例如：
   “配置校验失败：llm-deepseek-account 不支持 models 字段，请改用 modelOverrides”。
3. 模型设置页展示该 provider 的诊断信息（文档提到存在诊断机制，但当前 UI 未显示相关内容）。

临时规避方案

删除 $DSH_HOME/profiles/desktop/cordis.patch.yml 中 llm-deepseek-account 下的 config.models 整段，保留：

- id: llm-deepseek-account
  name: "@deepseek-ai/dsh-llm-deepseek-account"

重启后模型列表恢复正常。

影响面

所有从 0.2.0 或更早版本升级、且旧版本曾向 profile 写入模型目录配置的用户。属于升级路径上的普遍性问题，非个例。

---

[EN] Empty model list after upgrading to 0.2.1-rc.1: legacy models field in profile config breaks llm-deepseek-account load, with no UI error

Environment

• DSH Desktop: 0.2.1-rc.1 (Windows x64)
• Previous version: 0.2.0-rc.2
• OS: Windows 11
• Profile in use: desktop
• Auth: signed in with DeepSeek account (not API key mode)

Symptom

After upgrading to 0.2.1-rc.1, the model picker shows "No models available".

The following were attempted and did not help:

1. Sign out and sign back in (credential file timestamp updated, so re-login succeeded)
2. Restart the app (multiple times)
3. Network / proxy verification (all fine)
4. Credential inspection (present and valid)

Evidence

1. Account token is valid and the models endpoint works

GET https://api.deepseek.com/models
x-dsh-auth-token: <account token>
User-Agent: deepseek-harness

Returns HTTP 200 with two models (deepseek-flash, deepseek-v4-pro).

2. Node runtime and network ruled out

The same request issued from the bundled Node runtime (resources/runtime/primary-runtime/dependencies/node/bin/node.exe) also returns HTTP 200.

3. Credentials intact

$DSH_HOME/.credentials.yaml contains a complete deepseek-account-platform/default grant (token + issuer).

4. Legacy field found in profile config

$DSH_HOME/profiles/desktop/cordis.patch.yml contains:

- id: llm-deepseek-account
  name: "@deepseek-ai/dsh-llm-deepseek-account"
  config:
    models: [ ... ]   # legacy field, written by an older version

5. Conflicts with documented behavior

Per packages/llm/llm-deepseek-account/README.md:

This route has no models field; if it is still present in config, loading fails immediately and instructs using modelOverrides instead.

Root cause

1. Older versions (0.2.0 and earlier) materialized the account model catalog into cordis.patch.yml. The block contains protocol capability fields (systemPromptUpdate, toolUpdate) that cannot be edited through the UI, confirming it was written by the application.
2. 0.2.1 switched the account route to server-driven model discovery; models is no longer accepted.
3. The upgrade did not migrate or clean up the legacy config, so llm-deepseek-account failed its load-time validation and the route was never registered.
4. The failure is silent in the UI (only “No models available”), which misdirects users toward auth/network troubleshooting.

Expected behavior

1. Migrate or strip the legacy models field during upgrade (convert to modelOverrides or drop it with a log entry).
2. Surface configuration validation errors in the UI, e.g. “Config invalid: llm-deepseek-account does not accept models; use modelOverrides”.
3. Show the provider diagnostic on the model settings page.

Workaround

Remove the config.models block under llm-deepseek-account in $DSH_HOME/profiles/desktop/cordis.patch.yml, leaving:

- id: llm-deepseek-account
  name: "@deepseek-ai/dsh-llm-deepseek-account"

After restarting, the model list is restored.

Impact

Any user upgrading from 0.2.0 or earlier whose profile contains the legacy model catalog. This is a migration-path issue rather than a one-off.

[TCOTC]

补充一个 0.2.1-rc.2 的独立复现，确认不是 rc.1 个例。

• 环境：Windows 11 x64，DSH Desktop 0.2.1-rc.2，profile: desktop
• 账号 token 仍然有效：GET https://api.deepseek.com/models 返回 200，列出 deepseek-flash / deepseek-v4-pro
• 失败点同样是 $DSH_HOME/profiles/desktop/cordis.patch.yml 中 llm-deepseek-account 下遗留的 models 字段
• 按官方指南改为 modelOverrides.deepseek-flash 后，彻底退出并重启，模型列表恢复；不需要重新登录或配置 API Key
• UI 仍然只显示“暂无可用模型”，没有暴露 llm-deepseek-account 的加载错误

官方迁移指南：
https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/upgrade-guide/v0.2.1-alpha.2/deepseek-account-model-catalog/guide.zh.md

建议：升级时自动迁移/清理旧 models 字段；模型页显示插件加载错误；alpha.2 的 release notes 链接到这份指南。

Reproduced on 0.2.1-rc.2 as well; switching the legacy models field to modelOverrides restores the account models after a full restart.

[kinght1510]

补充：这个问题在 0.2.1-rc.2 Windows 桌面版（FileVersion 0.2.1-rc.2，2026-10-17 安装）仍然存在，不是 rc.1 独有。

环境：Windows x64，桌面运行时，profile desktop；账号已登录（凭据里有 deepseek-account-platform/default），同 profile 下 llm-deepseek（API Key 路由）正常。

现象：profile patch 的 llm-deepseek-account 仍带 0.2.0 时代的 models: 段时，设置 → 插件里该行显示「启动失败」，但不显示原因；模型列表为空。临时创建 API Key 切到 deepseek-official 后可用。

代码里其实有明确报错（dsh-llm-deepseek-account/lib/index.js 的 resolveAccountOptions）：

llm-deepseek-account: models is no longer configurable; the account /models listing supplies the catalog. Remove models from this entry and adjust single models with modelOverrides.<model id>

只是它没有出现在插件列表/设置页上。

本地 workaround：删掉该段的 models:（需要时改用 modelOverrides.<id>），把 agent-default-model.provider 切回 deepseek-account；之后真实 deepseek-account 请求成功。

建议：升级到 0.2.1 时，对 profile patch 里已废弃的 models 做一次迁移/启动期校验并给出可执行的修复提示；或至少把该行 apply 的错误文本透出到插件列表，避免用户只能靠「再建一个 Key」绕过。