eve-read-eve-docs

Eve Read Docs（先加载）

用途：提供一份精简、公开且始终可用的 Eve Horizon 系统文档提炼版。无法访问私有系统文档时，请使用此文档。

何时使用

• 任何有关如何通过 CLI 或 API 使用 Eve Horizon 的问题。
• 任何有关 .eve/manifest.yaml、流水线、工作流、作业或密钥的问题。
• 任何有关事件、触发器、Agent、团队、构建或部署的问题。

如何使用

1. 从 references/overview.md 开始，了解核心概念、ID 和参考资料索引。
2. 使用下方的任务路由器，为请求选择最精简的参考资料集。
3. 只打开相关的参考文件，避免加载无关文档。
4. 在提供具体命令前，先询问缺失的项目或环境信息。

任务路由器（渐进式访问）

• 平台概览、环境 URL、架构、Eve Dashboard、系统应用模式：references/overview.md
• 命令语法、标志和 CLI 工作流（包括 cloud-fs、endpoint、ingest、traces、env logs --follow/--filter、env diagnose --request、eve tcp-ingress test、eve app-links、eve admin email bounces list [--recipient|--event-type|--limit|--json]、eve org invite --project --redirect-to、eve project auth-context 命令）：references/cli.md
• 细分 CLI 主题：
  • references/cli-auth.md（身份验证 + 访问权限 + 策略）
  • references/cli-org-project.md（初始化、组织/项目设置、文档、文件系统同步）
  • references/cli-jobs.md（作业和执行控制、按作业设置 harness/env 覆盖、通过 --with-links 注入应用链接、通过 jobs.token_scope 限定范围的作业令牌）
  • references/cli-pipelines.md（构建、发布、流水线、工作流）
  • references/cli-deploy-debug.md（部署、恢复、本地栈、CLI 故障排查、env logs 跟踪/筛选、env diagnose --request、traces 查询）
