A PERSONAL JOURNAL

破山中贼易,破心中贼难

  1. 从设计者的角度理解源码--ClaudeCode中的状态机们

    Claude Code 的状态机们 Claude Code 里那么多状态机,凭什么不打架 引言 有一个说法流传很广,听起来像技术事实,其实是错觉: "Claude Code 里有好几个状态机,它们共用一个 LLM 大脑。" 这句话让人联想到一个共享内存:几台机器读写同一块区域,靠加锁互斥。 但物理上

    agent
  2. 从设计者的角度理解源码--Agent Loop到底是不是状态机?

    Agent Loop 是不是状态机 一个没有 phase 字段的状态机,靠什么运转 引言 关于 Claude Code 的 query(),流传最广的一句定性是"它是一个状态机"。讲得再细一点,会说它有若干"Continue Site",每次转移到下一轮都带着一个 transition.reason

    agent
  3. 从设计者角度理解源码·方法篇:机制、原型与提问协议

    从设计者角度理解源码·方法篇:机制、原型与提问协议 这是《从设计者角度理解源码》系列的一篇"元文章":它不讲某个模块怎么实现,只讲读源码这件事本身该怎么做。 案例全部来自同系列的 Hook 设计的两种答案——那篇给的是"填好的表",本篇给的是"怎么用这张表"。 引言 先讲一个很常见的困境。 你遇到了

    持续思考
  4. Hook 设计的两种答案:跨进程与同栈

    Hook 设计的两种答案:跨进程与同栈 前置阅读:Claude Code 的 Hook 体系设计(讲"这套系统内部怎么运转")、Hook 设计机制(讲"契约为什么是双保险")。 本篇不再重复那两篇的内容,只回答一个新问题:同样是"在生命周期节点插入第三方逻辑",为什么 Claude Code 和 D

    agent
  5. 从设计者的角度理解源码–上下文工程:系统的话,为什么要借用户的嘴说?

    从设计者的角度理解源码–上下文工程:系统的话,为什么要借用户的嘴说? 引言 本篇是《从设计者的角度理解源码》系列里聚焦上下文工程的一篇。 我原以为「上下文工程」是个玄学词——不就是「把该给模型看的东西塞进 prompt」吗?直到我盯着 Claude Code 的源码看久了,才意识到它其实是一套有明确

    agent
  6. 从设计者的角度理解源码--ClaudeCode的Hook体系设计

    从设计者的角度理解源码 -- Claude Code 的 Hook 体系设计引言本篇,作为《从设计者的角度理解源码》系列的第六篇,试图回答一个比「工具怎么统一」更棘手的问题:Claude Code 怎么敢让用户自己写的代码(Hook),插进它的核心执行流程,参与「要不要执行这个危险操作」的决策?上一

    agent
  7. 从设计者的角度理解源码--Claude Code的工具体系设计

    从设计者的角度理解源码 -- Claude Code 的工具体系设计引言本篇,作为《从设计者的角度理解源码》系列的第五篇,试图回答一个看起来不该成为问题的问题:Claude Code 怎么用「一个接口」统一调度几十种语义完全不同的工具?读文件的 Read、跑命令的 Bash、改代码的 Edit、搜代

    agent
  8. 从设计者的角度理解源码--ClaudeCode权限系统设计

    从设计者的角度理解源码 -- Claude Code 的权限系统设计引言本篇,作为《从设计者的角度理解源码》系列的第四篇,试图回答一个安全领域最朴素、也最难的问题:Claude Code 怎么敢让一个 LLM 直接在你电脑上执行 rm -rf?这个问题的难度在于:LLM 的能力和可信度是错配的。它的

    agent
  9. 从设计者的角度理解源码-ClaudeCode的消息机制设计

    从设计者的角度理解源码 -- ClaudeCode的消息机制设计引言本篇,作为《从设计者的角度理解源码》系列的第三篇,试图回答一个看似简单的问题:Claude Code 的消息系统为什么长成现在这个样子?如果你翻过源码,你会发现 messages.ts 有 3000+ 行,里面塞满了 isMeta、

    agent
  10. 从设计者的角度理解源码–CludeCode的记忆压缩策略

    从设计者的角度理解源码–记忆压缩的七种刀法引言本篇是《从设计者的角度理解源码》系列里聚焦上下文与记忆的一篇。聊一个每个做 LLM 应用的人都会撞上的问题:对话跑长了,token 不够用了怎么办?大部分项目的答案很简单——快爆了就让模型自己总结一下,用摘要替换历史。这当然能用,但总觉得糙。Claude

    agent