本地工作区与数据

OpenCareer 的核心设计是 Local First：框架代码可以从 GitHub 更新，但个人求职资料留在自己的工作区中。默认情况下服务只监听 127.0.0.1，不会主动把完整求职档案上传到云端。

工作区结构

第一次启动后，项目根目录会出现：

.career-data/ ├─ career.db ├─ files/ │ ├─ personal/ │ └─ companies/ ├─ backups/ └─ exports/

career.db 保存岗位、投递、个人资料、事实、叙事和材料之间的结构化关系。files/personal/ 和 files/companies/ 保存简历、证书、成绩单、作品等本地附件；这些文件仍然可以用 Word、WPS、Adobe Acrobat 或其他本机软件直接打开。

backups/ 用于保存数据库备份，exports/ 用于保存便于审阅和恢复的 JSON 快照。

备份与恢复

进行重要修改前，可以在设置页面创建数据库备份，也可以在终端运行：

python opencareer/app.py --data-dir .career-data backup

如果希望完整保留一个工作区，直接备份整个 .career-data/ 目录即可。它包含数据库、附件、备份和导出快照。

换电脑

迁移到新电脑时：

1. 在新电脑克隆 OpenCareer；
2. 关闭旧电脑上的 OpenCareer 服务；
3. 将旧工作区的 .career-data/ 复制到新项目根目录；
4. 在新电脑启动 OpenCareer。

只要 .career-data/ 完整保留，岗位、投递、材料关系和个人资料就可以继续使用。

更新框架

如果项目目录使用 Git 管理，更新代码只需要：

git pull

OpenCareer 的框架代码和 .career-data/ 是分离的。正常更新不会主动覆盖个人工作区，也不会把个人资料提交到公开仓库。仍然建议在更新前先做一次备份。