• 清单编写、配置结构、应用 CLI 框架、跨项目应用链接（x-eve.app_links）、工具链声明、云 FS 挂载、按组织配置 OAuth、应用取消部署/删除、自定义域名、公共 TCP 入口（x-eve.tcp_ingress）、稳定出口（hostNetwork v2）、工作流 env_overrides + 条件步骤 + 步骤级 harness/harness_options + 步骤级 git 控制 + 重试尾部 + 文件引用 + Slack 通知 + 资源引用策略、由清单驱动的服务令牌权限、x-eve.branding（徽标/颜色/发件人名称）、x-eve.auth.login_method（magic_link）、x-eve.auth.self_signup、x-eve.auth.invite_requires_password、x-eve.auth.org_access、x-eve.auth.domain_signup v2 规则列表（[{domain, target_org, role}]）、x-eve.auth.allowed_redirect_origins、jobs.token_scope 维度（orgfs/orgdocs/envdb/cloud_fs）：references/manifest.md
• 流水线、工作流、触发器、事件驱动自动化、自动触发、事件/应用/应用链接触发器、工作流输入转发、步骤优化、按步骤配置 with_apis、工作流 env_overrides + 条件步骤 + 步骤级 harness + 失败重试 + 文件引用 + Slack 通知、事件→触发器可观测性（trigger_match_count、triggers_evaluated）、限定范围的作业令牌（将工作流/步骤/调用范围的交集应用于 jobs.token_scope）：references/pipelines-workflows.md + references/events.md
• 作业生命周期、调度、执行调试、Agent 原生监控、生产环境强化、按作业隔离 HOME、按作业设置 harness/env 覆盖、应用链接环境变量/CLI 注入、学习循环（system.job.attempt.completed、上下文延续）、防止作业卡住 + 过期恢复 + 环境门控范围、限定范围的作业令牌（jobs.token_scope 维度：orgfs/orgdocs/envdb/cloud_fs）：references/jobs.md
• 构建、发布和部署行为：references/builds-releases.md + references/deploy-debug.md
• 私有端点（Tailscale）、按需加载工作器工具链、应用取消部署/删除、自定义域名故障排查（首次绑定优先、cert-manager TLS、eve domain list|verify|status|transfer|unbind|remove）、公共 TCP 入口诊断、稳定出口（hostNetwork v2）、DeployFailure 分类 + 集群快照 + 部署引用中的 manifest_hash + eve env diagnose、Platform Sentinel（环境健康监控 + Slack 告警）：references/deploy-debug.md
• Agent、团队、聊天路由、嵌入式应用对话、Agent 别名、分阶段分派、聊天投递、聊天进度、结构化对话事件流（cevt_*）、通过 Eve thr_* ID 保持聊天连续性、聊天正则表达式不区分大小写、Agent 学习循环钩子、Agent 运行时自动发现组织（无需 org_default）：references/agents-teams.md + references/gateways.md
• 密钥、身份验证、访问控制、身份提供商、自带模型密钥（BYOK）凭据、按组织存储 OAuth 凭据、由清单驱动的服务令牌权限 + 自动注入 EVE_SERVICE_TOKEN（默认只读）、应用链接令牌（type: app_link）、SSO 自助注册电子邮件域名限制（EVE_SIGNUP_ALLOWED_EMAIL_DOMAINS）、按 Agent 设置的 envdb 通配符范围（内置角色）、应用 magic-link 登录选择启用（x-eve.auth.login_method: magic_link）、magic-link 确认中间页（封装令牌；防止扫描器在未请求时兑换）、domain-signup v2 规则列表（[{domain, target_org, role}]）、项目级重定向允许列表（x-eve.auth.allowed_redirect_origins）、平台保证自定义域名应用的 eve_sso 会话 Cookie 使用 SameSite=None：references/secrets-auth.md
• 技能安装、包、解析顺序、物化快速路径 + .agents/skills/ 规范化 + 稀疏包支持 + eve skills materialize 运行时路径：references/skills-system.md
• Harness 选择、沙盒策略、自带模型密钥（BYOK）设置、共享调用、按需加载工具链、聊天 harness 配置文件、按作业覆盖 harness（--harness-override-file）+ 覆盖环境变量（--env-override）、harness 配置文件验证端点、聊天提示传播、Phase 4 步骤模板表达式、Codex 推理 + harness 模型规范化、Opus 4.7 + GPT-5.5 模型注册：references/harnesses.md
• 对象存储、组织文件系统同步、共享令牌、公共路径、GCS 存储、云 FS（Google Drive）、应用存储桶凭据隔离：references/object-store-filesystem.md
• 文档摄取（上传、处理、下载、回调）：references/ingest.md
• 文档摄取流水线（端到端流程、agentpack、媒体处理、聊天文件、doc.ingest 工作流触发器可靠性修复）：references/document-ingestion.md
• Eve SDK 概览、安装、快速入门、令牌流程、嵌入式对话、聊天 SDK、导出、结构化对话事件流、通过 thr_* ID 保持聊天连续性、品牌化应用登录模式、useEveAppAccess()、通过 POST /auth/app-invites 在应用内发送管理员邀请：references/eve-sdk.md
• Auth SDK 深入介绍、@eve-horizon/auth、@eve-horizon/auth-react、应用 SSO 中间件、令牌验证、项目角色解析和组织感知、magic-link 登录 SDK 选择启用、domain-signup v2 SDK 行为、magic-link 确认中间页对 EveAuthProvider 透明：references/auth-sdk.md
• 为应用 API 构建便于 Agent 使用的 CLI、清单声明、打包、分发、环境变量约定：references/app-cli.md
• OAuth 应用凭据（BYOA）、Google Drive 挂载、云 FS 浏览/搜索、简化 Slack 安装流程、网关热加载、按组织配置 OAuth、聊天文件物化、集成、Slack 连接、GitHub 设置、身份关联、成员资格申请、API 聊天提供商（对轮询客户端无操作；4 个内置提供商：slack、nostr、webchat、api）、应用组织访问 + 在应用内发送管理员邀请（POST /auth/app-invites、eve org invite --project --redirect-to、eve project auth-context）、应用品牌化邀请和 magic-link 电子邮件（通过 x-eve.branding 配置徽标、颜色、发件人名称）、项目级重定向允许列表：references/integrations.md + references/gateways.md
• 可观测性、请求诊断、服务日志（eve env logs --follow、--filter k=v）、跟踪（eve traces query）、eve env diagnose --request <req_id>、成本跟踪、凭证、分析、事件→触发器可观测性（trigger_match_count、triggers_evaluated、eve event show）、SES 邮件发送可靠性（发送前抑制检查、退信 webhook、email_delivery_events 表、eve admin email bounces list [--recipient|--event-type|--limit|--json]）：references/observability.md
• 数据库配置、迁移、SQL、托管数据库操作、托管数据库 TLS 信任（默认 verify-full + 注入 CA bundle）：references/database-ops.md
• 涵盖身份验证、密钥、部署、作业、构建的症状优先故障排查、DeployFailure 分类 + diagnose、Platform Sentinel 告警解读、防止作业卡住 + 过期恢复、SES 邮件丢失（抑制 / 退信 / email_delivery_events）、未收到 magic-link 或邀请邮件、magic-link 确认中间页的预期行为、自定义域名的 SameSite=None Cookie、重定向允许列表不匹配、限定范围的作业令牌被拒、domain-signup v2 迁移：references/troubleshooting.md
• LLM Wiki 模式、维护 Wiki 的 Agent、知识库架构、近乎即时的索引、CLI 增强（eve docs patch、diff、watch、sync、list --tree、search --path/--context、批量写入）：references/llm-wiki.md

