日常工作知识库

Appearance

📚 日常工作知识库 ​

记录排障过程、工程方法与可复用脚本，持续把零散经验沉淀成可检索、可复用、可发布的团队资产。 本页由 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、代理与本地网络环境排查。1
CLI 工具命令行工具安装、link、构建与报错排查。4
前端开发前端框架、构建工具、样式与性能优化经验。2
DevOps环境配置、CI/CD、容器化与部署实践。2
开发工具技巧Git、IDE、终端与知识库维护等效率实践。20
Node.js 相关Node.js、npm、pnpm 与运行时问题处理。0
数据库数据库、SQL、缓存与数据访问经验。0
安全相关权限、证书、安全风险与加固实践。0

目录结构 ​

text
site/
├── README.md                              # 公开知识库总览（自动生成）
├── index.md                               # 站点首页
├── network/                              # 网络 / CDN / 代理
│   ├── index.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                          # 分类索引（自动生成）
│   ├── localhost-dev-domains-and-templates.md
│   └── openclaw-control-layout-optimization.md
├── devops/                               # DevOps
│   ├── index.md                          # 分类索引（自动生成）
│   ├── daily-news-refresh-workflow-breakdown.md
│   └── github-actions-best-practices.md
├── tools/                                # 开发工具技巧
│   ├── index.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                          # 分类索引（自动生成）
├── database/                             # 数据库
│   └── index.md                          # 分类索引（自动生成）
└── security/                             # 安全相关
    └── index.md                          # 分类索引（自动生成）

文档索引 ​

网络 / CDN / 代理 ​

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

文档日期摘要
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_FOUND2026-03-06说明 npm link 依赖本地 node_modules 的运行机制，并给出 CLI 缺少依赖时报错的定位与修复步骤。

前端开发 ​

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

文档日期摘要
*.localhost 本地域名与前端开发最小配置模板2026-03-30解释为什么 *.localhost 通常不需要手动改 hosts，并提供 Vue CLI、Vite、webpack-dev-server 的最小可用配置模板。
OpenClaw Control Center 布局抖动与边距优化2026-03-25解决 OpenClaw 控制中心在初始化或切换视图时的 topbar 位移抖动，以及组件间距过窄的问题。

DevOps ​

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

文档日期摘要
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、终端与知识库维护等效率实践。

文档日期摘要
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-26OpenClaw 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 即可自动收录。

数据库 ​

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

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

安全相关 ​

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

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