Spec: docs/plan/provider-model-catalog-freshness-spec.md

Freshness checked: 2026-05-24 Asia/Shanghai.

Problem

• docs/providers/deepseek.md describes DeepSeek V3.1 and only documents deepseek-chat / deepseek-reasoner.
• src/core/providers/base/pricing.rs only has built-in DeepSeek pricing for those legacy aliases.
• Official DeepSeek docs now list deepseek-v4-flash and deepseek-v4-pro, with deepseek-chat and deepseek-reasoner scheduled for deprecation on 2026-07-24.

Official source

• https://api-docs.deepseek.com/

Acceptance criteria

• Update DeepSeek docs to describe V4 canonical model IDs and legacy alias behavior.
• Add or adjust pricing metadata only where official pricing is available.
• Preserve compatibility for deepseek-chat and deepseek-reasoner while documenting the 2026-07-24 deprecation date.
• Add focused tests for canonical IDs, legacy aliases, and pricing lookup behavior.
• Verify with fresh cargo check and relevant pricing/provider tests.