Index

• references/overview.md -- 架构、核心概念、ID、作业阶段、BYOK 推理、文档摄取、云 FS、私有端点、Eve Dashboard + 系统应用模式、参考索引。
• references/cli.md -- CLI 快速参考：按类别列出所有命令及其标志和选项，包括 cloud-fs、endpoint、ingest、traces query、env logs --follow/--filter、env diagnose --request、eve tcp-ingress test、eve app-links、eve admin email bounces list [--recipient|--event-type|--limit|--json]、eve org invite --project --redirect-to 和 eve project auth-context 命令。
• references/manifest.md -- Manifest v2 规范：服务、环境、流水线、工作流、x-eve 扩展、应用 CLI 框架、跨项目应用链接（x-eve.app_links）、工具链声明、云 FS 挂载、按组织划分的 OAuth、应用取消部署/删除、自定义域名、公共 TCP 入口（x-eve.tcp_ingress）、稳定出口（x-eve.networking.egress: stable）、工作流 env_overrides + 条件步骤 + 步骤级 harness/harness_options + 步骤 Git 控制 + 重试尾部 + 文件引用 + Slack 通知 + 资源引用策略、由 manifest 驱动的服务令牌权限、x-eve.branding（徽标/颜色/发件人名称）、x-eve.auth.login_method: magic_link、x-eve.auth.self_signup、x-eve.auth.invite_requires_password、x-eve.auth.org_access、x-eve.auth.domain_signup v2 规则列表 [{domain, target_org, role}]、x-eve.auth.allowed_redirect_origins、jobs.token_scope 维度（orgfs/orgdocs/envdb/cloud_fs）。
• references/events.md -- 事件类型目录（所有来源 + 负载）和触发器语法（github、slack、system、cron、manual、app_link）。
• references/jobs.md -- 作业生命周期、阶段、CLI、Git/工作区控制、调度提示、Agent 原生监控、生产环境加固、按作业隔离 HOME、按作业设置 harness/env 覆盖、应用链接环境变量/CLI 注入、学习循环（system.job.attempt.completed、上下文延续、user 记忆类别）、防止作业卡住 + 过时作业恢复 + 环境门控范围（仅操作类作业）、通过 jobs.token_scope 限定作用域的作业令牌（维度：orgfs/orgdocs/envdb/cloud_fs）。
• references/builds-releases.md -- 构建系统（规范、运行、制品）、发布、部署模型、晋级模式。
• references/agents-teams.md -- Agent/团队/聊天 YAML 架构、同步流程、slug 规则、嵌入式应用对话、Agent 别名、分阶段团队调度、聊天出站投递、聊天进度更新、调度模式、协调线程、结构化对话事件流（cevt_*）、通过 thr_* ID 保持聊天连续性、聊天正则表达式不区分大小写、Agent 学习循环钩子、Agent 运行时组织自动发现。
• references/pipelines-workflows.md -- 流水线步骤、触发器、工作流调用、自动触发、事件/应用触发器、工作流输入转发、步骤优化、按步骤设置 with_apis、构建-发布-部署模式、env_overrides + 条件步骤 + 步骤级 harness + 步骤 Git 控制 + 失败重试 + 文件引用 + Slack 通知 + 资源引用策略、事件→触发器可观测性（trigger_match_count、triggers_evaluated）、作用域受限的作业令牌（工作流/步骤/调用作用域的交集会应用于 jobs.token_scope）。
• references/secrets-auth.md -- 密钥作用域、插值、身份验证模型、身份提供方、OAuth 同步、服务主体、访问可见性、自定义角色、策略即代码、BYOK 模型凭据、按组织存储 OAuth 凭据、由 manifest 驱动的服务令牌权限 + 自动注入 EVE_SERVICE_TOKEN（默认只读）、应用链接令牌（type: app_link）、SSO 自助注册电子邮件域名限制（EVE_SIGNUP_ALLOWED_EMAIL_DOMAINS）、按 Agent 设置的 envdb 通配符作用域、应用魔法链接登录选择启用（x-eve.auth.login_method: magic_link）、魔法链接确认插页（包装令牌；防止扫描器意外兑换）、domain-signup v2 按规则设置列表（[{domain, target_org, role}]）、项目级重定向允许列表（x-eve.auth.allowed_redirect_origins）、平台保证自定义域名应用的 eve_sso 会话 Cookie 使用 SameSite=None。
• references/skills-system.md -- Skills 格式、skills.txt、安装流程、发现优先级、快速物化路径 + .agents/skills/ 规范化 + 稀疏包支持 + eve skills materialize 运行时路径。
• references/deploy-debug.md -- K8s 架构、工作器映像、部署轮询、入口/TLS、密钥配置、工作区清理器、私有端点（Tailscale）、按需工作器工具链、应用取消部署/删除、CLI 调试工作流、实时调试、特定环境调试、自定义域名调试（先绑定优先、cert-manager TLS、eve domain 子命令）、公共 TCP 入口诊断、稳定出口（hostNetwork v2）、DeployFailure 分类 + 集群快照 + 来自部署引用的 manifest_hash + eve env diagnose、Platform Sentinel（环境健康监控 + Slack 警报）。
• references/harnesses.md -- Harness 选择、配置档案、身份验证优先级、沙盒标志、BYOK 模型设置、共享 invoke 模块、按需工具链、聊天用 harness 配置档案、按作业覆盖 harness（--harness-override-file）+ 覆盖环境变量（--env-override）、harness-profile-validation 端点、聊天提示传播、Phase 4 步骤模板表达式、Codex 推理 + harness 模型规范化、Opus 4.7 + GPT-5.5 模型注册。
• references/gateways.md -- 网关插件架构、Slack + Nostr + webchat + API 提供方（内置 4 种）、线程键、结构化对话事件流（cevt_*）、通过 Eve thr_* ID 保持聊天连续性、嵌入式应用对话、API 聊天提供方（对轮询客户端不执行操作）。
• references/cli-auth.md -- CLI 身份验证、服务账户、访问角色和策略即代码。
• references/cli-org-project.md -- 用于设置组织/项目、文档、FS 同步和解析器 URI 的 CLI 命令。
• references/cli-jobs.md -- CLI 作业生命周期：创建/列出/更新、尝试跟踪、结果/监控/附件、应用链接注入（--with-links）、按作业覆盖 harness（--harness-override-file）+ 覆盖环境变量（--env-override）、通过 jobs.token_scope 限定作用域的作业令牌（维度：orgfs/orgdocs/envdb/cloud_fs）。
• references/cli-pipelines.md -- CLI 构建/发布/流水线/工作流命令参考。
• references/cli-deploy-debug.md -- CLI 环境部署/恢复/生命周期和本地 k3d 栈、env logs --follow/--filter、env diagnose --request、traces query。
• references/object-store-filesystem.md -- 对象存储、组织文件系统同步协议、共享令牌、公共路径、应用存储桶、访问控制、原生 GCS 存储、云 FS（Google Drive 挂载）、应用存储桶凭据隔离。
• references/ingest.md -- 文档摄取生命周期：上传、处理、下载 URL、回调、CORS、事件集成。
• references/document-ingestion.md -- 文档摄取流水线：端到端流程、ingest:// URI 方案、agentpack、媒体处理（ffmpeg + whisper）、聊天文件物化、集成点、doc.ingest 工作流触发器可靠性修复。
• references/eve-sdk.md -- Eve SDK 概览：身份验证 + 聊天包、安装、快速入门模式、令牌流程、嵌入式对话窗格、后端/前端导出、环境变量、结构化对话事件流、通过 thr_* ID 保持聊天连续性、品牌化应用登录模式、useEveAppAccess()、通过 POST /auth/app-invites 在应用内邀请管理员、应用魔法链接登录选择启用。
• references/auth-sdk.md -- Eve Auth SDK 深入介绍：中间件行为、验证策略、令牌类型、SSO 会话引导、NestJS 模式、项目角色解析、组织感知、迁移指南、魔法链接登录 SDK 选择启用、domain-signup v2 SDK 行为、对 EveAuthProvider 透明的魔法链接确认插页。
• references/integrations.md -- OAuth 应用凭据（BYOA）、Google Drive 云 FS 挂载、简化 Slack 安装流程、网关热加载、按组织划分的 OAuth、聊天文件物化、外部集成（Slack、GitHub）、身份解析层级、成员资格申请、CLI 链接、应用组织访问 + 应用内邀请管理员（POST /auth/app-invites、eve org invite --project --redirect-to、eve project auth-context）、应用品牌化邀请和魔法链接电子邮件（通过 x-eve.branding 设置徽标/颜色/发件人名称）、项目级重定向允许列表。
• references/observability.md -- 关联 ID、应用服务日志（eve env logs --follow、--filter k=v）、请求诊断（eve env diagnose --request）、跟踪（eve traces query）、执行回执、成本跟踪、分析、OTEL 配置、提供方发现、事件→触发器可观测性（trigger_match_count、triggers_evaluated、eve event show）、SES 邮件服务可靠性（发送前抑制检查、退信 webhook、email_delivery_events 表、eve admin email bounces list [--recipient|--event-type|--limit|--json]）。
• references/database-ops.md -- 托管数据库配置、迁移、SQL 访问、架构/RLS 检查、扩展/重置/销毁、托管数据库 TLS 信任（默认 verify-full + 注入 CA 证书包）。
• references/app-cli.md -- 应用 CLI 框架：manifest 声明、环境变量约定、打包、分发、用于跨项目应用链接的映像模式 CLI、实现模式。
• references/troubleshooting.md -- 按症状排列的身份验证、密钥、部署、作业、构建、网络问题诊断表、DeployFailure 分类 + eve env diagnose、Platform Sentinel 警报解读、防止作业卡住 + 过时作业恢复、SES 邮件丢失（抑制/退信/email_delivery_events）、魔法链接或邀请邮件缺失、魔法链接确认插页预期、自定义域名 SameSite=None Cookie、重定向允许列表不匹配、作用域受限的作业令牌遭拒、domain-signup v2 迁移。
• references/llm-wiki.md -- LLM Wiki 模式：双层基底、Agent 工作流、近乎即时的索引、操作（摄取/查询/检查/批量）、CLI 增强（eve docs patch、diff、watch、sync、list --tree、search --path/--context、批量写入）、与 Company as Intelligence 的关系。

