知识分享
技术文章、实战教程、经验心得
Code Agent 解剖（11）：Harness 设计之一——控制流
从 harness 工程设计视角审视 MyCodeAgent 的控制流：为什么选择单一主循环而不是多循环、不可变状态机的工程价值、完成门的反馈回路设计、终止路径的完备性。这是 Part 4 Harness Engineering 的第一篇，关注的是「为什么这样设计」而不是「是什么」。
Code Agent 解剖（09）：对话越来越长，token 超了怎么办？
深入 MyCodeAgent 的上下文工程：HistoryManager append-only 事实日志、ProjectionBuilder 读时投影、ContextBudgetPolicy 触发判断、ContextCompactor LLM 摘要压缩。理解为什么「历史永不删除」和「给模型看有界视图」是两件完全不同的事，以及 agent 如何在不丢失事实的前提下把上下文压进预算。
Code Agent 解剖（10）：agent 崩了怎么恢复，对话历史存在哪？
深入 MyCodeAgent 的持久化与恢复机制：TranscriptStore append-only JSONL 事件流、五种事件类型、ResumeLoader 从事件重建运行时状态、UncertainAction 的工具中断处理、SessionMemory 跨 run 的前馈记忆。理解 agent 为什么不能靠内存存历史，以及崩溃后确定性恢复的完整链路。
企业知识库系列（03）：图增强 RAG 实测——GraphRAG vs HippoRAG
同一套 89 道测试题，分别对 GraphRAG 3.1.1 和 HippoRAG 2.0 跑评测。本文记录从部署到出数据的完整过程，包括 GLM-4-flash 结构化输出失败、LanceDB 向量维度不匹配、NV-Embed-v2 离线加载等真实踩坑，以及两个框架在单跳、多跳、边界拒答三个维度上的真实数据。
Code Agent 解剖（08）：一个任务太复杂，怎么拆给子 agent 做？
深入 MyCodeAgent 的子 agent 机制：Task 工具、RuntimeProfile 沙箱约束、SubagentLauncher 完整执行链路、结构化结果合约。理解主 agent 如何把探索性任务委派给只读轻量子 agent，以及为什么子 agent 不是「简化版主 agent」而是受严格约束的执行单元。
Code Agent 解剖（07）：外部工具怎么接进来？MCP 集成是怎么做的？
深入 MyCodeAgent 的 MCP 集成：可选依赖、配置发现、stdio/HTTP 传输、Adapter 把远端工具伪装成本地 Tool、结果收成通用协议。理解外部能力如何进入同一条工具管道，以及「注册进目录」和「允许执行」为什么不是一回事。
开源项目第192期：shadcn-admin — Vite + shadcn/ui 构建的后台管理界面参考集，10+ 页面、RTL 支持、无障碍优先，不是模板，是可复用的 UI 参考库
satnaing 开源的后台管理 UI 参考集，基于 shadcn/ui + Vite + TanStack Router 构建。包含 Dashboard、Tasks、Users、Chats、Apps、Settings、Help Center 等 10+ 页面，全局搜索命令、亮暗模式、RTL 布局支持、Clerk 认证集成。定位是 UI 参考集合而非开箱即用脚手架，Radix UI 底层保证无障碍访问。不依赖 Next.js，纯 Vite 构建，性能更轻。13.9k Stars，MIT。
开源项目第193期：Semantica — 开源版 Palantir for AI Agent，知识图谱 + 确定性推理 + W3C 溯源，让 AI 决策可追溯、可审计、可合规
semantica-agi 出品的图原生 AI 基础设施层，定位为 AI Agent 的上下文和决策可问责层。知识图谱构建（Neo4j/FalkorDB/RDF）、确定性推理（Rete/Datalog/SPARQL/前向链，不依赖 LLM）、W3C PROV-O 溯源（每个事实可追溯来源）、冲突检测与解决、时间点快照（time travel）、合规导出（OWL/SHACL/RDF）。不是 RAG 框架，不是向量数据库，是坐落在所有这些之下的可解释决策层。支持 Claude Code、Cursor、Codex、Agno、CrewAI、LangChain、LlamaIndex 等生态。8.2k Stars，MIT。
开源项目第194期：deepseek-harness — DeepSeek 出品的 AI Agent 开发框架，万物皆插件 + PTC 程序化组合模式 + 完整轨迹溯源，137k Stars
DeepSeek AI 出品的 Agent 开发框架，以 Cordis 插件架构为核心——内核只管插件生命周期，其余一切（工具、后端、UI）均为可替换插件。四种运行模式：Standard（完整工具链）、PTC（模型写 TypeScript 程序组合操作，不是逐步调用工具）、Minimal（极简 bash 环境，用于 benchmark）、Creative（运行时插件试验）。Append-only 会话日志记录系统提示、CoT、工具调用、子 Agent 调度的每一步，支持 resume/fork/replay。npx @deepseek-ai/dsh web 一行启动。137.1k Stars，MIT。
开源项目第195期：OpenTelemetry Demo（Astronomy Shop）— 官方出品的分布式系统可观测性实战教材，12种语言 + 17个微服务 + 13个故障开关，50+ 云厂商用它做集成演示
OpenTelemetry 官方出品的分布式电商演示系统 Astronomy Shop，以接近真实的微服务架构展示 Traces/Metrics/Logs 三大信号的完整实现。17个服务覆盖 .NET/Go/Java/Kotlin/Python/Rust/Ruby/PHP/C++/TypeScript/JavaScript/Elixir 12种语言，13个可开关的故障场景（内存泄漏、CPU 飙升、服务不可达、Kafka 堆积），Grafana + Jaeger + Prometheus 全套可视化。Datadog、Elastic、AWS、GCP、New Relic、Dynatrace 等 50+ 家厂商基于此项目构建集成演示。Docker 或 Helm 一键部署。3.3k Stars，Apache-2.0。
Code Agent 解剖（05）：模型怎么知道有哪些工具可以用？Function Calling 如何实现？
跟着一次 tool_call 从头走到尾：工具如何注册进 Registry、Registry 如何生成 function schema 告知模型、模型触发 tool_calls 后 Orchestrator 如何分批执行、ToolExecutor 的权限/乐观锁/熔断管道、ToolResult 协议为什么要内外分离、以及观测结果怎么截断写回 history。
Code Agent 解剖（06）：agent 的能力怎么用 Skills 动态扩展？
深入 MyCodeAgent 的 Skills 动态扩展机制：一个只需要放一个 Markdown 文件就能让 agent 获得新能力的系统。完整走过定义→扫描→注入→调用→执行的生命周期，理解零代码扩展、按需加载、热更新背后的设计。