AIDAWORK / ARCHITECTURE

时间盒:超时 · TTL · 配额上界

独立图页 ↗
机制说明(SoT)图是辅读 · 结论以说明与证据为准

本主题只收 钉点上的墙钟/配额合同上界,不讨论多实例扩缩容(见 scaling-roles)。时间盒与失败链/排障地图并列:超时与 TTL 到期常表现为 lease、OCR、本机执行或 SSE 切断,排障入口见 observability-map / FAILURE-CHAINS。

本页可直接往下读完整机制说明,不需要「演示 / 播放故事」。术语不熟先看 术语表。

先读机制说明,结论以说明与证据为准 · 基于固定代码版本核验 · 部署状态另行确认

机制说明(全文)

时间盒:超时、TTL 与配额上界

读法

本主题只收 钉点上的墙钟/配额合同上界,不讨论多实例扩缩容(见 scaling-roles)。时间盒与失败链/排障地图并列:超时与 TTL 到期常表现为 lease、OCR、本机执行或 SSE 切断,排障入口见 observability-map / FAILURE-CHAINS。

层 常量 / 配置 钉点值 含义
Child Run DEFAULT_CHILD_TIMEOUT_MS 600_000(10 min) 必须低于 SSE 墙钟上界(默认 SSE_MAX_DURATION_MS=15 min)
通用工具 TOOL_TIMEOUT_MS → toolTimeoutMs 默认 150_000 读类本机工具继承此值
Desktop 确认对话框 DESKTOP_USER_CONFIRMATION_TIMEOUT_MS 10 min + 30s Skill 变更 apply / 导入对话框预算;不继承通用工具超时(原 DESKTOP_WRITE_TIMEOUT_MS 随 writeFile 删除)
Skill script DESKTOP_SKILL_SCRIPT_RESULT_WAIT_TIMEOUT_MS 30 min runSkillScript:材料核对 + 脚本墙钟 + 回执(原 DESKTOP_BUNDLED_SCRIPT_RESULT_WAIT_TIMEOUT_MS 随 runBundledScript 删除)
LF Operation LOCAL_FILE_OPERATION_TTL_SECONDS 1800 配置可更短,Math.min 钳到 1800;deadlineAt 进请求
LF ResultRef LOCAL_FILE_RESULT_REF_TTL_SECONDS 1800 有界 transient_result,不进 Message/history
OCR 异步 LOCAL_FILE_OCR_ASYNC_TIMEOUT_MS 330_000 Provider poll 300s + settle 余量
OCR 体量 image / document / pages 10 MiB / 16 MiB / 100 页 超限 → size_limit / page_limit
租户配额 QUOTA_TENANT_RPM / RPD 60 / 10_000 请求速率合同上界(env 可改)
LLM token 预留 DEFAULT_RESERVATION_TTL_MS 10 min QuotaService 预留未结算则过期
工具目录发现 CATALOG_DOMAIN_DEADLINE_MS 10_000 / domain 启动时 list + schema 共享期限;超时 TOOL_CATALOG_DISCOVERY_TIMEOUT,不装部分目录(412c7dddc)
Desktop Aida GET fetchAidaJson 15_000 Main 的 fetchAidaJson(含 Skill 目录读取)有界等待(e760819c)
Desktop Skill 选择器 useSkillLibrary 20_000 渲染层兜底,超时标来源不可用并结束 loading

实现存在 ≠ 生产已开;默认 env 与部署覆盖分开判断。

证据(工具目录发现与 Desktop Skill 目录三行,钉点 Agent e2adc9a3c325 / Desktop 8eecd12081db):aida-agent · packages/agent/src/orchestrator/tool-schema-provider.ts L22 · CATALOG_DOMAIN_DEADLINE_MS · e2adc9a3c325;aida-agent · packages/agent/src/orchestrator/tool-schema-provider.ts L193–225 · TOOL_CATALOG_DISCOVERY_TIMEOUT · e2adc9a3c325;aida-agent · packages/agent/src/orchestrator/tool-schema-provider.ts L296–320 · partial catalog · e2adc9a3c325;aida-desktop · apps/desktop/electron/auth/aida-api-client.ts L1621–1625 · fetchAidaJson · 4346d79eb364;aida-desktop · apps/desktop/src/user-skills/useSkillLibrary.ts L23–36 · 20_000 · 4346d79eb364

