Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

feat(landing): refresh homepage and download experience (#473)

Yaowei Zhengc4bccc56176a
diff --git a/README.md b/README.md
index 2807b3d7..d1371b6f 100644
--- a/README.md
+++ b/README.md
@@ -4,16 +4,19 @@
<h1 align="center">PenguinHarness</h1>
-<p align="center"><b>Your Automated Agent Builder, Right on Your Desktop / Server</b><br />Create Self-Evolving Agents in One Click</p>
-
-<h3 align="center"><a href="https://penguin.ooo/download/">⬇️ Click to Download</a></h3>
-
-<p align="center">macOS · Windows · Linux</p>
+<p align="center"><strong>Open-source, local-first platform for automated agent app development</strong><br />Fully automate <strong>building</strong> · <strong>optimizing</strong> · <strong>deploying</strong> AI applications</p>
<p align="center">
- <a href="https://www.producthunt.com/products/penguinharness?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-penguinharness" target="_blank" rel="noopener noreferrer"><img alt="PenguinHarness - Let Agents Autonomously Build Better Agents for $0.02 | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1202577&amp;theme=light&amp;t=1784804711946" /></a>
+ <a href="https://penguin.ooo/download">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="assets/readme/download-en-dark.svg" />
+ <img src="assets/readme/download-en-light.svg" alt="Download App" height="44" />
+ </picture>
+ </a>
</p>
+<p align="center">1000+ Models · Multi-Platform · Apache 2.0 · Agent Self-Evolution</p>
+
<p align="center">
<a href="https://www.npmjs.com/package/@prismshadow/penguin-core"><img src="https://img.shields.io/npm/v/@prismshadow/penguin-core" alt="npm version" /></a>
<a href="https://github.com/Prism-Shadow/penguin-harness/actions/workflows/ci.yml"><img src="https://github.com/Prism-Shadow/penguin-harness/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
@@ -34,13 +37,17 @@
<a href="https://github.com/Prism-Shadow/penguin-harness-community/blob/main/wechat/group.jpg"><img src="https://img.shields.io/badge/WeChat-user%20group-07C160?logo=wechat&logoColor=white" alt="WeChat" /></a>
</p>
+<p align="center">
+ <a href="https://www.producthunt.com/products/penguinharness?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-penguinharness" target="_blank" rel="noopener noreferrer"><img alt="PenguinHarness - Let Agents Autonomously Build Better Agents for $0.02 | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1202577&amp;theme=light&amp;t=1784804711946" /></a>
+</p>
+
<p align="center">English | <a href="README.zh.md">简体中文</a></p>
## Why PenguinHarness
> With LangChain, you build agents by hand — at 1× speed.<br />With PenguinHarness, agents build agents — at 100×.
-Three reasons, in deliberate order — from task quality, to how agents get built, to how they keep improving.
+PenguinHarness runs on your computer or server and automates the agent app lifecycle from creation and evaluation to optimization and deployment. Three reasons define the platform:
### 1. 🏆 Outstanding results at tens of times less cost
@@ -55,9 +62,9 @@ A deliberately minimal toolset over clean low-level interfaces: fewer tool calls
**Best accuracy on data analysis — at 1/70 of Claude Code's cost.**
-### 2. ⚡ One sentence, and an agent builds your agent app
+### 2. ⚡ One sentence generates a runnable agent app
-Type one sentence, and an agent builds the complete agent application for you — scaffold, code, and run instructions, end to end:
+Describe what you need in one sentence. PenguinHarness builds the complete agent application — scaffold, code, and run instructions, end to end:
```text
Collect the docs from https://github.com/ericbuess/claude-code-docs and build a RAG app that answers Claude Code questions as a configuration expert, citing its sources.
@@ -69,9 +76,9 @@ https://github.com/user-attachments/assets/9b7033e8-f08a-4c3f-bd33-547896664e6e
**And generating this entire RAG app burned just $0.02 (¥0.2) of tokens — on DeepSeek V4 Pro.**
-### 3. 🧬 Self-evolution: it gets stronger with use
+### 3. 🧬 Native agent self-evolution engine
-With PenguinHarness Skills, an agent evaluates and optimizes itself: run the benchmark, find the lost points, ship version N+1 — with a snapshot before every round, and every request observable in the Trace view.
+With PenguinHarness Skills, an agent evaluates and optimizes itself: run the benchmark, find the lost points, ship version N+1 — with a snapshot before every round and every request observable in the Trace view.
https://github.com/user-attachments/assets/922d13a6-5ffc-4685-9a39-352f02f9afc0
@@ -113,7 +120,7 @@ Each family's latest generation only — the app's **Models** page lists every b
## Installation
-Two ways in — both work on the same `~/.penguin/data` root, so a desktop install and a CLI install can be mixed freely:
+Start with the desktop app, or install the command line on a workstation or server. Both use the same `~/.penguin/data` root and can be mixed freely:
- **🖥️ Desktop app** — a double-click install: it embeds the server and opens already signed in, no terminal involved.
- **⌨️ CLI** — a one-line installer (or npm / offline package) puts the `penguin` command on the machine; `penguin web` then serves the full Web experience in your browser at `http://127.0.0.1:7364` (multi-session chat, agent / skill / model management, usage stats, Trace observability, evaluation center). The online installers bundle their own Node runtime — unpack and run; upgrades and reinstalls never touch your data.
@@ -125,7 +132,7 @@ Two ways in — both work on the same `~/.penguin/data` root, so a desktop insta
The full Web experience as a standalone application: it embeds the server and opens already signed in — no terminal, no login page, no initial password to copy. It works on the same `~/.penguin/data` root as a CLI install, so the two can be used interchangeably (a data root only ever runs one server; if a CLI-started instance is already up, the app attaches to it).
-**[⬇️ Get it from the download page](https://penguin.ooo/download)** — the page serves the OSS-accelerated mirror when it is reachable, and every installer is also attached to each [GitHub Release](https://github.com/Prism-Shadow/penguin-harness/releases).
+Download the desktop app from the [download page](https://penguin.ooo/download). The page serves the OSS-accelerated mirror when it is reachable, and every installer is also attached to each [GitHub Release](https://github.com/Prism-Shadow/penguin-harness/releases).
| Platform | Installers |
| ----------- | --------------------------- |
diff --git a/README.zh.md b/README.zh.md
index c0eac1d0..83b8cc55 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -4,16 +4,19 @@
<h1 align="center">PenguinHarness</h1>
-<p align="center"><b>全自动 Agent 构建平台,运行在你的桌面 / 服务器上</b><br />一键创建自进化 Agent</p>
-
-<h3 align="center"><a href="https://penguin.ooo/download/">⬇️ 点击下载</a></h3>
-
-<p align="center">macOS · Windows · Linux</p>
+<p align="center"><strong>开源、本地的 Agent 应用自动开发平台</strong><br />全自动<strong>创建</strong> · <strong>优化</strong> · <strong>部署</strong> AI 应用</p>
<p align="center">
- <a href="https://www.producthunt.com/products/penguinharness?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-penguinharness" target="_blank" rel="noopener noreferrer"><img alt="PenguinHarness - Let Agents Autonomously Build Better Agents for $0.02 | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1202577&amp;theme=light&amp;t=1784804711946" /></a>
+ <a href="https://penguin.ooo/download">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="assets/readme/download-zh-dark.svg" />
+ <img src="assets/readme/download-zh-light.svg" alt="下载应用" height="44" />
+ </picture>
+ </a>
</p>
+<p align="center">1000+ 模型 · 多平台 · Apache 2.0 · Agent 自进化</p>
+
<p align="center">
<a href="https://www.npmjs.com/package/@prismshadow/penguin-core"><img src="https://img.shields.io/npm/v/@prismshadow/penguin-core" alt="npm 版本" /></a>
<a href="https://github.com/Prism-Shadow/penguin-harness/actions/workflows/ci.yml"><img src="https://github.com/Prism-Shadow/penguin-harness/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
@@ -34,13 +37,17 @@
<a href="https://github.com/Prism-Shadow/penguin-harness-community/blob/main/wechat/group.jpg"><img src="https://img.shields.io/badge/%E5%BE%AE%E4%BF%A1-%E4%BA%A4%E6%B5%81%E7%BE%A4-07C160?logo=wechat&logoColor=white" alt="微信群" /></a>
</p>
+<p align="center">
+ <a href="https://www.producthunt.com/products/penguinharness?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-penguinharness" target="_blank" rel="noopener noreferrer"><img alt="PenguinHarness - Let Agents Autonomously Build Better Agents for $0.02 | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1202577&amp;theme=light&amp;t=1784804711946" /></a>
+</p>
+
<p align="center"><a href="README.md">English</a> | 简体中文</p>
## 为什么选择 PenguinHarness
> 使用 LangChain,以 1 倍速度人工构建 Agent;<br />使用 PenguinHarness,以 100 倍速度用 Agent 构建 Agent。
-三个递进的理由——从任务效果,到构建方式,再到进化能力。
+PenguinHarness 运行在你的电脑或服务器上,自动串联 Agent 应用的创建、评测、优化与部署。三个递进的理由定义了这个平台:
### 1. 🏆 以几十分之一的成本,跑出优异的效果
@@ -55,9 +62,9 @@
**数据分析准确率最高——成本只有 Claude Code 的 1/70。**
-### 2. ⚡ 一句话,让 Agent 构建 Agent 应用
+### 2. ⚡ 一句话生成可运行的 Agent 应用
-输入一句话,Agent 为你构建完整的 Agent 应用——脚手架、代码、运行说明,一步到位:
+用一句话描述需求,PenguinHarness 自动构建完整的 Agent 应用——脚手架、代码、运行说明,一步到位:
```text
收集 https://github.com/ericbuess/claude-code-docs 的文档,做一个化身 Claude Code 配置专家、回答带来源引用的 RAG 问答应用。
@@ -69,7 +76,7 @@ https://github.com/user-attachments/assets/604eb626-0a5d-4a62-87e3-14ebade1cd5f
**而生成整个 RAG 应用,仅消耗了 0.2 元($0.02)的 token——使用 DeepSeek V4 Pro 模型。**
-### 3. 🧬 自进化,越用越强
+### 3. 🧬 原生 Agent 自进化引擎
借助 PenguinHarness 技能库,Agent 自己评估、自己优化:跑 Benchmark、找失分点、发布 N+1 版——每轮之前自动快照,每个请求都可在轨迹观测中回放。
@@ -113,7 +120,7 @@ https://github.com/user-attachments/assets/aec49ae9-b743-467b-b247-37bedfeaa36e
## 安装
-两条路线——数据同在 `~/.penguin/data` 目录,桌面端与命令行安装可自由混用:
+优先使用桌面端,也可以在本地电脑或服务器上安装命令行。两种方式共用 `~/.penguin/data` 目录,可自由混用:
- **🖥️ 桌面端应用**——双击安装:内嵌服务端,打开即已登录,全程无需终端。
- **⌨️ 命令行**——一行命令(或 npm / 离线包)装出 `penguin` 命令,`penguin web` 即在浏览器打开完整 Web 体验 `http://127.0.0.1:7364`(多会话对话、Agent / 技能 / 模型管理、用量统计、轨迹观测、评估中心)。在线安装器自带 Node 运行时,解压即用;升级与重装不触碰数据。
@@ -125,7 +132,7 @@ https://github.com/user-attachments/assets/aec49ae9-b743-467b-b247-37bedfeaa36e
完整的 Web 体验打包为独立应用:内嵌服务端,打开即已登录——无需终端、无登录页、也不用抄初始密码——并与 CLI 安装共用同一个 `~/.penguin/data` 数据目录,两者可以混用(一个数据目录同一时刻只运行一个服务端;CLI 已启动实例时,应用会直接接入它)。
-**[⬇️ 前往下载页获取](https://penguin.ooo/download)**——国内自动走 OSS 镜像加速,安装包也附于每个 [GitHub Release](https://github.com/Prism-Shadow/penguin-harness/releases)。
+从[下载页](https://penguin.ooo/download)获取桌面端应用。下载页会自动选择可用的 OSS 加速源,安装包也附于每个 [GitHub Release](https://github.com/Prism-Shadow/penguin-harness/releases)。
| 平台 | 安装包 |
| ------------- | ---------------------------- |
diff --git a/assets/readme/download-en-dark.svg b/assets/readme/download-en-dark.svg
new file mode 100644
index 00000000..09bc4c3d
--- /dev/null
+++ b/assets/readme/download-en-dark.svg
@@ -0,0 +1,6 @@
+<svg width="160" height="44" viewBox="0 0 160 44" fill="none" xmlns="http://www.w3.org/2000/svg">
+ <title>Download App</title>
+ <rect x="0.5" y="0.5" width="159" height="43" rx="8" fill="#F9FAFB" stroke="#9CA3AF"/>
+ <path d="M28 13.5V24.5M28 24.5L23.5 20M28 24.5L32.5 20M22 28.5H34" stroke="#111827" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"/>
+ <text x="43" y="27" fill="#111827" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="14" font-weight="600">Download App</text>
+</svg>
diff --git a/assets/readme/download-en-light.svg b/assets/readme/download-en-light.svg
new file mode 100644
index 00000000..d1b4d294
--- /dev/null
+++ b/assets/readme/download-en-light.svg
@@ -0,0 +1,6 @@
+<svg width="160" height="44" viewBox="0 0 160 44" fill="none" xmlns="http://www.w3.org/2000/svg">
+ <title>Download App</title>
+ <rect x="0.5" y="0.5" width="159" height="43" rx="8" fill="#111827" stroke="#111827"/>
+ <path d="M28 13.5V24.5M28 24.5L23.5 20M28 24.5L32.5 20M22 28.5H34" stroke="white" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"/>
+ <text x="43" y="27" fill="white" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="14" font-weight="600">Download App</text>
+</svg>
diff --git a/assets/readme/download-zh-dark.svg b/assets/readme/download-zh-dark.svg
new file mode 100644
index 00000000..9660f216
--- /dev/null
+++ b/assets/readme/download-zh-dark.svg
@@ -0,0 +1,6 @@
+<svg width="124" height="44" viewBox="0 0 124 44" fill="none" xmlns="http://www.w3.org/2000/svg">
+ <title>下载应用</title>
+ <rect x="0.5" y="0.5" width="123" height="43" rx="8" fill="#F9FAFB" stroke="#9CA3AF"/>
+ <path d="M29 13.5V24.5M29 24.5L24.5 20M29 24.5L33.5 20M23 28.5H35" stroke="#111827" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"/>
+ <text x="44" y="27" fill="#111827" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'Microsoft YaHei', sans-serif" font-size="14" font-weight="600">下载应用</text>
+</svg>
diff --git a/assets/readme/download-zh-light.svg b/assets/readme/download-zh-light.svg
new file mode 100644
index 00000000..684094da
--- /dev/null
+++ b/assets/readme/download-zh-light.svg
@@ -0,0 +1,6 @@
+<svg width="124" height="44" viewBox="0 0 124 44" fill="none" xmlns="http://www.w3.org/2000/svg">
+ <title>下载应用</title>
+ <rect x="0.5" y="0.5" width="123" height="43" rx="8" fill="#111827" stroke="#111827"/>
+ <path d="M29 13.5V24.5M29 24.5L24.5 20M29 24.5L33.5 20M23 28.5H35" stroke="white" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"/>
+ <text x="44" y="27" fill="white" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'Microsoft YaHei', sans-serif" font-size="14" font-weight="600">下载应用</text>
+</svg>
diff --git a/changelog/unreleased/2026-08-27-landing-homepage-refinement.md b/changelog/unreleased/2026-08-27-landing-homepage-refinement.md
new file mode 100644
index 00000000..aa349d64
--- /dev/null
+++ b/changelog/unreleased/2026-08-27-landing-homepage-refinement.md
@@ -0,0 +1,26 @@
+# Refine the landing page hierarchy and downloads
+
+- **Date:** 2026-08-27
+- **Type:** fix
+- **Scope:** `landing`, `docs`
+- **PR:** [#473](https://github.com/Prism-Shadow/penguin-harness/pull/473)
+
+[中文版](2026-08-27-landing-homepage-refinement.zh.md)
+
+Refined the landing page without removing its existing product sections, and made the desktop download choices easier to scan.
+
+## Details
+
+- Restored the full homepage section sequence, moving the one-sentence app demo directly below the hero while retaining the three pillars, LangChain comparison, scenarios, benchmarks, contract, product tour, Skills, security, and community sections.
+- Reworked the hero around the PenguinHarness name and concise open-source, local-first positioning while preserving the announcement banner and restoring the original homepage's compact height and proof-point typography; kept the bilingual copy on one line, placed the release version inside a narrower desktop-download button, restored color-only hover feedback without vertical movement, and added a generously spaced, centered strip of eight model-provider marks without redundant brand text.
+- Restored the six homepage capability cards for the agent hub, Skill library, scheduled tasks, Subagents, Cost center, and multi-user management below the three screenshot tabs.
+- Restored the localized self-improvement demonstration video below the evolution diagram and trend cards, including its poster and full-cycle caption.
+- Removed the redundant divider above the footer copyright while retaining the footer's single top boundary.
+- Aligned the bilingual repository READMEs with the landing page's local-first, automated agent-app lifecycle narrative and added one localized, color-scheme-aware app-download button above the streamlined platform proof points.
+- Corrected the LangChain comparison animation so both builders reset on one shared cycle and the manual-build tower visibly stacks one block at a time from the bottom.
+- Reduced the landing and docs navigation by removing the Cases shortcut and folding the self-evolution section into Highlights, while keeping the full sections in the homepage story.
+- Added the live GitHub star count to the landing and docs navigation, using a neutral dash instead of a decorative star while the count loads.
+- Reduced the download-source report to a compact two-row manual selector with phone-signal indicators, kept both sources selectable before measurement completes, reused ZCode's colored macOS, Windows, and Linux marks, placed a release-version pill at the top right of every platform card, and kept installer suffixes on the download actions.
+- Split quick start into installation and launch steps, exposing Web UI and CLI choices only after command-line installation, and added direct release-asset links for every Linux, macOS, and Windows offline bundle.
+- Labeled the command installer as Online install above the matching Offline packages section, and rewrote both production scenarios around teams using PenguinHarness to build agents automatically before deploying them to live environments.
+- Removed the desktop download page's introductory paragraph and normalized English `agent` copy to lowercase while keeping navigation and primary hero actions on one line.
diff --git a/changelog/unreleased/2026-08-27-landing-homepage-refinement.zh.md b/changelog/unreleased/2026-08-27-landing-homepage-refinement.zh.md
new file mode 100644
index 00000000..eac38440
--- /dev/null
+++ b/changelog/unreleased/2026-08-27-landing-homepage-refinement.zh.md
@@ -0,0 +1,26 @@
+# 优化官网主页层级与下载体验
+
+- **Date:** 2026-08-27
+- **Type:** fix
+- **Scope:** `landing`, `docs`
+- **PR:** [#473](https://github.com/Prism-Shadow/penguin-harness/pull/473)
+
+[English](2026-08-27-landing-homepage-refinement.md)
+
+在不删除原有产品章节的前提下重新整理官网主页,并让桌面端下载选项更易浏览。
+
+## 细节
+
+- 恢复首页完整章节编排,将一句话生成应用的案例视频移到首屏之后,同时保留三大特色、LangChain 对比、应用场景、评测、契约、产品功能、Skills、安全与社区章节。
+- 围绕 PenguinHarness 名称与精简的开源、本地优先定位重新整理首屏,保留顶部公告横幅,并恢复线上旧版的紧凑高度与特点字号;保持中英文主文案单行展示,将版本号放入更窄的桌面端下载按钮,恢复仅变色且无垂直位移的悬停反馈,并以间距更舒展、整体居中的八个纯品牌标志展示模型支持范围。
+- 在三个产品截图标签下恢复智能体仓库、技能库、定时任务、子 Agent、成本中心与多用户管理六张首页能力卡片。
+- 在进化流程图与趋势卡片下恢复中英文自我进化演示视频,包括对应海报与完整一轮的说明文字。
+- 移除 Footer 版权信息上方的重复分割线,仅保留 Footer 顶部的一条边界线。
+- 将中英文仓库 README 同步为官网的本地优先、Agent 应用全生命周期自动化叙事,并在精简的平台特点上方加入一个本地化且适配亮暗色的应用下载按钮。
+- 修正 LangChain 对比动画,让左右两种构建方式按同一周期重置,并让人工构建侧从底部开始逐块垒起。
+- 精简官网与文档导航,移除“案例”快捷入口并将自进化章节归入“特色”,同时保留首页中的完整章节内容。
+- 在官网与文档导航中加入实时 GitHub 星标数量,并在数量加载期间使用中性的短横线代替星形图案。
+- 将下载源测速报告压缩为带手机信号格的两行手动选择器,让两个下载源在完成测速前即可手动选择,复用 ZCode 的彩色 macOS、Windows 与 Linux 标志,在每个平台卡片右上角显示版本号胶囊,并保留下载操作中的安装包后缀。
+- 将快速开始拆分为安装与启动两步,仅在命令行安装后展示 Web UI 与 CLI 启动选项,并为 Linux、macOS 与 Windows 的全部离线包补充 Release 制品直链。
+- 在离线安装包对应位置上方为命令安装明确标注“在线安装”,并重写两个生产应用场景,突出团队使用 PenguinHarness 自动开发 Agent 后再部署到生产环境的过程。
+- 删除桌面端下载页的介绍段落,将英文 `agent` 文案统一为小写,并让导航与首屏主要操作保持单行显示。
diff --git a/changelog/unreleased/2026-08-27-landing-page-focus.md b/changelog/unreleased/2026-08-27-landing-page-focus.md
new file mode 100644
index 00000000..ea0b226a
--- /dev/null
+++ b/changelog/unreleased/2026-08-27-landing-page-focus.md
@@ -0,0 +1,16 @@
+# Focus the landing and download pages
+
+- **Date:** 2026-08-27
+- **Type:** feature
+- **Scope:** `landing`
+- **PR:** [#473](https://github.com/Prism-Shadow/penguin-harness/pull/473)
+
+[中文版](2026-08-27-landing-page-focus.zh.md)
+
+The landing page was reorganized around the local-first Agent application platform, with clearer desktop and command-line entry points and a shorter product story.
+
+## Details
+
+- Reduced the homepage to product proof, self-evolution, examples, and a desktop-first quick start.
+- Added distinct desktop, command-line install, Web UI, and CLI paths.
+- Added platform marks and a block-based GitHub and OSS speed report to the download page.
diff --git a/changelog/unreleased/2026-08-27-landing-page-focus.zh.md b/changelog/unreleased/2026-08-27-landing-page-focus.zh.md
new file mode 100644
index 00000000..5755c902
--- /dev/null
+++ b/changelog/unreleased/2026-08-27-landing-page-focus.zh.md
@@ -0,0 +1,16 @@
+# 聚焦官网首页与下载页
+
+- **Date:** 2026-08-27
+- **Type:** feature
+- **Scope:** `landing`
+- **PR:** [#473](https://github.com/Prism-Shadow/penguin-harness/pull/473)
+
+[English](2026-08-27-landing-page-focus.md)
+
+官网首页围绕本地优先的 Agent 应用自动开发平台重新组织,以更清晰的桌面端和命令行入口串联更精简的产品叙事。
+
+## 细节
+
+- 首页内容收敛为产品实景、自进化、案例与桌面端优先的快速开始。
+- 分别提供桌面端、命令行安装、Web UI 与 CLI 启动路径。
+- 下载页增加系统标识,以及以方块呈现的 GitHub 与 OSS 测速结果。
diff --git a/packages/docs/src/components/nav.tsx b/packages/docs/src/components/nav.tsx
index c17fd3a7..2c53982a 100644
--- a/packages/docs/src/components/nav.tsx
+++ b/packages/docs/src/components/nav.tsx
@@ -11,11 +11,11 @@
* (packages/landing/src/components/nav.tsx — the two sites share no package, as with
* site-prefs.ts); keep the two files aligned so the navbars render identically.
*/
-import { useRef } from "react";
+import { useEffect, useRef, useState } from "react";
import type { MouseEvent, RefObject } from "react";
import { Link } from "react-router";
import { S } from "../lib/strings";
-import { REPO_URL, SITE_URL } from "../lib/links";
+import { REPO_API_URL, REPO_URL, SITE_URL } from "../lib/links";
import { GitHubIcon, MenuIcon, XIcon } from "./icons";
import { ThemeToggle } from "./theme-toggle";
import { LangToggle } from "./lang-toggle";
@@ -23,13 +23,46 @@ import { LangToggle } from "./lang-toggle";
const SECTION_IDS = [
"highlights",
"quickstart",
- "cases",
"scenarios",
"benchmark",
"contract",
"features",
] as const;
+function GitHubStarsLink() {
+ const [stars, setStars] = useState<number | null>(null);
+
+ useEffect(() => {
+ const controller = new AbortController();
+ void fetch(REPO_API_URL, {
+ signal: controller.signal,
+ headers: { Accept: "application/vnd.github+json" },
+ })
+ .then((response) => (response.ok ? response.json() : null))
+ .then((data: { stargazers_count?: unknown } | null) => {
+ if (typeof data?.stargazers_count === "number") setStars(data.stargazers_count);
+ })
+ .catch(() => undefined);
+ return () => controller.abort();
+ }, []);
+
+ const count = stars?.toLocaleString("en-US");
+ const label = count ? `${S.nav.github} · ${count} stars` : S.nav.github;
+ return (
+ <a
+ href={REPO_URL}
+ target="_blank"
+ rel="noreferrer"
+ title={label}
+ aria-label={label}
+ className="inline-flex h-9 min-w-9 items-center justify-center gap-1.5 rounded-lg border border-gray-200 bg-white px-2.5 text-xs font-medium text-gray-700 transition-colors hover:bg-gray-50 hover:text-gray-950 dark:border-gray-800 dark:bg-gray-900 dark:text-gray-300 dark:hover:bg-gray-800 dark:hover:text-white"
+ >
+ <GitHubIcon className="h-[18px] w-[18px]" />
+ <span className="min-w-8 tabular-nums">{count ?? "-"}</span>
+ </a>
+ );
+}
+
export function Nav({
menuOpen,
onToggleMenu,
@@ -45,7 +78,6 @@ export function Nav({
const sectionLabel: Record<(typeof SECTION_IDS)[number], string> = {
highlights: S.nav.highlights,
quickstart: S.nav.quickstart,
- cases: S.nav.cases,
scenarios: S.nav.scenarios,
benchmark: S.nav.benchmark,
contract: S.nav.contract,
@@ -58,7 +90,7 @@ export function Nav({
const deskInactiveLinkCls = `${inactiveLinkCls} hover:text-gray-900 dark:hover:text-gray-100`;
// Same class recipe as the landing nav's desktop links; here only "Docs" is ever active.
const deskLinkCls = (active: boolean) =>
- `relative z-10 rounded-md px-2.5 py-1.5 text-sm transition-colors ${active ? activeLinkCls : deskInactiveLinkCls}`;
+ `relative z-10 shrink-0 whitespace-nowrap rounded-md px-2 py-1.5 text-[13px] transition-colors ${active ? activeLinkCls : deskInactiveLinkCls}`;
/**
* The hover pill appears IN PLACE under the first link it lands on (position
@@ -117,9 +149,11 @@ export function Nav({
return (
<header className="sticky top-0 z-40 border-b border-gray-200 bg-white/85 backdrop-blur dark:border-gray-800 dark:bg-gray-950/85">
<div className="mx-auto flex h-14 max-w-7xl items-center gap-2 px-4 sm:px-6">
- <a href={SITE_URL} className="flex items-center gap-2">
+ <a href={SITE_URL} className="flex shrink-0 items-center gap-2">
<img src={`${import.meta.env.BASE_URL}penguin-logo.svg`} alt="" className="h-7 w-7" />
- <span className="text-[15px] font-semibold tracking-tight">{S.siteName}</span>
+ <span className="hidden text-[15px] font-semibold tracking-tight sm:inline">
+ {S.siteName}
+ </span>
</a>
<nav
@@ -140,16 +174,7 @@ export function Nav({
<div className="ml-auto flex items-center gap-1">
<LangToggle />
<ThemeToggle />
- <a
- href={REPO_URL}
- target="_blank"
- rel="noreferrer"
- title={S.nav.github}
- aria-label={S.nav.github}
- className="inline-flex h-9 w-9 items-center justify-center rounded-lg border border-transparent text-gray-600 transition-colors hover:border-gray-200 hover:bg-gray-50 hover:text-gray-900 dark:text-gray-400 dark:hover:border-gray-800 dark:hover:bg-gray-900 dark:hover:text-gray-100"
- >
- <GitHubIcon className="h-[18px] w-[18px]" />
- </a>
+ <GitHubStarsLink />
{/* Sidebar toggle: same slot and styling as the landing nav's menu button, but it
opens the docs sidebar and hides at lg (the sidebar's own breakpoint). */}
<button
diff --git a/packages/docs/src/lib/links.ts b/packages/docs/src/lib/links.ts
index 5d10fae3..2f73fd03 100644
--- a/packages/docs/src/lib/links.ts
+++ b/packages/docs/src/lib/links.ts
@@ -1,6 +1,7 @@
/** External links and language-independent constants used across the docs site. */
export const REPO_URL = "https://github.com/Prism-Shadow/penguin-harness";
+export const REPO_API_URL = "https://api.github.com/repos/Prism-Shadow/penguin-harness";
export const LICENSE_URL = `${REPO_URL}/blob/main/LICENSE`;
/**
diff --git a/packages/docs/src/lib/strings-en.ts b/packages/docs/src/lib/strings-en.ts
index aaf156ab..2d85c557 100644
--- a/packages/docs/src/lib/strings-en.ts
+++ b/packages/docs/src/lib/strings-en.ts
@@ -6,6 +6,7 @@ export const en: Strings = {
nav: {
highlights: "Highlights",
+ selfImprove: "Self-evolution",
quickstart: "Quick start",
cases: "Cases",
scenarios: "Scenarios",
diff --git a/packages/docs/src/lib/strings.ts b/packages/docs/src/lib/strings.ts
index 3cb55ccc..8bb4974c 100644
--- a/packages/docs/src/lib/strings.ts
+++ b/packages/docs/src/lib/strings.ts
@@ -12,6 +12,7 @@ export const zh = {
// Landing-parity labels: the top bar mirrors the landing page's nav exactly
// (same items, same order) so the two sites link into each other seamlessly.
highlights: "特色",
+ selfImprove: "自进化",
quickstart: "快速开始",
cases: "案例",
scenarios: "应用场景",
diff --git a/packages/landing/src/components/footer.tsx b/packages/landing/src/components/footer.tsx
index 292a0074..b1a547c2 100644
--- a/packages/landing/src/components/footer.tsx
+++ b/packages/landing/src/components/footer.tsx
@@ -29,9 +29,10 @@ export function Footer() {
<div>
<p className="mb-3 font-medium">{S.footer.product}</p>
<ul className="space-y-2 text-gray-500 dark:text-gray-400">
- <li>{anchor("quickstart", S.footer.quickstart)}</li>
<li>{anchor("features", S.footer.features)}</li>
- <li>{anchor("benchmark", S.footer.benchmark)}</li>
+ <li>{anchor("self-improvement", S.footer.selfImprove)}</li>
+ <li>{anchor("cases", S.footer.cases)}</li>
+ <li>{anchor("quickstart", S.footer.quickstart)}</li>
<li>
<Link to="/blog" className="hover:text-gray-900 dark:hover:text-gray-100">
{S.footer.blog}
@@ -86,9 +87,7 @@ export function Footer() {
</div>
</div>
</div>
- <p className="mt-10 border-t border-gray-200 pt-6 text-xs text-gray-400 dark:border-gray-800 dark:text-gray-500">
- {S.footer.copyright}
- </p>
+ <p className="mt-10 pt-6 text-xs text-gray-400 dark:text-gray-500">{S.footer.copyright}</p>
</div>
</footer>
);
diff --git a/packages/landing/src/components/icons.tsx b/packages/landing/src/components/icons.tsx
index 1ec9979c..54fe0b28 100644
--- a/packages/landing/src/components/icons.tsx
+++ b/packages/landing/src/components/icons.tsx
@@ -31,6 +31,142 @@ export function GitHubIcon(props: IconProps) {
);
}
+export type ModelProvider =
+ "openai" | "anthropic" | "gemini" | "deepseek" | "zai" | "moonshot" | "qwen" | "openrouter";
+
+/** Compact model-provider marks reused from the Web App's provider glyph set. */
+export function ModelProviderLogo({
+ provider,
+ className,
+}: {
+ provider: ModelProvider;
+ className?: string;
+}) {
+ if (provider === "gemini") {
+ return (
+ <svg viewBox="0 0 24 24" className={className} aria-hidden="true">
+ <defs>
+ <linearGradient id="landing-gemini-mark" x1="2" y1="22" x2="22" y2="2">
+ <stop stopColor="#1C69FF" />
+ <stop offset="0.48" stopColor="#9B72FF" />
+ <stop offset="1" stopColor="#D96570" />
+ </linearGradient>
+ </defs>
+ <path
+ fill="url(#landing-gemini-mark)"
+ d="M12 24A14.304 14.304 0 0 0 0 12 14.304 14.304 0 0 0 12 0a14.305 14.305 0 0 0 12 12 14.305 14.305 0 0 0-12 12"
+ />
+ </svg>
+ );
+ }
+
+ const color = {
+ openai: "text-gray-900 dark:text-gray-100",
+ anthropic: "text-[#D97757]",
+ deepseek: "text-[#4D6BFE]",
+ zai: "text-[#5B57D9]",
+ moonshot: "text-gray-900 dark:text-gray-100",
+ qwen: "text-[#615CED]",
+ openrouter: "text-gray-900 dark:text-gray-100",
+ }[provider];
+
+ return (
+ <svg
+ viewBox={provider === "qwen" ? "-0.76 -0.47 28.6 28.6" : "0 0 24 24"}
+ fill="currentColor"
+ className={`${color} ${className ?? ""}`}
+ aria-hidden="true"
+ >
+ {provider === "openai" && (
+ <path d="M22.2819 9.8211a5.9847 5.9847 0 0 0-.5157-4.9108 6.0462 6.0462 0 0 0-6.5098-2.9A6.0651 6.0651 0 0 0 4.9807 4.1818a5.9847 5.9847 0 0 0-3.9977 2.9 6.0462 6.0462 0 0 0 .7427 7.0966 5.98 5.98 0 0 0 .511 4.9107 6.051 6.051 0 0 0 6.5146 2.9001A5.9847 5.9847 0 0 0 13.2599 24a6.0557 6.0557 0 0 0 5.7718-4.2058 5.9894 5.9894 0 0 0 3.9977-2.9001 6.0557 6.0557 0 0 0-.7475-7.0729zm-9.022 12.6081a4.4755 4.4755 0 0 1-2.8764-1.0408l.1419-.0804 4.7783-2.7582a.7948.7948 0 0 0 .3927-.6813v-6.7369l2.02 1.1686a.071.071 0 0 1 .038.052v5.5826a4.504 4.504 0 0 1-4.4945 4.4944zm-9.6607-4.1254a4.4708 4.4708 0 0 1-.5346-3.0137l.142.0852 4.783 2.7582a.7712.7712 0 0 0 .7806 0l5.8428-3.3685v2.3324a.0804.0804 0 0 1-.0332.0615L9.74 19.9502a4.4992 4.4992 0 0 1-6.1408-1.6464zM2.3408 7.8956a4.485 4.485 0 0 1 2.3655-1.9728V11.6a.7664.7664 0 0 0 .3879.6765l5.8144 3.3543-2.0201 1.1685a.0757.0757 0 0 1-.071 0l-4.8303-2.7865A4.504 4.504 0 0 1 2.3408 7.872zm16.5963 3.8558L13.1038 8.364 15.1192 7.2a.0757.0757 0 0 1 .071 0l4.8303 2.7913a4.4944 4.4944 0 0 1-.6765 8.1042v-5.6772a.79.79 0 0 0-.407-.667zm2.0107-3.0231l-.142-.0852-4.7735-2.7818a.7759.7759 0 0 0-.7854 0L9.409 9.2297V6.8974a.0662.0662 0 0 1 .0284-.0615l4.8303-2.7866a4.4992 4.4992 0 0 1 6.6802 4.66zM8.3065 12.863l-2.02-1.1638a.0804.0804 0 0 1-.038-.0567V6.0742a4.4992 4.4992 0 0 1 7.3757-3.4537l-.142.0805L8.704 5.459a.7948.7948 0 0 0-.3927.6813zm1.0976-2.3654l2.602-1.4998 2.6069 1.4998v2.9994l-2.5974 1.4997-2.6067-1.4997Z" />
+ )}
+ {provider === "anthropic" && (
+ <path d="M17.3041 3.541h-3.6718l6.696 16.918H24Zm-10.6082 0L0 20.459h3.7442l1.3693-3.5527h7.0052l1.3693 3.5528h3.7442L10.5363 3.5409Zm-.3712 10.2232 2.2914-5.9456 2.2914 5.9456Z" />
+ )}
+ {provider === "deepseek" && (
+ <path d="M23.748 4.482c-.254-.124-.364.113-.512.234-.051.039-.094.09-.137.136-.372.397-.806.657-1.373.626-.829-.046-1.537.214-2.163.848-.133-.782-.575-1.248-1.247-1.548-.352-.156-.708-.311-.955-.65-.172-.241-.219-.51-.305-.774-.055-.16-.11-.323-.293-.35-.2-.031-.278.136-.356.276-.313.572-.434 1.202-.422 1.84.027 1.436.633 2.58 1.838 3.393.137.093.172.187.129.323-.082.28-.18.552-.266.833-.055.179-.137.217-.328.14a5.526 5.526 0 0 1-1.736-1.18c-.857-.828-1.631-1.742-2.597-2.458a11.365 11.365 0 0 0-.689-.471c-.985-.957.13-1.743.388-1.836.27-.098.093-.432-.779-.428-.872.004-1.67.295-2.687.684a3.055 3.055 0 0 1-.465.137 9.597 9.597 0 0 0-2.883-.102c-1.885.21-3.39 1.102-4.497 2.623C.082 8.606-.231 10.684.152 12.85c.403 2.284 1.569 4.175 3.36 5.653 1.858 1.533 3.997 2.284 6.438 2.14 1.482-.085 3.133-.284 4.994-1.86.47.234.962.327 1.78.397.63.059 1.236-.03 1.705-.128.735-.156.684-.837.419-.961-2.155-1.004-1.682-.595-2.113-.926 1.096-1.296 2.746-2.642 3.392-7.003.05-.347.007-.565 0-.845-.004-.17.034-.237.23-.256a4.173 4.173 0 0 0 1.545-.475c1.396-.763 1.96-2.015 2.093-3.517.02-.23-.004-.467-.247-.588zM11.581 18c-2.089-1.642-3.102-2.183-3.52-2.16-.392.024-.321.471-.235.763.09.288.207.486.371.739.114.167.192.416-.113.603-.673.416-1.842-.14-1.897-.167-1.361-.802-2.5-1.86-3.301-3.307-.774-1.393-1.224-2.887-1.298-4.482-.02-.386.093-.522.477-.592a4.696 4.696 0 0 1 1.529-.039c2.132.312 3.946 1.265 5.468 2.774.868.86 1.525 1.887 2.202 2.891.72 1.066 1.494 2.082 2.48 2.914.348.292.625.514.891.677-.802.09-2.14.11-3.054-.615zm1-6.44a.306.306 0 0 1 .415-.287.302.302 0 0 1 .2.288.306.306 0 0 1-.31.307.303.303 0 0 1-.304-.308zm3.11 1.596c-.2.081-.399.151-.59.16a1.245 1.245 0 0 1-.798-.254c-.274-.23-.47-.358-.552-.758a1.73 1.73 0 0 1 .016-.588c.07-.327-.008-.537-.239-.727-.187-.156-.426-.199-.688-.199a.559.559 0 0 1-.254-.078c-.11-.054-.2-.19-.114-.358.028-.054.16-.186.191-.21.356-.202.767-.136 1.146.016.352.144.618.408 1.001.782.391.451.462.576.685.914.176.265.336.537.445.848.067.196-.02.354-.25.452z" />
+ )}
+ {provider === "zai" && (
+ <path d="M4.6 3.2h14.8a.9.9 0 0 1 .73 1.43L9.9 18.6h9.2a.9.9 0 0 1 0 1.8H4.6a.9.9 0 0 1-.73-1.43L14.1 5.4H4.6a1.1 1.1 0 0 1 0-2.2Z" />
+ )}
+ {provider === "moonshot" && (
+ <path d="m1.053 16.91 9.538 2.55a21 20.981 0 0 0 .06 2.031l5.956 1.592a12 11.99 0 0 1-15.554-6.172m-1.02-5.79 11.352 3.035a21 20.981 0 0 0-.469 2.01l10.817 2.89a12 11.99 0 0 1-1.845 2.004L.658 15.918a12 11.99 0 0 1-.625-4.796m1.593-5.146L13.573 9.17a21 20.981 0 0 0-1.01 1.874l11.297 3.02a21 20.981 0 0 1-.67 2.362l-11.55-3.087L.125 10.26a12 11.99 0 0 1 1.499-4.285ZM6.067 1.58l11.285 3.016a21 20.981 0 0 0-1.688 1.719l7.824 2.091a21 20.981 0 0 1 .513 2.664L2.107 5.218a12 11.99 0 0 1 3.96-3.638M21.68 4.866 7.222 1.003A12 11.99 0 0 1 21.68 4.866" />
+ )}
+ {provider === "qwen" && (
+ <>
+ <path d="M26.59,15.92L22.82,13.75C22.92,13.59,22.97,13.4,22.97,13.21L22.97,12.05C22.97,11.66,22.76,11.31,22.43,11.12L21.42,10.54C21.09,10.34,20.68,10.34,20.35,10.54L17.26,12.32C16.93,12.51,16.73,12.86,16.73,13.25L16.73,14.41C16.73,14.79,16.93,15.15,17.26,15.34L24.51,19.53C24.84,19.72,25.25,19.72,25.58,19.53L26.59,18.94C26.92,18.75,27.13,18.4,27.13,18.01L27.13,16.85C27.13,16.47,26.92,16.11,26.59,15.92Z" />
+ <path d="M21.88,3.58L18.11,5.75C18.02,5.59,17.89,5.46,17.72,5.36L16.71,4.78C16.38,4.59,15.97,4.59,15.64,4.78L14.63,5.36C14.3,5.55,14.09,5.9,14.09,6.29L14.09,9.86C14.09,10.24,14.3,10.59,14.63,10.78L15.64,11.37C15.97,11.56,16.38,11.56,16.71,11.37L23.96,7.18C24.29,6.99,24.5,6.64,24.5,6.25L24.5,5.09C24.5,4.71,24.29,4.35,23.96,4.16L22.95,3.58C22.62,3.39,22.21,3.39,21.88,3.58Z" />
+ <path d="M8.83,1.48L8.83,5.83C8.65,5.83,8.46,5.88,8.3,5.98L7.29,6.56C6.95,6.75,6.75,7.11,6.75,7.49L6.75,8.65C6.75,9.04,6.95,9.39,7.29,9.58L10.37,11.37C10.71,11.56,11.11,11.56,11.45,11.37L12.45,10.78C12.79,10.59,12.99,10.24,12.99,9.85L12.99,1.48C12.99,1.1,12.79,0.75,12.45,0.56L11.45,-0.03C11.11,-0.22,10.71,-0.22,10.37,-0.03L9.37,0.56C9.03,0.75,8.83,1.1,8.83,1.48Z" />
+ <path d="M0.5,11.74L4.26,13.91C4.17,14.07,4.12,14.26,4.12,14.45L4.12,15.61C4.12,16,4.32,16.35,4.65,16.54L5.66,17.13C6,17.32,6.4,17.32,6.73,17.13L9.82,15.34C10.15,15.15,10.36,14.8,10.36,14.41L10.36,13.25C10.36,12.87,10.15,12.51,9.82,12.32L2.57,8.14C2.24,7.94,1.84,7.94,1.5,8.14L0.5,8.72C0.16,8.91,-0.04,9.26,-0.04,9.65L-0.04,10.81C-0.04,11.19,0.16,11.55,0.5,11.74Z" />
+ <path d="M5.21,24.08L8.97,21.91C9.07,22.07,9.2,22.21,9.37,22.3L10.38,22.88C10.71,23.08,11.11,23.08,11.45,22.88L12.46,22.3C12.79,22.11,12.99,21.76,12.99,21.37L12.99,17.81C12.99,17.42,12.79,17.07,12.46,16.88L11.45,16.29C11.11,16.1,10.71,16.1,10.38,16.29L3.13,20.48C2.8,20.67,2.59,21.02,2.59,21.41L2.59,22.57C2.59,22.95,2.8,23.31,3.13,23.5L4.14,24.08C4.47,24.28,4.88,24.28,5.21,24.08Z" />
+ <path d="M18.26,26.18L18.26,21.83C18.44,21.83,18.63,21.78,18.79,21.68L19.8,21.1C20.13,20.91,20.34,20.56,20.34,20.17L20.34,19.01C20.34,18.62,20.13,18.27,19.8,18.08L16.71,16.3C16.38,16.1,15.97,16.1,15.64,16.3L14.63,16.88C14.3,17.07,14.1,17.42,14.1,17.81L14.1,26.18C14.1,26.56,14.3,26.91,14.63,27.11L15.64,27.69C15.97,27.88,16.38,27.88,16.71,27.69L17.72,27.11C18.05,26.91,18.26,26.56,18.26,26.18Z" />
+ </>
+ )}
+ {provider === "openrouter" && (
+ <path d="M16.778 1.844v1.919q-.569-.026-1.138-.032-.708-.008-1.415.037c-1.93.126-4.023.728-6.149 2.237-2.911 2.066-2.731 1.95-4.14 2.75-.396.223-1.342.574-2.185.798-.841.225-1.753.333-1.751.333v4.229s.768.108 1.61.333c.842.224 1.789.575 2.185.799 1.41.798 1.228.683 4.14 2.75 2.126 1.509 4.22 2.11 6.148 2.236.88.058 1.716.041 2.555.005v1.918l7.222-4.168-7.222-4.17v2.176c-.86.038-1.611.065-2.278.021-1.364-.09-2.417-.357-3.979-1.465-2.244-1.593-2.866-2.027-3.68-2.508.889-.518 1.449-.906 3.822-2.59 1.56-1.109 2.614-1.377 3.978-1.466.667-.044 1.418-.017 2.278.02v2.176L24 6.014Z" />
+ )}
+ </svg>
+ );
+}
+
+/** Platform marks copied from the ZCode download page so both sites use the same glyphs. */
+export function MacOSIcon(props: IconProps) {
+ return (
+ <svg viewBox="0 0 32 32" fill="none" aria-hidden="true" {...props}>
+ <path
+ fill="currentColor"
+ d="M25.547 11.131a5.89 5.89 0 0 0-2.814 4.955 5.73 5.73 0 0 0 3.488 5.257 13.7 13.7 0 0 1-1.786 3.69c-1.112 1.601-2.275 3.202-4.044 3.202-1.77 0-2.225-1.028-4.264-1.028-1.988 0-2.696 1.062-4.314 1.062s-2.746-1.483-4.044-3.303a15.96 15.96 0 0 1-2.713-8.61c0-5.056 3.286-7.735 6.521-7.735 1.72 0 3.152 1.128 4.23 1.128 1.028 0 2.629-1.196 4.584-1.196a6.13 6.13 0 0 1 5.156 2.578m-6.083-4.718a5.8 5.8 0 0 0 1.382-3.622 2.5 2.5 0 0 0-.05-.522A5.82 5.82 0 0 0 16.97 4.24a5.65 5.65 0 0 0-1.432 3.522q0 .239.05.472.176.033.354.034a5.05 5.05 0 0 0 3.522-1.855"
+ />
+ </svg>
+ );
+}
+
+export function WindowsIcon(props: IconProps) {
+ return (
+ <svg viewBox="0 0 32 32" fill="none" aria-hidden="true" {...props}>
+ <path fill="#DD5B34" d="M5 5h10v10H5z" />
+ <path fill="#F1B941" d="M17 17h10v10H17z" />
+ <path fill="#49A1E8" d="M5 17h10v10H5z" />
+ <path fill="#8BB738" d="M17 5h10v10H17z" />
+ </svg>
+ );
+}
+
+export function LinuxIcon(props: IconProps) {
+ return (
+ <svg viewBox="0 0 32 32" fill="none" aria-hidden="true" {...props}>
+ <path
+ fill="#ECEFF1"
+ d="m12.267 9.498.082 1.9-1.322 2.48-2.066 4.048-.413 3.387 1.488 4.793 3.387 1.9h5.123l4.792-3.636 2.148-5.7-4.957-6.032-1.405-3.388z"
+ />
+ <path
+ fill="#263238"
+ d="M24 14.208c-1.323-1.9-2.397-3.058-2.975-5.454s.165-1.735-.33-3.8a6.5 6.5 0 0 0-1.075-2.397c-.496-.578-1.074-.908-1.404-.991-.744-.413-2.48-1.074-4.627.083-2.231 1.156-1.983 3.635-1.57 8.675 0 .33-.083.744-.248 1.074-.33.744-.91 1.405-1.405 1.983-.578.827-1.157 1.653-1.57 2.562-.991 1.9-1.9 4.296-1.652 5.205.413-.082 5.618 7.85 5.618 8.015.33-.083 1.735-.083 2.975-.083 1.735-.082 2.726-.165 4.131.165 0-.248-.083-.495-.083-.743 0-.496.083-.91.166-1.487.082-.414.165-.827.248-1.323-.827.744-2.314 1.57-3.719 1.818-1.239.248-3.305-.165-4.296-1.404.083 0 .248 0 .33-.083.248-.083.496-.165.579-.33.248-.414.082-.827-.083-1.075-.165-.247-1.404-1.156-1.983-1.652-.578-.496-.909-.744-1.24-1.074l-.66-.661c-.165-.166-.248-.33-.33-.413-.166-.414-.249-.91-.166-1.57.083-.91.413-1.653.826-2.479.166-.33.579-.991.579-.991s-1.405 3.47-.661 4.544c0 0 .082-1.074.413-2.148.248-.744.66-1.818 1.157-2.396.495-.579 1.735-2.727 1.817-4.05 0-.578.083-1.156.083-1.569-.33-.33 5.453-1.157 5.784-.248.082.33 1.24 3.305 1.9 4.875.33.744.744 1.405.992 2.23.247.91.413 2.15.413 3.389 0 .247 0 .66-.083 1.074.165 0 3.388-3.47-.413-6.362 0 0 2.313 1.074 2.396 3.222.083 1.735-.66 3.14-.826 3.388.082 0 1.735.743 1.818.743.33 0 .991-.248.991-.248.083-.248.33-.909.33-1.157.579-1.9-.826-4.957-2.148-6.857"
+ />
+ <path
+ fill="#ECEFF1"
+ d="M13.506 8.754c.593 0 1.074-.74 1.074-1.652 0-.913-.481-1.653-1.074-1.653s-1.074.74-1.074 1.653c0 .912.48 1.652 1.074 1.652M17.224 8.92c.776 0 1.405-.851 1.405-1.9 0-1.05-.63-1.901-1.405-1.901-.776 0-1.405.85-1.405 1.9s.63 1.9 1.405 1.9"
+ />
+ <path
+ fill="#212121"
+ d="M14.106 7.215c-.069-.543-.381-.951-.698-.911s-.518.513-.45 1.056c.069.543.381.951.698.911s.518-.513.45-1.056M17.142 8.424c.456 0 .826-.481.826-1.074s-.37-1.074-.826-1.074c-.457 0-.827.48-.827 1.074 0 .593.37 1.074.827 1.074"
+ />
+ <path
+ fill="#FFC107"
+ d="M28.13 25.527c-.33-.165-.908-.413-1.404-1.157-.248-.413-.165-1.57-.578-2.065-.248-.33-.579-.165-.662-.165-.743.165-2.478 1.322-3.635 0-.165-.166-.413-.414-.826-.414s-.579.166-.744.496-.165.579-.165 1.405c0 .66 0 1.404-.083 1.983-.165 1.404-.413 2.23-.413 3.057 0 .909.248 1.487.578 1.735.248.248.662.413 1.57.413.91 0 1.488-.33 2.066-.909.413-.413.744-.578 1.9-1.404.91-.579 2.314-1.322 2.562-1.57.165-.165.413-.248.413-.744 0-.413-.33-.578-.578-.66M11.523 25.775c-.826-1.322-.909-1.57-1.487-2.396-.496-.826-1.57-2.396-2.231-2.396-.496 0-.744.248-1.074.578s-.661 1.074-1.24 1.487c-.495.414-1.9.33-2.23.827-.33.495.33 1.239.33 2.478 0 .496-.413.827-.496 1.157-.082.413-.165.661 0 .992.33.495.744.66 3.553 1.239 1.488.33 2.892 1.157 3.801 1.24s2.479 0 2.479-2.232c.082-1.322-.661-1.652-1.405-2.974M13.093 10.82c-.496-.33-.909-.661-.909-1.157s.33-.66.826-1.074c.083-.083.992-.909 1.9-.909.91 0 1.984.579 2.397.744.744.165 1.487.33 1.405.909-.083.826-.166.991-.992 1.404-.578.166-1.652 1.074-2.396 1.074-.33 0-.826 0-1.157-.082-.248-.083-.66-.496-1.074-.91"
+ />
+ <path
+ fill="#634703"
+ d="M12.928 10.159c.165.165.413.33.66.413.166.083.414.165.414.165h.743c.414 0 .992-.165 1.57-.495.579-.248.661-.414 1.074-.579.413-.248.827-.496.661-.578-.165-.083-.33 0-.909.33-.495.33-.908.496-1.404.744-.248.083-.578.248-.826.248h-.744c-.248 0-.413-.083-.661-.165-.165-.083-.248-.166-.33-.166-.166-.082-.496-.413-.662-.495 0 0-.165 0-.082.082zM15.406 8.341c.083.165.248.165.33.248s.166.083.166.083c.083-.083 0-.248-.083-.248 0-.165-.413-.165-.413-.083M14.084 8.506c0 .083.165.166.165.083.083-.083.165-.165.248-.165.165-.083.083-.165-.165-.165-.165.082-.165.165-.248.247"
+ />
+ <path
+ fill="#455A64"
+ d="M22.1 23.131v.248c.164.33.577.413.908.413.496 0 .991-.33 1.24-.661 0-.083.082-.165.165-.248.165-.248.247-.413.33-.496 0 0-.083-.082-.083-.165-.082-.165-.33-.33-.66-.413-.248-.083-.662-.165-.827-.165-.743-.083-1.157.165-1.404.413 0 0 .082 0 .082.083a.75.75 0 0 1 .248.578c.083.165 0 .248 0 .413"
+ />
+ </svg>
+ );
+}
+
export function SunIcon(props: IconProps) {
return (
<Icon {...props}>
diff --git a/packages/landing/src/components/nav.tsx b/packages/landing/src/components/nav.tsx
index 9227f6be..bf6587d7 100644
--- a/packages/landing/src/components/nav.tsx
+++ b/packages/landing/src/components/nav.tsx
@@ -10,13 +10,18 @@
* (packages/docs/src/components/nav.tsx — the two sites share no package, as with
* site-prefs.ts); keep the two files aligned so the navbars render identically.
*/
-import { useRef, useState } from "react";
+import { useEffect, useRef, useState } from "react";
import type { MouseEvent } from "react";
import { Link, useLocation } from "react-router";
import { S } from "../lib/strings";
-import { DOCS_URL, REPO_URL } from "../lib/links";
-import { getActiveNavItem, SECTION_IDS } from "../lib/nav-state";
-import type { ActiveNavItem, SectionId } from "../lib/nav-state";
+import { DOCS_URL, REPO_API_URL, REPO_URL } from "../lib/links";
+import {
+ getActiveNavItem,
+ getNavItemForSection,
+ NAV_SECTION_IDS,
+ OBSERVED_SECTION_IDS,
+} from "../lib/nav-state";
+import type { ActiveNavItem, ObservedSectionId } from "../lib/nav-state";
import { useScrollSpy } from "../lib/use-scroll-spy";
import { GitHubIcon, MenuIcon, XIcon } from "./icons";
import { ThemeToggle } from "./theme-toggle";
@@ -25,19 +30,54 @@ import { LangToggle } from "./lang-toggle";
/** Stable empty list: keeps the spy idle away from the home page. */
const NO_IDS: readonly string[] = [];
+function GitHubStarsLink() {
+ const [stars, setStars] = useState<number | null>(null);
+
+ useEffect(() => {
+ const controller = new AbortController();
+ void fetch(REPO_API_URL, {
+ signal: controller.signal,
+ headers: { Accept: "application/vnd.github+json" },
+ })
+ .then((response) => (response.ok ? response.json() : null))
+ .then((data: { stargazers_count?: unknown } | null) => {
+ if (typeof data?.stargazers_count === "number") setStars(data.stargazers_count);
+ })
+ .catch(() => undefined);
+ return () => controller.abort();
+ }, []);
+
+ const count = stars?.toLocaleString("en-US");
+ const label = count ? `${S.nav.github} · ${count} stars` : S.nav.github;
+ return (
+ <a
+ href={REPO_URL}
+ target="_blank"
+ rel="noreferrer"
+ title={label}
+ aria-label={label}
+ className="inline-flex h-9 min-w-9 items-center justify-center gap-1.5 rounded-lg border border-gray-200 bg-white px-2.5 text-xs font-medium text-gray-700 transition-colors hover:bg-gray-50 hover:text-gray-950 dark:border-gray-800 dark:bg-gray-900 dark:text-gray-300 dark:hover:bg-gray-800 dark:hover:text-white"
+ >
+ <GitHubIcon className="h-[18px] w-[18px]" />
+ <span className="min-w-8 tabular-nums">{count ?? "-"}</span>
+ </a>
+ );
+}
+
export function Nav() {
const { pathname, hash } = useLocation();
const onHome = pathname === "/";
- const spied = useScrollSpy(onHome ? SECTION_IDS : NO_IDS) as SectionId | null;
- const activeItem: ActiveNavItem = onHome ? spied : getActiveNavItem(pathname, hash);
+ const spied = useScrollSpy(onHome ? OBSERVED_SECTION_IDS : NO_IDS) as ObservedSectionId | null;
+ const activeItem: ActiveNavItem = onHome
+ ? getNavItemForSection(spied)
+ : getActiveNavItem(pathname, hash);
const [open, setOpen] = useState(false);
const pillRef = useRef<HTMLSpanElement | null>(null);
const pillVisible = useRef(false);
- const sectionLabel: Record<(typeof SECTION_IDS)[number], string> = {
+ const sectionLabel: Record<(typeof NAV_SECTION_IDS)[number], string> = {
highlights: S.nav.highlights,
quickstart: S.nav.quickstart,
- cases: S.nav.cases,
scenarios: S.nav.scenarios,
benchmark: S.nav.benchmark,
contract: S.nav.contract,
@@ -53,7 +93,7 @@ export function Nav() {
const mobileLinkCls = (active: boolean) =>
`rounded-md px-2.5 py-1.5 text-sm transition-colors ${active ? activeLinkCls : mobileInactiveLinkCls}`;
const deskLinkCls = (active: boolean) =>
- `relative z-10 rounded-md px-2.5 py-1.5 text-sm transition-colors ${active ? activeLinkCls : deskInactiveLinkCls}`;
+ `relative z-10 shrink-0 whitespace-nowrap rounded-md px-2 py-1.5 text-[13px] transition-colors ${active ? activeLinkCls : deskInactiveLinkCls}`;
/**
* The hover pill appears IN PLACE under the first link it lands on (position
@@ -86,7 +126,7 @@ export function Nav() {
const desktopLinks = (
<>
- {SECTION_IDS.map((id) => {
+ {NAV_SECTION_IDS.map((id) => {
const active = activeItem === id;
return (
<Link
@@ -125,7 +165,7 @@ export function Nav() {
const mobileLinks = (
<>
- {SECTION_IDS.map((id) => {
+ {NAV_SECTION_IDS.map((id) => {
const active = activeItem === id;
return (
<Link
@@ -164,9 +204,11 @@ export function Nav() {
return (
<header className="sticky top-0 z-40 border-b border-gray-200 bg-white/85 backdrop-blur dark:border-gray-800 dark:bg-gray-950/85">
<div className="mx-auto flex h-14 max-w-7xl items-center gap-2 px-4 sm:px-6">
- <Link to="/" className="flex items-center gap-2" onClick={() => setOpen(false)}>
+ <Link to="/" className="flex shrink-0 items-center gap-2" onClick={() => setOpen(false)}>
<img src={`${import.meta.env.BASE_URL}penguin-logo.svg`} alt="" className="h-7 w-7" />
- <span className="text-[15px] font-semibold tracking-tight">{S.siteName}</span>
+ <span className="hidden text-[15px] font-semibold tracking-tight sm:inline">
+ {S.siteName}
+ </span>
</Link>
<nav
@@ -187,16 +229,7 @@ export function Nav() {
<div className="ml-auto flex items-center gap-1">
<LangToggle />
<ThemeToggle />
- <a
- href={REPO_URL}
- target="_blank"
- rel="noreferrer"
- title={S.nav.github}
- aria-label={S.nav.github}
- className="inline-flex h-9 w-9 items-center justify-center rounded-lg border border-transparent text-gray-600 transition-colors hover:border-gray-200 hover:bg-gray-50 hover:text-gray-900 dark:text-gray-400 dark:hover:border-gray-800 dark:hover:bg-gray-900 dark:hover:text-gray-100"
- >
- <GitHubIcon className="h-[18px] w-[18px]" />
- </a>
+ <GitHubStarsLink />
<button
type="button"
onClick={() => setOpen((v) => !v)}
diff --git a/packages/landing/src/lib/download-source.ts b/packages/landing/src/lib/download-source.ts
index e7e01bc0..cb317dd3 100644
--- a/packages/landing/src/lib/download-source.ts
+++ b/packages/landing/src/lib/download-source.ts
@@ -295,6 +295,14 @@ export interface SourceProbes {
measure(base: string, probe: ReleaseProbe): Promise<Measurement>;
}
+/** Measurements retained for the download page's visual source report. */
+export interface DownloadProbeReport {
+ source: DownloadSource;
+ github: Measurement;
+ /** Null when GitHub already cleared the threshold, so probing paid mirror traffic was unnecessary. */
+ oss: Measurement | null;
+}
+
/**
* The throughput half of the rule, in the order the installers apply it. It runs once the
* reachability pass has found a mirror, which is why an unreachable GitHub here needs no second
@@ -307,16 +315,33 @@ export interface SourceProbes {
* The measurements run one after another on purpose: concurrent transfers share the link and would
* each read as half as fast, which an absolute threshold cannot tolerate.
*/
-export async function decideDownloadSource(
+export async function decideDownloadSourceWithReport(
sources: ProbeSources,
probes: ReleaseProbes,
io: SourceProbes,
-): Promise<DownloadSource> {
+): Promise<DownloadProbeReport> {
const github = await io.measure(sources.githubBase, probes.large);
- if (github.bytesPerSecond >= SPEED_PROBE_GITHUB_MIN_BYTES_PER_SECOND) return "github";
- if (!github.reachable) return "oss";
+ if (github.bytesPerSecond >= SPEED_PROBE_GITHUB_MIN_BYTES_PER_SECOND) {
+ return { source: "github", github, oss: null };
+ }
+ if (!github.reachable) {
+ return { source: "oss", github, oss: null };
+ }
const oss = await io.measure(sources.ossBase, probes.large);
- return selectDownloadSource(github.bytesPerSecond, oss.bytesPerSecond);
+ return {
+ source: selectDownloadSource(github.bytesPerSecond, oss.bytesPerSecond),
+ github,
+ oss,
+ };
+}
+
+/** Source-only compatibility wrapper used by the installer-rule tests and other callers. */
+export async function decideDownloadSource(
+ sources: ProbeSources,
+ probes: ReleaseProbes,
+ io: SourceProbes,
+): Promise<DownloadSource> {
+ return (await decideDownloadSourceWithReport(sources, probes, io)).source;
}
/** The decision above, wired to real requests under the shared budget. */
@@ -330,6 +355,17 @@ export function probeDownloadSource(
});
}
+/** The same real probe, retaining both measurements for the download page. */
+export function probeDownloadSourceWithReport(
+ sources: ProbeSources,
+ probes: ReleaseProbes,
+ deadline: ProbeDeadline,
+): Promise<DownloadProbeReport> {
+ return decideDownloadSourceWithReport(sources, probes, {
+ measure: (base, probe) => measureSource(probeUrl(base, probe.file), probe.size, deadline),
+ });
+}
+
/** Reads a small JSON/TSV lookup under the shared budget; null on any failure. */
async function fetchMetadata(url: string, deadline: ProbeDeadline): Promise<Response | null> {
const timeoutMs = deadline.slice(METADATA_TIMEOUT_MS);
@@ -454,9 +490,17 @@ export async function refineDownloadSource(
mirror: Mirror,
deadline: ProbeDeadline,
): Promise<DownloadSource> {
+ return (await refineDownloadSourceWithReport(mirror, deadline))?.source ?? "github";
+}
+
+/** Refines the source and returns the measurements the download page renders. */
+export async function refineDownloadSourceWithReport(
+ mirror: Mirror,
+ deadline: ProbeDeadline,
+): Promise<DownloadProbeReport | null> {
const probes = await fetchProbes(mirror.base, mirror.tag, deadline);
- if (!probes) return "github";
- return probeDownloadSource(
+ if (!probes) return null;
+ return probeDownloadSourceWithReport(
{ githubBase: GITHUB_LATEST_DOWNLOAD, ossBase: mirror.base },
probes,
deadline,
diff --git a/packages/landing/src/lib/links.ts b/packages/landing/src/lib/links.ts
index 19e84823..fbffa96e 100644
--- a/packages/landing/src/lib/links.ts
+++ b/packages/landing/src/lib/links.ts
@@ -1,6 +1,7 @@
/** External links and language-independent constants used across the landing page. */
export const REPO_URL = "https://github.com/Prism-Shadow/penguin-harness";
+export const REPO_API_URL = "https://api.github.com/repos/Prism-Shadow/penguin-harness";
export const RELEASES_URL = `${REPO_URL}/releases`;
export const LICENSE_URL = `${REPO_URL}/blob/main/LICENSE`;
@@ -43,6 +44,26 @@ cd penguin-install
.\\install.cmd`,
};
+export interface CliInstaller {
+ /** Stable Release asset file name used by both online and offline installation. */
+ file: string;
+ /** Language-neutral architecture label rendered on the direct download link. */
+ variant: string;
+}
+
+/** Direct offline-install downloads shown under the selected command-line platform. */
+export const CLI_INSTALLERS: Record<"linux" | "macos" | "windows", CliInstaller[]> = {
+ linux: [
+ { file: "penguin-linux-x64.tar.gz", variant: "x64" },
+ { file: "penguin-linux-arm64.tar.gz", variant: "arm64" },
+ ],
+ macos: [
+ { file: "penguin-darwin-arm64.tar.gz", variant: "Apple Silicon" },
+ { file: "penguin-darwin-x64.tar.gz", variant: "Intel" },
+ ],
+ windows: [{ file: "penguin-win32-x64.zip", variant: "x64" }],
+};
+
/**
* Heavy marketing media lives in the sibling `penguin-harness-community` repo rather than
* in this one, so that assets only the landing site ever renders stay out of the clone of
diff --git a/packages/landing/src/lib/nav-state.ts b/packages/landing/src/lib/nav-state.ts
index 9f9bb092..519fa371 100644
--- a/packages/landing/src/lib/nav-state.ts
+++ b/packages/landing/src/lib/nav-state.ts
@@ -2,21 +2,34 @@
* Pure route state for the landing page navigation. Section links are represented by
* hashes on the home page; Blog is a normal application route.
*/
-export const SECTION_IDS = [
+export const NAV_SECTION_IDS = [
"highlights",
"quickstart",
- "cases",
"scenarios",
"benchmark",
"contract",
"features",
] as const;
-export type SectionId = (typeof SECTION_IDS)[number];
+/** Includes sections without their own link so scroll-spy can map them to a parent item. */
+export const OBSERVED_SECTION_IDS = [
+ "cases",
+ "highlights",
+ "self-improvement",
+ ...NAV_SECTION_IDS.slice(1),
+] as const;
+
+export type SectionId = (typeof NAV_SECTION_IDS)[number];
+export type ObservedSectionId = (typeof OBSERVED_SECTION_IDS)[number];
export type ActiveNavItem = SectionId | "blog" | "download" | null;
function isSectionId(value: string): value is SectionId {
- return SECTION_IDS.some((id) => id === value);
+ return NAV_SECTION_IDS.some((id) => id === value);
+}
+
+export function getNavItemForSection(value: string | null): SectionId | null {
+ if (value === "self-improvement") return "highlights";
+ return value && isSectionId(value) ? value : null;
}
export function getActiveNavItem(pathname: string, hash: string): ActiveNavItem {
@@ -25,5 +38,5 @@ export function getActiveNavItem(pathname: string, hash: string): ActiveNavItem
if (pathname !== "/") return null;
const id = hash.startsWith("#") ? hash.slice(1) : hash;
- return isSectionId(id) ? id : null;
+ return getNavItemForSection(id);
}
diff --git a/packages/landing/src/lib/strings-en.ts b/packages/landing/src/lib/strings-en.ts
index 77f2a03e..06fe0345 100644
--- a/packages/landing/src/lib/strings-en.ts
+++ b/packages/landing/src/lib/strings-en.ts
@@ -1,7 +1,7 @@
/**
* English dictionary (constrained by the `Strings` type to the same shape as zh):
- * locale switching goes through state/locale.tsx. Keep domain term capitalization
- * consistent with zh — Agent, Workspace, Token, Task, Skill, Trace, etc.
+ * locale switching goes through state/locale.tsx. Marketing copy uses lowercase `agent`;
+ * preserve the established casing of Workspace, Token, Task, Skill, Trace, and other terms.
*/
import type { Strings } from "./strings";
@@ -18,6 +18,7 @@ export const en: Strings = {
nav: {
highlights: "Highlights",
+ selfImprove: "Self-evolution",
quickstart: "Quick start",
cases: "Cases",
scenarios: "Scenarios",
@@ -47,27 +48,32 @@ export const en: Strings = {
},
hero: {
- // The trailing space lives in the PREFIX (a breakable space before the nowrap
- // span) — inside titleNoWrap it would glue "Builder," to the unbreakable chunk.
- titlePrefix: "Your Automated Agent Builder, ",
- titleNoWrap: "Right on Your ",
- titleWords: ["Desktop", "Server"],
- titleSuffix: "",
- subtitle: "Create Self-Evolving Agents in One Click",
- /** Primary CTA: base label, and the platform-aware variant once the OS is detected. */
- downloadCta: "Download the desktop app",
- downloadCtaFor: (platform: string) => `Download for ${platform}`,
- ctaQuickstart: "Get started",
- ctaGithub: "GitHub",
- /** Line under the CTAs: all installers on /download, CLI / self-hosted below the fold. */
- downloadAll: "All platforms (macOS / Windows / Linux)",
- cliAlt: "CLI and self-hosted install ↓",
+ platformLead: "The open-source, local-first agent app ",
+ platformAccent: "development",
+ platformTail: " platform",
+ automationLead: "Fully automated ",
+ automationActions: ["creation", "optimization", "deployment"],
+ automationTail: "of AI apps",
+ downloadCta: "Download desktop",
+ cliInstall: "Command-line install",
stats: [
- { value: "1000+", label: "supported models" },
- { value: "1×CPU", label: "minimum footprint" },
- { value: "100%", label: "open source, local deploy" },
- { value: "First native", label: "recursively self-improving harness" },
+ { value: "1000+ models", label: "Support for major providers" },
+ { value: "Local on every platform", label: "Linux · Windows · macOS" },
+ { value: "100% open source", label: "Apache 2.0 licensed" },
+ { value: "First self-evolving harness", label: "native agent self-evolution engine" },
],
+ supportedModelsLabel: "Supported models",
+ supportedModels: [
+ "OpenAI",
+ "Anthropic",
+ "Gemini",
+ "DeepSeek",
+ "Zai",
+ "MoonShot",
+ "Qwen",
+ "Openrouter",
+ ],
+ supportedModelsMore: "+992 more",
},
install: {
@@ -92,8 +98,6 @@ export const en: Strings = {
download: {
eyebrow: "Download",
title: "Download the desktop app",
- subtitle:
- "The full Web experience as a standalone application: it embeds the server and opens already signed in — no terminal, no login page; data lives in the same ~/.penguin/data root as a CLI install.",
recommended: "Your system",
platforms: {
mac: { name: "macOS", require: "macOS 11 or later, dmg disk image (pick your chip)" },
@@ -103,6 +107,22 @@ export const en: Strings = {
require: "x64 — AppImage runs in place, deb goes to your package manager",
},
},
+ speed: {
+ title: "Automatically pick the fastest source",
+ subtitle:
+ "The page checks reachability first, then measures speed in the background. Download buttons do not wait for the full test.",
+ github: "GitHub Releases",
+ githubHint: "Global source",
+ oss: "OSS mirror",
+ ossHint: "Optimized for mainland China",
+ testing: "Testing",
+ skipped: "Not tested",
+ unreachable: "Unavailable",
+ belowFloor: "Too slow to measure",
+ selected: "Current download route",
+ automatic: "Automatic",
+ manual: "Manual",
+ },
statusProbing: "Finding a download source that answers …",
statusRefining: "Still comparing the two sources — the faster one takes over on its own.",
statusOss: (version: string) =>
@@ -111,7 +131,7 @@ export const en: Strings = {
altGithub: "Download from GitHub instead",
altOss: "Use the OSS mirror instead",
checksums: "Checksums (SHA256SUMS.desktop)",
- allReleases: "All releases",
+ allReleases: "Open GitHub Releases",
/** First-launch FAQ: one collapsible item per platform, the visitor's own pre-expanded. */
faq: {
title: "First-launch FAQ",
@@ -162,21 +182,21 @@ export const en: Strings = {
desc: "A deliberately minimal toolset over clean low-level interfaces: fewer tool calls, fewer Tokens, complex tasks done efficiently.",
},
{
- title: "Harness for Building Agents",
+ title: "Harness for building agents",
tag: "",
- desc: "With the PenguinHarness SDK, an Agent builds complete Agent applications for you — autonomously, from scratch.",
+ desc: "With the PenguinHarness SDK, an agent builds complete agent applications for you — autonomously, from scratch.",
},
{
title: "Harness for Recursive Self-Improvement",
tag: "",
- desc: "With PenguinHarness Skills, an Agent evaluates and optimizes itself, improving recursively over time.",
+ desc: "With PenguinHarness Skills, an agent evaluates and optimizes itself, improving recursively over time.",
},
],
},
compare: {
eyebrow: "vs. LangChain",
- title: "Building Agents with Agents",
+ title: "Building agents with agents",
subtitle: [
"With LangChain, you build agents by hand — at 1× speed.",
"With PenguinHarness, agents build agents — at 100×.",
@@ -184,14 +204,14 @@ export const en: Strings = {
langchain: {
name: "LangChain",
speed: "1×",
- mode: "Agents built by hand",
+ mode: "agents built by hand",
note: "Chains, tools and prompts written line by line — every app starts from zero.",
},
penguin: {
name: "PenguinHarness",
speed: "100×",
- mode: "Agents built by agents",
- note: "One sentence in — an Agent delivers scaffold, code and run instructions end to end.",
+ mode: "agents built by agents",
+ note: "One sentence in — an agent delivers scaffold, code and run instructions end to end.",
},
},
@@ -199,13 +219,13 @@ export const en: Strings = {
eyebrow: "The self-improvement loop",
title: "Multi-agent collaboration makes evolution automatic",
subtitle:
- "The Optimizer orchestrates multiple Evaluators to score the Target Agent in parallel, uses the scores and run traces to find where points were lost, and upgrades the Agent from version N to N+1 — with a snapshot before every round.",
+ "The Optimizer orchestrates multiple Evaluators to score the target agent in parallel, uses the scores and run traces to find where points were lost, and upgrades the agent from version N to N+1 — with a snapshot before every round.",
videoLabel: "Self-improvement demo video",
videoCaption:
"The self-improvement loop end to end: run the benchmark, find the lost points, ship the next version.",
nodeOptimizer: "Optimizer",
nodeEvaluator: "Evaluator × N",
- nodeTarget: "Target Agent",
+ nodeTarget: "target agent",
badgeOld: "vN",
badgeNew: "vN+1",
edgeSpawn: "spawn parallel evaluations",
@@ -218,60 +238,70 @@ export const en: Strings = {
{ label: "Time", hint: "keeps shrinking" },
],
diagramLabel:
- "Self-improvement loop: the Optimizer orchestrates Evaluators to score, then upgrades the Target Agent from vN to vN+1 via scores and traces",
+ "Self-improvement loop: the Optimizer orchestrates Evaluators to score, then upgrades the target agent from vN to vN+1 via scores and traces",
},
quickstart: {
eyebrow: "Quick start",
- title: "Your first task in three steps",
- subtitle:
- "Install with one command and let the Agent work from a desktop-grade interface — all data stays in your local ~/.penguin/data directory.",
- step1: "Install",
- step1Desc:
- "Pick your OS and method — the online one-liner, or an offline package; the bundle carries its own Node runtime, and upgrades never touch your data.",
- tabWeb: "Web UI",
- tabCli: "CLI",
- webStep2: "Open the web interface",
- webStep2Desc:
- "penguin web starts the local service and opens your browser; sign in as the built-in admin “admin” with the initial password printed in the terminal on first start (looks like penguin-1234; change it right after).",
- webCmd: "penguin web # opens http://127.0.0.1:7364",
- webStep3: "Configure a model in the UI and start chatting",
- webStep3Desc:
- "Open the Models page, paste an API key under the DeepSeek or OpenRouter group and set it as default; then head back to Chat and hand the Agent its first task — e.g. “Analyze data.csv and summarize quarterly sales”.",
- getKeyPrefix: "Get an API key: ",
- getDeepseekKey: "DeepSeek console",
- getOpenrouterKey: "OpenRouter console",
- cliStep2: "Configure a model",
- cliStep2Desc:
- "Using the DeepSeek official API or the OpenRouter gateway as examples — one command configures it and sets the default.",
- tabDeepseek: "DeepSeek",
- tabOpenrouter: "OpenRouter",
- deepseekCmd: `penguin config model add \\
- --provider deepseek \\
- --model-id deepseek-v4-pro \\
- --api-key sk-your-deepseek-key \\
- --set-default`,
- deepseekNote:
- "A model is always referenced by the (provider, model_id) pair, so --provider is required; omit --api-key to fall back to the DEEPSEEK_API_KEY environment variable.",
- openrouterCmd: `penguin config model add \\
- --provider openrouter \\
- --model-id deepseek/deepseek-v4-pro \\
- --api-key sk-or-your-key \\
- --set-default`,
- openrouterNote:
- "Gateway groups pre-fill the OpenAI-compatible protocol and base URL — one key unlocks a thousand models.",
- cliStep3: "Run",
- cliStep3Desc:
- "penguin run executes a single task; penguin chat drops you into an interactive REPL.",
- runCmd: `penguin run --approve allow-all \\
- --message "Analyze data.csv and summarize quarterly sales"`,
+ title: "Get started with PenguinHarness in two steps",
+ subtitle: "Choose how to install first. With a CLI install, then choose Web UI or CLI.",
+ stepOne: "Step one",
+ chooseInstall: "Choose an installation method",
+ stepTwo: "Step two",
+ chooseLaunch: "Choose how to start",
+ tabs: {
+ desktop: "Desktop app",
+ install: "CLI install",
+ web: "Start Web UI",
+ cli: "Start CLI",
+ },
+ desktop: {
+ title: "Desktop first, ready when it opens",
+ desc: "The local server and full Web UI are built in, with no runtime setup and no terminal process to keep alive.",
+ cta: "Choose your system and download",
+ steps: [
+ "Download the installer for your system",
+ "Open PenguinHarness and follow the model setup",
+ "Describe your first agent app in one sentence",
+ ],
+ },
+ install: {
+ title: "Install PenguinHarness with one command",
+ desc: "Made for developer machines, servers, and private environments. The bundle includes its runtime and does not depend on system Node.js.",
+ osLabel: "Choose an operating system",
+ onlineTitle: "Online install",
+ offlineTitle: "Offline packages",
+ offlineDesc:
+ "Download the package for the target system on a connected machine, then copy it to the offline machine to install.",
+ offlineCommand: "Show offline install commands",
+ },
+ web: {
+ title: "Use the full interface in your browser",
+ desc: "This starts the local service and opens the Web UI, a good fit for servers and remote access.",
+ command: "penguin web # opens http://127.0.0.1:7364",
+ steps: [
+ "Complete the command-line install",
+ "Run penguin web",
+ "Follow the terminal prompt to sign in and configure a model",
+ ],
+ },
+ cli: {
+ title: "Run an agent directly from the terminal",
+ desc: "Start an interactive conversation or connect a one-off task to scripts and automated workflows.",
+ command: `penguin chat
+
+# Or run one task
+penguin run --message "Analyze data.csv and summarize quarterly sales"`,
+ },
+ localNote:
+ "Desktop, Web UI, and CLI share ~/.penguin/data; switching entry points never moves or copies your data.",
},
cases: {
eyebrow: "Cases",
- title: "From one sentence to a running app",
+ title: "Generate a runnable agent app in one sentence",
subtitle:
- "Hand the requirement to an Agent and get a runnable result end to end — more cases are on the way.",
+ "Hand the requirement to an agent and get a runnable result end to end — more cases are on the way.",
tabs: [
{
label: "RAG app",
@@ -295,17 +325,18 @@ export const en: Strings = {
scenarios: {
eyebrow: "Scenarios",
title: "From screening centers to factory floors",
- subtitle: "Real deployments in production — not concept demos.",
+ subtitle:
+ "Production stories of teams using PenguinHarness to build agents automatically and deploy them to production.",
items: [
{
title: "Screening-report QC",
alt: "A CT scanner room at a health screening center",
- body: "A health-screening group handed report QC to an agent on a locally deployed Qwen3 14B — data never leaves the facility. A review round that took 30 minutes by hand now clears 30 reports a minute, with findings in line with medical experts and several times the review capacity.",
+ body: "A health-screening group used PenguinHarness to automatically build a report-QC agent and deploy it into its production environment on a local Qwen3 14B, so data never leaves the facility. A review round that took 30 minutes by hand now clears 30 reports a minute, with findings in line with medical experts and several times the review capacity.",
},
{
title: "Production-line inspection",
alt: "An automated semiconductor production line",
- body: "A manufacturer runs inspection agents across its production lines, watching equipment around the clock and trying automated recovery first when something goes wrong. Downtime is down 65%; output roughly doubled.",
+ body: "A manufacturer used PenguinHarness to automatically build a production-line inspection agent and deploy it across multiple live lines. The agent watches equipment around the clock and tries automated recovery first when something goes wrong; after deployment, downtime fell 65% and output roughly doubled.",
},
],
},
@@ -316,15 +347,15 @@ export const en: Strings = {
subtitle:
"PenguinHarness treats this contract as the boundary and bedrock of evolution: capability may grow, the boundary never drifts.",
intro:
- "Evolution needs boundaries. The contract is the covenant between harness and Agent: capability grows within; the boundary holds without.",
+ "Evolution needs boundaries. The contract is the covenant between harness and agent: capability grows within; the boundary holds without.",
items: [
{
term: "Working boundary",
- text: "Every Agent runs on the same harness: Sessions are created under an Agent, Tasks run inside a Session; self-improvement happens only inside Workspace and Skills, while the harness kernel and its safety mechanisms never change.",
+ text: "Every agent runs on the same harness: Sessions are created under an agent, Tasks run inside a Session; self-improvement happens only inside Workspace and Skills, while the harness kernel and its safety mechanisms never change.",
},
{
term: "Editable files",
- text: "An Agent's prompts, Skills and configuration live as editable files on disk, never as constants baked into code. What you can see, the Agent can improve; what you can edit, it can learn.",
+ text: "An agent's prompts, Skills and configuration live as editable files on disk, never as constants baked into code. What you can see, the agent can improve; what you can edit, it can learn.",
},
{
term: "Full tracing",
@@ -332,11 +363,11 @@ export const en: Strings = {
},
{
term: "Approvals & audit",
- text: "Every tool call passes approval before it runs, and every decision leaves an audit record — what the Agent did is never a mystery.",
+ text: "Every tool call passes approval before it runs, and every decision leaves an audit record — what the agent did is never a mystery.",
},
{
term: "Version control",
- text: "Before each optimization, the Agent State is snapshotted. If a round fails or regresses, restore any historical version in one step.",
+ text: "Before each optimization, the agent state is snapshotted. If a round fails or regresses, restore any historical version in one step.",
},
{
term: "Progressive loading",
@@ -352,14 +383,14 @@ export const en: Strings = {
},
{
term: "Model decoupling",
- text: "Models are not bound to Agents: switch to a stronger or cheaper model at any time without rewriting the Agent.",
+ text: "Models are not bound to agents: switch to a stronger or cheaper model at any time without rewriting the agent.",
},
{
term: "Recoverable trajectories",
text: "Any Session can be fully restored from its Trace: restart the process or move machines without losing context.",
},
],
- outro: "The contract does not cap what an Agent can become — only how it gets there.",
+ outro: "The contract does not cap what an agent can become — only how it gets there.",
},
benchmark: {
@@ -397,19 +428,19 @@ export const en: Strings = {
items: [
{
title: "Multi-session chat",
- desc: "Any number of sessions per Agent — streaming output, tool approvals and image paste out of the box.",
+ desc: "Any number of sessions per agent — streaming output, tool approvals and image paste out of the box.",
},
{
- title: "Agent hub",
- desc: "Create and manage Agents in one click; names, descriptions and prompts stay editable.",
+ title: "agent hub",
+ desc: "Create and manage agents in one click; names, descriptions and prompts stay editable.",
},
{
title: "Skill library",
- desc: "Browse, install and quick-invoke Skills — Agents can write and optimize their own.",
+ desc: "Browse, install and quick-invoke Skills — agents can write and optimize their own.",
},
{
title: "Scheduled tasks",
- desc: "Cron-style schedules run Agents on time, fully traced, unattended.",
+ desc: "Cron-style schedules run agents on time, fully traced, unattended.",
},
{
title: "Subagents",
@@ -424,8 +455,8 @@ export const en: Strings = {
desc: "Replay every request and tool call round by round, with Token breakdown and timing.",
},
{
- title: "Agent evaluation",
- desc: "Built-in Benchmark suites and scoreboards — scores keep climbing as Agents evolve.",
+ title: "agent evaluation",
+ desc: "Built-in Benchmark suites and scoreboards — scores keep climbing as agents evolve.",
},
{
title: "Multi-user management",
@@ -437,7 +468,7 @@ export const en: Strings = {
skills: {
eyebrow: "Built-in Skills",
title: "The built-in Skill library at a glance",
- subtitle: "Four Skill groups out of the box — Agents can write and optimize their own, too.",
+ subtitle: "Four Skill groups out of the box — agents can write and optimize their own, too.",
groups: [
{ title: "Office Productivity", skills: ["data-analysis", "firecrawl"] },
{ title: "Software Development", skills: ["web-design", "software-engineering"] },
@@ -446,7 +477,7 @@ export const en: Strings = {
skills: ["penguin-sdk", "penguin-cli", "agenthub-models", "vllm", "ollama", "llamafactory"],
},
{
- title: "Agent Tuning",
+ title: "agent tuning",
skills: [
"agent-initialization",
"benchmark-design",
@@ -496,7 +527,7 @@ export const en: Strings = {
cta: {
title: "Complex AI development, made ever simpler",
subtitle:
- "Through continuous evolution, PenguinHarness gives you a more efficient, more reliable, lower-hallucination and lower-cost Agent productivity engine.",
+ "Through continuous evolution, PenguinHarness gives you a more efficient, more reliable, lower-hallucination and lower-cost agent productivity engine.",
download: "Download the desktop app",
quickstart: "Get started",
docs: "Read the docs",
@@ -508,7 +539,8 @@ export const en: Strings = {
resources: "Resources",
quickstart: "Quick start",
features: "Features",
- benchmark: "Benchmark",
+ selfImprove: "Self-evolution engine",
+ cases: "Cases",
blog: "Blog",
repo: "GitHub repository",
docs: "Documentation",
diff --git a/packages/landing/src/lib/strings.ts b/packages/landing/src/lib/strings.ts
index 038d88d5..ca28e9f0 100644
--- a/packages/landing/src/lib/strings.ts
+++ b/packages/landing/src/lib/strings.ts
@@ -3,8 +3,8 @@
* active dictionary `S`; the English dictionary lives in strings-en.ts (constrained to
* the same shape by the `Strings` type). Locale switching is handled by state/locale.tsx,
* which calls `setActiveStrings` and remounts the tree keyed by locale — keep `S.x`
- * reads inside components. Keep domain terms in standard English casing — Agent,
- * Workspace, Token, Task, Skill, Trace, etc.
+ * reads inside components. English marketing copy uses lowercase `agent`; preserve the
+ * established casing of Workspace, Token, Task, Skill, Trace, and other product terms.
*/
export const zh = {
siteName: "PenguinHarness",
@@ -19,6 +19,7 @@ export const zh = {
nav: {
highlights: "特色",
+ selfImprove: "自进化",
quickstart: "快速开始",
cases: "案例",
scenarios: "应用场景",
@@ -48,31 +49,32 @@ export const zh = {
},
hero: {
- /**
- * Headline: {titlePrefix}<nowrap>{titleNoWrap}{word}{titleSuffix}</nowrap>, the word
- * rotating through titleWords (桌面/服务器 — where the builder runs; the README
- * writes the pair as "桌面 / 服务器"). The nowrap span pins the wrap point in front
- * of it, so a break never splits "Agent Builder" / "Right on Your Desktop" mid-phrase.
- */
- titlePrefix: "全自动 Agent 构建平台,",
- titleNoWrap: "运行在你的",
- titleWords: ["桌面", "服务器"],
- titleSuffix: "上",
- subtitle: "一键创建自进化 Agent",
- /** Primary CTA: base label, and the platform-aware variant once the OS is detected. */
+ platformLead: "开源、本地的 Agent 应用",
+ platformAccent: "自动开发",
+ platformTail: "平台",
+ automationLead: "全自动",
+ automationActions: ["创建", "优化", "部署"],
+ automationTail: "AI 应用",
downloadCta: "下载桌面版",
- downloadCtaFor: (platform: string) => `下载桌面版(${platform})`,
- ctaQuickstart: "快速开始",
- ctaGithub: "GitHub",
- /** Line under the CTAs: all installers on /download, CLI / self-hosted below the fold. */
- downloadAll: "全部平台下载(macOS / Windows / Linux)",
- cliAlt: "命令行与自托管安装 ↓",
+ cliInstall: "命令行安装",
stats: [
- { value: "1000+", label: "支持模型数量" },
- { value: "1×CPU", label: "最低运行配置" },
- { value: "100%", label: "开源,可本地部署" },
- { value: "首个原生", label: "递归自我进化 Harness" },
+ { value: "1000+ 模型", label: "支持主流供应商" },
+ { value: "跨平台本地部署", label: "Linux,Windows,macOS 多系统兼容" },
+ { value: "100% 开源", label: "Apache 2.0 协议开源" },
+ { value: "首个自进化 Harness", label: "原生 Agent 自进化引擎" },
],
+ supportedModelsLabel: "支持模型",
+ supportedModels: [
+ "OpenAI",
+ "Anthropic",
+ "Gemini",
+ "DeepSeek",
+ "Zai",
+ "MoonShot",
+ "Qwen",
+ "Openrouter",
+ ],
+ supportedModelsMore: "+992 more",
},
/** Install-method switcher (quick start step 1): OS tabs, online/offline methods. */
@@ -97,14 +99,27 @@ export const zh = {
download: {
eyebrow: "下载",
title: "下载桌面端",
- subtitle:
- "完整的 Web 体验打包为独立应用:内嵌服务端,打开即已登录——无需终端、无登录页;数据与 CLI 安装共用同一个 ~/.penguin/data 目录。",
recommended: "当前系统",
platforms: {
mac: { name: "macOS", require: "macOS 11 及以上,dmg 安装镜像(按芯片选择)" },
windows: { name: "Windows", require: "Windows 10 及以上(x64),NSIS 安装程序" },
linux: { name: "Linux", require: "x64,AppImage 免安装运行,或 deb 交给包管理器" },
},
+ speed: {
+ title: "智能选择最快下载源",
+ subtitle: "页面会先确认连通性,再在后台测速;下载按钮无需等待完整测速即可使用。",
+ github: "GitHub Releases",
+ githubHint: "全球源",
+ oss: "OSS 国内镜像",
+ ossHint: "中国大陆优化",
+ testing: "测速中",
+ skipped: "未测速",
+ unreachable: "暂不可达",
+ belowFloor: "速度过低",
+ selected: "当前下载线路",
+ automatic: "自动选择",
+ manual: "手动选择",
+ },
statusProbing: "正在为你确认可用的下载源……",
statusRefining: "仍在比较两个源的速度,更快的一个会自动生效。",
statusOss: (version: string) => `已连接 OSS 国内镜像(${version}),点击即从镜像高速下载。`,
@@ -112,7 +127,7 @@ export const zh = {
altGithub: "改从 GitHub 下载",
altOss: "改用 OSS 镜像下载",
checksums: "校验和(SHA256SUMS.desktop)",
- allReleases: "全部版本",
+ allReleases: "打开 GitHub 发布页",
/** First-launch FAQ: one collapsible item per platform, the visitor's own pre-expanded. */
faq: {
title: "首次启动常见问题",
@@ -221,50 +236,57 @@ export const zh = {
quickstart: {
eyebrow: "快速开始",
- title: "三步跑通第一个任务",
- subtitle:
- "一行命令安装,打开桌面级界面即可让 Agent 开始工作;数据全部保存在本地 ~/.penguin/data 目录。",
- step1: "安装",
- step1Desc:
- "选择你的系统与安装方式:在线一行命令,或离线安装包;产物内嵌 Node 运行时,解压即用,升级与重装不触碰数据。",
- tabWeb: "Web 界面",
- tabCli: "命令行",
- webStep2: "启动 Web 界面",
- webStep2Desc:
- "penguin web 启动本地服务并打开浏览器,用内置管理员 admin 登录——初始密码在服务端首次启动时打印到终端(形如 penguin-1234),登录后请尽快修改密码。",
- webCmd: "penguin web # 打开 http://127.0.0.1:7364",
- webStep3: "在界面里配置模型,开始对话",
- webStep3Desc:
- "进入「模型库」页,在 DeepSeek 或 OpenRouter 分组里粘贴 API key 并设为默认;回到对话页把第一个任务交给 Agent,例如「分析 data.csv,输出各季度销售额汇总」。",
- getKeyPrefix: "获取 API key:",
- getDeepseekKey: "DeepSeek 控制台",
- getOpenrouterKey: "OpenRouter 控制台",
- cliStep2: "配置模型",
- cliStep2Desc: "以 DeepSeek 官方 API 或 OpenRouter 网关为例,一条命令完成配置并设为默认。",
- tabDeepseek: "DeepSeek",
- tabOpenrouter: "OpenRouter",
- deepseekCmd: `penguin config model add \\
- --provider deepseek \\
- --model-id deepseek-v4-pro \\
- --api-key sk-your-deepseek-key \\
- --set-default`,
- deepseekNote:
- "模型引用始终是 (provider, model_id) 二元组,--provider 必填;省略 --api-key 时回退环境变量 DEEPSEEK_API_KEY。",
- openrouterCmd: `penguin config model add \\
- --provider openrouter \\
- --model-id deepseek/deepseek-v4-pro \\
- --api-key sk-or-your-key \\
- --set-default`,
- openrouterNote: "网关分组自动预填 OpenAI 兼容协议与 base URL,一个 key 即可访问上千种模型。",
- cliStep3: "运行",
- cliStep3Desc: "penguin run 直接执行单个任务;penguin chat 进入交互式 REPL。",
- runCmd: `penguin run --approve allow-all \\
- --message "分析 data.csv,输出各季度销售额汇总"`,
+ title: "分两步开始使用 PenguinHarness",
+ subtitle: "先选择安装方式;使用命令行安装时,再选择 Web UI 或 CLI 启动。",
+ stepOne: "第一步",
+ chooseInstall: "选择安装方式",
+ stepTwo: "第二步",
+ chooseLaunch: "选择启动方式",
+ tabs: {
+ desktop: "桌面端",
+ install: "命令行安装",
+ web: "启动 Web UI",
+ cli: "启动 CLI",
+ },
+ desktop: {
+ title: "桌面端优先,打开就能用",
+ desc: "内置本地服务与完整 Web 界面,无需先配置运行环境,也无需在终端里保持进程。",
+ cta: "选择系统并下载",
+ steps: [
+ "下载适合当前系统的安装包",
+ "打开 PenguinHarness,按引导配置模型",
+ "输入一句话,创建第一个 Agent 应用",
+ ],
+ },
+ install: {
+ title: "一行命令安装 PenguinHarness",
+ desc: "适合开发机、服务器和私有化环境。安装包自带运行时,不依赖系统里的 Node.js。",
+ osLabel: "选择操作系统",
+ onlineTitle: "在线安装",
+ offlineTitle: "离线安装包",
+ offlineDesc: "在有网机器下载目标系统的安装包,再拷贝到离线机器完成安装。",
+ offlineCommand: "展开离线安装命令",
+ },
+ web: {
+ title: "在浏览器里使用完整界面",
+ desc: "命令会启动本地服务并自动打开 Web UI,适合服务器部署和远程访问。",
+ command: "penguin web # 打开 http://127.0.0.1:7364",
+ steps: ["先完成命令行安装", "运行 penguin web", "按终端提示登录并配置模型"],
+ },
+ cli: {
+ title: "直接从终端运行 Agent",
+ desc: "进入交互式对话,或把单次任务接入脚本和自动化工作流。",
+ command: `penguin chat
+
+# 或执行单次任务
+penguin run --message "分析 data.csv,输出季度销售额"`,
+ },
+ localNote: "桌面端、Web UI 与 CLI 共用 ~/.penguin/data;切换入口不会迁移或复制数据。",
},
cases: {
eyebrow: "案例",
- title: "从一句话到可运行的应用",
+ title: "一句话生成可运行的 Agent 应用",
subtitle: "把需求交给 Agent,端到端拿到可运行的结果;更多案例陆续加入。",
tabs: [
{
@@ -286,17 +308,17 @@ export const zh = {
scenarios: {
eyebrow: "应用场景",
title: "从体检中心到工厂车间",
- subtitle: "都是已经上线的真实部署,不是概念演示。",
+ subtitle: "企业使用 PenguinHarness 自动开发 Agent,并部署到生产环境的真实案例。",
items: [
{
title: "体检报告质控",
alt: "体检中心的 CT 检查室",
- body: "一家体检机构把报告质控交给了 Agent,跑在本地部署的 Qwen3 14B 上,数据不出机房。过去一轮人工复核要 30 分钟,现在一分钟自动过 30 份,核查结论与医学专家基本一致,审核产能提升数倍。",
+ body: "一家体检机构使用 PenguinHarness 自动开发了报告质控 Agent,并将它部署到院内生产环境,接入本地 Qwen3 14B,数据不出机房。过去一轮人工复核要 30 分钟,现在每分钟自动核查 30 份报告,结论与医学专家基本一致,审核产能提升数倍。",
},
{
title: "产线设备巡检",
alt: "自动化半导体生产线",
- body: "一家制造企业在各条流水线上部署巡检 Agent,全天候盯着设备状态,异常时先尝试自动恢复。停机时间减少 65%,产出提升约 2 倍。",
+ body: "一家制造企业使用 PenguinHarness 自动开发了产线巡检 Agent,并将它部署到多条流水线的生产环境。Agent 全天候监测设备状态,发现异常后优先尝试自动恢复;上线后停机时间减少 65%,产出提升约 2 倍。",
},
],
},
@@ -497,7 +519,8 @@ export const zh = {
resources: "资源",
quickstart: "快速开始",
features: "功能",
- benchmark: "评测",
+ selfImprove: "自进化引擎",
+ cases: "案例",
blog: "博客",
repo: "GitHub 仓库",
docs: "文档",
diff --git a/packages/landing/src/lib/version.ts b/packages/landing/src/lib/version.ts
new file mode 100644
index 00000000..d1a34d7e
--- /dev/null
+++ b/packages/landing/src/lib/version.ts
@@ -0,0 +1,4 @@
+import packageInfo from "../../package.json";
+
+/** Release version shown beside installer actions; kept in sync by the normal version bump. */
+export const RELEASE_VERSION = `v${packageInfo.version}`;
diff --git a/packages/landing/src/pages/download.tsx b/packages/landing/src/pages/download.tsx
index ba5d3ecd..fad585d2 100644
--- a/packages/landing/src/pages/download.tsx
+++ b/packages/landing/src/pages/download.tsx
@@ -1,24 +1,7 @@
-/**
- * Desktop download page. The buttons resolve to one of two sources: GitHub's static
- * `releases/latest/download/<name>` links — always valid because installer names are
- * version-less — or the OSS mirror's immutable per-tag URLs.
- *
- * Two passes decide, for the reason spelled out in lib/download-source.ts: whether a
- * source answers is a round trip, while how fast it is cannot be judged in under a
- * second at any probe size. So the buttons wait only on the first — one second at the
- * outside — and go live knowing nobody has been handed a link that will never start.
- * The throughput comparison then runs behind the live page and upgrades the links to the
- * mirror if it turns out to be worth switching to, which can cost a slower download but
- * never a broken one. Nothing is cached: conditions change between visits, so every load
- * measures again. Whatever the passes decide, the visitor can still switch by hand.
- *
- * Plain-anchor downloads are never CORS-gated; only the lookups and the probes are.
- * Below the cards, a first-launch FAQ covers the unsigned builds — one collapsible item
- * per platform (macOS quarantine removal, SmartScreen, AppImage execute bit), with the
- * visitor's own platform pre-expanded.
- */ import { useEffect, useState } from "react";
+/** Desktop downloads with platform-first choices and a visible source speed report. */
+import { useEffect, useState } from "react";
import { Link } from "react-router";
-import type { ReactNode } from "react";
+import type { ComponentType, ReactNode, SVGProps } from "react";
import { S } from "../lib/strings";
import {
DESKTOP_INSTALLERS,
@@ -26,10 +9,12 @@ import {
GITHUB_LATEST_DOWNLOAD,
LINUX_APPIMAGE_CHMOD_CMD,
MAC_UNQUARANTINE_CMD,
+ OSS_ORIGIN,
RELEASES_URL,
} from "../lib/links";
import { detectPlatform } from "../lib/platform";
import type { Platform } from "../lib/platform";
+import { RELEASE_VERSION } from "../lib/version";
import {
GATE_BUDGET_MS,
MIRROR_POINTER_MS,
@@ -37,21 +22,48 @@ import {
createDeadline,
fetchMirror,
gateDownloadSource,
- refineDownloadSource,
+ refineDownloadSourceWithReport,
worthRefining,
} from "../lib/download-source";
-import type { DownloadSource, Mirror } from "../lib/download-source";
+import type {
+ DownloadProbeReport,
+ DownloadSource,
+ Measurement,
+ Mirror,
+} from "../lib/download-source";
import { Section } from "../components/section";
import { CodeCard } from "../components/code-card";
-import { ChevronDownIcon, DownloadIcon, ExternalLinkIcon, SpinnerIcon } from "../components/icons";
+import {
+ CheckIcon,
+ ChevronDownIcon,
+ DownloadIcon,
+ ExternalLinkIcon,
+ LinuxIcon,
+ MacOSIcon,
+ SpinnerIcon,
+ WindowsIcon,
+} from "../components/icons";
const PLATFORMS: Platform[] = ["mac", "windows", "linux"];
+const PLATFORM_ICONS: Record<Platform, ComponentType<SVGProps<SVGSVGElement>>> = {
+ mac: MacOSIcon,
+ windows: WindowsIcon,
+ linux: LinuxIcon,
+};
+const PLATFORM_ICON_CLASSES: Record<Platform, string> = {
+ mac: "bg-gray-100 text-gray-950 dark:bg-gray-800 dark:text-white",
+ windows: "bg-gray-100 dark:bg-gray-800",
+ linux: "bg-gray-100 dark:bg-gray-800",
+};
+const RELEASE_MIRROR: Mirror = {
+ tag: RELEASE_VERSION,
+ base: `${OSS_ORIGIN}/releases/${RELEASE_VERSION}`,
+};
+
+function installerSuffix(file: string): string {
+ return file.match(/(\.AppImage|\.dmg|\.exe|\.deb)$/)?.[1] ?? "";
+}
-/**
- * One collapsible item of the first-launch FAQ. `defaultOpen` pre-expands the visitor's
- * own platform on mount; after that the element owns its open state (React only writes
- * the `open` property again if the rendered value changes, which it never does here).
- */
function FaqItem({
question,
defaultOpen,
@@ -77,18 +89,98 @@ function FaqItem({
);
}
+function formatSpeed(bytesPerSecond: number): string {
+ if (bytesPerSecond >= 1024 * 1024) {
+ return `${(bytesPerSecond / 1024 / 1024).toFixed(1)} MB/s`;
+ }
+ return `${Math.max(1, Math.round(bytesPerSecond / 1024))} KB/s`;
+}
+
+function speedText(measurement: Measurement | null, testing: boolean): string {
+ if (testing) return S.download.speed.testing;
+ if (measurement === null) return S.download.speed.skipped;
+ if (!measurement.reachable) return S.download.speed.unreachable;
+ if (measurement.bytesPerSecond <= 0) return S.download.speed.belowFloor;
+ return formatSpeed(measurement.bytesPerSecond);
+}
+
+function filledSignalBars(
+ measurement: Measurement | null,
+ testing: boolean,
+ selected: boolean,
+): number {
+ if (testing) return 2;
+ if (!measurement || !measurement.reachable) return selected ? 2 : 1;
+ if (measurement.bytesPerSecond <= 0) return 1;
+ return Math.min(4, Math.max(1, Math.round(Math.log2(measurement.bytesPerSecond / 65536) + 1)));
+}
+
+const SIGNAL_HEIGHTS = [4, 7, 10, 13] as const;
+
+function SourceSpeedButton({
+ title,
+ measurement,
+ testing,
+ selected,
+ onSelect,
+}: {
+ title: string;
+ measurement: Measurement | null;
+ testing: boolean;
+ selected: boolean;
+ onSelect: () => void;
+}) {
+ const filled = filledSignalBars(measurement, testing, selected);
+ return (
+ <button
+ type="button"
+ aria-pressed={selected}
+ onClick={onSelect}
+ className={`flex min-w-0 items-center justify-between gap-2 rounded-lg border px-3 py-2 text-left transition-colors ${
+ selected
+ ? "border-brand-400 bg-brand-50/70 dark:border-brand-700 dark:bg-brand-950/50"
+ : "border-gray-200 bg-white hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-900 dark:hover:border-gray-700 dark:hover:bg-gray-800"
+ }`}
+ >
+ <div className="min-w-0">
+ <span className="flex items-center gap-1.5 truncate text-xs font-semibold tracking-tight sm:text-sm">
+ {title}
+ {selected && (
+ <CheckIcon className="h-3 w-3 shrink-0 text-brand-600 dark:text-brand-300" />
+ )}
+ </span>
+ <span className="mt-0.5 block font-mono text-[11px] text-gray-500 tabular-nums dark:text-gray-400">
+ {speedText(measurement, testing)}
+ </span>
+ </div>
+ <span className="flex h-4 shrink-0 items-end gap-0.5" aria-hidden="true">
+ {SIGNAL_HEIGHTS.map((height, index) => (
+ <span
+ key={height}
+ className={`w-1 rounded-[1px] ${testing ? "animate-pulse" : ""} ${
+ index < filled
+ ? selected
+ ? "bg-brand-500 dark:bg-brand-400"
+ : "bg-gray-500 dark:bg-gray-400"
+ : "bg-gray-200 dark:bg-gray-800"
+ }`}
+ style={{ height: `${height}px`, animationDelay: `${index * 55}ms` }}
+ />
+ ))}
+ </span>
+ </button>
+ );
+}
+
export function DownloadPage() {
const [mirror, setMirror] = useState<Mirror | null>(null);
- /** null until the reachability pass ends — the only thing the buttons wait on. */
const [source, setSource] = useState<DownloadSource | null>(null);
- /** True while the throughput pass is still running behind the live buttons. */
+ const [report, setReport] = useState<DownloadProbeReport | null>(null);
const [refining, setRefining] = useState(false);
- /** The visitor's own choice, which outranks both passes for the rest of the visit. */
const [override, setOverride] = useState<DownloadSource | null>(null);
+
useEffect(() => {
let cancelled = false;
- // The pointer starts now and is handed to the gate still in flight: the gate only needs it on
- // the path where GitHub stayed silent, and the buttons should not wait on it otherwise.
const mirrorPromise = fetchMirror(createDeadline(MIRROR_POINTER_MS));
void mirrorPromise.then((resolved) => {
if (!cancelled) setMirror(resolved);
@@ -100,9 +192,15 @@ export function DownloadPage() {
const resolved = await mirrorPromise;
if (cancelled || !worthRefining(resolved) || !resolved) return;
setRefining(true);
- const refined = await refineDownloadSource(resolved, createDeadline(THROUGHPUT_BUDGET_MS));
+ const refined = await refineDownloadSourceWithReport(
+ resolved,
+ createDeadline(THROUGHPUT_BUDGET_MS),
+ );
if (cancelled) return;
- setSource(refined);
+ if (refined) {
+ setSource(refined.source);
+ setReport(refined);
+ }
setRefining(false);
})();
return () => {
@@ -113,97 +211,123 @@ export function DownloadPage() {
const detected = detectPlatform();
const probing = source === null;
const selected: DownloadSource = override ?? source ?? "github";
- const viaMirror = mirror !== null && selected === "oss";
+ const availableMirror = mirror ?? RELEASE_MIRROR;
+ const awaitingAutomaticSource = probing && override === null;
+ const viaMirror = selected === "oss";
const hrefFor = (file: string) =>
- viaMirror ? `${mirror.base}/${file}` : `${GITHUB_LATEST_DOWNLOAD}/${file}`;
-
+ viaMirror ? `${availableMirror.base}/${file}` : `${GITHUB_LATEST_DOWNLOAD}/${file}`;
const textLink =
"inline-flex items-center gap-1 text-brand-700 underline decoration-brand-300 underline-offset-2 transition-colors hover:text-brand-600 dark:text-brand-300 dark:decoration-brand-700";
return (
- <Section eyebrow={S.download.eyebrow} title={S.download.title} subtitle={S.download.subtitle}>
- <div className="mx-auto grid max-w-4xl gap-4 sm:grid-cols-3">
- {PLATFORMS.map((platform) => (
- <div
- key={platform}
- className={`flex flex-col rounded-xl border bg-white p-5 dark:bg-gray-900 ${
- detected === platform
- ? "border-brand-500 ring-1 ring-brand-500"
- : "border-gray-200 dark:border-gray-800"
- }`}
- >
- <div className="flex items-center justify-between">
- <h3 className="text-base font-semibold tracking-tight">
- {S.download.platforms[platform].name}
- </h3>
- {detected === platform && (
- <span className="rounded-full bg-brand-600/10 px-2 py-0.5 text-xs font-medium text-brand-700 dark:text-brand-300">
- {S.download.recommended}
- </span>
- )}
- </div>
- <p className="mt-1 mb-4 text-xs leading-5 text-gray-500 dark:text-gray-400">
- {S.download.platforms[platform].require}
- </p>
- <div className="mt-auto flex flex-col gap-2">
- {DESKTOP_INSTALLERS[platform].map(({ file, variant }) => (
- <a
- key={file}
- // No href while probing: an anchor without one is not a link, which is exactly
- // the state this is in — the source is not decided yet. The label and the box
- // keep their size, so nothing shifts under the pointer when it resolves.
- href={probing ? undefined : hrefFor(file)}
- aria-disabled={probing || undefined}
- className={`inline-flex items-center justify-center gap-1.5 rounded-md px-3.5 py-2 text-sm font-medium transition-colors ${
- probing
- ? "cursor-progress bg-gray-200 text-gray-500 dark:bg-gray-800 dark:text-gray-500"
- : "bg-gray-900 text-white hover:bg-gray-700 dark:bg-gray-100 dark:text-gray-900 dark:hover:bg-gray-300"
- }`}
+ <Section eyebrow={S.download.eyebrow} title={S.download.title} className="pt-14 sm:pt-20">
+ <div className="mx-auto grid max-w-5xl gap-4 sm:grid-cols-3">
+ {PLATFORMS.map((platform) => {
+ const PlatformIcon = PLATFORM_ICONS[platform];
+ const recommended = detected === platform;
+ return (
+ <article
+ key={platform}
+ className={`flex min-w-0 flex-col rounded-2xl border bg-white p-5 shadow-sm dark:bg-gray-900 ${
+ recommended
+ ? "border-brand-500 ring-1 ring-brand-500"
+ : "border-gray-200 dark:border-gray-800"
+ }`}
+ >
+ <div className="flex items-start justify-between gap-3">
+ <span
+ className={`inline-flex h-12 w-12 items-center justify-center rounded-xl ${PLATFORM_ICON_CLASSES[platform]}`}
>
- {probing ? (
- <SpinnerIcon className="h-4 w-4 animate-spin" />
- ) : (
- <DownloadIcon className="h-4 w-4" />
+ <PlatformIcon className="h-7 w-7" />
+ </span>
+ <div className="flex flex-wrap justify-end gap-1.5">
+ {recommended && (
+ <span className="rounded-full bg-brand-600/10 px-2 py-0.5 text-xs font-medium text-brand-700 dark:text-brand-300">
+ {S.download.recommended}
+ </span>
)}
- {variant}
- </a>
- ))}
- </div>
- </div>
- ))}
+ <span className="rounded-full bg-gray-100 px-2 py-0.5 text-xs font-medium text-gray-600 tabular-nums dark:bg-gray-800 dark:text-gray-300">
+ {RELEASE_VERSION}
+ </span>
+ </div>
+ </div>
+ <h3 className="mt-5 text-lg font-semibold tracking-tight">
+ {S.download.platforms[platform].name}
+ </h3>
+ <p className="mt-1 mb-5 min-h-10 text-xs leading-5 text-gray-500 dark:text-gray-400">
+ {S.download.platforms[platform].require}
+ </p>
+ <div className="mt-auto flex flex-col gap-2">
+ {DESKTOP_INSTALLERS[platform].map(({ file, variant }) => (
+ <a
+ key={file}
+ href={awaitingAutomaticSource ? undefined : hrefFor(file)}
+ aria-disabled={awaitingAutomaticSource || undefined}
+ className={`inline-flex w-full items-center justify-center gap-1.5 rounded-lg px-3.5 py-2.5 text-sm font-medium transition-colors ${
+ awaitingAutomaticSource
+ ? "cursor-progress bg-gray-200 text-gray-500 dark:bg-gray-800 dark:text-gray-500"
+ : "bg-gray-900 text-white hover:bg-gray-700 dark:bg-gray-100 dark:text-gray-900 dark:hover:bg-white"
+ }`}
+ >
+ {awaitingAutomaticSource ? (
+ <SpinnerIcon className="h-4 w-4 animate-spin" />
+ ) : (
+ <DownloadIcon className="h-4 w-4" />
+ )}
+ <span>{variant}</span>
+ <span className="rounded bg-white/10 px-1.5 py-0.5 text-[10px] font-semibold">
+ {installerSuffix(file)}
+ </span>
+ </a>
+ ))}
+ </div>
+ </article>
+ );
+ })}
</div>
- <div className="mx-auto mt-8 max-w-4xl text-center text-sm text-gray-600 dark:text-gray-400">
- <p aria-live="polite">
- {probing ? (
- <span className="inline-flex items-center gap-1.5">
- <SpinnerIcon className="h-3.5 w-3.5 animate-spin" />
- {S.download.statusProbing}
+ <section
+ className="mx-auto mt-7 max-w-4xl rounded-xl border border-gray-200 bg-gray-50/80 p-2.5 dark:border-gray-800 dark:bg-gray-950/70"
+ title={S.download.speed.subtitle}
+ >
+ <div className="flex items-center justify-between gap-3 px-0.5">
+ <h3 className="text-sm font-semibold tracking-tight">{S.download.speed.title}</h3>
+ <span className="inline-flex min-w-0 items-center gap-1.5 text-[11px] text-gray-500 dark:text-gray-400">
+ {(probing || refining) && <SpinnerIcon className="h-3 w-3 shrink-0 animate-spin" />}
+ <span className="truncate">
+ {selected === "oss" ? S.download.speed.oss : S.download.speed.github} ·{" "}
+ {override ? S.download.speed.manual : S.download.speed.automatic}
</span>
- ) : (
- <>
- {viaMirror ? S.download.statusOss(mirror.tag) : S.download.statusGithub}{" "}
- {refining && (
- <>
- <span className="inline-flex items-center gap-1.5 text-gray-500 dark:text-gray-500">
- <SpinnerIcon className="h-3.5 w-3.5 animate-spin" />
- {S.download.statusRefining}
- </span>{" "}
- </>
- )}
- {mirror !== null && (
- <button
- type="button"
- className={textLink}
- onClick={() => setOverride(viaMirror ? "github" : "oss")}
- >
- {viaMirror ? S.download.altGithub : S.download.altOss}
- </button>
- )}
- </>
- )}
+ </span>
+ </div>
+
+ <div className="mt-2 grid grid-cols-2 gap-2">
+ <SourceSpeedButton
+ title={S.download.speed.github}
+ measurement={report?.github ?? null}
+ testing={probing || refining}
+ selected={selected === "github"}
+ onSelect={() => setOverride("github")}
+ />
+ <SourceSpeedButton
+ title={S.download.speed.oss}
+ measurement={report?.oss ?? null}
+ testing={probing || refining}
+ selected={selected === "oss"}
+ onSelect={() => setOverride("oss")}
+ />
+ </div>
+ </section>
+
+ <div className="mx-auto mt-4 max-w-5xl text-center text-sm text-gray-600 dark:text-gray-400">
+ <p className="sr-only" aria-live="polite">
+ {probing
+ ? S.download.statusProbing
+ : viaMirror
+ ? S.download.statusOss(availableMirror.tag)
+ : S.download.statusGithub}
</p>
- <p className="mt-2">
+ <p>
<a href={hrefFor(DESKTOP_SHA256SUMS)} className={textLink}>
{S.download.checksums}
</a>
@@ -215,7 +339,7 @@ export function DownloadPage() {
</p>
</div>
- <div className="mx-auto mt-12 max-w-2xl">
+ <div className="mx-auto mt-14 max-w-3xl">
<h3 className="text-center text-base font-semibold tracking-tight">
{S.download.faq.title}
</h3>
@@ -248,7 +372,7 @@ export function DownloadPage() {
<div className="mx-auto mt-10 max-w-4xl text-center">
<p className="text-xs leading-5 text-gray-500 dark:text-gray-400">
{S.download.cliHint}{" "}
- <Link to="/#quickstart" className={textLink}>
+ <Link to="/#quickstart-install" className={textLink}>
{S.download.cliHintLink}
</Link>
</p>
diff --git a/packages/landing/src/pages/home.tsx b/packages/landing/src/pages/home.tsx
index cf83f8a4..ee9b0c3e 100644
--- a/packages/landing/src/pages/home.tsx
+++ b/packages/landing/src/pages/home.tsx
@@ -1,10 +1,10 @@
-/** Home: section composition, ordered to match the nav anchors. */
+/** Home: preserve the full product story, with the one-sentence build demo first. */
import { Hero } from "../sections/hero";
+import { Cases } from "../sections/cases";
import { Pillars } from "../sections/pillars";
import { Compare } from "../sections/compare";
import { SelfImprove } from "../sections/self-improve";
import { Quickstart } from "../sections/quickstart";
-import { Cases } from "../sections/cases";
import { Scenarios } from "../sections/scenarios";
import { Benchmark } from "../sections/benchmark";
import { Contract } from "../sections/contract";
@@ -18,11 +18,11 @@ export function HomePage() {
return (
<>
<Hero />
+ <Cases />
<Pillars />
<Compare />
<SelfImprove />
<Quickstart />
- <Cases />
<Scenarios />
<Benchmark />
<Contract />
diff --git a/packages/landing/src/sections/compare.tsx b/packages/landing/src/sections/compare.tsx
index 5e5f665a..27013011 100644
--- a/packages/landing/src/sections/compare.tsx
+++ b/packages/landing/src/sections/compare.tsx
@@ -5,7 +5,7 @@
* PenguinHarness side raises a whole skyline almost instantly and holds it.
* Reduced-motion users see both skylines complete.
*/
-import type { CSSProperties, ReactNode } from "react";
+import { useEffect, useState, type CSSProperties, type ReactNode } from "react";
import { S } from "../lib/strings";
import { Section } from "../components/section";
@@ -23,7 +23,7 @@ function Block({
return (
<span
className={`anim-block rounded-[3px] ${className}`}
- style={{ "--cycle": `${CYCLE_S}s`, animationDelay: `${delay - CYCLE_S}s` } as CSSProperties}
+ style={{ "--land-delay": `${delay}s` } as CSSProperties}
/>
);
}
@@ -106,6 +106,15 @@ function CompareCard({
}
export function Compare() {
+ const [cycle, setCycle] = useState(0);
+
+ // Remount both skylines together: every child begins hidden, then lands once
+ // at its positive delay. A shared reset keeps the 1x/100x pace comparison aligned.
+ useEffect(() => {
+ const timer = window.setInterval(() => setCycle((value) => value + 1), CYCLE_S * 1000);
+ return () => window.clearInterval(timer);
+ }, []);
+
return (
<Section
id="compare"
@@ -115,10 +124,10 @@ export function Compare() {
>
<div className="mx-auto grid max-w-4xl gap-5 sm:grid-cols-2">
<CompareCard {...S.compare.langchain}>
- <SlowBuild />
+ <SlowBuild key={`slow-${cycle}`} />
</CompareCard>
<CompareCard {...S.compare.penguin} emphasized>
- <FastBuild />
+ <FastBuild key={`fast-${cycle}`} />
</CompareCard>
</div>
</Section>
diff --git a/packages/landing/src/sections/features.tsx b/packages/landing/src/sections/features.tsx
index 0d8fdf86..db8c87e1 100644
--- a/packages/landing/src/sections/features.tsx
+++ b/packages/landing/src/sections/features.tsx
@@ -1,8 +1,6 @@
/**
- * Feature section in two layers: the three features with real captures
- * (multi-session chat, trace view, agent evaluation) form switchable tabs whose
- * active panel embeds the locale/theme-matched screenshot; the remaining
- * features sit below as a plain card grid, closed by an "and more…" card.
+ * Feature section in two layers: the three features with real captures form
+ * switchable tabs, while the remaining capabilities stay visible in a card grid.
*/
import { useState } from "react";
import { S } from "../lib/strings";
@@ -78,28 +76,26 @@ function ThemedShot({ set, alt }: { set: ShotSet; alt: string }) {
);
}
-/** Icon order matches S.features.items. */
-const ICONS = [
- MessageSquareIcon,
- BotIcon,
- SparklesIcon,
- ClockIcon,
- ShareIcon,
- PieChartIcon,
- ActivityIcon,
- BarChartIcon,
- UsersIcon,
-];
-
/** Item indexes with a real capture, in tab order. */
-const SHOT_TABS: Array<{ index: number; shot: keyof typeof SHOTS }> = [
- { index: 0, shot: "chat" },
- { index: 6, shot: "traces" },
- { index: 7, shot: "benchmark" },
+const SHOT_TABS: Array<{
+ index: number;
+ shot: keyof typeof SHOTS;
+ icon: typeof MessageSquareIcon;
+}> = [
+ { index: 0, shot: "chat", icon: MessageSquareIcon },
+ { index: 6, shot: "traces", icon: ActivityIcon },
+ { index: 7, shot: "benchmark", icon: BarChartIcon },
];
-/** The rest of the grid, in the original item order. */
-const PLAIN_INDEXES = [1, 2, 3, 4, 5, 8];
+/** Capabilities without a dedicated screenshot, in the source-copy order. */
+const PLAIN_FEATURES = [
+ { index: 1, icon: BotIcon },
+ { index: 2, icon: SparklesIcon },
+ { index: 3, icon: ClockIcon },
+ { index: 4, icon: ShareIcon },
+ { index: 5, icon: PieChartIcon },
+ { index: 8, icon: UsersIcon },
+];
export function Features() {
const [active, setActive] = useState(0);
@@ -120,7 +116,7 @@ export function Features() {
>
{SHOT_TABS.map((t, i) => {
const tabItem = S.features.items[t.index]!;
- const TabIcon = ICONS[t.index] ?? SparklesIcon;
+ const TabIcon = t.icon;
const activeTab = i === active;
return (
<button
@@ -152,24 +148,21 @@ export function Features() {
</BrowserFrame>
</div>
- {/* Features without a capture: the classic card grid, closed by "and more…". */}
<div className="mt-10 grid gap-5 sm:grid-cols-2 lg:grid-cols-3">
- {PLAIN_INDEXES.map((index) => {
- const plain = S.features.items[index]!;
- const IconCmp = ICONS[index] ?? SparklesIcon;
+ {PLAIN_FEATURES.map(({ index, icon: Icon }) => {
+ const feature = S.features.items[index]!;
return (
<article
- key={plain.title}
+ key={feature.title}
className="relative overflow-hidden rounded-xl border border-gray-200 bg-white p-5 transition-colors hover:border-gray-300 dark:border-gray-800 dark:bg-gray-900 dark:hover:border-gray-700"
>
- {/* Oversized faint icon as the card backdrop (decorative). */}
- <IconCmp
+ <Icon
strokeWidth={1.25}
className="pointer-events-none absolute -right-5 -bottom-5 h-26 w-26 text-gray-100 dark:text-gray-800"
/>
- <h3 className="relative text-[15px] font-semibold tracking-tight">{plain.title}</h3>
+ <h3 className="relative text-[15px] font-semibold tracking-tight">{feature.title}</h3>
<p className="relative mt-2 text-sm leading-6 text-gray-600 dark:text-gray-400">
- {plain.desc}
+ {feature.desc}
</p>
</article>
);
diff --git a/packages/landing/src/sections/hero.tsx b/packages/landing/src/sections/hero.tsx
index b8b4c84b..1ec413c2 100644
--- a/packages/landing/src/sections/hero.tsx
+++ b/packages/landing/src/sections/hero.tsx
@@ -1,145 +1,117 @@
-/**
- * Hero: enlarged logo + product name, the one-line headline whose rotating word
- * crossfades through a gaussian blur (Desktop <-> Server, localized per dictionary),
- * the desktop-first CTAs — a platform-aware download button pointing at /download
- * (artifact resolution stays on that page), an all-platforms line and a link down to
- * the quick start for CLI / self-hosted installs — and stats.
- * The rotating word is a stacked inline-grid so line width never jumps.
- */
-import { useEffect, useState } from "react";
+/** Product-first hero with two direct installation paths. */
import { Link } from "react-router";
import { S } from "../lib/strings";
-import { REPO_URL } from "../lib/links";
-import { detectPlatform } from "../lib/platform";
-import { ArrowRightIcon, DownloadIcon, GitHubIcon } from "../components/icons";
+import { RELEASE_VERSION } from "../lib/version";
+import { DownloadIcon, ModelProviderLogo, TerminalIcon } from "../components/icons";
-const ROTATE_MS = 2600;
-
-function RotatingWord({ words }: { words: string[] }) {
- const [active, setActive] = useState(0);
- useEffect(() => {
- if (words.length < 2) return;
- const timer = setInterval(() => setActive((i) => (i + 1) % words.length), ROTATE_MS);
- return () => clearInterval(timer);
- }, [words.length]);
- return (
- <span className="inline-grid justify-items-center align-bottom">
- {words.map((word, i) => (
- <span
- key={word}
- aria-hidden={i !== active}
- className={`col-start-1 row-start-1 text-brand-600 transition-[opacity,filter] duration-500 dark:text-brand-300 ${
- i === active ? "opacity-100 blur-none" : "opacity-0 blur-[6px]"
- }`}
- >
- {word}
- </span>
- ))}
- </span>
- );
-}
+const MODEL_PROVIDERS = [
+ "openai",
+ "anthropic",
+ "gemini",
+ "deepseek",
+ "zai",
+ "moonshot",
+ "qwen",
+ "openrouter",
+] as const;
export function Hero() {
- // Platform-aware label only; every link goes to /download, where the platform
- // cards and the GitHub/OSS artifact resolution live.
- const detected = detectPlatform();
- const downloadLabel = detected
- ? S.hero.downloadCtaFor(S.download.platforms[detected].name)
- : S.hero.downloadCta;
- const textLink =
- "inline-flex items-center gap-1 text-brand-700 underline decoration-brand-300 underline-offset-2 transition-colors hover:text-brand-600 dark:text-brand-300 dark:decoration-brand-700";
-
return (
<section className="relative overflow-hidden">
<div className="hero-dots pointer-events-none absolute inset-0" aria-hidden="true" />
- <div className="relative mx-auto max-w-6xl px-4 pt-16 pb-16 text-center sm:px-6 sm:pt-24 sm:pb-20">
- <div className="anim-rise flex items-center justify-center gap-3.5">
+ <div className="relative mx-auto max-w-6xl px-4 pt-16 pb-12 text-center sm:px-6 sm:pt-24 sm:pb-14">
+ <h1 className="anim-rise flex items-center justify-center gap-3.5">
<img
src={`${import.meta.env.BASE_URL}penguin-logo.svg`}
alt=""
className="h-14 w-14 sm:h-16 sm:w-16"
/>
<span className="text-3xl font-semibold tracking-tight sm:text-4xl">{S.siteName}</span>
- </div>
- {/* No text-balance: balance may break inside the breakable prefix ("…Agent /
- Builder…"); greedy wrapping + the nowrap span pins the desktop break to
- "Your Automated Agent Builder, / Right on Your Desktop". */}
- <h1
- className="anim-rise mx-auto mt-6 max-w-full text-3xl font-semibold tracking-tight sm:text-5xl"
- style={{ animationDelay: "80ms" }}
- >
- {S.hero.titlePrefix}
- <span className="whitespace-nowrap">
- {S.hero.titleNoWrap}
- <RotatingWord words={S.hero.titleWords} />
- {S.hero.titleSuffix}
- </span>
</h1>
<p
- className="anim-rise mt-6 text-base font-medium text-gray-600 sm:text-lg dark:text-gray-300"
- style={{ animationDelay: "140ms" }}
+ className="hero-positioning anim-rise mx-auto mt-6 whitespace-nowrap leading-tight font-semibold tracking-[-0.035em]"
+ style={{ animationDelay: "70ms" }}
>
- {S.hero.subtitle}
+ {S.hero.platformLead}
+ <span className="text-brand-600 dark:text-brand-300">{S.hero.platformAccent}</span>
+ {S.hero.platformTail}
+ </p>
+
+ <p
+ className="hero-automation anim-rise mt-5 leading-8 text-gray-600 dark:text-gray-300"
+ style={{ animationDelay: "120ms" }}
+ >
+ {S.hero.automationLead}
+ {S.hero.automationActions.map((action, index) => (
+ <span key={action}>
+ {index > 0 && <span className="font-normal"> · </span>}
+ <strong className="font-semibold text-gray-900 dark:text-gray-100">{action}</strong>
+ </span>
+ ))}{" "}
+ {S.hero.automationTail}
</p>
<div
- className="anim-rise mt-8 flex flex-wrap items-center justify-center gap-3"
- style={{ animationDelay: "200ms" }}
+ className="anim-rise mt-7 flex flex-wrap items-center justify-center gap-3"
+ style={{ animationDelay: "170ms" }}
>
<Link
to="/download"
- className="inline-flex h-11 items-center gap-2 rounded-lg bg-gray-900 px-5 text-sm font-medium text-white transition-colors hover:bg-gray-700 dark:bg-gray-100 dark:text-gray-900 dark:hover:bg-white"
+ className="inline-flex h-11 items-center justify-center gap-2 whitespace-nowrap rounded-lg bg-gray-900 px-5 text-sm font-semibold text-white shadow-sm transition-colors hover:bg-gray-700 dark:bg-gray-100 dark:text-gray-900 dark:hover:bg-white"
>
<DownloadIcon className="h-4 w-4" />
- {downloadLabel}
+ <span>{S.hero.downloadCta}</span>
+ <span className="border-l border-white/25 pl-2 text-xs font-medium text-white/70 tabular-nums dark:border-gray-900/20 dark:text-gray-900/60">
+ {RELEASE_VERSION}
+ </span>
</Link>
<Link
- to="/#quickstart"
- className="inline-flex h-11 items-center gap-2 rounded-lg border border-gray-200 bg-white px-5 text-sm font-medium text-gray-900 transition-colors hover:bg-gray-50 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100 dark:hover:bg-gray-800"
+ to="/#quickstart-install"
+ className="inline-flex h-11 items-center justify-center gap-2 whitespace-nowrap rounded-lg border border-gray-200 bg-white px-5 text-sm font-semibold text-gray-900 shadow-sm transition-colors hover:bg-gray-50 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100 dark:hover:bg-gray-800"
>
- {S.hero.ctaQuickstart}
- <ArrowRightIcon className="h-4 w-4" />
+ <TerminalIcon className="h-4 w-4" />
+ {S.hero.cliInstall}
</Link>
- <a
- href={REPO_URL}
- target="_blank"
- rel="noreferrer"
- className="inline-flex h-11 items-center gap-2 rounded-lg border border-gray-200 bg-white px-5 text-sm font-medium text-gray-900 transition-colors hover:bg-gray-50 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100 dark:hover:bg-gray-800"
- >
- <GitHubIcon className="h-4 w-4" />
- {S.hero.ctaGithub}
- </a>
</div>
- <p
- className="anim-rise mt-5 text-sm text-gray-600 dark:text-gray-400"
- style={{ animationDelay: "240ms" }}
- >
- <Link to="/download" className={textLink}>
- {S.hero.downloadAll}
- </Link>
- <span className="mx-2 text-gray-300 dark:text-gray-700">·</span>
- <Link to="/#quickstart" className={textLink}>
- {S.hero.cliAlt}
- </Link>
- </p>
-
<dl
- className="anim-rise mx-auto mt-12 grid max-w-3xl grid-cols-2 gap-x-6 gap-y-8 sm:grid-cols-4"
- style={{ animationDelay: "280ms" }}
+ className="anim-rise mx-auto mt-12 grid max-w-5xl grid-cols-2 gap-x-6 gap-y-8 sm:grid-cols-4"
+ style={{ animationDelay: "250ms" }}
>
- {S.hero.stats.map((s) => (
- <div key={s.label}>
- <dt className="order-last mt-1 text-xs text-gray-500 dark:text-gray-400">
- {s.label}
+ {S.hero.stats.map((stat) => (
+ <div key={stat.value} className="min-w-0">
+ <dt className="mt-1 text-xs leading-5 text-gray-500 dark:text-gray-400">
+ {stat.label}
</dt>
- <dd className="text-2xl font-semibold tracking-tight text-gray-900 dark:text-gray-100">
- {s.value}
+ <dd className="whitespace-nowrap text-2xl font-semibold tracking-tight text-gray-900 dark:text-gray-100">
+ {stat.value}
</dd>
</div>
))}
</dl>
+
+ <div
+ className="anim-rise mx-auto mt-12 flex max-w-5xl flex-wrap items-center justify-center gap-x-6 gap-y-4 text-center text-sm"
+ style={{ animationDelay: "300ms" }}
+ >
+ <span className="mr-1 text-xs font-semibold tracking-wide text-gray-400 uppercase dark:text-gray-500">
+ {S.hero.supportedModelsLabel}
+ </span>
+ {MODEL_PROVIDERS.map((provider, index) => (
+ <span
+ key={provider}
+ aria-label={S.hero.supportedModels[index]}
+ title={S.hero.supportedModels[index]}
+ className="inline-flex items-center text-gray-700 dark:text-gray-300"
+ >
+ <ModelProviderLogo provider={provider} className="h-6 w-6" />
+ </span>
+ ))}
+ <span className="whitespace-nowrap font-medium text-gray-400 dark:text-gray-500">
+ {S.hero.supportedModelsMore}
+ </span>
+ </div>
</div>
</section>
);
diff --git a/packages/landing/src/sections/quickstart.tsx b/packages/landing/src/sections/quickstart.tsx
index eb8a61ac..10e0a25a 100644
--- a/packages/landing/src/sections/quickstart.tsx
+++ b/packages/landing/src/sections/quickstart.tsx
@@ -1,99 +1,106 @@
-/**
- * Quick start: install, then a Web UI / CLI tab pair (Web is the default and never
- * touches the command line beyond `penguin web` — models are configured inside the
- * interface). API-key console links open in a new tab. Localized commands live in
- * the string dictionaries.
- */
-import { useState } from "react";
-import { Link } from "react-router";
+/** Two-step quick start: choose installation first, then a launch mode for CLI installs. */
+import { useEffect, useState } from "react";
+import { Link, useLocation } from "react-router";
import type { ReactNode } from "react";
import { S } from "../lib/strings";
import {
- DEEPSEEK_KEYS_URL,
+ CLI_INSTALLERS,
+ GITHUB_LATEST_DOWNLOAD,
INSTALL_CMD,
INSTALL_CMD_WINDOWS,
OFFLINE_INSTALL_CMDS,
- OPENROUTER_KEYS_URL,
- RELEASES_URL,
} from "../lib/links";
import { Section } from "../components/section";
import { CodeCard } from "../components/code-card";
import {
+ ArrowRightIcon,
DownloadIcon,
- ExternalLinkIcon,
MonitorIcon,
PlayIcon,
- SlidersIcon,
TerminalIcon,
} from "../components/icons";
-function Step({
- index,
- icon,
- title,
- desc,
- children,
-}: {
- index: number;
- icon: ReactNode;
- title: string;
- desc: string;
- children?: ReactNode;
-}) {
+type InstallMethod = "desktop" | "install";
+type LaunchMode = "web" | "cli";
+type InstallOs = "linux" | "macos" | "windows";
+
+const INSTALL_METHODS: Array<{ id: InstallMethod; icon: typeof DownloadIcon }> = [
+ { id: "desktop", icon: DownloadIcon },
+ { id: "install", icon: TerminalIcon },
+];
+
+const LAUNCH_MODES: Array<{ id: LaunchMode; icon: typeof MonitorIcon }> = [
+ { id: "web", icon: MonitorIcon },
+ { id: "cli", icon: PlayIcon },
+];
+
+function NumberedItem({ index, children }: { index: number; children: ReactNode }) {
return (
- <li className="relative pl-12 sm:pl-14">
- <span className="absolute top-0 left-0 inline-flex h-9 w-9 items-center justify-center rounded-lg border border-gray-200 bg-white text-gray-700 sm:h-10 sm:w-10 dark:border-gray-800 dark:bg-gray-900 dark:text-gray-300">
- {icon}
+ <li className="flex gap-3 text-sm leading-6 text-gray-600 dark:text-gray-300">
+ <span className="mt-0.5 inline-flex h-5 w-5 shrink-0 items-center justify-center rounded-full bg-gray-900 text-[11px] font-semibold text-white dark:bg-gray-100 dark:text-gray-900">
+ {index}
</span>
- <h3 className="text-base font-semibold tracking-tight">
- <span className="mr-2 text-gray-400 tabular-nums dark:text-gray-500">{index}.</span>
- {title}
- </h3>
- <p className="mt-1 text-sm leading-6 text-gray-600 dark:text-gray-400">{desc}</p>
- {children && <div className="mt-3">{children}</div>}
+ <span>{children}</span>
</li>
);
}
-/** API-key console links (open in a new tab). */
-function KeyLinks() {
- const link =
- "inline-flex items-center gap-1 text-brand-700 underline decoration-brand-300 underline-offset-2 transition-colors hover:text-brand-600 dark:text-brand-300 dark:decoration-brand-700";
+function StepHeading({ step, title }: { step: string; title: string }) {
return (
- <p className="mt-2 text-xs leading-5 text-gray-500 dark:text-gray-400">
- {S.quickstart.getKeyPrefix}
- <a href={DEEPSEEK_KEYS_URL} target="_blank" rel="noreferrer" className={link}>
- {S.quickstart.getDeepseekKey}
- <ExternalLinkIcon className="h-3 w-3" />
- </a>
- <span className="mx-1.5">·</span>
- <a href={OPENROUTER_KEYS_URL} target="_blank" rel="noreferrer" className={link}>
- {S.quickstart.getOpenrouterKey}
- <ExternalLinkIcon className="h-3 w-3" />
- </a>
- </p>
+ <div className="mb-4 flex items-center gap-3">
+ <span className="text-xs font-semibold tracking-wide text-brand-600 uppercase dark:text-brand-300">
+ {step}
+ </span>
+ <h3 className="text-lg font-semibold tracking-tight">{title}</h3>
+ </div>
);
}
export function Quickstart() {
- const [mode, setMode] = useState<"web" | "cli">("web");
- const [provider, setProvider] = useState<"deepseek" | "openrouter">("deepseek");
- const [os, setOs] = useState<"linux" | "macos" | "windows">("linux");
- const [method, setMethod] = useState<"online" | "offline">("online");
+ const { hash } = useLocation();
+ const [method, setMethod] = useState<InstallMethod>("desktop");
+ const [launchMode, setLaunchMode] = useState<LaunchMode>("web");
+ const [os, setOs] = useState<InstallOs>("linux");
- const modeBtn = (active: boolean) =>
- `inline-flex items-center gap-1.5 rounded-md px-3.5 py-1.5 text-sm font-medium transition-colors ${
+ useEffect(() => {
+ const requested = hash.replace("#quickstart-", "");
+ if (requested === "desktop") {
+ setMethod("desktop");
+ return;
+ }
+ if (requested === "install") {
+ setMethod("install");
+ return;
+ }
+ if (requested === "web" || requested === "cli") {
+ setMethod("install");
+ setLaunchMode(requested);
+ }
+ }, [hash]);
+
+ const installLabel: Record<InstallMethod, string> = {
+ desktop: S.quickstart.tabs.desktop,
+ install: S.quickstart.tabs.install,
+ };
+ const launchLabel: Record<LaunchMode, string> = {
+ web: S.quickstart.tabs.web,
+ cli: S.quickstart.tabs.cli,
+ };
+ const choiceBtn = (active: boolean) =>
+ `inline-flex min-h-11 items-center justify-center gap-2 rounded-lg px-4 py-2.5 text-sm font-medium transition-colors ${
active
- ? "bg-gray-900 text-white dark:bg-gray-100 dark:text-gray-900"
+ ? "bg-gray-900 text-white shadow-sm dark:bg-gray-100 dark:text-gray-900"
: "text-gray-600 hover:bg-gray-100 dark:text-gray-400 dark:hover:bg-gray-800"
}`;
- const providerBtn = (active: boolean) =>
- `rounded-md px-3 py-1.5 text-sm font-medium transition-colors ${
+ const osBtn = (active: boolean) =>
+ `rounded-md px-3 py-1.5 text-xs font-medium transition-colors ${
active
? "bg-gray-900 text-white dark:bg-gray-100 dark:text-gray-900"
: "text-gray-600 hover:bg-gray-100 dark:text-gray-400 dark:hover:bg-gray-800"
}`;
+ const installCommand = os === "windows" ? INSTALL_CMD_WINDOWS : INSTALL_CMD;
+
return (
<Section
id="quickstart"
@@ -101,197 +108,211 @@ export function Quickstart() {
title={S.quickstart.title}
subtitle={S.quickstart.subtitle}
>
- <div className="mx-auto max-w-3xl">
+ <div className="mx-auto max-w-4xl">
+ <StepHeading step={S.quickstart.stepOne} title={S.quickstart.chooseInstall} />
<div
- className="mb-8 flex justify-center gap-1 rounded-lg border border-gray-200 bg-white p-1 sm:mx-auto sm:w-fit dark:border-gray-800 dark:bg-gray-900"
+ className="grid grid-cols-2 gap-1 rounded-xl border border-gray-200 bg-white p-1 dark:border-gray-800 dark:bg-gray-900"
role="tablist"
+ aria-label={S.quickstart.chooseInstall}
>
- <button
- type="button"
- role="tab"
- aria-selected={mode === "web"}
- className={modeBtn(mode === "web")}
- onClick={() => setMode("web")}
- >
- <MonitorIcon className="h-4 w-4" />
- {S.quickstart.tabWeb}
- </button>
- <button
- type="button"
- role="tab"
- aria-selected={mode === "cli"}
- className={modeBtn(mode === "cli")}
- onClick={() => setMode("cli")}
- >
- <TerminalIcon className="h-4 w-4" />
- {S.quickstart.tabCli}
- </button>
+ {INSTALL_METHODS.map(({ id, icon: Icon }) => (
+ <button
+ key={id}
+ id={`quickstart-${id}`}
+ type="button"
+ role="tab"
+ aria-selected={method === id}
+ className={choiceBtn(method === id)}
+ onClick={() => setMethod(id)}
+ >
+ <Icon className="h-4 w-4" />
+ {installLabel[id]}
+ </button>
+ ))}
</div>
- <ol className="flex flex-col gap-10">
- <Step
- index={1}
- icon={<DownloadIcon className="h-4.5 w-4.5" />}
- title={S.quickstart.step1}
- desc={S.quickstart.step1Desc}
+ {method === "desktop" && (
+ <div
+ role="tabpanel"
+ className="anim-fade mt-5 overflow-hidden rounded-2xl border border-gray-200 bg-white shadow-sm dark:border-gray-800 dark:bg-gray-900"
>
- {/* Two switch rows — OS, then online/offline — so exactly one method shows at a time. */}
- <div className="mb-2 flex flex-wrap gap-2">
- <div
- className="inline-flex gap-1 rounded-lg border border-gray-200 bg-white p-1 dark:border-gray-800 dark:bg-gray-900"
- role="tablist"
- >
- {(["linux", "macos", "windows"] as const).map((key) => (
- <button
- key={key}
- type="button"
- role="tab"
- aria-selected={os === key}
- className={providerBtn(os === key)}
- onClick={() => setOs(key)}
- >
- {S.install[key]}
- </button>
+ <div className="grid gap-8 p-6 sm:p-8 md:grid-cols-[1fr_1.15fr] md:items-center">
+ <div>
+ <span className="inline-flex h-11 w-11 items-center justify-center rounded-xl bg-brand-50 text-brand-700 dark:bg-brand-950 dark:text-brand-300">
+ <DownloadIcon className="h-5 w-5" />
+ </span>
+ <h3 className="mt-5 text-xl font-semibold tracking-tight">
+ {S.quickstart.desktop.title}
+ </h3>
+ <p className="mt-2 text-sm leading-6 text-gray-600 dark:text-gray-400">
+ {S.quickstart.desktop.desc}
+ </p>
+ <Link
+ to="/download"
+ className="mt-6 inline-flex h-11 items-center gap-2 rounded-lg bg-gray-900 px-5 text-sm font-semibold text-white transition-colors hover:bg-gray-700 dark:bg-gray-100 dark:text-gray-900 dark:hover:bg-white"
+ >
+ {S.quickstart.desktop.cta}
+ <ArrowRightIcon className="h-4 w-4" />
+ </Link>
+ </div>
+ <ol className="grid gap-4 rounded-xl bg-gray-50 p-5 dark:bg-gray-950">
+ {S.quickstart.desktop.steps.map((step, index) => (
+ <NumberedItem key={step} index={index + 1}>
+ {step}
+ </NumberedItem>
))}
+ </ol>
+ </div>
+ </div>
+ )}
+
+ {method === "install" && (
+ <div className="anim-fade">
+ <div className="mt-5 rounded-2xl border border-gray-200 bg-white p-6 shadow-sm sm:p-8 dark:border-gray-800 dark:bg-gray-900">
+ <div className="flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between">
+ <div className="max-w-xl">
+ <h3 className="text-xl font-semibold tracking-tight">
+ {S.quickstart.install.title}
+ </h3>
+ <p className="mt-2 text-sm leading-6 text-gray-600 dark:text-gray-400">
+ {S.quickstart.install.desc}
+ </p>
+ </div>
+ <div
+ className="inline-flex w-fit gap-1 rounded-lg border border-gray-200 bg-gray-50 p-1 dark:border-gray-800 dark:bg-gray-950"
+ role="tablist"
+ aria-label={S.quickstart.install.osLabel}
+ >
+ {(["linux", "macos", "windows"] as const).map((key) => (
+ <button
+ key={key}
+ type="button"
+ role="tab"
+ aria-selected={os === key}
+ className={osBtn(os === key)}
+ onClick={() => setOs(key)}
+ >
+ {S.install[key]}
+ </button>
+ ))}
+ </div>
+ </div>
+
+ <div className="mt-6">
+ <h4 className="text-sm font-semibold tracking-tight">
+ {S.quickstart.install.onlineTitle}
+ </h4>
+ <CodeCard
+ code={installCommand}
+ label={os === "windows" ? "PowerShell" : "curl | sh"}
+ className="mt-3"
+ />
</div>
+
+ <div className="mt-6 rounded-xl bg-gray-50 p-4 dark:bg-gray-950">
+ <h4 className="text-sm font-semibold tracking-tight">
+ {S.quickstart.install.offlineTitle}
+ </h4>
+ <p className="mt-1 text-xs leading-5 text-gray-500 dark:text-gray-400">
+ {S.quickstart.install.offlineDesc}
+ </p>
+ <div className="mt-3 grid gap-2 sm:grid-cols-2">
+ {CLI_INSTALLERS[os].map(({ file, variant }) => (
+ <a
+ key={file}
+ href={`${GITHUB_LATEST_DOWNLOAD}/${file}`}
+ className="flex min-w-0 items-center gap-2 rounded-lg border border-gray-200 bg-white px-3 py-2.5 text-left transition-colors hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-900 dark:hover:border-gray-700 dark:hover:bg-gray-800"
+ >
+ <DownloadIcon className="h-4 w-4 shrink-0" />
+ <span className="min-w-0">
+ <strong className="block text-xs font-semibold">{variant}</strong>
+ <span className="block truncate font-mono text-[10px] text-gray-500 dark:text-gray-400">
+ {file}
+ </span>
+ </span>
+ </a>
+ ))}
+ </div>
+ <details className="mt-3 text-xs">
+ <summary className="cursor-pointer font-medium text-brand-700 dark:text-brand-300">
+ {S.quickstart.install.offlineCommand}
+ </summary>
+ <CodeCard
+ code={OFFLINE_INSTALL_CMDS[os]}
+ label={os === "windows" ? "PowerShell" : "shell"}
+ className="mt-3"
+ />
+ </details>
+ </div>
+ </div>
+
+ <div className="mt-10">
+ <StepHeading step={S.quickstart.stepTwo} title={S.quickstart.chooseLaunch} />
<div
- className="inline-flex gap-1 rounded-lg border border-gray-200 bg-white p-1 dark:border-gray-800 dark:bg-gray-900"
+ className="grid grid-cols-2 gap-1 rounded-xl border border-gray-200 bg-white p-1 dark:border-gray-800 dark:bg-gray-900"
role="tablist"
+ aria-label={S.quickstart.chooseLaunch}
>
- {(["online", "offline"] as const).map((key) => (
+ {LAUNCH_MODES.map(({ id, icon: Icon }) => (
<button
- key={key}
+ key={id}
+ id={`quickstart-${id}`}
type="button"
role="tab"
- aria-selected={method === key}
- className={providerBtn(method === key)}
- onClick={() => setMethod(key)}
+ aria-selected={launchMode === id}
+ className={choiceBtn(launchMode === id)}
+ onClick={() => setLaunchMode(id)}
>
- {S.install[key]}
+ <Icon className="h-4 w-4" />
+ {launchLabel[id]}
</button>
))}
</div>
</div>
- {method === "online" ? (
- <CodeCard
- code={os === "windows" ? INSTALL_CMD_WINDOWS : INSTALL_CMD}
- label={os === "windows" ? "PowerShell" : "curl | sh"}
- />
- ) : (
- <>
- <p className="mb-2 text-xs leading-5 text-gray-500 dark:text-gray-400">
- {S.install.offlineNote}
- </p>
- <CodeCard
- code={OFFLINE_INSTALL_CMDS[os]}
- label={os === "windows" ? "PowerShell" : "shell"}
- />
- <p className="mt-2 text-xs leading-5 text-gray-500 dark:text-gray-400">
- {S.install.offlineHints[os]}{" "}
- <a
- href={RELEASES_URL}
- target="_blank"
- rel="noreferrer"
- className="inline-flex items-center gap-1 text-brand-700 underline decoration-brand-300 underline-offset-2 transition-colors hover:text-brand-600 dark:text-brand-300 dark:decoration-brand-700"
- >
- {S.install.offlineRelease}
- <ExternalLinkIcon className="h-3 w-3" />
- </a>
- </p>
- </>
- )}
- {/* Below both install methods: the desktop app is the headline install path
- (hero + /download); this note tells CLI installers the two share one data
- root, and still routes anyone terminal-averse back to the download page. */}
- <p className="mt-2 text-xs leading-5 text-gray-500 dark:text-gray-400">
- {S.install.desktopNote}{" "}
- <Link
- to="/download"
- className="inline-flex items-center gap-1 text-brand-700 underline decoration-brand-300 underline-offset-2 transition-colors hover:text-brand-600 dark:text-brand-300 dark:decoration-brand-700"
- >
- {S.install.desktopPage}
- </Link>
- </p>
- </Step>
- {mode === "web" ? (
- <>
- <Step
- index={2}
- icon={<MonitorIcon className="h-4.5 w-4.5" />}
- title={S.quickstart.webStep2}
- desc={S.quickstart.webStep2Desc}
- >
- <CodeCard code={S.quickstart.webCmd} label="penguin web" />
- </Step>
- <Step
- index={3}
- icon={<SlidersIcon className="h-4.5 w-4.5" />}
- title={S.quickstart.webStep3}
- desc={S.quickstart.webStep3Desc}
- >
- <KeyLinks />
- </Step>
- </>
- ) : (
- <>
- <Step
- index={2}
- icon={<SlidersIcon className="h-4.5 w-4.5" />}
- title={S.quickstart.cliStep2}
- desc={S.quickstart.cliStep2Desc}
- >
- <div
- className="mb-2 inline-flex gap-1 rounded-lg border border-gray-200 bg-white p-1 dark:border-gray-800 dark:bg-gray-900"
- role="tablist"
- >
- <button
- type="button"
- role="tab"
- aria-selected={provider === "deepseek"}
- className={providerBtn(provider === "deepseek")}
- onClick={() => setProvider("deepseek")}
- >
- {S.quickstart.tabDeepseek}
- </button>
- <button
- type="button"
- role="tab"
- aria-selected={provider === "openrouter"}
- className={providerBtn(provider === "openrouter")}
- onClick={() => setProvider("openrouter")}
- >
- {S.quickstart.tabOpenrouter}
- </button>
+ <div
+ role="tabpanel"
+ key={launchMode}
+ className="anim-fade mt-5 overflow-hidden rounded-2xl border border-gray-200 bg-white shadow-sm dark:border-gray-800 dark:bg-gray-900"
+ >
+ {launchMode === "web" ? (
+ <div className="grid gap-8 p-6 sm:p-8 md:grid-cols-[0.9fr_1.1fr] md:items-center">
+ <div>
+ <h3 className="text-xl font-semibold tracking-tight">
+ {S.quickstart.web.title}
+ </h3>
+ <p className="mt-2 text-sm leading-6 text-gray-600 dark:text-gray-400">
+ {S.quickstart.web.desc}
+ </p>
+ <ol className="mt-5 grid gap-3">
+ {S.quickstart.web.steps.map((step, index) => (
+ <NumberedItem key={step} index={index + 1}>
+ {step}
+ </NumberedItem>
+ ))}
+ </ol>
+ </div>
+ <CodeCard code={S.quickstart.web.command} label="penguin web" />
</div>
- {provider === "deepseek" ? (
- <>
- <CodeCard code={S.quickstart.deepseekCmd} label="penguin config" />
- <p className="mt-2 text-xs leading-5 text-gray-500 dark:text-gray-400">
- {S.quickstart.deepseekNote}
+ ) : (
+ <div className="grid gap-8 p-6 sm:p-8 md:grid-cols-[0.9fr_1.1fr] md:items-center">
+ <div>
+ <h3 className="text-xl font-semibold tracking-tight">
+ {S.quickstart.cli.title}
+ </h3>
+ <p className="mt-2 text-sm leading-6 text-gray-600 dark:text-gray-400">
+ {S.quickstart.cli.desc}
</p>
- </>
- ) : (
- <>
- <CodeCard code={S.quickstart.openrouterCmd} label="penguin config" />
- <p className="mt-2 text-xs leading-5 text-gray-500 dark:text-gray-400">
- {S.quickstart.openrouterNote}
+ <p className="mt-5 text-xs leading-5 text-gray-500 dark:text-gray-400">
+ {S.quickstart.localNote}
</p>
- </>
- )}
- <KeyLinks />
- </Step>
- <Step
- index={3}
- icon={<PlayIcon className="h-4.5 w-4.5" />}
- title={S.quickstart.cliStep3}
- desc={S.quickstart.cliStep3Desc}
- >
- <CodeCard code={S.quickstart.runCmd} label="penguin run" />
- </Step>
- </>
- )}
- </ol>
+ </div>
+ <CodeCard code={S.quickstart.cli.command} label="penguin" />
+ </div>
+ )}
+ </div>
+ </div>
+ )}
</div>
</Section>
);
diff --git a/packages/landing/src/sections/self-improve.tsx b/packages/landing/src/sections/self-improve.tsx
index 28ffde25..395f493c 100644
--- a/packages/landing/src/sections/self-improve.tsx
+++ b/packages/landing/src/sections/self-improve.tsx
@@ -497,8 +497,6 @@ export function SelfImprove() {
))}
</div>
</div>
- {/* The loop above is a diagram; this is the same loop actually running. Replaces the
- "demo video coming soon" pill that stood here while the recording was in progress. */}
<div className="mt-10">
<DemoVideo
src={demoVideoUrl(locale === "zh" ? "evo_zh" : "evo_en")}
diff --git a/packages/landing/src/styles.css b/packages/landing/src/styles.css
index 074cc265..12860777 100644
--- a/packages/landing/src/styles.css
+++ b/packages/landing/src/styles.css
@@ -138,6 +138,21 @@
background-image: radial-gradient(rgb(138 180 248 / 0.16) 1px, transparent 1px);
}
+/* Keep the two concise hero lines on one line in English without widening the page. */
+.hero-positioning {
+ font-size: clamp(0.95rem, 4.3vw, 3rem);
+}
+:lang(en) .hero-positioning {
+ font-size: clamp(0.72rem, 3.3vw, 2.6rem);
+}
+.hero-automation {
+ font-size: clamp(0.8rem, 3.5vw, 1.125rem);
+}
+:lang(en) .hero-automation {
+ font-size: clamp(0.64rem, 2.1vw, 1.125rem);
+ white-space: nowrap;
+}
+
/* ---------- Ambient neon backdrop: blurred glows wandering across the screen ----------
Viewport-FIXED (the page background stays put while content scrolls over it) with a
uniform page background behind every section, so nothing jumps at section boundaries.
@@ -329,31 +344,28 @@
.anim-line-dot {
opacity: 1;
}
+ .anim-block {
+ opacity: 1 !important;
+ transform: none !important;
+ }
}
-/* ---------- Building-blocks loop (LangChain comparison): each block pops in at its
- negative delay within the shared cycle, holds while the rest of the tower lands,
- then the whole skyline fades and rebuilds. Reduced-motion shows towers complete. */
+/* ---------- Building blocks (LangChain comparison): React remounts both skylines on
+ one shared cycle; each block then lands once at its positive delay and holds. */
.anim-block {
- animation: block-build var(--cycle, 7.2s) linear infinite;
+ opacity: 0;
+ transform: translateY(5px) scale(0.92);
+ animation: block-land 220ms cubic-bezier(0.2, 0.75, 0.25, 1) var(--land-delay, 0s) both;
}
-@keyframes block-build {
- 0% {
+@keyframes block-land {
+ from {
opacity: 0;
transform: translateY(5px) scale(0.92);
}
- 3% {
- opacity: 1;
- transform: none;
- }
- 93% {
+ to {
opacity: 1;
transform: none;
}
- 100% {
- opacity: 0;
- transform: none;
- }
}
/* Printing never scrolls, so scroll-reveal must not hide content on paper/PDF. */
diff --git a/packages/landing/test/download-source.test.ts b/packages/landing/test/download-source.test.ts
index 1d62ac99..b7f3990a 100644
--- a/packages/landing/test/download-source.test.ts
+++ b/packages/landing/test/download-source.test.ts
@@ -12,6 +12,7 @@ import {
SPEED_PROBE_GITHUB_MIN_BYTES_PER_SECOND,
createDeadline,
decideDownloadSource,
+ decideDownloadSourceWithReport,
parseMirror,
parseProbes,
selectDownloadSource,
@@ -193,6 +194,17 @@ describe("decideDownloadSource", () => {
await expect(decideDownloadSource(SOURCES, PROBES, io)).resolves.toBe("oss");
expect(asked).toEqual(["measure:github", "measure:oss"]);
});
+
+ it("retains the measurements used by the visible speed report", async () => {
+ const github = reachable(MIN / 2);
+ const oss = reachable(MIN);
+ const { io } = fakeProbes(github, oss);
+ await expect(decideDownloadSourceWithReport(SOURCES, PROBES, io)).resolves.toEqual({
+ source: "oss",
+ github,
+ oss,
+ });
+ });
});
describe("worthRefining", () => {
diff --git a/packages/landing/test/nav-state.test.ts b/packages/landing/test/nav-state.test.ts
index ecfbf59b..9fe9c85a 100644
--- a/packages/landing/test/nav-state.test.ts
+++ b/packages/landing/test/nav-state.test.ts
@@ -4,9 +4,14 @@ import { getActiveNavItem } from "../src/lib/nav-state";
describe("landing navigation active state", () => {
it("tracks known section hashes on the home page", () => {
expect(getActiveNavItem("/", "#features")).toBe("features");
+ expect(getActiveNavItem("/", "#self-improvement")).toBe("highlights");
expect(getActiveNavItem("/", "#quickstart")).toBe("quickstart");
});
+ it("leaves the case section out of the reduced navigation", () => {
+ expect(getActiveNavItem("/", "#cases")).toBeNull();
+ });
+
it("tracks the Blog route and blog posts", () => {
expect(getActiveNavItem("/blog", "")).toBe("blog");
expect(getActiveNavItem("/blog/release-notes", "")).toBe("blog");