INDEX.zh-CN.md

文档索引

English | 简体中文

按你现在想完成的事情选择文档即可。

我想正常使用 WebCodex

• README —— WebCodex 能做什么，以及完整使用和临时试用的区别
• Desktop 安装与连接 —— Windows / macOS 推荐入口：Desktop + 官方 OpenAI Secure Tunnel
• 完整使用指南 —— CLI、已有 Server、Linux 与高级普通 Server + Runner 配置
• AI 辅助接入 —— 让 AI 帮你按普通用户语言完成配置
• MCP —— ChatGPT、Claude 与其他 MCP 客户端

我只想先试几分钟

• 快速试用 —— 一条 webcodex share 临时体验一个仓库

我需要生产部署或深入排障

• 部署指南 —— systemd/Docker、多用户、自托管和长期运维
• Windows + OpenAI Secure MCP Tunnel 深入实操 —— 独立 Windows Server/Runner、Tunnel 与真实故障排查
• Runner —— Runner 运维参考
• CLI —— 完整命令、配置和凭据参考

我需要认证或网络配置

• MCP —— Bearer、query-token 兼容方式、OAuth、私有隧道和 MCP 参考
• 认证模型 —— 详细凭据和权限边界
• 部署指南 —— 稳定 HTTPS、自托管和生产网络配置
• GPT Actions —— 可选的 OpenAPI Custom GPT 集成

我遇到了问题

• 故障排查 —— 安装、连接、运行和 Runner 问题
• 安全说明 —— 安全模型和使用建议

我想理解或扩展 WebCodex

• 架构 —— 主要组件如何协同
• Coding 工作流 —— 任务启动、指导、验证和收尾
• Native Tool Plugins —— 用任意可执行语言为 Runner 增加本地工具，不需要 MCP SDK
• Computer Use roadmap —— semantic-first desktop automation 方向与验证优先级

我想参与开发或发布

下面 docs/agent/ 中的页面属于 maintainer/internal contract。它们会有意保留 protocol field、兼容名称和实现 invariant；普通用户不需要为了使用 WebCodex 而学习 这些内容。

• AGENTS.md —— 面向 coding/AI agent 的仓库开发指引
• 仓库维护 —— 维护队列、依赖更新节奏、PR/CI 约定和双语文档规则
• 测试策略
• 发布清单
• 架构决策
• Runtime host context —— Runner 配置的 planning context 与 runtime diagnostics
• Job 可靠性与 Runner 并发
• Tool request tracing —— maintainer forensic payload/correlation contract
• 权限模型
• 会话模型
• 手动多窗口协作
• OpenAPI 指南
• 发布流程