在终端中搜索 Contextify 历史记录

各平台的安装方式

验证 CLI

contextify --version
contextify status
contextify doctor

status 检查数据库。doctor 检查 CLI 和技能的安装情况。如果 doctor 报告缺少技能，请运行：

contextify install-plugin
contextify doctor

旧命令名 contextify-query 仍然可用，但文档和教程中应使用 contextify。

在 Linux 上，搜索前先用 contextify ingest 为对话记录建立索引。需要定期在后台导入时，使用 contextify install-service。

运行第一次本地搜索

先用某个 AI 会话中有辨识度的短语、任务 ID、分支名、文件路径或错误信息来搜索。

contextify search "sign-in handoff" --limit 5
contextify search "ct 1703" --days 30
contextify search "cloud sync" --project . --limit 10

搜索会对带连字符的标识符分词。如果 ct-1703 的匹配结果不符合预期，试试 "ct 1703"，或者同一对话中的相邻词语。

搜索只能看到已在本地建立索引的历史记录。如果找不到最新的对话，请先运行导入，或者等已安装的应用处理完成。

通过 CLI 连接 Cloud

配置托管版 Cloud 时，默认会转入登录流程：

contextify cloud setup
contextify cloud status
contextify cloud sync

配置自托管服务器时，尽量使用交互式提示输入，这样 API 密钥不会留在 shell 历史记录中。

contextify cloud setup --url https://your-server.example.com
contextify cloud projects
contextify cloud projects --exclude my-private-project
contextify cloud sync

cloud projects --exclude 会更改这台 Mac 的“Project Sync”（项目同步）设置。项目被排除后，这台设备以后不会再上传该项目的数据。

无界面自动化场景支持 --key。如果命令记录中含有真实密钥，请把这份记录当作敏感信息处理。

contextify cloud setup --url https://your-server.example.com --key ctx_REDACTED --no-input

相关文档