企业内部长期存在大量临时性、长尾型的轻量系统需求：部门季度成果汇报页、设备借用登记、活动报名统计、小型数据看板等。这类需求单个业务价值有限但数量庞大，一旦进入「提需求—评估—排期—开发—测试—上线」的正式流程，交付周期往往按周计算，业务方等不起；同时研发资源被长尾需求持续挤占，真正的核心项目反而被拖慢。业务同学自身不具备编码能力，而传统低代码平台仍要求理解组件模型、数据结构与配置逻辑，上手门槛并未真正消除。本项目立项正是为了填补这一供给缺口：让不懂技术的业务人员只需用一句自然语言描述目标，几分钟内即可拿到一个可直接访问的线上链接，把长尾需求的交付周期从「周级」压缩到「分钟级」。此外，考虑到企业对数据与代码的合规要求，项目同步支持完全私有化部署，可脱离外部依赖运行在企业自有环境中。
项目提供从需求描述到应用上线的完整闭环，主要功能模块包括：
对话式应用生成：支持「创意模式」与「应用模式」双模生成，配合场景标签、视觉风格选择器与示例提示词，降低用户表达门槛；创意成果可一键转为正式应用继续迭代。
流式对话与生成过程可视化：基于 SSE 的流式输出，配合 Agent 执行时间线展示生成步骤、文件改动与工具调用，并具备卡死状态自动恢复能力。
沙箱运行与实时预览：为每个应用分配独立的容器化运行环境，支持启停、状态查询与预览地址路由，预览面板提供刷新、新窗口打开、响应式视图等工具能力。
代码查看与导出：在线浏览生成的项目源码结构与文件内容，并支持整包下载，保证产物可接管、可二次开发。
应用广场与模板中心：展示社区优秀作品，支持卡片悬浮快捷操作与「复用创意」二次生成；模板中心提供可复用的应用模板管理。
管理后台：包含数据看板、应用管理、模板管理、会话管理与配额管理，支持运营侧监控与资源治理。
鉴权、配额与响应式适配：基于 OIDC/JWT 的统一登录鉴权、用户级生成配额限制，并完整适配移动端布局。
我负责项目整体架构设计与前后端主体实现，核心投入在 AI Agent 生成链路的设计与稳定性建设。
Agent 架构：以自定义 AgentClient 接口抽象编码 Agent 能力（流式生成、轮次取消、交互回传、上下文清理），默认实现对接 opencode，可平滑替换底层 Agent 与大模型供应商，并支持会话内模型切换。
Agent 具备真实执行能力：Agent 直接运行在每个应用独立的容器沙箱内，拥有文件读写、命令执行、依赖安装与服务启动权限，因此产出的是一个可立即访问的真实工程，而非代码片段；配合依赖预烘焙与轮次快路径优化首字输出与预览就绪速度。
Agent 执行过程可观测：设计统一事件模型 AgentEvent（文本流 / 工具调用 / 沙箱准备 / 错误 / 完成），携带步骤 ID 与运行状态，把 Agent 的推理、工具调用与文件写入归一化为可增量更新的执行时间线，并以技能标签形式呈现，让用户看得懂 Agent 正在做什么。
人机协同中断交互：当 Agent 触发敏感操作权限校验或需要反问用户时，通过交互回传通道把用户的允许/始终允许/拒绝决策或答案送回 Agent，使阻塞轮次继续执行，兼顾自动化与可控性。
难点主要在长轮次稳定性治理：通过事件总线将轮次执行与 SSE 连接解耦，实现异步起轮、断线重连续传与真实事件心跳；并针对孤儿轮次、模型侧挂起、会话状态陈旧、工具事件缺失等异常设计守护与恢复机制，同时解决沙箱空闲回收与活跃轮次的冲突，保障生成过程不中断、不假死。
评论