文件即软件：Selfware 协议如何让 Agent 之间的上下文无缝流转

2026 年 2 月 26 日，floatboat.ai 创始人少卿与 agent 架构师 Remy 在 WaytoAGI 社区直播中，首次系统拆解了他们开源的 Selfware 协议——一个让「文件本身就是软件」的开放标准。这场分享适合所有正在使用 Claude Code、小龙虾（Clawdbot）等 coding agent 的开发者、产品经理和 AI 应用创业者，尤其是那些苦于 agent 之间上下文丢失、文件格式不兼容、协作分享困难的人。两位讲师从协议设计动机讲到实际 Demo，从底层规范聊到未来经济系统，完整呈现了「文件即软件」从理念到落地的全过程。

为什么需要 Selfware：传统文件格式的摩擦

▶ 8:58 · 看这一节

少卿从传统软件的结构讲起：一个软件通常包含数据层、逻辑层和交互层，而传统文件格式（如 DOCX、PPTX）把数据锁死在特定软件里。「你的 PSD 原来只能拿 Photoshop 打开是最好的，Word 也是在它自己里面打开是最好的，WPS 也没法完全兼容。」这种强绑定在 AI 时代成了巨大的摩擦源。

具体痛点有三：第一，办公 agent 解读传统文件格式非常麻烦，PDF 不可编辑、PPTX 兼容性差；第二，分享 Markdown 或 HTML 文件时图片经常裂开，附属资源带不进来；第三，agent 之间切换平台时，上下文无法无缝衔接——在 A 平台干完的活，交给 B 平台的 agent 接着干，所有来龙去脉都要重新交代。

少卿指出，AI 时代最大的变化是「AI 可以很好地理解你的上下文，然后你的视图跟逻辑层它是可以通过 coding 的能力去抹平的」。这意味着用户只需要留下一份数据，通过协议指定视图，AI 就能临时生成一个软件来展示和操作它。Selfware 协议正是基于这个思路设计的。

协议核心：一个文件就是一个 APP

▶ 9:54 · 看这一节

Selfware 协议最核心的定义只有一句话：「a file is an APP, everything is a file」。整个协议开源在 GitHub 的 floatboat AI 仓库中，最关键的一份文档是 selfware.md，其他都是模板和示例。

一个 .self 文件本质上是一个 zip 压缩包，解开后是一个有规范、有指导的文件夹。其中两个文件最关键：

• selfware.md：引用 GitHub 上的协议规范，AI 创建文件时会自动遵循它。
• manifest：定义软件的启动方式、打包方式、安全范围、权限要求，以及有哪些视图（如文档、画布、脑图、大纲演示、卡片等）。

所有软件的写入都发生在 content 目录下，且「只能够被 agent 去操作」。视图和内容可以随时修改——用户可以直接编辑 Markdown 内容，也可以让 agent 更新文档或软件本身。文件里还可以内置 skills，分享给别人时对方无需再去市场安装，开箱即用。

协议本身是一个简单规范，明确了「禁止、应当、可以」三层：比如禁止自动更新任何东西；应当把写入限定在数据源目录；可以的部分则留给进化——通过 discovery 服务，文件可以带着意图和部分上下文去 GitHub 上查找相似任务和技能，找到后询问用户是否尝试，用户同意后能力就增强了。

少卿特别强调，这个协议是完全开放的：「大家可以随便去定义它，甚至你不 follow 这个，你只把它当做一个玩法自己去玩，启发到你，你其实也是可以自己去定义一个协议的，甚至包括这个后缀名。」.self 只是他们推荐的通用后缀，用户完全可以自定义。

活的文件：协同、分享与进化

▶ 15:06 · 看这一节

与传统文件格式相比，Selfware 最大的差异在于它是一个「活的软件实体」。少卿展示了几个关键特性：

