TabTin

这是什么？适合谁？

TabTin（tabtin-ai/TabTin）是一个开源的人与 Agent 协作平台，面向希望把 Agent 带进真实工作的个人和团队。它要降低人和 Agent 共同工作的协作成本，让个人完成的工作能被团队接续、复用和检查。

它首先解决的问题：一个人已经完成的工作，能不能直接成为下一位同事的起点？ AI 提高了个人产出，却没有自动提高团队效率——团队用 Agent 越深入，重复调研、上下文与判断依据丢失、Token 重复消耗、方法难复用、结果责任不清的问题越明显。

核心能力：

• 工作可以交接：任务续接会冻结必要的对话上下文，带上任务中引用且有权共享的文档、表格、云端文件和本地文件；接手人能理解结论如何形成，在自己选的 Agent 和 Workspace 里继续推进。
• 人和 Agent 操作同一份结果：消息、文档、多维表格、演示文稿等协作应用，Agent 直接创建和编辑，不再在聊天框、文件下载、办公软件之间搬运。
• 团队方法可以复用：不同 Agent 角色配置自己的规则、模型、Skill 和记忆，验证过的调研方法、Review 规则、测试步骤、发布流程在后续任务中继续使用。

适合人群：深度使用 AI 的团队；需要「个人产出可被团队接续」的组织；想把 Agent 带进真实工作流而非只是聊天的人。

当前状态：Public Preview（公开预览）阶段，AGPL-3.0-only 开源。

准备工作

1. 官方服务：直接访问 tabtin.com 体验，无需自维护服务端。
2. 本地运行：需 Node.js、pnpm、Python、Go、Git、Docker、Docker Compose 及平台构建工具。
3. 成本：开源免费（AGPL-3.0-only）；无法采用 AGPL 的场景可联系官方获取商业授权。
4. 时间预算：官方服务注册即用；本地 Community Server 首次配置约 10-20 分钟。
5. 授权注意：AGPL-3.0-only 要求网络使用也开源；闭源 SaaS 需单独商业授权。

快速上手（3 步）

第一步：选择入口

• 官方服务：访问 tabtin.com 直接使用。
• 本地源码：适合本机体验或二次开发。

第二步：本地运行（命令行）

git clone https://github.com/tabtin-ai/TabTin.git
cd TabTin
cp .env.example .env        # 首次只复制模板，不覆盖已有文件
# 快速预览：Community 后端 + Electron
node scripts/dev.mjs community
# 或全量预览：后端 + AdminDash + tabtin-web + Electron
pnpm dev

Windows 用户也可双击 start-community-dev.bat，macOS 双击 start-community-dev.command。

第三步：配置 Agent 角色并开始协作

配置不同 Agent 的角色、模型、Skill 和执行规则，让 Agent 直接参与调研、文档、表格、演示文稿、代码等真实工作。

成功判定：Agent 能创建/编辑协作应用内容，且你能把任务（含冻结上下文 + 引用文件）交接给同事继续推进。

初级用法

工作交接

交接不只是最后一份文档：任务续接冻结对话上下文 + 引用且有权共享的文件。接手人理解结论如何形成，在独立任务中继续。

人与 Agent 同一份结果

Agent 直接创建和编辑消息、文档、多维表格、演示文稿；浏览器采集的数据与媒体进入工作应用。人和 Agent 面对同一份在线结果。

团队方法复用

Agent 角色配置规则、模型、Skill、记忆；验证过的方法在后续任务复用，不依赖某位成员临时写的 Prompt。Agent 执行工作，重要判断、责任确认、结果验收仍由人完成。

高级玩法

Community Server 与 BYOK

开发者可在本机运行 Community Server，也可从源码修改。Community Server 默认只监听本机，账号/配置/业务数据存本机 Docker 数据卷。.env 里可关闭手机号验证码（AUTH_FIXED_VERIFICATION_CODE 留空）。

用 Agent 启动本地环境

