OpenContext
为编码助手提供跨会话、跨仓库复用的持久上下文。
按维度查看评分与理由
README 明确列出 oc init 会写入 Cursor、Claude Code 和 Codex 的用户级 skills、commands 与 MCP 配置，并称初始化会提示选择工具，因此用户确认与外部影响有一定透明度；但默认选择全部工具，未展示逐文件授权、最小权限设计、卸载流程或完整回滚。产品被描述为本地个人知识库，但未给出完整的数据流、网络请求、遥测或第三方嵌入服务披露。配置测试证明敏感键未设置时不提供默认值且环境变量优先，但未展示密钥存储加密、日志脱敏或权限控制。依赖清单庞大，未提供审计、锁文件、SBOM 或漏洞缓解证据。README、包作者和仓库所有者分别使用 OpenContext、AIContextLab 与 0xranx，归属关系未解释，故来源归属仅部分清楚。
README、package scripts、CI 和测试共同支持核心 CLI、配置、文件夹及文档操作，错误路径也有部分断言，因此普通失败消息获得中等评价。扣分点是搜索集成测试默认跳过、index 测试接受多种宽松结果、CLI 没有版本标志，而且 README/MIT 文件与 package.json 的 Apache-2.0 声明冲突。Node 18+、npm 安装、可选原生模块及 CI 的 Rust/Protobuf 前置条件有记录，但跨平台依赖可用性没有全面说明。
材料清楚区分桌面视觉用户、使用代理工具的开发者和自动化高级用户，并覆盖 Cursor、Claude Code、Codex、OpenCode，受众与场景充分。CLI 命令和组件边界较清楚，但 GUI、Web UI、MCP、搜索及嵌入服务之间的具体能力限制不完整。显式命令和 slash command 使触发较精确，不过“自动加载背景”等表述未说明选择、范围或冲突规则。环境变量覆盖和多种配置路径有说明，但 Windows、Linux、macOS 的运行支持矩阵及 OpenCode 初始化细节不足。
README 的问题、方案、组件、快速开始、FAQ、命令参考和开发章节组织良好，安装说明与示例充足。命令及 OpenContext 名称大体稳定，但包名、作者名和仓库身份存在未解释的差异。已知限制仅零散出现，例如搜索需要 API key、Windows 构建说明及缺少 --version，没有集中限制清单。LICENSE 是完整 MIT 文本，但 package.json 声明 Apache-2.0，构成严重元数据不一致。存在 0.1.0 版本和发布工作流，但未提供变更日志或明确版本政策；帮助渠道存在，维护主体和更新责任仍不清楚。
CLI、MCP、桌面与 Web UI、搜索及可复用上下文库构成可直接使用的输出，并相对单纯存储工具提供跨代理读写的边际价值。README 给出简短操作示例，但没有展示实际检索质量、上下文污染控制、规模边界或成熟输出样例。无需额外代理订阅是合理的成本主张，但仍需要现有代理、全局 npm 安装，并可能需要嵌入 API、原生组件和较大的依赖集合，因此成本收益只能评为充分而非彻底。
主要功能声明可映射到命令表、package scripts、CI 和有限测试，配置、文件夹及文档操作有跨文件佐证。搜索、GUI、MCP 和“自动感知背景”等更广泛主张缺少同等强度的实现或测试证据，搜索集成测试还被跳过。营销性收益与静态事实没有始终明确分隔，且许可证与身份元数据冲突，故可追溯性和事实/推断分离均有扣分。
- LICENSE 和 README 标示 MIT，但 package.json 标示 Apache-2.0；在安装、分发或复用前必须确认实际许可证。
- oc init 会修改多个用户级代理目录和 MCP 配置，且默认选择全部工具；执行前应备份相关配置并核对提示选择。
- 知识库可能包含跨项目敏感信息；材料未说明加密、访问隔离、日志脱敏、遥测或完整网络数据流。
- 搜索依赖 API key/索引且集成测试默认跳过；不要仅凭 README 假设搜索可用性或质量。
- 依赖数量较多且未提供锁文件、SBOM 或安全审计证据，应在部署前独立审查依赖和原生组件。
这个 Agent 能做什么，适合哪些场景？
OpenContext 是面向 AI 助手和编码工具的个人上下文与知识存储系统，重点解决项目背景、历史决策和经验在会话或仓库之间丢失的问题。它包含管理全局 contexts/ 知识库的 oc CLI、供代理调用的 MCP Server、由 oc init 生成的用户级 Skills，以及桌面应用和本地 Web UI。系统不取代编码代理，而是复用已有的 Codex、Claude Code 或 OpenCode CLI，为其增加搜索、读取、创建和迭代上下文的能力。Cursor、Claude Code 和 Codex 可以通过用户级 MCP 配置接入；Cursor 与 Claude Code 还可使用生成的斜杠命令。数据边界是用户本地的全局上下文库，可跨项目访问和维护。
用户通过 oc folder create 和 oc doc create 在全局 contexts/ 库中建立文件夹与 Markdown 文档，并可用 oc folder ls、oc doc ls 和 oc context manifest 查看结构或生成供 AI 阅读的文件清单。oc search "query" 搜索已有文档，oc ui 启动本地 Web UI，桌面应用则提供原生的管理、搜索和编辑界面。执行 oc init 后，OpenContext 会为 Cursor、Claude Code 和 Codex安装用户级 Skills，并为 Cursor、Claude Code 生成 /opencontext-context、/opencontext-search、/opencontext-create 和 /opencontext-iterate 等命令。它还把 MCP 配置写入相应的用户级配置位置；oc mcp 可启动 MCP Server，使支持的客户端直接操作知识库。典型流程是先加载或搜索历史背景，再由现有编码代理执行工作，最后把新结论持久化回上下文库。
- 同时维护多个代码仓库的开发者，希望让 Codex 或 Claude Code 在切换项目后仍能读取统一的背景资料与技术决策。
- 经常开启新聊天或分阶段开发的个人用户，需要保存约束、已验证方案和项目历史，减少重复说明。
- 使用 Cursor 或 Claude Code 的开发者，希望通过斜杠命令加载、搜索、新建或更新知识文档。
- 偏好图形界面的用户，希望通过桌面应用管理、搜索和编辑代理可读取的上下文。
- 需要自动化知识库操作的高级用户，希望用 oc CLI、清单命令和 MCP Server 接入现有工作流。
这个 Agent 有哪些优点和局限？
- 同一个全局 contexts/ 库可以跨仓库和会话复用，无需把项目背景限制在单次聊天中。
- 直接复用 Codex、Claude Code 或 OpenCode CLI，不要求购买一个独立的代理订阅。
- 同时提供 CLI、MCP Server、Skills、桌面应用和本地 Web UI，既适合自动化也适合可视化维护。
- oc init 可生成用户级集成；Cursor 和 Claude Code 还获得专用斜杠命令。
- 它是上下文层而非独立编码代理；代理工作流仍依赖用户已有的 Codex、Claude Code 或 OpenCode CLI。
- 初始化会在用户目录中创建 Skills、命令和 MCP 配置，采用前需要评估对现有配置的影响。
- 来源没有说明最低 Node.js/npm 版本、支持的桌面操作系统或各平台功能是否完全一致。
- 知识库存放在本地文件系统；来源未描述云同步、多人协作、访问控制或加密机制。
如何安装或部署这个 Agent？
CLI 路径：
- 确保系统可以运行 npm，并已准备要复用的 Codex、Claude Code 或 OpenCode CLI。
- 安装：npm install -g @aicontextlab/cli
- 进入项目目录并初始化：cd your-project && oc init
- oc init 默认提示配置全部支持的工具；非交互安装可使用 --tools cursor,claude,codex，或用 --no-claude、--no-cursor、--no-codex 排除工具。
桌面路径：从 GitHub Releases 下载桌面应用。源码开发命令为 npm install 后运行 npm run tauri:dev；构建使用 npm run tauri:build。来源没有说明最低 Node.js/npm 版本、支持的桌面操作系统或任何凭据要求。
如何使用这个 Agent？
初始化后，可在 Cursor 或 Claude Code 中调用 /opencontext-context 加载背景、/opencontext-search 搜索文档、/opencontext-create 新建文档、/opencontext-iterate 保存新经验。Codex 使用 oc init 生成的用户级 opencontext-* Skills，并可通过 ~/.codex/mcp.json 中的配置访问 MCP Server。直接使用 CLI 时，可运行 oc folder ls、oc folder create <path> -d "desc"、oc doc create <folder> <name>.md -d "desc"、oc doc ls <folder>、oc context manifest <folder> 和 oc search "query"。运行 oc mcp 启动 MCP Server，运行 oc ui 启动本地 Web UI；具体参数可用 oc <cmd> --help 查看。
这个 Agent 与同类方案有什么区别？
与 Codex、Claude Code、OpenCode 或 Cursor 的关系是补充而非替代：这些工具承担编码代理或编辑器工作，OpenContext 为其提供可跨项目复用的本地上下文库、Skills、命令和 MCP 工具。与仅负责存储的知识工具相比，README 强调其知识可由编码代理直接读取和写入，但来源没有点名具体竞品。