doc-record

提示：点击上方Zread徽章可跳转到本仓库的 AI 问答页（Zread），支持搜索与提问，快速获取结构化指引。 AI 问答入口(zread)

介绍

记录一些文档, 关于docker, k8s, 以及一些其他工具的文档.

Claude Code MCP

项目级 Claude Code 配置已接入 Cloudflare AI Search MCP，配置文件位于 .claude/settings.json。

{
  "mcpServers": {
    "cloudflare-ai-search": {
      "type": "http",
      "url": "https://b9b71958-6156-440e-a28f-b4105ff6a50c.search.ai.cloudflare.com/mcp"
    }
  }
}

用途：在 Claude Code 中把 Cloudflare AI Search 作为 MCP server 使用，直接搜索已接入该索引的内容。

相关文档：docs/AI/mcp/modelcontextprotocol/servers/cloudflare-ai-search/doc.md

安装

npx create-docusaurus@latest doc-record classic
cd doc-record
pnpm install
pnpm start

• 生成侧边栏
  • 相关文档
    • 目前使用方法三

# 启动项目
pnpm start

github pages

自定义host

github设置路径

PS: 以下命令均在项目根目录下操作的(别再根目录操作了, 文件太多, 系统都要卡住了...)

Download

# Create a folder
$ mkdir actions-runner && cd actions-runner
Copied!# Download the latest runner package
$ curl -o actions-runner-osx-arm64-2.320.0.tar.gz -L https://github.com/actions/runner/releases/download/v2.320.0/actions-runner-osx-arm64-2.320.0.tar.gz
Copied! # Optional: Validate the hash
$ echo "14e2600c07ad76a1c9f6d9e498edf14f1c63f7f7f8d55de0653e450f64caa854  actions-runner-osx-arm64-2.320.0.tar.gz" | shasum -a 256 -c
Copied! # Extract the installer
$ tar xzf ./actions-runner-osx-arm64-2.320.0.tar.gz

Configure

# Create the runner and start the configuration experience
$ ./config.sh --url https://github.com/183461750/doc-record --token AJCNPVOFCKIXJHNU4XPGEX3HCO3O4
Copied!# Last step, run it!
$ ./run.sh

Using your self-hosted runner

# Use this YAML in your workflow file for each job
runs-on: self-hosted

使用到的vscode插件

• eliostruyf.vscode-front-matter-beta

人机协作指南

内容创作者（人类）

1. 专注在_docs目录编写Markdown
2. 使用分类文件夹组织文档
3. 保持Front Matter简洁

AI开发助手

1. 维护_docs目录结构稳定性
2. 自动优化知识呈现方式
3. 确保所有文档URL永久可用

备注

• vscode搜索

# 需要排除的搜索项

# 如果只是想排除 所有以 . 开头的文件和目录，最简单的写法是：
**/.*
# 但如果某些 .xxx 文件需要保留，可以结合 ! 排除规则：
**/.*, !./.some-important-dot-file

## 写入项目的 .vscode/settings.json 文件，这样只有当前项目会应用这些排除规则，而不会影响其他项目或全局设置。
{
    "search.exclude": {
        "**/node_modules": true,
        "**/.*": true,  // 排除所有以 . 开头的文件和目录
        // 加了下面这个, temp目录下的文件还是不能被搜索到
        // "!**/temp/**": true,  // 允许搜索所有 temp 文件夹（默认允许）
    },
    "search.useIgnoreFiles": false  // 关闭忽略文件的影响
}

使用到的项目

• docusaurus

TODO

• 接入AI搜索
  • 官方搜索相关文档
  • 参考页面
• 接入AI翻译能力
  • crowdin.com
  • https://docusaurus.io/zh-CN/docs/i18n/crowdin