设计文档
设计文档用于记录实现完成前的目标架构和 API 决策。它们属于开发指南的一部分；除非文档 明确说明某项能力已经实现，否则应把它们视为 proposal。
文档列表
- Function Mode
- Task 执行生命周期
- Agent Sandbox 的 Session Mode
- Runtime Gateway 传输安全与传输边界
- Runtime 就绪状态可见性
- Function Inline Source 物化
- Function Mode 生命周期与 Invoke Dataplane
- Function Runtime Server 协议
- Workflow Data Sharing
- Run Workspace 引用与 Affinity
- Scheduler Framework 与批量规划
- Run 资源记账
- Workflow Reuse
- Job-Level Reusable Workflow Execution
- Dashboard
Dashboard.zh
Dashboard 本文描述 v0.x 的目标设计，当前尚未实现。
kruntimes 应该提供一个小型只读 dashboard，帮助开发者和运维人员理解当前有哪些任务在运行、 哪些任务卡住了，以及如何找到 logs 和 …
Function Inline Source.zh
Function Inline Source 物化 状态：已接受；API 与通用 source preparation 已完成
function-mode Run 可以使用 repository source 或 inline …
Function Mode Lifecycle.zh
Function Mode 生命周期与 Invoke Dataplane 状态：已接受；正在实现
本文细化 Function Mode 和 Agent Sandboxes 中的 function-mode 目标， 定义实现前必须 …
Function Mode.zh
Function Mode 本文描述 v0.x Function-mode 设计及已经实现的 control-plane 和 invoke-dataplane 基线；延后 工作见 roadmap 。Agent sandbox 使用独立的 …
Run Workspace Affinity.zh
Run Workspace 引用与 Affinity 状态：已评审
本文固定 Workflow data sharing 下一项前置能力的 API shape：通用的 Run workspace 引用，以及 Run-to-Run …
Runtime Gateway Transport.zh
Runtime Gateway 传输安全与传输边界 状态：Proposed
问题 共享 Runtime gateway 当前提供已认证但明文的集群内 HTTP endpoint。Run.status.endpoint 支持 …
Runtime Readiness Visibility.zh
Runtime 就绪状态可见性 状态 在 v0.x 中逐步实现。本文在补齐剩余 integration 和 E2E coverage 前定义可观察的 contract。
目标 Operator 需要在 Runtime 层面看到 warm …
Session Mode.zh
Agent Sandbox 的 Session Mode 状态：已接受；正在实现
问题 Run.mode.function 是固定 handler 的 RPC 模型，适合 FaaS 和 tool endpoint，但不是 agent …
Task Execution Lifecycle.zh
Task 执行生命周期 状态：已实现
目标 Task mode 的 Run 会在已分配的预热 Runtime Pod 上执行一次有界的命令或脚本。本文定义 runtimed 中的本地异步工作与 Kubernetes …
Workflow Data Sharing.zh
Workflow Data Sharing 本文描述 v0.x 设计。API prerequisite、RuntimePodLocal binding、scheduler admission、 runtimed workspace …
Workflow Job Reuse.zh
Job 级可复用 Workflow 执行 状态：待评审
本文定义 v0.x 中 job 级可复用 Workflow 的执行边界。
决策 WorkflowRun 只表示带 inline jobs 的一次执行，不在 root 引用可复用 …
Workflow Reuse.zh
Workflow Reuse 本文定义 v0.x workflow reuse model。execution-instance split、template trigger 和 job-level reusable Workflow …
Action Execution
Action Execution 状态：Implemented
本文定义 v0.x Workflow reuse 的 step-level reusable Action execution。它扩展现有的 inline …
Function Runtime Server 协议
Function Runtime Server 协议 状态：已接受；正在实现
本文定义 function-mode Run 的内部 gRPC 协议。它细化了 Function Mode 生命周期与 Invoke Dataplane ，但不改 …
Run 资源记账
Run 资源记账 状态：Accepted；Scheduler 实现中
Runtime capacity 不应只限制并发 Run 数量。Runtime.spec.capacity.resources 已经声明每个 Runtime Pod 的命 …
Scheduler Framework
Scheduler Framework 状态：Accepted；v0.x 实现完成（Filter、Score、Reserve/Assume/Bind、Run 间亲和性和有界可观测性）
本文定义 kruntimes 的目标调度架构。它将当前“ …