Ziya
5270dcd61d
core-data-structures 18 篇（core.md 因超长仍在产出、随后补）、 postmortem 3 篇与 RFC 前门 README 配对；流水线 + 二遍校验产出。 生成文件 docs/rfc/INDEX.md（gen-rfc-index 产物）列入排除。中文侧 页内锚点统一指向英文侧锚名，满足配对门禁的链接目标一致规则。
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# 系统提示词组装
|
|
|
|
[English](system-prompt.md) | 中文
|
|
|
|
[system-prompt 包](../../packages/core/system-prompt)定义了提示词贡献方与单次组装调用之间交换的数据。包的 [README](../../packages/core/system-prompt/README.md) 文档记录了注册、排序、作用域与渲染行为；本页固定各插件实现或传递的跨包字面形状。
|
|
|
|
源码：[`packages/core/system-prompt/src/index.ts`](../../packages/core/system-prompt/src/index.ts)。
|
|
|
|
## 组装上下文
|
|
|
|
`AssembleContext` 标识单次组装所解析的作用域层。它可通过合并扩展：`dsh-agent` 添加了可选的运行时 `agent` 字段，`assembleContextFor(agent)` 同时设置该字段与 `scope`。
|
|
|
|
```ts type-equiv
|
|
interface AssembleContext {
|
|
scope?: ScopeKey
|
|
}
|
|
```
|
|
|
|
## 工具提供方结果
|
|
|
|
`ToolProviderResult.schemas` 是当前组装中模型可见的工具集。`knownNames` 是提供方在限制前的完整名称集合，用于区分「配置名拼写错误」与「已知工具在此作用域下被有意隐藏」。
|
|
|
|
```ts type-equiv
|
|
interface ToolProviderResult {
|
|
readonly schemas: readonly ToolSchema[]
|
|
readonly knownNames?: readonly string[]
|
|
}
|
|
```
|
|
|
|
## 提示词段
|
|
|
|
`PromptSection` 是一个只读的同进程注册契约。其文本可以是静态的，也可以从当前组装上下文动态解析。
|
|
|
|
```ts type-equiv
|
|
interface PromptSection {
|
|
readonly name: string
|
|
readonly order: number
|
|
readonly text: string | ((context: AssembleContext) => string)
|
|
}
|
|
```
|