Skip to content

Your lightweight open-source personal agent.

test(release): provision CJK fonts for native Linux acceptance

Xubin Ren76cb13c8cd8b
diff --git a/.github/workflows/native-acceptance.yml b/.github/workflows/native-acceptance.yml
index 364a780f0..9556c3913 100644
--- a/.github/workflows/native-acceptance.yml
+++ b/.github/workflows/native-acceptance.yml
@@ -112,6 +112,12 @@ jobs:
if: runner.os == 'Windows'
run: python -m pip install --disable-pip-version-check pywinpty==3.0.5
+ - name: Install Linux CJK diagram fonts
+ if: runner.os == 'Linux'
+ run: |
+ sudo apt-get update
+ sudo apt-get install --no-install-recommends -y fonts-noto-cjk
+
- name: Verify packaged terminal interaction and native render latency
run: |
python tui/scripts/native_smoke.py --wheel "$ACCEPTANCE_WHEEL" \
diff --git a/docs/releasing.md b/docs/releasing.md
index be6bd5c31..100e1b408 100644
--- a/docs/releasing.md
+++ b/docs/releasing.md
@@ -88,6 +88,8 @@ Before release, measure TUI first-screen and Mermaid render latency on each supp
Native acceptance runs `tui/scripts/native_smoke.py` against the exact input wheel. It reuses the PTY/ConPTY input, resize and terminal-restoration checks, records five first-frame samples and cold/warm Mermaid samples with system font discovery, then terminates a submitted render and verifies a fresh worker. Its small report includes wheel/executable identities and sizes; obtain ZIP sizes from that candidate's manifest. This is automated native terminal interaction with an unavailable fixture gateway, not connected-model E2E or controlled cold-OS-cache timing. The `DiagramJobs` integration tests separately cover UI-side cancellation and subsequent-job completion.
+The native render fixture includes Chinese C4 labels and generated Latin punctuation. Linux acceptance installs the supported `fonts-noto-cjk` system dependency; macOS and Windows use their installed fonts. This setup does not bundle fonts in the wheel or prove Chinese rendering on a host without suitable fonts. Keep the glyph checks enabled and retain the source-view fallback for users whose fonts are unavailable.
+
### Build the PyPI platform wheels
After `uv build` and native archive checks, from the exact release checkout:
diff --git a/tui/README.md b/tui/README.md
index 620731989..9bced78c3 100644
--- a/tui/README.md
+++ b/tui/README.md
@@ -21,7 +21,7 @@ Assistant math written with `$...$`, `$$...$$`, `\\(...\\)`, or `\\[...\\]` is p
Mermaid diagrams appear after a reply finishes. Press `Ctrl+G` or run `/diagrams` to open the viewer, where you can zoom, pan, switch diagrams, and view or copy the source. Keyboard shortcuts are shown at the bottom. Press `q` or `Esc` to return without losing your draft or reading position. If a diagram cannot be displayed, its source remains available.
-On macOS, diagrams use the installed PingFang fonts. The system resolves their location automatically; no font-path configuration is needed. If the font lookup fails, check that PingFang is available in Font Book. Diagram source remains available while fonts are unavailable.
+On macOS, diagrams use installed Heiti SC Light and Medium fonts. The system resolves their location automatically; no font-path configuration or download is needed. If the font lookup fails, check that Heiti SC is available in Font Book. On Linux, Chinese diagram labels require Noto Sans CJK; Debian and Ubuntu provide it through the `fonts-noto-cjk` package. DejaVu Sans supports diagrams whose labels fit its character set, but does not provide Chinese glyphs. Windows uses Microsoft YaHei. Diagram source remains available while fonts or required glyphs are unavailable.
Automatic theme selection follows the terminal's OSC 10/11 responses. Until a response arrives, the TUI uses the terminal's default foreground and background without semantic colors or color animations. Terminals that do not answer keep this readable fallback. Use `nanobot --theme light` or `nanobot --theme dark` to select a color palette explicitly.