shell-history

Shell History 搜索

当用户想从 shell 历史记录中查找内容时，使用 atuin，添加时间戳并通过 grep 过滤。

标准调用

atuin search --after "<N> days ago" --format "{time} {command}"

<N> 默认为 1。

如果用户指定了天数，则使用指定的数字。指定天数的示例：

• “搜索最近 2 天的 shell 历史记录”
• “查看 3 天的历史记录”
• “最近两天”

这会返回过去 N 天的所有 shell 命令，每条命令前面都带有时间戳。

按关键词过滤

然后使用 grep 搜索相关词语（URL、工具名称、标志等）。

每条命令都要单独作为一次 Bash 调用运行，绝不要在单次调用中通过管道串联命令。

步骤 1：将历史记录保存到作业目录中的临时文件（如果有该目录），否则写入 /tmp 下一个唯一命名的文件。

步骤 2：对该文件使用 grep 搜索关键词。

扩大搜索时间范围

如果使用默认的 1 天范围没有找到有用内容，则逐步扩大范围：依次尝试 2 天、3 天，依此类推，最多搜索 7 天；之后再放弃或向用户询问更多背景信息。

每次都要说明搜索的时间范围，让用户知道你查到了多久之前。

何时使用此技能

• 用户说“检查我的 shell 历史记录”“查看我的历史记录”“查找我运行过的那个命令”
• 用户想找通过 curl/wget 访问过的 URL，或最近运行过的工具
• 用户询问过去某条命令使用过哪些标志或参数