docs(i18n): localize Chinese internal links

This commit is contained in:
pku-xht
2026-08-18 19:00:37 +08:00
parent 721ff76d24
commit 8d3674695b
1519 changed files with 4137 additions and 3108 deletions
+1 -1
View File
@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/user/develop/basic/config.md
config.md: 21ba39fd7de1795e9139aff3e2b11743eedd4833
config.zh.md: a882c4d59b0ac8e8ec27a5b32da5376b534a7f62
config.zh.md: 642a413950e2d8deb8591bc688968607604c050d
+4 -4
View File
@@ -93,7 +93,7 @@ export interface Config {
### 配置错误要响亮
在 schema 中表达自身完备的约束,使无效配置在插件加载时失败。对服务或已注册资源的引用需要依赖注入;[服务教程](../framework/service.md) 会介绍这项约定。
在 schema 中表达自身完备的约束,使无效配置在插件加载时失败。对服务或已注册资源的引用需要依赖注入;[服务教程](../framework/service.zh.md) 会介绍这项约定。
## 配合 HMR
@@ -101,6 +101,6 @@ export interface Config {
## 下一步
- [打包与安装插件](./publish.md) — 把插件以可安装包的形式交付
- [插件与生命周期](../framework/) — 深入了解插件的完整生命周期
- [服务与依赖](../framework/service.md) — 让你的插件对外提供服务
- [打包与安装插件](./publish.zh.md) — 把插件以可安装包的形式交付
- [插件与生命周期](../framework/index.zh.md) — 深入了解插件的完整生命周期
- [服务与依赖](../framework/service.zh.md) — 让你的插件对外提供服务
+1 -1
View File
@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/user/develop/basic/index.md
index.md: 08199624e638aaf4a36b04446c39c228b2af6025
index.zh.md: c45a30d0bfffaf4a6c78303f9ca043c3397c8a08
index.zh.md: 2ea894079ffb3c5b8c4563fd535fe6e654861b1b
+5 -5
View File
@@ -2,7 +2,7 @@
[English](index.md) | 中文
本教程会创建一个最小的 Harness 插件,并将其加载到 Web UI 中。请从已完成[从源码运行路径](../../../../README.md#run-from-source)的仓库检出开始。
本教程会创建一个最小的 Harness 插件,并将其加载到 Web UI 中。请从已完成[从源码运行路径](../../../../README.zh.md#run-from-source)的仓库检出开始。
## 创建本地项目
@@ -135,10 +135,10 @@ export default class MyService extends Service {
}
```
大多数情况下,函数形式足够了。当插件需要向其他插件提供服务时,可使用类形式(见 [服务与依赖](../framework/service.md))。
大多数情况下,函数形式足够了。当插件需要向其他插件提供服务时,可使用类形式(见 [服务与依赖](../framework/service.zh.md))。
## 下一步
- [开发一个工具](./tool.md) — 了解工具定义 DSL
- [插件配置](./config.md) — 让插件接受用户配置
- [Cordis 框架教程](../../../cordis-tutorial/index.md) — 底层的插件框架,在临时目录中动手构建,无需 API 密钥
- [开发一个工具](./tool.zh.md) — 了解工具定义 DSL
- [插件配置](./config.zh.md) — 让插件接受用户配置
- [Cordis 框架教程](../../../cordis-tutorial/index.zh.md) — 底层的插件框架,在临时目录中动手构建,无需 API 密钥
+1 -1
View File
@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/user/develop/basic/publish.md
publish.md: 9548fe2f8e4636dd160c79cd0d50f01f8bdfd3d1
publish.zh.md: 2cff05edcca55bac5fde9d2e7d24ed9c8b48a6f5
publish.zh.md: 00b8885d6cbd39fa9899e110b1d31ef96175e127
+5 -5
View File
@@ -2,9 +2,9 @@
[English](publish.md) | 中文
前几篇教程通过 `--patch` overlay 加载本地插件。本教程把它打包成可安装的**组合包**(bundle),用 `dsh plugin add` 安装进一个 **profile**,并解释决定组合后配置的层顺序。本文假设 `dsh` CLI 已安装。请先完成[插件配置](./config.md)。
前几篇教程通过 `--patch` overlay 加载本地插件。本教程把它打包成可安装的**组合包**(bundle),用 `dsh plugin add` 安装进一个 **profile**,并解释决定组合后配置的层顺序。本文假设 `dsh` CLI 已安装。请先完成[插件配置](./config.zh.md)。
如果改用全新的源码 checkout,请先按照[从源码运行章节](../../../../README.md#run-from-source)完成准备,将本教程的 `hello-plugin` 目录放在仓库根目录,并从该目录把下文的 `dsh ...` 命令改为 `pnpm dsh ...`。构建与启动器行为见[源码执行](../../../../apps/cli/reference/README.md#source-execution)。
如果改用全新的源码 checkout,请先按照[从源码运行章节](../../../../README.zh.md#run-from-source)完成准备,将本教程的 `hello-plugin` 目录放在仓库根目录,并从该目录把下文的 `dsh ...` 命令改为 `pnpm dsh ...`。构建与启动器行为见[源码执行](../../../../apps/cli/reference/README.zh.md#source-execution)。
## 两个概念,两种 manifest
@@ -136,7 +136,7 @@ dsh --profile demo
name: 'dsh-hello-plugin/startup'
```
该插件导出 `inject = ['cmdlineArgs']`,使用自己的 commander program 调用 [`@deepseek-ai/dsh-cmdline`](../../../../packages/boot/cmdline/README.md) 中的 `parseCmdline`,再在 program 自己的 action 中把应用自有服务提供出去。启动器把自身 flag 之后的同一份不可变参数交给每个插件,因此添加应用专属 flag 无需修改启动器,多个插件也可以解析该快照。Loader 行不需要启动器标记或特殊类型。
该插件导出 `inject = ['cmdlineArgs']`,使用自己的 commander program 调用 [`@deepseek-ai/dsh-cmdline`](../../../../packages/boot/cmdline/README.zh.md) 中的 `parseCmdline`,再在 program 自己的 action 中把应用自有服务提供出去。启动器把自身 flag 之后的同一份不可变参数交给每个插件,因此添加应用专属 flag 无需修改启动器,多个插件也可以解析该快照。Loader 行不需要启动器标记或特殊类型。
受这些参数配置的行会注入提供方服务,并在自己的 `!!js` 选项中读取它,同时把部署取值写在旁边作为回退:
@@ -179,5 +179,5 @@ dsh plugin --profile demo add github:you/hello-plugin
## 下一步
- [插件与生命周期](../framework/) — 插件的完整生命周期
- [CLI(命令行界面)行为参考](../../../../apps/cli/reference/README.md) — 确切的层优先级、flag 与 profile 机制
- [插件与生命周期](../framework/index.zh.md) — 插件的完整生命周期
- [CLI(命令行界面)行为参考](../../../../apps/cli/reference/README.zh.md) — 确切的层优先级、flag 与 profile 机制
+1 -1
View File
@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/user/develop/basic/tool.md
tool.md: eb262d131a7f2b540827e86e56f8c0a28cb5f904
tool.zh.md: d33d9946a73881df2cd44ebf3695819d02d013ab
tool.zh.md: a07bef588f5a18093cf2eb1971b855bf40d1d0b6
+4 -4
View File
@@ -2,7 +2,7 @@
[English](tool.md) | 中文
本教程会在 Web UI 中添加一个 `greet` 工具。请先完成[第一个插件](./),并保留其中的 `scratch-plugin` 目录。
本教程会在 Web UI 中添加一个 `greet` 工具。请先完成[第一个插件](./index.zh.md),并保留其中的 `scratch-plugin` 目录。
## 创建工具插件
@@ -47,6 +47,6 @@ pnpm dsh web --patch ./scratch-plugin/cordis.yml
## 下一步
- [插件配置](./config.md) — 让问候语可配置。
- [工具编写参考](../../../cookbook/adding-a-tool.md) — 查阅嵌套 schema、规范值、后台工作、策略钩子、Code Mode 和 UI 卡片。
- [能力分层](../practice/) — 将可替换能力拆分为 Service Definition、Service Provider 和 Consumer 三类包。
- [插件配置](./config.zh.md) — 让问候语可配置。
- [工具编写参考](../../../cookbook/adding-a-tool.zh.md) — 查阅嵌套 schema、规范值、后台工作、策略钩子、Code Mode 和 UI 卡片。
- [能力分层](../practice/index.zh.md) — 将可替换能力拆分为 Service Definition、Service Provider 和 Consumer 三类包。