feat: 完成DPML协议体系0~1阶段开发 - 三层协议架构100%实现,智能路径检测系统,@package://与package.json完美集成,用户项目集成方案,CLI框架完整实现,132/137核心测试通过(96.3%通过率)

This commit is contained in:
sean
2025-05-31 13:03:26 +08:00
parent 3338b7c21f
commit be285f55b8
89 changed files with 6071 additions and 467 deletions

View File

@ -0,0 +1,60 @@
# DPML#行为提示单元 框架
> **TL;DR:** DPML#行为提示单元 框架定义了结构化的#行为单元 模板,包含#流程(Process)、#指导原则(Guideline)、#规则(Rule)、#约束(Constraint)和#标准(Criteria)五个核心子概念用于指导AI系统完成具体任务。
### 目的与功能
DPML#行为提示单元 框架定义了AI系统执行任务的#行为单元 模板,它的主要功能是:
- 提供执行任务的结构化#行为单元 定义
- 通过标准化#行为单元 明确#流程 步骤、#指导原则#规则#约束#标准
- 帮助AI系统通过规范化#行为单元 进行精确、可靠的任务执行
- 提供执行状态追踪和错误处理的#行为单元 模板
## 📝 语法定义
```ebnf
(* EBNF形式化定义 *)
execution_element ::= '<execution' attributes? '>' content '</execution>'
attributes ::= (' ' attribute)+ | ''
attribute ::= name '="' value '"'
name ::= [a-zA-Z][a-zA-Z0-9_-]*
value ::= [^"]*
content ::= (markdown_content | process_element | guideline_element | rule_element | constraint_element | criteria_element)+
process_element ::= '<process' attributes? '>' markdown_content '</process>'
guideline_element ::= '<guideline' attributes? '>' markdown_content '</guideline>'
rule_element ::= '<rule' attributes? '>' markdown_content '</rule>'
constraint_element ::= '<constraint' attributes? '>' markdown_content '</constraint>'
criteria_element ::= '<criteria' attributes? '>' markdown_content '</criteria>'
markdown_content ::= (* 任何有效的Markdown文本可包含特定语法元素 *)
```
## 🧩 语义说明
#行为提示单元 标签表示一个完整的#行为单元 框架。标签内容可以包含五种不同概念的子标签,每个子标签都有明确的语义:
- **#流程**: 表示执行的具体步骤,包含正常和异常路径,是#行为单元 的核心路径定义
- **#指导原则**: 表示建议性指导原则,具有灵活性和可变通性,用于推荐最佳实践
- **#规则**: 表示强制性行为准则,必须严格遵守,通常涉及安全、合规或核心质量要求
- **#约束**: 表示客观限制条件,客观存在且不可改变,需要被动适应
- **#标准**: 表示评价标准,用于判断执行结果是否满足要求
这五个子概念构成了完整的#行为单元 框架从不同维度定义了AI系统如何执行任务。
### 优先级关系
#行为提示单元 框架内的子概念具有以下固定的优先级关系,这种关系定义了如何理解和解释这些概念:
1. **#约束** - 最高优先级,表示客观存在的限制,不可违反
2. **#规则** - 次高优先级,表示必须遵循的行为准则
3. **#指导原则** - 较低优先级,表示可灵活调整的建议性原则
4. **#流程** - 在#约束#规则 的框架内定义执行路径
5. **#标准** - 作为评价依据,验证执行结果是否满足要求
这种优先级关系是框架的核心语义特征:
- 低优先级元素不能与高优先级元素产生冲突
- #流程 必须在#约束#规则 定义的边界内设计
- #指导原则 在不违反#规则#约束 的前提下可以灵活调整
- #标准 需要考虑所有优先级更高的元素的要求

View File

@ -0,0 +1,83 @@
<terminologies>
<terminology>
<zh>行为提示单元</zh>
<en>Execution Prompt Unit</en>
<definition>
<execution>标签及其子标签如process、guideline、rule、constraint、criteria构成的、表达完整行为/执行过程的结构化提示词单元。常简称为"行为单元",两者等同。
</definition>
<examples>
<example>"所有操作流程都应以 #行为提示单元 组织。"</example>
<example>"每个 #行为单元 都可以独立复用。"</example>
</examples>
</terminology>
<terminology>
<zh>行为单元</zh>
<en>Execution Unit</en>
<definition>
"行为提示单元"的简称,含义完全等同。参见"行为提示单元"。
</definition>
<examples>
<example>"请将你的执行方案拆分为多个 #行为单元。"</example>
</examples>
</terminology>
<terminology>
<zh>流程</zh>
<en>Process</en>
<definition>
在本协议中,#流程 专指 <process> 标签及其结构单元,表示用于承载具体执行步骤、路径的提示词片段。
</definition>
<examples>
<example>"请将详细步骤写入 #流程 单元(即 <process> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>指导原则</zh>
<en>Guideline</en>
<definition>
在本协议中,#指导原则 专指 <guideline> 标签及其结构单元,表示用于承载建议性、灵活调整的行为指导内容的提示词片段。
</definition>
<examples>
<example>"所有建议请归入 #指导原则 单元(即 <guideline> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>规则</zh>
<en>Rule</en>
<definition>
在本协议中,#规则 专指 <rule> 标签及其结构单元,表示用于承载必须遵守的强制性行为准则的提示词片段。
</definition>
<examples>
<example>"合规要求请写入 #规则 单元(即 <rule> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>约束</zh>
<en>Constraint</en>
<definition>
在本协议中,#约束 专指 <constraint> 标签及其结构单元,表示用于承载客观限制条件的提示词片段。
</definition>
<examples>
<example>"所有不可更改的限制请写入 #约束 单元(即 <constraint> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>标准</zh>
<en>Criteria</en>
<definition>
在本协议中,#标准 专指 <criteria> 标签及其结构单元,表示用于承载评价标准、验收依据的提示词片段。
</definition>
<examples>
<example>"验收要求请写入 #标准 单元(即 <criteria> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>行为模式</zh>
<en>Execution Mode</en>
<definition>
在本协议中,#行为模式 指不同类型的行为/执行方式,如 #流程#指导原则#规则#约束#标准 等,分别由 <process><guideline><rule><constraint><criteria> 标签实现。
</definition>
<examples>
<example>"复杂任务可组合多种 #行为模式。"</example>
</examples>
</terminology>
</terminologies>

