# 卓琪的开发笔记

> AI 应用开发工程师刘卓琪的技术博客。记录 Agent 产品开发、后端工程、上下文工程、RAG、工具调用与 AI 安全的实战与调研。

本站是刘卓琪的技术博客，聚焦 AI Agent、记忆系统、上下文工程、RAG、工具调用、后端架构与生产实践。每篇文章都有中英两版，并在文章地址后加 `index.md` 提供 Markdown 原文（例如 /posts/<slug>/index.md）。下面按发布时间倒序列出。

## 文章

- [买中转 API 之前先验货——六个问题判断这家卖的是不是真模型](https://zhuoqidev.com/posts/verify-llm-relay-api/index.md): 2026-10-24 · 便宜的 Claude、GPT、Seedance 中转站越来越多，分组名写着「官转」「官 key」「原生」，但分组名不是证据。真正能把这家卖的东西和官方对上号的，是响应 id 的前缀、和官方计数接口逐个对得上的 token、故意发错参数时的报错、视频文件里的 C2PA 签名和签名证书，以及它自己日志里的实扣。这篇按六个问题讲清每一项怎么查、要不要花钱、看到什么算有问题，没有官方 key 时怎么办，最后给出一个把整套流程交给 Agent 跑完、自动出对照报告的开源 skill。
- [Mac 到底适不适合跑大模型？——苹果和英伟达的宣传页上，都没写的那几个数](https://zhuoqidev.com/posts/mac-for-local-llms/index.md): 2026-10-18 · 苹果说 Mac mini「快速、私密的本机推理」、提示处理快 13.5 倍；英伟达说笔记本 RTX 5090 有 1,824 AI TOPS。小字里的对比对象、测试配置，和真正决定你用起来快不快的三个数——内存带宽、读提示词的算力、GPU 实际能用的内存——却都没摆在显眼处。这篇用 llama.cpp 社区几十台机器的统一跑分、两台手头机器的核验，再按苹果脚注的原测法在 16 GB 基础款上复现一遍，再摆出它在写代码、编译、跑测试上实测赢下的部分，分场景回答 Mac mini、Mac Studio 和各档 N 卡到底适合干什么。
- [上线一个应用，每月要花多少钱？——服务器、Serverless、边缘函数怎么选，先学会拆三笔账](https://zhuoqidev.com/posts/model-gateway-cloudflare-vs-china-cloud/index.md): 2026-10-09 · 写给想把第一个应用放上线、却不知道该买服务器还是用 Serverless 的人。先讲清云厂商的货架上卖的几样东西，再教你把自己的应用拆成三笔账（时间花在等还是算、每个请求搬多少字节、要不要一笔一笔记账），给个人网站、小程序后端、AI 应用、图片处理工具四种常见应用对号入座，查清各家免费额度和新人价；最后拿一个模型网关从零搭一遍，用 aliyun CLI、tccli、各家公开价格接口和官方价目页实查 2026-10-09 七家云的价格，把每月 1,000 万、1 亿、10 亿次请求的账单算到每一项。
- [让 Agent 替你管十几个海外社媒号——2026 年 10 月约 60 家发帖、评论、私信 API 与 MCP 逐格横评](https://zhuoqidev.com/posts/social-publishing-inbox-apis-2026/index.md): 2026-10-09 · 想让 Claude Code 这类 Agent 一键把内容发到 X、LinkedIn、YouTube、Instagram 等多个账号，还能看评论、回私信，能做到哪一步先由平台官方 API 决定，工具只是把这些官方能力搬进一个接口。X 从 2026-02 起只许程序回复 @ 了你的人，LinkedIn 个人号的评论和私信谁都读不到，Facebook 只能发主页，Threads 和 YouTube 没有私信接口。在这个上限之内，我把约 60 家统一 API、社媒管理套件、开源项目和会话型接口按「平台 × 发帖 / 评论 / @ / 私信」逐格核对 2026-10-09 的官方文档，按对接完善度打分排序，价格只放第二列，并写清哪些实测过、哪些只读了文档。
- [让 Agent 自己验收、自己整理记忆——Outcomes 与 Dreaming 的文档拆解，附 Claude Code /goal 实测](https://zhuoqidev.com/posts/managed-agents-outcomes-dreaming/index.md): 2026-10-06 · Outcomes 让一个看不到写手思路的独立评审按评分标准逐条验收，不合格就返工；Dreaming 在会话之间读旧记忆和历史会话，另外生成一份整理好的记忆库，原库不动。这两个都是 Claude 开发者平台 Managed Agents 的接口，Claude Code 里没有。本文按官方文档讲清它们为什么必要、怎样工作，再找出 Claude Code 里的近亲（/goal 和没放开的 auto-dream），用同一个任务把 /goal 实测了 12 次，最后把设计翻译成能搬到任何 Agent 技术栈的两份契约。
- [Codex 为什么不把所有工具都交给模型？讲透 tool_search、BM25 与模型替换](https://zhuoqidev.com/posts/codex-first-request-tools/index.md): 2026-08-08 · 基于 Codex rust-v0.147.0 源码，用大白话解释工具为什么要按需加载、BM25 如何从大量工具中排出最相关的几个，以及怎样把同一设计搬到 Python、Go 和其他模型。
- [读完 Codex 源码后，我认为最值得企业 Agent 借鉴的是这 5 个设计](https://zhuoqidev.com/posts/codex-agent-design/index.md): 2026-08-02 · 基于 openai/codex 源码，拆解选择性并行、Unified Exec、ExecCell、Skills 渐进上下文、Goal 自动续跑，以及如何通过 App Server 嵌入同一套 Runtime。
- [Agent 如何记住你：人脑记忆史与六大开源系统代码审计](https://zhuoqidev.com/posts/llm-memory-research/index.md): 2026-07-30 · 从 Ebbinghaus、H.M.、工作记忆与 engram 出发，重建 Agent 记忆发展史；再对 Mem0、Letta、Graphiti、LangMem、Cognee、MemoryOS 做宣传卖点与实际代码架构对照。
- [LLM 推理引擎怎么选——2026 年从本地单机到 PD 分离的全景选型地图](https://zhuoqidev.com/posts/llm-inference-engine-selection/index.md): 2026-07-19 · 阿里云那张 Ollama / vLLM / SGLang / HF Pipeline 四引擎表在 2026 年已经不够用了。这篇把推理引擎按「本地 → 高性能服务 → 分布式分离」三层重新梳理，覆盖 8 个主流引擎和 PD 分离 / 投机解码 / FP4 量化三大新趋势，附决策矩阵和决策树。
- [OpenClaw 实战：一行路径省掉 84% 的工具调用——Cron Job 排障实录](https://zhuoqidev.com/posts/openclaw-cron-skill-optimization/index.md): 2026-06-20 · OpenClaw 的 daily-ai-news 定时任务连续超时。根因不是模型不够强、不是 prompt 太长、不是上游 API 挂了——是 SKILL.md 里少写了一行绝对路径，导致 Agent 每次执行花 15 次 exec 调用搜索一个 skill 的位置。消息数从 54 膨胀到 165，工具调用结果从 204KB 暴涨到 1.1MB。这篇记录完整的排障过程和修复方法。
- [OpenClaw 记忆实战：从「向量搜索挂了也能用」到用 NVIDIA 免费 API 补全最后一块拼图](https://zhuoqidev.com/posts/openclaw-memory-text-to-vector/index.md): 2026-06-20 · OpenClaw 记忆系统的向量检索默认不可用——但 BM25 文本搜索兜底让系统照常运转。当你发现「不配 embedding 也能跑」，到底要不要修？怎么用 NVIDIA 免费 embedding API 零成本补上？这是一篇生产环境的真实记录。
- [Claude 工具调用范式转移：Programmatic Tool Calling 与 Dynamic Filter 深度解读](https://zhuoqidev.com/posts/claude-programmatic-tool-calling-dynamic-filter/index.md): 2026-06-13 · Anthropic 在 Claude 平台推出的 Programmatic Tool Calling 和 Dynamic Filtering 不仅是功能增强，更代表了一种 Agent 架构范式的转移——从自然语言编排转向代码编排，从全量上下文注入转向按需过滤。本文综合多篇非 AI 撰写的深度技术文章，从架构原理、性能数据到生产实践，全面解读这场 Outer Loop 的进化。
- [OpenClaw 生产踩坑：当最先进的记忆系统遇到最静默的失败](https://zhuoqidev.com/posts/openclaw-pitfalls/index.md): 2026-05-27 · 从部署到排障，记录 OpenClaw 从启动失败、飞书消息静默吞回复到 production 稳定的全链路实战经验——compaction safeguard、五层排查法、model-harness-fit 与记忆系统对比。
- [生产环境 Agent 实践：为什么我们从 Celery 迁移到 Temporal](https://zhuoqidev.com/posts/why-temporal-not-celery/index.md): 2026-05-16 · Agent 流水线不是普通的异步任务——它有状态、会卡住、需要重放排障、单条失败不能拖垮整批。Celery 每一条都踩坑后才明白 Temporal 不是"另一个任务队列"，而是在解决不同层级的问题。
- [ChatGPT Business 优惠码究竟从哪来？一次溯源与更正](https://zhuoqidev.com/posts/chatgpt-business-promo-investigation/index.md): 2026-05-14 · 重新核对 OpenAI、合作伙伴、Stripe 与 linux.do 的一手资料：优惠并未被统一取消，公开链接、资格审核后邮件发码等机制仍在并存。
- [什么时候用 RAG，什么时候用 LLM Wiki，什么时候用纯文本记忆——一个 Agent 记忆选型框架](https://zhuoqidev.com/posts/memory-choice-framework/index.md): 2026-05-11 · RAG、结构化知识库、纯文本上下文记忆——三种 Agent 长期记忆方案的成本、延迟、精度和可维护性对比，附决策树。
- [在 Hugo 文章里内嵌 CSS 动画 Demo](https://zhuoqidev.com/posts/css-animation-demo/index.md): 2026-05-04 · 用自定义 shortcode 在 Hugo 博客里直接运行 CSS 动画，无需 CodePen 账号，文章即 demo。
- [用 Hugo 和双栈 CDN 搭建个人网站](https://zhuoqidev.com/posts/hugo-dual-cdn-blog/index.md): 2026-05-04 · 记录如何用 Hugo + Blowfish，通过阿里云 OSS/CDN（国内）+ Cloudflare Pages（国际）实现双栈加速，备案、DNS 分线路解析一次走通。

## 作品

- [AI 厂商状态 — 一页看各家官方状态页](https://zhuoqidev.com/projects/ai-status/): 把 OpenAI、Claude、Gemini、xAI、Mistral、Groq、Amazon Bedrock、DeepSeek、Kimi、MiniMax 等官方状态页的当前状态排成一张报纸：头条写最严重的那家，每家一个天气，点开看组件和进行中的故障；没有状态页的厂商也列出来、写明为什么。Cloudflare Pages 函数每分钟最多读一次各家，不调用任何模型。
- [llm-relay-audit — 中转 API 验货的 Agent Skill](https://zhuoqidev.com/projects/llm-relay-audit/): 开源的 Agent skill：把一家 AI API 中转站（new-api / one-api / sub2api）和官方 API 逐项对比，判断是不是真模型、有没有换模型或注入提示词、视频是不是官方原片、参数有没有被吞、实际多收多少，原始请求全部落盘，最后自动出外发证据版 PDF 和内部决策卡。Python + Agent Skills 规范，npx 一行安装。
- [Argus — 纯前端长视频理解 Agent Harness](https://zhuoqidev.com/projects/argus/): 开源的浏览器本地长视频理解 agent harness：视频文件不出本地，多 provider LLM（Vercel AI SDK）+ 切帧/记忆/子代理工具，自带双线 CDN 发布。Vite + React + TypeScript。
- [见微 Vane — AI 个性化信息推送系统（已暂停）](https://zhuoqidev.com/projects/vane/): 独立设计开发、上过生产的 AI Agent 系统（2026-07 至 09，现已暂停）：多信源采集 → LLM 个性化打分 → 飞书推送，带用户画像反馈闭环。Go + Temporal + A2A 协议 + React 全栈。

## 设计灵感库

能单独打开的网页 UI 演示，每条的 index.md 带说明和完整源码，照着就能复现。目录：https://zhuoqidev.com/design/index.md

- [印章按钮](https://zhuoqidev.com/design/stamp-button/index.md) — 按钮与控件 · 按下去像盖章：往下一压、轻轻一拧，松手后纸上留下一枚带颗粒感、慢慢淡掉的红印。
- [荧光笔划过](https://zhuoqidev.com/design/highlighter-button/index.md) — 按钮与控件 · 链接和按钮被荧光笔从左往右涂一道：笔头是斜的、位置偏低、跨行每行单独划，离开时往右擦掉。纯 CSS。
- [一键复制按钮](https://zhuoqidev.com/design/copy-button/index.md) — 按钮与控件 · 复制成功：两张纸收起、画出对勾、文字往上换成「已复制」；失败：变红抖一下。还会念给读屏软件听。
- [磁吸按钮](https://zhuoqidev.com/design/magnetic-button/index.md) — 按钮与控件 · 鼠标靠近，按钮被「吸」过去，里面的字跟得更多，像有厚度；移开时用弹簧弹回原位。JS 只写两个变量。
- [会变形的下拉框：神灯 / 退潮 / 像素](https://zhuoqidev.com/design/pixel-dissolve-select/index.md) — 按钮与控件 · 下拉框的展开 / 收起三选一：神灯（像 Mac 最小化，菜单弯成漏斗被吸进名字）、退潮（带浪花的波浪线向上把菜单冲走）、像素溶解。
- [会睡觉的 Agent 卡片](https://zhuoqidev.com/design/agent-sleep-toggle/index.md) — 卡片与小部件 · 关掉 Agent，蓝色六边形吉祥物缩成灰色圆球、眼睛眯成两道线、头顶冒 z；打开又弹回来。醒着时眼睛跟着鼠标转。
- [底部悬浮药丸导航](https://zhuoqidev.com/design/pill-dock/index.md) — 导航 · 页面底部居中的药丸形导航：毛玻璃底、当前栏目高亮、按下回弹，旁边点缀会闪的小星星。
- [会滑动的激活圆点侧边栏](https://zhuoqidev.com/design/sidebar-active-dot/index.md) — 导航 · 整个目录只有一个圆点：点哪项它就竖着滑过去、换成分组色，落地把文字顶开，颜色再从左往右刷过去；每段速度都照原片逐帧量。
- [拍立得头像](https://zhuoqidev.com/design/polaroid-avatar/index.md) — 卡片与小部件 · 头像做成一张拍立得：白边、一条胶带、一行手写字；放在桌面上可以拖，拖得快会歪，松手弹回。
- [开场 / 告别终端](https://zhuoqidev.com/design/terminal-signoff/index.md) — 动画效果 · 页脚是一段终端会话：see you、联系方式、fortune、exit 逐行打出来；另附一段首访开机动画。
- [三合一状态图标变形](https://zhuoqidev.com/design/status-icon-morph/index.md) — 动画效果 · 信号格沉成四个点、电池缩成一根线，线绕 Wi-Fi 甩一圈半拉成外圈，四个点追进圈底的缺口。每个零件怎么动、动多久，都是照原片逐帧量的。
- [手绘风图表 + 大图查看器](https://zhuoqidev.com/design/hand-drawn-diagrams/index.md) — 图表与 3D · 文章里的流程图画成手绘风 SVG，点开是能滚轮 / 双指缩放、拖动平移、Esc 关闭的大图查看器。
- [桌面式首页](https://zhuoqidev.com/design/desk-home/index.md) — 整页与区块 · 首页做成一张桌子：卡片能拖、拖动时跟着速度倾斜、位置记在本机，双击图标开出能拖能缩放的小窗口。
- [便利贴留言墙](https://zhuoqidev.com/design/sticky-guestbook/index.md) — 整页与区块 · 彩色便利贴墙加发帖框：四种纸色、每张微微歪着、贴胶带，悬停摆正；示例里新便签只存在本机。
- [点阵地球访客地图](https://zhuoqidev.com/design/dot-globe-visitors/index.md) — 图表与 3D · three.js 点阵地球：各国访客数立成红色光柱，蓝色弧线带着光点飞向同一个目的地，可拖动、可点光柱看数字。
- [3D 滚动叙事](https://zhuoqidev.com/design/scroll-3d-story/index.md) — 图表与 3D · 左边 3D 小场景钉住不动，右边文字一步步滚过去：镜头推到当前这一步，零件弹出来，标签跟着 3D 点走。纯 three.js 代码建模。
- [编辑风结论报告页](https://zhuoqidev.com/design/value-ledger-report/index.md) — 整页与区块 · 结论先行的杂志式报告：衬线大标题、一张大结论卡加四张小卡、Chart.js 图表配可点图例，表格各自横向滚动。
- [地图 + 筛选侧栏](https://zhuoqidev.com/design/map-filter-finder/index.md) — 整页与区块 · 左侧多段筛选、右侧 Leaflet 地图：结果列表和标记实时同步，点聚合只数符合条件的点，点列表飞到地图并弹详情。
- [手作纸感](https://zhuoqidev.com/design/handmade-paper/index.md) — 整体风格 · 奶油纸色 + 点阵底，印章红 / 钢笔蓝 / 荧光黄；宋体标题、手写批注、便利贴、印章、虚线卡片，深色模式齐全。
- [纯 CSS 动效](https://zhuoqidev.com/design/css-only-motion/index.md) — 动画效果 · 不引动画库：linear() 弹簧缓动、View Transitions 页面过渡、滚动驱动、@starting-style 入场、高度到 auto。
- [落款盖章开场](https://zhuoqidev.com/design/stamp-opening/index.md) — 动画效果 · 首访全屏开场：「卓琪」按真实笔顺一笔一笔写出来，石章压下、抬走留下湿印，印痕飞回顶栏 Logo，页面从 Logo 处洇开。

## Optional

- [全部文章全文](https://zhuoqidev.com/llms-full.txt)
- [关于作者](https://zhuoqidev.com/about/)
- [English version](https://zhuoqidev.com/en/llms.txt)
- [RSS](https://zhuoqidev.com/index.xml)