> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 代码签名

为安装包签名，减少 macOS 和 Windows 对用户的安全警告。

## 初学者演练

先决条件：完成桌面本地设置，包括 Rust 和操作系统构建工具。在构建安装程序之前停止 Tauri 开发过程；让 Web 后端保持运行。从存储库根目录运行下面的每项检查，并等待其完成，然后再运行下一项。过滤后的包命令适用于仅桌面版和所有平台签出。

简而言之：工作区是一个团队的单独用户、数据和设置。服务器是可信后端；让提供商密钥远离浏览器和电话代码。迁移是创建或更新表的版本化数据库更改。人工智能模型是回答的引擎；型号目录是服务器上可用型号 ID 和价格的列表。提供商是一种外部服务，例如人工智能、电子邮件或计费服务。权利是允许工作区使用某项功能的授权。 Webhook 是一个服务发送到另一个服务的 URL 的消息。

1. 在本地分支机构，请您的编码代理检查 `apps/desktop/src-tauri/tauri.conf.json` 并将产品标识符、应用程序名称、图标和后端 URL 设置为您拥有的值。使用公共 HTTPS 后端 URL 进行发布版本。

2. 从存储库根目录运行下面的桌面包检查。在check:release-config之前，使用桌面本地设置中的操作系统命令在此终端中设置SUPASTACK_APP_URL；公共 HTTPS 后端必须正在运行，并且应用程序标识符必须是您自己的。

3. 成功的构建不会签署、公证或发布安装程序；如果 Rust 或系统库丢失，请完成桌面本地设置。

对于自定义代码，请从提供的 `prompts/README.md` 开始，然后复制最接近的提示：对于应用程序屏幕为 `prompts/new-app-screen.md`，对于公共页面为 `prompts/new-landing-page.md`。对于服务器、数据库或提供商工作，请为您的编码代理提供本指南的任务，并要求其读取 `AGENTS.md`、`.ai/PROJECT_CONTEXT.md` 和匹配的 `.ai/` 镜像；检查此处指定的确切源文件；列出文件并在编辑前进行检查；保留工作区所有权和仅限服务器的机密；并向您展示差异。告诉它您想要的行为、输入和输出字段、允许的角色、预期的成功和错误以及测试帐户、提供程序或设备。使用样本值；永远不要粘贴真正的秘密。

[开始之前](https://supastack.dev/zh/docs/web/before-you-start.md)

[终端基础知识](https://supastack.dev/zh/docs/web/terminal-basics.md)

[桌面本地设置](https://supastack.dev/zh/docs/desktop/ship-in-5-minutes.md)

[座席提示和项目内存](https://supastack.dev/zh/docs/web/agents.md)

```
corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build
```


## 配置产品外壳

查看 `src-tauri/tauri.conf.json`、Cargo 元数据、功能和平台标识符。通过共享资产流程替换应用程序图标，并在构建/运行时设置预期后端 URL。托管 Web 应用程序必须已部署且可访问。


## 运行本机构建门

这些包命令运行 Rust 类型检查和测试、验证发布设置并构建 Tauri 安装程序。签名和分发配置取决于目标平台和您的帐户/证书；不要将签名材料存储在源中。

```
corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build
```


## 验证目标操作系统上的安装程序

检查全新安装、启动、后端可访问性、身份验证、菜单/托盘、热键注册、第二实例、深层链接、离线重试和卸载。分别验证每个支持的操作系统。本地构建不能证明经过签名或公证的商业分发；不包括签名配置、更新程序源和发布自动化。

[本机验收清单](https://supastack.dev/zh/docs/desktop/run.md)

[部署共享后端](https://supastack.dev/zh/docs/web/deployment.md)


## 安装与配置

1. 未签名的安装包可以在自己的电脑上安装，但其他用户会看到 Gatekeeper 和 SmartScreen 警告；发布前需要签名。

2. macOS 需要加入 Apple Developer Program 并获取 Developer ID 证书，然后在 src-tauri/tauri.conf.json 的 bundle 部分配置签名和公证，并从 CI 密钥库向 Tauri 提供 APPLE_CERTIFICATE、APPLE_CERTIFICATE_PASSWORD、APPLE_SIGNING_IDENTITY，以及公证所需的 APPLE_API_KEY 和 APPLE_API_ISSUER。

3. Windows 需要配置 bundle 签名，可用证书 thumbprint 或自定义 signtool 命令；证书同样应由运行器的密钥库提供。

```
# tauri.conf.json ships unsigned today:
#   "bundle": { "active": true, "targets": "all", "icon": [...] }
# Add signing under bundle > macOS / bundle > windows
# and keep every certificate and password in your secret store,
# never in the repo.
# Auto-updater & release channels (stable / beta via {{channel}}):
# SUPASTACK_UPDATER_ENDPOINT=https://releases.example.com/{{channel}}/{{target}}/{{arch}}/{{current_version}}
# SUPASTACK_UPDATER_PUBKEY=…
# SUPASTACK_UPDATE_CHANNEL=stable
```


## 实现流程

通过自己的密钥库配置证书，并在构建时注入环境变量。证书一旦提交到仓库，就应视为需要吊销。

在同一发布构建中设置生产环境 SUPASTACK_APP_URL，确保安装后的外壳指向已部署应用，而不是 localhost。


## 验证与排障

将安装包安装到另一台电脑上进行验证：不再出现 Gatekeeper 或 SmartScreen 警告，应用可以启动，登录状态能够保留。仅仅 tauri build 成功而未测试签名安装，不足以证明具备发布条件。

接下来：Web 栏中的《部署检查清单》介绍服务器上线前的准备。


如果你想继续完成设置，可以阅读《[部署清单](https://supastack.dev/zh/docs/web/deployment.md)》。


## 下一篇

[部署清单](https://supastack.dev/zh/docs/web/deployment.md)