Content - All

Mon, 01 Jan 0001 00:00:00 +0000

Unreleased

Tue, 20 Oct 2026 00:00:00 +0800

Added

Chinese guides and developer documentation at https://banyan.swaw.com/.
Hugo Module at github.com/SwawHQ/banyan/module, with matching swaw-banyan Skill versions. doctor [directory] checks Module and theme-directory versions, vendored dependencies and local development. Local theme versions come from theme.toml. Doctor also checks selected tools and runtime launchers, including a damaged launcher or bindings file, and provides manual recovery steps. Ordinary tasks do not check pairing. Check switches and repair hints are maintained in references/doctor.toml. Extracted project ZIPs pair their built-in Skill and Module using module/theme.toml, without a .git directory. Recovery messages include the project URL, theme source ZIP and Module version commands.
Windows x64 CLI with Node/npm, Git, Go, Hugo and optional Bun and GitHub CLI. uv and Python 3.13 support isolated Python scripts and CLI packages in the Skill, including sites that already use uv. The system PATH and Python registry stay unchanged. Portable downloads are checksum-verified. npm prepares parser packages on demand for sync/ext and content checks, isolated from parent workspaces; site builds need no npm dependencies.
Name and product list views with shared column navigation and sorting. Site-owned taxonomies define product classifications.
Powered by page with the effective theme and Hugo versions, site build details, and PWA status and update checks.
Versioned release notes in the demo site’s content/changelog/. params.theme_changelog sets the Powered by release-notes URL.
Browser checks for navigation, layout, language settings, images, prefetch and PWA, with Chromium and selected WebKit checks. check/browser/site discovers representative pages and reports skipped coverage.
Static and HTTP checks for content, HTML, sitemap, robots, LLMS, images, CSP, SRI, cache headers and prefetch, plus asset-size and payload reports. HTML checks also validate article date rows, path order, aside controllers and static update controls. check/delivery checks generated platform formats, fingerprint policy agreement and published file names without reading resource bodies. Use --base-path for subdirectory deployments; URL path characters and EdgeOne host redirects retain their platform syntax.
sync/ext for declared external resources and deploy/edgeone/sync for generated deployment configuration.
deploy/cloudflare/cli and deploy/cloudflare/wrangler run pinned Cloudflare CLIs with native arguments. Each has ensure [--force] and a local check; normal commands prepare packages as needed. Authentication uses each CLI’s native per-user credentials or a shared API Token in Windows Credential Manager. Native configuration, sign-in credentials and storage remain CLI-managed; compatible sign-in from system installations can be reused. auth/token/check also finds manually added credentials. Resource names and explicit boolean flag values no longer change credential selection. auth whoami uses the same credential priority as resource commands. cf and Wrangler commands, including page sign-in and status checks, use fixed %TEMP%/swaw/banyan/cf/ and %TEMP%/swaw/banyan/wrangler/ directories. The directories and caches persist. Local paths use these directories; use absolute local paths. For a project, pass Wrangler’s native --cwd with an absolute project path. cf resource-management commands use an empty configuration; development and builds need an actual project configuration.
deploy/tencent/cli runs a pinned tccli with automatic uv/Python preparation in an isolated Skill environment. It provides ensure [--force] and a local read-only check, preserving native Tencent Cloud and EdgeOne commands. Sign-in and credential refresh require TLS certificate verification. auth/key/check returns a nonzero exit code when the local credential is absent. Configuration and sign-in follow tccli’s native rules. The page explains its plaintext sign-in storage and recommends API keys saved in Windows Credential Manager. tccli commands, including page sign-in and status checks, use the fixed %TEMP%/swaw/banyan/tccli/ directory and retain its caches. Use absolute local paths.
deploy/auth/setup opens one local authorization page for Cloudflare and Tencent Cloud. Each platform’s auth/setup entry selects its tab. The page supports native sign-in, Windows-stored API credentials and read-only environment status, with credential priority, site icons in their original colors and system-language text in English or Chinese. A title-bar language switch preserves inputs and progress; reloading returns to the system language without saving the selection. Platform navigation and method tabs use a monochrome layout with a thin column divider. Credential priority sits below the title; Close is in the upper-right corner. Supplementary notes follow the controls or variable table. Sign-in and API Token notes use numbered lists for setup, permissions and credential storage. Sign-in tabs prepare tools in the background, show readiness and support retry, then check existing cf and Wrangler sign-in and usable tccli native credentials, including after reload or reopening. tccli uses a native STS identity query with the same profile as sign-in; it does not distinguish stored sign-in from keys or check product permissions. Sign-in buttons show request progress immediately. API Token setup stays available during downloads and checks; Close stops preparation, checks and sign-in. The page no longer expires automatically; each CLI keeps its own authorization timeout. The page avoids browser-blocked ports. Cancellation still closes the session after a credential write if the save connection disconnects. Narrow screens stack the columns. Both platforms use the API Token tab label. Tencent access keys use swban/tencent/default; auth/key/check checks local presence.
MIT licenses for the repository, Module and Skill, with third-party notices.

Changed

Skill tool commands use base/<tool>, base/<tool>/check and base/<tool>/ensure. The entry uses Node and prepares Node/npm and required tools on demand; Bun remains an independent tool. base/ensure is removed. Hugo and Go prepare Git as needed. The theme no longer enables unused Git page information. GitHub CLI is prepared when used. Run npm and npx with base/node/npm and base/node/npx. Python commands use base/uv/python, base/uv/python/check and base/uv/python/ensure; common help lists uv as the Python tool manager. Prepare parser packages with base/packages/ensure before working offline; use --force to reinstall. Doctor reports missing packages without installing them. Prepare browsers with base/browser/ensure and base/browser/ensure.webkit. help/en [depth|path [depth]] and help/zh [depth|path [depth]] list commands and categories or show full help. Depth can start below a selected path; lists retain full paths and mark categories with a trailing /. With no argument, help shows common commands, including build, preview and release examples. help selects the system language. Invalid help files report their path and the JSON parse reason or specific field.

A Predictable Content Model

Thu, 01 Jan 2026 00:00:00 +0800

This page is intentionally small. It proves that article rendering, metadata, taxonomy links, and breadcrumb navigation work in a clean consumer site.

Structure Before Decoration

Banyan derives navigation from real pages and taxonomies. A page declares what it is, while the theme owns how that structure is presented.

The article belongs to two independent tag paths. This demonstrates that one page can appear under both AI and developer tooling without duplicating content.