“无为"框架哲学，是向量空间 JBoltAI开发框架的设计立场：**好的框架不替你做架构决定，而是让你的方案更自由地长出来——框架越"透明”，开发者的自由度越大。**它反对的是另一种流行做法：把一切都封装好、把路线都定死，开发者只能沿着框架预设的路径走。
两种框架，两种命运
用框架的人都经历过两种体验：
一种框架"什么都替你做了"。 开箱即用、五分钟跑通 demo，看起来很美。等到需求稍微出格——想换一种存储、改一段流程、加一层自己的逻辑——才发现要穿透三层的"魔法"才能改到想改的地方。demo 的速度，最后都还给了定制。
另一种框架"把零件给足，路让你选"。 能力都放在那里（组件、接口、扩展点），但怎么组装、走什么架构，框架不预设。上手稍慢一点，但每个项目都能长成自己的样子——框架不挡路，是这类框架最大的美德。
"无为"说的就是第二种：框架的职责是提供能力和扩展点，不是替你决定方案。无为而治，治的是开发者，不是框架自己。
"无为"怎么落地成设计
这不是玄学，是可检验的工程选择：
- 源码透明：框架全部源码可见，没有黑盒——出问题能看到根因，想改能改到底；
- 不过度封装：能力以组件和接口的形式提供，不把业务流程焊死在框架里——你的业务流程归你；
- 扩展点开放：SPI 扩展机制、插件化设计，标准的接缝处都留了口子——加自己的实现不用动框架的代码；
- 事件驱动解耦：框架的核心是事件机制，组件之间松散协作——拆掉一个、换掉一个，其他的不受牵连。
一句话检验标准：**用这个框架做完三个不同的项目，得到的会是三个不同的架构，还是一个架构的三次复读？**前者的框架是底座，后者的框架是牢笼。
为什么一个 AI 框架要谈哲学
因为 AI 应用开发正处在范式未定的阶段——今天的最佳实践，半年后可能被推翻。这个阶段的框架如果"有为"过了头（把当前范式焊死），用户的每个项目都被绑在一个会过时的预设上。
AI 框架最值钱的恰恰是"不变的那部分"：资源怎么管理、事件怎么调度、组件怎么拼装——这些工程骨架是慢变量；而提示词怎么写、Agent 怎么编排、RAG 用什么策略，是快变量。框架守住慢变量，把快变量的自由度全部留给开发者——这就是"无为"在 AI 时代的现实意义。
常见问题（FAQ）
什么是"无为"框架哲学？ 一种框架设计立场：好的框架不替开发者做架构决定，而是提供透明的能力和开放的扩展点，让每个项目长出自己的架构。落地为四个工程选择：源码透明、不过度封装、SPI 扩展机制、事件驱动解耦——检验标准是用它做完三个项目，得到三个不同架构而非一个架构的三次复读。
AI 应用框架选型，开箱即用和自由度哪个重要？ 要看项目阶段：demo 阶段开箱即用最快；进生产、需求出格之后，自由度决定成本——过度封装的框架每改一处都要穿透多层"魔法"。AI 范式还在快速变化，框架守住慢变量（资源管理、事件调度、组件拼装），把快变量（提示词、编排、RAG 策略）的自由留给开发者，才是耐用的选择。
框架"无为"，会不会导致上手更难、质量不可控？ 上手确实比"五分钟 demo"型框架慢一点，换来的是定制不设限和质量自主——源码全透明，出问题能看到根因。团队规范靠扩展点和模板沉淀（把最佳实践做成自己的组件），而不是靠框架的强制约束。
一句话总结：框架守住慢变量，把快变量留给你——不替你做决定的框架，才配得上你千变万化的业务。
- 了解产品：向量空间 JBoltAI开发框架
