记录技术与生活的个人博客https://caiwei.online/zh-CNhttps://caiwei.online/blog/cordis-context/https://caiwei.online/blog/cordis-context/ctx 不只是"一个对象"——它是 Proxy、是原型链的起点、是 146 行里装下整个框架入口的设计。逐行读 context.ts。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-capstone/https://caiwei.online/blog/cordis-capstone/毕业项目——配置树 + 依赖注入 + 事件总线 + 优雅关机，用 Cordis 组装一个完整的微型任务服务，并对照 dsh 检验学习成果。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-events-dispatch/https://caiwei.online/blog/cordis-events-dispatch/emit/parallel/serial/bail/waterfall 的实现原理——events.ts 全文精读，waterfall 的实现只有 9 行。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-fiber-effect/https://caiwei.online/blog/cordis-fiber-effect/ctx.effect 的四种形态、disposables 的逆序清理、epoch 保险与 EffectMeta 诊断树——fiber.ts 核心机制精读。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-dependency-injection/https://caiwei.online/blog/cordis-dependency-injection/「等依赖就绪再启动」是怎么实现的——Inject.resolve、epoch、notify 级联加载，全部从 fiber.ts 源码讲起。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-fiber-lifecycle/https://caiwei.online/blog/cordis-fiber-lifecycle/PENDING → LOADING → ACTIVE → UNLOADING → DISPOSED——fiber 状态机的完整迁移图、_reload/_unload 的实现与三条铁律。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-first-plugin/https://caiwei.online/blog/cordis-first-plugin/Cordis 插件的三种合法形态、Config 校验、以及让插件真正跑起来的三种启动方式——全部配上可运行代码。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-hmr/https://caiwei.online/blog/cordis-hmr/改配置不重启的秘密——internal/update waterfall、fiber.update/restart 的实现，以及 dsh 配置热重载的完整链路。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-learning-path/https://caiwei.online/blog/cordis-learning-path/逐行读懂 dsh 底层的插件框架 Cordis——从第一个插件到 fiber 生命周期、事件分发、作用域与热重载，全部结合 vendored 源码讲解。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-scopes/https://caiwei.online/blog/cordis-scopes/isolate/intercept 的原型链实现、Service 的作用域判定、dsh 按作用域过滤事件——"每个 agent 一个世界"的完整原理。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-services/https://caiwei.online/blog/cordis-services/服务如何注册进 ctx、Service 基类构造器做了什么、可调用服务与拦截配置合并——读 service.ts 与 reflect.ts。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-typed-events/https://caiwei.online/blog/cordis-typed-events/声明合并如何让事件名与参数获得类型约束、Context.filter 如何实现作用域过滤、internal/* 内部事件全家福。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-token-estimator/https://caiwei.online/blog/newapi-token-estimator/上游还没响应就要先扣费——new-api 如何用字符级状态机、按厂商权重表和图像分块公式，把 token 估算做到"够准、够快、够安全"。Mon, 07 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/context-economics-and-caching/https://caiwei.online/blog/context-economics-and-caching/上下文是稀缺资源，KV cache 是它的物理规律——为什么系统提示词要逐字节稳定，两个系统如何为缓存而设计。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/agent-evals/https://caiwei.online/blog/agent-evals/「跑通一次很容易，可靠才难」——单步评测、端到端评测、LLM-as-judge 与回归集：让 agent 的每次改动可度量。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/handwrite-agent-loop/https://caiwei.online/blog/handwrite-agent-loop/不用任何框架，把 function calling 装进 while 循环——然后对照 Codex 的 run_turn 和 dsh 的 agent-loop，看工业版在哪些地方加了码。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/jit-context-and-subagents/https://caiwei.online/blog/jit-context-and-subagents/上下文窗口装不下所有信息——按需检索、运行时注入、子 agent 隔离：两个系统如何让上下文「要时才有」。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/llm-api-fundamentals/https://caiwei.online/blog/llm-api-fundamentals/不谈原理只谈接口——token 与上下文窗口、采样参数、流式输出、function calling 的完整 wire 格式，以及 Codex 与 dsh 在模型接入层的不同取舍。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/mcp-in-practice/https://caiwei.online/blog/mcp-in-practice/Model Context Protocol 的架构与实战——写一个自己的 MCP server，接进 mini-agent，看 Codex 与 dsh 如何把它当工具生态通用语。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/memory-and-compaction/https://caiwei.online/blog/memory-and-compaction/长会话不爆窗、跨会话记得住——compaction 的两种流派、记忆系统的两大范式，以及「一个文件系统是不是就够了」。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/multi-agent-patterns/https://caiwei.online/blog/multi-agent-patterns/orchestrator-workers、evaluator-optimizer、专业分工——多 Agent 的三种正确用法、四种翻车方式，以及两个系统各自的实现。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-architecture-lifecycle/https://caiwei.online/blog/newapi-architecture-lifecycle/一个 sk-xxx 请求从进门到返回的完整旅程——new-api 的分层架构、路由组织、中间件链，以及模块之间靠什么协作。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-auth-tokens/https://caiwei.online/blog/newapi-auth-tokens/sk-xxx 的完整校验链路、控制台 session 与 access token 的分流、多协议 key 的兼容设计，以及 token 缓存的「突变 fence」——new-api 的鉴权全景。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-billing-ratios/https://caiwei.online/blog/newapi-billing-ratios/预扣费 → 结算 → 退款的三段式计费、模型/补全/缓存/分组四层倍率公式、阶梯计费表达式与双资金来源——把「按 token 收费」做对的全部细节。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-cache-performance/https://caiwei.online/blog/newapi-cache-performance/渠道缓存全量重建、Redis Lua 原子预扣、突变 fence、五类批量落库、过载保护——new-api 扛住并发的全部手段，逐个拆解。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-channel-management/https://caiwei.online/blog/newapi-channel-management/渠道是网关的弹药库——Channel 的完整字段解析、多 key 模式、渠道测试如何走完整 relay 链路、model_mapping 的链式重定向与环检测。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-learning-path/https://caiwei.online/blog/newapi-learning-path/开源大模型网关 new-api 的完整学习路径——按功能模块逐篇拆解：请求生命周期、鉴权、渠道、relay 适配器、负载均衡、计费、日志、缓存与插件。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-loadbalancing-retry/https://caiwei.online/blog/newapi-loadbalancing-retry/优先级分档、加权随机、重试降档、auto 组跨组切换、自动熔断——new-api 如何让几十个不可靠的上游像一个非常可靠的端点。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-logging-observability/https://caiwei.online/blog/newapi-logging-observability/每一笔消费都可追溯——logs 表的字段与索引设计、八类日志、request_id 双链路排障、数据看板与性能剖析三件套。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-plugins-deployment/https://caiwei.online/blog/newapi-plugins-deployment/在 Go 里安全地跑 JavaScript——jsplugin（sobek 引擎）的沙箱与信任边界、声明式任务插件的完整结构，以及单二进制与多机部署实践。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-relay-adaptors/https://caiwei.online/blog/newapi-relay-adaptors/new-api 的技术心脏——Adaptor 接口方法集、relaykit 四协议互转矩阵、SSE 流式处理、参数覆盖引擎，以及新增一个上游提供方的完整清单。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/newapi-users-groups/https://caiwei.online/blog/newapi-users-groups/分组是 new-api 最被低估的设计——一个字段同时决定权限面、渠道选择和计费倍率。用户模型、角色体系、usingGroup 判定与分组联动全解析。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/prompts-and-tool-design/https://caiwei.online/blog/prompts-and-tool-design/系统提示词的分层结构、稀疏 order 的确定性排序、工具描述的「何时用/何时不用」——dsh 与 Codex 各自的工业化答案。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/rag-engineering/https://caiwei.online/blog/rag-engineering/分块策略、重排、混合检索、效果评估——最小实现之后，决定检索质量的五个工程决策与一张「接知识」决策表。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/sandbox-permissions-security/https://caiwei.online/blog/sandbox-permissions-security/模型会犯错也会被骗——审批策略、OS 沙箱、prompt injection 防御：给 mini-agent 装上两个系统的安全体系。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/rag-minimal/https://caiwei.online/blog/rag-minimal/embedding、分块、向量检索——100 行跑通检索增强；以及一个反直觉的事实：coding agent 们为何都不内置 RAG。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ship-your-agent/https://caiwei.online/blog/ship-your-agent/可观测性、成本预算、渐进式放权——把 mini-agent 变成一个你敢让它跑在生产上的系统。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-capstone/https://caiwei.online/blog/ts-capstone/毕业项目——把 12 篇的技能组装成一个可运行的微型 agent 服务：插件化工具注册、SSE 流式输出、优雅关机，一次写完。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-event-loop-emitter/https://caiwei.online/blog/ts-event-loop-emitter/单线程为什么不卡——事件循环的工作方式、微任务与宏任务、EventEmitter 模式，以及 Cordis 事件系统的雏形。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-generics-declaration-merging/https://caiwei.online/blog/ts-generics-declaration-merging/dsh 最"魔法"的三个类型技巧——接口声明合并（ctx 键）、泛型约束（工具参数推导）、条件类型，全部拆开讲。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-http-sse/https://caiwei.online/blog/ts-http-sse/不用框架从零写 HTTP 服务、实现 SSE 流式端点——AI 回复"打字机效果"的全部原理，一次写明白。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-learning-path/https://caiwei.online/blog/ts-learning-path/为「读懂 DeepSeek Harness 源码」和「写出生产级 agent」设计的前置课——只教需要的部分：类型系统、异步、插件模式、HTTP 流式。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-mini-agent/https://caiwei.online/blog/ts-mini-agent/把 Agent 专栏第 4 篇的 100 行 Python agent 用 TypeScript 重写——同一份逻辑、两种语言，检验地基学得扎不扎实。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-modules-npm/https://caiwei.online/blog/ts-modules-npm/ESM 的 import/export、package.json 的关键字段、pnpm workspace 与 monorepo——读懂 dsh 的 import 图。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-plugin-host/https://caiwei.online/blog/ts-plugin-host/亲手实现 Cordis 的最小版——插件注册、依赖注入、事件总线与可逆副作用，60 行代码读懂"一切皆插件"。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-process-signals/https://caiwei.online/blog/ts-process-signals/SIGTERM 和 SIGINT 是什么、退出码的语义、如何把"正在进行的任务做完再走"——dsh 优雅关机机制的原理与最小实现。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-promise-async/https://caiwei.online/blog/ts-promise-async/异步的正确心智模型——Promise 是"稍后兑现的值"，async 函数是"看起来同步的异步代码"，附 agent 场景的全部用法。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-reading-opensource/https://caiwei.online/blog/ts-reading-opensource/以 dsh 为例演示一套可复用的源码阅读流程——从 README 到主干道，四步读懂任何大型项目，附 dsh 的完整走读记录。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-schema-validation/https://caiwei.online/blog/ts-schema-validation/用 zod 实现运行时校验与类型推导的双赢——亲手写一个迷你版 defineTool，理解"schema 是唯一事实源"。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/ts-type-system/https://caiwei.online/blog/ts-type-system/只教读 dsh 源码需要的类型知识——基础类型、联合与收窄、接口、只读、类型断言，每个概念配真实源码影子。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/what-is-an-agent/https://caiwei.online/blog/what-is-an-agent/workflow 与 agent 的分界线、智能体的最小定义、agent 化程度的光谱，以及为什么 Codex 和 dsh 都选择先做 coding agent。Sun, 06 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/agent-learning-path/https://caiwei.online/blog/agent-learning-path/从零构建 AI Agent 的六阶段学习路径——每个概念都用 DeepSeek Harness 与 OpenAI Codex 两个开源智能体的真实源码对照讲解。Sat, 05 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/codex-tools-sandbox-mcp/https://caiwei.online/blog/codex-tools-sandbox-mcp/ToolRouter 与内置工具、四级审批策略与规则引擎、三平台沙箱、MCP 与 code-mode——Codex 把「安全地放权给模型」做成了系统工程。Sat, 05 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/codex-agent-architecture/https://caiwei.online/blog/codex-agent-architecture/拉下 codex 开源仓库逐层拆解——120 个 Rust crate 如何组织出一个生产级 coding agent：线程、turn 循环、工具并发与会话录制。Sat, 05 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/dsh-vs-codex-agent-patterns/https://caiwei.online/blog/dsh-vs-codex-agent-patterns/浓缩 dsh 的架构精髓，与 Codex 并排对照——两个彼此独立的生产级 agent 在设计上不约而同的十个决定。Sat, 05 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/build-from-source/https://caiwei.online/blog/build-from-source/clone 到 pnpm dsh web 之间发生了什么——四步构建流水线、两个 TypeScript 世界、以及为什么产物缺一不可。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/capability-seams/https://caiwei.online/blog/capability-seams/Service Definition / Provider / Consumer 三角色——dsh 把「可替换」做成了一等公民。以文件系统为例走通一条完整链路。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/agent-loop-internals/https://caiwei.online/blog/agent-loop-internals/turn 与 step 的状态机、inbox 三入口、pre-step 改写与拒绝、事件瀑布与 turn-stopping——循环本体逐行读。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/cordis-plugin-framework/https://caiwei.online/blog/cordis-plugin-framework/dsh 构建在 Cordis 之上——插件的三种形态、ctx 键、类型化事件、五种分发模式、effect 与 fiber 生命周期。读 dsh 任何源码前先读这篇。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/deepseek-harness-learning-path/https://caiwei.online/blog/deepseek-harness-learning-path/dsh 是什么、源码地图长什么样、以及由浅入深的六阶段学习路线——本专栏的全部规划都在这一篇。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/dsh-in-10-minutes/https://caiwei.online/blog/dsh-in-10-minutes/不读一行源码，先把 dsh 跑起来——三种启动方式、配置树长什么样、退出码与信号的意义。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/human-in-the-loop/https://caiwei.online/blog/human-in-the-loop/ask 决策如何变成浏览器里的审批卡片、两档权限预设的旋钮模型、凭据为什么只存引用——dsh 的安全边界全在这篇。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/llm-adapter-streaming/https://caiwei.online/blog/llm-adapter-streaming/ctx.llm 的适配器 seam、七种 StreamChunk、start/chunk/end 实时帧与持久 settlement 的双轨制——以及 deepseek 适配器的每一处细节。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/product-forms-web-headless-sdk/https://caiwei.online/blog/product-forms-web-headless-sdk/同一棵插件树，三种出口——浏览器 GUI 的 host/client 分工、一次性运行的退出码、以及一条 JSON-RPC 管道。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/profiles-and-bundles/https://caiwei.online/blog/profiles-and-bundles/运行中的 dsh 是一棵按序叠加的插件树——patch 的语法、层的优先级、五种 profile 的差异，以及为什么 web profile 改配置不用重启。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/session-append-only-log/https://caiwei.online/blog/session-append-only-log/12 种会话事件、deriveMessages 投影、「模型可见即已记录」不变量——dsh 不存消息历史，只存事件日志。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/system-prompt-assembly/https://caiwei.online/blog/system-prompt-assembly/片段注册、集中分配的稀疏 order、协作式 waterfall——dsh 把「模型是谁、能用什么工具」变成一份可缓存的确定性文本。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/tools-execution-pipeline/https://caiwei.online/blog/tools-execution-pipeline/从 tool/call 落日志到 tool/result 回流——注册表、pre-execute 决策、审批、单调 guard、环绕分发、post-execute 改写，十道工序逐一看。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/write-your-own-plugin/https://caiwei.online/blog/write-your-own-plugin/从零写一个工具、用 --patch 挂载、在 Web UI 里验收——并把前十二篇的机制全部用上。专栏收官之作。Fri, 04 Sep 2026 00:00:00 GMThttps://caiwei.online/blog/features-demo/https://caiwei.online/blog/features-demo/一次看懂本站新增的 Pagefind 搜索、KaTeX 公式、彩色提示块与 MDX 支持Mon, 24 Aug 2026 00:00:00 GMThttps://caiwei.online/blog/mermaid-diagrams/https://caiwei.online/blog/mermaid-diagrams/流程图、时序图、甘特图、饼图……纯 Markdown 文本画图，自动跟随博客主题配色Mon, 24 Aug 2026 00:00:00 GMThttps://caiwei.online/blog/hello-world/https://caiwei.online/blog/hello-world/记录本站如何在一台腾讯云服务器上，用 Astro + Caddy 从零搭建上线。Sat, 22 Aug 2026 00:00:00 GMThttps://caiwei.online/blog/why-static-blog/https://caiwei.online/blog/why-static-blog/对比了几种方案后，静态博客的简单可靠胜出——原因都在这篇文章里。Fri, 21 Aug 2026 00:00:00 GMT