coding_agent_session_search

环境要求

• 支持 Linux / macOS / Windows（Linux 预编译二进制需 glibc 2.38+）
• 至少 1GB 磁盘空间；源码编译建议 2GB 内存
• 多机检索需可用的 SSH 密钥登录与 ~/.ssh/config 配置
• 可选：Rust 工具链（仅在源码安装或 cargo install 时需要）

安装与启动步骤

1. 1脚本安装 cass

   官方推荐的一键安装脚本，默认装最新 release，带校验和验证；可在末尾加 --version <tag> 固定版本。

   curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/coding_agent_session_search/main/install.sh?$(date +%s)" | bash -s -- --easy-mode --verify

   复制

2. 2Windows 安装

   在 PowerShell 中运行官方 ps1 安装脚本，参数为 -EasyMode -Verify；固定版本用 -Version <tag>。

   & ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Dicklesworthstone/coding_agent_session_search/main/install.ps1"))) -EasyMode -Verify

   复制

3. 3包管理器安装

   备选方式：Homebrew 仅支持 Apple Silicon macOS 与 Linux；Windows 可用 Scoop 桶。

   brew install dicklesworthstone/tap/cass
   scoop bucket add dicklesworthstone https://github.com/Dicklesworthstone/scoop-bucket
   scoop install dicklesworthstone/cass

   复制

4. 4验证安装结果

   自检命令可校验新安装的可执行文件，不会打开配置好的归档或交互界面。

   cass selftest --json

   复制

5. 5配置数据源向导

   交互式向导会扫描 ~/.ssh/config、探测远端会话数据并生成 sources.toml，最后提示你手动执行同步。

   cass sources setup

   复制

6. 6手动编辑配置

   按平台路径手动维护 sources 配置：Linux 为 ~/.config/cass/sources.toml，macOS 在 Application Support/cass 下。

7. 7同步远端会话

   向导不会自动同步，配置完成后自行运行同步命令，把远端代理会话拉到本地索引。

   cass sources sync

   复制

8. 8安装语义模型

   可选步骤：显式请求时从 Hugging Face 下载约 90MB 模型启用语义检索；离线环境用本地目录安装。

   cass models install
   cass models install --from-file /your/path/to/model-dir

   复制

关键配置

如何确认成功

执行 cass selftest --json 无报错即安装成功；随后运行 cass 打开 TUI 能搜到已索引的历史会话。

常见问题

注意事项

• 多机向导支持的远端安装方式按 cargo-binstall、预编译二进制、cargo install、完整 bootstrap 的优先级选择，失败不会自动降级。
• 安装完成后仅得到一个 cass 二进制，没有守护进程或后台服务。
• --json 模式下的 sources setup 会推迟同步，并报告 sync.status = "pending" 及待执行命令。
• 安装脚本默认验证发布产物的校验和，并可从 crates.io 用 cargo install coding-agent-search 安装。