Vibecape
指南

工作区管理

了解 Vibecape 工作区的功能和使用方法

工作区管理

工作区是 Vibecape 的核心概念,每个工作区是一个独立的文档项目。

工作区结构

每个工作区包含以下内容:

{repository_id}/
├── config.json      # 工作区配置
├── docs.db          # 文档数据库
├── chat.db          # 项目聊天记录
└── llm.txt          # AI 上下文提示词

文档管理

树形结构

文档支持父子层级组织:

  • 根文档
    • 子文档 1
      • 孙文档
    • 子文档 2

文档属性

每个文档包含:

属性说明
title文档标题
contentTiptap JSONContent 格式的内容
metadataFrontmatter 元数据
parent_id父文档 ID
order同级排序权重

llm.txt - AI 上下文

每个工作区可以有一个 llm.txt 文件,用于为 AI 提供项目上下文:

这是一个关于 XXX 的文档项目。

## 写作风格
- 简洁明了
- 技术准确

## 术语表
- Vibecape: 沉浸式创作工坊
- Repository: 工作区

## 注意事项
- 使用中文
- 代码示例使用 TypeScript

AI 在对话时会自动读取此文件作为上下文。

项目聊天

每个工作区有独立的聊天记录(chat.db),与全局聊天分离。这样可以:

  • 保持项目相关的对话历史
  • AI 可以参考之前的讨论
  • 切换工作区时自动切换聊天上下文

备份与迁移

由于所有工作区都存储在 docs_root 目录下,备份和迁移非常简单:

  1. 备份: 复制整个 docs_root 目录
  2. 迁移: 将目录复制到新机器,在设置中指定 docs_root 路径
  3. 同步: 可以将 docs_root 放在云同步目录(如 iCloud、Dropbox)