视图

  • main — 模型/工具/LF/OCR/配额时间盒分层(非扩缩容)。

相关

  • observability-map、FAILURE-CHAINS:超时/TTL 到期后的诊断入口。
  • local-file-v5、local-executor:LF TTL 与 Desktop 写/脚本超时宿主。
  • enterprise-task-e2e:Child Run / lease 失败链。

证据与范围

  • aida-agent · packages/tool-client/src/types/local-files-v4.ts L18–40 · LOCAL_FILE_OPERATION_TTL_SECONDS · e2adc9a3c325
  • aida-agent · packages/agent/src/runtime/local/local-file-v4-tool.ts L599–626 · ttlSeconds · e2adc9a3c325
  • aida-agent · packages/agent/src/orchestrator/agent-as-tool/child-run-orchestrator.ts L271–302 · DEFAULT_CHILD_TIMEOUT_MS · e2adc9a3c325
  • aida-agent · packages/agent/src/config.ts L673–703 · toolTimeoutMs · e2adc9a3c325
  • aida-agent · packages/agent/src/gateway/local-executor-schemas.ts L45–58 · DESKTOP_USER_CONFIRMATION_TIMEOUT_MS · e2adc9a3c325
  • aida-agent · packages/agent/src/runtime/local/local-file-ocr-stream.ts L38–75 · LOCAL_FILE_OCR_ASYNC_TIMEOUT_MS · e2adc9a3c325
  • aida-agent · packages/agent/src/config/services/quota-service.ts L72–102 · DEFAULT_RESERVATION_TTL_MS · e2adc9a3c325

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

机制说明

时间盒:超时、TTL 与配额上界

读法

本主题只收 钉点上的墙钟/配额合同上界,不讨论多实例扩缩容(见 scaling-roles)。时间盒与失败链/排障地图并列:超时与 TTL 到期常表现为 lease、OCR、本机执行或 SSE 切断,排障入口见 observability-map / FAILURE-CHAINS。

层 常量 / 配置 钉点值 含义
Child Run DEFAULT_CHILD_TIMEOUT_MS 600_000(10 min) 必须低于 SSE 墙钟上界(默认 SSE_MAX_DURATION_MS=15 min)
通用工具 TOOL_TIMEOUT_MS → toolTimeoutMs 默认 150_000 读类本机工具继承此值
Desktop 确认对话框 DESKTOP_USER_CONFIRMATION_TIMEOUT_MS 10 min + 30s Skill 变更 apply / 导入对话框预算;不继承通用工具超时(原 DESKTOP_WRITE_TIMEOUT_MS 随 writeFile 删除)
Skill script DESKTOP_SKILL_SCRIPT_RESULT_WAIT_TIMEOUT_MS 30 min runSkillScript:材料核对 + 脚本墙钟 + 回执(原 DESKTOP_BUNDLED_SCRIPT_RESULT_WAIT_TIMEOUT_MS 随 runBundledScript 删除)
LF Operation LOCAL_FILE_OPERATION_TTL_SECONDS 1800 配置可更短,Math.min 钳到 1800;deadlineAt 进请求
LF ResultRef LOCAL_FILE_RESULT_REF_TTL_SECONDS 1800 有界 transient_result,不进 Message/history
OCR 异步 LOCAL_FILE_OCR_ASYNC_TIMEOUT_MS 330_000 Provider poll 300s + settle 余量
OCR 体量 image / document / pages 10 MiB / 16 MiB / 100 页 超限 → size_limit / page_limit
租户配额 QUOTA_TENANT_RPM / RPD 60 / 10_000 请求速率合同上界(env 可改)
LLM token 预留 DEFAULT_RESERVATION_TTL_MS 10 min QuotaService 预留未结算则过期
工具目录发现 CATALOG_DOMAIN_DEADLINE_MS 10_000 / domain 启动时 list + schema 共享期限;超时 TOOL_CATALOG_DISCOVERY_TIMEOUT,不装部分目录(412c7dddc)
Desktop Aida GET fetchAidaJson 15_000 Main 的 fetchAidaJson(含 Skill 目录读取)有界等待(e760819c)
Desktop Skill 选择器 useSkillLibrary 20_000 渲染层兜底,超时标来源不可用并结束 loading

