博客 & 更新日志
了解 WeClaw 的最新动态、技术分享和最佳实践
博客专题
按主题快速导航，点击专题查看系列文章
深度解析 Hermes Agent：Nous Research 开源的"AI 超级助手"为何火爆全网？
上线两月狂揽数万星标：深度拆解 Hermes Agent 的架构设计与火爆原因。
双引擎意图识别：一次「配置开了却没生效」的排查，揭开的链路真相
双引擎架构 · 规则引擎兜底 · 链路分工 · 子开关灰度 · 首 token 延迟
给 LLM 快路径上保险：6 秒最坏情况是怎么被设计出来的
LLM 意图分类 · 超时预算 · 快失败重试 · 熔断器 · 双引擎降级
三张意图表合并成一张：一次「单源化」重构，如何用常驻断言把漂移锁死
单一事实来源 · 派生视图 · 常驻不变量 · 等价搬迁 · 基线纪律
论文依赖活体代码时，怎么重构才不烧掉自己的实验：一次提示词瘦身的安全骨架
冻结契约 · 快照门禁 · 门禁驱动验收 · 回归归因 · 论文代码漂移治理
19K tokens 的「你好」：我们把系统提示词减掉了 80%，还顺手让一篇论文的措辞名副其实
提示词预算 · 锚点切分 · 按意图注入 · 整模块丢弃 · 灰度回退
24 个 pattern 的图书馆：为什么检索优化到头了，问题其实在采集端
采集端瓶颈 · 值域枚举法 · 反事实实验 · 语义聚类对照 · 死代码考古
时间衰减的第二层：修好误杀之后，它开始悄悄毁掉排序
召回管道归因 · 验收指标盲区 · 排序信号越权 · 逐层剥离实验 · 考古层位第三层
否决一个看起来很美的方案：五道闸门与「证伪优先」的选型方法
技术选型方法学 · 证伪优先 · 跨语料基准不可迁移 · 天花板效应 · 依赖真实账单 · 零成本取证
Mock、Fixture 与录制回放：三种测试替身术的工程实战
从 WeClaw v7.0.0 工作流队列 282 项测试中，拆解 Mock / Fixture / 录制回放三种测试隔离策略的选型逻辑与实战代码
校准测试框架：3 语料集 + live 门控持续校准
模块八收官：从离线回归（<1s）到 live 校准（真实 LLM），构建心理安全网的最后一道质量闸门
伦理边界与 AI 安全等级：能力越强护栏越硬
从 ASL-MH 四级框架看 WeClaw 的自我定位：做 Level 1 陪伴者，绝不做 Level 4 治疗师
L4 监护人告警：10 条前置校验如何避免骚扰式告警
从"狼来了效应"看安全告警的工程悖论：发多了是骚扰，发少了是失职
词表校准与误报治理：从实测回放看召回率与误报率的平衡术
从 12 条真实消息的"打脸回放"，看关键词表如何从"想当然"走向"数据驱动"
危机资源零编造红线：当 AI 凭记忆"编"出一个不存在的热线号码
从一次真实事故看"幻觉零容忍"工程：静态核验表 + 双通道注入 + 预算闭环
RiskLevel 全序 Bug：一个缺失的 `__lt__` 如何让整条告警链路静默失效
从 Python Enum 比较运算符协议，看"字典序退化"如何制造一个不报错、不崩溃、却彻底瘫痪的生产 Bug
L1–L2 双重确认：为什么一个 LLM 说了不算？
独立复核与置信融合：从 C-SSRS 分级思路到双 critical + confidence≥0.85 的工程落地
L0 关键词闸门：<1ms 零 IO 的危机念头第一道防线
深入 L0Gate 的纯内存判定引擎：三类词表、区间抵消、LRU 去重与 casefold 大小写折叠
分层风险治理总览：为什么 AI 心理陪伴需要 L0–L4 五层"安全阀"？
从一次真实危机对话回放，看 WeClaw 如何用"纵深防御"给 AI 装上一套负责任的心理危机守护系统
向量库重建实战：维度变更、10000 字符截断陷阱与文件锁
向量库全量重建 · content_text 截断陷阱 · ChromaDB 文件锁 · git stash 对照归因 · 备份回滚设计
时间衰减的隐形杀手：离线评估 93%，上线为什么只有 80%？
过滤顺序缺陷 · 等效阈值抬升 · 相关性门控与排序加权分离 · 端到端验证的必要性
嵌入模型不是玄学：四轮实证把 Hit@1 从 33% 拉到 93% 的完整决策过程
嵌入模型选型 · 离线评估方法学 · BGE 前缀反直觉实测 · 在线 vs 本地 · CPU 性能验证
第一性原理砍需求：一个"多会话并发"方案从立项到自我否决的完整思辨
第一性原理 · 需求拆解 · 复杂度税 · 收益上限分析 · 分阶段决策门
总结与展望：Harness工程的迭代哲学与被否决的方案
迭代哲学 · 三轮评审 · 被否决方案 · Reasoning Sandwich · 双路径对称 · 未来路线
Loop_Detection：检测和中断Agent的死亡循环
Loop Detector · 死亡循环 · 三级检测 · 锚定消息注入 · 渐进响应
Pre-completion_Checklist：AI的交付前自检清单
Completion Checklist · 交付前自检 · 双路径差异 · 流式后置告知 · 非流式拦截重入
自适应Harness：让系统从历史成功模式中学习
Adaptive Harness · 模式挖掘 · 工具暴露优化 · 数据驱动 · 渐进调整
熵管理：AI系统的垃圾回收机制
Entropy Manager · 后台清理 · 文档一致性 · 死代码扫描 · 技能花园维护
角色化多Agent协作：从并行隔离到Explorer_Planner_Coder_Reviewer分工编排
Multi-Agent · 角色分工 · RoleOrchestrator · EventBus 隔离 · Token 预算控制
确定性约束引擎：从Prompt引导到代码级强制的范式转变
Constraint Engine · 确定性校验 · 语义级约束 · Hook 注入 · 零 token 成本
Harness工程全景：六层模型评估与WeClaw 4.3分成熟度诊断
Harness Engineering · 六层架构模型 · 成熟度评估 · 差距分析 · 迭代规划
当AI把内部协议泄漏给用户：DeepSeek DSML标记污染content字段的全链路排查与修复
DeepSeek API · DSML 标记泄漏 · Unicode hex 分析 · 流式过滤 · API 契约缺陷
能力越强，护栏越硬：AI自主进化的安全边界工程与核能类比
从核能类比看 AI 能力-安全共演化的工程实践
三级裁剪：零 LLM 成本的旧 Tool 结果瘦身术
不花一个 token 给旧工具结果瘦身：三级裁剪策略详解。
System Prompt 膨胀：你的 AI 有多少预算给了"自我介绍"？
系统提示词占了多少预算？System Prompt 膨胀的诊断与瘦身策略。
密钥脱敏：你的 API Key 可能藏在摘要里
你的 API Key 可能正躺在上下文摘要里——密钥脱敏方案与实现。
异步压缩：让用户感知不到上下文整理
把上下文整理放到后台执行，让用户完全无感知的压缩方案。
结构化摘要：从 6 字段到 10 字段的信息保全术
从 6 字段到 10 字段：结构化摘要如何在压缩中保全关键信息。
当 AI 学会“照镜子”：自我反思闭环架构从哲学之问到工程实践
四工具闭环自愈架构（感知 → 诊断 → 修复 → 重启），让 AI 能审查自身调用日志、分析错误、搜索源码并安全重启。
AI 失忆症处方：跨会话经验知识图谱让 AI 越用越聪明
构建 ExperienceStore，让 AI 自动记录诊断经验、语义检索历史方案，实现跨会话知识积累。
Token-Budget 尾部保护：别再按"轮次"保护上下文了
为什么按“轮次”保护上下文是错的：Token-Budget 尾部保护策略详解。
三级容灾：当辅助 LLM 挂了，你的摘要怎么办？
辅助 LLM 挂了怎么办？本地兜底 + 缓存 + 降级的三级容灾设计。
上下文管理实战：当 AI 在百万 Token 长对话中“失忆”
深入理解大模型 Agent 上下文管理的问题本质，从压缩策略、容灾机制到异步摘要的完整解决方案。
实战踩坑录：上下文管理的 10 个反直觉 Bug
汇总两轮上下文管理重构中遇到的 10 个反直觉 Bug，每个都按“现象 → 根因 → 修复 → 教训”展开。
压缩阈值：为什么 1M 窗口下 AI 从不压缩
深入分析大模型上下文压缩的阈值设定策略，揭示 1M 窗口下的工程决策逻辑。
Tool 配对完整性：ReAct Agent 最隐蔽的 Bug
揭秘 ReAct 循环中 tool_call 与 tool_result 配对失败这一最隐蔽的 Bug 及其修复方案。
架构选型：三个开源项目的上下文管理哲学——Hermes、CoPaw 与 WeClaw 的横向对比
横向对比三个开源项目的上下文管理策略，理解 AI“失忆”的工程解法。
"早上好惊喜"机制揭秘：四层架构如何让 AI 主动回顾昨天、温暖开启今天
从陪伴人格注入到会话上下文回忆，解密"早上好"背后多组件协同的惊喜体验
OCR架构优化：构建统一的OCR抽象层设计
构建统一的 OCR 抽象层：一套接口适配多种引擎。
OCR技术在工具调用中的最佳实践：意图识别与路由策略
工具调用中的意图识别与路由策略：让 LLM 选对 OCR 引擎。
OCR技术选型决策指南：多场景下的技术栈选择策略
文档扫描、票据识别、截图取字……不同场景该如何选择 OCR 技术栈。
音乐播放器开发：QtMultimedia音频引擎与播放列表管理
QtMultimedia 音频引擎与播放列表管理：从零构建桌面音乐播放器。
课程表系统设计：iCalendar标准与家庭生活日程管理
基于 iCalendar 标准的家庭生活日程管理：.ics 文件解析、存储与提醒。
家庭成员管理系统：SQLite 关系型数据库建模实战
SQLite 关系型建模实战：从表结构设计到家庭成员数据的完整 CRUD。
营养食谱推荐引擎：基于规则与协同过滤的混合算法
规则 + 协同过滤混合算法，决定今天吃什么。
文档扫描工具开发：高拍仪硬件集成与图像处理流水线
高拍仪硬件集成与图像处理流水线：从拍摄采集到增强输出的完整链路。
语音识别系统架构：GLM-ASR 实时流式识别与录音管理
GLM-ASR 实时流式识别与录音管理：构建低延迟语音输入管道的完整方案。
TTS 语音合成实战：pyttsx3 本地引擎与 Edge-TTS 云服务的混合架构
本地优先、云端兜底：pyttsx3 与 Edge-TTS 混合架构设计与延迟优化实践。
会话管理系统的演进：从内存字典到 SQLite 持久化的实战之路
从内存字典到 SQLite 持久化，记录会话数据落盘的完整过程与设计权衡。
LLM Function Calling的Schema陷阱与纯语言输出双重保障
JSON Schema · OpenAI Function Calling · 语言约束 · 后处理过滤 · Prompt Engineering
信号链双路径陷阱：新增Signal路径后AI回复重复的根因与修复
PySide6 Signal/Slot · 信号分叉 · CFTA 架构 · 语音对话 · 双路径竞争
从本地开发到 PyPI发布：WeClaw 的 Python 包标准化之旅
从 `pip install weclawpy` 说起，揭秘一个 AI 桌面智能体的 PyPI发布全流程与血泪教训
意图识别与工具智能路由：17维关键词矩阵如何让LLM精准选择38个工具
从"选择困难症"到"精准狙击"，揭秘 Phase 6 工具扩展后的意图识别体系重构
可选依赖的优雅降级：从思维导图双引擎到语音识别三级容错的实战设计
条件导入、多引擎架构与依赖容错机制深度解析
无感建档系统：从工具调用推断用户档案的分阶段采集策略
OnboardingSequence + InferenceRule 如何在对话中自然地收集用户信息
防骚扰冷却机制：拒绝不是失败，让陪伴更懂用户
预算制+拒绝惩罚+连续忽略检测的三层防护与动态调整算法
工具状态失踪之谜：EventBus 事件漏接与 asyncio.Lock 并发陷阱双线诊断
EventBus · asyncio.Lock · 异步生成器 · 并发序列化 · 跨端消息隔离
TTS 静默之谜：pyttsx3 全局缓存陷阱与 qasync 环境四轮诊断实战
Windows TTS · pyttsx3 · qasync · COM 线程模型 · 第三方库全局状态
架构演进史：从 0 到 1 构建跨平台 AI 助手的完整历程
收官之作：技术选型、关键决策与宝贵经验全分享
消息丢失问题分析：从 ACK 确认机制到离线队列设计
消息可靠性保障、ACK 机制与离线队列全链路实践
WebSocket 连接中断诊断：从频繁掉线到稳定长连的优化之路
心跳检测、重连机制与网络环境适配全解析
设备指纹绑定失败排查：从"无效设备"错误到 SHA-256 算法优化
设备指纹生成、验证与冲突解决全链路诊断
日志分析实战：如何从海量日志中快速定位根因？
日志聚合、模式识别与自动化告警
全链路追踪实战：如何在 50ms 内定位分布式系统中的性能瓶颈？
Agent 核心循环埋点采集与数据分析
API 权限与审计实战：RBAC 模型如何在后台管理中实现细粒度权限控制？
RBAC 模型在后台管理中的实践
Token 吊销实战：如何用 JWT 黑名单在 50ms 内阻止未授权访问？
从 JWT 黑名单到设备绑定安全加固
双通道密钥管理实战：一个.env 文件差点毁掉整个软件分发，我们怎么用 125 行代码翻盘的？
兼顾开发者便利与用户安全的实战方案
桌面端与PWA文件双向传输：WebSocket与HTTP混合协议设计
WebSocket + HTTP 混合协议设计，打通桌面端与 PWA 的文件双向传输。
Agent工具注册全链路：从BaseTool到意图识别的标准化接入
从 BaseTool 到意图识别：一个新工具的标准化接入全流程。
双重认证与Token自动刷新：Device Fingerprint与JWT安全机制
设备指纹 + JWT 双重认证与 Token 自动刷新机制的完整实现。
PWA语音消息端到端处理：从录音到ASR转录的异步管道
从录音、上传到 ASR 转录：一条全异步的语音消息处理管道。
流式响应转发实战：LLM Token 流的实时推送技术，如何让首字延迟降至 200ms？
asyncio.Queue 缓冲设计 + SSE/WebSocket双协议支持
离线消息队列实战：异步任务队列如何保证在服务器宕机时不丢失任何一条 AI 回复？
异步任务队列在实时通信中的应用
工具注册系统演进：从手动映射到配置驱动自动发现的架构之路
回顾工具注册系统从硬编码到 tools.json 配置驱动、自动发现的完整演进历程。
心跳与重连实战：指数退避算法如何让 WebSocket 在弱网环境下的连接成功率提升 67%？
指数退避算法在 WebSocket 中的实践
系统监控与日志体系：多层次日志架构与Trace追踪
多层次日志架构与 Trace 追踪：让每一次异常都有迹可循。
WebSocket 路由实战：BridgeConnectionManager 如何用四层映射在 800 个连接中实现毫秒级消息转发？
从 BridgeConnectionManager 看消息转发的艺术
CFTA异步调用链优化：从阻塞15秒到非阻塞并发
从阻塞 15 秒到非阻塞并发：工具调用链的 asyncio 全链路改造。
远程桥接并发控制：MCP架构与Session隔离机制
MCP 架构与 Session 隔离机制：让并发远程指令互不干扰。
主动陪伴引擎实战：五大组件如何协力决策“何时”和“说什么”
从事件驱动到 asyncio 非阻塞调度，揭秘 AI 主动关怀背后的决策引擎与防骚扰冷却机制。
请求路由实战：一个 request_id 如何在 800 个并发连接中精准找到目标浏览器？
request_id 在分布式系统中的生命周期
性能优化实战：启动速度提升 3 倍与内存占用降低 60% 的秘密
懒加载、对象池、LRU 缓存与 Profiling 全链路优化，启动时间从 10 秒降至 3 秒。
设备指纹绑定实战：一个 SQLite 唯一约束如何阻止了 300 次重复绑定？
从硬件信息到安全认证的全链路设计
混合通讯架构实战：HTTP+SSE+WebSocket 的三元融合
详解 WeClaw 如何设计混合通讯架构，实现桌面端、PWA 移动端与远程服务的高效协同。