mirror of https://github.com/getpaseo/paseo.git synced 2026-10-30 21:23:04 +00:00

Files

T

Mohamed Boudra d87998bc8c feat(website): serve paseo.sh in Simplified Chinese

Every page of the website now has a Simplified Chinese version under
/zh-CN: the interface, docs, blog posts, comparison pages, legal pages,
all changelog releases and the homepage mockup. English URLs are unchanged.

The URL alone decides the language. There is no browser-language redirect
and no stored preference, because either would have to redirect the
unprefixed English URLs that people share and search engines index.
Internal links carry the page's language instead, and hreflang alternates
point Chinese search results at /zh-CN.

Translated headings pin the English anchor with {#id}, so section links
work in both languages. content-translations.test.ts fails when a page
has no translation or a translation's headings drift from the English.
Changelog releases and plugin listings without a translation render
whole in English under a notice, so a release never waits on one.

Plugin manifests and the registry gain optional translations and
OVERVIEW.zh-CN.md fields; older clients and registries ignore them.

2026-10-19 08:30:45 +02:00

3.4 KiB

Raw Blame History

title, description, nav

title	description	nav
为 Hub 配置 GitHub	创建 Hub 用于仓库访问和事件触发器的 GitHub App。	GitHub App

为 Hub 配置 GitHub

Hub 通过一个由你创建并拥有的 GitHub App 与 GitHub 通信。一个 App 服务于一个 Hub；安装它的每个账号或组织都会成为一个连接。

打开 Apps → GitHub。Hub 会给出当前的回调 URL、所需的仓库权限、订阅的事件，以及需要从 GitHub 复制回来的字段。保存之前，Hub 会验证这个 App。

公开 URL 要求

仓库访问和安装不需要 GitHub webhook。GitHub 事件触发器和配置同步则需要：GitHub 必须能够把事件投递到一个公开的 HTTPS URL。

在本地 HTTP 的 Hub 上，Apps 指南允许你配置仓库访问，并说明事件设置不可用。设置 PASEO_HUB_APP_URL 后，在 Hub 的公开地址上重新打开它，即可添加 webhook 密钥和事件。

GitHub 会使用以下 Hub URL：

设置项	Hub URL
Homepage URL	`<PASEO_HUB_APP_URL>`
Callback URL	`<PASEO_HUB_APP_URL>/api/integrations/github/callback`
Setup URL	`<PASEO_HUB_APP_URL>/api/integrations/github/setup`
Webhook URL	`<PASEO_HUB_APP_URL>/webhook`

请保持 GitHub 的 SSL 验证开启。

在 Subscribe to events 下，选择 Issue comment、Issues、Pull requests、Pull request review、Pull request review comment 和 Push。github.pull_request_created 和 github.pull_request_label_added 需要 Pull requests。

连接仓库

Hub 验证 App 之后，选择 Install on GitHub。选择 App 可以访问的账号或组织以及仓库。

请从 Hub 发起安装，而不是使用 GitHub 自己的安装按钮。这一来一回会把安装绑定到当前的 Hub 组织。

连接会以一个由账号派生的 slug 出现。例如，安装在 getpaseo 上会成为 getpaseo-github。Hub 组织需要多少安装就可以连接多少。

连接提供什么

事件：来自该安装可见仓库的 issue、评论、审查和推送。参见 GitHub 触发器。
配置同步：仓库可以保存标准的 .paseo 配置包。参见配置。
执行凭据：对于明确请求 GitHub 权限的 workflow step，Hub 会签发限定范围的 GitHub App token。

daemon 上已认证的 gh CLI 不会配置 Hub 的 GitHub 集成。它仍然可以在 Hub 限定的 GitHub 权限之外为 Agent 服务，但受 daemon 和 Provider 自身的环境与权限策略约束。

通过环境变量配置

把应用密钥保存在 Hub 之外的部署可以设置：

GITHUB_APP_ID=
GITHUB_APP_SLUG=
GITHUB_APP_CLIENT_ID=
GITHUB_APP_CLIENT_SECRET=
GITHUB_APP_PRIVATE_KEY=
GITHUB_WEBHOOK_SECRET=

私钥是从 GitHub 下载的 PEM 文件的内容。如果部署挂载了这个文件，请改用 GITHUB_APP_PRIVATE_KEY_PATH。

环境变量配置优先于已保存的 GitHub App，并在 Apps 下显示为 Managed by environment。完整的环境变量配置包含 webhook 密钥，因此需要一个公开的 webhook 地址。

3.4 KiB Raw Blame History Unescape Escape