Skip to content

Projects zh

Ra1nify edited this page Oct 31, 2026 · 1 revision

项目

项目是一份记忆库。一个项目可绑定到多个实例,实例以 Junction 挂载项目目录。

列表字段

列 含义
名称 项目名
路径 本地代码工作区目录
会话 记忆库中的会话数量
状态 运行中(被某个实例占用)/ 空闲
占用实例 当前绑定的运行中实例

路径不存在时显示 路径无效,可通过 重定位 修复。

顶部按钮

按钮 行为
从 .gemini 导入 选择目录,扫描 .gemini 下的历史项目与会话,写入项目名录与记忆库
刷新 重新读取项目状态

行内按钮

按钮 行为
会话 打开会话预览对话框,列出记忆库中的会话
操作 打开操作菜单:重命名、分支克隆、导出 Markdown、删除
重定位 重新指定本地代码工作区目录

记忆库结构

projects\{id}\memory\
  brain\{conversationId}\              会话上下文
  conversations\{conversationId}.db    会话数据库
  conversation_summaries.db            会话摘要索引

操作菜单

项 行为 约束
重命名 修改项目名 —
分支克隆 深拷贝记忆库为新项目,名称需唯一 目标名已存在时失败
导出 Markdown 将指定会话导出为 .md —
删除 移除项目定义与记忆库目录,保留本地源码 项目运行中时不可用

分支克隆 使用 SQLite 在线备份接口复制数据库,不直接复制文件,避免拷到未提交的 WAL 内容。

绑定与共享

绑定项目数 挂载方式 新建会话归属
1 实例 brain、conversations 整目录 Junction 到项目 直接写入项目
≥2 实例自有目录,按已有会话逐条 Junction 留在实例沙盒,进程退出时回写

回写条件:会话的 workspace_uris 包含该项目的本地路径。

互斥

同一项目在同一时刻只能被一个运行中的实例使用。状态记录在 data/projects.json:

字段 含义
RunningInstanceId 占用实例 ID
ProcessId 占用进程 PID
IsRunning 运行标记

实例异常退出后标记残留。再次启动会检测到冲突并询问是否强制接管。

导入

从 .gemini 导入 的扫描对象:

  1. 选定目录下的 .gemini\antigravity\brain\ 各会话子目录;
  2. 同级的 .gemini\antigravity\conversations\*.db;
  3. .gemini\antigravity\conversation_summaries.db。

导入时按 workspace_uris 归并到项目。会话已存在时跳过,不覆盖。

相关文件

文件 作用
data/projects.json 项目名录与互斥状态
data/projects/{id}/memory/ 记忆库
src/Gravityless.Core/Services/ProjectService.cs 导入、克隆、重命名、删除
src/Gravityless.App/Resources/Languages/*.xaml 本页文案键 Projects_*

Clone this wiki locally