指南
工作区管理
了解 Vibecape 工作区的功能和使用方法
工作区管理
工作区是 Vibecape 的核心概念,每个工作区是一个独立的文档项目。
工作区结构
每个工作区包含以下内容:
{repository_id}/
├── config.json # 工作区配置
├── docs.db # 文档数据库
├── chat.db # 项目聊天记录
└── llm.txt # AI 上下文提示词文档管理
树形结构
文档支持父子层级组织:
- 根文档
- 子文档 1
- 孙文档
- 子文档 2
- 子文档 1
文档属性
每个文档包含:
| 属性 | 说明 |
|---|---|
title | 文档标题 |
content | Tiptap JSONContent 格式的内容 |
metadata | Frontmatter 元数据 |
parent_id | 父文档 ID |
order | 同级排序权重 |
llm.txt - AI 上下文
每个工作区可以有一个 llm.txt 文件,用于为 AI 提供项目上下文:
这是一个关于 XXX 的文档项目。
## 写作风格
- 简洁明了
- 技术准确
## 术语表
- Vibecape: 沉浸式创作工坊
- Repository: 工作区
## 注意事项
- 使用中文
- 代码示例使用 TypeScriptAI 在对话时会自动读取此文件作为上下文。
项目聊天
每个工作区有独立的聊天记录(chat.db),与全局聊天分离。这样可以:
- 保持项目相关的对话历史
- AI 可以参考之前的讨论
- 切换工作区时自动切换聊天上下文
备份与迁移
由于所有工作区都存储在 docs_root 目录下,备份和迁移非常简单:
- 备份: 复制整个
docs_root目录 - 迁移: 将目录复制到新机器,在设置中指定
docs_root路径 - 同步: 可以将
docs_root放在云同步目录(如 iCloud、Dropbox)