实现存在 ≠ 生产已开;默认 env 与部署覆盖分开判断。

证据(工具目录发现与 Desktop Skill 目录三行,钉点 Agent e2adc9a3c325 / Desktop 8eecd12081db):aida-agent · packages/agent/src/orchestrator/tool-schema-provider.ts L22 · CATALOG_DOMAIN_DEADLINE_MS · e2adc9a3c325;aida-agent · packages/agent/src/orchestrator/tool-schema-provider.ts L193–225 · TOOL_CATALOG_DISCOVERY_TIMEOUT · e2adc9a3c325;aida-agent · packages/agent/src/orchestrator/tool-schema-provider.ts L296–320 · partial catalog · e2adc9a3c325;aida-desktop · apps/desktop/electron/auth/aida-api-client.ts L1621–1625 · fetchAidaJson · 4346d79eb364;aida-desktop · apps/desktop/src/user-skills/useSkillLibrary.ts L23–36 · 20_000 · 4346d79eb364

视图

  • main — 模型/工具/LF/OCR/配额时间盒分层(非扩缩容)。

相关

  • observability-map、FAILURE-CHAINS:超时/TTL 到期后的诊断入口。
  • local-file-v5、local-executor:LF TTL 与 Desktop 写/脚本超时宿主。
  • enterprise-task-e2e:Child Run / lease 失败链。

证据与范围

  • aida-agent · packages/tool-client/src/types/local-files-v4.ts L18–40 · LOCAL_FILE_OPERATION_TTL_SECONDS · e2adc9a3c325
  • aida-agent · packages/agent/src/runtime/local/local-file-v4-tool.ts L599–626 · ttlSeconds · e2adc9a3c325
  • aida-agent · packages/agent/src/orchestrator/agent-as-tool/child-run-orchestrator.ts L271–302 · DEFAULT_CHILD_TIMEOUT_MS · e2adc9a3c325
  • aida-agent · packages/agent/src/config.ts L673–703 · toolTimeoutMs · e2adc9a3c325
  • aida-agent · packages/agent/src/gateway/local-executor-schemas.ts L45–58 · DESKTOP_USER_CONFIRMATION_TIMEOUT_MS · e2adc9a3c325
  • aida-agent · packages/agent/src/runtime/local/local-file-ocr-stream.ts L38–75 · LOCAL_FILE_OCR_ASYNC_TIMEOUT_MS · e2adc9a3c325
  • aida-agent · packages/agent/src/config/services/quota-service.ts L72–102 · DEFAULT_RESERVATION_TTL_MS · e2adc9a3c325

结论来自固定版本的静态源码与合同阅读;实现存在、默认开关和生产启用分别判断。本站代码证据面板列出声明状态与具体限制。

代码证据

引用核验检查固定 commit 的文件与范围;实现结论来自代码阅读。自动检查不证明生产环境已启用。

已核验实现

Local File Operation TTL 与 ResultRef TTL 合同常量均为 1800 秒;OCR 体量上界为 image 10MiB、document 16MiB、最多 100 页。

aida-agentpackages/tool-client/src/types/local-files-v4.ts:29–517f2e519936b57902d4907ed8026fe1ecdd146e82符号:LOCAL_FILE_OPERATION_TTL_SECONDS
已核验实现

local-file-v4-tool 将 binding.operationTtlSeconds 与 LOCAL_FILE_OPERATION_TTL_SECONDS 取 min 后写入 deadlineAt;非法 TTL 抛 LOCAL_FILE_OPERATION_TTL_INVALID。

aida-agentpackages/agent/src/runtime/local/local-file-v4-tool.ts:795–8227f2e519936b57902d4907ed8026fe1ecdd146e82符号:LOCAL_FILE_OPERATION_TTL_SECONDS
已核验实现

Child Run 默认墙钟 DEFAULT_CHILD_TIMEOUT_MS=600_000,注释要求保持低于 15 分钟 SSE 上界。

aida-agentpackages/agent/src/orchestrator/agent-as-tool/child-run-orchestrator.ts:285–3167f2e519936b57902d4907ed8026fe1ecdd146e82符号:DEFAULT_CHILD_TIMEOUT_MS
已核验实现

