refactor(llm): unify DeepSeek protocol implementations

This commit is contained in:
Yichen Jiang committed 2026-09-10 17:19:51 +08:00
1 parent 66e4f809d7
commit 6a137ea702
99 files changed
+2344 -2167

No files matched your search

+2 -2
View File
@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/config-catalog.md
config-catalog.md: a7e7064cc065a20dd43aae27c4c7330c89b62685
config-catalog.zh.md: cc3da4c77894e92c0620c6773993658bc7eff001
config-catalog.md: b65d2f036cfc513e9cc97151701be3bc56d29718
config-catalog.zh.md: 0bf0314d9d294a604c2d230d38c942f58fce2fee
+6 -63
View File
@@ -1025,6 +1025,8 @@ Requires: `llm`
* reasoning effort resolves to `high`.
*/
export interface Config {
/** Wire protocol; defaults to chat-completions. Configure through Cordis YAML. */
protocol?: DeepSeekProtocol
/** Credential reference (environment-variable name) resolved per request; defaults to `DEEPSEEK_API_KEY`. */
apiKeyEnv?: string
/** Endpoint base; falls back to $DEEPSEEK_BASE_URL from a trusted environment layer, then the public API. */
@@ -1065,6 +1067,9 @@ export interface Config {
retryPolicy?: RetryPolicyConfig
}
/** Supported wire implementations; Responses is not yet implemented. */
export type DeepSeekProtocol = 'chat-completions' | 'messages'
/** One optional model entry advertised by the direct-fetch adapter. */
export interface DeepSeekCatalogModel {
/** Wire model id accepted by the configured endpoint. */
@@ -1094,69 +1099,7 @@ export interface DeepSeekCatalogModel {
Depends on: [`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · [`SystemPromptUpdate`](../packages/llm/llm/src/index.ts)
Source: [`packages/llm/llm-deepseek/src/index.ts:134`](../packages/llm/llm-deepseek/src/index.ts)
<a id="deepseek-aidsh-llm-deepseek-messages"></a>
## `@deepseek-ai/dsh-llm-deepseek-messages`
Requires: `llm`
```ts config-catalog
/** Composition configuration and the `llm-deepseek-messages` settings section. */
export interface Config {
/** Credential reference resolved per request; defaults to DEEPSEEK_API_KEY. */
apiKeyEnv?: string
/** Messages protocol root, without /v1/messages; defaults to DEEPSEEK_MESSAGES_BASE_URL, then https://api.deepseek.com/anthropic. */
baseURL?: string
/** Deployment policy; disabled permits only off. */
thinking?: 'enabled' | 'disabled'
/** Default effort; high unless thinking is disabled. */
reasoningEffort?: 'off' | 'low' | 'high' | 'max'
/** Default output cap, including thinking tokens; defaults to 256000. */
maxTokens?: number
/** Context capacity for models without an explicit entry; defaults to 1000000. */
defaultContextWindow?: number
/** Advisory catalog; omission advertises V41 Flash, V4 Flash, Pro, and Flash Vision Exp. */
models?: CatalogModel[]
/** Maximum idle time while waiting on the provider; defaults to 300000 ms. */
streamIdleTimeoutMs?: number
/** Maximum aggregate base64 image bytes; defaults to 20 MiB. */
maxInlineRequestImageBytes?: number
/** Maximum retained image occurrences; defaults to 600. */
maxImagesPerRequest?: number
/** Oldest-image byte removal quantum; defaults to 10 MiB. */
inlineImageOffloadByteQuantum?: number
/** Oldest-image count removal quantum; defaults to 20. */
imageOffloadCountQuantum?: number
/** Provider retry policy executed by llm-retry. */
retryPolicy?: RetryPolicyConfig
}
/** One advisory model entry; unlisted models remain callable as text-only models. */
export interface CatalogModel {
/** Model id sent unchanged to the provider. */
id: string
/** Display label; omission uses the model id. */
name?: string
/** Exact-model context capacity in tokens. */
contextWindow?: number
/** Exact-model default output cap. */
maxTokens?: number
/** Accepted input modalities; omission advertises text only. */
inputModalities?: ('text' | 'image')[]
/** Total-pixel target used to normalize request images. */
imagePixelBudget?: number
/** Encoded-byte target used to normalize each request image. */
imageMaxBytes?: number
/** Explicit support for complete system-prompt updates within message history; absent by default. */
systemPromptUpdate?: SystemPromptUpdate
}
```
Depends on: [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · [`SystemPromptUpdate`](../packages/llm/llm/src/index.ts)
Source: [`packages/llm/llm-deepseek-messages/src/config.ts:31`](../packages/llm/llm-deepseek-messages/src/config.ts)
Source: [`packages/llm/llm-deepseek/src/config.ts:25`](../packages/llm/llm-deepseek/src/config.ts)
<a id="deepseek-aidsh-llm-pi-ai"></a>
+8 -65
View File
@@ -1015,7 +1015,7 @@ export interface Config {
## `@deepseek-ai/dsh-llm-deepseek`
需要:`llm`
需要: `llm`
```ts config-catalog
/**
@@ -1027,6 +1027,8 @@ export interface Config {
* reasoning effort resolves to `high`.
*/
export interface Config {
/** Wire protocol; defaults to chat-completions. Configure through Cordis YAML. */
protocol?: DeepSeekProtocol
/** Credential reference (environment-variable name) resolved per request; defaults to `DEEPSEEK_API_KEY`. */
apiKeyEnv?: string
/** Endpoint base; falls back to $DEEPSEEK_BASE_URL from a trusted environment layer, then the public API. */
@@ -1067,6 +1069,9 @@ export interface Config {
retryPolicy?: RetryPolicyConfig
}
/** Supported wire implementations; Responses is not yet implemented. */
export type DeepSeekProtocol = 'chat-completions' | 'messages'
/** One optional model entry advertised by the direct-fetch adapter. */
export interface DeepSeekCatalogModel {
/** Wire model id accepted by the configured endpoint. */
@@ -1094,71 +1099,9 @@ export interface DeepSeekCatalogModel {
}
```
依赖:[`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · [`SystemPromptUpdate`](../packages/llm/llm/src/index.ts)
依赖: [`ModelModality`](../packages/llm/llm/src/index.ts) · [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · [`SystemPromptUpdate`](../packages/llm/llm/src/index.ts)
来源:[`packages/llm/llm-deepseek/src/index.ts:134`](../packages/llm/llm-deepseek/src/index.ts)
<a id="deepseek-aidsh-llm-deepseek-messages"></a>
## `@deepseek-ai/dsh-llm-deepseek-messages`
需要: `llm`
```ts config-catalog
/** Composition configuration and the `llm-deepseek-messages` settings section. */
export interface Config {
/** Credential reference resolved per request; defaults to DEEPSEEK_API_KEY. */
apiKeyEnv?: string
/** Messages protocol root, without /v1/messages; defaults to DEEPSEEK_MESSAGES_BASE_URL, then https://api.deepseek.com/anthropic. */
baseURL?: string
/** Deployment policy; disabled permits only off. */
thinking?: 'enabled' | 'disabled'
/** Default effort; high unless thinking is disabled. */
reasoningEffort?: 'off' | 'low' | 'high' | 'max'
/** Default output cap, including thinking tokens; defaults to 256000. */
maxTokens?: number
/** Context capacity for models without an explicit entry; defaults to 1000000. */
defaultContextWindow?: number
/** Advisory catalog; omission advertises V41 Flash, V4 Flash, Pro, and Flash Vision Exp. */
models?: CatalogModel[]
/** Maximum idle time while waiting on the provider; defaults to 300000 ms. */
streamIdleTimeoutMs?: number
/** Maximum aggregate base64 image bytes; defaults to 20 MiB. */
maxInlineRequestImageBytes?: number
/** Maximum retained image occurrences; defaults to 600. */
maxImagesPerRequest?: number
/** Oldest-image byte removal quantum; defaults to 10 MiB. */
inlineImageOffloadByteQuantum?: number
/** Oldest-image count removal quantum; defaults to 20. */
imageOffloadCountQuantum?: number
/** Provider retry policy executed by llm-retry. */
retryPolicy?: RetryPolicyConfig
}
/** One advisory model entry; unlisted models remain callable as text-only models. */
export interface CatalogModel {
/** Model id sent unchanged to the provider. */
id: string
/** Display label; omission uses the model id. */
name?: string
/** Exact-model context capacity in tokens. */
contextWindow?: number
/** Exact-model default output cap. */
maxTokens?: number
/** Accepted input modalities; omission advertises text only. */
inputModalities?: ('text' | 'image')[]
/** Total-pixel target used to normalize request images. */
imagePixelBudget?: number
/** Encoded-byte target used to normalize each request image. */
imageMaxBytes?: number
/** Explicit support for complete system-prompt updates within message history; absent by default. */
systemPromptUpdate?: SystemPromptUpdate
}
```
依赖: [`RetryPolicyConfig`](../packages/llm/llm/src/index.ts) · [`SystemPromptUpdate`](../packages/llm/llm/src/index.ts)
来源: [`packages/llm/llm-deepseek-messages/src/config.ts:31`](../packages/llm/llm-deepseek-messages/src/config.ts)
来源: [`packages/llm/llm-deepseek/src/config.ts:25`](../packages/llm/llm-deepseek/src/config.ts)
<a id="deepseek-aidsh-llm-pi-ai"></a>
+2 -2
View File
@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/module-graph.md
module-graph.md: 70db2ecb398538bb478151d21e639f15aaecaec9
module-graph.zh.md: 4ae92b3e6abea70c682eb37ac71d7d4487406d68
module-graph.md: cbaa8cb04a7ec2406b1f6e7f2c1dbf0a8dff0527
module-graph.zh.md: 148b2730fccc1740d1c2f24d766f2aa7213093cf
-10
View File
@@ -28,7 +28,6 @@ flowchart TD
pkg_deepseek_llm_api_extensions["deepseek-llm-api-extensions"]
pkg_llm["llm"]
pkg_llm_deepseek["llm-deepseek"]
pkg_llm_deepseek_messages["llm-deepseek-messages"]
pkg_llm_pi_ai["llm-pi-ai"]
pkg_llm_retry["llm-retry"]
pkg_plugin_package_inventory_deepseek["plugin-package-inventory-deepseek"]
@@ -512,14 +511,6 @@ flowchart TD
pkg_llm_deepseek --> pkg_llm
pkg_llm_deepseek --> pkg_settings
pkg_llm_deepseek --> pkg_timeout
pkg_llm_deepseek_messages --> pkg_anonymous_user_id
pkg_llm_deepseek_messages --> pkg_attachment
pkg_llm_deepseek_messages --> pkg_credentials
pkg_llm_deepseek_messages --> pkg_fs
pkg_llm_deepseek_messages --> pkg_launch_environment
pkg_llm_deepseek_messages --> pkg_llm
pkg_llm_deepseek_messages --> pkg_settings
pkg_llm_deepseek_messages --> pkg_timeout
pkg_llm_pi_ai --> pkg_attachment
pkg_llm_pi_ai --> pkg_authorization
pkg_llm_pi_ai --> pkg_credentials
@@ -1341,7 +1332,6 @@ flowchart TD
| [`shell`](../packages/shell/shell) | `shell` | [`sandbox`](../packages/sandbox/sandbox), [`settings`](../packages/settings/settings), [`subprocess`](../packages/subprocess/subprocess) |
| [`workspace`](../packages/workspace/workspace) | `workspace` | [`invariants`](../packages/runtime-diagnostics/invariants), [`session`](../packages/core/session), [`session-persistence`](../packages/session/session-persistence), [`storage`](../packages/storage/storage), [`storage-domain`](../packages/storage/storage-domain), [`typert-protocol`](../packages/typert/protocol) |
| [`llm-deepseek`](../packages/llm/llm-deepseek) | `llm` | [`anonymous-user-id`](../packages/identity/anonymous-user-id), [`atomic-write`](../packages/util/atomic-write), [`attachment`](../packages/attachment/attachment), [`credentials`](../packages/credentials/credentials), [`deepseek-llm-api-extensions`](../packages/llm/deepseek-llm-api-extensions), [`fs`](../packages/fs/fs), [`home-paths`](../packages/util/home-paths), [`launch-environment`](../packages/util/launch-environment), [`llm`](../packages/llm/llm), [`settings`](../packages/settings/settings), [`timeout`](../packages/util/timeout) |
| [`llm-deepseek-messages`](../packages/llm/llm-deepseek-messages) | `llm` | [`anonymous-user-id`](../packages/identity/anonymous-user-id), [`attachment`](../packages/attachment/attachment), [`credentials`](../packages/credentials/credentials), [`fs`](../packages/fs/fs), [`launch-environment`](../packages/util/launch-environment), [`llm`](../packages/llm/llm), [`settings`](../packages/settings/settings), [`timeout`](../packages/util/timeout) |
| [`llm-pi-ai`](../packages/llm/llm-pi-ai) | `llm` | [`attachment`](../packages/attachment/attachment), [`authorization`](../packages/credentials/authorization), [`credentials`](../packages/credentials/credentials), [`fs`](../packages/fs/fs), [`launch-environment`](../packages/util/launch-environment), [`llm`](../packages/llm/llm), [`settings`](../packages/settings/settings), [`timeout`](../packages/util/timeout) |
| [`llm-retry`](../packages/llm/llm-retry) | `llm` | [`agent`](../packages/core/agent), [`brand`](../packages/util/brand), [`invariants`](../packages/runtime-diagnostics/invariants), [`llm`](../packages/llm/llm), [`session`](../packages/core/session), [`session-projection`](../packages/session/session-projection), [`timeout`](../packages/util/timeout) |
| [`agent-default-model`](../packages/core/agent-default-model) | `core` | [`agent`](../packages/core/agent), [`llm`](../packages/llm/llm), [`settings`](../packages/settings/settings) |
-10
View File
@@ -30,7 +30,6 @@ flowchart TD
pkg_deepseek_llm_api_extensions["deepseek-llm-api-extensions"]
pkg_llm["llm"]
pkg_llm_deepseek["llm-deepseek"]
pkg_llm_deepseek_messages["llm-deepseek-messages"]
pkg_llm_pi_ai["llm-pi-ai"]
pkg_llm_retry["llm-retry"]
pkg_plugin_package_inventory_deepseek["plugin-package-inventory-deepseek"]
@@ -514,14 +513,6 @@ flowchart TD
pkg_llm_deepseek --> pkg_llm
pkg_llm_deepseek --> pkg_settings
pkg_llm_deepseek --> pkg_timeout
pkg_llm_deepseek_messages --> pkg_anonymous_user_id
pkg_llm_deepseek_messages --> pkg_attachment
pkg_llm_deepseek_messages --> pkg_credentials
pkg_llm_deepseek_messages --> pkg_fs
pkg_llm_deepseek_messages --> pkg_launch_environment
pkg_llm_deepseek_messages --> pkg_llm
pkg_llm_deepseek_messages --> pkg_settings
pkg_llm_deepseek_messages --> pkg_timeout
pkg_llm_pi_ai --> pkg_attachment
pkg_llm_pi_ai --> pkg_authorization
pkg_llm_pi_ai --> pkg_credentials
@@ -1343,7 +1334,6 @@ flowchart TD
| [`shell`](../packages/shell/shell) | `shell` | [`sandbox`](../packages/sandbox/sandbox), [`settings`](../packages/settings/settings), [`subprocess`](../packages/subprocess/subprocess) |
| [`workspace`](../packages/workspace/workspace) | `workspace` | [`invariants`](../packages/runtime-diagnostics/invariants), [`session`](../packages/core/session), [`session-persistence`](../packages/session/session-persistence), [`storage`](../packages/storage/storage), [`storage-domain`](../packages/storage/storage-domain), [`typert-protocol`](../packages/typert/protocol) |
| [`llm-deepseek`](../packages/llm/llm-deepseek) | `llm` | [`anonymous-user-id`](../packages/identity/anonymous-user-id), [`atomic-write`](../packages/util/atomic-write), [`attachment`](../packages/attachment/attachment), [`credentials`](../packages/credentials/credentials), [`deepseek-llm-api-extensions`](../packages/llm/deepseek-llm-api-extensions), [`fs`](../packages/fs/fs), [`home-paths`](../packages/util/home-paths), [`launch-environment`](../packages/util/launch-environment), [`llm`](../packages/llm/llm), [`settings`](../packages/settings/settings), [`timeout`](../packages/util/timeout) |
| [`llm-deepseek-messages`](../packages/llm/llm-deepseek-messages) | `llm` | [`anonymous-user-id`](../packages/identity/anonymous-user-id), [`attachment`](../packages/attachment/attachment), [`credentials`](../packages/credentials/credentials), [`fs`](../packages/fs/fs), [`launch-environment`](../packages/util/launch-environment), [`llm`](../packages/llm/llm), [`settings`](../packages/settings/settings), [`timeout`](../packages/util/timeout) |
| [`llm-pi-ai`](../packages/llm/llm-pi-ai) | `llm` | [`attachment`](../packages/attachment/attachment), [`authorization`](../packages/credentials/authorization), [`credentials`](../packages/credentials/credentials), [`fs`](../packages/fs/fs), [`launch-environment`](../packages/util/launch-environment), [`llm`](../packages/llm/llm), [`settings`](../packages/settings/settings), [`timeout`](../packages/util/timeout) |
| [`llm-retry`](../packages/llm/llm-retry) | `llm` | [`agent`](../packages/core/agent), [`brand`](../packages/util/brand), [`invariants`](../packages/runtime-diagnostics/invariants), [`llm`](../packages/llm/llm), [`session`](../packages/core/session), [`session-projection`](../packages/session/session-projection), [`timeout`](../packages/util/timeout) |
| [`agent-default-model`](../packages/core/agent-default-model) | `core` | [`agent`](../packages/core/agent), [`llm`](../packages/llm/llm), [`settings`](../packages/settings/settings) |