本机内容管理工作台

适用于 Windows x64 的 Cove Desktop 0.2.7 工作台预览包。此版本在本机运行完整内容管理后台，使用与官网 /admin/ 相同的模块和编辑器。本机页面、素材、配置和插件保存在电脑上，与官网内容数据库分开。登录身份由授权方在线验证，客户端没有默认 admin 账号。

公开下载页可能仍提供 0.1.0，请先在应用版本信息中确认版本。Mac 0.1.0 的项目式界面不适用本篇指南。

1. 安装与进入#

1. 使用管理员交付的 0.2.7 Windows 安装包，安装前核对随包提供的 SHA-256。
2. 打开应用，等待本地服务初始化完成。首次启动需要初始化数据库，耗时通常比后续启动长。
3. 使用授权方交付的账号和密码联网登录。系统根据全局唯一的用户名自动识别所属租户，无需填写租户标识。授权方管理员在官网「客户管理 → 新增客户」直接建立账号，或在客户行的「账号管理」中补建、停用账号和重置密码；「租户 → 桌面租户账号」仍可管理账号。
4. 登录后先检查本机应用授权。首次未激活时显示独立的激活引导页，尚不展示模块或编辑器；租户已自动识别，可使用个人中心、退出登录和数据目录设置。密码不会保存到本地数据库，每次重新启动、退出登录或会话到期后需联网重新登录。
5. 在引导页粘贴 Cove 管理员提供的应用激活码，点击「激活并进入工作台」。激活必须联网，且激活码归属与当前租户一致。成功后自动展示模块，可编辑、保存与发布；错误或网络失败时留在引导页，修正后重试。
6. 已有有效授权时，登录后直接进入工作台，不必重复激活。授权状态读取失败时点击「重新检查授权」。已有授权过期时，先显示更新授权引导；也可点击「仅查看与导出已有内容」，再备份原内容。该入口不会解锁编辑和发布。

该安装包仍是未签名预览版。当前验证平台为 Windows 11 x64，内置 Java、MongoDB 和 SQL 数据库，无需另装 Docker、Java 或数据库。内置 MongoDB 8.0 的 Windows 平台要求参见 官方说明。

2. 模块与操作手册#

激活通过后的总览提供全部模块入口。各模块的按钮、操作顺序和权限要求沿用内容管理后台手册。

客户与授权管理仅在授权方官网后台提供，桌面客户端不包含此模块。用户、角色与租户信息在客户端为只读，登录账号及身份权限由授权方管理；访问控制仍可用于本地内容。邮件发送需要配置自己的 SMTP 服务，AI 创建需要配置可用的模型服务；应用不会自动提供这两类外部服务。

3. 完成第一张页面#

1. 在「站点管理」创建属于当前租户的新站点。
2. 打开「页面管理」，选择站点并新增页面。
3. 选中页面，点击右侧「编辑」。编辑器会在独立的应用窗口打开。
4. 编辑组件及页面属性，确认保存成功，再检查 SEO 与页面版本。
5. 在页面管理点击「发布」。页面内容将发布到本机 Publisher。
6. 根据页面和站点信息打开本机预览，核对图片、链接和页面内容。

编辑器画布与后台预览禁止执行页面脚本；交互脚本的最终效果请在本机 Publisher 发布页检查。统计插件采集的是本机 Publisher 的访问事件，不会混入官网访问数据。

4. 发布地址与外部访问#

应用启动时自动分配本机端口，内置 Publisher 的地址为 http://127.0.0.1:<本次端口>。页面路径沿用后台的站点和页面路径规则，例如 /<站点>/home。

发布到本机后，页面仅能在这台电脑上访问。它不会上传或覆盖官网。应用关闭后，本地页面服务停止；再次启动，已发布的内容仍然保留。端口可能变化，使用应用当前显示的地址。

如需公网托管，请与管理员安排内容包迁移、服务器插件配置及上线检查。旧版桌面项目的远程快照发布流程与本机工作台的发布流程不同。

5. 租户身份与应用授权#

• 联网登录：授权方验证租户、账号、密码和启用状态。授权方管理员账号不能登录客户桌面工作台。登录后的本机会话最长 24 小时，重启和退出后必须重新联网登录；已登录时，断网仍可编辑、保存和发布到本机 Publisher，直至会话或应用授权到期。
• 应用激活：使用授权方签发的、与当前租户标识一致的激活码。客户端不能创建或分发激活码，也不会启动本机授权签发服务。
• 本机目录归属：首次成功登录后，当前数据目录绑定此租户。其他租户不能使用此目录登录，应使用独立的数据目录。
• 账号停用和密码重置：授权方的调整在下次联网登录时检查；为了允许登录后离线使用，当前已登录会话不会实时联网同步，最长 24 小时后重新核验。

