Your lightweight open-source personal agent.
Python agent-frameworkai-agentai-agentschatbotchatopsdiscord-botllm-agentsllmslocal-llmmcpmodel-context-protocolmulti-agentopenai-compatibleopenclawpersonal-ai-assistantpythonself-hostedtelegram-bot-ai-assistantwebuiworkflow-automation
test(release): provision CJK fonts for native Linux acceptance
Xubin Ren76cb13c8cd8b
diff --git a/.github/workflows/native-acceptance.yml b/.github/workflows/native-acceptance.ymlindex 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 latencyrun: |python tui/scripts/native_smoke.py --wheel "$ACCEPTANCE_WHEEL" \diff --git a/docs/releasing.md b/docs/releasing.mdindex 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 suppNative 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 wheelsAfter `uv build` and native archive checks, from the exact release checkout:diff --git a/tui/README.md b/tui/README.mdindex 620731989..9bced78c3 100644--- a/tui/README.md+++ b/tui/README.md@@ -21,7 +21,7 @@ Assistant math written with `$...$`, `$$...$$`, `\\(...\\)`, or `\\[...\\]` is pMermaid 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.