3241288994/codexmanager

CodexManager · 从一个绝对路径开始的本机 / 服务器项目理解入口

复制一个本机或服务器绝对路径，ChatGPT 就能在你授权的范围内查看目录、找到入口文件、继续读取 关键代码与文档，并解释整个项目是做什么的——无需先上传项目，也无需先注册工作区。

一句话卖点：把路径贴给 ChatGPT，让它直接读懂你电脑和服务器上的真实项目。

交给 Agent 安装 · 路径直读与工作区 · 连接 ChatGPT · 服务器部署

English: Paste a path and let ChatGPT understand a project on your computer or server. CodexManager connects authorized ChatGPT workflows to bounded, read-only project tools while keeping administration and credentials private.

下面是一段典型流程。路径只是示例，实际可使用你已经授权的本机或服务器目录。

你：
请读取服务器上的 /srv/research/web-agent，先看目录，再找到入口文件，告诉我这个项目怎么运行。

ChatGPT：
✓ 已确认来源：服务器
✓ 已读取两层目录：README.md、pyproject.toml、src/、tests/、configs/
✓ 找到主要入口：src/main.py
✓ 继续检查 README.md、pyproject.toml 与入口模块

这是一个用于网页任务规划与执行的 Agent 项目：
- src/main.py 负责启动任务和加载配置
- src/agent/ 保存规划、动作选择与错误恢复逻辑
- configs/ 定义模型、浏览器环境和实验参数
- tests/ 覆盖页面解析与任务执行

建议先从 README.md 的 Quick Start 启动，再查看 configs/default.yaml。

这个过程由四步组成：

你也可以直接这样问：

请查看本地电脑的 /Users/me/Documents/project，找到入口文件并解释项目结构。
请读取服务器 /srv/research/paper-a/README.md，总结当前研究目标与运行方法。
请在服务器 /srv/research/experiments 下列出两层目录，并比较两个实验的结果文件。

两端完全解耦：只需要本机就不必安装服务器组件，只需要服务器也不必开放本机文件。访问范围始终由 各端 Provider 的 registry.allowed_roots 控制；根目录、凭据、隐藏密钥和不支持的二进制不会因为 贴了路径就自动开放。

inspect_path 适合“现在帮我看看这个目录/文件”。Provider 0.9.0 支持（工作区文件读取共用同一解析器）：

• 有限深度目录树；
• 常见代码、配置、日志、文本及 README、Dockerfile、Makefile 等文件；
• HTML 可见正文，不加载外部资源；
• 文本型 PDF 的分页读取与搜索；
• DOCX 正文、XLSX 单元格、PPTX 幻灯片文字和 IPYNB 源码/纯文本输出；
• 扫描型 PDF 的明确 OCR 提示，而不是猜测内容。

需要持续研究时，再把路径固定为工作区。工作区可以维护项目概述、证据索引、实验结果、研究图、 分析任务和最近 Codex 会话衔接。路径直读与工作区共用同一套目录授权，但互不强制：先读懂，再决定 是否长期管理。

不用逐行复制部署命令。把下面内容交给能操作目标电脑和服务器的编码 Agent：

请安装 https://github.com/3241288994/codexmanager ，模式为 hybrid。
服务器 SSH Host 是 <你的 SSH 别名>；本机允许读取 <本机目录>，服务器允许读取 <服务器目录>。
请先完整阅读仓库中的 AGENTS.md 和 INSTALL.md，按其中的 Agent 执行契约操作；
沿用已有 SSH 配置和密钥，不在对话或日志中输出凭据。只有必须由我在 OpenAI 页面完成时再通知我。

只使用一端时把模式改为 local 或 server。INSTALL.md 定义了只读盘点、备份、 组件安装、人工授权检查点与真实调用验收，Agent 不应把“端口已打开”误报成“已经完全连通”。

打开 http://127.0.0.1:48761/labcontext/：

1. 连接降级时点击 一键修复；
2. 系统自动诊断，清理可验证的旧 SSH 转发或孤儿组件，重建连接并重新验证；
3. 无法安全修复时，页面直接显示具体原因和处理建议。

清理期间若另一个合法的 LabContext 启动器已经接管连接，修复会等待并核对 Router 的真实状态，避免把 短暂的 SSH 端口交接误报为失败。

如果 Router 完全没有运行，终端执行：

labcontext repair