页面、素材和本机发布内容不会上传到登录服务。主动激活或刷新授权、SMTP 发送和 AI 服务仍需要对应网络连接。

旧版 0.2.0 / 0.2.1 的 admin 登录已禁用，原数据库、页面和素材不会被删除。旧版统一归在 cove 下的内容不会自动归给新的租户；请保留旧目录备份，联系授权方确认归属后迁移。0.1.0 的项目只有归属与当前租户一致时才允许复制。

自行修改登录密码#

1. 点击右上角用户名 →「个人中心」→「修改密码」。
2. 填写当前密码、新密码和确认新密码。新密码至少 12 位，UTF-8 编码最多 72 字节，与当前密码不同，两次新密码一致。
3. 保持联网，点击「确认修改」。成功提示后退出当前登录，使用新密码重新登录。

密码由授权方验证和保存，本机数据库没有登录密码。断网或当前密码错误时不会修改成功，修正后重试；忘记当前密码则请授权方管理员重置。改密不会迁移、删除或上传本机内容。其他已登录的离线会话不会即时全部失效，最长 24 小时后重新核验。

6. 迁移原桌面项目#

从 0.1.0 升级后，点击顶部「原桌面项目」。选中原项目，为它填写一个未使用的新站点标识，再确认复制到工作台。

迁移会创建站点、页面和素材，并更新原项目内的素材引用。成功后到「页面管理」检查新站点。原项目文件保留，不会被覆盖；原远程配对凭证不迁移。

如果列表为空，确认当前应用使用的是原 Windows 用户的数据目录。跨电脑或从 Mac 迁移请先保留原备份，并联系管理员安排导入。

7. 备份和恢复#

选择磁盘与迁移目录#

首次启动时，应用会询问数据存放位置。选择「选择其他目录」，再选择 D 盘等磁盘中的上级文件夹，应用会创建专用的 Cove Workspace 数据文件夹。

已经开始使用时，可点击顶部「数据目录设置」：

1. 查看当前目录，点击「选择新位置」。
2. 选择新位置的上级文件夹，核对待复制数据大小和目标磁盘可用空间。
3. 保存并关闭其他编辑器或预览窗口。
4. 点击「复制数据并重启」，等待复制和校验完成。
5. 应用重启后再次打开设置，确认显示新目录，并检查原有站点、素材与授权记录。

迁移包含数据库、素材、插件、配置、原项目和应用授权资料。原目录会保留，确认新目录正常后再自行处理旧副本；应用不会自动删除原数据。如果空间不足、目录重复、复制失败或磁盘不可用，应用会提示原因，不会覆盖已有工作台。迁移后请保持目标磁盘连接。

0.2.3 同时保留 Windows 加密凭据所需的 Local State。如果曾迁移后无法启动，请保留原目录，并安装修复版再次打开；应用会依据迁移记录和匹配的凭据恢复加密状态。不要手动删除 Local State 或加密凭据文件。

备份方式#

• 日常内容备份：使用「内容包」，勾选需要的页面并包含素材，再导出 ZIP。恢复时先选择目标站点，阅读覆盖提示后安装内容包。
• 完整工作台备份：点击顶部「打开数据目录」，记住目录位置；完全退出应用后，再复制整个数据目录。这里包含数据库、配置、插件、素材及应用授权凭据。
• 完整目录恢复到相同电脑、相同 Windows 用户时，先关闭应用并保留现有目录的副本。跨电脑迁移优先使用内容包，系统加密的凭据不能直接跨用户复用。

内容包包含页面和素材，不包含用户、客户激活码、SMTP 密码和应用授权凭据。不要把整个工作台目录作为公开文档或安装资源上传。

8. 启动失败或授权到期#

启动失败时，查看数据目录中的 desktop-runtime.log 和 logs。反馈时提供应用版本、系统版本、复现步骤和错误片段。

应用授权到期后，本地内容仍可查看，内容包仍可导出；编辑保存、内容导入、配置修改与发布需要有效授权。重新登录时可在引导页选择「仅查看与导出已有内容」。使用途中授权到期不会强制关闭已打开的编辑器，但保存与发布会被服务拒绝；请及时保存备份并联系管理员续期。