OneContext

OneContext 是一款专为 AI Agent 设计的统一上下文管理工具，核心价值在于为团队所有 AI Agent 提供标准化的上下文层——无论是人还是 Agent，都能基于相同的上下文接手工作，彻底解决多 Agent 协作时“上下文割裂、工作衔接断层”的问题。

核心功能：让 AI Agent 上下文可记录、可共享、可复用

1. 轨迹自动记录：运行 Agent 时，OneContext 会自动记录其完整执行轨迹，留存所有操作上下文；
2. 上下文共享：支持在 Slack 上共享 Agent 上下文，任何人都能直接与 Agent 对话，无需重新梳理背景；
3. 上下文加载：可将历史上下文一键加载到 Agent 中，确保所有人/Agent 从同一起点继续工作，避免重复沟通。

快速安装（开箱即用）

安装命令

npm i -g onecontext-ai

该命令会自动识别并使用最优 Python 包管理器（优先级：uv > pipx > pip3 > pip），安装最新版 onecontext-ai Python 包。

前提条件

• Node.js 版本 ≥ 16
• Python 版本 ≥ 3.11，且已安装以下任一包管理器：uv / pipx / pip3 / pip

三、快速开始与基础用法

启动工具

onecontext

命令别名（三者等效）

安装后可使用任意简写命令，底层均代理到 Python CLI：

onecontext-ai <command> [args...]  # 完整命令
onecontext <command> [args...]     # 简化版
oc <command> [args...]             # 最短别名

基础示例

# 查看版本
onecontext version
# 或简写
oc version

# 显示帮助文档
onecontext --help

更新与维护

推荐升级方式

onecontext update

（npm 包装器会自动同步最新 Python 包，无需手动操作）

升级故障修复

若升级失败，先修复升级路由再重试：

onecontext doctor --fix-upgrade
onecontext update

极端情况处理

仅当 npm 包装器链接/缓存失效时，才需重建链接：

npm rebuild onecontext-ai

常见故障排除（安装后命令找不到）

1. 优先修复并更新：

   onecontext doctor --fix-upgrade && onecontext update
   

2. 重建 npm 包装器链接：

   npm rebuild onecontext-ai
   

3. 检查命令是否在系统 PATH 中：

   which onecontext