imccyu
cbe8735d7c
- Mount WorkspacesService.startInitialSelection in the runtime apply (the one-shot baseline follower shipped in 98633b5aa without a caller): a restored current session wins, an explicit clear stays cleared, a failed connect retries on the next baseline projection. - Cover the policy in client-apply and the assembled workspace-flow snapshot; startup now lands in the recent Workspace's blank session, so the draft-carry scenario starts from the hero directly. - Bring docs along: startup-selection paragraphs in the session-scope RFC note (both languages), bilingual README pairs for the four new client packages, doc-graph regeneration with client-declared events exempt from the dispatcher requirement (client dispatch sites are structurally invisible to the host-side ts.Program), and pairing re-records.
3.5 KiB
@deepseek-ai/dsh-client-ui-command
English | 中文
客户端命令业务面（ctx.command）：以会话为 key 的命令目录缓存、带 matchSpace／matchEnter 裁决钩子的 / 命令 source、三型派发（execute／popupSelect／leadingInput），以及面向业务包的 popupSelect 注册面。契约：Web 命令业务面 Agent Note（agent 决策记录）。
src/client/contract.ts 是冻结的业务表层：CommandServiceContract.register(name, spec) 是业务包消费的全部内容；CommandUiSpec{options, onSelect} 让 popup 数据自给自足——壳组件归本包所有，业务永远见不到它。命令三型按每次派发派生，绝不在注册时定型：带 input 的 host descriptor 是 leadingInput，注册了 CommandUiSpec 的是 popupSelect，其余全部是 execute。
CommandDirectory（src/client/directory.ts）是唯一的 wire 派生缓存，以会话为 key：每个会话恒为 agent-backed，因此 command.list({sessionId}) 是唯一的寻址形状，source 的 scope 出生 warm 钩子会预热该会话的缓存项。缓存项由 commands/changed 类型化事件软失效（重拉在途期间旧快照继续服务），由 connection/reset 硬失效，并以 epoch 把关，被取代的旧拉取永远无法覆盖更新的结果。matchSpace 只凭该缓存同步应答；matchEnter 在 SubmitAttempt 信号上强等缓存，预热失败即拒绝——/ 开头的一行绝不会被静默降级为普通提示词。
PopupSelectController（src/client/popup.ts）是无头的壳状态：PopupSelectView 自行注册进 conversation.input.overlay（SlotMap key 归 ui-conversation 所有；本包只以 type-only 导入引入该声明——没有运行时依赖边）。壳是打开期间持有焦点的瞬态层；onSelect 之后的 token 片段消费在两条分支上都经 consumeTokenSegment 执行（菜单路径做 span CAS，回车路径做裸 token 相等比较），作用于接线层经 bindDraft 绑定的草稿表层。
/client 导出表层是插件主体（apply／inject）、CommandService、目录类和 popup 类及其状态类型，以及冻结的契约类型；壳组件本身是 overlay 注册的内部实现。
模型体验
间接影响，途径是本包的派发与 claim.submit 路径触发的 host command.execute RPC：匹配命中的命令，其 handler 会修改 host 领域状态，其他包再把该状态投影进下一个请求（/plan 的 handler 翻转 plan 模式，其归属包注入 plan:policy 系统提示词 section），而命令行本身、detached result 与所有菜单／notice 渲染都留在客户端，永不进入会话日志。
KV Cache 影响
无直接影响；该包既不组装也不发送提供方请求。它触发的命令 handler 可能改变归属 host 包对下一个请求系统提示词的贡献（某个 section 的出现或消失会替换较早的请求 token，并使提供方前缀从该点起失效），但这一影响由各命令的 host 包拥有并记录。
已知限制与暂缓事项
- popupSelect 壳还没有已上架的业务消费者：模型选择（host
selectModel）是设计的参照用例，将随其自身的功能工作落地；在此之前，壳只由包测试演练。 - 脱离会话后，detached result 的 notice 回退到 console：fire-and-forget 路径经
SessionInput.notify把结果送到触发会话的编辑器；会话拆除后，console 输出行是仅剩的呈现面。