---
title: 内容来源
description: "本页专门交代本站十六篇编程指南的上游仓库、在线原文、内容提交、迁移规则与完整文章清单，作为隐藏出处页故不进入站点地图"
sidebar:
  hidden: true
seo:
  noindex: true
---

本站是 [zreren/ai-coding-guide](https://github.com/zreren/ai-coding-guide) 的 Blume 迁移,不是重写。在线原文:[https://aicoding.tips/guide/](https://aicoding.tips/guide/)。

## 上游

| 项 | 值 |
| --- | --- |
| GitHub 仓库 | https://github.com/zreren/ai-coding-guide |
| 在线指南 | https://aicoding.tips/guide/ |
| 内容提交 | `17346067a66ba55bfe07619d98e2135241dfc95a` |
| 站点框架 | Blume 1.5.3 |

## 迁移规则

- 保留每篇文章的完整正文、代码示例、表格、图表、链接、警告与措辞;不摘要、不替换、不编造、不“现代化”技术主张。
- 为 Blume 增加 frontmatter 的 `title` 与基于原文的中文 `description`;Blume 会渲染标题,因此去掉正文里重复的首个 H1。
- 仅做 Blume 所需的语法适配:
  - VitePress `::: tip Title` / `::: warning Title` 改为 MDX `:::tip[Title]` / `:::warning[Title]`,闭合行仍是 `:::`。
  - 下列 8 篇因此使用同 slug 的 `.mdx`:`cache-write-cost`、`repoprompt`、`sessions`、`models`、`context-window`、`cache-strategy`、`skills-ponytail`、`prompt-caching`。
  - 去掉标题上的 VitePress `{#id}` 后缀;Blume 会生成等价 heading slug。涉及 `skills-frontend` 与 `tool-explosion`。
- 路由保持 `/guide` 与 `/guide/<source-slug>`。
- 侧栏分组标题与顺序:开始;基础概念;缓存 Prompt Caching;上下文工程实践;安全;Skills 推荐。分组写在 `blume.config.ts` 的 `navigation.sidebar`,每组 `items` 是路由字符串,不使用括号目录,不增加 URL 段。
- 静态资源放在 `public/`,不热链到上游。
- `search.provider` 为 `orama`;`theme` 只保留 `accent: "indigo"`,不使用 `preset`。

## 16 篇文章清单

| 源文件 | 路由 | 侧栏分组 |
| --- | --- | --- |
| `docs/guide/index.md` | `/guide` | 开始 |
| `docs/guide/tokenization.md` | `/guide/tokenization` | 基础概念 |
| `docs/guide/context-window.mdx` | `/guide/context-window` | 基础概念 |
| `docs/guide/models.mdx` | `/guide/models` | 基础概念 |
| `docs/guide/prompt-caching.mdx` | `/guide/prompt-caching` | 缓存 Prompt Caching |
| `docs/guide/cache-write-cost.mdx` | `/guide/cache-write-cost` | 缓存 Prompt Caching |
| `docs/guide/cache-strategy.mdx` | `/guide/cache-strategy` | 缓存 Prompt Caching |
| `docs/guide/tool-explosion.md` | `/guide/tool-explosion` | 上下文工程实践 |
| `docs/guide/subagents.md` | `/guide/subagents` | 上下文工程实践 |
| `docs/guide/sessions.mdx` | `/guide/sessions` | 上下文工程实践 |
| `docs/guide/skills.md` | `/guide/skills` | 上下文工程实践 |
| `docs/guide/repoprompt.mdx` | `/guide/repoprompt` | 上下文工程实践 |
| `docs/guide/permissions.md` | `/guide/permissions` | 安全 |
| `docs/guide/skills-picks.md` | `/guide/skills-picks` | Skills 推荐 |
| `docs/guide/skills-ponytail.mdx` | `/guide/skills-ponytail` | Skills 推荐 |
| `docs/guide/skills-frontend.md` | `/guide/skills-frontend` | Skills 推荐 |

站点另有首页 `/` 与本页 `/content-sources`。指南语料仅上述 16 篇,不含失败草稿中的虚构页面。