Project Logic Overview

理解 Downcity 最好先从产品问题开始：AI builders 不应该为每个产品、工作流或客户 Demo 都重复搭一遍 Agent 后端。

核心关系是：

• 产品表层负责用户体验
• Agent 在明确运行边界里执行任务
• City runtime services 负责模型、env、auth、service routing、usage、balance、payment 等重复基础设施
• Console、Chrome Extension、SDK 和 UI 组件把这套 runtime 暴露给 builders 和团队

Runtime 名词

• town：整体 runtime 与 CLI 表面
• console：全局控制面
• agent：一个项目 runtime
• session：一条执行线程
• plugin：一个能力边界
• city：当前 City runtime 的 package / runtime 名称

最短模型

• 产品负责体验
• agent 负责运行工作
• session 负责执行轮次
• plugins 负责暴露能力
• City 负责把重复后端能力从每个产品里抽出来

plugin 的两类

本地 plugin

• 直接挂到一个 SDK Agent
• 通常是 action-first 或 hook-oriented

托管 plugin

• 归属于目标 agent runtime
• 可以持有 lifecycle-owned runtime state

为什么这很重要

读当前代码或文档时，优先看产品边界：

• 需要产品操作，看 town、console 和产品文档
• 需要执行拥有者，看 agent 与 session
• 需要找能力拥有者，看 plugin
• 需要可复用后端能力，看 City SDK 和 services 文档