架构设计

記億揺晃着的那天

【Agent 架构实战】大模型长期项目开发：决策文档生命周期管理与 CI 门禁治理如果你也在用 Agent 维护长期项目，大概率撞过这样的墙：上个季度就废弃的刷新策略，Agent 偏偏检索到旧文档，理直气壮地写回代码；你问它为什么，它还贴出"出处"证明自己有据可查。问题不在 Agent 记性差，而在仓库从未用机器可读的方式表达过"哪些文档还算数"。本文给出一套零依赖、可直接抄走的方案：三层知识解耦、四状态决策目录、一条 SHA-256 哈希门禁。

【源码解析】DeepSeek-V3 MLA+MoE 推理优化源码硬核拆解：从 KV Cache 压缩到专家路由的工程化破局如果你最近打开过 DeepSeek-V3 的推理代码仓库，大概率会经历这样一条情绪曲线：这不是你菜，而是现代大模型源码的“阅读路径”问题。AI 帮我们写代码越来越快，但读懂一个 10 万行级别的推理引擎，靠 Ctrl+F 和断点已经不够了。本文就带你用架构全景 + 源码逐行的方式，把 DeepSeek-V3 的 MLA 与 MoE 推理优化彻底读透。

阿钱真强道

25 嵌入式操作系统 | 设备面板：用 Qt 控件把“设备“画出来（本节不接串口）title: 嵌入式操作系统 | 设备面板：用 Qt 控件把"设备"画出来（本节不接串口） course: 嵌入式 Ubuntu 系统开发 lesson: 25 module: 模块七综合项目 duration: 2 学时 tags:

阿钱真强道

24 嵌入式操作系统 | 项目启动与环境准备（PyQt5 / Flask 两个“最小可跑“）本课程开源地址（Gitee）：https://gitee.com/fujianxinxi/qianrushixitongyingyongkaifa.git 课件、示例代码与验收脚本都在该仓库，可直接 git clone 或下载 ZIP 使用。

公司发展到一定阶段，到底要不要封装中间件？这个问题其实困扰过很多技术团队，尤其是那些从一条业务线慢慢长成多条业务线的公司。我们自己也走过这条路，从"啥都自己包"到"出了事故赶紧拆"，算是把封装中间件这件事从头到尾经历了一遍。今天就把这些经历和思考整理一下，也算给同行一个参考。

爱上纯净的蓝天

只输出选项和概率的模型：判别层的接口契约与阈值工程最近在整理公司内部那套工单自动分流的链路，顺手把一类新模型放进去试了一遍。这类模型不写一个字，只回一个选项、一个档位或者一个概率。刚开始我以为它不过是"便宜版分类器"，跑了两周之后发现，它在系统里的位置、该盯的指标、出问题的姿势，跟分类器和大模型都不一样。这篇把这两周的结论整理一下，偏架构和工程，不涉及模型内部原理。

【Agent Harness】Gliding Horse 最新进化：从“能学习”到“可验证的自主进化”摘要：本文深入解析 Gliding Horse 从 v0.1.5 到最新代码的核心升级——如何将 AI Agent 从“能学习”推向“可验证的自主进化”。文章围绕持续学习闭环、执行效果契约、双编排统一、强类型上下文模型、可观测性、安全加固、工作区感知、TUI 交付验证等八大模块展开，揭示“把智能变成可验证的智能”这一核心命题背后的工程实践与设计哲学。关键词：AI Agent；自主进化；可验证智能；持续学习；PDCA 编排；JSON-LD DAG；强类型上下文；可观测性；安全加固；Rust 系统工程

記億揺晃着的那天

Amazon Ads API 实战：如何高精度关联广告活动（Campaign）与 ASIN 及 ERP 产品主数据在开发跨境电商 ERP、广告自动化投放系统或数据分析平台时，如何准确将亚马逊广告活动（Campaign）与对应的 ASIN（推广商品）及企业内部的产品主数据进行关联，是一个看似简单却极具挑战的技术课题。

Gin 项目里的错误处理：让 Controller 不必知道错误是怎么来的刚开始写 Gin 项目的时候，Controller 基本都长这样：问题不在于它能不能跑，而在于：Controller 被迫知道了错误是从哪一层、因为什么原因产生的。gorm.ErrRecordNotFound 是数据访问层的概念，它不该泄漏到 HTTP 层。等哪天你把 GORM 换掉，或者给这个查询加一层缓存，所有 Controller 都得跟着改。

一次RabbitMQ重启引发的网关雪崩复盘晚上生产告警群里突然开始刷屏。网关 Pod 不断重启，有客户反馈操作页面时好时坏，K8s 事件里清一色的：

