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

新增记忆功能，允许用户通过promptx.js remember命令添加记忆条目，并更新相关文档以规范记忆工具的使用。确保记忆条目格式统一，包含评分、标签和有效期信息，同时增加了工具使用监控流程和违规处理机制，提升系统的可靠性和用户体验。

Browse Source
This commit is contained in:
sean
2025-05-21 12:53:13 +08:00
parent 3d599dc6f7
commit 4e7a50f95d
6 changed files with 379 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@ -93,10 +93,19 @@
### 3. 自动存储流程
**自主执行工具调用**：
- 准备符合记忆条目格式的内容
- 自动选择适当的标签
- 主动使用工具调用实际写入记忆文件
- 验证工具调用结果
- 使用 `promptx.js remember` 命令存储记忆
- 命令格式：`node promptx.js remember "记忆内容" [#标签1 #标签2] [score:评分] [duration:时长]`
- 示例：`node promptx.js remember "用户偏好设置" #用户信息 #配置 score:8 duration:长期`
- 验证存储结果并提供反馈
**记忆存储格式**：
```
记忆条目格式：
- {内容} #{标签1} #{标签2} #评分:{分值} #有效期:{时长} #时间:{时间戳}
示例：
- 用户偏好深色主题 #用户信息 #配置 #评分:8 #有效期:长期 #时间:2024-03-20 15:30
```
### 4. 自动反馈机制
@ -111,17 +120,45 @@
- 检测对话中是否出现相关问题或需求
- 主动加载记忆文件并检索相关内容
- 自然地将记忆内容融入回答中
### 6. 工具初始化检查
**启动时执行**：
- 检查 promptx.js 是否可用
- 验证 remember 命令是否正常
- 确认记忆存储权限
### 7. 违规监控机制
**违规处理流程**：
```mermaid
flowchart TD
A[检测记忆存储请求] --> B{是否使用promptx.js}
B -->|是| C[继续处理]
B -->|否| D[记录违规]
D --> E{违规次数}
E -->|首次| F[发出警告]
E -->|再次| G[记录到审计日志]
E -->|三次及以上| H[暂停记忆功能]
F --> I[引导使用正确命令]
G --> I
H --> J[要求人工干预]
```
</process>
<rule>
1. 角色初始化时**必须**主动加载记忆文件
2. 显式记忆指令**必须**自动触发完整的记忆处理流程，无需用户提醒
3. 记忆存储**必须**通过实际工具调用执行，不得仅在对话中声明
2. 显式记忆指令**必须且只能**使用 `promptx.js remember` 命令执行存储
3. 记忆存储**必须**包含评分、标签和有效期信息
4. 工具调用结果**必须**得到验证，确保记忆实际写入
5. 记忆反馈**必须**简洁明了，使用emoji等轻量级方式
6. 高价值信息识别和评估**必须**自动进行，不依赖用户明确指示
7. 记忆回忆**必须**在检测到相关需求时自动触发
8. 记忆处理的全流程**必须**在单次对话交互中完成，不拖延到后续交互
9. **严禁**使用其他工具调用替代 promptx.js remember 命令
10. **严禁**忽略评分不达标的记忆存储请求
11. 违反工具使用规则**必须**执行违规处理流程
12. 命令格式**必须**为：node promptx.js remember "内容" [#标签] [score:分值] [duration:时长]
</rule>
<constraint>
@ -131,6 +168,12 @@
4. 记忆评估受限于AI的语义理解能力
5. 记忆文件访问和写入可能受到环境限制
6. emoji反馈可能在某些界面中显示不完整
7. 仅允许使用 promptx.js remember 进行记忆存储
8. 其他工具调用在记忆存储场景下将被拒绝
9. 记忆存储操作不可被其他工具替代
10. 单次记忆命令执行时间不超过1秒
11. 评分计算不超过100ms
12. 存储验证不超过50ms
</constraint>
<guideline>
@ -142,6 +185,9 @@
6. 记忆反馈应作为轻量级确认，不打断对话流程
7. 回忆机制应自然融入回答，避免机械式引用
8. 高度相关的记忆应在合适时机主动提供，不等用户询问
9. 发现记忆指令时应立即切换到 promptx.js remember 命令
10. 首次出现工具选择错误时，应提供正确使用方法的指导
11. 对于评分不达标的信息，应明确解释不存储的原因
</guideline>
<criteria>
@ -155,5 +201,8 @@
| 回忆主动性 | 相关场景下自动检索并应用记忆 | 用户需明确要求回忆 |
| 流程效率 | 不影响对话响应时间 | 明显延迟或阻塞对话 |
| 集成一致性 | 与现有记忆协议无缝集成 | 与其他协议冲突 |
| 工具选择正确性 | 使用 promptx.js remember | 使用其他工具调用 |
| 命令格式正确性 | 符合规定格式 | 格式错误或缺失参数 |
| 违规处理及时性 | 及时发现并处理违规 | 忽视违规操作 |
</criteria>
</execution>

146
core/execution/memory-tool-usage.execution.md Normal file
View File

@ -0,0 +1,146 @@
<execution>
<process>
# 记忆工具使用规范
```mermaid
flowchart TD
A[启动记忆服务] --> B[检查工具可用性]
B --> C[注册监控钩子]
C --> D[等待记忆触发]
D --> E{检测记忆指令}
E -->|显式指令| F[强制使用promptx.js]
E -->|隐式指令| G[评估并使用promptx.js]
F --> H[执行记忆命令]
G --> H
I[检测工具使用错误] --> J{纠正机制}
J -->|首次错误| K[发出警告]
J -->|再次错误| L[记录违规]
J -->|多次错误| M[阻断操作]
K --> N[提供正确示例]
L --> N
N --> O[重定向到正确工具]
O --> H
```
## 工具优先级规则
1. **命令优先级设置**
- promptx.js remember 命令具有最高优先级
- 任何记忆存储操作必须使用此命令
- 其他工具调用在记忆场景下将被自动拦截
2. **命令格式标准化**
- 标准格式：`node promptx.js remember "内容" [#标签] [score:分值] [duration:时长]`
- 示例：`node promptx.js remember "用户偏好简洁界面" #用户偏好 #设置 score:8 duration:长期`
- 所有参数必须按照规定格式提供，不得省略必要参数
3. **监控与拦截机制**
- 实时监控所有记忆相关操作
- 自动拦截非 promptx.js 的工具调用
- 自动转换为正确的命令格式
- 记录所有拦截和转换操作
4. **违规处理流程**
```
1. 首次违规：发出警告，提供正确使用示例
2. 二次违规：记录违规，强制转换为正确命令
3. 三次违规：阻断操作，要求人工确认
4. 多次违规：暂时禁用自动记忆功能
```
5. **工具调用初始化检查**
- 系统启动时检查 promptx.js 可用性
- 验证 remember 命令是否正常工作
- 测试记忆存储路径的写入权限
- 配置违规监控阈值和处理策略
</process>
<rule>
1. **工具选择强制规则**
- 记忆操作**必须且只能**使用 promptx.js remember 命令
- **严禁**使用任何其他工具调用替代
- 违反工具使用规则将触发自动拦截和纠正
- 连续违规将导致记忆功能暂时禁用
2. **命令格式强制规则**
- 命令格式必须为：`node promptx.js remember "内容" [#标签] [score:分值] [duration:时长]`
- 评分参数必须提供
- 标签必须遵循规定的标签体系
- 有效期必须明确指定
3. **参数验证规则**
- 内容不得为空
- 评分必须为有效数值(0-10)
- 有效期必须为预定义值(短期/中期/长期)
- 内容长度不超过100个字符
4. **工具监控规则**
- 记忆相关操作必须被实时监控
- 监控程序不得干扰正常对话流程
- 所有违规记录必须保存到审计日志
- 违规统计数据必须定期清零
</rule>
<constraint>
1. **工具使用技术限制**
- promptx.js 依赖于运行环境
- 监控机制受系统性能限制
- 拦截和转换操作可能产生轻微延迟
- 并发记忆操作存在资源竞争
2. **命令执行限制**
- 单次记忆命令执行时间不超过1秒
- 命令参数总长度不超过200字符
- 同一会话中记忆操作数量有限
- 命令执行失败时需有重试机制
3. **监控性能限制**
- 监控开销不超过10ms/次
- 拦截处理不超过50ms/次
- 审计日志大小不超过2MB
- 违规计数器精度为会话级别
</constraint>
<guideline>
1. **工具选择最佳实践**
- 始终首选 promptx.js remember 命令
- 熟悉命令的完整语法和参数
- 在记忆相关操作前主动切换到正确工具
- 不尝试使用替代工具绕过限制
2. **命令使用技巧**
- 准备好所有必要参数再执行命令
- 标签应简洁明确，便于后续检索
- 评分应基于多维度评估结果
- 有效期应与信息的时效性匹配
3. **错误处理建议**
- 命令执行失败时检查参数格式
- 权限问题时检查存储路径设置
- 内容过长时进行适当分割
- 遇到违规警告时立即改正
4. **监控响应建议**
- 理解并遵循工具使用规则
- 收到警告时认真查看提供的示例
- 避免尝试绕过监控系统
- 记录并学习常见的使用错误
</guideline>
<criteria>
| 指标 | 通过标准 | 不通过标准 |
|------|---------|-----------|
| 工具选择正确性 | 100%使用promptx.js remember | 使用其他工具调用 |
| 命令格式准确性 | 完全符合规定格式 | 参数缺失或格式错误 |
| 参数完整性 | 提供所有必要参数 | 缺少关键参数 |
| 拦截响应速度 | 错误检测后立即拦截 | 延迟拦截或不拦截 |
| 纠正准确性 | 正确转换为标准格式 | 转换错误或不完整 |
| 违规处理及时性 | 违规后立即执行处理 | 延迟处理或忽略违规 |
| 审计记录完整性 | 记录所有相关操作 | 记录缺失或不完整 |
| 用户体验影响 | 不影响正常对话流程 | 明显干扰对话体验 |
</criteria>
</execution>

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

@ -54,6 +54,31 @@
- 时效性：2 (短期有效)
总分：4.3分 ✗ (未通过存储阈值)
```
## 工具使用监控流程
```mermaid
flowchart TD
A[检测记忆操作] --> B{检查工具选择}
B -->|promptx.js| C[继续处理]
B -->|其他工具| D[拦截操作]
D --> E[记录违规]
E --> F[强制重定向]
F --> G[使用正确工具]
G --> C
C --> H[执行记忆存储]
```
1. **工具使用检测**：
- 主动监控记忆相关操作
- 识别显式和隐式记忆指令
- 在检测到记忆指令时立即验证工具选择
2. **工具纠正机制**：
- 发现错误工具使用时立即拦截
- 自动切换到 promptx.js remember 命令
- 保留原始参数并转换为正确格式
- 记录纠正操作以便审计
</process>
<rule>
@ -64,21 +89,40 @@
- 显式记忆指令可以覆盖评分，但最低为8分
2. **存储前置条件**
- 存储操作必须验证评分标记
- 未评分的记忆条目将被自动拒绝
- 存储操作必须且只能使用 `promptx.js remember` 命令
- 严禁使用其他工具调用替代 promptx.js remember
- 命令格式必须包含评分和标签信息
- 评分需包含具体分值和评估依据
- 评分标记格式：#评分:{分值} #评估:{维度得分}
- 存储示例：
```bash
# 高价值信息存储
node promptx.js remember "用户ID: 12345" #用户信息 #核心信息 score:9 duration:长期
# 中等价值信息存储
node promptx.js remember "用户喜欢简洁界面" #用户偏好 score:6 duration:长期
# 低价值信息（不建议存储）
node promptx.js remember "临时调试信息" #调试 score:3 duration:短期
```
3. **违规处理机制**
- 对违规存储操作发出警告提示
- 自动清理评分不达标的记忆条目
- 记录违规操作到审计日志
- 连续违规将触发系统提醒
- 对评分不达标的存储操作发出警告提示
- 系统会自动拒绝评分低于5分的存储请求
- 记录所有存储操作到 `.memory/declarative.md`
- 定期检查并清理低价值记忆
- 检测到错误工具使用时必须立即纠正
- 记录所有工具使用违规到审计日志
4. **评分有效性**
- 评分有效期为当前会话
- 跨会话的记忆条目需重新评估
- 定期对已存储记忆进行重新评分
5. **工具使用优先级**
- promptx.js remember 命令具有最高优先级
- 任何其他工具调用尝试将被自动拦截并重定向
- 记忆相关操作必须通过指定命令执行
- 违反工具使用规则将触发警告和纠正机制
</rule>
<constraint>
@ -86,16 +130,24 @@
- 单次评分计算不超过100ms
- 评分维度数量固定为6个
- 评分精度保留一位小数
- 记忆命令执行时间不超过1秒
2. **存储验证限制**
- 验证超时时间不超过50ms
- 单次会话最多允许3次违规
- 评分记录最多保存30天
- `.memory` 目录总大小不超过10MB
3. **系统资源限制**
- 评分计算内存占用不超过10MB
- 审计日志大小不超过1MB
- 单日评分次数不超过1000次
4. **工具使用限制**
- 记忆存储操作仅支持 promptx.js remember 命令
- 工具调用监控开销不超过10ms
- 工具切换过程不影响用户体验
- 纠正机制仅在检测到错误工具使用时触发
</constraint>
<guideline>
@ -106,6 +158,9 @@
5. 记忆反馈应简洁，避免打断自然对话流程
6. 会话结束记忆处理应尽可能全面但有选择性
7. 长期价值信息优先于短期价值信息
8. 检测到记忆相关操作时立即使用正确的工具
9. 首次工具使用错误时提供明确的纠正指导
10. 主动监控工具选择以确保符合规则
</guideline>
<criteria>
@ -117,5 +172,8 @@
| 响应及时性 | 评分计算及时 | 计算延迟明显 |
| 反馈清晰度 | 提供明确反馈 | 反馈模糊或缺失 |
| 审计完整性 | 记录所有违规 | 违规记录缺失 |
| 工具选择正确性 | 仅使用 promptx.js remember | 使用其他工具调用 |
| 工具切换及时性 | 错误检测后立即切换 | 延迟切换或不切换 |
| 命令格式正确性 | 完全符合规定格式 | 参数错误或不完整 |
</criteria>
</execution>