---
title: 为什么我们建立新的文档站
description: 将用户指南和开发过程放回代码仓库，让文档与产品一起演进。
---

cursor-byok 的功能已经从单一模型转发扩展到多协议模型配置、工具调用、会话观测和跨平台桌面应用。散落在发布说明与讨论区中的信息，已经不足以支持第一次使用产品的人，也不利于开发者理解系统边界。

## 文档也是产品的一部分

新的文档站与应用代码放在同一个仓库中：

```text
apps/
├── desktop/       # 桌面应用
└── docs/          # 文档站
    ├── content/docs/
    └── content/blog/
```

用户文档负责回答“如何使用”，开发者博客负责记录“为什么这样设计”。两类内容分开维护，但使用同一套构建和审查流程。

## 为什么选择 Fumadocs

Fumadocs 提供了文档布局、全文搜索、代码高亮、目录和 MDX 内容层，我们只需要维护产品信息与视觉样式，不必重新实现通用文档能力。

文档应用保持独立，桌面端不会引入 Next.js 或 Fumadocs 依赖。开发、构建和部署也可以分别进行。

## 接下来会记录什么

开发者博客将持续记录：

- Cursor 协议适配与模型兼容性设计。
- Agent 工具调用和多轮会话的实现取舍。
- 本地存储、可观测性与性能优化。
- 桌面端跨平台开发和发布过程。

这些文章以当前代码为准，不为已经删除的旧实现保留兼容说明。