zcode-app-cli@3.12.3-26

Important: Configuration Migration for ZCode Desktop 3.12.3

ZCode Desktop 3.12.3 introduced a new provider and model configuration structure. This release follows
that upstream change by adopting the native Provider Registry and sharing provider configuration with
Desktop.

This is a configuration format change. Please review the upgrade notes below.

Configuration changes

• Providers, model capabilities, and the default model now use ~/.zcode/v2/provider_config.json.
• CLI-specific settings move to ~/.zcode/cli/setting.json.
• Startup performs a one-time migration of supported legacy CLI settings and personal providers. The
  original file is preserved, but the old config.json is no longer used as runtime configuration.

Changes to shared providers or the saved default model affect both Desktop and CLI. The CLI’s /model
command still changes only the current session.

Model capabilities and automatic updates

Smart configuration inherits upstream updates to multimodal capabilities, token limits, native web
search, and reasoning parameter mappings. Explicit user overrides and manually configured values are
preserved.

After upgrading

• Verify your selected provider and default model.
• If you previously configured custom multimodal capabilities, output limits, or reasoning parameters,
  check that those settings migrated correctly. Some legacy fields require manual conversion to the new
  schema.

See provider.example.json for configuration examples, docs/PROVIDER_CONFIG.md for the full field
reference, and docs/PROVIDER_CONFIG.zh-CN.md for the Chinese version.

Future releases will follow the current Desktop configuration structure. Legacy configuration formats
will no longer receive runtime compatibility support.

重要变更：跟随桌面端升级配置结构

ZCode 桌面端 3.12.3 调整了 provider 和模型目录的配置结构。本版本同步迁移到上游原生 Provider Registry，
并与桌面端共用 provider 配置。

这是一次配置格式调整，升级前请阅读以下说明。

配置文件变化

• Provider、模型能力和默认模型统一使用 ~/.zcode/v2/provider_config.json。
• CLI 专属设置迁移到 ~/.zcode/cli/setting.json。
• 启动时会尝试一次性迁移支持的旧 CLI 设置和个人 provider，原文件保留。迁移后，旧 config.json 不再作
  为运行配置读取。

桌面端和 CLI 对共享 provider、默认模型的修改会相互生效；CLI 的 /model 切换仍只影响当前会话。

模型能力与自动更新

智能配置（Smart configuration）跟随上游目录更新多模态能力、Token 上限、联网能力和推理参数映射。用户显
式设置的覆盖项及手动配置会保留。

升级后请检查

• 确认当前 provider 和默认模型符合预期。
• 如果以前配置过自定义多模态能力、输出上限或推理参数，请检查这些设置是否完整迁移；部分旧字段需要按新
  schema 重新填写。

完整字段示例见 provider.example.json，详细说明见 docs/PROVIDER_CONFIG.md 和中文版 docs/ PROVIDER_CONFIG.zh-CN.md。

后续版本将继续跟随当前桌面端的配置结构，不再维护旧配置格式的运行时兼容逻辑。

What's Changed

• refactor!: migrate to ZCode 3.12.3 shared configuration by @kingsword09 in #157
• feat(tui): add /rename command to set a custom session title by @Ni7e in #156
• chore(release): prepare zcode-app-cli 3.12.3-26 by @github-actions[bot] in #158

New Contributors

• @Ni7e made their first contribution in #156

Full Changelog: v3.11.2-25...v3.12.3-26