Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
HANDOFF — 状态条 P0 实现(断点续传用)
给"被清空上下文后的我 / 接力者"看。读完这份 +
agent-progress-status-bubble.md(完整 spec) 就能无损继续。 恢复方法:先git -C <worktree> diff看已改动,再看下方"进度"与"任务清单(TaskList)",从第一个未完成任务继续。
环境
- Worktree:
/essd/qiqi/code/dev/avibe/.agents/worktrees/agent-progress-status-bubble - 分支:
feat/agent-progress-status-bubble,基于alex/master(remotealex= github.com/avibe-bot/avibe)。 - 完整设计:
docs/plans/agent-progress-status-bubble.md(已定稿,含 §1-§12 + 评审折回)。 - 工作目录命令一律用绝对路径或
git -C,避免 cd 权限弹窗。
目标(两诉求)
- 不污染消息列表:一轮跑完只剩一条结果,无过程残渣。
- 推理状态可感知:长时间无新内容也能看出没挂。 仅 Slack / Discord(支持编辑)。其余平台回退现状、行为 byte-identical。
锁定决策(不要再推翻)
- concise = Slack/Discord 首版直接默认。
- Edit 优先:状态条 edit 成 Result;Delete 仅"过程溢出成2+条"时删多余的。
- 过程状态条 = 单行替换(不 append/不 split/不 continued-below);正文 = 当前动作标签。
- 持久化不变:store 仍存完整 process 行 + result 行;可视清理 ≠ 删数据。
- 计时是 P1 心跳驱动;P0 不带计时(静态
⏳ 思考中/🔧 <动作>)。 - 可感知=分层:进程心跳(已运行计时) + 后端存活探针 + 无输出提示 + ⏳ 保留(P1)。
评审必守(codex 两轮)
- B1 后端探针按后端分流:Claude
controller.receiver_tasks[key].done();CodexCodexTransport.is_alive(transport.py:157-164)。心跳落 agent 内、对外暴露backend_alive(context)->bool。(P1) - B2 concise 下抑制 processing_indicator 的 ack 消息/reaction,仅留 typing;注意 Slack
supports_message_indicator_delete=False,ack_mode=message 时不抑制会永久残留。 - B3 result 6 路径只有 inline 与 edit 干净;其余(split/summary+.md/fallback/失败通知)在另发后必须清理孤儿状态条。
- S1 ✅已做:
base_formatter.to_status_label()安全清洗(去反引号/首行/截断)。 - S2 新增
_consolidated_overflow_ids: dict[str,list[str]],并在_clear_consolidated_state清。 - S3 取消心跳(await)→再 edit result,不能塞 finally;stop/error 路径也取消。(P1)
- S4 Slack
edit_message返回 bool!edit 成功后primary_message_id = 已知气泡 id,不可取返回值。 - S5 dispatcher 侧 per-message
asyncio.Lock字典,把 cancel-heartbeat→edit-result 整段原子化。 - N1 last_activity 按 turn-key 存;N3 P0 无计时;N4 心跳 edit 包
try/except CancelledError。
关键落点(worktree 实测行号)
core/message_dispatcher.pyConsolidatedMessageDispatcher.__init__状态字典 @114-117emit_agent_message@539;result 分支 @697-891;process 块(assistant/toolcall/system) @893-1027_clear_consolidated_state@225-230;_get_consolidated_message_key附近_supports_message_editing@420;_send_unconsolidated_log_message@517- split/threshold helpers @359-377
modules/im/formatters/base_formatter.py:to_status_label(已加,顶部)、format_toolcall@374modules/im/slack.py/modules/im/discord.py:edit_message(Slack 返回 bool)、带按钮 edit、typingcore/processing_indicator.py:start()/_candidate_modes()(B2 抑制点)modules/agents/claude_agent.py:handle_message@79、receiver_tasks填充@123-126、toolcall emit@~611
实现切片(= TaskList)
- T1 落点核对
- T2
to_status_labelhelper + 实测 - T3 过程路径→单状态条一行替换(concise,Slack/Discord)
- T4 edit_message 带按钮 + dispatcher per-message 锁(S4/S5)
- T5 result 情况1 edit-into-result + 孤儿清理(B3) + indicator 抑制(B2)
- T6 单测 + ruff
- 后续 P1:心跳/计时/后端探针/无输出提示;P1 长结果切分首段 edit;P2 溢出删多余条。
如何判断 concise 生效(实现内部用)
平台是否 slack/discord + _supports_message_editing 为真 + progress_style!=off。建议加一个 _use_concise_status(context) 私有判定,集中口径。
测试 & lint
- 单测:
python3 -m pytest tests/<file> -q(worktree 内)。新测放tests/。 - lint:
ruff check <changed.py>(push 前必跑)。 - 不重启本地 vibe;跨平台人工验证用 Incus(用户触发"回归测试"时)。
提交规范
- commit:
type(scope): summary。先不 push,除非用户要求。已在 feature 分支。
进度日志(每步追加)
2026-06-24: 建 worktree(alex/master) + 带入 spec + 落点核对 +
to_status_label落地实测通过。下一步 T3。2026-06-24: P0 核心完成(未提交,feature 分支工作区)。
base_formatter.to_status_label():安全单行标签(去反引号/首行/截断,保留下划线)。message_dispatcher:新增_progress_style/_concise_progress_style/_render_concise_status/_concise_status_bubble_id/_edit_bubble_into_result/_tidy_orphan_status_bubble;__init__加_consolidated_overflow_ids;_clear_consolidated_state清 overflow。- process 块:Slack/Discord 走单状态条一行替换(concise 默认;off=无气泡;verbose/其他平台=旧路径不变)。
- result 分支:case1 edit-into-result(S4 用已知气泡 id),非 inline/edit 失败时孤儿气泡收成 ✅(B3)。踩坑修复:曾把原
if/elif/else投递链拆成两个if导致 consumed=True 时落到 summary 误发第二条——已改成if status_bubble_consumed: pass / elif ...重新接好链。 - 测试:
tests/test_message_dispatcher_status_bubble.py10 passed;既有 dispatcher 套件 61 passed(无回归);ruff 全过。 - 验证用 python:
/essd/qiqi/code/dev/avibe/.venv/bin/python -m pytest <file> -q(worktree 内uv run会因缺 ui/dist 构建失败,别用)。
2026-06-24: P0 已 commit
e72cb385。2026-06-24: P1 完成(未提交→见下条)。
message_dispatcher:注入时钟self._now(可测);per-turn_status_started_at/_status_last_activity_at/_status_heartbeat_tasks。- footer:
_format_elapsed/_status_footer_text(运行⏳ m:ss、完成✅、后端死⚠️、久无输出提示)/_compose_with_footer(Discord-#、Slack 斜体小字)/_compose_status_message。 - 心跳:
_start_status_heartbeat/_status_heartbeat_loop(~30s, turn-token+bubble 守卫,CancelledError安全)/_status_heartbeat_render_once(走 consolidated lock 串行 render↔heartbeat = S5 等效)/_stop_status_heartbeat。 - S3:result 分支在任何 edit 前
await _stop_status_heartbeat(key);_clear_consolidated_state也先停心跳(在取锁前,避免与 heartbeat render 抢同一 lock 死锁)再清 timing。 - 完成 footer:edit-into-result 用
_compose_status_message(done=True, result_body=display_text)→答案\n\n_✅ m:ss_;孤儿 tidy →✅ m:ss。持久化/SSE 仍用干净 display_text(footer 仅在 IM edit)。 - B1 探针 hook:
_backend_dead→controller.backend_alive(context)(None/缺失=不判死,安全)。注意:controller.backend_alive 尚未实现 → ⚠️ 暂不会真正触发;需后续在 controller 落地按后端分流(Claudereceiver_tasks[key].done()/ Codextransport.is_alive)。 - i18n:
status.backendUnresponsive/status.noOutputFor加到 en.json/zh.json。 - 测试:status_bubble 套件 17 passed(含 footer/心跳 render/S3 停心跳);既有 dispatcher 61 passed;ruff 全过。
2026-06-24: Loop 续作(commit 链):
f8cdd29dStep A — backend_alive 真正生效(base/claude/service/controller 分层探针;Codex 暂 None)。+8 tests。2954e6fbStep C — 长结果(Discord)首段 edit 进气泡(case2);_send_split_result_messages加edit_first_message_id。71165875评审修复(codex 全量 diff 评审 issues-found → 已修):- Blocker:heartbeat render 吞了
CancelledError→_stop永久 hang → 改为raise;心跳循环改为每 tick 读当前 bubble id(一 turn 一 task,re-send 不丢计时)。 - split 后续 chunk 失败不再外抛(否则首段已发却被判未消费→孤儿 ✅ 覆盖已发内容)。
suppress_delivery结果路径补孤儿气泡 tidy。clear_consolidated_message_id补停心跳+清 timing。- +2 回归测试(cancel-mid-edit 能终止;split 后续失败保留首段)。
- Blocker:heartbeat render 吞了
- 全量:status_bubble 套件 + backend_alive + result_fallback/platform_limits/scheduled = 74 passed;ruff 全过。
目标达成(P0/P1):两诉求(不污染列表 + 状态可感知)在 Slack/Discord 已端到端实现、评审、修复、测试。
2026-06-24: 全设计目标 loop(每步过 opus+codex 双验收):
a8c3bb5aStep B — progress_style + 心跳/无输出阈值接 V2 config + controller getters + config_to_payload(防 partial-save 丢失) + 上下界 cap。0c6b6dbeStep E — concise 下 indicator 行为:保留 👀 received-ack reaction + typing keepalive,仅抑制 ack 消息(它会重复状态条且 Slack 删不掉);Controller.uses_concise_status_bubble单一真源。逻辑在start()的 concise 分支(reaction+typing best-effort),非 first-wins。ad0af1c0Step D — Codex backend_alive(transport.is_alive);删不可达 overflow 脚手架。d82aa567Step F — footer 下沉适配器:Slack context block / Discord-#;core 改传 (body, footer);base 抽象加subtext,Multi 仅 set 时转发(不破坏其它适配器)。- 每步 opus(general-purpose)+codex-expert 双评审,blocker/should-fix 当轮修复并加回归测试。
b030d757Web UI 开关 — Messaging 设置页 CompactSelect(精简/详细/关闭) foragent_progress_style,i18n en/zh,npm run build通过。opus+codex ACCEPT(修复了编辑碰撞误删的appShell.moreSettings)。设计目标状态:spec 全部目标(后端 + 前端)已完成并逐轮 opus+codex 验收,共 12 commits。
- 注意:Web UI 子代理误改了主 checkout(master 工作区);已把 3 个 UI 文件搬回 worktree 并
git checkout还原 master,worktree ui 用软链 node_modules 重新 build 验证。
- 注意:Web UI 子代理误改了主 checkout(master 工作区);已把 3 个 UI 文件搬回 worktree 并
运行测试:worktree 内
/essd/qiqi/code/dev/avibe/.venv/bin/python -m pytest ... -p no:cacheprovider;UI buildcd ui && npm run build(node_modules 为指向主 checkout 的软链,gitignore)。未推送/未发 PR(按用户明确约束,等其指示)。
历史/已被取代的"剩余"清单(多已完成,仅留档):
- B 设置 plumbing:
progress_style(concise/off/verbose)+心跳/无输出阈值 接 V2 config + Web UI(现 dispatcher 已用安全默认 concise;getter 缺失即降级)。需动 config schema + React UI = 独立 PR 量级。 - E B2 indicator 抑制:仅
ack_mode=message(非默认)才双信号;依赖 B 的 progress_style 解析。 - D case3 溢出删多余条:状态条天生单行短、几乎不溢出 → 极低价值;
_consolidated_overflow_ids已预埋。 - F Slack context-block footer:现用斜体小字近似,可升级为
[section,context]。 - Codex backend_alive:transport 解析后接
is_alive(现 None 安全)。 - (原始遗留) controller.backend_alive —— 已在 Step A 实现。
- Slack context block footer:当前用斜体小字近似;可升级为
[section, context](评审 B5)。 - Discord footer 字节预算:edit-into-result 给 display_text 追加 footer ~15B,理论上 +footer 可能逼近 2000;当前 within_limit 用 1900 字符判定,余量足够,但严格起见可在判定时预留 footer 字节。
- B2 indicator 抑制:concise 下抑制 ack 消息/reaction。默认 Slack ack=typing 无双信号,故 P0 不阻塞;待
progress_style设置 plumbing 落地后随 P1 一起做(注意 Slacksupports_message_indicator_delete=False的 ack 残留)。 - P1:心跳(已运行计时)+后端分流探针(B1)+typing 保活+"无输出"提示+取消心跳→edit 顺序(S3)+per-message 锁(S5,心跳并发才需要)+计时 footer(Discord
-#/Slack context block)。 - P1:result 情况2(长结果切分首段 edit)。P2:情况3(溢出删第2+条,用
_consolidated_overflow_ids)。 - 设置 plumbing:
get_progress_style_for_context目前 controller 未实现 →_progress_style默认 concise;待接 V2 config/Web UI(concise/verbose/off + heartbeat/no_output 阈值)。 - 未 commit(按规范等用户指示)。建议 commit msg:
feat(im): concise status bubble for slack/discord (P0)。
- B 设置 plumbing: