OpenProgram Docs

工程改进待办#

跨专项分支的已完成状态、未合并实现和后续实施顺序统一记录在 OpenProgram implementation status and handoff。 本文件只保留尚未定案、需要讨论后再排期的改进项。

本文只收当前仍需要讨论后再动的项，按影响排序。历史审计日期、一次性计数和已修复 问题不作为当前状态依据；讨论定案一条就删除对应条目。

打包 / 分发#

  1. provider.json 损坏被静默吞掉：providers/_provider_meta.py 读 provider.json 时静默吞异常，数据文件损坏（而非缺失）表现为 "provider 列表为空且无报错"。

前端#

  1. window.* 退役（state-layer 阶段 3）：仍有多处旧状态入口，需按 state-layer 设计逐步收敛。四组： W.currentSessionId 路由闸门 39 处、window.conversations 20 处、 W.isRunning 9 处（最便宜，runningTasks 已覆盖）、 window.__sessionStore 38 处。另有 30+ 处 window.dispatchEvent 无类型字符串事件总线（阶段文档未列的第五类）。按设计文档这是阶段 2 完成后的事，规模大，需专项排期。
  2. WS 层用无类型 CustomEvent 二次广播 store 帧 （apps/web/lib/net/use-ws.ts 六处）：与 store 平行的第二条状态通路， detail 无类型。属于 window.* 退役的同族问题，可并入 window.* 退役专项。

模块规模（>1400 行且多职责，重构窗口另排）#

  1. 前端两个大文件已拆完。剩余为 Python 侧的多职责模块，具体行数不在本设计文档中 固定；排期时应以当前源码和职责边界重新测量。 当前候选包括 openprogram/agentic_programming/runtime.py、 openprogram/store/session/session_store.py、openprogram/agentic_programming/call_state.py、 openprogram/auth/cli.py 和 openprogram/programs/_runtime.py。 apps/cli/src/runtime/ 下的 yoga-layout 与 ink 运行时属 vendored 移植代码， 不算多职责问题。

回归核验清单#

原仓库缺陷快照混合了已修行为、未证实观察和功能提案，在此合并为核验清单，不表示每项当前仍有缺陷。创建实施任务前，需要在当前源码和公开 UI 入口复现；完成状态写回对应主题的正式设计。

范围 需要核实的行为 代码或入口
回退 Web 在确认后携带 plan hash 和 idempotency key 提交 apply；缺少结果时给出可操作状态 ws_actions/chat.py、_rewind.py、message-actions.tsx、slash-commands.ts
命令发送 WebSocket 未连接时不把命令视为成功，不清空草稿 wsSend、输入框提交
斜杠命令 输入 / 打开菜单不会意外执行压缩；空 /skill 名称和 /task 提示有校验反馈 slash-commands.ts
菜单交互 收起动画不拦截回车或历史上下键；必填参数保持可编辑 selectSlashCommand、输入框键盘处理
会话要求 没有会话时反馈原因，不静默清空输入 输入框与斜杠命令
上下文压缩 忙碌、建议、完成、失败、无变化状态可见；必要时先 compact 后 snip；reactive compact/snip 也有反馈 loop_runner.py、reactive.py、chat-handlers.ts
上下文历史 压缩保留旧轮次及 DAG head；snip 只改下一次请求 history；摘要展开需要可视核验 上下文详情与聊天记录
Help 与 doctor Help 打开并聚焦菜单；doctor 在有无会话时均有明确的结果展示 /help、/doctor
控件重叠 跳到最新按钮和斜杠菜单在实际位置可用，不能仅凭 z-index 判断遮挡 聊天 UI
附件 不支持或过大的文件明确反馈 image-attach.ts
桌面启动 窗口以预期布局出现，不出现从角落调整大小的过程 已安装 App
CLI 恢复 resume 参数将正确会话传入 Ink runtime apps/cli/python/openprogram_cli/_impl/ink.py、apps/cli/src/index.tsx
SSO、语音与插件隔离 文档区分已实现方法/provider 与未实现入口；community 插件执行符合隔离合同 auth/methods/sso.py、tts.py、plugins/sandbox.py、plugin loader
函数恢复 区分原帧恢复与新建兄弟重试；间接调用循环符合递归约束 ws_actions/chat.py、agentic_programming/call_state.py
函数元数据 动态 metadata 和源码字面量声明符合表单合同 函数表单与元数据文档
分发 Linux 桌面产物、升级失败恢复、Workflow 手动发布与沙箱行为门禁符合安装文档 安装、源码升级、Workflow 发布
命令注册表 重名命令有明确解析顺序，菜单无歧义 runCommand 与命令菜单

闲时自动压缩仍属于产品决策，不默认作为缺陷；环境变量探测不能替代文档规定的 AuthStore 边界。外部 issue 数量与旧快照提交号不作为当前正确性的证据。

Last updated · 2026-10-10
PreviousDocumentation gapsNextUI unification