企业官网建设流程全解析

• 桌面应用
• 插件系统
• AI Agent
• 人工智能
• MCP 服务
• dsh-plugin

OpenPets 是一款本地优先（Local-first）的桌面伴侣平台，内置动画宠物、插件 SDK 与编程智能体（coding-agent）集成。想让 OpenPets 正式发行到三大桌面系统？本文带你走通 OpenPets 跨平台打包与代码签名的完整流程，覆盖 Windows、macOS、Linux 的发布分发要点，帮助新手一次做出可正常安装的正式版本。

📥 先获取源码：克隆 OpenPets 仓库

本地尚未拿到代码的话，先执行以下命令克隆 OpenPets 仓库：

git clone https://gitcode.com/gh_mirrors/op/openpets

📌 提示：该仓库是面向迁移安装环境的兼容发布镜像，项目当前状态与入口说明见 README.md。

三端发布形态速览：先选对打包产物

动手做跨平台打包前，先了解各平台最常用的发布产物与签名方式：

核心思路：OpenPets 是桌面应用，三端都遵循「构建 → 签名 → 校验 → 发布」四步走，先选对产物，再谈签名。

🪟 Windows 发布打包与代码签名步骤

1. 生成安装产物：编译 OpenPets 主程序（x64，必要时加 arm64），用安装器工具打成双击即装的.exe或.msi。
2. 获取代码签名证书：从正规 CA 购买 Authenticode 证书（EV/OV），免费试用证书不适合正式分发。
3. 先签主程序、再签安装包：只签安装包而漏签内部可执行文件，是用户看到 SmartScreen 弹窗的第一大原因。
4. 验证签名：右键安装包 → 属性 → 数字签名，确认发布者名称与版本正确。

🍎 macOS 打包与签名公证：开发者证书是前提

macOS 审核最严，OpenPets 在这条线上需要额外完成三件事：

• 申请 Developer ID Application 证书：普通 Apple 账号不够，需加入 Apple 付费开发者计划。
• 用codesign递归签名.app：OpenPets 内置的插件 SDK 模块与 coding-agent 集成组件要一并签到位。
• 提交公证并装订（staple）：公证票据绑定到应用后，用户双击即可打开，无需右键「打开」。

建议产物：Universal 通用构建（同时支持 Apple Silicon 与 Intel 机型），省得用户自己判断该下哪份。

🐧 Linux 发布分发：AppImage 与包管理器双通道

Linux 生态碎片化，实用的 OpenPets 发布策略是双通道：

1. 主推 AppImage：免安装、双击运行，最适合动画宠物伴侣类应用快速传播。
2. .deb/.rpm作为补充：面向需要系统集成、托盘菜单与开机自启的用户。
3. 依赖核查：确认图形、音频等运行库已随包或可在主流发行版安装，避免「能装不能跑」。
4. GPG 签名（可选）：用个人密钥对发布产物签名并提供.sig文件，供用户校验完整性。

代码签名常见问题排查清单

上线前最终检查清单

• 三端产物版本号与发布标签一致
• 签名证书均在有效期内
• 主程序、安装包、插件 SDK 模块全部完成签名
• 发布说明（Release Notes）与安装路径已写清
• 在干净系统上实测安装、启动与签名校验

写在最后

对 OpenPets 这样的桌面伴侣平台来说，跨平台打包与代码签名是发布分发的最后一程：Windows 签好 Authenticode，macOS 完成 Developer ID 公证，Linux 备好 AppImage，用户才能放心安装。项目当前的发布状态说明，可随时查看 README.md。

• 桌面应用
• 插件系统
• AI Agent
• 人工智能
• MCP 服务
• dsh-plugin