📄️ 🏗️ 系统架构
本文档详细介绍 Wegent 平台的系统架构、组件设计和技术栈。
📄️ 💻 开发环境搭建
本文档详细介绍如何在本地环境搭建 Wegent 开发环境。
📄️ Dynamic Context（动态上下文注入）
背景
📄️ 测试框架文档
本文档介绍 Wegent 项目的单元测试框架设置。
📄️ 📋 CRD 架构
本文档为开发者提供 Wegent CRD（自定义资源定义）架构的详细技术参考，帮助理解内部结构和实现细节。
📄️ Skill 开发指南
本文档提供 Skill 系统的技术实现细节，包括架构、Provider 开发和 API 参考。
📄️ 协作模式开发指南
本文档提供协作模式的详细配置示例、实战案例和技术实现细节。
📄️ MCP 工具重构指南
English | 简体中文
📄️ 外部知识库 MCP
English | 简体中文
📄️ 技能传递链路
本文描述 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 生命周期，也不会产生聊天消息。
📄️ 全局能力同步
全局能力同步允许 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 路径。
📄️ 任务运行态状态机
背景
📄️ Chat Shell 优雅退出
Chat Shell 的 /v1/responses 是长连接流式接口。Kubernetes 终止 Pod 时，必须先停止新流量，再等待已有流结束，否则用户会看到中断的 SSE 响应。
📄️ 用户运行时配置
English | 简体中文
📄️ Wework macOS 发布
English | 简体中文
📄️ QuickCard 输入预设
概述
📄️ 共享技能目录
Wework 提供“技能”设置页，用于把本地 Claude 和 Codex 的个人技能目录统一到 ~/.agents/skills。该能力面向在线 Claude Code 本地设备，通过本地设备命令 RPC 执行，不在浏览器端直接访问文件系统。
📄️ 🛠️ 开发者指南
English | 简体中文
📄️ 数据库迁移指南
本指南介绍如何使用 Alembic 管理 Wegent 后端应用的数据库迁移。
📄️ OpenTelemetry Setup Guide
This guide explains how to set up and configure OpenTelemetry for distributed tracing and metrics in Wegent.
📄️ 响应式开发指南
概述