repair 会自行完成诊断；不要写成 labcontext doctor && labcontext repair，因为诊断发现故障时会 返回非零状态，Shell 的 && 会阻止修复命令执行。

日常使用只需要记住 labcontext；下面的组件可以分别安装、升级和替换：

labcontext status   # 分层状态
labcontext doctor   # 真实验证 SSH 与依赖
labcontext repair   # 降级时安全重建链路

ChatGPT 网页版
      │
      ▼
Secure MCP Tunnel
      │
      ▼
LabContext Router · 127.0.0.1:1460/mcp
      ├── local Provider  ── 本机授权目录
      └── server Provider ── SSH bridge ── 服务器授权目录

CodexManager Web · 127.0.0.1:48761
      └── 连接中心 / 工作区 / 研究图 / 用量与会话管理

• Provider 负责受限、只读地理解文件与项目；
• Router 把本机与服务器组合成一个稳定 MCP 工具面；
• Tunnel 让 ChatGPT 在无需开放入站公网端口的情况下访问 Router；
• CodexManager 提供连接诊断、工作区管理，以及 Codex 账号、额度、用量与会话辅助能力。

完整端口、SSH、Tunnel 和故障排查见统一 LabContext Router。

路径直读是主入口，下面这些能力为长期研究提供配套：

• 可验证、可一键修复的连接中心：逐层检查 Router、Provider 身份与版本、真实 MCP 调用、SSH 子进程和 Tunnel；降级时先安全诊断再自动重建，无法处理则直接显示具体原因。
• 项目工作区：管理模型可见资产、工具策略、项目概述、证据、实验、分析任务与研究图。
• 账号与额度：通过官方设备授权添加账号，显示实际生效身份、套餐信号与额度快照，并切换服务器 Codex 凭据。
• 用量分析：保存 Credits、Token 与交互历史，提供趋势图、JSON/CSV 导出和非账单性质的 USD 参考估算。
• 会话恢复：读取 state_5.sqlite 元数据搜索本地会话并生成 codex resume 命令，不导出原始对话。

查看更多界面：工作区、研究图、账号、用量与会话

工作区与研究图

账号与额度

用量分析

会话恢复

• 只有 registry.allowed_roots 下经过验证的路径可读；目录深度、条目数、文件大小、PDF 页数和单次响应均有限制。
• 默认部署只监听回环地址；数据库、管理 RPC、账号令牌和 LabContext admin token 不应公开。
• CodexManager service 本身不是 MCP endpoint；ChatGPT 连接的是独立 Router 的 /mcp，不是 /api/rpc、/rpc 或 /admin。
• 当前公开版不提供公共 OpenAI 兼容 /v1 网关。Secure MCP Tunnel 适合私有连接和开发测试，不是公共插件分发机制。
• 请只读取你有权访问的本机和服务器目录，并遵守 OpenAI、Codex 与目标项目的适用条款。

详细边界见 SECURITY.md 和 OpenAI 插件与 Tunnel 说明。

本地开发要求 Node.js 20+、Python 3.11+、Rust stable；桌面打包还需要对应平台的 Tauri 依赖。

corepack pnpm@10.30.3 -C apps install --frozen-lockfile
corepack pnpm@10.30.3 -C apps run build:desktop
corepack pnpm@10.30.3 -C apps run test:runtime
cargo test --workspace --locked -- --test-threads=1
cargo test --manifest-path apps/src-tauri/Cargo.toml --locked --lib
scripts/open-source/preflight.sh

labcontext-provider/     路径直读、工作区、证据与研究工具的只读 Provider
scripts/labcontext*.py   本机 / 服务器统一 Router、SSH bridge 与启动诊断
apps/                    Next.js 管理界面与 Tauri 桌面壳
crates/web/              Web 运行壳、认证与受保护的 RPC 代理
crates/service/          账号、额度、会话、用量和 LabContext 管理适配
crates/core/             SQLite、认证与共享数据结构
crates/start/            service + web 启动器
deploy/                  安全 Compose 与 Router 示例配置
plugins/                 不含用户连接 ID 的公开插件模板
docs/                    路径、部署、Tunnel、安全与发布文档

• 安全问题请遵循 SECURITY.md，不要在公开 Issue 中提交凭据或可利用细节。
• 贡献流程见 CONTRIBUTING.md。
• 项目采用 MIT License，基于 qxcnm/Codex-Manager 的 MIT 许可代码演进而来；详见 NOTICE 与第三方声明。