learn-claude-code 笔记 4:用钩子扩展 Agent 循环,不改动循环本身
本节演示如何用钩子系统扩展 Agent 行为而不修改 agent_loop:循环只调用 trigger_hooks(),具体逻辑全部挂在 UserPromptSubmit、PreToolUse、PostToolUse、Stop 四个事件的回调里。
本节演示如何用钩子系统扩展 Agent 行为而不修改 agent_loop:循环只调用 trigger_hooks(),具体逻辑全部挂在 UserPromptSubmit、PreToolUse、PostToolUse、Stop 四个事件的回调里。
openchamber-openwith 是一个 Apache-2.0 开源的 OpenChamber 扩展,在侧栏点击即可把当前项目用本机已安装的编辑器、终端或文件管理器打开,省去手动翻文件夹的动作。
Seed-VC 是零样本歌声转换开源模型(论文 arXiv 2411.09943),在 AIGCPanel 中导入一键运行包,用一段 5 秒参考音频即可把整首歌换成另一种嗓音,无需训练。
作者建议把权属核查从成片后的法务环节前移到立项阶段,作为流水线的一个工程节点,输出权属声明文件、素材来源表和提示词档案目录三份产物。天津和平法院与北京互联网法院的两起案件表明,生成过程留档与授权审核已成为抗辩和免责的关键,门禁设计可在角色图定稿、批量生成和交付前分段拦截。
REA 是把 Ghidra、IDA、JADX 等逆向工具封装成 MCP 工具的开源项目,让 AI Agent 在没有源码的情况下解释软件某个功能如何实现。截至 2026 年 10 月 18 日,morluto/rea 有 308,201 个 Star,npm 包 rea-agents 单周下载 30.7 万次。
LangBot 从 4.10.11 升到 4.11.0 后内置 Runner 消失,迁移分两条路径:数据库 schema 由 Alembic 在启动时自动迁移(实测跨 14 个 revision、约 80 秒出现首个 HTTP 200),Runner 配置则须通过需 USER_TOKEN 确认的迁移 API 手动执行。
LangBot 4.11 新增工作区级操作日志、TOTP 与 WebAuthn 双因子以及插件认证与签名三项治理能力,面向机器人对外服务前的上线准备。操作日志默认关闭需显式开启,每条记录以 HMAC-SHA256 串成链可校验是否被篡改;插件认证只做准入判定,不提供托管沙箱,文中给出了从 4.10 迁移与逐项验证的步骤。
作者用 Spring AI 2.0.1 实测 Metadata Filter 的多租户检索隔离,把两家商户的 6 份资料放入同一向量库,对比无过滤、shop-a 和 shop-b 三种检索结果。加过滤后候选资料收敛到当前租户,越权提示词也无法让另一家规则进入上下文。测试使用 Qwen3 Embedding 0.6B 做向量检索、Qwen2.5 3B 做生成,topK 固定为 3。
作者从自己的 Claude Code 会话记录中统计,2026 年 9 月 18 日至 10 月 13 日权限分类器共拦截 27 次,分布在 10 个日子、12 种标签,其中至少 7 次只是查账号信息、读文件、grep 等只读命令。
笔者所在团队把 AI 回答的来源列表拆成引用位置、URL、域名三层分别存储与统计,并在自建 AI 可见度监测库(项目 56,查询日 2026-10-18)上跑出 815 条带被引链接记录、273 个去重网页、140 个归并站点三个不可互相替代的数字。归一化只剥约定的跟踪参数、保留其余参数,域名归并放在最后且不可逆;引用位置层是区分主推来源与兜底来源的唯一字段。
《驿路巡点》在 iOS 与 Android 模拟器连续跑 0–99 关,94 关通关、6 关卡死,根因是关卡导入脚本丢失渡口(ferry)等机制字段,引擎一侧当时也没有渡口规则。两次合并修复后,求解器层面 100 关全部有解,后续复测未再失败。求解器与规则测试原本只按 20 关编写,导入 100 关时未拦住问题,是这趟排查中代价最大的流程教训。
本文介绍两张表对账的方法:先按候选键分组查重复与缺项,再让 AI 把已算出的异常整理成待办说明。作者用 6 行对 7 行的演示表展示一致、重复候选、币种不同、金额差异和仅单边记录五类结果,并建议用全外连接保留双边记录,差额与原行分开保存以便人工复核。
本文系统讲解向量数据库主流索引(Flat、HNSW、IVF 系列、PQ/RaBitQ 量化、DiskANN/SPANN、CAGRA 等)的原理与适用场景,强调选型应由 Recall@k、延迟、过滤选择率、硬件和总成本决定,而非按数据量套口诀。
作者从 Java 后端视角(Java 17 + Spring Boot 3.4 + Spring AI)完成六阶段 AI Agent 落地实验,把大模型当作延迟高、会模型幻觉、按 token 计费的无状态下游服务,直接复用超时、重试、限流、缓存、熔断等后端工程手段。
ARTS 1018 涵盖 LeetCode 异位词题解、Claude Code 团队代码审查流程点评及 Linus 关于 AI 工具的观点。Anthropic 将常规代码检查交给 AI,按风险分配人工批准并限制 Agent 审查轮数,避免节省的时间被修 Bug 消耗。Linus 强调使用工具不能替代对工作的理解,作者据此指出 AI 编程中人的理解和判断仍不可缺。
生产环境里 Agent 工具调用失败约 65% 出在参数 JSON 而非模型能力,本文据此梳理了从手写 Prompt、Function Calling、JSON Mode 到 Structured Outputs 的四代演进。
推荐理由:原文把工具调用参数错误拆成语法与语义两层,并给出 schema 设计、服务端校验和有限重试的闭环做法,可直接照搬到自己的 Agent 工程。
作者过去两个月把量化本地小模型接进日常开发工作流,用 pre-commit 代码审查、本地 RAG 和批量文本分类三个高频场景替代云端 API,一个月约 4.2 万次调用折算节省 800-1200 元。关键工程细节包括 Q4_K_M 量化是能力与体积的平衡点、7B 模型单条请求控制在 6K 上下文以内,以及关键链路需保留降级到云端 API 的 fallback。
2026 年 8 月 13 日,Claude Code 作者 Boris Cherny 公开实践:让 Claude 通过 Slack 频道接管一个应用的日常维护,数周内自动开出 388 个 PR,其中 180 个经 Claude Code Review 与人工审核后合并,合并率约 46%。
长租公寓租赁微服务基于 Java Spring Boot 集成天远人脸身份证比对 A 接口,以自动比对替代门店人工肉眼核验,实现签约人证合一秒级校验。租客授权后传入姓名、18 位身份证号与活体人脸照片 URL,经 AES-128-CBC 动态 IV 加密直连权威身份核验数据库,返回 valid/invalid 审核结果与 0~1000 分相似度。
技术团队将天远人脸身份证比对 A 接口(IVYZZQ3B)集成进空铁联运通关网关,用 Goroutine Worker Pool 并发处理闸机请求,实现人证合一秒级通关。
金融合规问答助手落地规则版 RAG 查询路由:检索前按聚合词与术语密度(阈值 0.30)将查询分流至 hybrid 或 hybrid+rewrite 链路。三路 A/B 评估中,route 模式 hit@4 从基线 95% 升至 100%,MRR 从 0.912 升至 1.000,20 道正例全部 rank=1、零误判。
作者提出 AI 人格无需 prompt 设计,只需在同一对话框用高密度、成体系的对话压力持续推动,几百轮后模型便会因惯性叠权自然收敛出目标风格。文中给出收敛测试、自发人格测试等 6 种验证方法,以及涵盖基线测绘、密度投喂与收敛监测的主动育种流程。需注意,具备外部长期记忆的产品中人格污染为账号级,删除对话框无效,清空记忆才能重置。
SIFT 是 David Lowe 于 1999 年提出、2004 年完善的图像特征算法,具备尺度与旋转不变性,专利于 2020 年过期后可自由商用。它通过高斯金字塔与 DOG 检测极值点,经精确定位和方向分配生成 128 维描述子,再以 Lowe 比率测试(阈值 0.7)与 RANSAC 完成匹配。
作者在《Agent Harness 从用到会造》第 8 讲用可复现台架对比关键词、向量、混合三路检索,核心判断是混合检索的首要价值在兜底而非涨分。台架把 329 个 md 文件切成 3818 块,精确串族向量 recall@5 仅 36% 而关键词 100%,混合的漏检集合与关键词完全相同。
推荐理由:作者用可复现台架把混合检索的收益拆成可数的差集,这套差集分析方法可直接迁移到自己的知识库上。
作者提出本地模型升级时把模型版本和提示词绑在一起验收,用记录模型名、量化方式、上下文长度和采样参数的运行名片,配合按版本分目录的提示词管理。升级前准备格式题、拒答题、术语题等探针题重跑,新旧环境并行一天再切流量。实践发现一半所谓提示词失效其实是新模型行为变化,另有采样参数被安装器改回默认值的情况,分开定位后只改了两处措辞。
作者从零体验 DeepSeek Harness(DSH)开发者预览,目标是开发一个由 AI 驱动的操作录制插件。
DeepSeek 于 10 月 17 日将 deepseek-flash 背后的模型静默切换为 DeepSeek-V4.1-Flash-1017,旧的 deepseek-v4-flash 也会转到新版,API 名与价格不变。
推荐理由:作者结合自己的出海外链自动化流程,总结出便宜模型接活的三条件判断法和后台验账方法,可直接迁移。
作者将 AMP 协议升级到 v0.2.0,引入 AES-256-GCM 端到端加密,采用“密文存储、明文哈希”设计,contentHash 仍基于明文计算以保持 Hash Chain 的确定性。v0.2.0 还新增跨设备同步的 export/import 接口,用只追加合并解决冲突。v0.1 的 8 个黑盒一致性测试未改一字即全部通过,升级完全向后兼容。
作者分享用 LangSmith 为上线 RAG 应用接入可观测性的经验,覆盖全链路追踪、逐环节排查、按链路拆分 token 成本和 Prompt 版本评估。
作者用码道 WebUI 生成零依赖的纯前端单文件批量加水印工具,图片全程不出浏览器。实测 30 张混合尺寸图片导出耗时 4.57 至 4.89 秒,3 张示例图仅 0.53 秒,全程 0 条网络请求。工具已开源,支持文字与图片水印、九宫格及全图平铺布局。
作者用码道 Web 版生成单文件 HTML5 Canvas 塔防游戏,把写死折线改为网格 A* 寻路并实测塔位对路径的影响。空地图最短路径 41 格、访问 234 个节点,堵住终点旁两格后路径变 43 格、节点数升至 349,全堵则判不可达。
作者基于 Next.js 14 App Router + TypeScript 给出一套可直接运行的 AI 流式聊天前端方案,解决中文乱码、打字机卡顿、Markdown/LaTeX 渲染闪烁和反向代理缓冲四大生产问题。
ECC(Everything Claude Code)是一个开源的 Agent Harness 性能优化系统,2026 年 Q1 Star 数达 119.8K、增长 119.8 倍,位列 Runa Capital ROSS 指数头部项目。
推荐理由:文章拆解了 ECC 的五层架构与 AgentShield 安全参数,读者可借鉴它如何用规则和钩子让 Agent 长期稳定工作。
作者介绍了在浏览器中把扫描 PDF 转成可搜索 PDF 的完整管线:先用 PDF.js 逐页渲染到 Canvas,再用 Tesseract.js 识别并输出带隐藏文字层的单页 PDF,最后用 pdf-lib 合并。文中给出复用单个 Worker、单页 1600 万像素渲染上限、及时释放 Canvas 与加载资源等实践细节,并强调可编辑文本与 PDF 隐藏文字层需分开处理。
作者用一个临时 SQLite 最小例复现了语音 Agent 的时序问题:用户打断后,已完成旧任务的结果可能被错误写入新回合的对话历史。四条串行时序显示,未加防护时结果归入回合 2;在投影写入前检查来源回合是否仍为当前且前台开放后,该事件转为 quarantined,后台任务仍保持 completed。文章强调后台任务完成与结果能否进入前台是两个独立状态,检查与写入须共享同一提交边界。
REA 是让 AI Agent 调用 Ghidra 等能力的逆向分析连接器,现已内置支持 TRAE,运行 npx rea-agents@latest setup 选择 TRAE 即可自动完成配置,无需手动设置 MCP。
文章从认知科学的短期/长期记忆层次出发,将业界 Agent 记忆方案收敛为上下文内、外部检索(RAG)、结构化自管理三大范式,并落到 XXL-AI 的混合架构实现。
AI应用工具中的「专家」分为单个专家与专家团两种形态:单个专家针对单一问题提供深度解答,专家团则由主理人与专业成员组成,将复杂任务拆分后串行执行。专家团通过严格的链条中转保证产出稳定,适合跨多环节的复杂任务,而单点小活找单个专家即可。使用专家团前,用户需提前明确目标、备齐素材并定好交付格式,以降低返工成本。
作者复盘了为投研 ETF Agent 引入子代理的完整设计:一套通用子代理运行时配合 Web、PDF、Python、Reviewer 等专业配置,将局部过程隔离出主 Agent 上下文,再以摘要、证据和产物交接回主线。
推荐理由:作者复盘了自家投研 Agent 的子代理设计,给出了上下文隔离、成果交接与治理复用等可迁移方法,适合多 Agent 架构设计者参考。
大模型训练先用 Softmax 将输出向量归一化为各 token 的概率,再以交叉熵损失函数量化预测与正确答案的差距,最终经反向传播与梯度下降更新参数。前置数学基础包括矩阵乘法、对数、偏导数与链式法则,用于推导 Softmax 归一化与信息量、交叉熵的数学性质。