feat: 桥接 prompt/enhance 进 ACP (同步 + 异步 job)

[tizerluo]

背景

ZCode App 3.3.0（CLI 仍 0.15.0）引入 prompt/enhance 协议方法族——让外部调用方能用 ZCode 内置的"提示词增强"能力。本 PR 把它桥接进 ACP bridge，同步 + 异步两种模式全做。

协议契约（从 glm/zcode.cjs 二进制挖出）

方法	性质	行为
prompt/enhance	同步 RPC	阻塞返回 {enhanced: string}
prompt/enhance/start	异步 job	立即返回 {requestId, accepted}，结果由 server 推送
prompt/enhance/result	server 推送通知（非 client 可调）	{requestId, status, enhanced?, errorMessage?}
prompt/enhance/cancel	RPC	{requestId, cancelled: bool}

实现

packages/acp-bridge/zcode-acp-bridge（+168 行）

• 同步 prompt/enhance：照 workspace/generateText 模板，timeout=90（比 generateText 的 60s 宽裕，因 enhance 含 prompt 构造 + 清洗）
• 异步 prompt/enhance/start：转成 ACP 阻塞语义——先注册 listener 再 start（参考 session/prompt "先 subscribe 再 send" 教训），阻塞等待 result 通知（120s 兜底），收到 completed/failed/cancelled 后返回
• prompt/enhance/cancel：纯透传 requestId
• ZCodeBackend 新增 enhance result 通知路由：仿 _response_queues 模式，reader 收到 prompt/enhance/result 按 requestId 路由到等待中的 start；reader 退出时唤醒所有等待中的 enhance queue 防止永久挂起

packages/agent-help/zcode-agent-help

• version_described: App 3.2.1 → App 3.3.0
• key_methods + acp_methods_implemented 补 prompt/* 分组

README.md

• 扩展方法表加 prompt 级小节
• 版本兼容性表加 App 3.3.0 行（澄清：CLI 仍 0.15.0，但 prompt/* 是 App 3.3.0 引入）
• 新增 MCP 规范兼容性说明：阐述 stdio + 2024-11-05 是有意识的稳定选择，非落后

测试

• 158 passed（143 原有 + 15 新增，0 失败）
• ruff 全过（ruff==0.15.17）
• exec bit 全 100755（perms CI job 会复核）
• 真实 e2e（3.3.0 + GLM-5-Turbo，非 mock）：
  • 同步 prompt/enhance：「帮我写个函数」→ 50 字精确提示词 ✅
  • 异步 prompt/enhance/start：「分析这段代码」→ 74 字专业审查提示词 ✅

风险与边界

• 异步通知漏失：listener 在发 start 之前注册，消除竞态窗口；若无人等待则进 _notification_queue 兜底
• 超时：同步 90s、异步 120s，均比模型层 AbortSignal.timeout 兜底宽裕
• 不触碰用户 config/credentials：纯协议透传

验证清单

• python3 -m pytest tests/ -q → 158 passed
• ruff check → All checks passed
• exec bit → 100755
• 真实 e2e 同步 + 异步两条路径
• 双引擎 deep review（drive-claude + drive-codex）

Refs: ZCode App 3.3.0 (CLI 0.15.0)