cloveric

**4 月 28 日更新：**
从 v4.5.0 或更早版本升级： 更新代码后请刷新已生成的实例指令，让旧 bot 拿到新的短 Telegram Transport block：

telegram instructions upgrade --all --dry-run
telegram instructions upgrade --all
telegram service restart --all

0418 更新，
Changelog

这次更新主要是一次底层整理和稳定性增强，不是新增很多表面功能。

- 重构了 Telegram 主流程，把原本过大的 delivery.ts 拆成多个职责明确的模块，包括命令分发、普通消息处理、错误恢复、响应发送、配置读写等。
- 收口了共享逻辑，统一了 Telegram 和 bus 路径里的 usage 、budget 、audit 、timeline 、错误处理和部分 bookkeeping 行为。
- bus 现在有正式协议层了，补上了结构化 request/response 、错误码、retryable 语义，以及更稳的响应校验。
- 给主要状态文件补了 runtime schema 校验，包括 config.json 、access.json 、session.json 、usage.json 、runtime-state.json 、workflow 状态、bus registry 、audit log 、timeline
log 、instance lock 。
- 新增了 timeline event model ，并把它接到了 dashboard 、service status 、service doctor 和 CLI 查询路径。
- 修复了一批运维和边界问题，包括 stale PID 误报 running 、dashboard 忽略自定义 state dir 、非 JSON bus 响应缺少结构化错误、旧 schemaVersion 写回不升级等。
- 整理了错误分类，把 bus 和运行时错误语义进一步收口，减少子系统各说各话的情况。
- 补了大量 focused tests ，并新增 dashboard / bus handler / runtime state / telegram modules 等测试覆盖。
- 新增和补充了一组项目文档，包括架构说明、状态模型、安全边界、入口地图、bus 协议、event model 、变更规则和发布清单。

0416 更新，
因为 opus4.7 多了 xhigh 的逻辑，所以/effort 匹配了下

0414 更新：

会话续接
在电脑上用 Claude Code 开了个头？发 /resume 就能在 Telegram 上接着干 不用重复解释上下文。

/resume ← Bot 扫描本地最近 1 小时的 session
Bot 列出最近的 session：

最近的本地 session：

[cc-telegram-bridge] 64c2081c… (5m ago)
[my-app] a3f8b21e… (32m ago)
回复 /resume <编号> 继续该 session 。
选一个：

/resume 1 ← Bot 自动建软链、切工作区、绑 session
之后发的每条消息都走原始 session 相同的上下文、相同的项目目录、相同的对话历史。完成后：

/detach ← 清理软链、解绑 session 、恢复默认工作区
底层原理：

扫描 ~/.claude/projects/ 中最近 1 小时内修改过的 .jsonl 文件
在 bot 的 engine-home/projects/ 下创建软链指向本地 session 目录
将工作区切换到你的真实项目路径
绑定 session ID ，Claude CLI 通过 -r <sessionId> 恢复会话
/detach 反向操作 本地 session 不受任何影响
零污染： --append-system-prompt 是每次调用时传入的，不会写进 session 文件。bridge 指令不会泄漏到你的本地会话中。

@ltux 一加手机都不用刷

看用途了啊。。