docs: document self:, builtin:, $/ and runner tracing (#553)

Documents the `self:` and `builtin:` action prefixes from https://github.com/go-gitea/gitea/pull/39358, https://gitea.com/gitea/runner/pulls/1233 and https://gitea.com/gitea/runner/pulls/871, workflow-relative `$/` actions, and the runner's OpenTelemetry tracing from https://gitea.com/gitea/runner/pulls/1206.

1. Trims the action resolution and `DEFAULT_ACTIONS_URL` docs to state each fact once.
1. Drops outdated runner content from the FAQ and design pages.
1. Syncs zh-cn and zh-tw, including a port of the token permissions page they now link to.

_Written by Claude._

Reviewed-on: https://gitea.com/gitea/docs/pulls/553
Reviewed-by: bircni <[email protected]>
Co-authored-by: silverwind <[email protected]>

i18n/zh-cn/docusaurus-plugin-content-docs/current/usage/actions/faq.md

@@ -27,34 +27,19 @@ DEFAULT_REPO_UNITS = ...,repo.actions
 
 ## 使用`actions/checkout@v4`等Actions时，Job容器会从何处下载脚本？
 
-GitHub 上有成千上万个 [Actions 脚本](https://github.com/marketplace?type=actions)。
-当您编写 `uses: actions/checkout@v4` 时，它默认会从 [github.com/actions/checkout](https://github.com/actions/checkout) 下载脚本。
-那如果您想使用一些托管在其它平台上的脚本呢，比如在 gitea.com 上的？
+默认从`https://github.com`下载，当`[actions].DEFAULT_ACTIONS_URL`为`self`时则从您自己的实例下载，参见[配置速查表](../../administration/config-cheat-sheet.md#actions-actions)。
 
-好消息是，您可以指定要从任何位置使用Actions的URL前缀。
-这是Gitea Actions中的额外语法。
-例如：
+要使用其他位置的Action，请指明其主机：
 
-- `uses: https://gitea.com/xxx/xxx@xxx`
-- `uses: https://github.com/xxx/xxx@xxx`
-- `uses: http://your_gitea_instance.com/xxx@xxx`
-
-注意，`https://`或`http://`前缀是必需的！
-
-这是与 GitHub Actions 的一个区别，GitHub Actions 只允许使用托管在 GitHub 上的 actions 脚本。
-但用户理应拥有权利去灵活决定如何运行 Actions。
-
-另外，如果您希望您的 Runner 默认从您自己的 Gitea 实例下载 Actions，可以通过设置 `[actions].DEFAULT_ACTIONS_URL`进行配置。
-参见[配置速查表](../../administration/config-cheat-sheet.md#actions-actions)。
+- `uses: https://gitea.com/owner/repo@ref`
+- `uses: http://your_gitea_instance.com/owner/repo@ref`
+- `uses: self:owner/repo@ref`，用于您自己的Gitea实例
 
 ## 如何限制Runner的权限？
 
-Runner仅具有连接到您的Gitea实例的权限。
-当任何Runner接收到要运行的Job时，它将临时获得与Job关联的仓库的有限权限。
-如果您想为Runner提供更多权限，允许它访问更多私有仓库或外部系统，您可以向其传递[密钥](usage/actions/secrets.md)。
-
-对于 Actions 的细粒度权限控制是一项复杂的工作。
-在未来，我们将添加更多选项以使Gitea更可配置，例如允许对仓库进行更多写访问或对同一组织中的所有仓库进行读访问。
+Runner仅连接到您的Gitea实例。
+对于每个Job，Runner会获得一个仅限于该Job所属仓库的`GITEA_TOKEN`，参见[Actions Job令牌权限](token-permissions.md)。
+如需让Job访问更多私有仓库或外部系统，请向其传递[密钥](usage/actions/secrets.md)。
 
 ## 如何避免被黑客攻击？
 
@@ -75,19 +60,8 @@ Runner仅具有连接到您的Gitea实例的权限。
 
 ## Runner 支持哪些操作系统？
 
-它在Linux、macOS和Windows上运行良好。
-虽然理论上支持其他操作系统，但需要进一步测试。
-
-需要注意的一点是，如果选择直接在主机上运行Job而不是在Job容器中运行，操作系统之间的环境差异可能会导致意外的失败。
-
-例如，在大多数情况下，Windows上没有可用的bash，而act尝试默认使用bash运行脚本。
-因此，您需要在工作流文件中将默认shell指定为`powershell`，参考[defaults.run](https://docs.github.com/zh/actions/using-workflows/workflow-syntax-for-github-actions#defaultsrun)。
-
-```yaml
-defaults:
-  run:
-    shell: powershell
-```
+官方发布了Linux、macOS和Windows的二进制文件。
+理论上，Go和Docker支持的其他系统也可以运行。
 
 ## 为什么选择GitHub Actions？为什么不选择与GitLab CI/CD兼容的工具？
 
@@ -99,42 +73,13 @@ defaults:
 
 ## 如果它在多个标签上运行，例如 `runs-on: [label_a, label_b]`，会发生什么？
 
-这是有效的语法。
-它意味着它应该在具有`label_a` **和** `label_b`标签的Runner上运行，参考[GitHub Actions的工作流语法](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idruns-on)。
-不幸的是，runner 并不支持这种方式。
-如上所述，我们将标签映射到环境：
-
-- `ubuntu` → `ubuntu:22.04`
-- `centos` → `centos:8`
-
-但我们需要将标签组映射到环境，例如：
-
-- `[ubuntu]` → `ubuntu:22.04`
-- `[with-gpu]` → `linux:with-gpu`
-- `[ubuntu, with-gpu]` → `ubuntu:22.04_with-gpu`
-
-我们还需要重新设计任务分配给Runner的方式。
-具有`ubuntu`、`centos`或`with-gpu`的Runner并不一定表示它可以接受`[centos, with-gpu]`的Job。
-因此，Runner应该通知Gitea实例它只能接受具有 `[ubuntu]`、`[centos]`、`[with-gpu]` 和 `[ubuntu, with-gpu]`的Job。
-这不是一个技术问题，只是在早期设计中被忽视了。
-参见[runtime.go#L65](https://gitea.com/gitea/runner/src/commit/90b8cc6a7a48f45cc28b5ef9660ebf4061fcb336/runtime/runtime.go#L65)。
-
-目前，runner 尝试匹配标签中的每一个，并使用找到的第一个匹配项。
+该Job会在拥有所有这些标签的Runner上运行，与[GitHub](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idruns-on)一致。
+Runner会使用这些标签中它所拥有的第一个标签对应的环境。
 
 ## 代理标签和自定义标签对于Runner有什么区别？
 
-![labels](/images/usage/actions/labels.png)
-
-代理标签是由 Runner 在注册过程中向 Gitea 实例报告的。
-而自定义标签则是由Gitea的管理员或组织或仓库的所有者手动添加的（取决于Runner所属的级别）。
-
-然而，目前这方面的设计还有待改进，因为它目前存在一些不完善之处。
-您可以向已注册的Runner添加自定义标签，比如 `centos`，这意味着该Runner将接收具有`runs-on: centos`的Job。
-然而，Runner可能不知道要使用哪个环境来执行该标签，导致它使用默认镜像或导致逻辑死胡同。
-这个默认值可能与用户的期望不符。
-参见[runtime.go#L71](https://gitea.com/gitea/runner/src/commit/90b8cc6a7a48f45cc28b5ef9660ebf4061fcb336/runtime/runtime.go#L71)。
-
-与此同时，如果您想更改Runner的标签，我们建议您重新注册Runner。
+Gitea已不再有自定义标签。
+Runner每次启动时都会声明其标签，标签来自`runner.labels`配置或注册时指定的标签，因此请在那里修改并重启Runner。
 
 ## Gitea Actions runner会有更多的实现吗？
 
@@ -165,3 +110,11 @@ defaults:
 
 > 对于 `pull_request` 事件，在 [GitHub Actions](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#pull_request) 中 `ref` 是 `refs/pull/:prNumber/merge`，它指向这个拉取请求合并提交的一个预览。但是 Gitea 没有这种 reference。
 > 因此，Gitea Actions 中 `ref` 是 `refs/pull/:prNumber/head`，它指向这个拉取请求的头分支而不是合并提交的预览。
+
+## 如何共享私有仓库中的Actions和可复用工作流？
+
+前往仓库的**设置** > **Actions** > **常规**页面并添加协作所有者。
+协作所有者的私有仓库可以访问当前仓库中的Actions和工作流。
+
+如需在同一用户或组织内共享，请改为在该用户或组织的**设置** > **Actions** > **常规** > **跨仓库访问**中添加这些私有仓库。
+参见[跨仓库访问](token-permissions.md#cross-repository-access)。