字
字节笔记本
2026年2月16日
OneContext：AI 代理自管理的上下文层系统
API中转
¥120
本文介绍 OneContext，一个智能代理自管理的上下文层系统。它为团队提供统一的 AI 代理上下文管理方案，让任何人或代理都能从相同的上下文继续工作，实现跨会话、跨设备、跨代理的无缝协作。
项目简介
OneContext 是一个开源的代理上下文管理工具，由 TheAgentContextLab 开发维护。截至目前，该项目在 GitHub 上已获得 853 stars。它的核心理念是让 AI 代理能够自我管理上下文，实现团队协作时的上下文共享和连续性。
核心特性
- 🤖 代理轨迹记录：运行代理时自动记录完整的工作轨迹
- 💬 上下文共享：通过 Slack 与团队共享代理上下文，任何人都可以继续对话
- 🔄 上下文加载：将上下文加载到代理，从相同断点继续工作
- 📦 会话导入：支持导入过去的 Codex/Claude 会话作为上下文
- 💾 会话归档：灵活管理活跃和归档的会话/上下文
- 🔗 链接分享：生成可分享的链接，方便团队协作
技术栈
- Node.js - CLI 工具基础（>= 16）
- Python 3.11+ - 核心功能实现
- uv/pipx/pip - Python 包管理支持
- npm - Node.js 包分发
安装指南
前置要求
- Node.js >= 16
- Python 3.11+
- Python 包管理器（uv、pipx、pip3 或 pip）
安装步骤
bash
# 全局安装 OneContext
npm i -g onecontext-ai安装脚本会自动检测并使用最佳的 Python 包管理器（优先级：uv > pipx > pip3 > pip）安装底层的 Python 包。
快速开始
启动 OneContext
bash
onecontext或使用短别名：
bash
oc基本命令
bash
# 查看版本
onecontext version
# 显示帮助
onecontext --help
# 检查并修复安装
onecontext doctor --fix-upgrade
# 更新到最新版本
onecontext update使用示例
1. 运行代理并记录上下文
bash
# 启动 OneContext
onecontext在界面中：
- 点击 Add Context 创建新上下文
- 点击 New Session 创建会话并设置工作路径
- 开始工作，会话摘要会自动显示在左侧
- 可以在同一上下文中创建多个会话
2. 共享代理上下文
- 点击 Share 生成分享消息和链接
- 复制链接分享给团队成员
- 接收者可以通过链接查看上下文
- 支持直接在 Slack 中询问上下文
3. 加载共享上下文
收到分享链接后：
- 点击链接打开上下文，可直接在聊天中提问
- 或导入共享会话到本地
- 在 OneContext 中找到导入的会话
- 创建新会话继续工作
4. 恢复会话
关闭终端或会话后恢复：
bash
# 方法 1：点击 + 选择 Resume Session
# 方法 2：双击上下文名称
# 选择要恢复的会话，点击 Resume5. 归档和恢复上下文
归档上下文：
- 点击上下文旁边的 × 进行归档
恢复归档的上下文：
- 进入 Config 标签页
- 启用 "Show Archived Agents"
- 返回 Contexts 标签查看所有归档上下文
- 点击 Restore Agent 恢复
导入历史会话
OneContext v0.8.3 新增功能：支持导入过去的 Codex/Claude 会话作为上下文。
bash
# 导入历史会话，保持跨会话、跨设备、跨代理的连续性
onecontext
# 在界面中选择导入选项故障排除
命令未找到
bash
# 修复并更新
onecontext doctor --fix-upgrade && onecontext update
# 重建 wrapper 链接
npm rebuild onecontext-ai
# 检查 PATH
which onecontext升级路由损坏
bash
# 修复一次后重试
onecontext doctor --fix-upgrade
onecontext update工作流程示例
场景：团队协作完成 ML 项目
成员 A：
bash
# 创建项目上下文
onecontext
# 添加 Context：ml-project
# 创建 Session：data-exploration
# 进行数据探索工作共享给成员 B：
bash
# 点击 Share 生成链接
# 通过 Slack 发送给成员 B成员 B：
bash
# 点击链接查看上下文
# 或导入会话到本地
# 创建新 Session：model-training
# 继续模型训练工作结果：成员 B 无需重新了解项目背景，直接从成员 A 的断点继续。
项目链接
- GitHub 仓库：https://github.com/TheAgentContextLab/OneContext
- 问题反馈：https://github.com/TheAgentContextLab/OneContext/issues
更新日志
2026-02-14: v0.8.3
- 新增：导入过去的 Codex/Claude 会话作为上下文
- 支持跨会话、跨设备、跨代理的上下文连续性
2026-02-07: 首次发布
- 基础上下文管理功能
- 会话记录和共享
- Slack 集成
分享: