mirror of
https://gitcode.com/JianFeeeee/TrulyMEM-TrueHumanMEM.git
synced 2026-10-15 12:15:32 +00:00
9e2f390332
移除frontmatter中不被WaterFlow处理的冗余字段: - name: WaterFlow使用目录名作为skill名称 - description: WaterFlow从Markdown #标题提取 - when_to_use: 不被处理，整合到body中 修改后的SKILL.md完全兼容WaterFlow SkillLoader: - description从#标题正确提取 - allowed-tools正确转换为allowedTools - arguments正确映射 - user-invocable正确转换为userInvocable
207 lines
4.3 KiB
Markdown
207 lines
4.3 KiB
Markdown
---
|
||
context: inline
|
||
allowed-tools:
|
||
- builtin:graph_memory
|
||
arguments:
|
||
- name: action
|
||
type: string
|
||
required: true
|
||
enum: [recall, commit, purge, introspect, persona_update, persona_clear, task_create, task_set_state, task_delete, task_link_info]
|
||
description: 记忆操作类型
|
||
- name: params
|
||
type: object
|
||
required: true
|
||
description: 操作参数
|
||
user-invocable: true
|
||
---
|
||
|
||
# 图记忆工具 - 让 AI 拥有真正的长期记忆能力
|
||
|
||
**何时使用**: 需要 AI 记住、回忆、管理信息或任务时调用此技能。
|
||
|
||
你可以通过以下操作与图记忆系统交互。
|
||
|
||
## 核心操作
|
||
|
||
### 1. recall - 检索记忆
|
||
|
||
从记忆图中检索相关信息。支持广度优先搜索（BFS），自动扩展关联实体。
|
||
|
||
**参数**:
|
||
- `queryIntent`: 搜索意图/关键词
|
||
- `seedEntities`: 可选的种子实体名
|
||
- `depth`: 检索深度（默认 2，BFS 层数）
|
||
- `sessionFilter`: 可选的会话ID过滤
|
||
|
||
**示例**:
|
||
```
|
||
action: recall
|
||
params:
|
||
queryIntent: "用户 喜欢 编程"
|
||
seedEntities: ["用户"]
|
||
depth: 2
|
||
```
|
||
|
||
### 2. commit - 写入记忆
|
||
|
||
将信息写入记忆图。使用三元组（主体-关系-客体）格式。
|
||
|
||
**参数**:
|
||
- `triplets`: 三元组数组，每个包含 subject, relation, object, confidence(可选)
|
||
- `sessionId`: 会话ID
|
||
- `turnId`: 轮次ID
|
||
|
||
**示例**:
|
||
```
|
||
action: commit
|
||
params:
|
||
triplets:
|
||
- subject: "用户"
|
||
relation: "喜欢"
|
||
object: "Python"
|
||
- subject: "用户"
|
||
relation: "正在学习"
|
||
object: "TypeScript"
|
||
```
|
||
|
||
### 3. purge - 删除记忆
|
||
|
||
从记忆图中删除信息。
|
||
|
||
**参数**:
|
||
- `criteria`: 删除条件 (subject, target, relation, sessionId)
|
||
- `mode`: 删除模式 (soft=标记删除/hard=物理删除/supersede=替代)
|
||
|
||
**示例**:
|
||
```
|
||
action: purge
|
||
params:
|
||
criteria:
|
||
subject: "旧信息"
|
||
mode: "soft"
|
||
```
|
||
|
||
### 4. introspect - 查看状态
|
||
|
||
查看当前记忆状态统计（实体数、关系数）。
|
||
|
||
**参数**: 无
|
||
|
||
**示例**:
|
||
```
|
||
action: introspect
|
||
params: {}
|
||
```
|
||
|
||
## 人设管理
|
||
|
||
### 5. persona_update - 更新人设
|
||
|
||
更新 AI 的人设属性（性格、语气、角色等）。
|
||
|
||
**参数**:
|
||
- `attributes`: 属性数组，每个包含 attribute 和 value
|
||
- `mode`: merge(合并) 或 replace(替换)
|
||
|
||
**示例**:
|
||
```
|
||
action: persona_update
|
||
params:
|
||
attributes:
|
||
- attribute: "性格"
|
||
value: "活泼可爱"
|
||
- attribute: "语气词"
|
||
value: "喵"
|
||
mode: "replace"
|
||
```
|
||
|
||
### 6. persona_clear - 清除人设
|
||
|
||
清除所有人设，恢复默认身份。
|
||
|
||
**参数**:
|
||
- `confirm`: 必须为 true 才执行
|
||
|
||
**示例**:
|
||
```
|
||
action: persona_clear
|
||
params:
|
||
confirm: true
|
||
```
|
||
|
||
## 任务管理
|
||
|
||
### 7. task_create - 创建任务
|
||
|
||
创建连续性任务节点，维持对话连贯性。
|
||
|
||
**参数**:
|
||
- `task_id`: 任务唯一ID
|
||
- `description`: 任务描述
|
||
- `info_nodes`: 可选的关联信息节点列表
|
||
|
||
**示例**:
|
||
```
|
||
action: task_create
|
||
params:
|
||
task_id: "Task_成语接龙"
|
||
description: "成语接龙游戏，当前成语：为所欲为"
|
||
info_nodes: ["成语接龙_当前成语"]
|
||
```
|
||
|
||
### 8. task_set_state - 设置任务状态
|
||
|
||
更新任务状态（进行中/已完成/已暂停/已取消）。
|
||
|
||
**参数**:
|
||
- `task_id`: 任务ID
|
||
- `state`: 新状态
|
||
|
||
**示例**:
|
||
```
|
||
action: task_set_state
|
||
params:
|
||
task_id: "Task_成语接龙"
|
||
state: "已暂停"
|
||
```
|
||
|
||
### 9. task_delete - 删除任务
|
||
|
||
删除任务节点。
|
||
|
||
**参数**:
|
||
- `task_id`: 任务ID
|
||
|
||
**示例**:
|
||
```
|
||
action: task_delete
|
||
params:
|
||
task_id: "Task_成语接龙"
|
||
```
|
||
|
||
### 10. task_link_info - 关联信息到任务
|
||
|
||
将记忆节点关联到任务节点，实现"由一件事回忆起相关事情"。
|
||
|
||
**参数**:
|
||
- `task_id`: 任务ID
|
||
- `info_node`: 信息节点名
|
||
|
||
**示例**:
|
||
```
|
||
action: task_link_info
|
||
params:
|
||
task_id: "Task_成语接龙"
|
||
info_node: "用户喜欢罗辑"
|
||
```
|
||
|
||
## 使用原则
|
||
|
||
1. **选择性记忆**: 只记住重要和持久的信息
|
||
2. **结构化**: 使用三元组 (主体-关系-客体) 格式
|
||
3. **关联**: 通过关系连接相关实体
|
||
4. **定期清理**: 删除过时或错误的信息
|
||
5. **BFS 搜索**: recall 支持广度优先搜索，depth 参数控制扩展层数
|
||
6. **工作记忆链**: 每轮对话必须查询和更新工作记忆链（TaskNode），这是维持对话连贯性的唯一机制
|
||
7. **人设优先**: 每轮对话必须先查询人设图，确保角色一致性
|