Import docs/codex-remote.md
This commit is contained in:
parent
33541752aa
commit
3f4a52173a
|
|
@ -37,7 +37,13 @@ Host 可以使用 `thread/list` 已返回的绝对 `cwd` 精确生成只读后
|
|||
新建 Thread 的目录只能来自上述 authority root 内的真实子目录。Host 必须同时执行词法路径校验和
|
||||
`realpath` 校验,拒绝 `..`、符号链接逃逸和 Client 自报的越界路径,也不得推测共同父目录。
|
||||
|
||||
## 数据映射
|
||||
## 实现与内存投影
|
||||
|
||||
Host 实现在 `packages/plugin/src/codex/`,Client 经 `CodexRemoteClient` 和每连接 bridge 访问固定 App Server 方法。Desktop 虚拟 carrier 不得将未知方法回落到本机 Harness。VS Code 当前不提供 CodeX 会话入口。
|
||||
|
||||
Workspace 使用 `codex-workspace:project:`,Session 使用 `codex:<threadId>`;这些 ID 仅定位,不授予目录或 Thread 权限。Remote 不读取 `~/.codex` 私有 JSONL/SQLite,也不建立第二份数据存储。
|
||||
|
||||
|
||||
|
||||
Desktop 端会把 Codex Thread 映射成临时 DSH Session,把 History 和实时 frame 映射成原生 Session
|
||||
事件。Android 端直接消费同一 Codex 领域,并只在移动端内存中生成展示投影。
|
||||
|
|
@ -47,7 +53,7 @@ Thread 状态和模型切换。Web Search、Subagent、Image、Compaction 和 Re
|
|||
大段实时工具输出只保留有界内存窗口;文件 patch 只传递路径和变更类型,不把原始 diff 写成
|
||||
Workspace 文件内容。
|
||||
|
||||
History 由 Host 按 DSH 消息边界分页后再传输。Client 只在当前可见 Thread 的标题、预览、目录和
|
||||
History 优先使用 Host 分页 `dsh/sessionHistory`,旧 App Server 才回退到 `thread/read(includeTurns:true)`;不能把失败当空历史。Host 按 DSH 消息边界分页后再传输。Client 只在当前可见 Thread 的标题、预览、目录和
|
||||
标识中做本地搜索。
|
||||
|
||||
## 操作与权限
|
||||
|
|
@ -71,7 +77,7 @@ Harness 日志或第二份 Codex 数据存储。
|
|||
|
||||
## 配置
|
||||
|
||||
Codex 默认开启,可在 DeepSeek Remote 设置卡片中关闭,修改后需要重启 DSH。
|
||||
Codex 默认开启,可在 Remote 的 Agent 后端设置中关闭。保存后热更新该后端,不需要重启整个 DSH。
|
||||
|
||||
```yaml
|
||||
ds-harness-remote:
|
||||
|
|
@ -83,11 +89,19 @@ ds-harness-remote:
|
|||
`binary` 必须指向支持 `codex app-server` 的 Codex CLI。在 macOS 保持默认 `codex` 时,Plugin 会先
|
||||
尝试当前 ChatGPT App 内置的 Codex,再回退到 `PATH`;显式配置的 binary 始终原样使用。
|
||||
|
||||
已有安装若仍使用旧的 `dsh-remote` 设置命名空间,Plugin 会一次性复制到 `ds-harness-remote`,同时
|
||||
保留旧配置作为回退。
|
||||
旧 `dsh-remote` 设置不再自动导入;已有旧配置应通过本机设置界面重新配置。身份与凭据目录迁移属于另一流程,见[接入指南](plugin-integration.md)。
|
||||
|
||||
## 当前验证状态
|
||||
|
||||
Codex Remote 已完成 Desktop 跨机、Android 真机、Web → Host、多客户端观察、大 History、Prompt、
|
||||
approval、interrupt 和图片分块的真实设备验证,但仍以实验功能发布。后续恢复策略、跨平台矩阵和
|
||||
长期稳定性以 [TODO](TODO.md) 为准;不应把 TODO 中的目标能力描述为已完成。
|
||||
|
||||
|
||||
## Files、Terminal 与生命周期
|
||||
|
||||
`codex-workspace-bridge.ts` 将 Thread cwd 解析为独立工具 scope,不把 CodeX ID 当作 Harness agent,也不扩大 App Server allowlist。只读文件和终端使用固定 workspaceFiles / terminal 语义;路径、realpath、符号链接、尺寸、设备归属与连接输入权仍在 Host 校验。
|
||||
|
||||
CodeX / ACP 共用 Host `RemoteTerminalController`。有 subprocess 支持时使用 PTY;pipe fallback 不支持 resize 或 job control。屏幕恢复使用有界 xterm 快照,不回放原始输出;断线释放输入权而保留已提交进程,后端重配或关闭则等待清理。只有无持有者/follower 且持续明确 idle 两小时才回收,unknown/busy 不回收。具体字段及限额统一见[协议](protocol.md#codex-session-workspace-and-terminal-scope)。
|
||||
|
||||
切换 Host/领域、注销、断线或关闭后端清理对应内存载体、stream、pending waiter 和审批。热更新只影响变化的后端;迟到结果不能更新新实例,也不重放不确定 mutation。
|
||||
|
|
|
|||
Loading…
Reference in New Issue