概念
核心概念与定义
理解 OpenJellyfish，从这些术语开始。每一个都在回答同一个问题：为什么智能应该活在文档里。
术语表
- Document-first Agent
- 在 Document-first Agent 中，Agent 的身份、记忆、技能、工作流、权限与知识全部以文档形式存在。运行时只负责推理与执行，不承载任何业务逻辑或人格。因此同一个运行时配上不同的文档，就是完全不同的 Agent。
- Document-native Intelligence
- 文档原生智能意味着：Prompt 只是文档的一种投影，Memory、Workflow、Skills、Policies、Permissions、Knowledge 也都是文档。所有可定制的能力本质上都来自文档，而不是数据库表或硬编码逻辑。
- Persistent Intelligence
- 因为 Agent 就是一组文档，它可以脱离具体的运行时长期存在。Harness 可以升级，LLM 可以替换，Runtime 可以重构，但 Agent 的灵魂始终保存在文档里，不会随之消失。
- Agent Harness
- Harness 不是 Agent，而是让智能得以运行的躯体。它不知道自己是谁、该做什么、有哪些记忆与权限，永远保持简单。把复杂度留在文档层，同一个 Harness 就能承载无限多个完全不同的 Agent。
- Environment Projection
- Environment 包括 Filesystem、Tools、MCP、Scheduler 与 External Services。它不属于 Agent，只是 Agent 所处的世界。Harness 与环境交互，文档定义 Harness 如何理解并投射到这个世界。
- Document Memory
- 记忆不被塞进不透明的向量库或数据库，而是写成可阅读、可翻阅、可版本管理的文档。你可以像走进记忆宫殿一样逐层查看 Agent 记住了什么，并直接编辑它。
把智能保存在文档里、而不是 Prompt 或编排代码里的 Agent。
以文档为第一载体来定义、存储与演化的智能。
不绑定任何 Runtime、数据库或平台，可长期留存与迁移的智能。
只负责 Observe · Think · Decide · Act 的最小智能运行躯体。
智能通过文件系统、工具与外部服务把自身投射到世界的方式。
以可读、可编辑文档形式存在的长期与分层记忆。
常见问题
OpenJellyfish 是什么？+
OpenJellyfish 是一个 Document-first 的 AI Agent 框架。它不把智能写进 Prompt 或编排代码，而是保存在文档中：LLM 提供智能，Harness 运行智能，Documents 定义智能，Environment 投射智能。开源、自托管、可用 git 迁移。
什么是 Document-first Agent？+
Document-first Agent 把 Agent 的身份、记忆、技能、工作流、权限与知识全部存成文档，运行时只负责推理与执行。换掉文档就换掉了 Agent，而运行时保持不变。
为什么用 Documents 而不是 Prompt？+
Prompt 只是文档的一种投影，且难以版本管理、复制与迁移。用文档承载智能，能获得可阅读、可 diff、可 merge、可复制的完整生命周期管理——整个 Agent 都能用成熟的软件工程工具来维护。
Harness 是怎么工作的？+
Harness 是最小的智能运行躯体，只跑 Observe · Think · Decide · Act 循环。它不承载业务与人格，所有定制都发生在文档层，因此同一个 Harness 可以运行无数个不同的 Agent。
什么是 Environment？+
Environment 是 Agent 所处的世界：文件系统、工具、MCP、调度器与外部服务。Agent 通过环境触达真实世界并把结果表现出来，但环境本身不属于 Agent。