docs(i18n): reproofread updated Chinese documentation

This commit is contained in:
xjt
2026-08-09 03:20:17 +08:00
parent 0543a6f79d
commit bd659179f6
212 changed files with 315 additions and 315 deletions

View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/typert/README.md
README.md: ad9f843e48be0e3be85921ed8fd3ca4e2c327160
README.zh.md: 0d4be016b766178b54f7e269583fa4200e3eb24b
README.zh.md: aae74bf89f657f50f4519b2f8a0628fd391f8de3

View File

@@ -7,5 +7,5 @@ Typert 将源代码分析、运行时存储和 Loader 发现机制分离。
| 包 | 职责 | Cordis 键 |
|---|---|---|
| [`registry/`](registry/README.md) | 存储运行时包反射和 schema | `ctx.typert` |
| [`loader/`](loader/README.md) | 发现 Loader 条目并注册生成的宿主产物 | 消费 `ctx.loader``ctx.typert` |
| [`loader/`](loader/README.md) | 发现 Loader 条目并注册生成的宿主产物 | 使用 `ctx.loader``ctx.typert` |
| [`generator/`](generator/README.md) | 从源代码类型生成运行时产物 | 构建时库 |

View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/typert/generator/README.md
README.md: 38030c2b7e07c70ab79001086640b6581943dbd9
README.zh.md: afa45820b7c7fba77704b86902c8752cd45777e6
README.zh.md: 0cf0a365785775a9461e9744d29a0da482e54d14

View File

@@ -4,7 +4,7 @@
TypeScript 项目分析器和模型驱动的 Typert 生成器。在生成任何产物之前,它会先将开发者编写的源类型树转换为独立于编译器的 `FaceModel``TypeGraph` 数据。静态分析无需 Cordis 即可消费该模型;各产物生成组件均不会接收 TypeScript 抽象语法树AST或类型检查器对象。
分析器可以分别使用由 `tsconfig.host.json``tsconfig.client.json` 初始化的独立 `ts.Program`。直接 Project Reference 确定 compiler project 成员关系;带 `dshClient` 的普通单 project package 可按公开 subpath 同时贡献 Host 与 Client 运行时 face显式引用 `tsconfig.host.json``tsconfig.client.json` 的拆分 project 则只贡献所选 face。`package.json#exports` 确定所有跨包公开边界,跨 face 的边只能来自源码导入或重新导出。NPM 依赖拥有的类型(包括 `@types` 包中的全局声明)继续以 `external` 引用表示,不会被展开。
分析器可以分别使用由 `tsconfig.host.json``tsconfig.client.json` 初始化的独立 `ts.Program`。直接项目引用确定编译器 face 的成员归属,而包子路径确定 TypeRT 运行时 face 的贡献:带 `dshClient` 的普通单项目包可以同时贡献 Host 与 Client 运行时模型;只有通过 `tsconfig.host.json``tsconfig.client.json` 显式引用的拆分项目,才会被限制在相应 face。`package.json#exports` 确定所有跨包公开边界,跨 face 的边只能来自源码导入或重新导出。NPM 依赖拥有的类型(包括 `@types` 包中的全局声明)继续以 `external` 引用表示,不会被展开。
## 分析模型
@@ -18,7 +18,7 @@ TypeScript 项目分析器和模型驱动的 Typert 生成器。在生成任何
`WorkspaceTypertGenerator` 会遍历从 Cordis `Context``Events` 扩充声明及显式 `@typert` 声明可达的包公开导出,以发现贡献方。发布产物时,它要求宿主侧产物位于 `lib/typert.host.{js,d.ts}` 并以 `package/typert` 暴露,客户端侧产物位于 `lib/typert.client.{js,d.ts}` 并以 `package/client/typert` 暴露。生成的声明将 `TYPERT` 暴露为 `unknown`,因此参与贡献的业务包无需依赖运行时注册表。
各包可自行选择是否发布,未提供对应公开入口的业务包无需生成 Typert 产物。仓库的 Host tsdown 会以 `tsconfig.host.json` 为唯一 program 种子运行 workspace TypeRT 生成;它既生成 Host 反射产物,也把 Host Remote 约投影为 Client 使用的 `typert.remote-client.*`。后续 Client tsdown 不启动 TypeRT也不分析 `tsconfig.client.json`。静态消费方仍可直接调用 `WorkspaceAnalyzer`,显式选择 face 与包子集,并在不发布或加载运行时产物的情况下分批处理包。
各包可自行选择是否发布,未提供对应公开入口的业务包无需生成 Typert 产物。仓库的 Host tsdown 会以 `tsconfig.host.json` 为唯一 program 种子运行 workspace TypeRT 生成;它既生成 Host 反射产物,也把 Host Remote 约投影为 Client 使用的 `typert.remote-client.*`。后续 Client tsdown 不启动 TypeRT也不分析 `tsconfig.client.json`。静态消费方仍可直接调用 `WorkspaceAnalyzer`,显式选择 face 与包子集,并在不发布或加载运行时产物的情况下分批处理包。
## 本仓库的 Cordis 投影

View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/typert/registry/README.md
README.md: fa227b1c8faf1abd5a6492d4b8fe7d0c51ceeef1
README.zh.md: 343e43aaca6ddaa0bb5e8d3130c85f37e4b4cb93
README.zh.md: b3dd820c9a4f23917e85631bedaf68e4fc5803c1

View File

@@ -9,8 +9,8 @@
## 公开 API
- `TypertRegistry` 是默认插件,并提供 `ctx.typert`
- `ctx.typert.lookups.register()` 注册业务包拥有的 wire 声明和默认 resolver`configure()` 注册 Host 组合拥有可异步执行的 resolver。两者生命周期独立配置可以先于 provider,卸载配置会恢复默认策略。
- `ctx.typert.contexts.registerHost()``configureHost()` 将同一所有权拆分应用于 scoped Context 身份`registerClient()` 提供对应的 Client Context binder
- `ctx.typert.lookups.register()` 注册业务包拥有的协议声明和默认解析器`configure()` 注册由宿主组合拥有可异步执行的解析器。两者生命周期相互独立配置可以先于提供方注册,卸载配置会恢复默认策略。
- `ctx.typert.contexts.registerHost()``configureHost()` 对具作用域的上下文身份采用同样的所有权划分`registerClient()` 提供对应的客户端上下文绑定器
- `register(contribution)` 会在提交任何内容之前拒绝格式错误的标识,以及重复的包与 face 组合键或 schema 键,随后返回 Cordis effect 提供的同一资源释放函数。
- `get(key)``resolve(key)``list(filter?)` 查询当前有效的 schema。`resolve()` 能区分格式错误的键、未注册的包,以及已注册但未以该名称提供 schema 的包。
- `getPackage(packageName, face?)``listPackages(filter?)` 查询生成的服务、事件和对象反射信息;默认 face 为 `host`