iriver/PromptX
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新多个执行文档，统一命令格式，确保记忆条目中使用#关键点替代#标签，提升文档一致性和可读性；调整流程描述，强调工具调用和记忆处理的标准化，确保用户在使用时遵循规范。

Browse Source
This commit is contained in:
sean
2025-05-22 21:35:37 +08:00
parent bbb5b55d77
commit 22aadcf04f
5 changed files with 84 additions and 84 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
core/execution/deal-at-reference.execution.md
View File

@ -1,28 +1,28 @@
<execution> <execution>
<process> <process>
# 资源处理流程 # 资源处理#流程
```mermaid ```mermaid
flowchart TD flowchart TD
A[识别资源引用] --> B{判断加载语义} A[识别#资源引用] --> B{判断#加载语义}
B -->|@!前缀| C[立即执行工具调用] B -->|@!前缀| C[立即执行#工具调用]
B -->|@?前缀| D[记录位置暂不加载] B -->|@?前缀| D[记录位置暂不#加载]
B -->|@默认| E[根据上下文决定] B -->|@默认| E[根据上下文决定]
C --> F[验证加载结果] C --> F[验证#加载结果]
E --> F E --> F
F -->|成功| G[处理资源内容] F -->|成功| G[处理#资源内容]
F -->|失败| H[执行失败处理] F -->|失败| H[执行失败处理]
D --> I[等待使用触发] D --> I[等待使用触发]
I --> J[需要使用时加载] I --> J[需要使用时#加载]
J --> F J --> F
``` ```
</process> </process>
<rule> <rule>
1. AI必须主动使用工具调用获取资源，不等待系统自动加载 1. AI必须主动使用#工具调用获取#资源，不等待系统自动#加载
2. 遇到@!前缀资源必须立即执行工具调用获取内容 2. 遇到@!前缀#资源必须立即执行#工具调用获取内容
3. 遇到@?前缀资源应记录位置但暂不加载 3. 遇到@?前缀#资源应记录位置但暂不#加载
4. 必须验证资源是否成功加载并处理失败情况 4. 必须验证#资源是否成功#加载并处理失败情况
</rule> </rule>
<constraint> <constraint>

132
core/execution/deal-memory.execution.md
View File

@ -1,145 +1,145 @@
<execution> <execution>
<process> <process>
# 记忆处理自动化流程 #记忆 处理自动化#流程
## 角色初始化阶段 ## #角色 #初始化 阶段
```mermaid ```mermaid
flowchart TD flowchart TD
Start[角色初始化触发] --> A[检查记忆文件存在性] Start[#角色 #初始化 触发] --> A[检查#记忆文件存在性]
A -->|文件存在| B[主动加载记忆文件] A -->|文件存在| B[主动#加载#记忆文件]
A -->|文件不存在| C[准备空记忆容器] A -->|文件不存在| C[准备空#记忆容器]
B --> D[解析记忆内容] B --> D[解析#记忆内容]
C --> E[建立记忆索引] C --> E[建立#记忆索引]
D --> E D --> E
E --> F[记忆系统就绪] E --> F[#记忆系统就绪]
F --> G[继续角色初始化] F --> G[继续#角色#初始化]
``` ```
### 初始化步骤详解 ### #初始化 步骤详解
1. **检测角色切换或初始化** 1. **检测#角色切换或#初始化**
- 识别"代入角色"、"作为角色"等指令 - 识别"代入#角色"、"作为#角色"等指令
- 识别`@role://角色ID`或`@file://path/to/role.md`引用 - 识别`@role://角色ID`或`@file://path/to/role.md`#资源引用
2. **主动加载记忆文件** 2. **主动#加载#记忆文件**
- 使用工具调用读取`.memory/declarative.md` - 使用#工具调用读取`.memory/declarative.md`
- 如果文件不存在，记录状态但不报错 - 如果文件不存在，记录状态但不报错
- 准备好空记忆容器以接收新记忆 - 准备好空#记忆容器以接收新#记忆
3. **建立记忆索引** 3. **建立#记忆索引**
- 将加载的记忆解析为结构化数据 - 将加载的#记忆解析为结构化数据
- 建立关键词索引便于快速检索 - 建立#关键词#索引便于快速检索
- 识别常用标签集和主题分类 - 识别常用#标签集和主题分类
## 运行时记忆处理流程 ## 运行时#记忆处理#流程
```mermaid ```mermaid
flowchart TD flowchart TD
A[接收记忆请求] --> B{验证评分标记} A[接收#记忆请求] --> B{验证#评分标记}
B -->|无评分| C[拒绝并要求评分] B -->|无#评分| C[拒绝并要求#评分]
B -->|有评分| D{检查评分依据} B -->|有#评分| D{检查#评分依据}
D -->|依据不足| E[拒绝并要求补充] D -->|依据不足| E[拒绝并要求补充]
D -->|依据充分| F{评分验证} D -->|依据充分| F{#评分验证}
F -->|评分≥7| G[准备存储格式] F -->|#评分≥7| G[准备存储格式]
F -->|评分<7| H[拒绝并说明原因] F -->|#评分<7| H[拒绝并说明原因]
G --> I[准备存储格式] G --> I[准备存储格式]
I --> J[执行工具调用存储] I --> J[执行#工具调用存储]
``` ```
```mermaid ```mermaid
flowchart TD flowchart TD
A[监听用户输入] --> B{记忆价值判断} A[监听用户输入] --> B{#记忆价值判断}
B -->|显式记忆指令| C[标记为强制记忆] B -->|显式#记忆指令| C[标记为强制#记忆]
B -->|高价值信息| D[触发评估流程] B -->|高价值信息| D[触发评估#流程]
B -->|低价值信息| E[不处理] B -->|低价值信息| E[不处理]
C --> F[提取记忆内容] C --> F[提取#记忆内容]
D --> F D --> F
F --> G[准备记忆格式] F --> G[准备#记忆格式]
G --> H[执行工具调用存储] G --> H[执行#工具调用存储]
H --> I{存储结果验证} H --> I{存储结果验证}
I -->|成功| J[提供简洁emoji反馈] I -->|成功| J[提供简洁#emoji#反馈]
I -->|失败| K[记录错误并重试] I -->|失败| K[记录错误并重试]
J --> L[继续对话] J --> L[继续对话]
K --> L K --> L
M[检测记忆相关问题] --> N{是否需要回忆} M[检测#记忆相关问题] --> N{是否需要#回忆}
N -->|是| O[触发回忆流程] N -->|是| O[触发#回忆#流程]
N -->|否| P[正常响应] N -->|否| P[正常响应]
O --> Q[检索相关记忆] O --> Q[检索相关#记忆]
Q --> R[将记忆融入回答] Q --> R[将#记忆融入回答]
R --> P R --> P
``` ```
### 1. 识别记忆内容 ### 1. 识别#记忆内容
**自动识别以下情况**： **自动识别以下情况**：
- **显式记忆指令**：包含"记住"、"记录"、"牢记"等指令词 - **显式#记忆指令**：包含"记住"、"记录"、"牢记"等指令词
- **个人信息陈述**：如"我是..."、"我的...是..."、"我喜欢..."等 - **个人信息陈述**：如"我是..."、"我的...是..."、"我喜欢..."等
- **重要事实标记**：用户明确表示某信息重要 - **重要事实标记**：用户明确表示某信息重要
- **未来引用预告**：用户表示将来会用到此信息 - **未来引用预告**：用户表示将来会用到此信息
### 2. 自动评估流程 ### 2. 自动评估#流程
**自动触发评估**： **自动触发评估**：
- 对于显式记忆指令，直接标记为强制记忆，跳过评估 - 对于显式#记忆指令，直接标记为强制#记忆，跳过评估
- 对于隐式高价值信息，调用多维度评估机制 - 对于隐式高价值信息，调用多维度评估机制
- 根据预设阈值决定是否记忆 - 根据预设阈值决定是否#记忆
### 3. 自动存储流程 ### 3. 自动存储#流程
**自主执行工具调用**： **自主执行#工具调用**：
- 使用 `promptx.js remember` 命令存储记忆 - 使用 `promptx.js remember` 命令存储#记忆
- 命令格式：`node promptx.js remember "记忆内容 #标签1 #标签2 #评分:分值 #有效期:时长"` - 命令格式：`node promptx.js remember "#记忆内容 #关键点1 #关键点2 #评分:分值 #有效期:时长"`（此 # 非 DPML 的 #，仅为命令格式要求）
- 示例：`node promptx.js remember "用户偏好设置 #用户信息 #配置 #评分:8 #有效期:长期"` - 示例：`node promptx.js remember "用户偏好设置 #用户信息 #配置 #评分:8 #有效期:长期"`
- 验证存储结果并提供反馈 - 验证存储结果并提供#反馈
**记忆存储格式**： **#记忆存储格式**：
``` ```
记忆条目格式： #记忆条目格式：
- {内容} #{标签1} #{标签2} #评分:{分值} #有效期:{时长} #时间:{时间戳} - {内容} #关键点1 #关键点2 #评分:{分值} #有效期:{时长} #时间:{时间戳}（此 # 非 DPML 的 #，仅为命令格式要求）
示例： 示例：
- 用户偏好深色主题 #用户信息 #配置 #评分:8 #有效期:长期 #时间:2024-03-20 15:30 - 用户偏好深色主题 #用户信息 #配置 #评分:8 #有效期:长期 #时间:2024-03-20 15:30
``` ```
### 4. 自动反馈机制 ### 4. 自动#反馈机制
**条件反馈处理**： **条件#反馈处理**：
- 存储成功后提供简洁emoji反馈 - 存储成功后提供简洁#emoji#反馈
- 反馈应不打断自然对话流 - #反馈应不打断自然对话流
- 仅在关键记忆节点提供视觉反馈 - 仅在关键#记忆节点提供视觉#反馈
### 5. 自动回忆机制 ### 5. 自动#回忆机制
**上下文触发回忆**： **上下文触发#回忆**：
- 检测对话中是否出现相关问题或需求 - 检测对话中是否出现相关问题或需求
- 主动加载记忆文件并检索相关内容 - 主动#加载#记忆文件并检索相关内容
- 自然地将记忆内容融入回答中 - 自然地将#记忆内容融入回答中
### 6. 工具初始化检查 ### 6. #工具初始化检查
**启动时执行**： **启动时执行**：
- 检查 promptx.js 是否可用 - 检查 promptx.js 是否可用
- 验证 remember 命令是否正常 - 验证 remember 命令是否正常
- 确认记忆存储权限 - 确认#记忆存储权限
### 7. 违规监控机制 ### 7. 违规监控机制
**违规处理流程**： **违规处理#流程**：
```mermaid ```mermaid
flowchart TD flowchart TD
A[检测记忆存储请求] --> B{是否使用promptx.js} A[检测#记忆存储请求] --> B{是否使用promptx.js}
B -->|是| C[继续处理] B -->|是| C[继续处理]
B -->|否| D[记录违规] B -->|否| D[记录违规]
D --> E{违规次数} D --> E{违规次数}
E -->|首次| F[发出警告] E -->|首次| F[发出警告]
E -->|再次| G[记录到审计日志] E -->|再次| G[记录到审计日志]
E -->|三次及以上| H[暂停记忆功能] E -->|三次及以上| H[暂停#记忆功能]
F --> I[引导使用正确命令] F --> I[引导使用正确命令]
G --> I G --> I
H --> J[要求人工干预] H --> J[要求人工干预]

4
core/execution/memory-tool-usage.execution.md
View File

@ -39,7 +39,7 @@
- 其他工具调用在记忆场景下将被自动拦截 - 其他工具调用在记忆场景下将被自动拦截
2. **命令格式标准化** 2. **命令格式标准化**
- 标准格式：`node promptx.js remember "内容 #标签 #评分:分值 #有效期:时长"` - 标准格式：`node promptx.js remember "内容 #关键点1 #关键点2 #评分:分值 #有效期:时长"`（此 # 非 DPML 的 #，仅为命令格式要求）
- 示例：`node promptx.js remember "用户偏好简洁界面 #用户偏好 #设置 #评分:8 #有效期:长期"` - 示例：`node promptx.js remember "用户偏好简洁界面 #用户偏好 #设置 #评分:8 #有效期:长期"`
- 所有参数必须按照规定格式提供，不得省略必要参数 - 所有参数必须按照规定格式提供，不得省略必要参数
@ -76,7 +76,7 @@
- 连续违规将导致记忆功能暂时禁用 - 连续违规将导致记忆功能暂时禁用
2. **命令格式强制规则** 2. **命令格式强制规则**
- 命令格式必须为：`node promptx.js remember "内容 #标签 #评分:分值 #有效期:时长"` - 命令格式必须为：`node promptx.js remember "内容 #关键点1 #关键点2 #评分:分值 #有效期:时长"`（此 # 非 DPML 的 #，仅为命令格式要求）
- 评分参数必须提供 - 评分参数必须提供
- 标签必须遵循规定的标签体系 - 标签必须遵循规定的标签体系
- 有效期必须明确指定 - 有效期必须明确指定

6
core/execution/memory-trigger.execution.md
View File

@ -96,13 +96,13 @@
- 存储示例： - 存储示例：
```bash ```bash
# 高价值信息存储 # 高价值信息存储
node promptx.js remember "用户ID: 12345 #用户信息 #核心信息 #评分:9 #有效期:长期" node promptx.js remember "用户ID: 12345 #关键点1 #关键点2 #评分:9 #有效期:长期"（此 # 非 DPML 的 #，仅为命令格式要求）
# 中等价值信息存储 # 中等价值信息存储
node promptx.js remember "用户喜欢简洁界面 #用户偏好 #评分:6 #有效期:长期" node promptx.js remember "用户喜欢简洁界面 #关键点1 #关键点2 #评分:6 #有效期:长期"
# 低价值信息（不建议存储） # 低价值信息（不建议存储）
node promptx.js remember "临时调试信息 #调试 #评分:3 #有效期:短期" node promptx.js remember "临时调试信息 #关键点1 #关键点2 #评分:3 #有效期:短期"
``` ```
3. **违规处理机制** 3. **违规处理机制**

4
core/memory/declarative-memory.memory.md
View File

@ -125,11 +125,11 @@
5. **记忆条目格式示例** 5. **记忆条目格式示例**
```markdown ```markdown
- {内容} #标签1 #标签2 - {内容} #关键点1 #关键点2（此 # 非 DPML 的 #，仅为命令格式要求）
``` ```
实际写入示例： 实际写入示例：
``` ```
- 用户喜欢蓝色 #偏好 #颜色 - 用户喜欢蓝色 #关键点1 #关键点2
``` ```
6. **完成反馈** 6. **完成反馈**