okooooooo/Piik
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(website): restore download provider labels and clarify Server packages

Browse Source 
## Problem and outcome / 问题与结果

Restore explicit GitHub and Gitee labels on every platform download card while keeping each provider's native latest-download URL. Identify the Linux Server archive by its actual release filename in both READMEs and self-hosting guides, and record the remaining maintenance reports in TODO.

## Verification / 验证

- Website build, documentation checks and repository hygiene pass.
- Both languages fit at 360px; all six links retain their platform-specific latest routes.
- An independent reader ran the documented source and Windows App sharing paths; the Server archive naming correction follows that walkthrough.
- The release planner reports `publish: false` for this commit.

## Impact / 影响

Website and documentation only; no App/Server release. The Chrome block on Gitee downloads remains unresolved and tracked in TODO; the label correction does not clear that provider verdict.
This commit is contained in:
AAA authored and GitHub committed 2026-09-14 01:32:45 +08:00
1 parent 02e71621f2
commit 8effc8e8f4
8 files changed
+50 -23
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

README.md
+2 -1
View File
@@ -87,7 +87,8 @@ link and the demo, may not connect on restrictive networks.
## Self-hosting
Piik Server is a standalone binary with the web interface built in.
Download the Linux x64 Server package, extract it, and run:
Download the Linux x64 Server package (`piik-<revision>-runtime.tar.gz`),
extract it, and run:
```sh
./piik-server
README.zh-CN.md
+1 -1
View File
@@ -83,7 +83,7 @@ macOS 和 Linux 客户端尚未经过实机测试，欢迎有设备的朋友试
## 自行部署
Piik Server 是一个内置网页界面的独立程序。
下载 Linux x64 服务端程序包，解压后运行：
下载 Linux x64 服务端程序包 `piik-<revision>-runtime.tar.gz`，解压后运行：
```sh
./piik-server
docs/design/public-introduction.md
+3 -5
View File
@@ -133,11 +133,9 @@ are not automatically included in the website artifact.
The [website operations guide](../operations/website.md) owns Pages publication,
public destinations and the separate P2P-only demo. The primary action leads
to the platform download section. Each supported platform uses the native latest
download routes of GitHub and Gitee, as owned by the website operations guide.
Use “Download” / “下载” for the primary action and name Gitee on the alternative.
Keep archive formats and build-time versions out of button labels, and link
release notes separately. Verify destinations as part of publication.
to the platform download section. The website operations guide owns each
platform's latest download routes and provider labels. Link release notes
separately and verify destinations as part of publication.
Demo, App and existing-site walkthroughs
use real action names and explain the first sharing and viewing steps. Keep
platform requirements and connection limitations beside the relevant steps.
docs/operations/self-hosting.md
+4 -3
View File
@@ -9,9 +9,10 @@ forwarding in **one server binary**. Extract and run it; room data is stored in
These server instructions use a Linux x64 machine.
Download the **Linux x64 Server** archive from [GitHub Releases](https://github.com/TNTcraftHIM/Piik/releases)
or the [Gitee mirror](https://gitee.com/TNTcraftHIM/Piik/releases),
extract it, and run the following in its directory:
Download **`piik-<revision>-runtime.tar.gz`**, the Linux x64 Server archive,
from [GitHub Releases](https://github.com/TNTcraftHIM/Piik/releases)
or the [Gitee mirror](https://gitee.com/TNTcraftHIM/Piik/releases).
Extract it and run the following in its directory:
```sh
./piik-server
docs/operations/self-hosting.zh-CN.md
+1 -1
View File
@@ -10,7 +10,7 @@ Piik Server 将网页、房间管理和可选的媒体转发打包在**一个服
以下服务端操作在 Linux x64 环境中执行。
从 [GitHub Releases](https://github.com/TNTcraftHIM/Piik/releases) 或
[Gitee 镜像](https://gitee.com/TNTcraftHIM/Piik/releases)下载 **Linux x64 服务端**程序包，
[Gitee 镜像](https://gitee.com/TNTcraftHIM/Piik/releases)下载 **`piik-<revision>-runtime.tar.gz`**，即 Linux x64 服务端程序包。
解压后，在该目录运行：
```sh
docs/operations/website.md
+3 -2
View File
@@ -82,8 +82,9 @@ each provider's native latest-attachment route:
([Windows download](https://gitee.com/TNTcraftHIM/Piik/releases/download/latest/piik-app-windows-amd64.zip)).
Both links follow provider publication without a website rebuild or a release
API request from the build or visitor. Buttons say “Download” / “下载”; the
secondary link names Gitee. Keep versions and archive formats out of these labels.
API request from the build or visitor. Platform buttons say “Download from GitHub” /
“GitHub 下载”; the secondary link says “Download from Gitee” /
“Gitee 国内镜像下载”. Keep versions and archive formats out of these labels.
[Versioning](../reference/versioning.md#release-sources) owns package verification
and completion of mirror publication. GitHub remains the primary source; the
Gitee download can temporarily lag while a mirror publication completes.
docs/todo.md
+27 -1
View File
@@ -1,6 +1,6 @@
# Current TODO Ledger
Last reviewed: 2026-09-13
Last reviewed: 2026-09-14
Only **Now** is executable. Product modules own behavior; Git/PRs own completed
history. A parked idea is not implementation authority.
@@ -12,6 +12,32 @@ history. A parked idea is not implementation authority.
Follow the [deployment runbook](./deployment.md) for the private service and keep public
demo deployment separate. Preserve the owner's
[device/network deferrals](./verification-status.md#candidate-evidence-boundary).
- [ ] **Browser sharing startup failure.** Reproduce [#399](https://github.com/TNTcraftHIM/Piik/issues/399):
the local encoding connection can remain connecting without producing frames
or entering the existing ordinary-sender fallback. Verify bounded startup and
retirement at that owner before changing room routing or ICE configuration.
- [ ] **App startup feedback.** Verify [#396](https://github.com/TNTcraftHIM/Piik/issues/396)
against the current release. Its older build predates the LAN selector,
detailed launcher errors and Windows error-exit pause; those repairs do not
establish resolution on the reporting machine. Use a current Debug report if
startup still fails.
- [ ] **Chrome mirror download warning.** Verify the current Gitee download in
Chrome and resolve its download-source warning using the recorded verdict and
package checksums. Keep GitHub primary; ordinary link changes do not establish
that Safe Browsing has cleared the mirror.
- [ ] **App launch-mode preference.** Check why a saved Site keeps selecting
Site mode after the user chooses another mode. Review last-used-mode behavior
and its configuration owner before changing startup selection.
- [ ] **Display-name editing.** Reproduce the edit button immediately closing
or failing to open the editor. Check Host and Viewer forms, including native
submit behavior when React reuses action buttons, before changing signaling.
- [ ] **Theater centering.** Keep expansion and collapse centered. The current
width spring overshoots the viewport before settling; verify motion at wide
and narrow sizes without changing playback state.
- [ ] **Tooltip motion consistency.** Review all tooltip entries and explanatory
comics for missing motion across languages, themes and pointer/touch input.
Check trigger reuse and static rendering against the shared visual grammar;
resolve any intended change to settled-state motion in that owner.
Keep fixes on a maintenance branch until acceptance. The public release is the
compatibility baseline; private service deployment stays independent.
site/index.html
+9 -9
View File
@@ -741,10 +741,10 @@
data-download="windows-amd64" data-provider="github"
href="https://github.com/TNTcraftHIM/Piik/releases/latest/download/piik-app-windows-amd64.zip"
aria-describedby="download-status"
><svg aria-hidden="true"><use href="#download-mark" /></svg><span lang="en">Download</span
><span lang="zh-CN">下载</span></a
><svg aria-hidden="true"><use href="#download-mark" /></svg><span lang="en">Download from GitHub</span
><span lang="zh-CN">GitHub 下载</span></a
><a data-download="windows-amd64" data-provider="gitee" href="https://gitee.com/TNTcraftHIM/Piik/releases/download/latest/piik-app-windows-amd64.zip"
><span lang="en">Download via Gitee</span><span lang="zh-CN">Gitee 备用下载</span></a
><span lang="en">Download from Gitee</span><span lang="zh-CN">Gitee 国内镜像下载</span></a
>
</article>
<article class="download-card" aria-labelledby="download-macos">
@@ -771,10 +771,10 @@
data-download="darwin-arm64" data-provider="github"
href="https://github.com/TNTcraftHIM/Piik/releases/latest/download/piik-app-darwin-arm64.zip"
aria-describedby="download-status"
><svg aria-hidden="true"><use href="#download-mark" /></svg><span lang="en">Download</span
><span lang="zh-CN">下载</span></a
><svg aria-hidden="true"><use href="#download-mark" /></svg><span lang="en">Download from GitHub</span
><span lang="zh-CN">GitHub 下载</span></a
><a data-download="darwin-arm64" data-provider="gitee" href="https://gitee.com/TNTcraftHIM/Piik/releases/download/latest/piik-app-darwin-arm64.zip"
><span lang="en">Download via Gitee</span><span lang="zh-CN">Gitee 备用下载</span></a
><span lang="en">Download from Gitee</span><span lang="zh-CN">Gitee 国内镜像下载</span></a
>
</article>
<article class="download-card" aria-labelledby="download-linux">
@@ -800,10 +800,10 @@
data-download="linux-amd64" data-provider="github"
href="https://github.com/TNTcraftHIM/Piik/releases/latest/download/piik-app-linux-amd64.zip"
aria-describedby="download-status"
><svg aria-hidden="true"><use href="#download-mark" /></svg><span lang="en">Download</span
><span lang="zh-CN">下载</span></a
><svg aria-hidden="true"><use href="#download-mark" /></svg><span lang="en">Download from GitHub</span
><span lang="zh-CN">GitHub 下载</span></a
><a data-download="linux-amd64" data-provider="gitee" href="https://gitee.com/TNTcraftHIM/Piik/releases/download/latest/piik-app-linux-amd64.zip"
><span lang="en">Download via Gitee</span><span lang="zh-CN">Gitee 备用下载</span></a
><span lang="en">Download from Gitee</span><span lang="zh-CN">Gitee 国内镜像下载</span></a
>
</article>
</div>