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

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

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

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

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