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.
 ```

docs/user/guide/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: 0cad49d9bd82813da230a44d526190d4e0b6a730
-config.zh.md: ee1ea9a0c1d9010be8c1a3984acdcbe870e30584
+config.md: 939773c530ac0bacde3ac0702918854c0a20fcf0
+config.zh.md: 1233b1fe50ed7db2320733b91cfea5cec6e45bfd

docs/user/guide/config.md

@@ -23,7 +23,7 @@ A minimal configuration is a list of plugin entries:
       - deepseek-v4-flash
 
 - id: stdio-agent
-  name: '@deepseek-ai/dsh-stdio-agent'
+  name: '@deepseek-ai/dsh-stdio-demo'
   config:
     model: deepseek-v4-flash
 ```

docs/user/guide/config.zh.md

@@ -23,7 +23,7 @@ Harness 使用 `cordis.yml` 描述 Agent 加载哪些插件以及每个插件的
       - deepseek-v4-flash
 
 - id: stdio-agent
-  name: '@deepseek-ai/dsh-stdio-agent'
+  name: '@deepseek-ai/dsh-stdio-demo'
   config:
     model: deepseek-v4-flash
 ```

docs/user/guide/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: 4daf7fdc76b38b5d10cc8b4726d9b6239a72933f
-index.zh.md: 1f41078822009234cbaf513aaa8dbc01c4b5d879
+index.md: a20b1041e13b01b6b1d01a5baa8975d3e68c6aa0
+index.zh.md: 56ec50352218e2e28ad2dd7a6ef387376de75606

docs/user/guide/index.md

@@ -15,7 +15,7 @@ Harness implements every capability an AI agent needs—including LLM calls, too
     apiKey: !!js process.env.DEEPSEEK_API_KEY
 
 # Select the application template
-- name: '@deepseek-ai/dsh-stdio-agent'
+- name: '@deepseek-ai/dsh-stdio-demo'
   config:
     model: deepseek-v4-flash
 ```

docs/user/guide/index.zh.md

@@ -15,7 +15,7 @@ Harness 将一个 AI Agent（智能体） 所需要的所有能力——LLM 调
     apiKey: !!js process.env.DEEPSEEK_API_KEY
 
 # Select the application template
-- name: '@deepseek-ai/dsh-stdio-agent'
+- name: '@deepseek-ai/dsh-stdio-demo'
   config:
     model: deepseek-v4-flash
 ```

docs/user/guide/quickstart.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
-quickstart.md: c2932cf5a5f49c3e3ddb887866b421c6e6cad7a1
-quickstart.zh.md: 54ddb50be31203e98d4cd75d0b8851f8f0e14cc5
+quickstart.md: 0968d5d8596722e8cc53516a355950929571bfbe
+quickstart.zh.md: 4591f73bd0467159c215b2a11d17856f9646f6e7

docs/user/guide/quickstart.md

@@ -91,7 +91,7 @@ Try a task:
 
 ## What happened
 
-echo-agent and coding-agent use the same application framework (`@deepseek-ai/dsh-stdio-agent`). Their `cordis.yml` files select different plugins and configuration. Custom agents use the same composition model.
+echo-agent and coding-agent use the same application framework (`@deepseek-ai/dsh-stdio-demo`). Their `cordis.yml` files select different plugins and configuration. Custom agents use the same composition model.
 
 ## Next steps
 

docs/user/guide/quickstart.zh.md

@@ -91,7 +91,7 @@ agent REPL ready. Give it a coding task.
 
 ## 回头看
 
-echo-agent 和 coding-agent 用的是同一个应用框架(`@deepseek-ai/dsh-stdio-agent`)，区别只在 `cordis.yml`——换了哪些插件、填了什么配置。你以后定制自己的 Agent 也是同样的方式。
+echo-agent 和 coding-agent 用的是同一个应用框架(`@deepseek-ai/dsh-stdio-demo`)，区别只在 `cordis.yml`——换了哪些插件、填了什么配置。你以后定制自己的 Agent 也是同样的方式。
 
 ## 下一步