⚠️ 发布规则

所有发布到ClawHub的技能必须严格测试，确定没有问题再发布

技能测试验证清单

• frontmatter格式正确
• 功能原创独特
• 概念清晰易懂
• 操作流程完整
• 无语法错误

Context Memory Ball - 上下文记忆球

原创技能 | 激活词: 记忆球 / 保存上下文 / 加载上下文

核心概念

什么是记忆球?

记忆球 = 上下文快照的封装单元

┌─────────────────────────────────┐
│         记忆球 (Memory Ball)      │
├─────────────────────────────────┤
│  ID: ball_20260428_001          │
│  创建时间: 2026-04-28 13:45     │
│  主题: 用户偏好分析              │
├─────────────────────────────────┤
│  内容摘要:                       │
│  - 用户偏好: React + TypeScript  │
│  - 当前任务: 开发用户模块         │
│  - 进度: 70%                     │
├─────────────────────────────────┤
│  状态: active                    │
└─────────────────────────────────┘

为什么叫"球"?

• 封装性: 完整的上下文单元
• 可滚动: 可以在不同会话间传递
• 弹性: 压缩后可以恢复
• 可叠加: 多个球可以合并

记忆球结构

class MemoryBall:
    id: str              # 唯一标识
    timestamp: str       # 创建时间
    topic: str           # 主题/标题
    summary: str         # 内容摘要
    key_points: list     # 关键点
    decisions: list     # 已做决策
    pending: list        # 待办事项
    context_tokens: int  # token数量
    state: str           # active/complete/archived

操作命令

创建记忆球

用户: "帮我记住当前进度"
AI: 创建记忆球 #001

## 记忆球 #001 已创建

### 基础信息
- ID: ball_20260428_001
- 主题: 用户模块开发
- 创建时间: 2026-04-28 13:45

### 内容摘要
- 已完成: 用户登录、注册页面
- 进行中: 用户资料编辑
- 待开始: 用户权限管理

### 状态
🟢 active

保存记忆球

# 保存到文件
mempalace save ball_001

# 导出JSON
mempalace export ball_001 --format json

加载记忆球

# 从文件加载
mempalace load ball_001

# 加载并恢复上下文
"加载记忆球 ball_001"

合并记忆球

当需要同时处理多个任务时：

用户: "加载球1和球3"
AI: 合并记忆球 #001 + #003

## 合并结果

### 当前上下文
- 任务A: 用户模块开发 (70%)
- 任务B: 订单模块设计 (30%)

### 建议
⚠️ 同时处理2个任务，是否需要拆分?

归档记忆球

# 归档完成的任务
mempalace archive ball_001

# 归档并创建总结
mempalace archive ball_001 --summary

使用场景

场景1: 会话切换

用户A: "先做任务X，记住进度"
AI: [创建记忆球 ball_A]
用户B: "切换到任务X"
AI: [加载 ball_A，恢复上下文]

场景2: 多任务并行

项目A: [创建 ball_A]
项目B: [创建 ball_B]
项目C: [创建 ball_C]

随时切换: 加载任意球恢复

场景3: 上下文恢复

长任务中断后:
用户: "继续上次的工作"
AI: [加载最近的active球]

场景4: 经验积累

完成的项目:
- ball_001: React项目经验
- ball_002: API设计经验
- ball_003: 性能优化经验

新项目可以学习这些球的经验

记忆球管理

列表查看

## 当前记忆球

| ID | 主题 | 状态 | 创建时间 |
|----|------|------|----------|
| 001 | 用户模块开发 | 🟢 active | 13:45 |
| 002 | 订单模块设计 | 🔴 pending | 14:20 |
| 003 | React经验总结 | ✅ complete | 昨天 |

清理策略

与熵管理结合

上下文增长 → 熵值上升
创建记忆球 → 上下文精简
熵值下降 ← 恢复清晰状态

输出格式

## 记忆球报告

### 统计
- 总数: 5个
- Active: 2个
- Archived: 3个

### 最近活动
- ball_001: 5分钟前更新
- ball_002: 2小时前更新

### 建议
🟢 记忆球状态良好

原创性声明

本技能为原创，首创"记忆球"概念：

• 上下文封装单元
• 可保存/加载/恢复
• 支持合并和归档
• 与熵管理互补

作者: laosi 创建日期: 2026-04-28