HYD

我从 joye 的站点与 QQ 群交流获得启发，先后构建了 qqbot 与跑在 Telegram 上的 personal agent，并持续长期使用。文章记录了动机（不为做而做，标准是"明天还会不会用"）、qb 从基础问答到课表定时任务与娱乐模式的过程、qb 与 pa 因受众不同而采取的不同权限与放手程度、pa 通过后台调度连接其他 coding agent 只汇报最终结果、pa 与 qb 的桥接、给 agent 邮箱并让它自主注册账号（人机验证仍需人完成）、harness 的设计原则（不是越复杂越好，能用→常用→好用）、桥接层的陷阱（用关键词概率匹配模拟理解会随需求腐化，能力被吸入桥接层后将不可组合、不可观察），以及对产品定位的回答（区别不在功能，而在于长期积累的私有记忆与数据归属）。

精读 Anthropic 工程博客两篇：《Code execution with MCP》与《Effective harnesses for long-running agents》。前篇讲用代码执行给上下文瘦身（渐进披露、沙箱内处理数据、Skills 固化），后篇讲长程 agent 跨 session 的交接方案（initializer + coding agent、特征清单、git/progress、端到端测试）。两篇共同指向一条演进线：agent 从 LLM + 工具走向 LLM + harness。

精读 Anthropic 工程博客三篇：《Building effective agents》《How we built our multi-agent research system》《Effective context engineering for AI agents》。按“演化线”整理——上篇工具与编排模式、中篇多 Agent 系统的工程实现、下篇上下文工程，末尾归纳三次表态。

一份来自三个实现的 Agent 工程笔记。CoreCoder 是 Python 手写的最小实现，Claude Code 是生产实现，learn-claude-code 是教学实现。内容覆盖 Agent Loop 的流转条件与中断修复、工具定义与文件编辑策略、上下文注入与三档压缩、QueryEngine 的长期状态、并行工具与子 Agent、Hook 与 Task 扩展点、多 Agent 协作、记忆 / MCP / 后台任务 / 定时任务，以及路径与命令的安全防线。

一份 Transformer 的学习笔记，按先整体再拆件的顺序整理：编码器与解码器的数据流；学大模型前需要回答的三个问题（神经网络、注意力机制、PyTorch 组成）；Token、词嵌入矩阵与位置编码各自解决什么问题；Q、K、V 的含义，Q·K 点积为什么代表相关性，softmax 前为什么要除以维度的平方根；自注意力与交叉注意力的区别，以及交叉注意力为什么不需要掩码；训练时并行预测多个 token 而推理时逐 token 生成，因此需要因果掩码防止偷看，做法是把后文置为负无穷再经 softmax 变成 0；前馈网络、多头注意力与层归一化的定义，包括层归一化与批量归一化在归一化维度上的差别。

结合 Anthropic《When to fold subagents into your main agent loop》与自己搭 personal agent、qqbot 的经验，主张 harness 的重量该放在描述、模型连续性和端到端验收上：同一能力有三种落点（子 agent 直接面对用户 / 主 agent 用 tool 调子 agent / 折成 skill + tool），越折越小但越重；边界应按上下文需不需要其他部分来切，而不是按职责切；子 agent 只保留在上下文膨胀、真并行、工具冲突三种场景，写代码派给后台 coding agent 的「一次性工人」用法不算折叠对象；动手顺序是先建端到端 eval，一次折一个，看哪些任务翻转。

基于 learn-claude-code 教学项目的模块笔记扩写（笔记写于 2026 年 6、7 月，2026 年 10 月整理成文）。内容沿最小工具调用循环展开：Agent Loop 的消息协议细节（tool_use_id 关联、单轮多工具调用、停止条件）；工具 schema/handler 分离与 safe_path 内层边界；权限三道闸门、拒绝即反馈；Hook 四事件与首个非 None 短路语义；Todo、Task System、Memory 三种状态对比及各自的校验与生命周期；任务文件持久化、锁内原子领取与依赖解锁；background/cron/team 事件统一在轮次边界作为新用户消息交付；队友状态机、IDLE 先处理消息再领任务、Task→Assignment→CWD 绑定与轮次边界释放；带 request_id 与 work_version 的审批、关机协议；worktree 的 fail-closed 与部分失败处理；MCP 命名与动态工具池、Skill 渐进式披露、Goal Loop 的验收缺口。明确标注哪些是教学实现、哪些尚未完成，文末附项目链接。

对 CSDN 时期内容的总结：前期集中在 Python、Numpy / Pandas 与数据分析、可视化和几个比赛项目，后期转向 Transformer、LLM 与 Agent（工具调用、Agent Loop、MultiAgent、Prompt / Context / Harness、Claude Code、提示词注入防御、Agent checkpoint）；从 2026 年 9 月起把博客写在自己的站点上，CSDN 的旧文保留但不再更新。

两三家小厂面试的复盘。项目一条是 agent、一条是 LLM，题目也落在这两处：GQA 为什么好（MHA 的维度表达、MQA 的 KV Cache、GQA 分 G 组的折中）、prompt 注入的三层防御（model / agent / 权限）、一百多用户并发时的显存与 CPU·内存争抢、多 agent 子任务卡死时的 timeout 与 scheduler、trace 观测字段与十个问题、摘要压缩丢信息的补法、高危审批要带哪些信息、checkpoint 按事件而非按 step 保存。