工作区与数据

Cocurdex 如何在本机存储工作区、笔记、Issue、演示文稿与搜索数据——以及什么保持私有。

工作区

工作区是 Cocurdex 挂接的项目上下文——通常是磁盘上的一个目录，Agent、终端和编辑器在其中工作。

一个工作区可以包含多个源文件夹。使用编辑工作区可添加文件夹、设为主文件夹或移除文件夹；将文件夹拖到窗口中即可将其作为工作区打开。

从桌面 UI 打开，或：

cocurdex .
cocurdex open /path/to/project
cocurdex workspace list

会话和许多产品视图围绕当前工作区组织。笔记、Issue 和演示文稿可以可选地关联到某个工作区 id；默认它们不是「项目树里的文件」。演示文稿列表把全部演示文稿放在同一份列表里。

本机的本地网页客户端——以及你允许的已配对设备——连的是同一个 daemon 和同一批工作区。

笔记、Issue、演示文稿、视图、标签、链接和搜索索引存放在应用私有存储(cocurdex.sqlite)中，而不是双写的 Markdown 树。

重要规则：

桌面 daemon 是唯一打开本地数据库的进程。
CLI 是自动化和 Agent 受支持的外部读写边界。
Markdown 导入导出是显式的——不是第二个活数据库。
私有表结构和文件路径不是公开 API。
升级时数据库会向前迁移并保留你的数据。迁移前，Cocurdex 会在旁边写一份 cocurdex.sqlite.pre-migration-<timestamp> 快照，并保留最近三份。
由更新版本应用写入的数据库会被拒绝打开，绝不降级。只有不是 Cocurdex 数据库的文件才会被替换，并且会先另存为 .bak-<timestamp> 文件。

平台	默认位置
macOS	`~/Library/Application Support/Cocurdex`
Windows	`%APPDATA%\Cocurdex`
Linux	`$XDG_CONFIG_HOME/Cocurdex`(默认 `~/.config/Cocurdex`)

这个位置在各版本之间保持不变，升级后仍会读取你已有的数据。

以路径为身份的文件树让稳定 id、事务、全文搜索和反向链接更难实现。SQLite 提供了这些性质，而不要求每个工具都去解析仓库。Agent 通过 cocurdex note|issue|deck|search … 保持互操作，而不是另造平行的 .scratch 树。

Daemon 负责：

cocurdex daemon status

如果 CLI 数据命令失败，打开桌面应用（或确认 daemon 进程可达），然后重试。

未来的团队控制台和云端 API 会为选定实体（很可能先是 Issue 和已发布文档）暴露组织级投射。这不会取代本机工作的本地写权威：

同步的最终用户行为会随功能上线出现在这里。