Intent Coverage Matrix

意图	最少参考文档	预期输出
进行身份验证或检查权限	references/cli-auth.md、references/secrets-auth.md	会话状态、令牌／权限验证结果
初始化组织／项目资源	references/cli-org-project.md、references/manifest.md	组织／项目 ID、成员、清单同步状态
提交并监控工作	references/cli-jobs.md、references/jobs.md	作业 ID、阶段转换、尝试日志
构建／部署版本	references/cli-pipelines.md、references/builds-releases.md、references/pipelines-workflows.md	流水线运行 ID、构建／发布产物、部署跟踪
从运行时问题中恢复	references/cli-deploy-debug.md、references/deploy-debug.md、references/cli-jobs.md	诊断输出、恢复目标、缓解命令计划
跟踪已部署应用的请求	references/observability.md、references/cli-deploy-debug.md、references/deploy-debug.md	请求日志、部署元数据、K8s 事件、审计记录、跟踪跨度
检查平台行为或事件	references/events.md、references/agents-teams.md	规范事件流视图、路由路径
为 Agent 安装／更新技能	references/skills-system.md、references/overview.md	已安装的包／技能集及解析顺序
监控成本、收据或分析数据	references/observability.md、references/cli.md	收据明细、分析计数器、成本总额
配置或运维环境数据库	references/database-ops.md、references/manifest.md	迁移状态、查询结果、托管数据库状态
同步文件、分享链接或配置组织文件系统	references/object-store-filesystem.md、references/cli-org-project.md	同步状态、分享令牌、公开路径 URL
通过摄取上传、处理或下载文档	references/ingest.md、references/document-ingestion.md、references/events.md	摄取 ID、下载 URL、回调负载、处理状态
配置摄取 Agent 包或媒体处理	references/document-ingestion.md、references/agents-teams.md	包导入、配置文件选择、媒体工具可用性
了解 Slack 文件如何传递给 Agent	references/document-ingestion.md、references/gateways.md	聊天文件流转、附件索引、工作区布局
为应用添加 SSO 身份验证或验证令牌	references/eve-sdk.md、references/auth-sdk.md、references/secrets-auth.md	SDK 设置代码、令牌验证、SSO 流程
添加嵌入式 Agent 对话面板	references/eve-sdk.md、references/agents-teams.md、references/gateways.md	对话 API 结构、SDK 设置代码、路由策略、流恢复行为
配置 OAuth 应用凭据或连接 Google Drive	references/integrations.md	BYOA 配置状态、挂载 ID、浏览／搜索结果
连接 Slack／GitHub 或解析外部身份	references/integrations.md、references/agents-teams.md	集成状态、身份绑定、成员资格请求
为应用 API 构建便于 Agent 使用的 CLI	references/app-cli.md、references/manifest.md	CLI 源代码、esbuild 包、清单声明、已测试的命令
连接 Google Drive 或浏览云 FS	references/object-store-filesystem.md、references/integrations.md	挂载 ID、浏览／搜索结果、云 FS 事件触发器
设置私有端点（Tailscale）	references/deploy-debug.md、references/cli.md	端点名称、集群内 DNS、健康检查状态
声明或使用工具链	references/manifest.md、references/harnesses.md	工具链列表、初始化容器配置、PATH 设置
设置 Agent 别名或个性化名称	references/agents-teams.md	别名绑定、slug 解析、同步验证
检查聊天送达状态或进度	references/agents-teams.md、references/gateways.md	送达状态、线程消息、进度更新
配置工作流的事件或应用触发器	references/pipelines-workflows.md、references/events.md	触发器配置、事件负载转发、匹配的工作流
取消部署或删除应用／环境	references/deploy-debug.md、references/manifest.md	部署状态、清理顺序、级联删除
配置 BYOK 模型凭据	references/secrets-auth.md、references/harnesses.md	密钥作用域、harness 环境映射、提供商密钥
设置每个组织的 OAuth 凭据（BYOA）	references/integrations.md、references/manifest.md	OAuth 应用配置、提供商连接、凭据存储
配置 GCS 原生存储	references/object-store-filesystem.md	存储后端配置、Workload Identity 绑定
使用 Agent 原生工具监控作业	references/jobs.md、references/cli-jobs.md	作业状态、监控输出、生产环境防护措施
设置分阶段团队调度（council）	references/agents-teams.md	团队配置、分阶段标志、负责人／成员协调
在工作流中配置每个步骤的 with_apis	references/pipelines-workflows.md、references/manifest.md	步骤覆盖项、API 注入、工作流级默认值
在身份验证 SDK 中解析项目角色	references/auth-sdk.md、references/secrets-auth.md	项目角色声明、X-Eve-Project-Id 标头、中间件配置
为已部署应用配置自定义域名	references/cli.md、references/manifest.md、references/deploy-debug.md	域名注册、DNS 验证、TLS 激活
绑定自定义域名	references/manifest.md、references/deploy-debug.md	域名绑定、先绑定者优先行为、cert-manager TLS 状态
暴露或诊断公共原始 TCP 监听器	references/manifest.md、references/deploy-debug.md、references/cli.md	x-eve.tcp_ingress 配置、监听器状态、TCP 探测结果
根据症状诊断故障	references/troubleshooting.md、references/deploy-debug.md	根本原因、修复命令、恢复路径
按作业覆盖 harness 或环境	references/cli-jobs.md、references/jobs.md、references/harnesses.md	覆盖文件路径、环境键、已验证的 harness 配置文件
验证 harness 配置文件	references/harnesses.md	验证结果、规范化模型、沙箱／身份验证检查
在工作流中配置条件式或步骤级 harness	references/pipelines-workflows.md、references/manifest.md	步骤 harness／harness_options 块、条件表达式、env_overrides
诊断部署失败	references/deploy-debug.md、references/troubleshooting.md	DeployFailure 代码、集群快照、manifest_hash、诊断输出
配置稳定出站流量（hostNetwork）	references/manifest.md、references/deploy-debug.md	x-eve.networking.egress: stable 配置、源 IP、Pod 放置位置
解读 Platform Sentinel 警报	references/troubleshooting.md、references/deploy-debug.md	警报来源、环境健康探测、Slack 消息、补救措施
流式传输服务日志或按 JSON 键筛选	references/observability.md、references/cli-deploy-debug.md	实时日志流、筛选后的键／值匹配结果
端到端诊断单个请求	references/observability.md、references/cli-deploy-debug.md	请求时间线、跨度、日志、req_* 的 K8s 上下文
从 CLI 查询 OTEL 跟踪	references/observability.md、references/cli.md	跟踪查询结果、跨度树、延迟明细
通过 thr_* ID 继续 Eve 线程	references/agents-teams.md、references/eve-sdk.md	线程恢复调用、对话连续性、结构化事件流
从 CLI 编辑、比较或监视 wiki 文档	references/llm-wiki.md	eve docs patch/diff/watch/sync 流程、近乎即时的索引状态
限制按电子邮件域进行 SSO 自助注册	references/secrets-auth.md	EVE_SIGNUP_ALLOWED_EMAIL_DOMAINS 配置、允许列表行为
在作业运行时物化技能	references/skills-system.md	eve skills materialize 调用、.agents/skills/ 布局、稀疏包子集
使用 Agent 学习循环／job.attempt.completed	references/jobs.md、references/agents-teams.md	事件负载、延续上下文、user 记忆写入
采用系统应用模式（部署平台层级的应用）	references/overview.md	模式定义、系统应用边界、指向 fullstack-app-design 的交叉链接
配置由清单驱动的服务令牌	references/secrets-auth.md、references/manifest.md	权限范围、自动注入的 EVE_SERVICE_TOKEN、只读默认值
验证托管数据库 TLS 信任	references/database-ops.md	verify-full 默认值、CA 包注入路径、连接字符串
分离应用存储桶凭据	references/object-store-filesystem.md	应用存储桶凭据作用域、隔离边界
为应用启用无密码的 magic-link 登录	references/secrets-auth.md、references/manifest.md	x-eve.auth.login_method: magic_link 配置、中间页流程、SDK 行为
按电子邮件域将用户自动注册到具有指定角色的组织（路径 C）	references/secrets-auth.md、references/manifest.md	x-eve.auth.domain_signup v2 规则列表 [{domain, target_org, role}]、已应用的角色
允许邀请／magic-link 后重定向到自定义域名的应用源站	references/secrets-auth.md、references/manifest.md	x-eve.auth.allowed_redirect_origins 配置、允许的源站匹配
为应用的邀请和 magic-link 邮件添加品牌标识	references/integrations.md、references/manifest.md	x-eve.branding 徽标／颜色／发件人名称、品牌邮件预览
向新用户发送应用内管理员邀请	references/integrations.md、references/eve-sdk.md	POST /auth/app-invites 调用、eve org invite --project --redirect-to、重定向目标
检查 SES 退信或被抑制的收件人	references/observability.md、references/cli.md、references/troubleshooting.md	eve admin email bounces list 输出、email_delivery_events 记录、抑制状态
将作业令牌限制为特定路径或挂载	references/jobs.md、references/pipelines-workflows.md、references/manifest.md	jobs.token_scope 轴（orgfs／orgdocs／envdb／cloud_fs）、工作流／步骤交集
诊断未收到 magic-link／邀请邮件的问题	references/troubleshooting.md、references/observability.md	email_delivery_events 记录、抑制／退信原因、中间页预期
将域名注册清单从 v1 迁移到 v2	references/manifest.md、references/secrets-auth.md	将字符串列表替换为 [{domain, target_org, role}] 规则列表、每条规则的角色

硬性规则

• Eve 以 API 为先；CLI 只需要 EVE_API_URL。
• 不要假设 URL、端口或环境状态——如果不清楚，请先询问。
• 这些参考资料仅描述已发布的平台行为。
• 如果有任何信息缺失或不清楚，请询问缺少的输入。