SuperAPI AI 工具集

extract-agent-sessions

智能体与模型

查看项目

更新于 10-16 05:45

技能介绍

用途:该技能作为本地智能体会话存储的“地图与决策指南”,用于恢复、导出或总结近期的人类与助手对话,默认排除工具调用、推理、系统注入等非对话内容。它不是稳定的解析器:本地会话布局均视为未版本化的实现细节,需先检查当前存在的文件,再按观察到的结构临时组合 shell 命令,遇到模糊结构应失败关闭,不要创建或安装持久的提取脚本。

主要能力与输出模式:可选 Inventory(默认发现模式,列出别名、存储族、UTC 活动时间、记录可用性、状态与警告)、Private full(按顺序保留每条持久化的人类消息与可见助手文本块,仅限所有者,不宣称已脱敏)、Shareable summary(去掉路径、稳定 ID、附件引用、秘密和不必要逐字文本,只保留主题与结果)。所有会话日志视为敏感数据,发现保持本地,未经用户明确要求不上传;候选以临时别名(如 S1、S2)列出,默认不显示提示预览、项目名、工作目录、完整 ID 或绝对路径;仅在确定范围或用户选定别名后读取消息正文,向外部服务或他人发送前需披露并获确认。

使用方式:先冻结一个 UTC 窗口(如“最近两天”按滚动 48 小时解释),用历史或可见消息时间戳判断讨论新旧,mtime 仅用于检测活跃写入。从小索引发现候选,保留窗口内每个会话 ID 的最新条目;历史只是发现索引,不是规范对话文本。证明根身份时,路径约束在批准的数据根内,拒绝符号链接和不安全 ID;树形存储只接受根级项目记录,排除子代理;关系型存储以 parent 为 NULL 为根,递归排除子代理,fork 会话视为独立根并报告可能重复。不读内容的模式指纹只投影键名、列名、值类型、枚举和计数;缺少必需字段或组合未知时停止提取并报告结构漂移。提取时仅恢复选定可见时间线,树形需重建活动 UUID 路径并兼顾物理与逻辑父链接;关系型连接 message 与 part,按存储顺序只保留允许列表中的可见文本部分,尊重 revert 标记,只读规范表而不读凭据表与事件日志。模型上下文最小化:先看计数,摘要仅加载选定人类消息和已完成轮次的最终答案;完整过滤时间线只留在磁盘上供 Private full 使用。

限制:当前版本仅支持 Linux 与 macOS 主机,WSL 需将 Linux 发行版视为独立环境且仅当客户端在其中运行时检查,原生 Windows 会话存储不在支持范围。JSONL 族需要 jq 等流式 JSON 工具,关系型族需要只读 SQLite 客户端(Node 22+ 的 node:sqlite 或以 mode=ro URI 打开的 sqlite3)。绝不检查认证文件、凭据存储、环境快照、shell 历史、调试日志、遥测、崩溃转储、剪贴板或浏览器存储;临时私有中间产物只写入受限临时目录,正常退出或中断时移除,除非用户明确要求导出。报告需包含别名、精确 UTC 窗口、根会话数、仅命令排除项、子代理排除、状态、结构警告、分支/压缩歧义及缺失的外部化内容。