一句话定位:这不是三个孤立概念,而是 AI 系统工程关注点的升级。 核心理念:Prompt 解决“怎么说”,Context 解决“喂什么”,Harness 解决“系统怎么让 agent 稳定完成工作”。 3 分钟速览版 点击...
Agent 节点调用数据中台接口返回空列表的处理方案
💭 Agent 节点调用数据中台接口返回空列表的处理方案 💡 核心观点:当中台接口对未匹配的 ID 返回空列表 [] 时,不应要求对方修改接口语义,而是在 Agent 工作流中通过 Python 节点自行补全缺失数据,保证下游节点...
RESTful API 设计规范:返回值、状态码与响应结构
💭 RESTful API 设计规范:返回值、状态码与响应结构 💡 核心观点:HTTP 状态码表达协议层语义,不是业务层语义。理解”单资源 vs 集合”的区分,是正确设计 API 返回值的关键。 🔑 最关键的区分:单资源 vs...
电梯底层代码如何判断该停哪一层:从请求表到方向切换的思考
一句话定位:这篇笔记只关心一件事,电梯代码到底怎么判断该停哪一层。核心理念:电梯不是“算出一个终点再一路开过去”,而是在每一层都基于当前状态重新做一次局部决策。 3 分钟速览版 点击展开核心概念 代码视角里的决策循环graph...
从 OpenSpec 到项目管理经验:一套能落地的需求复杂度评估模型
一句话定位:这是一篇把 OpenSpec、规则分层、项目管理经验和交付风险治理串成一套实战方法的文章。 核心理念:复杂需求真正难的不是写代码,而是先把意图、边界、风险、验证和协作方式定义清楚。 3 分钟速览版 点击展开核心概...
博得之门 3 骰子机制解析:用 Python 模拟 DnD 攻击命中与豁免概率
🎯 一句话定位:把 BG3 里”感觉运气不好”的直觉,变成有数据支撑的概率认知——用 Python 算清楚每一次骰子背后的真实胜率。 💡 核心理念:DnD 的 d20 骰子系统不是纯随机赌博,而是一个参数可控的概率模型。理解了 ...
CI/CD 从零到实战:基于 GitHub Actions 的 Hexo 博客自动化部署
🎯 一句话定位:一个 54 行的 YAML 文件,藏着 CI/CD 工程化思维的五层骨架。💡 核心理念:好的流水线不是命令的堆砌,而是对”触发边界、环境一致性、构建隔离、安全左移、发布可逆”的显式表达。 📖 3 ...
MySQL 线上表结构优化实战:从字段长度分析到批量 DDL 变更
🎯 一句话定位:用两段 SQL,把「凭经验猜字段长度」变成「用数据说话」的线上表结构优化工作流。 💡 核心理念:先分析再变更,数据驱动 DDL,Review 后再执行。 📋 问题背景业务场景项目里有一套调度管理系统,dem...
手动实现 SFTP/FTP 连接池,引发的深思
🎯 一句话定位:从手写 SFTP/FTP 连接池到使用 Commons Pool2,一步步看清”对象池”模式的本质——创建昂贵的资源,池化复用才是正解。 💡 核心理念:连接池不是”缓存连接”这么简单。创建、验证、回收、...
MyBatis sql 标签实战:构建可复用 SQL 片段的最佳实践
🎯 一句话定位:用 <sql> + <include> 实现 Mapper XML 中的 DRY 原则,告别复制粘贴式的 SQL 维护。 💡 核心理念:重复的 SQL 片段不是小问题——当字段名变更时...