用途
Scratch Pad 是一个基于 Markdown 的工作记忆(working memory)工具,用于在复杂任务执行过程中跟踪进度、保存中间结果并组织信息。它把内容直接写入一个 .md 文件,可以立即读取使用。
主要能力
命令行脚本提供以下操作:
- 初始化:
python scripts/scratch_pad.py init "Task Name",创建指定任务名的记录文件,也可用--file指定路径。 - 追加内容:
python scripts/scratch_pad.py append "Content to add..."。 - 添加章节标题:
python scripts/scratch_pad.py section "Research Findings"。 - 读取全部内容:
python scripts/scratch_pad.py read。 - 记录工具调用:
python scripts/scratch_pad.py log-tool "tool_name" '{"param": "value"}' "result text",保存工具名、参数与结果。 - 添加发现:
python scripts/scratch_pad.py finding "Important discovery" --category "Analysis"。 - 添加检查点:
python scripts/scratch_pad.py checkpoint "Phase 1 Complete"。 - 管理待办:
python scripts/scratch_pad.py todo "Follow up on this",用--done标记已完成。 - 标记任务完成:
python scripts/scratch_pad.py complete。
同时提供 Python 模块接口,可导入 ScratchPadManager,使用 init、add_section、append、log_tool、add_finding、read、complete 等方法。
使用方式
资料给出的集成模式为:任务开始时初始化文件;每次工具调用前后记录参数与结果;随时添加发现;需要时读取内容作为参考;任务结束后删除临时文件。文件建议放在 FILESYSTEM_BASE_DIR/files/{channel_id}/tmp/ 下,命名为 scratch_{timestamp}.md 或 scratch_{task_id}.md,并保持体积在 1MB 以内。
适用场景
资料建议在以下情况使用:需要 5 次以上工具调用的任务、多来源调研(如“조사해줘”)、对比分析(“비교해줘”)、信息综合整理(“정리해줘”)以及分步骤处理。
限制与注意事项
- 资料强调 scratch pad 仅供自身参考,不应把原始 Markdown 直接复制粘贴到回复中,而应据此组织并撰写正式答复。
- 使用后必须删除临时文件。
- 输出文件为易读的 Markdown 结构,含任务名、创建时间、状态、任务概览、发现、工具记录与检查点等。
- 关于许可、价格或外部平台集成的更多信息,资料暂未提供。