衍生素材链怎么设计？截帧、音频与子素材的关联管理复盘做素材管理的人迟早会撞上一个问题：你下载了一条 10 分钟的直播回放，真正有用的其实只有第 3 分钟那段演示和第 6 分钟那段金句。你把这两段剪出来存了，结果过两周想回看"当时那段演示的前后语境"，原片早删了，截出来的片段成了孤儿——没了来源、没了上下文、更没了和原片的关联。这就是"衍生素材"的管理难题：素材不是孤立的文件，而是一棵从原片长出来的树。这篇文章以我们桌面素材库的一次功能复盘，讲清楚衍生素材链（截帧、音频、子素材）该怎么设计，核心就一句话——让派生出来的每一片，都记得自己从哪来。

递归尽头是星辰

软件架构风格：范式、落地形态与选型权衡很多开发者对架构风格存在认知偏差：要么把它等同于 “整套系统的顶层业务规划”，要么认为一个系统只能有一种架构风格。本质上，架构风格是架构层面的可复用设计范式，地位等同于代码领域的 GoF 设计模式，是软件工程实践沉淀下来的组件组织经验。它既可以作用于整个系统，也可以作用于单个模块、一条处理链路；一个成熟的分布式系统，必然是多种架构风格的混合体。

素材库智能集合怎么设计？把多维筛选存成动态收藏的功能复盘你有没有算过这样一笔账：上周收藏的那批竖屏产品特写素材，今天要用的时候，你花了多久才把它们找齐？打开素材库，点平台筛选，点类型筛选，翻到上周的收藏记录，再肉眼排除掉横屏和口播片段——十分钟后，素材终于拖进了剪辑软件。而同样的筛选动作，这一周你已经重复了四遍。

Patrick在香港

模型路由器实测：12 个任务省 77%，旗舰过载时的降级要打出显式标记“API 要涨了：留下、换模型还是上路由？”——这句话里最值钱的词是"路由"。用一整个工作日的 12 个任务实测一个成本感知路由器：同样的活，全用旗舰模型要 1200 个归一化成本单位，路由后只花 276，省 77%。方法是朴素的三层结构：mini=8 / mid=30 / flagship=100，按价格升序找"最便宜的能胜任档位"，复杂度标签由应用侧打——faq reply 落 mini、contract review 才配旗舰。

多素材对比同步播放怎么设计？对齐播放与差异高亮的功能复盘凌晨的某个版本评审会上，设计师指着屏幕问了一个我答不上来的问题：“用户要对比三条素材，为什么不能让它们一起放？“当时我的第一反应是"这有什么难的”，两周的弯路之后我才明白：多路视频同步播放这件事，难的从来不是"同时按下播放键”，而是让三条不同时长、不同帧率、不同编码的素材，在任意时刻都停在"可比较"的位置上。而这个功能，恰恰是素材筛选里被低估最深的一个。

长脖鹿Johnny

游戏输入系统框架设计（三）：网络输入权威与可验证性联网输入的核心边界不是把本地事件原样转发，而是明确客户端时间、消息顺序和服务器模拟时间各自能证明什么，再由服务器决定输入意图是否进入权威状态。本篇集中讨论这一边界及其验证方法。

記億揺晃着的那天

Amazon SP-API 报告创建全流程与状态机：从创建、轮询到下载入库，新手避坑指南本文基于 Selling Partner API（SP-API）Reports API v2021-06-30。

【架构师从入门到进阶】第五章：DNS&CDN&网关优化思路——第八节：网关-注入攻击与预防这篇文章我们来看SQL注入。SQL注入攻击的原理呢？我们来简单说一下，它就是通过攻击者在http的请求当中注入恶意的SQL命令，比如说把某个表进行删除，那么服务器在用请求参数构造数据库的命令的时候，恶意的SQL语句也被一起构造了，我们来写一个例子。

【架构师从入门到进阶】第五章：DNS&CDN&网关优化思路——第七节：网关-XSS攻击与预防在前面的文章中，我们讲了负载均衡，讲了请求从客户端出发到服务器的中间过程。我们是按照用户请求到达我们服务器的顺序来讲解我们架构方面的知识的。

亿牛云爬虫专家

聊聊数据的“冷热分离“：如何对历史爬虫数据进行合理的归档与压缩存储？作者按：这是一篇写给爬虫工程师和数据处理同学的实战笔记。我们不谈虚的，直接从"数据是怎么堆成山的"讲起，再给一套能直接抄走的代码。文中的代理部分基于亿牛云的隧道代理产品，代码全部带中文注释。