配置默认 toolTimeoutMs=TOOL_TIMEOUT_MS(150_000)、SSE_MAX_DURATION_MS=15min、租户配额 RPM=60 / RPD=10_000。

aida-agentpackages/agent/src/config.ts:556–5867f2e519936b57902d4907ed8026fe1ecdd146e82符号:toolTimeoutMs
已核验实现

本机等待上界:Skill 变更 / 导入确认对话框用 DESKTOP_USER_CONFIRMATION_TIMEOUT_MS=10min+30s;runSkillScript 结果等待 DESKTOP_SKILL_SCRIPT_RESULT_WAIT_TIMEOUT_MS=30min(覆盖材料核对、脚本墙钟与回执);其余非交互本机读继承 toolTimeoutMs。原 DESKTOP_WRITE_TIMEOUT_MS 与 DESKTOP_BUNDLED_SCRIPT_RESULT_WAIT_TIMEOUT_MS 随 writeFile / runBundledScript 一起删除。

aida-agentpackages/agent/src/gateway/local-executor-schemas.ts:51–647f2e519936b57902d4907ed8026fe1ecdd146e82符号:DESKTOP_USER_CONFIRMATION_TIMEOUT_MS
aida-agentpackages/agent/src/gateway/local-executor-tool-executor.ts:263–2727f2e519936b57902d4907ed8026fe1ecdd146e82符号:DESKTOP_SKILL_SCRIPT_RESULT_WAIT_TIMEOUT_MS
已核验实现

OCR 异步流默认超时 LOCAL_FILE_OCR_ASYNC_TIMEOUT_MS=330_000(provider poll 300s + settle);超页数走 page_limit。

aida-agentpackages/agent/src/runtime/local/local-file-ocr-stream.ts:38–757f2e519936b57902d4907ed8026fe1ecdd146e82符号:LOCAL_FILE_OCR_ASYNC_TIMEOUT_MS
aida-agentpackages/agent/src/runtime/local/local-file-ocr-stream.ts:746–7767f2e519936b57902d4907ed8026fe1ecdd146e82符号:LOCAL_FILE_OCR_DOCUMENT_MAX_PAGES
已核验实现

QuotaService 租户 LLM token 预留默认 TTL 为 10 分钟(DEFAULT_RESERVATION_TTL_MS)。

aida-agentpackages/agent/src/config/services/quota-service.ts:75–1057f2e519936b57902d4907ed8026fe1ecdd146e82符号:DEFAULT_RESERVATION_TTL_MS
已核验实现

启动工具目录发现时限(412c7dddc):tool-schema-provider 每个 domain 的目录发现(list + schema)共享 10s 期限(CATALOG_DOMAIN_DEADLINE_MS),剩余时间作为每次请求的 timeout,超时抛 TOOL_CATALOG_DISCOVERY_TIMEOUT;出错时取消同批其余 schema 请求,不安装部分目录。

aida-agentpackages/agent/src/orchestrator/tool-schema-provider.ts:23–237f2e519936b57902d4907ed8026fe1ecdd146e82符号:CATALOG_DOMAIN_DEADLINE_MS
aida-agentpackages/agent/src/orchestrator/tool-schema-provider.ts:199–2317f2e519936b57902d4907ed8026fe1ecdd146e82符号:TOOL_CATALOG_DISCOVERY_TIMEOUT
aida-agentpackages/agent/src/orchestrator/tool-schema-provider.ts:312–3367f2e519936b57902d4907ed8026fe1ecdd146e82符号:partial catalog
已核验实现

Desktop Skill 目录有界等待(e760819c):Main 的 fetchAidaJson(GET 查询)统一 15s AbortSignal.timeout;渲染层 useSkillLibrary 20s 兜底,超时把 builtin / organization / user 三个来源标为不可用并结束 loading,迟到的真实结果仍可应用。

aida-desktopapps/desktop/electron/auth/aida-api-client.ts:1883–18874346d79eb36402355e51118df0edf1f98586880c符号:fetchAidaJson
aida-desktopapps/desktop/src/user-skills/useSkillLibrary.ts:23–364346d79eb36402355e51118df0edf1f98586880c符号:20_000