kalpacode 个人技术博客：后端、前端、运维与 AI 实践记录，站内 AI 导览助手基于文章回答你的问题。http://kalpacode.cn/zh-CNhttp://kalpacode.cn/posts/agent-pipeline-orchestration-protocol/http://kalpacode.cn/posts/agent-pipeline-orchestration-protocol/八个 skill 互相不认识，却能接力跑完整个系统。串起它们的是一套极简协议：文件即接口、一行输出即完成标志、开工先查前置条件。这篇拆解这套协议的每个设计决定，以及它换来的断点续跑、可审计和可替换性。Wed, 19 Aug 2026 00:00:00 GMTAIAI Agent系统设计编排协议http://kalpacode.cn/posts/business-requirement-quality/http://kalpacode.cn/posts/business-requirement-quality/逆向流水线里技术密度最高的一步：如何用质量红线、零合并原则、三级优先级和两阶段执行，约束大模型把 if-else 和拼接 SQL 诚实地翻译成客户也能看懂的业务语言。Wed, 19 Aug 2026 00:00:00 GMTAI逆向工程Prompt 工程输出质量控制http://kalpacode.cn/posts/database-dictionary-ddl-context/http://kalpacode.cn/posts/database-dictionary-ddl-context/祖传系统的数据库往往有几百张表、几千个字段，注释栏里一半空白、一半写着「字段」。数据字典生成这一步先用系统表摸清家底，再让前面所有步骤的业务产物反哺回来，给每个字段写出真正的业务含义——写不出来的，诚实标记待确认。Wed, 19 Aug 2026 00:00:00 GMT后端数据治理数据库逆向AI Agenthttp://kalpacode.cn/posts/doc-asset-organize-merge-index/http://kalpacode.cn/posts/doc-asset-organize-merge-index/几十份业务需求文档散在目录里，还只是散件不是资产。归类、合并、索引三个 skill 接力，把它们变成有账本、有对账、能发现需求缺口的结构化资产库——顺带完成一次意外的需求完整性审计。Wed, 19 Aug 2026 00:00:00 GMTAI文档工程知识组织AI Agenthttp://kalpacode.cn/posts/feature-dev-on-documented-system/http://kalpacode.cn/posts/feature-dev-on-documented-system/让 AI 在老系统上写新代码，最常见的灾难不是写不出来，而是写得太顺。feature-dev 用六条原则和一张映射表，把「读懂的系统」变成写代码的约束条件。Wed, 19 Aug 2026 00:00:00 GMTAIAI 辅助开发正向工程代码规范http://kalpacode.cn/posts/feature-extract-any-stack/http://kalpacode.cn/posts/feature-extract-any-stack/流水线第一步决定后面所有步骤的工作量：认出代码里有多少个功能点。用一张技术栈识别表、一份排除清单和一份 JSON schema，把「找功能」变成可校验的机械活。Wed, 19 Aug 2026 00:00:00 GMTAI逆向工程静态分析AI Agenthttp://kalpacode.cn/posts/link-diagram-call-chain-mermaid/http://kalpacode.cn/posts/link-diagram-call-chain-mermaid/大模型读代码最难的不是某一行代码，而是调用跨过边界的那一瞬：前端到后端、Java 到 SQL、程序到外部系统。这一步用六张技术栈地图、一套图形语义和一道数量门禁，把整条调用链画成一张不许说谎的图。Wed, 19 Aug 2026 00:00:00 GMTAI逆向工程静态分析mermaidhttp://kalpacode.cn/posts/llm-output-quality-three-layers/http://kalpacode.cn/posts/llm-output-quality-three-layers/让大模型写一万字不难，难的是让第一千个字段和第一个字段一样规矩。这条流水线把散落在各步骤里的质控手段收拢成三层防线：写进 prompt 的红线、过程中的闸门、事后的脚本验证，外加防超时、防截断、重试降级三套保命机制。Wed, 19 Aug 2026 00:00:00 GMTAIPrompt 工程输出质量控制AI Agenthttp://kalpacode.cn/posts/reverse-engineering-pipeline-overview/http://kalpacode.cn/posts/reverse-engineering-pipeline-overview/七步逆向、一步正向：一条技术栈中立的 AI 流水线，如何把没人敢动的遗留系统，逐层翻译成功能清单、链路图、业务需求与数据字典，并让这些文档反过来指导新功能的开发。这是 13 篇系列的总览。Wed, 19 Aug 2026 00:00:00 GMTAI逆向工程AI Agent遗留系统http://kalpacode.cn/posts/reverse-to-forward-doc-assets/http://kalpacode.cn/posts/reverse-to-forward-doc-assets/系列完结篇。十二篇讲完了一条流水线的每个零件，最后一篇回答那个贯穿始终的问题：这些文档到底给谁用、怎么用——从新人上手的五级下钻，到审计、测试、二次开发，再到流水线自身的演进方向。Wed, 19 Aug 2026 00:00:00 GMTAI文档资产知识管理逆向工程http://kalpacode.cn/posts/skill-tech-stack-neutralization/http://kalpacode.cn/posts/skill-tech-stack-neutralization/逆向流水线的第一个版本只认识一种技术栈。第二个项目进门那天，每个 skill 都要回答同一个问题：你写的规则里，哪些是这个项目的习惯，哪些是文档工程的规律。改造的答案整理成了四个泛化维度和一条参数与原则的分界线。Wed, 19 Aug 2026 00:00:00 GMTAISkill 设计Prompt 工程逆向工程http://kalpacode.cn/posts/subagent-parallel-divide-conquer/http://kalpacode.cn/posts/subagent-parallel-divide-conquer/一个页面的业务需求要拆几十个事件函数，一个库的数据字典要精修几百张表，串行跑到天荒地老。这条流水线的答案是子代理分治：分批、独立结果文件、模板化任务描述、完整性核对，外加一套主代理的两阶段校验协议，管住并行带来的新风险。Wed, 19 Aug 2026 00:00:00 GMTAIAI Agent并行计算分治设计http://kalpacode.cn/posts/three-stack-pipeline-case-study/http://kalpacode.cn/posts/three-stack-pipeline-case-study/Python+OCR 的报销影像系统、操纵 SAP 的清账平台、ExtJS 工作流老系统——三套画风完全不同的祖传系统跑同一条流水线。复盘各自的难点与零改动复用的环节。Wed, 19 Aug 2026 00:00:00 GMTAI实战复盘逆向工程技术栈适配http://kalpacode.cn/posts/agent-graceful-degradation/http://kalpacode.cn/posts/agent-graceful-degradation/AI 助手一定会失败——Key 欠费、模型超时、网络断流，只是早晚问题。设计的问题是失败时用户看到什么。拆解这个项目的四层防线：首字超时、断流保留、失败冷却、兜底文案，以及兜底机制怎么避免掩盖真因。Tue, 18 Aug 2026 00:00:00 GMTAIAgent降级设计可靠性前端http://kalpacode.cn/posts/agent-memory-design/http://kalpacode.cn/posts/agent-memory-design/LLM 没有记忆，每次请求都是白纸。这个博客助手用三层结构补回来：localStorage 与会话管理器做短期记忆，ChromaDB 做知识长期记忆，System Prompt 做每次请求的工作记忆。Tue, 18 Aug 2026 00:00:00 GMTAIAgentRAG记忆系统ChromaDBhttp://kalpacode.cn/posts/ai-collab-proposal-workflow/http://kalpacode.cn/posts/ai-collab-proposal-workflow/这个项目的大部分代码是 AI 写的，但架构决策一个都没交给它。两天上线的背后是一套工作流：先出提案、确认后动手，文档驱动，接口契约先行。Tue, 18 Aug 2026 00:00:00 GMTAIAI 协作工作流文档驱动方法论http://kalpacode.cn/posts/chat-widget-state-machine/http://kalpacode.cn/posts/chat-widget-state-machine/大部分「给网站加 AI 聊天」的教程止于调通接口。这篇写剩下的部分：五状态机、前端限流、连续失败降级冷却、localStorage 会话持久化，以及一个沿椭圆轨道绕行的悬浮球入口。Tue, 18 Aug 2026 00:00:00 GMT前端React状态机前端架构产品化http://kalpacode.cn/posts/ecs-99-deploy-full-record/http://kalpacode.cn/posts/ecs-99-deploy-full-record/一台 99 元/年的阿里云 ECS 扛起整个博客。逐命令的部署记录：Python 3.11 旁装、systemd 守护、Nginx 反代，以及一个差点成为定时炸弹的裸 location 块。Tue, 18 Aug 2026 00:00:00 GMT运维ECSNginxsystemd部署SSEhttp://kalpacode.cn/posts/rag-vs-agent/http://kalpacode.cn/posts/rag-vs-agent/这个博客的 AI 助手有检索、有对话历史、有大模型，但它不是 Agent——它没有规划、没有工具调用、没有行动空间。用自己项目的真实代码当解剖样本，把 RAG 和 Agent 的分界线画出来。Tue, 18 Aug 2026 00:00:00 GMTAIRAGAgentLLM架构http://kalpacode.cn/posts/system-prompt-anti-hallucination/http://kalpacode.cn/posts/system-prompt-anti-hallucination/RAG 系统的幻觉不全是模型的问题，更多是约束没给够。解剖这个博客助手的真实 SYSTEM_PROMPT：三条约束各防什么，以及为什么检索为空时宁可绕过模型直接返回固定文案——提示词是软保险，代码分支是硬保险。Tue, 18 Aug 2026 00:00:00 GMTAIRAGPrompt工程幻觉LLMhttp://kalpacode.cn/posts/blog-rag-agent-review/http://kalpacode.cn/posts/blog-rag-agent-review/两天时间，从一份 PRD 到一个能逐字流式回答问题的站内 AI 助手。这篇文章记录全部关键取舍：为什么不上 Dify、为什么全站只留一个 React 岛屿、SSE 协议怎么定、99 元服务器扛不扛得住。Mon, 17 Aug 2026 00:00:00 GMTAIRAGAstroFastAPIChromaDB架构http://kalpacode.cn/posts/chromadb-three-pitfalls/http://kalpacode.cn/posts/chromadb-three-pitfalls/给博客装 RAG 智能体，向量库选了「最省事」的 ChromaDB，结果连续踩了三个坑：系统 sqlite3 太老拒绝启动、langchain 旧封装悄悄不落盘、DashScope 兼容模式不收 token 数组。一篇讲透。Mon, 17 Aug 2026 00:00:00 GMTAIChromaDBLangChainRAGEmbedding踩坑http://kalpacode.cn/posts/deepseek-thinking-mode-latency/http://kalpacode.cn/posts/deepseek-thinking-mode-latency/升级模型版本后什么都没改，聊天窗却全员显示降级文案。根因是 deepseek-v4-flash 默认开启思考模式，流式接口前 15 秒静默，撞上前端 15 秒首字超时。一行 extra_body 解决。Mon, 17 Aug 2026 00:00:00 GMTAIDeepSeekLLM流式输出踩坑http://kalpacode.cn/posts/nginx-rate-limit-real-ip/http://kalpacode.cn/posts/nginx-rate-limit-real-ip/反代之后 request.client.host 恒为 127.0.0.1，全站访客共享一个「10 次/分钟」的限流桶。我自己测试太勤快把桶刷爆，真实用户被误伤返回 429。修复只有一行，教训却值得单独写一篇。Mon, 17 Aug 2026 00:00:00 GMT运维Nginx限流FastAPI反向代理http://kalpacode.cn/posts/randomuuid-secure-context/http://kalpacode.cn/posts/randomuuid-secure-context/本地 localhost 永远正常，线上 HTTP 裸 IP 水合即白屏。根因是 crypto.randomUUID 只在安全上下文存在。修复是一个带回退的 UUID 生成函数。Mon, 17 Aug 2026 00:00:00 GMT前端浏览器 APIReactAstro踩坑http://kalpacode.cn/posts/sse-client-fetch-readablestream/http://kalpacode.cn/posts/sse-client-fetch-readablestream/EventSource 不支持 POST，于是手写了基于 fetch + 流式解析 的 SSE 客户端：帧缓冲状态机、15 秒首字超时、断流保留已得内容，外加一个 ?mock=1 假后端。Mon, 17 Aug 2026 00:00:00 GMT前端SSE流式解析fetch前端架构http://kalpacode.cn/posts/sse-crlf-debug/http://kalpacode.cn/posts/sse-crlf-debug/后端日志正常、curl 正常、浏览器 Network 面板里数据收得完完整整，界面却固定显示「AI 助手暂时休息中」。最后的根因是服务端用 CRLF 分帧，前端用 LF 解析。Mon, 17 Aug 2026 00:00:00 GMT前端SSE调试FastAPI浏览器http://kalpacode.cn/posts/chromadb-local/http://kalpacode.cn/posts/chromadb-local/在 2G 内存的服务器上跑向量数据库：持久化路径、内存占用与三个真实的坑。Sun, 16 Aug 2026 00:00:00 GMTAIRAGChromaDBEmbeddinghttp://kalpacode.cn/posts/github-actions-deploy/http://kalpacode.cn/posts/github-actions-deploy/写一篇 Markdown，git push，几分钟后文章自动上线并进入 AI 知识库——完整流水线配置。Sun, 16 Aug 2026 00:00:00 GMT运维CICDActionshttp://kalpacode.cn/posts/rag-chunking/http://kalpacode.cn/posts/rag-chunking/同样的文章，换三种分块方式，检索命中率从 63% 到 87%。分块是 RAG 最被低估的环节。Sun, 16 Aug 2026 00:00:00 GMTAIRAGLangChainhttp://kalpacode.cn/posts/sse-fastapi/http://kalpacode.cn/posts/sse-fastapi/AI 回答为什么要逐字返回？Server-Sent Events 比 WebSocket 简单在哪里，FastAPI 里怎么写。Sun, 16 Aug 2026 00:00:00 GMT后端SSEFastAPIhttp://kalpacode.cn/posts/astro-zero-js/http://kalpacode.cn/posts/astro-zero-js/内容站点为什么不需要一整个 React 应用？Astro 的岛屿架构如何把首页 JS 压到接近零。Sat, 15 Aug 2026 00:00:00 GMT前端Astro静态站点http://kalpacode.cn/posts/docker-network/http://kalpacode.cn/posts/docker-network/四种网络模式到底怎么选？用一台 2G 内存的小服务器实测 bridge、host 与自定义网络的真实差异。Sat, 15 Aug 2026 00:00:00 GMT后端Docker网络http://kalpacode.cn/posts/ecs-99-ops/http://kalpacode.cn/posts/ecs-99-ops/2 核 2G 跑静态博客 + Python 后端 + 向量库，每一 MB 内存都要精打细算。Sat, 15 Aug 2026 00:00:00 GMT运维LinuxNginxSwaphttp://kalpacode.cn/posts/tailwind-dark-mode/http://kalpacode.cn/posts/tailwind-dark-mode/class 策略、媒体查询、CSS 变量令牌——为什么这个博客选择第三种。Sat, 15 Aug 2026 00:00:00 GMT前端TailwindCSS