# omp-worker-mcp 文档中心 **`omp-worker-mcp` 完整架构指南、客户端配置、运维参考与 MCP 工具说明。**

English • 简体中文 • 返回根目录 README

--- ## 概述 欢迎查阅 `omp-worker-mcp` 官方文档中心。本目录包含有关 Agent 编排工作流、跨客户端本地 stdio 集成配置、状态生命周期运维管理以及完整 MCP 工具规格的深度技术指南。 如果您需要快速了解项目概况或获取快速起步指引，请访问根目录 [README.zh-CN.md](../README.zh-CN.md)。 --- ## 文档结构与职责划分 为保持文档清晰精简并杜绝内容重复，各技术专题划分如下： | 文档页面 | 主要职责与涵盖范围 | 核心主题 | | :--- | :--- | :--- | | [**作者工作流启用教程与架构参考**](author-workflow.zh-CN.md) | 工作流启用教程、策略模板与架构参考。 | • 工具可用性、直接命名空间访问与选择策略的三层体系
• Codex 专属 `direct_only_tool_namespaces` 配置步骤
• 可复用的项目级策略模板（`AGENTS.md` / `CLAUDE.md`）
• 一次性验证提示词与预期现象
• 主控与 Worker 监督闭环（6 步生命周期）
• 执行策略对比矩阵（直接处理 vs. 单任务 vs. 批量 DAG）
• 作者个人 Gemini / Antigravity 实测体验（明确为非保证参考）
• 发布与撰写工作流的安全准则 | | [**客户端接入与配置指南**](client-configurations.zh-CN.md) | 各类 MCP 主控 Harness 的接入与配置说明。 | • 本地 stdio 兼容性前提条件
• 证据分级支持矩阵（实测验证 vs. 文档可复制 vs. 有条件支持）
• 通用 `mcpServers` JSON 配置模板
• 具体客户端配置（Codex、Claude Code、Cursor、VS Code / Copilot、Windsurf、Continue）
• 官方文档参考链接与直接使用边界 | | [**ChatGPT Secure MCP Tunnel 接入指南**](chatgpt-secure-tunnel.zh-CN.md) | 将网页端 ChatGPT 连接到本机 `omp-worker-mcp` 的远程 Supervisor-Worker 方案。 | • OpenAI `tunnel-client` stdio MCP 接入
• `OMP_WORKER_ALLOWED_ROOTS` 目录白名单
• symlink / junction 逃逸防护
• runtime 健康检查与信任边界 | | [**运维配置与状态生命周期**](operations.zh-CN.md) | 运行时配置、持久化内部机制与日常运维管理。 | • 环境变量完整参考表
• 磁盘状态目录布局（`~/.codex/state/omp-worker`）
• 保留与清理策略（TTL 与磁盘容量阈值）
• 服务器重启、崩溃恢复与进程解耦 | | [**工具参考与安全约束**](tool-reference.zh-CN.md) | 全部 MCP 工具的详细参数、规格与安全协议约定。 | • 单任务委托工具集（`omp_run_compact`、`omp_delegate` 等）
• 批量任务与 DAG 编排工具集（`omp_run_batch_compact` 等）
• 路径所有权隔离规则（`write` vs. `read_only`）
• 结构化结果信封约定（`OMP_WORKER_RESULT`） | | [**官方 MCP Registry 发布指南**](registry-publishing.zh-CN.md) | 针对维护者的 npm 与官方 MCP Registry 发布流程。 | • 核心元数据文件（`package.json`、`server.json`）
• 正式发布执行顺序（npm 发布与 MCP Publisher CLI）
• 版本核验与安全发布边界 | --- ## 快速导航指引 - **初次了解 Agent 委托？** 请阅读 [作者工作流启用教程与架构参考](author-workflow.zh-CN.md)，快速启用项目策略并掌握主控与 Worker 的协同模式。 - **需要配置您的 MCP 客户端？** 请查阅 [客户端接入与配置指南](client-configurations.zh-CN.md) 获取即用配置与模板。 - **要从网页 ChatGPT 调用本机 OMP？** 请阅读 [ChatGPT Secure MCP Tunnel 接入指南](chatgpt-secure-tunnel.zh-CN.md)。 - **管理生产或持续运行环境？** 请查阅 [运维配置与状态生命周期](operations.zh-CN.md) 了解保留清理与状态恢复。 - **编写 Prompt 或开发集成逻辑？** 请参考 [工具参考与安全约束](tool-reference.zh-CN.md) 查阅工具定义与结构化信封规范。 - **发布版本或日常维护？** 请参阅 [官方 MCP Registry 发布指南](registry-publishing.zh-CN.md)。 --- ## 双语同步机制 本目录下的所有文档均严格采用中英文双语 1:1 同步维护： - **英文版本**：`docs/.md` - **中文版本**：`docs/.zh-CN.md`