docs: 同步 v0.1 backend profile 规格
This commit is contained in:
@@ -21,7 +21,7 @@ UniDesk 与 HWLAB 是 tenant/client。UniDesk 负责平台入口、provider 清
|
||||
- `projectId`,例如 `pikasTech/unidesk` 或 `pikasTech/HWLAB`;
|
||||
- `workspaceRef`,用于定位 source/worktree/workspace;
|
||||
- `providerId`,例如 `G14` 或 `D601`;
|
||||
- `backendProfile`,例如 `codex`、`opencode`、`claudecode`、`host-native` 或 `windows-native`;
|
||||
- `backendProfile`,`v0.1` allowlist 为 `codex` 与 `deepseek`;后续可以扩展 `opencode`、`claudecode`、`host-native` 或 `windows-native`;
|
||||
- `executionPolicy`,包含 sandbox、approval、timeout、network 和 secret scope;
|
||||
- `traceSink`,说明标准化 event 镜像到哪里。
|
||||
|
||||
@@ -51,9 +51,9 @@ Backend adapter 隐藏具体工具协议。Codex stdio JSON-RPC、OpenCode JSON
|
||||
|
||||
AgentRun `v0.1` 自研 runtime 优先使用 Bun + TypeScript:manager、runner、backend adapter、Codex backend、CLI 和后续 scheduler 都按这一技术栈实现。`scripts/agentrun-cli.ts` 是官方 CLI 入口;复杂 CLI 逻辑进入 `scripts/src/`,服务和 runner 逻辑进入 `src/`。YAML manifest、Tekton/Argo CD 配置、Postgres 和 Kubernetes 仍按各自原生生态管理。
|
||||
|
||||
Codex backend 固定采用 Codex CLI app-server JSON-RPC over stdio。实现必须启动受控 `codex app-server --listen stdio://`,执行 `initialize`、`thread/start` 或 `thread/resume`、`turn/start`,并把 stdout/stderr、notification、tool lifecycle、assistant output 和 terminal/error 状态归一化为 AgentRun events。直接 Responses HTTP、OpenAI SDK wrapper、`codex exec` 一次性输出或文本 fallback 不能作为 `v0.1` Codex backend 的正式执行路径。
|
||||
Codex stdio backend 固定采用 Codex CLI app-server JSON-RPC over stdio。实现必须启动受控 `codex app-server --listen stdio://`,执行 `initialize`、`thread/start` 或 `thread/resume`、`turn/start`,并把 stdout/stderr、notification、tool lifecycle、assistant output 和 terminal/error 状态归一化为 AgentRun events。`codex` 与 `deepseek` 是同一个 backend kind 下的 profile/config/SecretRef 选择;直接 Responses HTTP、OpenAI SDK wrapper、`codex exec` 一次性输出或文本 fallback 不能作为 `v0.1` Codex backend 的正式执行路径。
|
||||
|
||||
实现参考优先级:UniDesk Code Queue 的 `src/components/microservices/code-queue/src/code-agent/codex.ts`、`common.ts`,以及 HWLAB v0.2 的 `internal/cloud/codex-stdio-session.mjs`、`scripts/code-agent-chat-smoke.mjs`。AgentRun 复用其协议、trace、redaction、Secret projection 和 failure 分类经验,但不复制 tenant 业务规则、环境专用路径或密钥材料。
|
||||
实现参考优先级:UniDesk Code Queue 的 `src/components/microservices/code-queue/src/code-agent/codex.ts`、`common.ts`,以及 HWLAB v0.2 的 `internal/cloud/codex-stdio-session.mjs`、`scripts/code-agent-chat-smoke.mjs`、`docs/reference/spec-v02-deepseek-proxy.md`、`docs/reference/code-agent-chat-readiness.md`。AgentRun 复用其协议、trace、redaction、Secret projection、profile overlay、DeepSeek/Moon Bridge 分层诊断和 failure 分类经验,但不复制 tenant 业务规则、环境专用路径、bridge host、namespace 或密钥材料。
|
||||
|
||||
## MVP 顺序
|
||||
|
||||
@@ -69,7 +69,7 @@ AgentRun 必须按纵向切片推进,不要一开始大规模并行开发。
|
||||
- `Runner`
|
||||
- `Backend`
|
||||
|
||||
第一切片只要求 `turn`、`interrupt`、`status` 和分页 `events`。不要一开始就做 `steer`、`resume`、judge/retry、UI、多 backend 路由或自动调度。
|
||||
第一切片只要求 `turn`、`interrupt`、`status` 和分页 `events`。不要一开始就做 `steer`、`resume`、judge/retry、UI、跨 backend kind 的自动路由或自动调度。`v0.1` 可做同一 Codex stdio backend kind 下的显式 profile 选择。
|
||||
|
||||
### M1: 最小 Runner 加一个 Backend
|
||||
|
||||
@@ -224,7 +224,7 @@ Control-plane service 应是长驻服务;runner 应是短生命周期 Job 或
|
||||
|
||||
- 迁移 UniDesk Code Queue;
|
||||
- 全局替换 HWLAB Code Agent;
|
||||
- 多 backend 路由;
|
||||
- 跨 backend kind 的自动多 backend 路由;
|
||||
- 最小诊断之外的 UI;
|
||||
- judge/retry 自动化;
|
||||
- 自动扩缩容;
|
||||
|
||||
Reference in New Issue
Block a user