用途:把 Design Agent 的一份 fork 或克隆同步到上游仓库的最新状态,在更新代码的同时保留团队自己的品牌素材、授权字体、环境配置、技能与指令编辑,并重新构建受影响的部分。
主要能力:
- 保护不被 Git 跟踪的本地资产:品牌包(workspace/brand/)、授权字体(private-fonts/)和 .env 文件不会因更新被改动。
- 处理团队技能与指令编辑可能与上游产生的冲突。
- 更新后执行依赖同步、健康检查、测试与技能校验。
- 在沙箱配置发生变化时重建并测试沙箱;对 Managed Deep Agents 还需发布沙箱快照。
- 支持先在测试副本上验证,再部署团队智能体。
使用方式:
- 先运行 git status 查看状态;提交本地工作或先询问,不要直接使用裸 git stash。
- 一次性添加上游远程:git remote add upstream https://github.com/langchain-ai/design-agent.git。
- 运行 git fetch upstream,并阅读 CHANGELOG.md 中新增条目以了解破坏性变更。
- 将 upstream/main 合并到用户分支;发生冲突时,保留团队的技能与指令编辑,采用上游的代码;若冲突同时涉及两者,先询问。
- 依次执行:uv sync、uv run design-agent doctor、uv run pytest -q、uv run design-agent skills verify。
- 若 sandbox/setup.sh 有变化:执行 uv run design-agent sandbox build 与 uv run design-agent sandbox test;对于 Managed Deep Agents,还需执行 uv run design-agent sandbox publish(快照名称跟随配方哈希)。
- 先在测试副本上试用更新(uv run mda deploy --name design-agent-test),确认后再部署团队智能体(design-agent-deploy)。
适用场景:团队维护 Design Agent 的定制分支,需要定期吸收上游代码更新,但又不希望丢失品牌定制、字体授权文件和自定义技能。
限制:资料未提供自动化冲突解决机制;涉及技能与指令和上游代码同时冲突的情况需人工判断。具体部署与发布细节、快照命名以外的高级配置暂未提供。