让支持本地代码操作的 Agent 严格参考 docs/development/community-dev-agent-prompt.md，分两步：先装依赖（Node/pnpm/Python/Go/Docker 等）+ Doctor 检查，再选「快速预览」或「全量预览」。

中国大陆网络

node scripts/dev.mjs community --region cn 处理网络环境；区域选择、复用后端、排障见 Electron 开源开发指南。

小技巧

1. 先官方服务后本地：体验用 tabtin.com，自建用 Community Server，二者分开决策。
2. 交接时明确共享范围：只带「任务中引用且有权共享」的文件，冻结上下文让接手人不重做调研。
3. 方法沉淀成 Agent 角色：把验证过的 Review 规则、测试步骤固化到角色配置，而不是每次临时写 Prompt。
4. 区分责任边界：Agent 执行工作，但重要判断、责任确认、结果验收由人完成。
5. AGPL 先想清楚：闭源 SaaS 集成需商业授权，开源衍生可放心用。

常见踩坑

踩坑 1：AGPL 许可误用

• 现象：想把 TabTin 集成进闭源 SaaS。
• 原因：AGPL-3.0-only 要求网络使用也开源。
• 解决：联系 contact@larchiveai.com 获取商业授权；或只作为独立开源服务使用。

踩坑 2：移动端误当独立执行环境

• 现象：只装移动端就想跑 Agent 任务。
• 原因：移动端是桌面端配套入口，不提供独立 Agent 执行环境。
• 解决：先在桌面端完成执行环境配置与设备绑定，任务运行时保持电脑在线。

踩坑 3：.env 覆盖已有配置

• 现象：重复 cp .env.example .env 覆盖了本地配置。
• 原因：误解「首次配置只复制模板」。
• 解决：首次才复制；个人覆盖放 .env.local；两个文件都不得提交。

踩坑 4：本地预览 ≠ 正式 Release

• 现象：把「快速预览」当正式分发包。
• 原因：快速预览/全量预览都是本地开发入口，不是 Community 分发包或正式 Release。
• 解决：明确预期；正式部署走 Community Server 安装流程。

踩坑 5：后端未健康就报告启动成功

• 现象：Agent 报告启动成功但实际后端没起来。
• 原因：没等健康检查。
• 解决：只有后端健康、Electron 窗口就绪、满足验收条件时才算启动成功。

常见问题 FAQ

Q1: TabTin 和聊天式 Agent 有什么不同？

A: TabTin 是协作平台而非聊天框。它解决「个人产出如何被团队接续」——交接冻结上下文 + 引用文件，人和 Agent 操作同一份在线结果，方法可复用，责任可追溯。

Q2: 开源范围是什么？

A: 开放的是实际产品代码，不是为开源单独做的 Demo。计划公开桌面/移动客户端、服务端、Agent Runtime、实时协作、消息、文档、表格、演示文稿、模型管理、管理后台等；以发布快照和验证记录为准。

Q3: AGPL 对我有什么影响？

A: 修改源码并通过网络提供服务，必须开源你的修改。只部署不修改则无额外限制。闭源 SaaS 建议联系官方商业授权。

Q4: 数据存哪？

A: Community Server 默认只监听本机，账号/配置/业务数据存本机 Docker 数据卷。官方服务按公开隐私政策处理。

Q5: 现在是正式版吗？

A: 否，Public Preview 阶段。核心工作链路已可体验，不同组件成熟度和跨端体验有差异；Project 能力下一版本重点推进。

进阶学习建议

掌握基础后，建议深入：

1. 交接协议设计：把「冻结上下文 + 引用文件 + 独立续接」的交接方式用进团队流程，让调研不重做、结论可追溯。
2. Agent 角色库沉淀：为调研、Review、测试、发布分别配置角色（规则+模型+Skill+记忆），形成团队可复用的 Agent 工作系统。
3. Community Server 定制：读 Community 快速开始指南，做 BYOK 配置和模块化扩展，把 TabTin 改造成自己的平台。

参考链接

• 官方仓库
• TabTin 官网
• AGPL-3.0 License

最后更新：2026-08-27 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成