尧图网站建设 
Reflex Build 生成控制与协作指南排队指令、实时进度跟踪与编辑锁机制【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflexReflex Build 是 Reflex 平台内的 AI 应用构建器它允许你在 Agent 持续生成应用代码的同时继续对话、实时查看进度并与队友在同一应用上安全协作。本篇指南基于 generation_controls.md 展开系统讲解「排队后续指令」「跟踪生成进度」「处理并发编辑与编辑锁」三大核心机制并补充角色权限与配套工作流帮助你在多页应用、多成员协作场景下既保持引导精度又不互相覆盖彼此的改动。排队后续指令在生成进行中持续引导 AgentReflex Build 的一个核心交互特点是你不必等当前一次生成完全结束就可以补充上下文。当 Agent 正在工作时你继续发送一条消息这条消息会被排入队列Agent 会在它的下一个处理步骤中自动拾取并执行。Keep the current desktop layout. Make the new table responsive below 768 px and do not change the existing filters.以上面的示例为例这是一个典型的「排队消息」——它给出的是小范围修正或缺失约束保持桌面布局、表格在 768px 以下响应式、不要改动现有筛选器而不是推倒重来的全新需求。这类指令最适合以队列方式发送。排队的使用原则适合排队的内容小修正、补充约束、明确「哪些不能动」。它们不改变整体方向Agent 可以在当前步骤完成后顺次执行。避免排队多个互相竞争的变更如果几条指令彼此矛盾Agent 会难以取舍最终结果反而偏离你的预期。方向性的大变更要合并发送如果需求方向已经发生实质变化正确做法是先让当前步骤执行完查看生成结果然后发送一条整合后的后续指令。这样 Agent 能把最新指令与已在进行的改动对齐而不是在同一份代码上同时执行两个版本的意图。从实现角度看这条机制保证了「提示词 → 生成」的串行一致性Reflex Build 把每次 Agent 消息视为一个可追溯的工作单元每个改变应用的 Agent 消息都会创建检查点详见 Restore Checkpoint排队指令在下一个步骤被消费天然避免了两条指令在同一步内交错执行导致的冲突。跟踪生成进度解读工作区的实时活动生成运行期间工作区会持续展示 Agent 的当前活动让你随时知道它「正在做什么」。可观察到的活动类型包括活动类型含义规划planningAgent 正在把大需求拆解为分步实现计划可通过 Planning 的 Plan 视图查看和调整Web 搜索web searchesAgent 正在检索当前信息、包文档或外部实现细节工作区会显示它使用的搜索查询工作区操作workspace operationsAgent 正在读写、比较或组织生成的应用文件测试testsAgent 正在运行或生成测试验证改动行为生成截图generated screenshotsAgent 产出运行截图截图会标注它对应的页面路由最后一点对多页面应用尤其重要由于截图带有页面路由信息你可以准确区分「哪张截图属于哪个页面」而不是在一堆缩略图里靠猜。这也印证了 Agent 工具链中的能力——Reflex Build 的 Agent 可以在构建过程中执行 Web 搜索、运行 Python用于校验脚本、转换数据、复现错误、跑测试等并生成图片资源这些活动都会如实呈现在生成进度中详见 Agent Tools。生成期间如何继续工作生成进行中你可以继续浏览Preview预览和Plan计划视图两者互不冲突Plan 不会因切换视图而丢失。在发送下一个宽泛的大请求之前先检查一下最新的生成结果——避免你在不了解现状的情况下发出指令不小心反向覆盖掉一个有用的改动。如果要在生成过程中修改计划务必同时在聊天中把该变更说清楚这样 Agent 才能将最新指令与已经在进行的工作对齐见 Planning 的「Move Between Plan and Implementation」。与队友安全协作编辑锁、并发规避与权限边界多人协作是 Reflex Build 面向团队场景的核心能力其安全模型建立在两个机制之上编辑锁edit lock与项目角色project roles。编辑锁机制当一个应用正在另一个会话中被编辑时Reflex Build 会锁定该应用防止发生重叠编辑overlapping edits。这意味着你不能在同一时间从两个会话对同一应用发起互相冲突的生成。正确做法是等待当前这次生成结束、编辑锁清除之后再在另一个会话中开始工作。这与你手动编辑文件时的行为一致——Code Workspace 中同样强调「等待当前生成完成再手动编辑」「不要同时在两处编辑同一批文件」如果生成还在进行即使你只是想通过 Code 视图做一次精确的手工修改也需要先等它结束。开始大型生成前的四项检查在开始一次大规模生成之前建议按以下顺序确认原文四项检查检查是否有人正在编辑受影响区域——先看编辑锁状态与队友活动。将请求范围限定在清晰的工作流内——不要把互不相关的改动塞进同一次生成。明确说明哪些内容必须保持不变——像排队指令示例那样显式声明约束如「不要修改现有筛选器」。在开始另一次重叠生成之前先审查最新预览和测试结果——确认前一次改动符合预期再继续推进。这四项检查本质上是在「并发修改」之前建立一次同步点先看别人在改什么 → 划定自己的边界 → 声明保护范围 → 以最新状态为基线开工。项目角色谁能打开、编辑和管理应用能否对一个应用执行打开、编辑、管理操作由项目角色Project Roles决定。Reflex 在项目级别提供三个内置角色另有自定义角色Custom Roles用于内置角色无法覆盖的场景详见 Roles Permissions角色核心权限边界Viewer查看者只读。可以查看项目及其应用与活动但不能编辑、部署或查看 Secret 值Editor编辑者创建和编辑应用、在 Build 中工作、管理应用 Secret可以看到 Secret 存在名称但不能查看其值Admin管理员项目的完全控制权包括成员、角色、集成、Secret、审批策略与删除除直接分配外项目角色还可以通过团队Teams继承给组内成员组织管理员Organization Admin会自动成为每个项目的 Admin。当内置角色「差一点但又不完全合适」时文档明确建议创建自定义项目角色而不是过度授予 Admin 权限。此外还有一层组织角色Member / Manager / Admin控制的是创建项目、管理计费、查看审计日志等组织级能力与项目角色分别独立授予。一句话总结权限模型组织角色管「组织运营」项目角色管「项目内干活」二者分开分配、互不影响。配套能力让生成控制形成完整闭环「生成控制」不是孤立的它与 Reflex Build 的其他工作流共同构成一个闭环。以下能力在协作场景中值得联动使用PlanningPlan 视图把大提示词转成可审查的实现计划。生成前可通过Plan firstAuto / Always / Never控制是否先规划生成中可调整计划Agent 会拾取最新改动。涉及多页面、多集成或跨系统的工作建议先规划小改动则通常不需要。Code and ReviewReview 模式把画在预览图上的标注转换为发给 Agent 的提示词发送 Review 需要编辑权限若其他会话正在生成或持有编辑锁需等待Code 模式用于检查源码、查看 diff 或做精确的小幅手动修改。注意发送 Review 同样受编辑锁约束——如果另一个会话正在生成或持有应用的编辑锁需要等它结束。Code Workspace可以浏览、搜索、比较和编辑生成的文件支持文件锁Lock——当你需要 Agent 在后续生成中保留你的手动实现时可以锁定该文件Agent 会跳过被锁文件直到解锁。手动编辑要求付费方案 编辑权限且务必先等当前生成结束。Restore Checkpoint每次改变应用的 Agent 消息都会创建检查点可一键将应用源码恢复到某个较早状态。配合编辑锁你可以在协作中随时回退到「上一个可靠版本」。Testing用自然语言描述行为即可生成并运行单元测试或浏览器测试用于在分享和部署前验证关键行为。生成结束时关注测试结果是「发送下一个大请求前先审查最新结果」的重要组成部分。这些机制共同回答了协作中的三个基本问题改什么Plan 与排队指令、改得对不对进度、截图、测试、Review、改坏了怎么办检查点恢复。实践要点速览小修正用排队Agent 工作时直接发消息指令会在下一步骤被消费避免同时排队多个冲突指令。大变更先等完成方向变了就先让当前步骤结束review 结果后发一条整合指令。盯进度看路由生成截图带有页面路由标注多页面应用据此分辨结果归属。生成中可继续看 Preview / Plan但发大请求前先确认最新结果别反向覆盖有用改动。尊重编辑锁他人会话生成中应用会被锁定等锁清除再开工。大生成前过四关查他人是否在改 → 限定范围 → 声明不可变项 → 审查最新预览与测试。权限按角色给项目内 Editor 负责构建、Admin 管项目、Viewer 只读不匹配时用自定义角色避免过度授权。通过排队指令、进度跟踪与编辑锁三者的配合Reflex Build 让「多成员并行推进一个应用」从互相踩踏变为可预期的协作流程——这正是生成控制模块的设计核心。相关文档Generation Controls Collaboration原始文档Planning — 生成前/生成中审查和调整工作计划Code and Review — 检查源码改动或发送带标注的视觉反馈Code Workspace — 浏览、比较、锁定或编辑生成的文件Restore Checkpoint — 将应用恢复到较早的生成状态Testing — 验证生成后的行为Agent Tools — Web 搜索、运行 Python 与生成图片的 Agent 工具链Roles Permissions — 组织与项目两级角色体系【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Reflex Build 生成控制与协作指南：排队指令、实时进度跟踪与编辑锁机制
Reflex Build 生成控制与协作指南排队指令、实时进度跟踪与编辑锁机制【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflexReflex Build 是 Reflex 平台内的 AI 应用构建器它允许你在 Agent 持续生成应用代码的同时继续对话、实时查看进度并与队友在同一应用上安全协作。本篇指南基于 generation_controls.md 展开系统讲解「排队后续指令」「跟踪生成进度」「处理并发编辑与编辑锁」三大核心机制并补充角色权限与配套工作流帮助你在多页应用、多成员协作场景下既保持引导精度又不互相覆盖彼此的改动。排队后续指令在生成进行中持续引导 AgentReflex Build 的一个核心交互特点是你不必等当前一次生成完全结束就可以补充上下文。当 Agent 正在工作时你继续发送一条消息这条消息会被排入队列Agent 会在它的下一个处理步骤中自动拾取并执行。Keep the current desktop layout. Make the new table responsive below 768 px and do not change the existing filters.以上面的示例为例这是一个典型的「排队消息」——它给出的是小范围修正或缺失约束保持桌面布局、表格在 768px 以下响应式、不要改动现有筛选器而不是推倒重来的全新需求。这类指令最适合以队列方式发送。排队的使用原则适合排队的内容小修正、补充约束、明确「哪些不能动」。它们不改变整体方向Agent 可以在当前步骤完成后顺次执行。避免排队多个互相竞争的变更如果几条指令彼此矛盾Agent 会难以取舍最终结果反而偏离你的预期。方向性的大变更要合并发送如果需求方向已经发生实质变化正确做法是先让当前步骤执行完查看生成结果然后发送一条整合后的后续指令。这样 Agent 能把最新指令与已在进行的改动对齐而不是在同一份代码上同时执行两个版本的意图。从实现角度看这条机制保证了「提示词 → 生成」的串行一致性Reflex Build 把每次 Agent 消息视为一个可追溯的工作单元每个改变应用的 Agent 消息都会创建检查点详见 Restore Checkpoint排队指令在下一个步骤被消费天然避免了两条指令在同一步内交错执行导致的冲突。跟踪生成进度解读工作区的实时活动生成运行期间工作区会持续展示 Agent 的当前活动让你随时知道它「正在做什么」。可观察到的活动类型包括活动类型含义规划planningAgent 正在把大需求拆解为分步实现计划可通过 Planning 的 Plan 视图查看和调整Web 搜索web searchesAgent 正在检索当前信息、包文档或外部实现细节工作区会显示它使用的搜索查询工作区操作workspace operationsAgent 正在读写、比较或组织生成的应用文件测试testsAgent 正在运行或生成测试验证改动行为生成截图generated screenshotsAgent 产出运行截图截图会标注它对应的页面路由最后一点对多页面应用尤其重要由于截图带有页面路由信息你可以准确区分「哪张截图属于哪个页面」而不是在一堆缩略图里靠猜。这也印证了 Agent 工具链中的能力——Reflex Build 的 Agent 可以在构建过程中执行 Web 搜索、运行 Python用于校验脚本、转换数据、复现错误、跑测试等并生成图片资源这些活动都会如实呈现在生成进度中详见 Agent Tools。生成期间如何继续工作生成进行中你可以继续浏览Preview预览和Plan计划视图两者互不冲突Plan 不会因切换视图而丢失。在发送下一个宽泛的大请求之前先检查一下最新的生成结果——避免你在不了解现状的情况下发出指令不小心反向覆盖掉一个有用的改动。如果要在生成过程中修改计划务必同时在聊天中把该变更说清楚这样 Agent 才能将最新指令与已经在进行的工作对齐见 Planning 的「Move Between Plan and Implementation」。与队友安全协作编辑锁、并发规避与权限边界多人协作是 Reflex Build 面向团队场景的核心能力其安全模型建立在两个机制之上编辑锁edit lock与项目角色project roles。编辑锁机制当一个应用正在另一个会话中被编辑时Reflex Build 会锁定该应用防止发生重叠编辑overlapping edits。这意味着你不能在同一时间从两个会话对同一应用发起互相冲突的生成。正确做法是等待当前这次生成结束、编辑锁清除之后再在另一个会话中开始工作。这与你手动编辑文件时的行为一致——Code Workspace 中同样强调「等待当前生成完成再手动编辑」「不要同时在两处编辑同一批文件」如果生成还在进行即使你只是想通过 Code 视图做一次精确的手工修改也需要先等它结束。开始大型生成前的四项检查在开始一次大规模生成之前建议按以下顺序确认原文四项检查检查是否有人正在编辑受影响区域——先看编辑锁状态与队友活动。将请求范围限定在清晰的工作流内——不要把互不相关的改动塞进同一次生成。明确说明哪些内容必须保持不变——像排队指令示例那样显式声明约束如「不要修改现有筛选器」。在开始另一次重叠生成之前先审查最新预览和测试结果——确认前一次改动符合预期再继续推进。这四项检查本质上是在「并发修改」之前建立一次同步点先看别人在改什么 → 划定自己的边界 → 声明保护范围 → 以最新状态为基线开工。项目角色谁能打开、编辑和管理应用能否对一个应用执行打开、编辑、管理操作由项目角色Project Roles决定。Reflex 在项目级别提供三个内置角色另有自定义角色Custom Roles用于内置角色无法覆盖的场景详见 Roles Permissions角色核心权限边界Viewer查看者只读。可以查看项目及其应用与活动但不能编辑、部署或查看 Secret 值Editor编辑者创建和编辑应用、在 Build 中工作、管理应用 Secret可以看到 Secret 存在名称但不能查看其值Admin管理员项目的完全控制权包括成员、角色、集成、Secret、审批策略与删除除直接分配外项目角色还可以通过团队Teams继承给组内成员组织管理员Organization Admin会自动成为每个项目的 Admin。当内置角色「差一点但又不完全合适」时文档明确建议创建自定义项目角色而不是过度授予 Admin 权限。此外还有一层组织角色Member / Manager / Admin控制的是创建项目、管理计费、查看审计日志等组织级能力与项目角色分别独立授予。一句话总结权限模型组织角色管「组织运营」项目角色管「项目内干活」二者分开分配、互不影响。配套能力让生成控制形成完整闭环「生成控制」不是孤立的它与 Reflex Build 的其他工作流共同构成一个闭环。以下能力在协作场景中值得联动使用PlanningPlan 视图把大提示词转成可审查的实现计划。生成前可通过Plan firstAuto / Always / Never控制是否先规划生成中可调整计划Agent 会拾取最新改动。涉及多页面、多集成或跨系统的工作建议先规划小改动则通常不需要。Code and ReviewReview 模式把画在预览图上的标注转换为发给 Agent 的提示词发送 Review 需要编辑权限若其他会话正在生成或持有编辑锁需等待Code 模式用于检查源码、查看 diff 或做精确的小幅手动修改。注意发送 Review 同样受编辑锁约束——如果另一个会话正在生成或持有应用的编辑锁需要等它结束。Code Workspace可以浏览、搜索、比较和编辑生成的文件支持文件锁Lock——当你需要 Agent 在后续生成中保留你的手动实现时可以锁定该文件Agent 会跳过被锁文件直到解锁。手动编辑要求付费方案 编辑权限且务必先等当前生成结束。Restore Checkpoint每次改变应用的 Agent 消息都会创建检查点可一键将应用源码恢复到某个较早状态。配合编辑锁你可以在协作中随时回退到「上一个可靠版本」。Testing用自然语言描述行为即可生成并运行单元测试或浏览器测试用于在分享和部署前验证关键行为。生成结束时关注测试结果是「发送下一个大请求前先审查最新结果」的重要组成部分。这些机制共同回答了协作中的三个基本问题改什么Plan 与排队指令、改得对不对进度、截图、测试、Review、改坏了怎么办检查点恢复。实践要点速览小修正用排队Agent 工作时直接发消息指令会在下一步骤被消费避免同时排队多个冲突指令。大变更先等完成方向变了就先让当前步骤结束review 结果后发一条整合指令。盯进度看路由生成截图带有页面路由标注多页面应用据此分辨结果归属。生成中可继续看 Preview / Plan但发大请求前先确认最新结果别反向覆盖有用改动。尊重编辑锁他人会话生成中应用会被锁定等锁清除再开工。大生成前过四关查他人是否在改 → 限定范围 → 声明不可变项 → 审查最新预览与测试。权限按角色给项目内 Editor 负责构建、Admin 管项目、Viewer 只读不匹配时用自定义角色避免过度授权。通过排队指令、进度跟踪与编辑锁三者的配合Reflex Build 让「多成员并行推进一个应用」从互相踩踏变为可预期的协作流程——这正是生成控制模块的设计核心。相关文档Generation Controls Collaboration原始文档Planning — 生成前/生成中审查和调整工作计划Code and Review — 检查源码改动或发送带标注的视觉反馈Code Workspace — 浏览、比较、锁定或编辑生成的文件Restore Checkpoint — 将应用恢复到较早的生成状态Testing — 验证生成后的行为Agent Tools — Web 搜索、运行 Python 与生成图片的 Agent 工具链Roles Permissions — 组织与项目两级角色体系【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考