docs(i18n): proofread active Chinese documentation
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
|
||||
[English](service.md) | 中文
|
||||
|
||||
服务 (Service) 是插件对外暴露能力的方式。依赖 (inject) 是插件声明自己需要哪些服务。
|
||||
服务是一个插件向其他插件公开的能力。inject 声明插件需要哪些服务。
|
||||
|
||||
## 什么是服务
|
||||
|
||||
@@ -14,7 +14,7 @@ ctx.llm // LLM service
|
||||
ctx.agents // Agent service
|
||||
```
|
||||
|
||||
任何插件都可以提供一个新服务,供其他插件使用。
|
||||
任何插件都可以提供服务,供其他插件使用。
|
||||
|
||||
## 使用服务
|
||||
|
||||
@@ -52,7 +52,7 @@ export default class MetricsService extends Service {
|
||||
}
|
||||
```
|
||||
|
||||
加载这个插件后,其他插件就可以通过 `ctx.metrics` 访问它:
|
||||
加载这个插件后,消费方就可以通过 `ctx.metrics` 访问它:
|
||||
|
||||
```ts ignore-check
|
||||
export const inject = ['metrics']
|
||||
@@ -86,7 +86,7 @@ export default class MetricsService extends Service {
|
||||
|
||||
## 依赖的行为
|
||||
|
||||
### 必选依赖 vs 可选依赖
|
||||
### 必需依赖与可选依赖
|
||||
|
||||
```ts ignore-check
|
||||
// Required: the plugin does not load while the service is absent.
|
||||
@@ -101,12 +101,12 @@ export function apply(ctx: Context) {
|
||||
|
||||
### 服务消失时的行为
|
||||
|
||||
如果一个必选依赖的服务在运行时消失(比如提供者被卸载):
|
||||
如果应用运行期间某项必需服务消失(例如其提供方卸载):
|
||||
|
||||
1. 依赖它的插件自动 dispose
|
||||
1. 依赖它的插件会自动 dispose(资源释放)
|
||||
2. 当服务重新出现时,插件自动重新加载
|
||||
|
||||
这保证了不会出现"调用一个已不存在的服务"的情况。
|
||||
这可以防止插件调用已不存在的服务。
|
||||
|
||||
## 服务隔离
|
||||
|
||||
@@ -136,13 +136,13 @@ export function apply(ctx: Context) {
|
||||
- name: './src/plugin-b.ts'
|
||||
```
|
||||
|
||||
`plugin-a` 和 `plugin-b` 各自看到自己组内的 bash 实例,互不影响。
|
||||
`plugin-a` 和 `plugin-b` 各自看到自己组内的 Bash 实例,互不影响。
|
||||
|
||||
## Harness 内置服务
|
||||
|
||||
服务名、公开方法和源码位置由仓库自动生成,见[服务目录](../../../cordis-catalog/services.md)。开发插件时应以该目录和服务接口的 TypeScript 类型为准,不要复制一份静态清单。
|
||||
仓库会自动生成[服务目录](../../../cordis-catalog/services.md),其中包含服务名、公开方法和源码位置。开发插件时应以该目录和服务的 TypeScript 接口为准,不要维护另一份静态清单。
|
||||
|
||||
## 下一步
|
||||
|
||||
- [事件系统](./events.md) — 插件间松耦合通信
|
||||
- [能力三件套](../practice/) — 服务在 seam 模式中的应用
|
||||
- [能力分层](../practice/) — 将服务用作能力接口
|
||||
|
||||
Reference in New Issue
Block a user