## 背景 当前 SAGE 体系在该仓库存在边界职责不够清晰的风险,需要执行一次“无兼容层优先”的深度梳理。 - Repository: `sage-amms` - Layer: `L3-cpp` - Heavy deps signal: `torch` ## 目标 1. 明确该仓库在分层架构中的唯一职责(做什么 / 不做什么)。 2. 移除或下沉越层实现,避免 L 层反向依赖。 3. 删除不必要兼容层(re-export/fallback/shim),直接改调用方。 4. 依赖最小化:只保留当前层真实运行所需依赖。 ## Phase 1 可执行任务(manageable) - [ ] 产出边界清单:in-scope / out-of-scope / forbidden imports - [ ] 盘点跨层调用与动态导入点(含 CLI、tests、scripts) - [ ] 标记兼容层并给出移除顺序与受影响调用方 - [ ] 依赖审计:pyproject.toml 与运行时 import 一致性 - [ ] 拆分为 3~6 个子改造 PR(每个 PR 可独立回归) ## 非目标 - 不在本 issue 内一次性重写全部功能;仅完成边界梳理、拆分计划与第一批落地改造。 ## 验收标准 - [ ] 有书面边界定义(README/ARCHITECTURE/DEVELOPER 文档之一) - [ ] 删除至少 1 个不必要兼容层或越层路径 - [ ] 依赖清单有删减或明确保留理由 - [ ] 测试与 lint 全绿(按本仓库既有门禁) - [ ] 新增后续子 issue/PR checklist 并可追踪 ## 约束 - Flownet-first(不新增 ray) - 不创建 .venv/venv - fail-fast,禁止静默 fallback - 避免新增过渡兼容层,优先直接更新调用方
Activity
ShuhaoZhangTony commentedon Mar 1, 2026
回填子任务 #4:
结论:#4 范围内接口/实现边界问题已消除,无新增兼容层。
ShuhaoZhangTony commentedon Mar 1, 2026
子任务 #5 已完成:清理 CUDA/CPU 路径中的兼容分支。
完成项:
验证:
详情见:#5