Merge remote-tracking branch 'origin/master' into worktree/docs-website

# Conflicts:
#	docs/user/develop/basic/config.zh.md
#	docs/user/develop/basic/index.zh.md
#	docs/user/develop/basic/tool.zh.md
#	docs/user/develop/framework/index.zh.md
#	docs/user/develop/framework/service.zh.md
#	docs/user/develop/practice/index.zh.md
#	docs/user/guide/index.zh.md
#	package.json
#	pnpm-lock.yaml
#	pnpm-workspace.yaml
#	website/.vitepress/config/index.ts
#	website/.vitepress/config/zh-CN.ts
#	website/package.json
#	website/zh-CN/api/cordis/context.md
#	website/zh-CN/api/cordis/events.md
#	website/zh-CN/api/cordis/fiber.md
#	website/zh-CN/api/cordis/registry.md
#	website/zh-CN/api/cordis/service.md
#	website/zh-CN/api/harness/bash.md
#	website/zh-CN/api/harness/fs.md
#	website/zh-CN/api/harness/llm.md
#	website/zh-CN/api/harness/tools.md
#	website/zh-CN/api/index.md
#	website/zh-CN/design/composability.md
#	website/zh-CN/design/context-model.md
#	website/zh-CN/design/reactive-coeffects.md
#	website/zh-CN/design/revertible-effects.md
#	website/zh-CN/develop/framework/events.md
#	website/zh-CN/develop/practice/llm-adapter.md
#	website/zh-CN/guide/config.md

docs/user/develop/basic/config.i18n.yaml

@@ -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
-config.md: 5c4e712e2ae452d30fde23bd2481f0c5260ee526
-config.zh.md: 23c97e18a119a92fe7ae883621cb9340ef54bf80
+config.md: 26d2d48ebede74194fbf306aa97d214bdb99b722
+config.zh.md: 9ed389b16779f25c633d0c8772f8658197ba4322

docs/user/develop/basic/config.md

@@ -91,12 +91,19 @@ The test is whether `cordis.yml` can change the value without a code edit.
 
 ### Fail loudly on invalid configuration
 
-If configuration refers to a missing model or another nonexistent resource, fail early instead of silently skipping it:
+If configuration refers to an unregistered LLM provider route or another nonexistent resource, fail early instead of silently skipping it:
 
-```ts ignore-check
-export function apply(ctx: Context, config: Config) {
-  if (!ctx.llm.models().includes(config.model)) {
-    throw new Error(`Model "${config.model}" is not registered by any LLM adapter`)
+```ts
+import type { Context } from 'cordis'
+import type {} from '@deepseek-ai/dsh-llm'
+
+export interface ModelConfig {
+  provider: string
+}
+
+export function apply(ctx: Context, config: ModelConfig) {
+  if (!ctx.llm.listProviders().some(provider => provider.id === config.provider)) {
+    throw new Error(`LLM provider "${config.provider}" is not registered`)
   }
 }
 ```

docs/user/develop/basic/config.zh.md

@@ -91,12 +91,19 @@ export interface Config {
 
 ### 配置错误要响亮
 
-如果配置引用了不存在的东西（比如一个不存在的模型名），应该尽早报错，而不是静默跳过：
+如果配置引用了未注册的 LLM 提供方路由或其他不存在的资源，应该尽早报错，而不是静默跳过：
 
-```ts ignore-check
-export function apply(ctx: Context, config: Config) {
-  if (!ctx.llm.models().includes(config.model)) {
-    throw new Error(`Model "${config.model}" is not registered by any LLM adapter`)
+```ts
+import type { Context } from 'cordis'
+import type {} from '@deepseek-ai/dsh-llm'
+
+export interface ModelConfig {
+  provider: string
+}
+
+export function apply(ctx: Context, config: ModelConfig) {
+  if (!ctx.llm.listProviders().some(provider => provider.id === config.provider)) {
+    throw new Error(`LLM provider "${config.provider}" is not registered`)
   }
 }
 ```

docs/user/develop/framework/index.i18n.yaml

@@ -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
-index.md: bb08e7cb3f9d3a094100806451fd33d1482003cb
-index.zh.md: 4b9d6d22c8d82bece67c71032a0028b21939f98f
+index.md: 79e925b54509da41535735527e283850384257ec
+index.zh.md: 62be8c706510704f7b07286f166f14fa81235a0a

docs/user/develop/framework/index.md

@@ -79,11 +79,16 @@ export function apply(ctx: Context) {
 
 To stop a plugin instance early:
 
-```ts ignore-check
+```ts
+import type { Context } from 'cordis'
+
+declare const ctx: Context
+declare function myPlugin(ctx: Context): void
+
 const fiber = ctx.plugin(myPlugin)
 
 // Dispose it manually later.
-fiber.dispose()
+await fiber.dispose()
 ```
 
 `dispose` guarantees:

docs/user/develop/framework/index.zh.md

@@ -79,11 +79,16 @@ export function apply(ctx: Context) {
 
 当你需要提前终止一个插件实例：
 
-```ts ignore-check
+```ts
+import type { Context } from 'cordis'
+
+declare const ctx: Context
+declare function myPlugin(ctx: Context): void
+
 const fiber = ctx.plugin(myPlugin)
 
 // Dispose it manually later.
-fiber.dispose()
+await fiber.dispose()
 ```
 
 `dispose` 保证：

docs/user/develop/practice/llm-adapter.i18n.yaml

@@ -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
-llm-adapter.md: 18e05ab79f7daf9f86fe1eb27bdd4440fb9107bc
-llm-adapter.zh.md: f3c1ac70f7b4c11fb9f6dcb247be342fb358bd39
+llm-adapter.md: 7f4fb11fdfd57cd7b05efb04f176a93901c147b1
+llm-adapter.zh.md: 328ca2522d9032ee6816c3f43b35c23ee2ab7625

docs/user/develop/practice/llm-adapter.md

@@ -132,7 +132,7 @@ The first argument lists the model names handled by the adapter. If `cordis.yml`
       - my-model-v2
 
 - id: stdio-agent
-  name: '@deepseek-ai/dsh-stdio-agent'
+  name: '@deepseek-ai/dsh-stdio-demo'
   config:
     model: my-model-v1  # References the model registered above.
 ```

docs/user/develop/practice/llm-adapter.zh.md

@@ -132,7 +132,7 @@ ctx.llm.registerAdapter(['model-name-1', 'model-name-2'], adapter)
       - my-model-v2
 
 - id: stdio-agent
-  name: '@deepseek-ai/dsh-stdio-agent'
+  name: '@deepseek-ai/dsh-stdio-demo'
   config:
     model: my-model-v1  # References the model registered above.
 ```