Files
cursor-byok/apps/docs/content/blog/2026-08-27-documentation.mdx
T
leokun c5d578c5b1 feat(docs): add documentation site and demo features
- Introduced a new documentation site for Cursor BYOK using Next.js and Fumadocs.
- Added a product demo page with a corresponding Vite configuration.
- Implemented a demo API to simulate LLM calls and responses.
- Enhanced the Makefile to include new build and development commands for the documentation.
- Updated package.json scripts for building and running the documentation site.
- Created various components and layouts for the documentation structure, including blog and user documentation sections.
- Added styling for the new components and layouts to ensure a cohesive design.
- Included a README and other necessary files for local development and deployment.
2026-08-27 21:45:28 +08:00

38 lines
1.5 KiB
Plaintext

---
title: 为什么我们建立新的文档站
description: 将用户指南和开发过程放回代码仓库,让文档与产品一起演进。
---
cursor-byok 的功能已经从单一模型转发扩展到多协议模型配置、工具调用、会话观测和跨平台桌面应用。散落在发布说明与讨论区中的信息,已经不足以支持第一次使用产品的人,也不利于开发者理解系统边界。
## 文档也是产品的一部分
新的文档站与应用代码放在同一个仓库中:
```text
apps/
├── desktop/ # 桌面应用
└── docs/ # 文档站
├── content/docs/
└── content/blog/
```
用户文档负责回答“如何使用”,开发者博客负责记录“为什么这样设计”。两类内容分开维护,但使用同一套构建和审查流程。
## 为什么选择 Fumadocs
Fumadocs 提供了文档布局、全文搜索、代码高亮、目录和 MDX 内容层,我们只需要维护产品信息与视觉样式,不必重新实现通用文档能力。
文档应用保持独立,桌面端不会引入 Next.js 或 Fumadocs 依赖。开发、构建和部署也可以分别进行。
## 接下来会记录什么
开发者博客将持续记录:
- Cursor 协议适配与模型兼容性设计。
- Agent 工具调用和多轮会话的实现取舍。
- 本地存储、可观测性与性能优化。
- 桌面端跨平台开发和发布过程。
这些文章以当前代码为准,不为已经删除的旧实现保留兼容说明。