协同工作：在 manifest 中定义文件位于某个 Git 仓库后，多人或多 agent 可以基于同一个 .self 文件协同。A 改完传给 B，B 打开时会自动去服务端检查更新，通过 Git 方式 merge 进来。「你传一次之后，如果双方相互是信任的，类似于传统的授权，它有了之后就可以基于这个去协同。」

记忆与回滚：文件内置了 memory 模块，所有改动默认启用 Git 记录（可选）。每次关键决策的元数据都会被记录下来，用户可以随时让 agent 找回某个历史版本。「如果我们在 a 小龙虾用完了，然后 b 里边，然后我要 claude code 接着去干，甚至我让 Manus 或者是 ChatGPT 接着干，你就把这包传给他，他就知道所有的来龙去脉。」

权限与安全：打包分享时，用户可以控制粒度——选择是否包含 memory、是否排除敏感信息。协议默认排除环境个性化信息和 Git 记录。文件某些环节还可以加密，实现简单的权限管理。

协议进化：协议本身放在 GitHub 上持续迭代。用户去年的文件用的是旧版协议，今年打开时 agent 会发现协议更新了，询问是否升级。「你更新一下可以享受到更新的，如果你不更新，那就还是用以前那个稳定运行，也是 ok 的。」

少卿还对比了 DOCX 格式：「DOCX 本身也是一个 zip 包，你把它改成了点 zip，它也能解压出来。」微软把相关内容放在媒体文件夹里，而 .self 文件把数据、逻辑、视图全部打包在一起，分享时不会丢东西。

实战演示：从笔记软件到长程运行系统

▶ 26:03 · 看这一节

Remy 从架构师视角补充了 Selfware 的设计逻辑。他指出，现在 agent 的能力已经足够让每个人开发自己用的软件，但分享是个大问题：「我需要建一个 git 仓库，然后需要让别人拉下来，然后有这样一拖的操作，那可能 50% 的人可能到这一步之后就望而却步了。」

Selfware 的解法是把「跟 agent 交互的所有的历史、所有的关键决策全都记录到这一份 selfware 里边」。它首先是一个传统软件，定义目标、输入输出；其次记录了整个开发过程——用了哪些 skills、做了哪些关键决策、为什么界面长这样而不是那样。

Remy 展示了一个让 agent 长程运行的系统：运行了 25 小时、经过 20 次迭代，包含 UI、测试、功能性等内容。最终产出的脚本打包成 .self 文件后，「除了软件的界面本身，大家还能获得的是在开发这个东西的过程中用了哪些 skill，做了哪些关键的决策，整个的意图或者说整个的协作历史会被更清晰地记录下来。」

AJ 则从完全不懂代码的产品经理视角，演示了上手过程：把 GitHub 链接丢给 Claude Code，说「你给我装一下」，装完后让 agent 介绍用法，然后让它创建一个日记系统。生成的日记系统以 .self 文件形式存在，本地运行后通过 localhost 访问，支持 Markdown 格式，可以随时记录和保存，还能打包分享给朋友。

AJ 特别提到传统工具的痛点：「我们自己在飞书里边搞龙虾聚会，每天这些文章让小龙虾写到飞书文档里，填进去又是空白，然后又各种格式不支持。」而 Selfware 协议下，「agent 之间的传输是完全无损的」。她还让日记系统进化，添加了游戏化系统、时光胶囊，甚至让 agent 自己写日记——「实现了与 agent 的共创」。

现场问答

▶ 43:04 · 看这一节

Q：带服务器的复杂程序能用 Selfware 吗？

少卿认为这类程序「恰恰是最容易 selfware 的」，因为 Selfware 的核心是本地运行，不需要跟云服务打交道。「你本地的环境是很简单的，可能大家非专业开发者被卡在的第一步就是怎么去跟阿里云、亚马逊云打交道，但是如果是你本地运行的话，完全没有这个障碍。」依赖可以全部装进文件里。不过协议推荐用 agent 驱动打开，entry point 设计了两类：action（发给 AI 执行）和 script（用户点按钮就能触发）。

