概念
核心概念与定义
理解文档如何承载经验，以及模型、运行时和授权如何共同支持一次任务。
术语表
- Document-first Agent
- 文档优先意味着先把专业方法、资料和任务约定留下来，让运行时在授权范围内使用它们。改动文档可以调整工作方式；实际行为还取决于模型、工具和执行权限。
- Document-native Intelligence
- Prompt、规则、示例和长期经验可以成为可阅读、可修改的文档。文档帮助理解与改进 Agent 的工作方法；模型能力、工具实现和持久化执行状态仍由相应系统提供。
- Persistent Intelligence
- 规则、知识与工作进展保存在文档中，便于备份、比较和迁移。更换模型或运行环境时，需要重新核对依赖、授权与输出效果；接续完整安装还需保留运行数据库、配置和凭据。
- Agent Harness
- Harness 将文档和当前任务组织成上下文，调用模型与工具，并执行权限检查和任务控制。文档描述期望的工作方式，运行时负责在实际环境中执行这些约定。
- Environment Projection
- Environment 包括文件系统、工具、MCP、调度器和外部服务。文档提供任务依据，环境提供可调用的能力；能访问什么、执行什么，还需要由配置与授权共同确定。
- Document Memory
- 将有用的事实、规则与进展整理成文档，便于查看、修订和复用。它与会话记录、运行数据库及检查点各有用途；备份文档不等于保存全部对话与执行状态。
以可读文档组织规则、知识与工作进展的 Agent。
把可复用的专业经验沉淀在文档中的设计方式。
让有效经验超出一次对话，能够长期保留与接续。
组织上下文、模型调用与工具执行的运行机制。
Agent 通过文件、工具与外部服务完成实际工作的方式。
以可读、可编辑文档保留的长期经验与工作进展。
常见问题
OpenJellyfish 是什么？+
OpenJellyfish 是一个文档优先的本地 Agent 工作台，开源并支持自托管。你可以围绕专业资料完成日常任务、把有效方法写回文档，再配置微信、网页或 API 服务交给团队使用。
什么是 Document-first Agent？+
它以可读文档组织专业规则、知识、示例和进展，让经验可以被检查、修改与复用。实际执行还依赖模型、工具、权限和运行环境；文档修改本身不会授予新的工具权限。
文档与 Prompt 是什么关系？+
Prompt 可以是文档的一部分，也可以从文档与任务上下文中组装。两者都能做版本管理。文档优先强调把规则、知识、示例和工作进展一起管理，让有用经验持续积累。
Harness 是怎么工作的？+
Harness 组织当前任务与文档上下文，调用模型、协调工具执行，并检查权限及维护运行状态。同一套工作资料可以交给不同模型使用，但切换后仍需验证行为和输出。
什么是 Environment？+
Environment 是执行任务所需的文件系统、工具、MCP、调度器与外部服务。相关依赖、访问配置和凭据需要在部署环境中准备，不能只靠复制文档获得。
复制文档就能迁移整个 Agent 吗？+
复制文档可以保留规则、知识和已记录的进展。完整迁移还应按部署指南备份配置、运行数据库、凭据 vault 与加密密钥，并在新环境核对依赖和授权。敏感凭据不应提交到公开 Git 仓库。