<?xml version="1.0" encoding="utf-8" ?><rss version="2.0"><channel><title><![CDATA[打破AI信息差的博客]]></title><description><![CDATA[]]></description><link>https://blog.youkuaiyun.com/zhj_1213</link><language>zh-cn</language><generator>https://blog.youkuaiyun.com/</generator><copyright><![CDATA[Copyright &copy; zhj_1213]]></copyright><item><title><![CDATA[017-日志与可观测性：追踪、指标与调试技巧]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170909111</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170909111</guid><author>zhj_1213</author><pubDate>Tue, 17 Nov 2026 10:46:27 +0800</pubDate><description><![CDATA[本文分享WorkBuddy可观测性实战经验：通过结构化日志（JSON格式+关键字段注入）、指标埋点（Counter/Histogram/Gauge）与追踪结合，实现问题快速定位。强调日志非简单打印，而是可查询数据；指标需关注P99等长尾表现，而非平均值；队列积压等关键状态应独立采集。三者协同，让故障从“猜谜”变为“秒查”。]]></description><category></category></item><item><title><![CDATA[016-错误处理与重试：构建健壮的容错链路]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170844820</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170844820</guid><author>zhj_1213</author><pubDate>Mon, 16 Nov 2026 09:25:55 +0800</pubDate><description><![CDATA[本文分享了WorkBuddy流程在生产环境中如何通过错误分类、指数退避加抖动的重试机制、节点级重试包装、幂等性保障及熔断降级策略，构建健壮容错链路。强调重试需区分瞬时与确定性错误，避免重试风暴；通过结构化日志提升可观测性，实现故障快速定位。核心是让系统在瞬时故障中自愈，在持续故障下优雅降级，真正“活下来”。]]></description><category></category></item><item><title><![CDATA[015-状态与持久化：会话存储与断点恢复]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170844770</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170844770</guid><author>zhj_1213</author><pubDate>Mon, 16 Nov 2026 09:25:09 +0800</pubDate><description><![CDATA[本文深入探讨WorkBuddy任务中的会话状态管理与断点恢复机制。指出内存存储无法支撑长时间任务，提出“元数据-轨迹-产物”三层持久化架构，强调幂等键与检查点设计避免重复执行，并规范写入顺序以保障一致性。作者建议避免过度设计，重视恢复测试与用户反馈，强调状态持久化应作为核心设计而非事后补丁，否则将引发严重体验问题。]]></description><category></category></item><item><title><![CDATA[014-自定义工具开发：从接口到可复用组件]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170821942</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170821942</guid><author>zhj_1213</author><pubDate>Sun, 15 Nov 2026 23:36:40 +0800</pubDate><description><![CDATA[自定义工具开发的核心在于构建清晰的“契约”——既要满足运行时的类型安全，又要让模型准确理解调用条件。从最小接口出发，通过精准描述、扁平参数设计、防御性编程（参数兜底、超时控制、模型友好返回）与三层通用封装（错误处理、校验、格式化），实现从“能跑”到“可复用”的跃迁。测试需覆盖异常场景，避免模型误触发或依赖失效。经验表明：动词命名、明确边界、屏蔽敏感信息，是保障工具稳定可用的关键。]]></description><category></category></item><item><title><![CDATA[013-插件机制剖析：扩展点与生命周期]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170821936</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170821936</guid><author>zhj_1213</author><pubDate>Sun, 15 Nov 2026 23:35:59 +0800</pubDate><description><![CDATA[本文剖析WorkBuddy插件机制的核心——扩展点与生命周期。指出插件问题多源于对扩展点本质（契约而非接口）和调用时序的误解。详解四类扩展点：生命周期、数据管道、能力注册、事件订阅，强调“宿主调你”与“你调宿主”的方向差异。重点解析激活阶段的同步约束、责任链模式中next()的必要性、运行与停用阶段的资源管理规范，以及事件广播的并行特性。最后提供一个覆盖全扩展点的最小可运行插件模板，并提醒合理配置activationEvents以优化性能。]]></description><category></category></item><item><title><![CDATA[012-外部服务对接：HTTP、Webhook与鉴权]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170776301</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170776301</guid><author>zhj_1213</author><pubDate>Sat, 14 Nov 2026 15:43:23 +0800</pubDate><description><![CDATA[本文详解WorkBuddy中外部服务对接的三大核心：HTTP调用需设超时、合理重试并记录响应体；Webhook接收须验签、幂等处理且快速返回；鉴权采用配置管理，避免硬编码。强调配置安全、连接复用、出站白名单及日志追踪请求ID，结合实战案例揭示常见陷阱与规避策略，提升系统稳定性与可维护性。]]></description><category></category></item><item><title><![CDATA[011-数据接入：文件、数据库与API集成]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170776278</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170776278</guid><author>zhj_1213</author><pubDate>Sat, 14 Nov 2026 15:42:42 +0800</pubDate><description><![CDATA[本文系统讲解数据接入的三大核心场景：文件（编码探测、分块读取）、数据库（连接池配置、防断连）、API（超时重试、限流分页）。强调实战中常见陷阱，如乱码、内存溢出、连接失效、接口超时等，并提出统一接入层设计与日志监控建议，倡导“假设一切都不稳定”的工程思维，助力高效可靠的数据集成。]]></description><category></category></item><item><title><![CDATA[010-多轮任务编排：串行、并行与依赖处理]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170691206</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170691206</guid><author>zhj_1213</author><pubDate>Fri, 13 Nov 2026 09:17:07 +0800</pubDate><description><![CDATA[多轮任务编排中，串行需显式校验依赖与输出合法性，避免失败传递；并行应合理设置等待策略与资源限制，防止“通知先于订单”等时序问题；依赖处理须用DAG明确拓扑关系，支持字段级依赖提升效率；失败时需结合重试、补偿（幂等性保障）与降级策略，确保系统韧性。核心是：编排不仅是顺序，更是契约与容错的工程化表达。]]></description><category></category></item><item><title><![CDATA[009-上下文管理：记忆、裁剪与长对话策略]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170690978</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170690978</guid><author>zhj_1213</author><pubDate>Fri, 13 Nov 2026 09:16:10 +0800</pubDate><description><![CDATA[本文系统解析了WorkBuddy长对话中的上下文管理难题，指出盲目存储消息会导致信息串乱与性能崩溃。核心策略包括：区分事实型与情节型记忆，结构化存储前者；采用滑动窗口裁剪对话历史，保留最近几轮并防止工具调用断裂；仅在必要时通过摘要压缩早期内容，并确保摘要包含关键事实、决策与待办事项。强调按真实token计数、避免多用户共用会话、裁剪后更新状态等实践细节，提出“先砍一半预算再设计”的务实原则，辅以日志监控与人工抽检，保障长对话稳定可用。]]></description><category></category></item><item><title><![CDATA[008-工具调用原理：Function Calling与参数校验]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170591197</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170591197</guid><author>zhj_1213</author><pubDate>Thu, 12 Nov 2026 09:33:46 +0800</pubDate><description><![CDATA[Function Calling 本质是模型生成合规 JSON，而非直接调用函数。核心在于：参数校验不可缺省，需通过 Pydantic 等工具严格验证类型、格式与必填项；schema 应精确描述约束（如 string 类型的订单号勿转数字），并禁用 additionalProperties 防止冗余字段；错误回传应以自然语言明确指出问题字段与期望值，助力模型自愈；同时注意并行调用、结果截断、幂等性等边界问题。最终，将 schema 当文档写，校验层“宽进严出”，方能构建稳定可靠的工具链。]]></description><category></category></item><item><title><![CDATA[007-Prompt工程实践：让WorkBuddy稳定听懂指令]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170591125</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170591125</guid><author>zhj_1213</author><pubDate>Thu, 12 Nov 2026 09:32:56 +0800</pubDate><description><![CDATA[本文分享了提升WorkBuddy指令响应稳定性的核心Prompt工程实践：将模糊指令转化为清晰的“规格说明书”，明确字段名、类型、取值范围与输出格式；通过结构化约束（如禁止前缀、强制纯JSON）、少样本示例（1个足矣，重在边界样本）和分步输出（分析+结果分离），杜绝模型自由发挥；结合温度设0、重试时反馈错误信息等技巧，实现零失误。关键在于：凡是能写死的，绝不留给模型猜。]]></description><category></category></item><item><title><![CDATA[006-Skill开发入门：定义、注册与调用机制]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170528301</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170528301</guid><author>zhj_1213</author><pubDate>Wed, 11 Nov 2026 13:45:28 +0800</pubDate><description><![CDATA[本文详解WorkBuddy中Skill的定义、注册与调用机制。Skill是带元信息的可调用单元，需明确命名、描述及执行入口。推荐使用装饰器定义简单技能，类式用于需状态或复杂逻辑的场景。关键在于显式注册——通过app.register_skill()将对象注册，而非依赖自动发现。描述应聚焦“触发条件”，参数需标注类型，返回值统一为dict。调试时可用invoke_skill绕过调度器验证功能。避免名称冲突、描述过长、可变默认值等常见坑。核心原则：注册在前，描述在精，异常结构化处理，确保技能高效、稳定被调用。]]></description><category></category></item><item><title><![CDATA[005-配置文件详解：目录结构与参数体系]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170528214</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170528214</guid><author>zhj_1213</author><pubDate>Wed, 11 Nov 2026 13:44:41 +0800</pubDate><description><![CDATA[WorkBuddy 配置体系采用三层叠加结构：全局、项目层与根目录配置，加载顺序为全局→项目→根文件→环境变量→命令行，支持深度合并但列表操作为替换。关键点包括：config_version: 2 与 strict: true 可避免静默失效；模型参数改后需重启，工具权限可热加载；密钥应存于 credentials.yaml 或环境变量；使用 workbuddy config show --source 查看来源，避免配置“没生效”的排查陷阱。]]></description><category></category></item><item><title><![CDATA[004-核心概念全景：Agent、Skill、Task与Session]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170410088</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170410088</guid><author>zhj_1213</author><pubDate>Tue, 10 Nov 2026 09:28:34 +0800</pubDate><description><![CDATA[本文深入解析 WorkBuddy 中 Agent、Skill、Task 与 Session 四大核心概念：Agent 负责决策规划，Skill 为无状态能力单元，Task 代表一次独立执行，Session 则是多轮对话的上下文容器。强调四者职责分明——任务生命周期与会话管理不可混淆，避免因误清 Session 导致上下文丢失。通过实例阐明正确协作流程：用户消息触发 Task，Agent 基于 Session 上下文规划 Skill 调用，结果回写会话，最终实现连贯智能交互。]]></description><category></category></item><item><title><![CDATA[003-第一个WorkBuddy应用：从零跑通最小闭环]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170410003</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170410003</guid><author>zhj_1213</author><pubDate>Tue, 10 Nov 2026 09:27:39 +0800</pubDate><description><![CDATA[本文手把手指导从零构建首个 WorkBuddy 应用，聚焦“最小闭环”：通过 workbuddy init --template minimal 创建纯净项目，编写 main.py 实现 /echo 和 /count 路由，严格遵循 Request/Response 类型规范，最终用 curl 验证输入→处理→输出链路成功跑通。强调避免常见陷阱（如 req.body 为空、返回值类型错误），并建议通过故意出错、阅读日志、禁用第三方依赖来夯实基础。掌握此闭环，方能为后续功能拓展打下坚实地基。]]></description><category></category></item><item><title><![CDATA[002-环境准备：账号、客户端与开发工具链搭建]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170349163</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170349163</guid><author>zhj_1213</author><pubDate>Mon, 09 Nov 2026 14:51:24 +0800</pubDate><description><![CDATA[本文系统梳理WorkBuddy环境搭建的三大核心层：账号、客户端与工具链。强调配置冲突是常见痛点，建议通过官方安装脚本统一客户端，注册后立即验证默认工作区与专用API Token，使用workbuddy doctor全面自检。推荐使用Node 20 LTS并配置编辑器插件，确保最小闭环（init → run → log）成功。最后提醒：环境问题早解决胜于后期返工，养成升级后重验习惯，以.workbuddy/目录为真相源，高效避坑。]]></description><category></category></item><item><title><![CDATA[001-WorkBuddy是什么：定位、能力边界与典型场景]]></title><link>https://blog.youkuaiyun.com/zhj_1213/article/details/170348656</link><guid>https://blog.youkuaiyun.com/zhj_1213/article/details/170348656</guid><author>zhj_1213</author><pubDate>Mon, 09 Nov 2026 14:40:24 +0800</pubDate><description><![CDATA[WorkBuddy 是一个任务驱动型工作流代理，擅长多步骤拆解、工具调用与状态管理，适用于文档批量处理、跨系统数据流转等需执行闭环的场景。它不擅长开放式生成或实时响应，核心优势在于“有目标、可推进、需确认”的复杂任务自动化。使用时需明确目标、声明工具权限、合理设置确认模式，并重视错误信息调试。建议将其视为需清晰指令的“实习生”，从最小闭环起步，逐步构建复杂流程。]]></description><category></category></item></channel></rss>