Q：打包分享时 API key 会泄露吗？

AJ 提到很多人在部署小龙虾时把 API key 明文丢给 AI，存在安全隐患。少卿回应：「我们协议里面是让它去掉的，但是可以再检查一下。目前是一个协议层面的内容，后面会配合一整套软件工程来保证，比如它读了点 ENV，我们就用个 hook 让他不读。」他也建议用户打包时明确告诉 agent「敏感信息不要打包」，或者定期轮换 key。

Q：文件分享给别人后打不开或运行失败怎么办？

少卿的建议很简单：「让 agent 运行它，agent 的能力是很强的，运行失败可以让它继续尝试。」分享方式有两种：单文件传输最直观；如果双方有信任关系，可以基于 Git 仓库协作，更新后自动同步。

Q：Selfware 和 Skill 是什么关系？

少卿解释：「Skill 本身只是一个文件的约束，你可以把 Skill 理解成一种特殊的文件格式。点 self 是逻辑上包含它——Skill 是方法论，点 self 是你做出来的作品。」

产品与展望：floatboat AI 与新的经济系统

▶ 1:23:41 · 看这一节

少卿介绍了他们正在开发的 floatboat AI——一个基于 agent 的聊天软件，背后可切换 Gemini、Claude Code 等不同后端。它自带完整的文件管理器，支持文件拖放操作，可响应第三方服务；支持多个工作空间切换，可新建纯 chat 视图；内置 combo skills 市场，用户可加载和下载别人做好的技能。产品还设计了 IACT 交互——agent 干完活后，用户可以通过按钮直接操作，比如一键写成技术博客。

少卿把它定位为「办公场景下的 Openclaw」：「你可以跟同事的电脑去协同，你在手机上可以控制它。」下周将发布正式版，目前内测中，今天参与直播的用户可获赠一个月的 credits。

Remy 则展望了更远的经济系统变革。他认为在生产力爆棚之后，「工作将从人工作变成人指导 AI 工作，那就是 Web 4.0 的形态」。同样的 agent，引导能力不同，产出天差地别——「你的虾虾在那边帮你跑一些小任务，但有别人的虾虾可能就拿去做了一个量化系统，从里边每天赚 1 万块」。新一代经济系统需要度量「有效引导的能力、把需求落地的能力、把一个 TOKEN 变成经济价值的能力」。

Selfware 在这个系统中的角色是：「能够把这些技能无限地迭代、无限地复制，早期的开发者应该享受到后面新加入的人所产生的红利。」价值锚定从「工作量」转变为「把 TOKEN 变成价值的能力」——「有更多的人愿意相信你这个 selfware，或者愿意使用你这个 selfware，你这个东西就变得更加有价值。」

要点回顾

• 核心定义：Selfware 协议的核心是「a file is an APP, everything is a file」，一个 .self 文件就是一个自包含的软件，包含数据、逻辑和视图。
• 开放通用：协议完全开源，不绑定任何平台，数据归用户所有；后缀名可自定义，所有 coding agent 都能支持。
• 自包含与自进化：文件包含 selfware.md（协议引用）和 manifest（软件定义），可通过 discovery 服务自动查找和更新技能。
• 无缝协同：文件可在不同 agent 之间无损传输，支持多人多 agent 基于 Git 仓库协同工作，自动同步更新。
• 权限可控：打包粒度由用户决定，协议默认排除敏感信息，支持加密和权限管理。
• 上手方式：把 GitHub 仓库链接丢给任意 coding agent（Claude Code、小龙虾等），说「克隆这个文件并运行 selfware」即可。
• 适用场景：办公写作、项目管理、产品设计、自媒体、个人知识管理，以及任何需要 agent 之间交接上下文的场景。
• 配套产品：floatboat AI 是 Selfware 的首个工作平台，提供文件管理、多 agent 并行、技能市场等能力，下周发布正式版。