用途:ccc 是 CocoIndex Code 的 CLI,为当前代码库提供语义搜索和索引管理,用于在编码任务中查找概念、功能或行为相关代码。
主要能力:语义搜索(ccc search <query terms>);索引管理(ccc index、ccc search --refresh);按语言过滤(--lang,可重复);按路径过滤(--path,相对于项目根的 glob,省略时默认当前工作目录);分页(--offset、--limit)。查询应描述概念或功能,而非精确代码语法。搜索结果包含文件路径和行范围,可用编辑器读取文件或 sed -n '<start>,<end>p' <file> 查看上下文。
使用方式:智能体负责当前项目的 ccc 生命周期,自动完成初始化、索引和搜索,不要求用户执行。若 ccc search 或 ccc index 报初始化错误(如 Not in an initialized project directory),在项目根目录运行 ccc init,再 ccc index 建索引,然后重试原命令。若索引可能过期(会话开始、大量代码变更、新增文件、重构或模块重命名后),运行 ccc index 或 ccc search --refresh;连续搜索之间未改代码则无需重建。若找不到 ccc 命令,需参考 management.md 的安装说明并告知用户。设置、安装、初始化、守护进程、排查与清理命令见 settings.md 和 management.md。
例外与限制:若 ccc index 因目录是 ccc 用户设置目录(通常是主目录)而拒绝,不要在该目录运行 ccc init,应进入项目内运行或询问用户使用哪个项目;若 ccc note 提示当前使用的项目就是该目录(其下仓库没有自己的项目),应告知用户,不要自行运行 ccc reset,是否保留为项目由用户决定。资料未提供具体安装命令、平台支持、性能指标或收费信息。