Skip to content

支持多 git 仓库容器目录、灵活选择索引范围与渐进式建立索引 #54

Description

@Cui-xf

背景 / Background

我的使用场景是后端微服务架构:在一个工作目录(如 /work)下存在多个子项目,每个子项目是一个独立的 git root,而 /work 目录本身不是 git root。开发一个需求时,我通常在 /work 下启动 AI Agent,修改代码会涉及多个项目(微服务)联动。

Reading the README, AOCI-CODE 的索引范围目前强依赖 Git:scan takes its file inventory from Git,并以单个 repository 为治理单位(aoci --repo /absolute/path/to/repository)。这与「多 git root 容器目录 + 跨项目联动开发」的场景适配度不足,主要遇到以下三个问题。

问题一:包含多个 git 仓库的目录无法建立索引

/work 本身不是 git root,无法对其执行 scan(取不到 Git 文件清单);而若分别在每个子项目内各自 init/scan,会得到多份相互独立的 Whole-Index,无法表达「跨微服务的整体系统认知」——而这正是多项目联动开发时最需要的。

期望:支持以「容器目录」为治理根,把其下多个独立 git 仓库纳入同一份 Whole-Index(multi-repo / workspace 级别的索引),同时保留各子项目的 git 边界。

问题二:不能灵活指定只对某些项目/文件建立索引(强依赖 .gitignore)

当前 Managed Scope 主要靠 .gitignore 做排除式控制(README 也强调不要把 aoci 资产加入 .gitignore,否则被静默跳过),缺少正向、显式的「只索引这些项目/这些文件/这些路径」的 include 机制。

期望:提供正向的 scope 配置(include/exclude 路径、项目、glob),能显式声明「只对哪些子项目/哪些目录/哪类文件建立索引」,而不是只能靠 .gitignore 间接排除。

问题三:希望支持渐进式索引(progressive / incremental indexing)

对已经存在的大型项目,一次性建立全量索引耗时巨大(README 说约 1 小时 / 20 万行,且要消耗大量 token)。我希望初期可以只指定少量代码建立索引,在后续需求开发迭代过程中持续增加索引范围,最终渐进式达到全量索引。

现有的 scan 是「一次性建立 Managed Baseline」,--force 也不能作为重新定义治理事实的捷径(README 明确说明)。缺少「从一个小子集起步、随开发逐步扩面」的渐进式建索引路径。

期望:支持渐进式建索引——初始只索引少量指定文件/模块,后续随迭代持续追加范围,直至覆盖全量代码;中间各阶段都保持可用且 aligned 的认知。

当前最佳实践与场景不适配

综上,AOCI-CODE 当前的最佳实践更面向「单一 git 仓库、一次性全量认知」的形态,而我的场景是「多 git root 容器目录 + 跨项目联动 + 已有大型存量代码渐进式接入」,三者目前都缺少顺畅的路径。

希望 aoci-code 能考虑上述场景的支持。感谢!

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions