diff --git a/VERSION b/VERSION index 339fd080..f386df22 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.42.1 +0.42.2 diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index b4769681..607cad24 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -8,6 +8,13 @@ This project follows the repository versioning rule: - `improvement` -> `+0.0.1`（bugfix + 小功能混合） - `bugfix` -> `+0.0.1` +## [0.42.2] — 2026-04-28 + +### 🐛 Fixes +- Docs 中文模式下补齐左侧分组、文档标题、页头分类与搜索结果分类翻译，并更新文档站品牌标题/副标题文案 + +--- + ## [0.42.1] — 2026-04-28 ### 🐛 Fixes diff --git a/docs/version-history.md b/docs/version-history.md index 561c8c24..471db99e 100644 --- a/docs/version-history.md +++ b/docs/version-history.md @@ -16,12 +16,13 @@ ## Current Version - `main` 当前主线历史推导到：`0.16.5` -- `dev` 当前开发分支历史推导到：`0.42.1` +- `dev` 当前开发分支历史推导到：`0.42.2` ## Timeline | Version | Type | Branch | Commit | Summary | | --- | --- | --- | --- | --- | +| `0.42.2` | bugfix | `dev` | `pending` | Docs 中文模式补齐分组和文档标题翻译，并更新文档站品牌文案 | | `0.42.1` | bugfix | `dev` | `pending` | 修正 release skill 的 feature 版本计算规则，minor 进位时重置 patch 为 0 | | `0.42.0` | feature | `dev` | `pending` | 新增公开 `/docs` 文档站、中英文技术/使用文档、搜索与主题切换，并补充公共组件复用和 Earth 无高清材质边缘提示 | | `0.41.2` | improvement | `dev` | `pending` | 启动脚本新增 verbose 滚动日志与端口占用诊断，Docker 构建支持镜像源覆盖，并修复 Earth 登陆点遮挡判断 | diff --git a/frontend/package.json b/frontend/package.json index 5b31c428..11971e3f 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "planet-frontend", - "version": "0.42.1", + "version": "0.42.2", "private": true, "packageManager": "bun@1", "dependencies": { diff --git a/frontend/src/pages/Docs/Docs.tsx b/frontend/src/pages/Docs/Docs.tsx index f8e52a7b..e69d68b5 100644 --- a/frontend/src/pages/Docs/Docs.tsx +++ b/frontend/src/pages/Docs/Docs.tsx @@ -11,6 +11,7 @@ import { extractHeadings, getDocsEntries, getDocsEntry, + getDocsGroupLabel, groupDocsEntries, slugFromDocsHref, } from './docs-content' @@ -252,15 +253,19 @@ export default function Docs() { P - Planet Docs - Developer guide + + {lang === 'zh' ? '星球计划文档' : 'Planet Docs'} + + + {lang === 'zh' ? '开发者和用户手册' : 'Developer & User Guide'} + {groupedEntries.map((group) => (
-

{group.group}

+

{getDocsGroupLabel(group.group, lang)}

{group.entries.map((entry) => { const isActive = entry.slug === activeSlug return ( @@ -320,7 +325,9 @@ export default function Docs() {
-

{activeEntry?.group || 'Docs'}

+

+ {activeEntry ? getDocsGroupLabel(activeEntry.group, lang) : 'Docs'} +

{activeEntry?.title || 'Document not found'}

@@ -356,7 +363,9 @@ export default function Docs() { onClick={() => handleSearchSelect(result.entry.slug)} > {result.entry.title} - {result.entry.group} + + {getDocsGroupLabel(result.entry.group, lang)} + {result.excerpt} )) diff --git a/frontend/src/pages/Docs/docs-content.ts b/frontend/src/pages/Docs/docs-content.ts index e6fc8043..91f9557f 100644 --- a/frontend/src/pages/Docs/docs-content.ts +++ b/frontend/src/pages/Docs/docs-content.ts @@ -21,6 +21,29 @@ interface DocsMetadataEntry { en: { title: string; group: DocsGroup; order: number } } +const DOCS_GROUP_LABELS: Record> = { + zh: { + Overview: '概览', + Manual: '使用手册', + Earth: '地球可视化', + Frontend: '前端', + Backend: '后端', + Agents: '智能体', + Ops: '运维', + Other: '其他', + }, + en: { + Overview: 'Overview', + Manual: 'Manual', + Earth: 'Earth', + Frontend: 'Frontend', + Backend: 'Backend', + Agents: 'Agents', + Ops: 'Ops', + Other: 'Other', + }, +} + const DOCS_README_FILENAME = 'README.md' const FALLBACK_DOCS_ORDER = 999 const MAX_HEADING_ID_LENGTH = 80 @@ -42,7 +65,7 @@ const DOCS_METADATA: Record = { en: { title: 'Technical Docs', group: 'Overview', order: 0 }, }, 'quickstart.md': { - zh: { title: 'Quickstart', group: 'Manual', order: 1 }, + zh: { title: '快速开始', group: 'Manual', order: 1 }, en: { title: 'Quickstart', group: 'Manual', order: 1 }, }, 'manual.md': { @@ -50,7 +73,7 @@ const DOCS_METADATA: Record = { en: { title: 'Planet Manual', group: 'Manual', order: 2 }, }, 'earth-frontend-context.md': { - zh: { title: 'Earth Frontend Context', group: 'Earth', order: 10 }, + zh: { title: 'Earth 前端结构', group: 'Earth', order: 10 }, en: { title: 'Earth Frontend Context', group: 'Earth', order: 10 }, }, 'earth-layer-style-reference.md': { @@ -62,23 +85,23 @@ const DOCS_METADATA: Record = { en: { title: 'Earth Render Layer Order', group: 'Earth', order: 12 }, }, 'earth-satellite-footprint-policy.md': { - zh: { title: 'Earth Satellite Footprint Policy', group: 'Earth', order: 13 }, + zh: { title: 'Earth 卫星覆盖策略', group: 'Earth', order: 13 }, en: { title: 'Earth Satellite Footprint Policy', group: 'Earth', order: 13 }, }, 'earth-bgp-context.md': { - zh: { title: 'BGP Context', group: 'Earth', order: 14 }, + zh: { title: 'BGP 态势上下文', group: 'Earth', order: 14 }, en: { title: 'BGP Context', group: 'Earth', order: 14 }, }, 'earth-news-live-streams-collector-format.md': { - zh: { title: 'News Live Streams Collector Format', group: 'Earth', order: 15 }, + zh: { title: '新闻直播采集格式', group: 'Earth', order: 15 }, en: { title: 'News Live Streams Collector Format', group: 'Earth', order: 15 }, }, 'frontend-admin-frontend-context.md': { - zh: { title: 'Admin Frontend Context', group: 'Frontend', order: 20 }, + zh: { title: '控制台前端结构', group: 'Frontend', order: 20 }, en: { title: 'Admin Frontend Context', group: 'Frontend', order: 20 }, }, 'frontend-layout-guidelines.md': { - zh: { title: 'Frontend Layout Guidelines', group: 'Frontend', order: 21 }, + zh: { title: '前端布局指南', group: 'Frontend', order: 21 }, en: { title: 'Frontend Layout Guidelines', group: 'Frontend', order: 21 }, }, 'backend-collectors.md': { @@ -86,11 +109,11 @@ const DOCS_METADATA: Record = { en: { title: 'Data Collectors', group: 'Backend', order: 30 }, }, 'backend-system-service-control.md': { - zh: { title: 'System Service Control', group: 'Backend', order: 31 }, + zh: { title: '系统服务控制', group: 'Backend', order: 31 }, en: { title: 'System Service Control', group: 'Backend', order: 31 }, }, 'agents-aiprovider.md': { - zh: { title: 'AI Provider Guide', group: 'Agents', order: 40 }, + zh: { title: 'AI Provider 指南', group: 'Agents', order: 40 }, en: { title: 'AI Provider Guide', group: 'Agents', order: 40 }, }, 'ops-docker-compose-buildx-upgrade.md': { @@ -154,6 +177,10 @@ export function groupDocsEntries(entries: DocsEntry[]): Array<{ group: DocsGroup })).filter((group) => group.entries.length > 0) } +export function getDocsGroupLabel(group: DocsGroup, lang: DocsLang): string { + return DOCS_GROUP_LABELS[lang][group] +} + export function createHeadingId(text: string, usedIds: Map): string { const base = text .toLowerCase() diff --git a/pyproject.toml b/pyproject.toml index c6a00873..47f0e6ad 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "planet" -version = "0.42.1" +version = "0.42.2" description = "智能星球计划 - 态势感知系统" requires-python = ">=3.14" dependencies = [ diff --git a/uv.lock b/uv.lock index ca9da24b..5f836d53 100644 --- a/uv.lock +++ b/uv.lock @@ -475,7 +475,7 @@ wheels = [ [[package]] name = "planet" -version = "0.42.1" +version = "0.42.2" source = { virtual = "." } dependencies = [ { name = "aiofiles" },