第7章：状态管理算法

Tue, 09 Jun 2026 00:00:00 +0800

“程序的本质就是状态与状态之间的转换。” —— Edsger W. Dijkstra

7.1 问题引入：百态纷呈的 Agent 系统

想象一个拥有超过 100 个状态属性的 AI Agent 系统。它需要同时管理：

对话历史：数十轮多模态消息，包含用户输入、模型回复、工具调用结果
工具权限：每个工具的授权模式（允许、拒绝、询问），可在运行时动态变更
用户配置：来自用户设置、项目设置、企业策略、命令行参数等多层级配置源
UI 状态：展开/折叠视图、模型选择、通知队列、输入提示等
任务状态：后台任务的生命周期、子 Agent 的运行状态、团队协作信息
会话元数据：会话 ID、权限模式、远程连接状态、推测执行状态

当多个组件同时读写这些状态时，如何确保变更可预测、不产生副作用？当配置文件在磁盘上被外部修改时，如何实时感知并正确合并？当会话中断后恢复时，如何从持久化的日志中重建完整状态？

这些问题的本质是一个经典的工程挑战：在复杂系统中实现可预测的状态管理。Claude Code 源码为我们展示了一套精巧的解决方案——它融合了不可变状态机、发布-订阅、选择器订阅、层级合并、事件溯源等多种算法思想，构建了一个既高效又可靠的状态管理体系。

7.2 算法思想

7.2.1 不可变状态机算法

核心原则：状态只能通过纯函数转换，旧状态永不修改。

不可变状态机的思想源自函数式编程：给定当前状态 S 和一个转换函数 f，新状态 S’ = f(S)。旧状态 S 在转换过程中不被修改，它依然可以被引用和比较。这一原则带来三大好处：

变更检测极其廉价——只需 Object.is(prev, next) 即可判断是否发生变更，时间复杂度 O(1)
不存在并发修改的竞态条件——因为没有人能修改已经发出的状态快照
天然支持时间旅行——旧状态快照可以保留，用于调试或回溯

Claude Code 在类型层面通过 DeepImmutable<T> 泛型强制保证不可变性。AppState 的核心字段被 DeepImmutable 包裹，编译器会阻止任何对深层属性的直接赋值。

// 类型层面的不可变保证
type AppState = DeepImmutable<{
 settings: SettingsJson
 verbose: boolean
 mainLoopModel: ModelSetting
 toolPermissionContext: ToolPermissionContext
 // ... 100+ 字段
}> & {
 // 少数包含函数类型的字段排除在 DeepImmutable 之外
 tasks: { [taskId: string]: TaskState }
 mcp: { clients: MCPServerConnection[]; tools: Tool[]; ... }
}

注意 DeepImmutable 与交叉类型 & 的组合使用：核心配置字段（settings、verbose、权限上下文等）被严格冻结；而包含回调函数或可变引用的字段（tasks、mcp）则排除在外。这是实用主义的不可变性——在类型安全和运行时灵活性之间取得平衡。

状态管理

Sat, 05 Oct 2024 00:00:00 +0800

本知识点将以 Pinia 为例，介绍 Vue 中的状态管理。

前言

Pinia简称小菠萝🍍，是一个专为Vue 3设计的现代化状态管理库，为Vue 3开发的，它提供了一种简单、可扩展和类型安全的方式来管理应用程序的状态。

与Vue 2中的Vuex相比，Pinia提供了更好的TypeScript支持，具有更好的类型定义和类型推断，可在编译时捕获错误，提供更高的代码可靠性和开发体验。它是专为Vue 3设计的，充分利用了Vue 3的新特性，如Composition API，以提供更直接、自然和灵活的状态管理体验。Pinia的核心概念是Store，它类似于Vuex中的模块，用于管理应用程序的状，可以将相关的状态和逻辑组合到单个Store中，使代码更清晰、结构更有组织性。除此之外海提供了许多有用的特性和功能，例如模块化组织、状态持久化、插件扩展等。

总的来说，Pinia是一个功能强大而灵活的状态管理解决方案，适用于各种规模的Vue 3应用程序。它提供了现代化的特性和工具，帮助我们更好地组织、管理和扩展应用程序的状态，同时提供了更好的类型安全和开发体验。

安装

运行安装命令

npm install pinia

在main.ts中引入

// main.ts
import { createApp } from 'vue'
import { createPinia } from 'pinia'
import App from './App.vue'

const pinia = createPinia()
const app = createApp(App)

app.use(pinia)
app.mount('#app')

初始化Store

新建stores文件，用于存放所有的store，然后创建index.ts。

同过 defineStore() 定义一个store，它接受一个参数作为仓库名称，也就是Id。它返回一个函数，默认我们使用user开头的风格来接收。第二个参数为一个Setup函数或者Option对象。

import { defineStore } from 'pinia'

export const useUsersStore = defineStore('users', {
 // 其他配置...

})

Option Store

这种方式熟悉Vuex的很了解，传入一个带有 state、actions 与 getters 属性的 Option 对象

export const userUsersStore = defineStore('users', {
 state: () => {
 return {
 name: 'inkun',
 current: 100
 }
 },

 getters: {
 getName: (state) => state.name + '🐔你好帅'
 },

 actions:{
 getUserInfo {
 ...
 }
 }
})

在 Option Store 中：

状态管理 on Last Stand