用途:当用户询问开源仓库、GitHub/GitLab 链接、owner/repo、包名或相关关键词时,Replicant 用本地克隆的外部仓库源码作为回答依据,强调以真实实现而非 README 声明、过时文档或网页片段为准。
主要能力:按 <clone_root>/<host>/<owner>/<repo> 的布局保存克隆,clone_root 以配置块为准;支持从显式 URL、owner/repo、包名、关键词提取仓库线索并归一化为 host/owner/repo;先查本地清单与克隆目录,精确 owner/repo 优先于子串匹配;本地无匹配时再经网页/代码搜索解析并映射到克隆路径;缺失时按配置的传输方式与深度克隆,明显过大的仓库会先询问;已存在则按配置策略更新。使用前记录 git rev-parse HEAD 与 git status --porcelain,回答时给出提交 SHA、文件路径与行号范围作为证据。
使用方式:先读取 REPLICANT_CONFIG 配置块;若其中 configured: false,需先运行首次设置。首次设置必须显式进行,逐项向用户说明可配置选项后再写入配置,可推荐默认值但需用户明确选择或确认,不得静默采用默认值。参考文档包含工作流配方(克隆、更新、搜索、解析、回答命令)与设置参考(首次运行提示、策略定义、配置格式、回退路径)。
限制:外部克隆默认只读,除非明确要求,不得 commit、push、建分支、reset、git clean 或删除克隆内容;保留本地修改,不自动更新有改动的克隆;除非回答必需,不安装依赖或运行构建/测试。具体配置项、传输方式、深度与更新策略细节暂未提供。