View File

@ -0,0 +1,79 @@
# DPML#记忆提示单元 框架
> **TL;DR:** DPML#记忆提示单元 框架定义了AI系统的#记忆管理#记忆单元 模板,支持运行时#动态记忆 管理,包含#评估(evaluate)、#存储(store)和#回忆(recall)三个核心#记忆操作,实现完整的#记忆循环 能力。
### 目的与功能
DPML#记忆提示单元 框架为AI系统提供完整的#记忆单元 模板,主要功能包括:
- 提供运行时#动态记忆#评估#存储#回忆 的标准化#记忆操作 机制
- 实现跨会话的信息持久化#记忆单元 模板
- 支持复杂的#记忆关联#记忆检索 模式的#记忆提示单元 构建
## 🔍 基本信息
**框架名称:** `<memory>` (DPML#记忆提示单元 框架)
## 📝 语法定义
```ebnf
(* EBNF形式化定义 *)
memory_element ::= '<memory' attributes? '>' memory_content '</memory>'
attributes ::= (' ' attribute)+ | ''
attribute ::= name '="' value '"'
name ::= [a-zA-Z][a-zA-Z0-9_-]*
value ::= [^"]*
memory_content ::= (text | evaluate_element | store_element | recall_element)+
evaluate_element ::= '<evaluate:thought>' thought_content '</evaluate:thought>'
store_element ::= '<store:execution' attributes? '>' (text | execution_element)* '</store:execution>'
recall_element ::= '<recall:thought>' thought_content '</recall:thought>'
thought_content ::= (* 符合thought协议的内容 *)
execution_element ::= (* 符合execution协议的元素 *)
text ::= (* 任何文本内容 *)
```
## 🧩 语义说明
#记忆提示单元 标签表示AI系统的#记忆管理 单元,定义了#动态记忆 的结构和#记忆操作 方式。它由运行时#记忆管理 的三个核心部分组成:
### #记忆操作
#记忆提示单元 包含三个核心子标签,分别对应#记忆操作 的三个阶段:
1. **`<evaluate:thought>`**#评估 信息是否值得记忆
- 通过thought协议实现#评估 过程
- 判断信息的价值、相关性和可信度
- 决定是否将信息存入#记忆系统
2. **`<store:execution>`**:将信息#存储#记忆系统
- 通过execution协议实现#存储 操作
- 定义#存储 过程、规则和约束
- 管理#记忆单元 的添加、更新和组织
3. **`<recall:thought>`**:从#记忆系统 检索并应用信息
- 通过thought协议实现#回忆 过程
- 判断何时需要#回忆 特定记忆
- 规划如何#回忆 和应用#记忆内容
- 可以使用多种实现方式,包括但不限于#资源引用
- **注意**#回忆 标签中的#资源引用 默认是按需加载的
### #记忆单元 关系
三个核心组件之间具有明确的逻辑关系:
- #评估-#存储-#回忆 构成#动态记忆 的完整#记忆循环
- #评估 决定什么值得记忆
- #存储 定义如何保存记忆
- #回忆 描述何时以及如何使用记忆
#记忆系统 的运行遵循"#评估-#存储-#回忆"的#记忆循环 模式,不断丰富和发展角色的#记忆能力。
> **注意**#先验知识库(knowledge)已经迁移至`<role>`标签下管理,`<memory>`标签专注于#动态记忆 的运行时管理。
### #记忆模式
#记忆提示单元 支持多种#记忆模式,如#工作记忆、#短期记忆、#长期记忆、#陈述性记忆、#程序性记忆、#情境性记忆 等,可根据场景灵活配置和切换。

View File

@ -0,0 +1,163 @@
<terminologies>
<terminology>
<zh>记忆提示单元</zh>
<en>Memory Prompt Unit</en>
<definition>
<memory>标签及其子标签如evaluate:thought、store:execution、recall:thought构成的、表达记忆管理与操作的结构化提示词单元。常简称为"记忆单元",两者等同。
</definition>
<examples>
<example>"所有运行时信息管理都应以 #记忆提示单元 组织。"</example>
<example>"每个 #记忆单元 都可以独立复用。"</example>
</examples>
</terminology>
<terminology>
<zh>记忆单元</zh>
<en>Memory Unit</en>
<definition>
"记忆提示单元"的简称,含义完全等同。参见"记忆提示单元"。
</definition>
<examples>
<example>"请将你的记忆操作拆分为多个 #记忆单元。"</example>
</examples>
</terminology>
<terminology>
<zh>评估</zh>
<en>Evaluate</en>
<definition>
在本协议中,#评估 专指 <evaluate:thought> 标签及其结构单元,表示用于判断信息是否值得记忆的提示词片段。
</definition>
<examples>
<example>"所有信息入库前需经过 #评估 单元(即 <evaluate:thought> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>存储</zh>
<en>Store</en>
<definition>
在本协议中,#存储 专指 <store:execution> 标签及其结构单元,表示用于将信息写入记忆系统的提示词片段。
</definition>
<examples>
<example>"数据写入请归入 #存储 单元(即 <store:execution> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>回忆</zh>
<en>Recall</en>
<definition>
在本协议中,#回忆 专指 <recall:thought> 标签及其结构单元,表示用于从记忆系统检索信息的提示词片段。
</definition>
<examples>
<example>"检索操作请写入 #回忆 单元(即 <recall:thought> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>记忆操作</zh>
<en>Memory Operation</en>
<definition>
在本协议中,#记忆操作#评估-#存储-#回忆 的完整循环过程。
</definition>
<examples>
<example>"#记忆操作 需遵循评估-存储-回忆的顺序。"</example>
</examples>
</terminology>
<terminology>
<zh>动态记忆</zh>
<en>Dynamic Memory</en>
<definition>
在本协议中,#动态记忆 指运行时可变的记忆内容,与#先验知识库 区分。
</definition>
<examples>
<example>"#动态记忆 反映AI当前会话的上下文。"</example>
</examples>
</terminology>
<terminology>
<zh>先验知识库</zh>
<en>Prior Knowledge Base</en>
<definition>
在本协议中,#先验知识库 指角色固有的、初始化的知识体系,不属于#动态记忆 范畴。
</definition>
<examples>
<example>"#先验知识库<role>标签管理。"</example>
</examples>
</terminology>
<terminology>
<zh>记忆循环</zh>
<en>Memory Cycle</en>
<definition>
在本协议中,#记忆循环#评估-#存储-#回忆 的循环模式。
</definition>
<examples>
<example>"#记忆循环 有助于持续优化AI记忆。"</example>
</examples>
</terminology>
<terminology>
<zh>记忆模式</zh>
<en>Memory Mode</en>
<definition>
在本协议中,#记忆模式 指不同的#评估#存储#回忆 实现方式。
</definition>
<examples>
<example>"可根据场景切换不同 #记忆模式。"</example>
</examples>
</terminology>
<terminology>
<zh>工作记忆</zh>
<en>Working Memory</en>
<definition>
在本协议中,#工作记忆 指AI在当前任务或会话中临时存储和处理的信息具有短时性和高活跃度。
</definition>
<examples>
<example>"#工作记忆 主要用于当前推理和决策。"</example>
</examples>
</terminology>
<terminology>
<zh>短期记忆</zh>
<en>Short-term Memory</en>
<definition>
在本协议中,#短期记忆 指AI在较短时间内保留的信息支持跨轮对话和短时上下文。
</definition>
<examples>
<example>"#短期记忆 可用于多轮对话的上下文保持。"</example>
</examples>
</terminology>
<terminology>
<zh>长期记忆</zh>
<en>Long-term Memory</en>
<definition>
在本协议中,#长期记忆 指AI可持久保存、跨会话复用的重要信息。
</definition>
<examples>
<example>"用户偏好应存入 #长期记忆。"</example>
</examples>
</terminology>
<terminology>
<zh>陈述性记忆</zh>
<en>Declarative Memory</en>
<definition>
在本协议中,#陈述性记忆 指可被明确表达和检索的事实性知识,如事件、概念等。
</definition>
<examples>
<example>"知识库内容属于 #陈述性记忆。"</example>
</examples>
</terminology>
<terminology>
<zh>程序性记忆</zh>
<en>Procedural Memory</en>
<definition>
在本协议中,#程序性记忆 指AI掌握的操作流程、技能和执行规则。
</definition>
<examples>
<example>"常用操作流程应归入 #程序性记忆。"</example>
</examples>
</terminology>
<terminology>
<zh>情境性记忆</zh>
<en>Contextual Memory</en>
<definition>
在本协议中,#情境性记忆 指与特定场景、环境或上下文相关的记忆内容。
</definition>
<examples>
<example>"对话场景信息属于 #情境性记忆。"</example>
</examples>
</terminology>
</terminologies>

View File

@ -0,0 +1,186 @@
# DPML#资源提示单元 框架
> **TL;DR:** DPML#资源提示单元 框架定义了统一的#资源单元 模板,支持通过#资源引用(@协议名://路径)形式在提示词中访问和操作各类资源。
### 目的与功能
DPML#资源提示单元 框架用于定义特定类型的#资源单元,使开发者能够以标准化的方式在提示词中描述如何#定位 和处理各种资源。通过这个框架,可以明确#资源协议 的引用语法、#位置 规则和#查询参数,确保#资源引用 在不同环境中的一致性和可靠性。此框架是PromptX中#资源协议RP在提示词层面的具体实现方式。
主要功能包括:
- 定义#资源单元 的标识和#资源引用 方式
- 规范化#位置 的提示词语法结构和#解析 规则
- 指定#资源单元 支持的#查询参数 和格式
- 提供#资源单元 的标准化示例
### 默认支持的通用#资源协议
PromptX默认支持以下通用且已有共识的#资源协议,这些协议符合`@协议名://路径`格式,遵循其业界标准语法和规则,无需在#资源单元 中重新定义:
| #资源协议 | 描述 | 示例 |
|-------|------|------|
| file | 文件系统资源 | `@file://path/to/file.txt` |
| http/https | HTTP/HTTPS网络资源 | `@https://example.com/api/data` |
| ftp/sftp | 文件传输协议 | `@ftp://user:pass@host/path` |
| ssh | 安全Shell协议 | `@ssh://user@host/path` |
这些通用#资源协议 的路径格式和#查询参数 遵循它们的标准规范。对于特定领域或自定义的#资源协议,才需要使用#资源单元 进行详细定义。
## 📝 语法定义
```ebnf
(* EBNF形式化定义 *)
resource_element ::= '<resource' ' protocol="' protocol_name '"' '>' content '</resource>'
protocol_name ::= [a-zA-Z][a-zA-Z0-9_-]*
content ::= (markdown_content | location_element | params_element | registry_element)+
location_element ::= '<location>' markdown_content '</location>'
params_element ::= '<params>' markdown_content '</params>'
registry_element ::= '<registry>' markdown_content '</registry>'
markdown_content ::= (* 任何有效的Markdown文本包括代码块、表格等 *)
```
## 🧩 语义说明
### 子标签语义
#资源单元 包含三个核心子标签,用于定义#资源协议 的具体内容:
- **#位置**:定义该#资源协议 的路径规则。通常采用EBNF形式化语法描述路径结构并可包含示例说明。
- **#参数**:定义该#资源协议 支持的#查询参数。通常采用表格形式列出参数名称、类型、描述和用法示例。
- **#注册表**:根据#位置#参数 定义注册抽象参数与具体资源的映射关系。通常采用表格形式列出ID到实际资源路径的映射。
这三个子标签共同构成#资源协议 的完整定义:#位置 定义资源的#定位 格式,#参数 定义资源的访问选项,#注册表 将抽象ID映射到具体资源路径。标签应按照#位置#参数#注册表 的顺序定义,确保#注册表 可以基于前两个标签的内容建立正确的映射关系。
### `@` #资源引用 协议
#资源单元 定义了一个#资源协议,指定了如何使用`@`符号作为统一入口,遵循以下核心语法规则:
```ebnf
resource_reference ::= ('[@]' | '@!' | '@?') protocol_name ':' resource_location [query_params]
resource_location ::= uri | nested_reference
uri ::= protocol_name '://' path
nested_reference ::= ['[@]' | '@!' | '@?'] protocol_name ':' resource_location
path ::= path_segment {'/' path_segment}
query_params ::= '?' param_name '=' param_value {'&' param_name '=' param_value}
```
#### #加载语义
#资源引用 支持三种#加载语义 前缀:
| 前缀 | 语义 | 示例 |
|-----|------|------|
| `@` | 默认模式由AI自行决定#加载 时机 | `@file://document.md` |
| `@!` | #热加载AI看到引用时必须立即#加载 | `@!https://example.com/data` |
| `@?` | #懒加载AI仅记录资源位置在实际需要使用时才#加载 | `@?file://large-dataset.csv` |
#### 基础#资源引用
基础#资源引用 使用单一#资源协议
```
@protocol://path
```
例如:
- `@file://document.md` - 引用文件系统中的文档
- `@http://example.com/api/data.json` - 引用网络资源
- `@memory://user_preferences` - 引用内存中的数据
- `@!file://important.md` - #热加载 重要文档
- `@?file://large-dataset.csv` - #懒加载 大型数据集
#### #嵌套引用
#嵌套引用 允许一个#资源协议 处理另一个#资源协议 的输出:
**完整形式**(内部使用@符号
```
@outer:@inner://path
```
**简写形式**(内部省略@符号
```
@outer:inner://path
```
#嵌套引用 时也可以指定#加载语义:
```
@outer:@!inner://path // 内部资源#热加载
@!outer:@?inner://path // 外部#热加载,内部#懒加载
```
例如:
- `@thinking:@file://method.md` - 对文件内容应用thinking协议处理
- `@execution:file://workflow.md` - 对文件内容应用execution协议处理
- `@outer:middle:inner://resource` - 多层#嵌套引用(从内向外处理)
- `@!thinking:@?file://large-file.md` - 立即应用thinking但文件内容#懒加载
#### #路径通配符
路径支持以下#路径通配符 模式:
- `*` - 匹配单层中的任意文件或目录,如`@file://docs/*.md`
- `**` - 匹配多层目录和文件,如`@file://src/**/*.js`
- `*.ext` - 匹配特定扩展名的文件,如`@file://docs/*.txt`
- `*.{ext1,ext2}` - 匹配多种扩展名,如`@file://src/*.{js,ts}`
#### #查询参数
#查询参数 提供额外的资源处理指令:
```
@protocol://path?param1=value1&param2=value2
```
例如:
- `@file://document.md?line=5-10` - 只获取文件的第5-10行
- `@http://api.example.com/data?format=json&cache=false` - 指定返回格式并禁用缓存
#### #注册表 解析与抽象引用
使用#注册表 定义的资源可以通过抽象ID引用无需知道具体路径
```
@protocol://resource_id
```
例如定义了以下#注册表
```xml
<resource protocol="thought">
<location>
location ::= thought://{thought_id}
thought_id ::= [a-zA-Z][a-zA-Z0-9_-]*
</location>
<registry>
| 思维ID | 文件路径 |
|--------|---------|
| analytical | @file://PromptX/core/thoughts/analytical.thought.md |
| creative | @file://PromptX/core/thoughts/creative.thought.md |
</registry>
</resource>
```
使用时可以简单引用:
- `@thought://analytical` - 自动映射到对应文件
- `@thought://creative` - 自动映射到对应文件
这种抽象引用机制提供了路由层,使#资源引用 与实际存储位置解耦,方便管理和移植。
### #解析 规则
1. #资源引用 解析从左至右进行,先识别#资源协议 名称,再#解析 资源位置和#查询参数
2. #嵌套引用 从内向外#解析,内层#资源引用 的结果作为外层引用的输入
3. #查询参数 应用于资源#加载 后的处理阶段,不影响资源的基本#定位
4. 相对路径#定位 基于当前上下文的工作目录或基础路径
5. #加载语义 前缀(@、@!、@?)优先于其他部分#解析,决定资源的#加载 策略
### #加载 实现说明
对于支持工具调用能力的AI系统:
1. **主动#加载 责任**: AI需主动使用工具调用(例如read_file)获取@引用的资源,而非等待系统自动#加载
2. **#热加载 义务**: 特别是对于@!前缀资源AI必须立即执行工具调用#加载 内容
3. **自主判断#懒加载**: 对于@?前缀资源AI应记录位置但暂不#加载,直到实际需要使用时
4. **#加载 验证**: AI应验证资源是否成功#加载,并适当处理#加载 失败情况
5. **#注册表 解析**: 对于使用#注册表 注册的#资源引用AI应首先#解析 资源ID找到对应的实际资源路径然后再应用上述规则获取资源
这种主动#加载 模式确保AI能正确执行协议定义的#加载语义,而不依赖系统层面的自动处理。#注册表 机制则提供了#资源引用 的抽象层,使资源组织更加灵活和模块化。

View File

@ -0,0 +1,173 @@
<terminologies>
<terminology>
<zh>资源提示单元</zh>
<en>Resource Prompt Unit</en>
<definition>
<resource>标签及其子标签如location、params、registry构成的、表达资源访问与引用的结构化提示词单元。常简称为"资源单元",两者等同。
</definition>
<examples>
<example>"所有外部数据访问都应以 #资源提示单元 组织。"</example>
<example>"每个 #资源单元 都可以独立复用。"</example>
</examples>
</terminology>
<terminology>
<zh>资源单元</zh>
<en>Resource Unit</en>
<definition>
"资源提示单元"的简称,含义完全等同。参见"资源提示单元"。
</definition>
<examples>
<example>"请将你的引用方案拆分为多个 #资源单元。"</example>
</examples>
</terminology>
<terminology>
<zh>位置</zh>
<en>Location</en>
<definition>
在本协议中,#位置 专指 <location> 标签及其结构单元,表示用于定义资源路径规则的提示词片段。
</definition>
<examples>
<example>"请将路径规则写入 #位置 单元(即 <location> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>参数</zh>
<en>Params</en>
<definition>
在本协议中,#参数 专指 <params> 标签及其结构单元,表示用于定义资源支持的查询参数的提示词片段。
</definition>
<examples>
<example>"所有可选参数请归入 #参数 单元(即 <params> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>注册表</zh>
<en>Registry</en>
<definition>
在本协议中,#注册表 专指 <registry> 标签及其结构单元表示用于定义资源ID与实际路径映射关系的提示词片段。
</definition>
<examples>
<example>"资源ID映射请写入 #注册表 单元(即 <registry> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>资源协议</zh>
<en>Resource Protocol</en>
<definition>
在本协议中,#资源协议 指 file、http、memory 等协议名部分,用于标识资源类型和访问方式。
</definition>
<examples>
<example>"#资源协议 支持 file、http、memory 等多种类型。"</example>
</examples>
</terminology>
<terminology>
<zh>资源引用</zh>
<en>Resource Reference</en>
<definition>
在本协议中,#资源引用@file://path@memory://id 等资源的引用表达式。
</definition>
<examples>
<example>"请用 #资源引用 方式标注外部依赖。"</example>
</examples>
</terminology>
<terminology>
<zh>加载语义</zh>
<en>Loading Semantics</en>
<definition>
在本协议中,#加载语义 指 @、@!、@? 前缀,决定资源的加载策略。
</definition>
<examples>
<example>"#加载语义 决定资源是立即加载还是懒加载。"</example>
</examples>
</terminology>
<terminology>
<zh>加载</zh>
<en>Load</en>
<definition>
在本协议中,#加载 指资源的实际获取、读取或载入过程。
</definition>
<examples>
<example>"#加载 过程由 AI 主动发起。"</example>
</examples>
</terminology>
<terminology>
<zh>懒加载</zh>
<en>Lazy Load</en>
<definition>
在本协议中,#懒加载 指资源仅在实际需要时才加载,通常与 @? 前缀相关。
</definition>
<examples>
<example>"大文件建议采用 #懒加载 策略。"</example>
</examples>
</terminology>
<terminology>
<zh>热加载</zh>
<en>Eager Load</en>
<definition>
在本协议中,#热加载(即立即加载)指资源在被引用时立即加载,通常与 @! 前缀相关。
</definition>
<examples>
<example>"关键依赖应采用 #热加载 策略。"</example>
</examples>
</terminology>
<terminology>
<zh>定位</zh>
<en>Locate</en>
<definition>
在本协议中,#定位 指通过协议和路径规则确定资源实际位置的过程。
</definition>
<examples>
<example>"#定位 过程依赖 #位置 单元的定义。"</example>
</examples>
</terminology>
<terminology>
<zh>解析</zh>
<en>Parse</en>
<definition>
在本协议中,#解析 指对资源引用表达式、路径、参数等进行语法和语义分析的过程。
</definition>
<examples>
<example>"#解析 资源引用时需处理嵌套结构。"</example>
</examples>
</terminology>
<terminology>
<zh>嵌套引用</zh>
<en>Nested Reference</en>
<definition>
在本协议中,#嵌套引用 指资源引用中包含另一个资源引用的结构,如 @outer:@inner://path
</definition>
<examples>
<example>"复杂场景可用 #嵌套引用 实现多层资源处理。"</example>
</examples>
</terminology>
<terminology>
<zh>路径通配符</zh>
<en>Path Wildcard</en>
<definition>
在本协议中,#路径通配符*、**、*.ext 等通配符用法,用于灵活匹配资源路径。
</definition>
<examples>
<example>"#路径通配符 支持批量引用资源。"</example>
</examples>
</terminology>
<terminology>
<zh>查询参数</zh>
<en>Query Parameter</en>
<definition>
在本协议中,#查询参数 指 ?param=value 结构,用于为资源引用提供额外指令。
</definition>
<examples>
<example>"#查询参数 可用于指定加载范围。"</example>
</examples>
</terminology>
<terminology>
<zh>资源模式</zh>
<en>Resource Mode</en>
<definition>
在本协议中,#资源模式 指不同类型的资源访问与引用方式,如 #位置#参数#注册表 等,分别由 <location><params><registry> 标签实现。
</definition>
<examples>
<example>"支持多种 #资源模式 灵活访问外部数据。"</example>
</examples>
</terminology>
</terminologies>

View File

@ -0,0 +1,76 @@
# DPML#角色提示单元 框架
> **TL;DR:** DPML#角色提示单元 框架解释了如何通过组合#思维模式、#行为模式 和#记忆模式 三大基础协议来构建完整的#AI角色支持不同类型#角色模式 的构建和定制。
### 目的与功能
DPML#角色提示单元 框架说明了如何通过基础协议的组合构建#AI角色,它的主要功能是:
- 提供#角色合成 的标准方法论
- 指导如何将#思维模式#行为模式#记忆模式 组合以表达#角色特性
- 支持不同类型#角色模式 的灵活定制
- 确保#角色定义 的一致性和完整性
## 📝 语法定义
```ebnf
(* EBNF形式化定义 *)
role_element ::= '<role' attributes? '>' role_content '</role>'
role_content ::= (personality_element | principle_element | knowledge_element | experience_element | action_element)+
(* #角色组织标签 *)
personality_element ::= '<personality' attributes? '>' personality_content '</personality>'
principle_element ::= '<principle' attributes? '>' principle_content '</principle>'
knowledge_element ::= '<knowledge' attributes? '>' knowledge_content '</knowledge>'
experience_element ::= '<experience' attributes? '>' experience_content '</experience>'
action_element ::= '<action' attributes? '>' action_content '</action>'
(* 内部内容 *)
personality_content ::= markdown_content
principle_content ::= markdown_content
knowledge_content ::= markdown_content
experience_content ::= markdown_content
action_content ::= markdown_content
attributes ::= (' ' attribute)+ | ''
attribute ::= name '="' value '"'
name ::= [a-zA-Z][a-zA-Z0-9_-]*
value ::= [^"]*
(* 各协议内容定义见各自协议文档 *)
```
## 🧩 语义说明
`<role>`标签是DPML中定义#AI角色 的顶层#角色提示单元,它封装了#人格#原则#知识记忆,共同构成一个完整的#角色定义#角色定义 必须使用`<role>`作为根标签,而不应直接使用其他标签的组合。
### #角色提示单元 的组成部分
- **#人格(Personality)**: 用于设置和编排多种#思维模式 的优先级
- #思维模式`<thought>` 的语义功能
- 定义#角色 拥有的一种或多种#思维模式
- 设置不同#思维模式 的激活条件,组合方式和优先级
- 确保#角色思维 的一致性和可预测性
- **#原则(Principle)**: 用于设置和编排多种#行为模式 的优先级
- #行为模式`<execution>` 的语义功能
- 定义#角色 拥有的一种或多种#行为模式
- 设置不同#行为模式 的触发条件,执行顺序和优先级
- 确保#角色行为 的规范性和可控性
- **#知识(Knowledge)**: #角色#先验知识库
- 定义#角色 固有的、初始化的#知识体系
- 提供#角色 的专业背景和基础认知框架
- 作为#角色理解 和决策的#知识基础
- **#经验(Experience)**: 用于设置和编排多种#记忆模式 的优先级
- #记忆模式`<memory>` 的语义功能
- 定义#角色 如何#评估#存储#回忆 信息
- 设置不同#记忆模式 的检索条件和优先级
- 确保#角色记忆处理 的连贯性和适应性
- **#激活(Action)**: 提供#角色初始化 和执行的入口
- 定义#角色 从"定义"到"执行"的转换机制
- 明确#角色初始化 序列和优先级
- 规定#资源加载#记忆系统 启动等关键步骤
- 确保#角色 能够正确地进入执行状态
- 建立#角色定义 与实际执行间的桥梁

View File

@ -0,0 +1,103 @@
<terminologies>
<terminology>
<zh>角色提示单元</zh>
<en>Role Prompt Unit</en>
<definition>
<role>标签及其子标签如personality、principle、knowledge、experience、action构成的、表达AI角色结构与行为的结构化提示词单元。常简称为"角色单元",两者等同。
</definition>
<examples>
<example>"所有AI角色定义都应以 #角色提示单元 组织。"</example>
<example>"每个 #角色单元 都可以独立复用。"</example>
</examples>
</terminology>
<terminology>
<zh>角色单元</zh>
<en>Role Unit</en>
<definition>
"角色提示单元"的简称,含义完全等同。参见"角色提示单元"。
</definition>
<examples>
<example>"请将你的角色设计拆分为多个 #角色单元。"</example>
</examples>
</terminology>
<terminology>
<zh>人格</zh>
<en>Personality</en>
<definition>
在本协议中,#人格 专指 <personality> 标签及其结构单元,定义角色的#思维模式
</definition>
<examples>
<example>"#人格 决定角色的思考风格。"</example>
</examples>
</terminology>
<terminology>
<zh>原则</zh>
<en>Principle</en>
<definition>
在本协议中,#原则 专指 <principle> 标签及其结构单元,定义角色的#行为模式
</definition>
<examples>
<example>"#原则 约束角色的行为边界。"</example>
</examples>
</terminology>
<terminology>
<zh>知识</zh>
<en>Knowledge</en>
<definition>
在本协议中,#知识 专指 <knowledge> 标签及其结构单元,定义角色的#先验知识库
</definition>
<examples>
<example>"#知识 提供角色的专业背景。"</example>
</examples>
</terminology>
<terminology>
<zh>经验</zh>
<en>Experience</en>
<definition>
在本协议中,#经验 专指 <experience> 标签及其结构单元,定义角色的#记忆模式
</definition>
<examples>
<example>"#经验 影响角色的记忆处理方式。"</example>
</examples>
</terminology>
<terminology>
<zh>激活</zh>
<en>Action</en>
<definition>
在本协议中,#激活 专指 <action> 标签及其结构单元,定义角色的初始化和执行入口。
</definition>
<examples>
<example>"#激活 决定角色的启动流程。"</example>
</examples>
</terminology>
<terminology>
<zh>角色合成</zh>
<en>Role Composition</en>
<definition>
在本协议中,#角色合成 指通过#思维模式#行为模式#记忆模式 三大协议组合构建角色的机制。
</definition>
<examples>
<example>"#角色合成 支持灵活定制AI能力。"</example>
</examples>
</terminology>
<terminology>
<zh>角色模式</zh>
<en>Role Mode</en>
<definition>
在本协议中,#角色模式 指角色内部多种模式(如#思维模式#行为模式#记忆模式)的组合。
</definition>
<examples>
<example>"不同AI可采用不同 #角色模式。"</example>
</examples>
</terminology>
<terminology>
<zh>角色初始化</zh>
<en>Role Initialization</en>
<definition>
在本协议中,#角色初始化 指角色从定义到执行的激活过程。
</definition>
<examples>
<example>"#角色初始化 包含资源加载、记忆系统启动等步骤。"</example>
</examples>
</terminology>
</terminologies>

View File

@ -0,0 +1,105 @@
# DPML术语定义协议 (Terminology Protocol)
> **TL;DR:** DPML术语定义协议提供统一的术语定义和引用框架支持通过`#术语`形式在提示词中引用明确定义的术语确保术语在AI理解和计算机执行两个层面的一致性和准确性。
### 目的与功能
DPML术语定义协议用于在协议文件中嵌入标准化的术语定义并提供统一的引用方式解决以下关键问题
- 为特定领域和上下文提供明确、原子化的术语定义
- 确保术语与其适用的协议/上下文紧密绑定
- 统一术语的引用方式,减少歧义
- 便于维护和更新术语定义
### 设计思想
术语定义协议基于以下核心理念:
1. **上下文绑定**:术语与其适用的协议文件紧密结合,确保术语在特定上下文中的含义明确。
2. **结构简洁**:采用最小必要的标签结构,便于维护和理解。
3. **引用明确**使用特定符号系统引用术语确保人类和AI都能识别术语引用。
4. **隐式作用域**:术语通过所在文件自动获得作用域,无需显式声明。
5. **自包含性**:协议文件包含其相关术语定义,提高文档完整性。
## 📝 语法定义
```ebnf
(* EBNF形式化定义 *)
terminologies_element ::= '<terminologies>' terminology+ '</terminologies>'
terminology_element ::= '<terminology>' terminology_content '</terminology>'
terminology_content ::= zh_element en_element definition_element examples_element
zh_element ::= '<zh>' text '</zh>'
en_element ::= '<en>' text '</en>'
definition_element ::= '<definition>' markdown_content '</definition>'
examples_element ::= '<examples>' example+ '</examples>'
example_element ::= '<example>' markdown_content '</example>'
text ::= (* 任何文本内容 *)
markdown_content ::= (* 任何有效的Markdown文本 *)
```
## 🧩 语义说明
### 术语定义结构
术语定义使用`<terminologies>`标签包含一组术语,每个术语使用`<terminology>`标签定义:
- **`<terminology>`**:单个术语的定义容器
- **`<zh>`**:术语的中文名称
- **`<en>`**:术语的英文名称
- **`<definition>`**术语的详细定义可同时包含AI理解和系统实现层面的解释
- **`<examples>`**:包含一个或多个`<example>`标签,提供使用示例
每个协议文件末尾使用标题"## 🔖 术语定义"引入术语定义部分,将术语定义与协议正文分隔。
### `#` 引用协议
术语定义协议规定了如何使用`#`符号作为统一的术语引用方式,遵循以下核心语法规则:
```ebnf
term_reference ::= '#' term_name [' ']
term_name ::= (* 术语的中文名称或英文名称 *)
```
#### 术语引用
术语引用在术语名称前使用井号标记:
| 语法 | 描述 | 示例 |
|------|------|------|
| `#术语` | 引用上下文中定义的术语 | `#协议绑定` |
基本术语引用在术语名称前使用井号,引用当前文档上下文中定义的术语:
```
#术语名称
```
例如:
- `#协议绑定` - 引用当前上下文中定义的"协议绑定"术语
- `#标签嵌套` - 引用当前上下文中定义的"标签嵌套"术语
推荐在术语后添加空格与其他内容分隔:`#术语 后续内容`,但这不是强制要求。
#### 与 Markdown 的兼容性
为了避免与 Markdown 的标题语法冲突DPML 采用以下解析规则:
1. **行首 # 符号**
- 当 # 出现在行首时,按照 Markdown 语法解析为标题
- 例如:`# 这是一个标题`
2. **非行首 # 符号**
- 当 # 出现在行中或词首时,解析为术语引用
- 例如:`这里引用了一个 #术语`
3. **行首术语引用**
- 如果需要在行首使用术语引用,可以添加空格或其他字符
- 例如:` #术语``文本 #术语`
这种设计保持了与 Markdown 的兼容性,同时提供了清晰的术语引用机制。
### 作用域规则
**隐式作用域**:术语自动具有其所在文档和上下文的作用域,这意味着:
- 术语的定义和使用范围由其所在的文档上下文决定
- 同一术语在不同上下文中可能有不同的定义
- 使用术语时应考虑当前所处的上下文环境

View File

@ -0,0 +1,60 @@
# DPML#思考提示单元 框架
> **TL;DR:** DPML#思考提示单元 框架定义了结构化的#思考单元 模板,支持四种核心#思维模式 的#思考提示单元 构建:#探索思维exploration、#推理思维reasoning、#计划思维plan和#挑战思维challenge帮助AI系统进行系统性分析和推理。
### 目的与功能
DPML#思考提示单元 框架定义了AI系统进行思考分析的#思考单元 模板和结构,它的主要功能是:
- 提供结构化的#思维分析#思考提示单元 模板
- 规范化#思考单元 的组织方式
- 支持可视化#思维导图#决策树#思考提示单元 表达
- 帮助AI系统通过标准化#思考提示单元 进行系统性、全面性的问题分析
- 区分不同类型的#思维模式#思考提示单元#探索思维#推理思维#计划思维#挑战思维
## 📝 语法定义
```ebnf
(* EBNF形式化定义 *)
thought_element ::= '<thought' attributes? '>' content '</thought>'
attributes ::= (' ' attribute)+ | ''
attribute ::= name '="' value '"'
name ::= [a-zA-Z][a-zA-Z0-9_-]*
value ::= [^"]*
content ::= (markdown_content | exploration_element | reasoning_element | plan_element | challenge_element)+
markdown_content ::= (* 任何有效的Markdown文本包括Mermaid图表 *)
exploration_element ::= '<exploration' attributes? '>' markdown_content '</exploration>'
reasoning_element ::= '<reasoning' attributes? '>' markdown_content '</reasoning>'
plan_element ::= '<plan' attributes? '>' markdown_content '</plan>'
challenge_element ::= '<challenge' attributes? '>' markdown_content '</challenge>'
```
## 🧩 语义说明
#思考提示单元 标签表示一个完整的#思考单元 或#思维框架。标签内容可以包含四种不同#思维模式 的子标签或直接使用Markdown格式表达#思考内容。
子标签具有明确的语义:
- **#探索思维**: 表示跳跃思考,发散性思维,生成可能性,寻找多种可能性、创新点和关联性
- **#推理思维**: 表示连续思考,收敛性思维,验证可能性,深入分析因果关系、逻辑链条
- **#计划思维**: 表示秩序思考,结构性思维,固化可能性,设计行动步骤、决策路径、组织结构、系统架构
- **#挑战思维**: 表示逆向跳跃思考,批判性思维,质疑可能性,寻找假设漏洞、识别潜在风险、测试极限条件
#探索思维 和#挑战思维 是一对#思维模式 的正反两面:#探索思维 向外发散寻找"可能是什么",而#挑战思维 向内批判探究"可能不是什么"。二者都采用跳跃式思考,但方向相反。#推理思维 负责系统验证,而#挑战思维 主要提出问题点。
#思考提示单元 特别适合表达概念关系、逻辑推理和系统性思考为AI提供#思考分析 的参考框架。
### 推荐的#思考顺序
在实际思考过程中,推荐遵循如下顺序以获得系统性和全面性的分析结果:
1. **#探索思维**:首先发散思考,提出尽可能多的可能性和创新点;
2. **#挑战思维**:对#探索思维 阶段的内容进行批判性思考,识别潜在风险和假设漏洞;
3. **#推理思维**:对经过#挑战思维 筛选的内容进行系统性推理和因果分析;
4. **#计划思维**:最后制定具体的行动方案和决策路径。
在复杂问题中,#挑战思维#推理思维 可多次交替,#计划思维 阶段也可穿插#挑战思维 以确保方案稳健性。
### 子标签的可选性
#思考提示单元 内的四种#思维模式 子标签(#探索思维、#挑战思维、#推理思维、#计划思维)均为可选。实际的#思考提示单元 可以只包含其中的一种、几种,或全部,具体内容由实际需求决定。
对于提示词的理解者来说,只需知道这些子标签不是必须全部出现,遇到哪些子标签就理解哪些即可,无需关心未出现的部分。

View File

@ -0,0 +1,73 @@
<terminologies>
<terminology>
<zh>思考提示单元</zh>
<en>Thought Prompt Unit</en>
<definition>
<thought>标签及其子标签如exploration、reasoning、plan、challenge构成的、表达完整思考过程的结构化提示词单元。常简称为"思考单元",两者等同。
</definition>
<examples>
<example>"本协议所有复杂推理均应以 #思考提示单元 为基本结构。"</example>
<example>"每个 #思考单元 都可以独立复用。"</example>
</examples>
</terminology>
<terminology>
<zh>思考单元</zh>
<en>Thought Unit</en>
<definition>
"思考提示单元"的简称,含义完全等同。参见"思考提示单元"。
</definition>
<examples>
<example>"请将你的分析拆分为多个 #思考单元。"</example>
</examples>
</terminology>
<terminology>
<zh>探索思维</zh>
<en>Exploration</en>
<definition>
在本协议中,#探索思维 专指 <exploration> 标签及其结构单元,表示用于承载发散性、创新性思考内容的提示词片段。
</definition>
<examples>
<example>"请将你的假设写入 #探索思维 单元(即 <exploration> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>推理思维</zh>
<en>Reasoning</en>
<definition>
在本协议中,#推理思维 专指 <reasoning> 标签及其结构单元,表示用于承载因果分析、逻辑推理内容的提示词片段。
</definition>
<examples>
<example>"所有因果链条建议写入 #推理思维 单元(即 <reasoning> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>计划思维</zh>
<en>Plan</en>
<definition>
在本协议中,#计划思维 专指 <plan> 标签及其结构单元,表示用于承载行动方案、结构规划内容的提示词片段。
</definition>
<examples>
<example>"最终方案请整理进 #计划思维 单元(即 <plan> 标签)。"</example>
</examples>
</terminology>
<terminology>
<zh>挑战思维</zh>
<en>Challenge</en>
<definition>
在本协议中,#挑战思维 专指 <challenge> 标签及其结构单元,表示用于承载批判性、风险识别内容的提示词片段。
</definition>
<examples>
<example>"请用 #挑战思维 单元(即 <challenge> 标签)补充反例和风险点。"</example>
</examples>
</terminology>
<terminology>
<zh>思维模式</zh>
<en>Thinking Mode</en>
<definition>
在本协议中,#思维模式 指不同类型的思考方式,如 #探索思维#推理思维#计划思维#挑战思维 等,分别由 <exploration><reasoning><plan><challenge> 标签实现。
</definition>
<examples>
<example>"可根据任务需要切换不同 #思维模式。"</example>
</examples>
</terminology>
</terminologies>