# 本地Git与持续提交 本产品独立仓库:`D:/Ai-project/REA逆向/Agent-Workbench`。分支:`main`。基线提交:`bac87da`;标签:`v1.0.0-baseline`。Git仅覆盖本产品;其他目录中的研究目标和其他项目保持独立。 ## 作者与远端 当前未配置全局Git作者。本仓库使用项目开发身份`Agent Workbench Dev `,只设置仓库本地配置;该邮箱是本地占位身份。用户可随时替换为自己的提交署名。全局Git配置保持原状,当前未设置远端。 本地提交用于保存进展和检查点,不等于异地备份;远端仓库/推送以后按用户明确指令配置。 ## 每次开发的小步流程 1. 读取目标与当前Git状态,明确本次文件和验收。 2. 做一个能独立解释、验证和回滚的改动。 3. 做相关检查:文档用diff/链接/JSON检查;代码运行适当构建与行为验证;界面或异常恢复改动另做相关场景。 4. 查看diff,确认文件范围、研究引用与验收结果。 5. 只暂存本次范围的文件并本地提交;未完成实验以明确名称保存在实验分支或检查点中。 6. 输出提交ID、结果和剩余工作。没有文件变化的只读研究不制造空提交。 ```powershell git status --short git diff --check git diff --stat git add -- docs/PRODUCT-PLAN.md docs/CAPABILITIES.md git diff --cached --check git commit -m 'docs: refine verified capability plan' ``` 代码的相关检查按修改范围执行,例如: ```powershell npm.cmd run build npm.cmd test ``` UI和模型fixture验证用独立数据/服务,沿用已有验证器的演示/无Key要求。不得为本地提交重启当前仅在内存中保存Key的正式服务。 ## 实验与用户工程 工作台自身的代码开发和产品内置用户工程Git是两个层面。内置Git能力将包括仓库识别、dirty状态、基线、独立任务worktree、diff、审查后合并/提交和交付引用。 需要独立实验时,先记录当前基线,再创建具体任务分支/worktree。合并前检查结果与冲突,保留原工作区已有改动。恢复不能使用破坏性reset/clean来替代状态核对。 ## 归档规则 源码、契约、测试、自有兼容fixture、小型来源索引和验证文档入Git。node_modules、构建目录、.qa、releases、.env/Key文件、运行数据和大体积原始工件由.gitignore排除。旧版自有fixture保留原字节,支持独立升级测试。 研究目标的版本、hash、来源和许可声明可以保存为登记记录;第三方完整发行包/个人会话/登录信息不混入本产品代码仓库。