CocoWisdom 的 wisdom-index 技能用于对磁盘上已有的会话 JSONL 转录文件构建或刷新本地词法索引,使这些会话内容可以被本地检索。该技能通过命令 $wisdom index [--harness <harness-name>] 实现。
用途:在 .cocoplus/lifecycle/wisdom-index/ 下建立可搜索的本地索引,索引对象为已存在的会话 JSONL 转录。该过程是追溯性的:首次运行会索引所有可用会话,包括 CocoWisdom 之前产生的会话。
主要能力:
- 读取 cocoplus.toml 中 [wisdom] 配置(若存在),遵循 session_index_enabled、session_index_path 和 redact_credentials_at_index。
- 默认以 .cocoplus/lifecycle/sessions/ 作为会话来源。
- 支持 --harness 参数,只索引匹配指定 harness 的会话。
- 在 redact_credentials_at_index 未被显式设为 false 时,存储索引文本前对凭证模式进行脱敏,包括 API 令牌、bearer 令牌、密码/密钥材料、Snowflake 连接字符串,以及与凭证相邻的角色、仓库或账户名称。
- 保持原始 JSONL 转录不变。
- 写出索引元数据,包括会话数、脱敏数、索引时间戳和 harness 过滤条件。
使用方式:执行 $wisdom index 或 $wisdom index --harness <harness-name>。运行前需确认 .cocoplus/ 存在;若不存在,输出“CocoPlus is not initialized. Run $pod init first.”并停止。
适用场景:需要对本地已有会话转录建立可搜索索引、追溯索引历史会话、或按 harness 限定索引范围时使用。
限制与约束:索引必须位于 .cocoplus/lifecycle/wisdom-index/;原始转录不得修改;索引内容需经凭证脱敏;重复运行应确定性地更新索引。该技能不提供检索界面、索引格式细节或性能指标,这些信息暂未提供。