常见问题¶
常规¶
我的数据是否存储在外部服务器上？
不是。所有数据都存储在您的服务器本地。您的简历数据保存在 /data 目录中的 SQLite 数据库文件中。
我可以不使用 Docker 运行 CV Manager 吗？
可以。安装 Node.js 18+，在项目目录中运行 npm install，然后运行 node src/server.js。管理界面在端口 3000 上运行，公开站点在端口 3001 上运行。
多个人可以使用同一个实例吗？
CV Manager 设计为单用户应用程序。每个实例管理一个人的简历。如果需要多人使用，请运行单独的容器。
编辑¶
如何将职位标记为'当前'？
将结束日期字段留空。它将在简历上显示为"至今"。
我可以对某个板块内的条目重新排序吗？
可以。大多数条目支持拖放排序。排序会自动保存。
如何在工作经历中添加要点？
编辑工作经历，在亮点字段中输入内容——每行一个要点。
如何添加公司标志？
编辑工作经历，滚动到公司标志部分，点击选择图片上传。您也可以点击使用现有来重复使用已上传的标志。启用"将标志同步到所有 [公司]"开关，可将相同的标志应用到该公司的所有工作经历。
我不小心删除了某些内容。可以撤销吗？
没有撤销功能。由于编辑会自动保存到活动数据集，更改会立即持久化。如果您有之前的导出文件或单独保存的数据集，可以从中恢复。建议定期导出简历作为备份。
自定义板块¶
我可以创建多少个自定义板块？
没有硬性限制。您可以根据需要创建任意数量。
创建后可以更改自定义板块的布局类型吗？
可以。编辑该板块并选择不同的布局。请注意，某些字段可能无法在布局类型之间完全保留（例如，从卡片切换到社交链接）。
'要点列表'和'自由文本'布局有什么区别？
要点列表将每一行渲染为带有组标题的项目符号列表项。自由文本渲染纯文本，保留换行符且没有标题——类似于"关于我"板块。
打印和 PDF¶
为什么我的 PDF 看起来与屏幕上的不同？
打印输出使用专门为纸张优化的打印样式。某些视觉效果（悬停状态、动画、渐变）会被简化。隐藏的条目和管理控件会自动移除。
如何让简历页数更少？
尝试在"打印与导出"设置中启用允许板块分割和允许条目分割。您还可以隐藏不太重要的条目或板块，或使用更紧凑的自定义板块布局。此外，您可以通过任何浏览器的打印对话框调整打印缩放比例（有时隐藏得比较深）。
为什么打印的简历中缺少某些条目？
检查这些条目是否已切换为隐藏（眼睛图标）。隐藏的条目会从打印输出和公开页面中排除。
页码没有显示？
确保在"设置 → 打印与导出"中启用了页码。某些浏览器 PDF 查看器可能无法显示 CSS 生成的页码——尝试下载 PDF 并在专用阅读器中打开。
时间线¶
时间线显示的日期不正确 / 只显示年份 / 显示完整日期？
时间线有自己的日期设置。转到设置 → 高级 → 时间线：仅显示年份来切换仅年份显示和完整日期格式。
我可以直接在时间线中添加条目吗？
不可以。时间线是根据您的工作经历自动生成的。添加或编辑工作经历后，时间线会相应更新。
时间线上没有显示国旗？
确保工作经历上的国家代码字段设置为有效的两字母 ISO 国家代码（例如 us、gb、ch、de、fr）。国旗是从外部 CDN 加载的。
如果我同时有两份工作怎么办？
时间线会自动检测重叠的职位，并将它们渲染为并行轨道。并行的工作会出现在一条升高的分支线上，S 形曲线连接器显示分叉和合并点。无需配置——完全基于您的开始/结束日期。短于 1 个月的重叠会被忽略（常见于工作过渡期）。
为什么时间线显示的是标志而不是公司名称？
如果您已为该工作经历上传了公司标志，时间线会显示标志图片而不是文字。如果标志文件缺失，则会回退到显示公司名称。要从时间线中移除标志，请编辑工作经历并在"公司标志"部分点击移除。
语言和更新¶
如何更改管理界面语言？
点击工具栏中的地球图标，然后从下拉网格中选择语言。更改会立即生效，并在各会话间保存。
如何查看我运行的版本？
打开设置——版本号显示在弹窗的左下角（例如 v1.11.0）。
即使有新版本发布，我也看不到更新横幅？
版本检查缓存 24 小时。重启服务器（或 Docker 容器）以清除缓存并强制重新检查。您的服务器还需要能够访问外部网络以连接 raw.githubusercontent.com。
数据集 / 多份简历¶
什么是'默认'数据集？
默认数据集是访问者在您的根 URL（/）上看到的简历版本。首次安装时，CV Manager 会自动从您的简历数据创建一个"默认"数据集。您可以随时使用"打开"弹窗中的单选按钮更改哪个数据集为默认数据集。
我的编辑会自动保存吗？
是的。您在管理界面中所做的每项更改（添加、编辑、删除、重新排序、切换可见性）都会在短暂延迟后自动保存回活动数据集。横幅会显示"正在保存..."然后显示"已保存"以确认。
当我'加载'一个数据集时会发生什么？
加载数据集会将您的工作副本切换到该数据集。您之前的编辑已经自动保存，所以不会丢失任何内容。
访问者可以实时看到我的编辑吗？
不能。公开站点展示的是固定的默认数据集，而不是您的实时编辑内容。只有当自动保存将更改写入默认数据集后，访问者才能看到更改。如果您正在编辑的是非默认数据集，访问者在您将其设为默认之前完全看不到这些更改。
访问者可以看到我保存的数据集吗？
只有在您将其设为公开时才可以。每个数据集在"打开"弹窗中都有一个切换开关。设为公开后，该版本可通过公开站点（端口 3001）上的 /v/slug 访问。私有数据集只能从管理界面预览。
如何与他人分享特定的简历版本？
打开打开...弹窗，将数据集切换为公开，然后点击 slug URL 旁边的复制图标。分享该链接——它可以在公开站点上使用，不会暴露您的管理界面。
我可以同时拥有多个公开版本吗？
可以。您可以将任意数量的数据集设为公开。每个都有自己的 URL（例如 /v/technical-cv-1、/v/marketing-cv-2）。主页 / 显示默认数据集。
我可以删除默认数据集吗？
不能。当前选为默认的数据集（通过单选按钮）无法删除。请先将其他数据集设为默认，然后再删除旧的数据集。
搜索引擎会索引我的版本化 URL 吗？
默认情况下不会——版本化页面会获得 noindex, nofollow。要允许索引，请在"设置 → 高级"中启用索引版本化 URL。
公开站点和 SEO¶
如何分享我的简历？
分享您的公开服务器 URL（端口 3001）。如果您已使用 Cloudflare Tunnel 或反向代理设置了域名，请分享该域名。根 URL 始终显示您的默认数据集。您还可以使用公开版本化 URL 分享特定版本（参见数据集）。
搜索引擎会索引我的简历吗？
默认情况下会——主公开页面包含正确的 meta 标签、站点地图和 robots.txt。要阻止索引，请在"设置 → 高级"中将搜索引擎索引设置更改为"不索引"。公开版本化 URL（/v/slug）默认不会被索引；如果您希望它们被抓取，请启用索引版本化 URL。
我可以在简历中添加 Google Analytics 吗？
可以。在设置 → 高级 → 跟踪代码中粘贴您的跟踪代码。它仅注入到面向公众的页面。
Docker 和基础设施¶
我的更改没有出现在公开站点上？
公开站点展示的是默认数据集，当您在管理界面中编辑时会自动更新。尝试在公开站点上强制刷新（Ctrl+Shift+R）。如果运行的是单独的容器，请确保它们共享相同的数据卷。
我收到'端口已被占用'错误？
更改 Docker 配置中的主机端口映射。例如，映射到 3010:3000 和 3011:3001。不要更改 PUBLIC_PORT 环境变量——那是内部容器端口。
如何备份我的数据？
两种选择：使用管理工具栏中的导出按钮（导出 JSON），或备份包含 SQLite 数据库和上传图片的 data/ 目录。
头像没有显示？
确保图片是通过管理界面上传的。文件存储在 data/uploads/picture.jpeg。如果在 Linux 上运行，请检查文件权限。