@flg1217/dsh-subagent-codebuddy

Overview

CodeBuddy CLI (Tencent) as a dsh LLM provider via ACP: selectable as a main-agent model (the ACP CLI owns the turn and its tools) and as a subagent backend through the generic subagent tool; exposes the CLI model catalog via listModels().

README / EN

Package documentation

Registry summary

dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.

Read the full README on GitHub

LIMITATIONS

Known limitations

- **压缩卡必然出现在一轮对话的尾部**。ACP 协议不报压缩事件（`session/update` 只有 `agent_message_chunk` / `agent_thought_chunk` / `tool_call` / `usage_update` 等类型，没有 `compact` 或 `summary`）。CLI 的压缩发生在 ACP run **内部**（收到 prompt → 检查压力 → 压缩 → 落盘 → 处理 → 流式返回），对 dsh 完全不可见。镜像层只能 tail CLI 的会话文件（`~/.codebuddy/projects/<slug>/<acpId>.jsonl` 里的 `{"type":"summary","providerData":{"source":"periodic"}}` 记录），而该记录的落盘是惰性的。所以卡片最早只能在 `turn-stopping`（turn 收尾）弹出—— 这是 dsh 能读到新摘要的最早时机。除非 CLI 在 ACP 协议里增加压缩通知，否则无法更早。 - **上下文容量环（ContextMeter）不会在压缩时立即下降**。容量环显示的是 `contextPressure` 投影的 `projectedTokens`，而 `pressureTokens` 只在 CLI 上报 `usage` chunk 时更新。压缩镜像是纯逻辑写（零模型调用、零 usage 事件），不产生 `usage` → 容量环停在最后一次请求的值，直到**下一轮请求**上报 usage 才降到新值。这是设计后果，不是 bug。 > 压缩卡**不会隐藏或删除任何历史消息**：被遮蔽的消息照常渲染，dsh 的历史接口不做过滤。 > 压缩改的是 dsh 的 **surface**（上下文压力表，以及插件需要重建 CLI 上下文时的素材 > `buildPrompt` / 原生 seed）。 **启动自检与告警**（不会再静默失效）：插件装载时自检接管是否真的落到实例上，dsh 升级若改了压缩入口，控制台会出现 `[subagent-codebuddy/compact] …未生效/未安装` 的 warn；正常接管时每个 codebuddy 会话播报一次 `已接管 <sessionId> 的 dsh 压缩`；镜像成功时播报 `[subagent-codebuddy/mirror] 已把 CodeBuddy CLI 的压缩镜像到 dsh 会话 <id>…`。

@flg1217/dsh-subagent-codebuddy