SuperAPI AI 工具集

session-navigation

通用与其它

查看项目

更新于 10-16 05:08

技能介绍

用途:帮助用户在过去的 Droid 会话中定位内容,例如继续上次的工作、查找上周做过的某件事,或了解某个项目近期发生了什么。

会话存放位置:会话位于 ~/.factory/sessions/,按项目文件夹组织,路径中的斜杠会替换为短横线,例如 /Users/me/code/app 对应 -Users-me-code-app。每个会话包含两个文件:对话文件 <uuid>.jsonl,每行一个 JSON 对象,首行为元数据(会话 id、标题、工作目录),其余为用户消息、助手回复和工具调用;设置文件 <uuid>.settings.json,记录模型、运行时长、token 数量和自主模式等统计信息。

主要能力与用法: 列出项目文件夹:ls ~/.factory/sessions/;按部分名称查找:ls ~/.factory/sessions/ | grep "myapp"。 列出某项目近期会话:ls -lt ~/.factory/sessions/-Users-enoreyes-code-work-myapp/;获取近期会话标题可遍历 *.jsonl 并用 head -1 配合 jq -r '.title // "Untitled"'。 按内容搜索:跨全部会话 rg "authentication" ~/.factory/sessions/;限定项目 rg "bug fix" ~/.factory/sessions/-Users-enoreyes-code-work-myapp/;查看上下文 rg -C 2 "login" ~/.factory/sessions/-Users-enoreyes-code-projects-api/;查找哪些项目提到某关键词 rg -l "redis" ~/.factory/sessions/ | cut -d'/' -f1-5 | sort -u。 读取会话:head -1 <uuid>.jsonl | jq . 查看元数据;cat <uuid>.settings.json | jq . 查看统计;wc -l <uuid>.jsonl 查看对话长度。用户消息 role 为 user,助手回复为 assistant,工具调用显示执行的命令和涉及的文件。

适用场景:了解某项目做过什么、查找修复登录 bug 的会话、恢复此前工作(先阅读并总结关键决策再继续)、统计 Droid 使用量(汇总设置文件中的 token 数与活跃时间)。

限制与提示:建议使用 rg(ripgrep)替代 grep,速度更快且更好处理嵌套目录;会话标题不一定准确,有时需阅读对话内容才能判断主题;会话可能包含敏感信息,展示时需谨慎。资料未提供该技能的安装方式、收费或平台支持信息。