📚 日常工作知识库

记录排障过程、工程方法与可复用脚本，持续把零散经验沉淀成可检索、可复用、可发布的团队资产。 本页由 npm run site:sync 自动生成，请勿手动维护文档列表。

使用方式

• 从左侧分类导航进入对应主题。
• 需要全局查找时优先使用站点搜索。
• 每篇文章尽量遵循“现象 / 背景 → 排查 → 根因 → 解决 → 预防”的结构，方便复盘与复用。

维护规则

• 公开文章是唯一事实来源，统一放在 site/<category>/*.md。
• 运行 npm run site:sync 会自动刷新 site/README.md、分类索引页和 .vitepress/config.mts。
• npm run docs:build 与 npm run publish 会自动执行同步，作为最终兜底。

分类概览

分类	说明	文档数
网络 / CDN / 代理	网络访问、DNS、CDN、代理与本地网络环境排查。	2
CLI 工具	命令行工具安装、link、构建与报错排查。	4
前端开发	前端框架、构建工具、样式与性能优化经验。	4
DevOps	环境配置、CI/CD、容器化与部署实践。	7
开发工具技巧	Git、IDE、终端与知识库维护等效率实践。	25
Node.js 相关	Node.js、npm、pnpm 与运行时问题处理。	0
Python 与全栈开发	Python 核心语法、全栈开发进阶与服务端部署实践。	1
数据库	数据库、SQL、缓存与数据访问经验。	1
安全相关	权限、证书、安全风险与加固实践。	0

目录结构

site/
├── README.md                              # 公开知识库总览（自动生成）
├── index.md                               # 站点首页
├── network/                              # 网络 / CDN / 代理
│   ├── index.md                          # 分类索引（自动生成）
│   ├── dns-domain-types-licensing-scenarios.md
│   └── cdn-hosts-conflict-troubleshooting.md
├── cli/                                  # CLI 工具
│   ├── index.md                          # 分类索引（自动生成）
│   ├── cli-local-link-debug-best-practices.md
│   ├── cbm-start-bootstrap-quickstart.md
│   ├── npm-link-bin-missing.md
│   └── npm-link-missing-node-modules.md
├── frontend/                             # 前端开发
│   ├── index.md                          # 分类索引（自动生成）
│   ├── chrome-builtin-ai-guide.md
│   ├── layout-shift-optimization.md
│   ├── localhost-dev-domains-and-templates.md
│   └── openclaw-control-layout-optimization.md
├── devops/                               # DevOps
│   ├── index.md                          # 分类索引（自动生成）
│   ├── cloudflare-pages-post-deployment-guide.md
│   ├── cloudflare-hybrid-deployment-wrangler-guide.md
│   ├── serverless-architecture-comparison.md
│   ├── cloudflare-serverless-rag-deployment-guide.md
│   ├── sdd-pipeline-architecture-pattern.md
│   ├── daily-news-refresh-workflow-breakdown.md
│   └── github-actions-best-practices.md
├── tools/                                # 开发工具技巧
│   ├── index.md                          # 分类索引（自动生成）
│   ├── ai-agent-skills-bloat-and-routing.md
│   ├── devhelper-ai-agent-rag-design.md
│   ├── ai-skill-test-architecture.md
│   ├── ai-coding-agentic-sdlc-practices.md
│   ├── dify-workflow-automation-best-practices.md
│   ├── hermes-agent-quick-start.md
│   ├── llm-prompt-engineering-costar-framework.md
│   ├── openspec-vs-speckit-sdd.md
│   ├── claude-router-isolation-design.md
│   ├── igit-mr-mcp-to-skills-evolution.md
│   ├── igit-mr-sharing-one-pager.md
│   ├── llm-pricing-subscription-performance-comparison.md
│   ├── high-fidelity-prd2prototype-framework.md
│   ├── claude-code-openai-compatible-gateway-routing.md
│   ├── init-vitepress-node16-compatibility.md
│   ├── igit-mr-skills-install-and-usage-manual.md
│   ├── news-base-crawl-to-page-sequence.md
│   ├── claude-code-15-tips.md
│   ├── igit-mr-skills-cdn-release-checklist.md
│   ├── knowledge-base-skill-distribution-workflow.md
│   ├── launchagent-local-service-practice.md
│   ├── chrome-extension-development-manual.md
│   ├── openclaw-cli-commands.md
│   ├── openclaw-skill-development.md
│   └── knowledge-base-sync-workflow.md
├── nodejs/                               # Node.js 相关
│   └── index.md                          # 分类索引（自动生成）
├── python/                               # Python 与全栈开发
│   ├── index.md                          # 分类索引（自动生成）
│   └── frontend-to-python-fullstack-guide.md
├── database/                             # 数据库
│   ├── index.md                          # 分类索引（自动生成）
│   └── universal-knowledge-base-backup-strategy.md
└── security/                             # 安全相关
    └── index.md                          # 分类索引（自动生成）

文档索引

网络 / CDN / 代理

网络访问、DNS、CDN、代理与本地网络环境排查。

文档	日期	摘要
域名体系深度解析 — 域名定价、场景限制与部署准入风险指南	2026-06-17	系统性梳理顶级域名（TLD）分类、注册局商业定价机制、常见域名的使用限制，以及根域名（后缀）对 HTTPS 强制性认证、国内 ICP 备案准入和 Cookie 安全的深度影响。
CDN 资源加载失败 — /etc/hosts 硬编码 IP 失效问题	2026-03-06	排查 /etc/hosts 中的历史硬编码记录导致 CDN 节点失效、TLS 握手中断与页面静态资源全部加载失败的问题。

CLI 工具

命令行工具安装、link、构建与报错排查。

文档	日期	摘要
CLI 工具本地软链接调试机制与发布最佳实践	2026-05-19	深入剖析 npm/yarn link 软链调试机制、业内成熟开发经验，以及如何确保本地调试与远程包发布安全解耦。
CBM CLI start 与一键脚本快速上手	2026-03-30	整理 cbm start 的推荐使用方式、首次接入时的一键 bootstrap 思路，以及常见启动结果和排查要点。
npm link 关联失效或私有源安装 404 排查	2026-03-17	排查私有 npm 源缺包、构建产物未生成与 npm link 软链不完整导致 CLI 命令不可用的问题。
npm link 后 CLI 报错 — node_modules 缺失导致 MODULE_NOT_FOUND	2026-03-06	说明 npm link 依赖本地 node_modules 的运行机制，并给出 CLI 缺少依赖时报错的定位与修复步骤。

前端开发

前端框架、构建工具、样式与性能优化经验。

文档	日期	摘要
Chrome 内置 AI (Gemini Nano) 深度解析与流式协议 Bug 排查复盘	2026-06-24	深入剖析 Chrome 内置本地模型 Gemini Nano 的技术原理、本地运行机制及存储路径，复盘由于新旧版本流式接口 (promptStreaming) 返回增量/全量数据契约不一致导致的 UI 空白渲染 Bug 的排查思路与智能拼接兼容方案。
前端页面渲染抖动（Layout Shift）根因剖析与骨架屏优化实践	2026-06-24	本文详细整理了前端开发中常见的页面加载/路由切换时布局抖动（Layout Shift）的成因，并以 DevHelper 主页的异步数据加载为实战案例，讲解如何通过设计精确的骨架屏（Skeleton Screen）实现 0 抖动的无缝视觉过渡。
*.localhost 本地域名与前端开发最小配置模板	2026-03-30	解释为什么 *.localhost 通常不需要手动改 hosts，并提供 Vue CLI、Vite、webpack-dev-server 的最小可用配置模板。
OpenClaw Control Center 布局抖动与边距优化	2026-03-25	解决 OpenClaw 控制中心在初始化或切换视图时的 topbar 位移抖动，以及组件间距过窄的问题。

DevOps

环境配置、CI/CD、容器化与部署实践。

文档	日期	摘要
Cloudflare Pages 部署完成后的三大配置路径深度解析	2026-06-24	深度剖析 Cloudflare Pages 部署成功后所推荐的 Wrangler CLI、资源绑定（Bindings）、自定义域（Custom Domains）三大后续步骤的作用、应用场景及其本质区别。
Cloudflare 混合部署模式与 Wrangler CLI 运维指南	2026-06-17	本文详细梳理了 panjiayuan-helper 采用的“前端 GitHub 自动联动 + 后端本地 CLI 推送”的混合部署架构，全面扩展了 Cloudflare Wrangler 核心命令以及 D1/Vectorize 场景操作指令。
Cloudflare Workers 与传统云函数 Serverless 架构深度对比	2026-06-17	深度分析 Cloudflare Workers 与以阿里云 FC 为代表的传统 Serverless 架构差异，涵盖计算模型、冷/热启动机制、RAG 数据库集成、成本模型及网络合规，并补充服务端核心知识与优化建议。
Cloudflare Serverless RAG 部署完整指南	2026-06-16	从零构建 Cloudflare Workers + D1 + Vectorize 无服务器 RAG 知识问答系统，包含完整的踩坑记录、正确操作步骤与 wrangler 配置规范。
SDD 多仓协作流水线架构：提示词同步、Guard Rails 隔离与测试层级设计	2026-06-08	梳理基于 Spec-Driven Development (SDD) 的三仓协作模式，涵盖 Prompt 资产双向同步、Dify 工作流编译、服务端增量修改 Guard Rails 策略，以及规则回归测试与 E2E 测试盲区的分析与改进建议。
Daily News Refresh 工作流深度拆解：从定时抓取到 Cloudflare Pages 自动部署	2026-04-07	以 news-base 项目为例，深度拆解 GitHub Actions 定时新闻抓取工作流的完整链路、每步设计意图、实际遇到的排队延迟与 Node.js 弃用警告问题，以及对应的工程改进方案。
GitHub Actions 全解析：核心概念、工作流优化与实战最佳实践	2026-04-07	从 YAML 语法到运行时矩阵，系统梳理 GitHub Actions 核心概念，并给出 pnpm 缓存、失败重试、通知机制与免费 Runner 排队延迟等工程实战最佳实践。

开发工具技巧

Git、IDE、终端与知识库维护等效率实践。

文档	日期	摘要
大模型 Agent 技能（Skills）臃肿与相似冲突的路由分流最佳实践	2026-07-09	深入剖析在工程化开发中技能过多或描述接近对 AI Agent 判断的影响，并结合业内（Router-Agent、向量检索、元数据硬过滤）提出区分与分流的最佳实践。
DevHelper AI 助手能力检索与网页分析方案设计	2026-07-08	通过三阶段演进路线（本地 Native Tool Calling、Cloudflare RAG、Agents SDK）解决 Chrome 插件 AI 助手工具感知与动态页面分析的局限。
AI 技能工程：测试资产三层分层架构设计	2026-07-07	以回票跟进助手（wuba-invoice-followup）为实战案例，总结 AI 技能从业务验证到自动化回归的测试资产分层设计方法，包含目录架构、生命周期流水线、examples 瘦身策略与 cybervisor 流水线集成。
智能体时代下的研发效能变革与前沿实践：AI Coding 与双层 Harness 架构演进	2026-06-12	系统剖析 AI 时代下软件开发生命周期 (SDLC) 的范式变革。从 Google 内部 AI 辅助开发（Goose 专属模型、Cider Agent 等）及 SDD (Spec-Driven Development) 规范，到企业级落地中的“业务 Harness（行业 Know-How 编码层）”与“基础设施 Harness（云原生托管与安全防护层）”双层架构体系，为智能体时代下的效能提升提供标准化参考指南。
58智能报销审批：Dify 工作流与提示词资产自动化流水线标准作业说明	2026-06-04	系统梳理 58 内部个人报销智能审批的 Dify 工作流架构、V2 本地预计算引擎与 LLM 混合决策设计、Prompt 双端同步规范及自动化 YML 编译流水线，为后续费用类型接入提供标准化作业 SOP 借鉴。
Hermes Agent 研发快速上手指南 (含 OpenClaw 迁移对比及工程踩坑)	2026-05-18	快速理解 Hermes 核心架构、与 OpenClaw 关键对比、机器可读一键安装配置流程，以及控制中心数据库连接泄露的实战踩坑记录。
LLM Prompt 工程方法论：CO-STAR、六段框架与结构化 Prompt 交付模板	2026-05-18	系统讲解 CO-STAR 提示词设计思想与 Role-Context-Schema-Rules-Few-Shot-Format 六段框架的关系，厘清框架来源与原创延伸，并提供完全脱敏、可复用的业务 Prompt 交付模板及五条核心设计原则。
OpenSpec 与 Spec Kit (Specify CLI) 的 SDD 模式深度对比	2026-05-18	全面解析 OpenSpec 与 Spec Kit 的核心区别、工作流机制，以及它们在 Spec-Driven Development (SDD) 规范驱动开发下的定位。
Claude Code 多模型切换：claude-router 设计原理与隔离实践	2026-04-29	解决 Claude Code 多服务商切换时的环境变量污染问题，详解 claude-router 的隔离机制及 Shim 脚本导致的 Model Not Found 故障排查。
iGit MR 工具从 MCP 到 Skills 的工程化演进	2026-04-22	梳理 iGit MR 工具如何从 MCP Server 发展到 Skills、Bootstrap Installer 与本地 CLI 双运行时架构。
iGit MR 工具分享提纲与精简架构图	2026-04-22	面向对外分享的一页版材料，包含演讲提纲、核心结论与精简 Mermaid 架构图。
国内外主流大模型资费、订阅与性能对比（2026-04）	2026-04-22	对比 OpenAI、Anthropic、Google、DeepSeek、Qwen、Kimi 等代表性厂商的大模型 API 单价、订阅方案，以及第三方统一口径下的延迟与性能表现。
高保真 PRD2Prototype 技能方案与自动化验证流程	2026-04-21	梳理高保真 PRD2Prototype 的整体框架、技能与工作流用法，以及更新原型后默认自动 build、可选 auto-start dev 的验证闭环。
Claude Code 对接 OpenAI 兼容网关：EdgeFn / LiteLLM / 多模型切换实践	2026-04-09	梳理 Claude Code 接第三方 OpenAI 兼容平台时的边界与推荐做法，补充 newapi 这类新渠道的接入判断、dashboard 在线录入多平台注册表、以及 claude-router / claude-gateway / 单平台快捷入口的长期分工。
init-vitepress 在 Node 16.14.2 项目中的兼容策略	2026-03-31	说明 init-vitepress 的真源应该改在 agent-workflows 技能仓库中，并给出 Node 16.14.2、Node 18+、双运行时隔离三条稳定落地路径。
igit-mr-skills 与 /igit-mr-review 安装使用手册	2026-03-30	说明 /igit-mr-review 已切换为本地 CLI 入口，并给出 mds skills 与在线 shell 脚本两种已验证可用的安装方式。
news-base：从抓取到页面展示的简化时序图	2026-03-30	梳理 news-base 如何从真实新闻源抓取内容、补足分类兜底数据、生成静态 JSON，并最终由 VitePress 页面组件完成展示。
Claude Code 15条高频实用技巧深度解析	2026-03-27	基于B站视频分析的Claude Code 15个高频实用技巧，包含架构图、思维导图和完整实施指南
igit-mr-skills CDN 发布后验收清单	2026-03-27	提供 igit-mr-skills 发布到私有 npm 和 CDN 之后的标准验收流程，重点覆盖主 skill 与 /igit-mr-review、/igit-mr-report 两个高频快捷入口。
knowledge-base skill 多工具分发与一键安装工作流	2026-03-27	梳理 knowledge-base skill 当前的单一源、多目录同步、bootstrap 安装方式，以及未来扩展到 npx 和自动化同步工作流的实现路径。
macOS LaunchAgent 入门与本地服务常驻实践	2026-03-27	解释 LaunchAgent 是什么、适合解决什么问题，以及如何把本地控制台、帮助中心和网关这类服务做成登录自启动的常驻进程。
Chrome 扩展开发手册：从本地调试到商店发布	2026-03-26	基于 Cookie 管理器与二维码扩展两个项目，整理 Manifest V3 扩展的目录组织、权限设计、脚本注入、打包发布与常见故障排查手册。
OpenClaw CLI 常用命令与实用技巧	2026-03-26	OpenClaw CLI 命令行工具的常用命令、实用技巧和日常管理指南
OpenClaw 本地技能封装开发指南	2026-03-26	基于 github-trending 技能模式的 OpenClaw 本地技能开发、封装与部署完整指南
知识库维护工作流：让文档、README 与侧边栏自动同步	2026-03-24	用 frontmatter 加同步脚本把公开文章、README、分类页与 VitePress sidebar 收敛到同一事实来源，避免知识库索引长期漂移。

Node.js 相关

Node.js、npm、pnpm 与运行时问题处理。

当前暂无公开文章，新增内容后运行 npm run site:sync 即可自动收录。

Python 与全栈开发

Python 核心语法、全栈开发进阶与服务端部署实践。

文档	日期	摘要
前端同学转全栈 Python 与服务端部署全流程指南	2026-06-15	为前端开发者量身定制的 Python 全栈进阶指南。通过 JS/TS 与 Python 概念类比，深入剖析核心语法与高级特性，并详述从本地依赖管理到生产环境 Uvicorn、Docker 及 Nginx 部署的全流程实践。

数据库

数据库、SQL、缓存与数据访问经验。

文档	日期	摘要
万能知识库备份与多云托管方案：黑盒数据库灾备与多介质异地容灾实战	2026-06-11	在不了解数据库结构与存储对象的前提下，通过原生工具逻辑备份、应用层 API 半结构化导出以及基于 Restic/Rclone 的多云异地冷备，设计并实施高可用的知识库灾备系统。

安全相关

权限、证书、安全风险与加固实践。

当前暂无公开文章，新增内容后运行 npm run site:sync 即可自动收录。