Developer Guide

📄️ 📋 CRD 架构

本文档为开发者提供 Wegent CRD（自定义资源定义）架构的详细技术参考，帮助理解内部结构和实现细节。

📄️ Skill 开发指南

本文档提供 Skill 系统的技术实现细节，包括架构、Provider 开发和 API 参考。

📄️ 技能传递链路

本文描述 Wegent 在不同执行场景中的技能选择、解析、传递与消费方式，重点说明为什么技能相关逻辑必须由 backend 统一收敛，以及 sandbox / 本地设备为什么不能只依赖技能名称。

📄️ 实体权限扩展

本文档介绍 Wegent 的统一资源分享权限架构，涵盖当前授权机制、权限处理逻辑、扩展架构设计，以及如何通过 IExternalEntityResolver 接入内部定制化授权系统。

📄️ 对外暴露能力指南

本文档介绍 Wegent 项目中对外暴露功能能力的标准方式，以 Knowledge Base MCP 实现为例，说明如何让你的功能被 AI Agent 调用。

📄️ 预执行钩子

预执行钩子允许您在 Executor 执行任务之前运行自定义脚本。这对于自定义初始化、安全检查、环境设置或与外部系统集成非常有用。

📄️ 本地运行时任务

Wework 的本地运行时任务用于展示和继续用户已经在设备上创建的 Codex 或 Claude Code 工作。它不再把这些工作导入中心库的 TaskResource 或 Subtask，也不再依赖 Backend projects 表生成侧栏列表。列表来自在线设备 executor 返回的运行时线程，并在前端展示为两类：

📄️ 运行时清理

运行时清理接口用于手动清理长时间无更新的执行环境。它只删除运行时 Pod/容器，不删除 Backend 中的 Task 记录和历史消息。

📄️ 本地设备命令 RPC

本地设备命令 RPC 允许 Backend 向指定在线 local executor 设备下发一条预配置的本机 shell 命令，并等待命令完成后拿到结果。该能力用于运维检查、工作区诊断和后端主动探测，不参与 Task/Subtask 生命周期，也不会产生聊天消息。

Connector Apps 让 Wework 在不修改 Codex 源码、也不依赖 ChatGPT 登录的前提下连接组织内部系统。上游既可以是 MCP Server，也可以是普通 HTTP API。系统把“App”拆成三个独立职责：Wegent Admin 管理定义、可见范围和固定请求头，Wegent Backend 读取 kinds 中的 ConnectorApp 资源并适配上游协议，Executor 向 Codex 统一暴露本地 MCP。Wework 不提供 Connector 设置页面，只在连接 Wegent 云端后同步可用能力。

📄️ 全局能力同步

全局能力同步允许 Backend 将用户启用的 Skill、Plugin 和 MCP 下发到在线 local executor 设备。Project task 可以复用这些本机能力，非 Project task 继续使用任务级 .claude 配置目录，保持隔离。

📄️ 交互表单 Defer 流程

本文档说明 interactiveformquestion MCP 工具的标准渲染和恢复流程。该流程用于让 Agent 在执行过程中向用户展示结构化表单，并在用户提交后通过后续消息继续执行。

📄️ 沙箱工作区归档

沙箱工作区归档用于在 Sandbox runtime 被 24 小时空闲清理删除前保存文件状态，并在同一 Task 后续重新对话时恢复到新建的 Sandbox runtime。该机制复用现有 executor Pod 工作区归档链路，executor 与 sandbox 都使用 home/ 和 workspace/ 两个归档根目录，并通过 runtime_type 选择运行时 home 路径。