Compare commits

..
4 Commits
Author SHA1 Message Date
rayd1o a54fcdbeed release: bump version to 0.74.3
ci / backend (push) Has been cancelled
ci / frontend (push) Has been cancelled
ci / delivery (push) Has been cancelled
release / images (push) Has been cancelled
ci / backend (pull_request) Has been cancelled
ci / frontend (pull_request) Has been cancelled
ci / delivery (pull_request) Has been cancelled
2026-09-13 02:17:55 +08:00
rayd1o 1dd2921674 release: bump version to 0.74.2
ci / backend (push) Has been cancelled
ci / frontend (push) Has been cancelled
release / images (push) Has been cancelled
ci / delivery (push) Has been cancelled
2026-07-01 23:40:00 +08:00
linkong d30f7d08c5 release: bump version to 0.74.1
ci / backend (push) Has been cancelled
ci / frontend (push) Has been cancelled
ci / delivery (push) Has been cancelled
release / images (push) Has been cancelled
2026-06-30 18:54:34 +08:00
linkong 5bdb55f3f1 release: bump version to 0.74.0
ci / backend (push) Has been cancelled
ci / frontend (push) Has been cancelled
ci / delivery (push) Has been cancelled
release / images (push) Has been cancelled
2026-06-30 13:52:52 +08:00
85 changed files with 6437 additions and 1636 deletions

No files matched your search

-139
View File
@@ -1,139 +0,0 @@
---
description: 审查当前工作区未提交代码中的垃圾代码,并在不影响逻辑的前提下自动清理
argument-hint: 可选:指定要检查的文件或目录(默认检查所有未提交修改)
allowed-tools: ["Read", "Edit", "Bash", "Grep", "Glob"]
---
# /cleanup — 垃圾代码审查与清理
分析当前工作区(git diff)中的未提交代码,找出并修复常见垃圾代码,**不得改变任何运行逻辑**。
## 检查范围
若 `$ARGUMENTS` 非空,则只检查指定文件/目录;否则检查所有未提交修改(`git diff HEAD`)。
## 节省上下文规则
优先用确定性的 CLI 检查缩小范围,不要一上来把完整文件或大 diff 读入上下文:
```bash
git diff --name-only HEAD
git diff --unified=0 HEAD -- <path>
git diff --check
rg -n "TODO|FIXME|console\.log|debugger|print\(" <changed-paths>
```
只有 focused diff 不足以安全判断或修改时,才读取完整文件。
## 审查清单
按优先级检查以下问题(只报告在本次 diff 中**新增或修改**的代码里存在的问题):
### 1. 重复逻辑 (Duplicate Logic)
- 完全相同或高度相似的代码块在多处出现
- 同一函数/方法被多个地方各自实现,已有公共版本未被复用
- 相同的 DOM 查询、正则、模板字符串在同一文件重复
### 2. Magic Numbers / Magic Strings
- 裸数字直接参与计算(如偏移量、时间、尺寸、阈值),没有命名常量
- 硬编码字符串(如 id 名、状态值、URL 片段)散落在逻辑中
- 例外:`0`, `1`, `-1`, `100`, `""` 等语义明确的惯用值不算
### 3. 命名问题
- 含义不明的缩写变量(如 `or_`, `tmp2`, `x2`)
- 命名与实际用途不符
- 同一概念在不同地方用不同名字表达
### 4. 死代码 / 无效代码
- 注释掉的旧代码块(3行以上)
- 声明后从未使用的变量/参数/导入
- 永远不会执行的条件分支
### 5. 代码风格问题
- 尾部空白字符(trailing whitespace)
- 同一文件内风格不一致(如混用单双引号、缩进不统一)
- 空行使用不一致(连续多个空行等)
### 6. 其他常见问题
- 私有辅助函数应被 export 但没有,导致调用方重复实现
- 类型/接口重复定义
- 过于冗长的条件表达式可以简化(不改逻辑)
## 执行步骤
### Step 1 — 获取待检查文件列表
```bash
# 无参数时:获取所有未提交修改
git diff HEAD --name-only
# 有参数时:用 $ARGUMENTS 过滤
```
### Step 2 — 逐文件阅读并分析
先从 focused diff 开始:
```bash
git diff --unified=0 HEAD -- <file>
```
用 `rg`、`git diff --check`、编译器或 linter 输出确认确定性问题。只有需要上下文时才用 Read 读取完整文件。对照审查清单,记录每个问题:文件名、行号、问题类型、建议修复方式。
### Step 3 — 报告问题清单
在修改前,先以列表形式输出所有发现的问题:
```
发现 N 个问题:
[文件] js/foo.js
· L34, L78: 重复逻辑 — 两处都实现了相同的 DOM 查询,可提取到 getPanel()
· L91: Magic number — 硬编码 14 作为偏移量,应命名为 TOOLTIP_OFFSET
[文件] js/bar.js
· L12: 命名问题 — 变量 `or_` 语义不明,应命名为 outerR/outerG/outerB
...
```
如果没有发现问题,直接输出"未发现垃圾代码,当前代码质量良好。"并停止。
### Step 4 — 执行修复
对每个问题,使用 Edit 工具进行**最小化修改**:
- **重复逻辑**:提取为共享常量/函数,更新所有调用点
- **Magic number**:在文件顶部或逻辑附近声明 `const NAME = value`,替换所有引用
- **命名问题**:重命名变量,更新所有使用处
- **死代码**:直接删除
- **尾部空白/风格**:修正
- **未 export 的函数**:添加 `export`,在调用方改为导入(不重复实现)
**修复原则:**
- 只改在审查清单中发现的问题,不做额外优化
- 每次 Edit 只修改确实有问题的行,保持 diff 最小
- 改完后用 `grep` 验证旧的坏代码已消失
- 优先做精确补丁;只有仓库已有对应格式化流程时,才运行格式化工具
### Step 5 — 输出总结
```
清理完成:
修复了 N 个问题:
✓ earth.js — 提取重复 vertexShader 为 ATMOS_VERTEX_SHADER 常量
✓ main.js — 提取 TOOLTIP_CURSOR_OFFSET = 14(4处引用)
✓ controls.js — export updateLayerButtonState,移除 main.js 中的重复实现
...
未修改的问题(需人工确认):
! foo.js L45 — 注释代码块较长,建议手动确认是否可删除
```
## 约束
- **禁止**改变函数签名、接口定义、导出 API(除非问题正是私有函数应被 export)
- **禁止**添加新功能、新抽象、新参数
- **禁止**修改注释内容(只删除注释掉的死代码)
- **禁止**修改测试文件逻辑
- 如果一个 Magic number 的语义不完全确定,**跳过**,在总结中标记为"需人工确认"
-104
View File
@@ -1,104 +0,0 @@
---
description: Create or update repository documentation from current code changes
argument-hint: Optional: topic to document, or leave empty to infer from git diff
allowed-tools: ["Read", "Edit", "Write", "Bash", "Glob", "Grep"]
---
# /docs — Documentation Workflow
## Goal
Create or update documentation that explains why a change exists, how it behaves, and what maintainers need to know. Keep this command generic. Repository-specific coverage rules live in the repository and must be loaded separately.
## Repository Rules
Before deciding scope, check whether the repository has a documentation rules file:
```bash
test -f docs/documentation-coverage-rules.md && sed -n '1,240p' docs/documentation-coverage-rules.md
```
If it exists, apply it as the project-specific coverage checklist. If it does not exist, continue with the generic workflow below.
## Workflow
### Step 1 — Understand The Change
```bash
git diff HEAD --stat
git diff HEAD --name-only
git log --oneline -10
rg --files docs
```
If `$ARGUMENTS` specifies a topic, focus on that topic. Otherwise infer the documentation topic from the changed files. Do not read the full repository diff by default; inspect focused files only:
```bash
git diff HEAD -- <path>
rg -n "class |def |function |export |router|@router|interface |type " <path>
```
### Step 2 — Decide Scope
- Prefer updating an existing relevant document over creating a duplicate.
- Use one document for one coherent topic.
- Split documents only when the change crosses meaningful domains.
- Keep filenames lowercase and hyphenated.
- Apply the repository-specific rules file before writing.
#### Document Audience Routing (Planet)
In this repository, classify the action's performer before picking a target file:
- Browser/UI end user → `docs/technical/{zh,en}/manual.md` or `quickstart.md`.
- Shell / Docker / log paths / `planet.sh` / SMTP fallbacks / port forwarding → `docs/technical/{zh,en}/ops-runbook.md` (or an existing `ops-*.md`).
- Second-party developers → existing `*-context.md` / `backend-*.md` / `earth-*.md` files.
Never put shell commands, log paths, or Docker operations into `manual.md` / `quickstart.md`. Never put UI button labels or screenshots into `ops-*.md`. When the same action has both a UI and a CLI path, write each in its own home and cross-link them with one sentence.
For ambiguous or large documentation changes, briefly state the intended doc plan before editing. For clear small changes, proceed directly.
### Step 3 — Write
Explain:
- Background/problem: what was wrong or missing before.
- Core design decisions and rationale.
- Operational or user-facing impact.
- Relevant code paths, only when useful for future maintainers.
Style:
- Follow the repository’s existing language and heading conventions.
- Use fenced code blocks with language tags.
- Prefer tables for comparisons or parameter lists.
- Keep snippets concise and relevant.
- For UI labels, chart labels, feature names, datasource names, and other terms that may become mixed Chinese/English copy, check `docs/technical/{zh,en}/naming-glossary.md` and use the documented display name. If a confusing term is missing, update the glossary in both languages as part of the docs change.
### Step 4 — Verify
- Read the completed docs once for clarity and stale statements.
- Verify referenced paths exist with `test -e` or `rg --files`.
- Run applicable checks from `docs/documentation-coverage-rules.md`.
- Check Markdown links use readable user-facing titles unless repository rules allow otherwise.
### Step 5 — Report
Summarize changed docs and verification:
```md
Updated:
- path/to/doc.md — what changed
Verified:
- checks that passed
- checks that could not be run, if any
```
## Hard Constraints
- Do not leave placeholder docs.
- Do not duplicate bilingual files byte-for-byte.
- Do not reference PR numbers, issue numbers, or the current conversation unless explicitly requested.
- Do not write changelog-style lists without the reasoning and tradeoffs behind the change.
- Keep docs maintainable and concise.
-93
View File
@@ -1,93 +0,0 @@
---
description: 用 goal-driven 方法推动一个复杂任务持续执行,直到明确成功标准被满足
argument-hint: 建议填写任务目标;若同时给出成功标准更好
allowed-tools: ["Read", "Edit", "Bash", "Grep", "Glob"]
---
# /goal-driven — 目标驱动执行模式
使用 `lidangzzz/goal-driven` 的核心思想来推进复杂任务:先固定目标与成功标准,再持续执行和反复验收,直到标准真正满足。
适用场景:
- 长周期实现任务
- 高复杂度工程任务
- 可被明确验收的研究、实现、迁移、验证类工作
不适用场景:
- 纯脑暴
- 无法定义成功标准的模糊任务
- 很小的一次性修改
## 输入要求
若 `$ARGUMENTS` 只包含目标,没有成功标准,先补全一版可执行的成功标准再开始。
启动时先输出:
```md
Goal
- ...
Criteria for success
- ...
Plan
1. ...
2. ...
3. ...
Verification
- ...
```
## 执行规则
1. 先把任务固化为两个核心块:
- `Goal`
- `Criteria for success`
2. 成功标准必须尽量客观,可验证,可落地。
优先写成:
- 需要交付什么
- 需要通过哪些测试或验证
- 如何判断结果真的完成
3. 进入持续执行循环:
- 完成一个阶段
- 检查当前结果是否满足成功标准
- 若未满足,明确剩余差距并继续推进
4. 任何“完成了”“差不多了”“已实现”之类的结论,都必须经过验证,不能直接接受。
5. 如果验证失败:
- 明确指出哪条成功标准没满足
- 继续工作,不要把阶段性进展误判为完成
6. 只有在以下情况之一才能停止:
- 成功标准已满足
- 用户明确要求停止
## 执行风格
- 重证据,轻口头判断
- 优先使用确定性工具证据:`rg`、`git diff --stat`、`git diff -- <path>`、测试、构建、lint、`curl`、数据库查询等能直接证明成功标准的方式
- 不把大段命令输出粘进回复;保留在工具调用里,回复只总结关键证据
- 重验收,轻自我感觉
- 优先用测试、日志、产物、对比结果来证明完成
- 对长期任务保持“未达标就继续”的节奏
## 简版模板
```md
Goal: [[[[[在此填写最终目标]]]]]
Criteria for success: [[[[[在此填写成功标准]]]]]
循环执行:
1. 推进任务
2. 检查是否满足成功标准
3. 若未满足,继续工作
4. 直到满足标准或用户明确停止
```
-160
View File
@@ -1,160 +0,0 @@
---
description: 发版工作流:根据变更类型决定版本号,更新所有版本文件和 changelog,运行验证,commit 并 push
argument-hint: 可选:feature | bugfix | 或直接描述本次发布内容
allowed-tools: ["Read", "Edit", "Bash", "Glob", "Grep"]
---
# /release — Planet 发版工作流
## 版本号规则
| 变更类型 | 版本跳动 | 适用场景 |
|---------|---------|---------|
| `feature` | `+0.1.0` | 纯新功能,无 bugfix |
| `improvement` | `+0.0.1` | UI 调整、小功能增强、bugfix 混合,或以 UI/体验改进为主的迭代 |
| `bugfix` | `+0.0.1` | 纯 bug 修复,无新功能 |
| `docs` / `maintenance` / `refactor` | 默认不发版,除非用户明确要求 |
意图混合时以用户明确描述为准;bugfix + 小 feature 混合默认判定为 `improvement`(`+0.0.1`)。
## 必须同步更新的文件
使用 `git rev-parse --show-toplevel` 获取仓库根目录,以下路径均相对于根目录:
- `VERSION`
- `frontend/package.json`(`"version"` 字段)
- `pyproject.toml`(`version =` 字段)
- `uv.lock`(**不要手动编辑**,通过 `uv lock` 重新生成)
- `docs/CHANGELOG.md`
- `docs/version-history.md`
## 节省上下文规则
发版判断应以确定性 CLI 证据为主,优先使用紧凑命令和定点读取:
```bash
git status --short
git diff --stat HEAD
git diff --name-only HEAD
rg -n "version|^## |^Released:|当前开发版本|current" VERSION frontend/package.json pyproject.toml docs/CHANGELOG.md docs/version-history.md
```
除非需要判断某个代码变更是否属于本次发版,否则不要读取完整 diff。
## 执行步骤
### Step 1 — 环境检查
```bash
git branch --show-current # 确认在 dev 分支
git status --short # 检查是否有无关的未暂存修改
cat VERSION # 读取当前版本
```
若当前**不在 `dev` 分支**,停下来告知用户,不要继续。
若存在无关的未暂存修改,列出并询问用户是否一并提交,或先 stash。
### Step 2 — 确定发版类型与新版本号
- 若 `$ARGUMENTS` 提供了明确类型(`feature` / `bugfix`),直接使用
- 否则根据 `git diff --stat HEAD`、`git diff --name-only HEAD`、必要的 focused diff 和 `git log` 推断
- 计算新版本号(例:`0.26.2` → bugfix → `0.26.3`)
- **先输出发版计划供用户确认**:
```
发版计划:
类型:bugfix
版本:0.26.2 → 0.26.3
分支:dev
将更新:VERSION, frontend/package.json, pyproject.toml, uv.lock, CHANGELOG.md, version-history.md
```
### Step 3 — 更新版本号文件
按顺序更新(每步用 Edit 工具,精确替换,不要重写整个文件):
1. `VERSION` — 直接替换全部内容为新版本号
2. `frontend/package.json` — 替换 `"version": "x.x.x"` 行
3. `pyproject.toml` — 替换 `version = "x.x.x"` 行
4. 运行 `uv lock` 重新生成 `uv.lock`(在仓库根目录下执行)
### Step 4 — 更新 CHANGELOG.md
在文件顶部插入新条目,格式:
```markdown
## [x.x.x] — YYYY-MM-DD
### ✨ Features / 🐛 Fixes / 🔧 Improvements
- ...(只列高信号条目,最多 5 条)
- ...
---
```
日期使用 `date +%Y-%m-%d` 获取今天的日期。
### Step 5 — 更新 docs/version-history.md
- 更新文件头部的"当前开发版本"字段
- 在时间线表格顶部插入新行:`| vx.x.x | YYYY-MM-DD | 一句话摘要 |`
### Step 6 — 验证
针对本次变更范围做最小验证:
- Python 文件有修改:先用 `git diff --name-only HEAD -- '*.py'` 列出,再运行 `python3 -m py_compile <changed_files>`
- Frontend 文件有修改:先用 `git diff --name-only HEAD -- frontend` 判断范围,再运行项目标准检查(若无则跳过并说明)
- 版本号一致性检查:用 grep 确认 VERSION、package.json、pyproject.toml 中的版本号完全一致
```bash
cat VERSION
rg -n "\"version\":|^version =|version = " frontend/package.json pyproject.toml uv.lock
```
### Step 7 — 提交前预览
展示将要提交的文件列表:
```bash
git diff --stat HEAD
```
再次确认所有必须文件都在变更列表中,**不包含**非预期文件(如调试文件、.env 等)。
### Step 8 — Commit & Push(用户确认后)
```bash
git add VERSION frontend/package.json pyproject.toml uv.lock docs/CHANGELOG.md docs/version-history.md
# 若有代码变更也一并 stage
git add <code_files>
git commit -m "release: bump version to x.x.x"
git tag vx.x.x
git push origin dev
git push origin vx.x.x
```
commit message 固定格式:`release: bump version to x.x.x`
### Step 9 — 完成确认
输出摘要:
```
✓ 版本号已更新:0.26.2 → 0.26.3
✓ CHANGELOG 已更新
✓ version-history 已更新
✓ uv.lock 已重新生成
✓ 验证通过
✓ commit: release: bump version to 0.26.3
✓ tag: v0.26.3
✓ 已 push 到 origin/dev
```
## 注意事项
- `uv.lock` 只能通过 `uv lock` 生成,绝不手动编辑
- 发版 commit 只包含版本文件 + 本次功能代码,不混入无关改动
- 若环境中 `uv` 不可用,说明原因并跳过 lockfile 更新,提醒用户手动运行
Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 109 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 124 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 170 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 772 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 95 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 97 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

+73 -224
View File
@@ -1,6 +1,6 @@
# AGENTS.md
**AI Agent 角色设定。定义 AI 如何行为、沟通和工作。**
**Planet agent harness. Defines behavior for coding agents working in this repository.**
---
@@ -10,26 +10,32 @@ This file is the single authoritative agent guide for the Planet repository.
The older lowercase `agents.md` entry has been merged here so coding agents and
harness tools use one source of truth.
### Read First
### Source Of Truth
- `rules.md` is the mandatory repository rule source. Always load `core`,
`security`, and `workflow`; load only task-relevant modules after that.
- `AGENTS.md` defines the local agent operating mode and evidence gates.
- `project_context.md` is background, not a rule source. Prefer newer
implementation docs when it disagrees with current code.
- `.codex/skills/` is the active specialized workflow layer for cleanup, docs,
goal-driven work, and release.
- Do not duplicate long workflow text across harness files. Durable constraints
belong in `rules.md`; task procedures belong in skills or scripts.
Read these files before changing code:
1. `rules.md` - mandatory repository rules. Always load `core`, `security`, and
`workflow`; load `docs`, `uiux`, `frontend`, `backend`, `earth`, `ai`, or
`release` when the task touches those areas.
2. `AGENTS.md` - this file, including role, communication, workflow, and
harness compatibility guidance.
3. `project_context.md` - static project background. Prefer newer
implementation docs when this context disagrees with current code.
4. `README.md` - current architecture, startup, and toolchain summary.
5. `docs/HARNESS.md` - harness workflow, conflict policy, and validation tiers.
6. `CODEMAP.md` - codebase entry points, ownership boundaries, and deeper docs.
1. `rules.md`
2. `AGENTS.md`
3. `project_context.md`
4. `README.md`
5. `docs/HARNESS.md`
6. `CODEMAP.md`
For documentation work, also read `docs/documentation-coverage-rules.md`.
### Start Safely
Before editing:
Before broad edits:
```bash
git status --short
@@ -61,8 +67,9 @@ Full local validation:
scripts/harness/validate.sh
```
`validate.sh` includes the quick check and the frontend Bun build. Docker image
smoke builds are intentionally opt-in:
`validate.sh` includes quick checks, frontend Bun build, and frontend smoke
unless disabled by its documented environment flags. Docker image smoke builds
are intentionally opt-in:
```bash
PLANET_HARNESS_DOCKER_SMOKE=1 scripts/harness/validate.sh
@@ -103,229 +110,71 @@ behavior and document the compatibility note in `docs/harness-audit.md` or
---
## Identity
## Operating Mode
You are **opencode**, an AI coding assistant specialized in enterprise-level systems.
You are working on the **智能星球计划 (Intelligent Planet Plan)** - a situational awareness system for data-centric competition featuring:
- Python FastAPI backend
- React admin console, public Docs UI, and browser Web Earth shell
- AI Provider model gateway
- Multi-source data collection
- Future physical display directions such as UE5 / Cesium remain optional
roadmap work, not the active local development loop
- Default to acting directly when the user gives a clear task.
- Ask before acting only when the missing decision is risky, cannot be
discovered from repository context, and no conservative assumption is safe.
- Read relevant files before editing.
- Prefer focused CLI evidence: `rg`, `git diff --stat`, `git diff --name-only`,
focused file reads, tests, builds, linters, and harness scripts.
- Keep changes scoped to the requested area. Do not mix cleanup, feature work,
release work, and documentation unless the task requires it.
---
## Communication Style
## Evidence Gates
### Tone
- **Professional but concise**
- Technical accuracy with clarity
- No unnecessary verbosity
- Use code comments sparingly (explain **why**, not **what**)
### When Responding
1. **Answer directly** - 1-3 sentences for simple questions
2. **Use code blocks** for all code snippets
3. **Include file:line_number** references when discussing code
4. **Never** start with "I am an AI assistant" or similar phrases
5. **Never** add unnecessary preambles/postambles
### Examples
**Good:**
```
GPU clusters are stored in `backend/app/services/collectors/top500.py:45`.
```
**Bad:**
```
Based on the information you provided, I can see that the GPU clusters are stored in the top500.py file at line 45. Let me explain more about this...
```
- Visual inputs are blocking evidence. If the user provides a screenshot, image,
mock, browser capture, or visual reference, obtain evidence from the artifact
before interpreting intent or editing code.
- Path resolution is part of the task. If the path cannot be opened, first try
reasonable local equivalents such as WSL/Windows path conversion,
workspace-relative lookup, absolute paths, and attached-file locations.
- Never guess from prompt text, filenames, previous context, logs, OCR, or
memory when a visual artifact was provided but cannot be accessed.
- OCR is acceptable evidence for text-only visual questions or non-multimodal
environments; state that OCR was used as the fallback. Layout, color, spacing,
pixel, and rendering issues need real visual inspection or a clear limitation
note.
- If a visual artifact still cannot be inspected, say so and pause that
visual-dependent part of the work.
- Claims of completion need evidence: a relevant test, build, lint, screenshot,
diff, direct file check, or harness result.
- For UI and rendering changes, verify the rendered result when local tooling
allows it.
---
## Operational Mode
## Communication
### Plan Mode (default for complex tasks)
- Analyze requirements
- Propose architecture
- Confirm with user before execution
- **DO NOT** write code until approved
### Build Mode (after user approval)
- Execute the approved plan
- Write code, run commands
- Verify results
- Report completion concisely
### Read-Only Mode
- Analyze code
- Explain functionality
- Answer questions
- **DO NOT** modify files
- Match the user's language. Use Chinese for Chinese requests unless the user
asks otherwise.
- Keep updates short and specific: what is being inspected, edited, or verified.
- Final responses should summarize changed files and verification, with blockers
stated plainly.
- Use file references with line numbers when explaining code or review findings.
---
## Decision Framework
## Quality Bar
### When to Ask Before Acting
- Unclear requirements
- Multiple implementation approaches
- Architecture changes
- Dependency additions
- Anything that could break existing functionality
### When to Act Directly
- Clear, approved requirements
- Routine tasks (linting, formatting, running tests)
- Following established patterns
- Fixing obvious bugs
### When to Refuse
- Malicious code requests
- Security violations (secrets, credentials)
- Anything that violates `rules.md`
- Prefer existing project patterns over new abstractions.
- Remove stale branches, mocks, compatibility paths, and duplicated helpers once
a stable path exists.
- Centralize prompts, constants, defaults, and shared request/response handling.
- Do not add secrets, generated runtime output, or local environment files.
- Frontend commands use Bun only. Do not use `npm`, `pnpm`, or `yarn`.
- Run the smallest relevant verification for the changed scope and report
anything skipped.
---
## Working Principles
## Prohibited
### 1. First Understand, Then Act
- Read relevant files before editing
- Understand existing patterns and conventions
- Follow the code style in the codebase
- Match the project's technology choices
### 2. Incremental Progress
- Break large tasks into smaller PRs
- Complete one feature before starting the next
- Run tests after each significant change
- Commit frequently with clear messages
### 3. Quality First
- Write tests for new functionality
- Run linters before committing
- Fix warnings, don't ignore them
- Document non-obvious decisions
### 4. Communication Clarity
- Use precise technical language
- Show relevant code, not explanations
- Report errors with context
- Confirm understanding of requirements
---
## Code Review Checklist
Before marking a task complete:
- [ ] Code follows `rules.md` style guidelines
- [ ] Type hints are correct and complete
- [ ] Error handling is proper (no silent failures)
- [ ] Tests pass locally
- [ ] Linting passes
- [ ] No TODO comments left behind
- [ ] Documentation updated if needed
- [ ] Commit message is clear
---
## Common Workflows
### Feature Development
```
1. Understand requirements
2. Check existing patterns in codebase
3. Design solution (brief mental model)
4. Write code following rules.md
5. Write/run tests
6. Lint and format
7. Commit with clear message
8. Report completion
```
### Bug Fix
```
1. Reproduce the bug (write failing test)
2. Locate the source
3. Fix the issue
4. Verify test passes
5. Check for regressions
6. Commit fix
```
### Refactoring
```
1. Understand current behavior
2. Design target state
3. Make incremental changes
4. Preserve tests
5. Verify functionality
6. Clean up dead code
```
---
## Special Considerations
### WebSocket Services
- Implement heartbeat mechanism (30-second intervals)
- Handle disconnection gracefully
- Include camera position in control frames
- Support both update and full sync modes
### Data Collectors
- Inherit from BaseCollector
- Implement fetch() and transform() methods
- Support incremental updates
- Handle API changes gracefully
### UE5 Integration
- Communicate via WebSocket
- Send data frames at configurable intervals (default 5 min)
- Support auto-cruise and manual modes
- Optimize for 4K@120Hz rendering
### Multi-User Security
- JWT tokens with 15-minute expiration
- Redis token blacklist for logout
- Role-based access control (RBAC)
- Audit logging for all actions
---
## Output Format
### When Writing Code
```python
# File: backend/app/services/collectors/top500.py
from typing import List, Dict
class TOP500Collector:
async def fetch(self) -> List[Dict]:
...
```
### When Explaining
- Use concise paragraphs
- Include code references
- No conversational filler
### When Reporting Progress
- What was done
- What remains
- Any blockers
- Next action
---
## Remember
1. **Rules are hard constraints** - follow `rules.md` absolutely
2. **Context provides understanding** - use `project_context.md` for background
3. **Role defines behavior** - follow `AGENTS.md` for how to work
4. **Quality over speed** - Enterprise systems require precision
5. **Communicate clearly** - Precision in, precision out
- Do not skip visual evidence handling when a visual artifact was provided.
- Do not preserve obsolete harness files just because they already exist.
- Do not invent behavior not present in code, docs, or verified external
sources.
- Do not rewrite unrelated files during cleanup.
- Do not mark a task complete without checking concrete success criteria.
+3 -1
View File
@@ -168,10 +168,12 @@
## 快速启动
入口需要先具备 `zsh`、`curl` 和可访问的软件源。Ubuntu / Ubuntu WSL 上,`init` 会自动检测并补装 Docker Engine、Compose v2 和 Buildx,启动 Docker 服务并配置当前用户的访问权限;需要系统权限时会提示输入 sudo 密码。其他系统请先准备可用的 Docker 环境。
```bash
# 新机器或空项目首次初始化
./planet.sh init
# 会自动安装/检查 uv、bun,同步 Python/前端依赖
# 会先准备 Docker / Compose / Buildx,再安装/检查 uv、bun 并同步 Python/前端依赖
# 会在缺少时生成 backend/.env、aiprovider/.env、frontend/.env.local
# 会启动 PostgreSQL/Redis,并创建表、默认数据源和本地默认用户
+1 -1
View File
@@ -1 +1 @@
0.73.0
0.74.3
+2 -2
View File
@@ -865,9 +865,9 @@ def _get_locale_text(
if isinstance(fallback, dict):
value = _coerce_str(fallback.get(key))
if value:
if locale == "en-US" and _contains_cjk_text(value):
return ""
return value
if locale == "en-US" and _is_chinese_language(item.content_language):
return item.title if key == "title" else item.summary
return ""
+8 -1
View File
@@ -384,7 +384,14 @@ def test_parse_chinese_rss_marks_source_language_and_keeps_zh_localization():
assert items[0].content_language == "zh-CN"
assert items[0].localizations["zh-CN"]["title"] == "中国电商平台发布季度增长数据"
assert payload_zh["display_title"] == "中国电商平台发布季度增长数据"
assert payload_en["display_title"] == "中国电商平台发布季度增长数据"
assert payload_en["display_title"] == ""
items[0].localizations["en-US"] = {
"title": "Chinese e-commerce platform reports quarterly growth",
"summary": "The platform said cross-border orders rose year over year.",
}
payload_en_ready = _serialize_item(items[0], active_region="global", locale="en-US")
assert payload_en_ready["display_title"] == "Chinese e-commerce platform reports quarterly growth"
def test_default_news_sources_include_business_and_ecommerce_sources():
+68
View File
@@ -8,6 +8,74 @@ This project follows the repository versioning rule:
- `improvement` -> `+0.0.1`(bugfix + 小功能混合)
- `bugfix` -> `+0.0.1`
## [0.74.3] — 2026-09-13
Released: 2026-09-13
### Highlights
- Ubuntu / WSL 新机器初始化会自动检测并准备 Docker Engine、Compose v2、Buildx 和当前用户权限,减少手工安装步骤。
- 数据库初始化先核对容器端口与后端真实连接,连接和认证通过后才创建表和默认数据。
### Added / Fixed / Improved
- 区分 Docker CLI 缺失、服务未安装、daemon 不可用及 socket 权限不足,修正未安装 Docker 时误提示启动 socket 的诊断。
- 自动补齐缺失的 Docker 依赖并启动本地服务,以原用户身份刷新 Docker 组权限;保留参数和 PATH,不依赖 sg。
- 通过 Compose 同步已有 PostgreSQL / Redis 容器配置,保留端口冲突等具体错误;端口映射异常时最多保留数据卷重建一次 PostgreSQL。
- 新增后端数据库只读连接检查,对认证、库名和网络失败给出不含密码或完整连接串的诊断。
- 将 Docker 与数据库启动隔离回归测试接入快速检查,并同步 README、harness 和中英文运维说明。
---
## [0.74.2] — 2026-07-01
Released: 2026-07-01
### Highlights
- 收敛 agent harness 到 `rules.md`、`AGENTS.md`、`docs/HARNESS.md` 和 `.codex/skills/`,删除重复维护的旧 Claude command 入口。
- 强化视觉证据规则:截图或视觉引用路径打不开时必须先处理 WSL/Windows 路径、相对路径和附件位置,而不是跳过后猜测。
- 明确 OCR 可作为文本类视觉证据或非多模态环境 fallback,同时要求布局、颜色、像素和渲染类问题保留真实视觉验证或明确限制说明。
### Added / Fixed / Improved
- `AGENTS.md` 替换旧 opencode/默认 Plan Mode 内容,保留最新单一入口和 harness 验证说明。
- `rules.md` 与 `docs/HARNESS.md` 同步 Visual Evidence Gate,补齐路径解析、访问失败报告和 OCR fallback 边界。
- 删除 `.claude/commands/*` 中与 `.codex/skills/*` 重复的旧 cleanup/docs/goal-driven/release 入口,并更新文档受众计划中的旧路径引用。
---
## [0.74.1] — 2026-06-30
Released: 2026-06-30
### Highlights
- 将 `/earth-content` 的品牌标识上传收敛到 `Logo 地址` 与 `标题图地址` 字段内,移除旧的全局“选择资产/上传”工具栏。
- 新增字段级图片拖拽反馈,拖到对应字段时直接提示将图片复制为 Logo 或标题图。
- 对齐品牌上传按钮到现有 Tactile UI primary 按钮样式,并同步中英文使用手册、快速开始和控制台上下文文档。
### Added / Fixed / Improved
- `BrandAssetInput` 支持字段内选择文件、拖拽上传、单字段 loading 和上传后回写草稿 URL。
- `FieldGrid` 支持按字段注入自定义输入控件,同时复用统一草稿提交路径。
- 品牌上传拖拽态改为低饱和 tactile 配色,上传按钮保持蓝色轻立体样式,容器内上下/右侧留白对齐为 3px。
- 补齐品牌上传相关 legacy UI 英文翻译、术语对照和用户文档。
---
## [0.74.0] — 2026-06-30
Released: 2026-06-30
### Highlights
- 扩展统一 i18n 到 Web Earth、控制台、认证页和公开 Docs 的更多动态入口,减少英文界面中文残留。
- 强化 Earth HUD 的通知胶囊、品牌栏、语言 switch、图例、tooltip、详情卡、新闻和 TV 文案展示,避免英文态裁切或错位。
- 将容易遗漏的 i18n 入口和视觉回归加入 harness,让 smoke 覆盖通知位置、内容宽度、语言切换状态和动态文案。
### Added / Fixed / Improved
- 新增 Earth runtime i18n 入口,统一高清材质、启动状态、错误提示和图层状态文案来源。
- 补齐国家名、属性名、卫星 legend、详情页 tooltip、新闻/TV 默认文案和 API 错误提示的英文翻译与回退。
- 更新控制台与 Earth 布局规则,保留 brand 尺寸语义,同时让标题、副标题和通知胶囊按内容完整显示。
- 扩展 frontend smoke 与 harness 文档,固化一屏高度链、i18n 动态入口、胶囊/tag overflow 和截图证据要求。
- 更新 Earth 新闻本地化服务与测试,确保英文界面新闻内容不再回退中文 UI 文案。
---
## [0.73.0] — 2026-06-29
Released: 2026-06-29
+86 -4
View File
@@ -84,7 +84,7 @@ git diff --unified=0 HEAD -- <path>
| Doctor | `scripts/harness/doctor.sh` | Checks required files, required tools, optional delivery tools, and forbidden frontend lockfiles. |
| Security | `scripts/harness/security-check.sh` | Checks that environment/private-key files are not tracked and scans for high-confidence committed secret tokens. |
| Backend Rules | `scripts/harness/backend-rules-check.sh` | Checks backend app Python for direct `print()`, `breakpoint()`, and `pdb.set_trace()` debug calls so service code uses structured logging. |
| Frontend Rules | `scripts/harness/frontend-rules-check.sh` | Checks Bun-only scripts, admin route manifest coherence, literal internal route links, admin search route targets, frontend debug output, native button safety, icon-button accessibility, no nested Cards, no AntD/Space layout primitives, ConnectionTestInput usage, admin/docs shell height-chain sizing, viewport-scaled font sizes, zero letter spacing, and high-signal UI rule warnings. |
| Frontend Rules | `scripts/harness/frontend-rules-check.sh` | Checks Bun-only scripts, admin route manifest coherence, literal internal route links, admin search route targets, frontend debug output, native button safety, icon-button accessibility, no nested Cards, no AntD/Space layout primitives, ConnectionTestInput usage, admin/docs shell height-chain sizing, same-category style owner warnings, viewport-scaled font sizes, zero letter spacing, and high-signal UI rule warnings. |
| Docs Consistency | `scripts/harness/docs-consistency-check.sh` | Checks frontend Docs metadata against backend Gatekeeper metadata, public Docs registration, full technical-doc bilingual file pairs, public doc links, readable link titles, language-scoped technical links, README/project-context admin stack drift, supported credential collector contracts, manual console route coverage against the actual admin manifest, documented UI route drift, documented `?section=` deep-link validity against the actual admin section config in technical docs and active plan docs, and the harness rules-coverage notes. |
| Quick | `scripts/harness/quick-check.sh` | Runs doctor, whitespace diff check, shell syntax checks, security scan, backend/frontend/doc consistency checks, and CI backend smoke tests. |
| Full | `scripts/harness/validate.sh` | Runs quick check, frontend Bun install/build, Playwright route smoke, optional Helm checks, and opt-in Docker image smoke builds. |
@@ -130,6 +130,71 @@ PLANET_HARNESS_FRONTEND_SMOKE=0 scripts/harness/validate.sh
PLANET_HARNESS_FRONTEND_SMOKE_PORT=4174 scripts/harness/validate.sh
```
### Visual Evidence And Style Consistency
- Treat user-provided screenshots and images as primary visual evidence. If a
screenshot contradicts written text, inspect the image first and explicitly
call out the mismatch before deciding what to change.
- Path resolution is part of visual evidence handling. If a referenced
screenshot path cannot be opened, try reasonable local equivalents first:
WSL/Windows path conversion, workspace-relative paths, absolute paths, current
thread attachments, repository files, and obvious local attachment/download
locations.
- If the image still cannot be found or opened, report the exact path/access
blocker instead of guessing. Do not infer image content from the filename, alt
text, surrounding prose, logs, or memory.
- OCR is acceptable evidence for text-only questions or non-multimodal
environments; state when OCR was the fallback. Layout, color, spacing, pixel,
and rendering issues still require a real visual inspection or an explicit
"could not verify visually" note.
- Same-category UI surfaces must use one visual system per product area. Badges,
chips, pills, tags, status labels, small buttons, cards, panels, and toolbar
controls should reuse the shared component, shared token, or established CSS
owner for that area instead of introducing a page-local lookalike.
- `scripts/harness/frontend-rules-check.sh` warns when semantic
`badge` / `chip` / `pill` / `tag` / `status` selectors appear outside the
approved React and Earth CSS owner files. A warning means the reviewer should
either move the style into the shared owner or document why this is a genuinely
new visual family.
### Earth I18n Harness Rules
Earth i18n work must validate rendered behavior, not only static text lookup.
Agents often miss dynamic strings that are created after initial page load, so
the smoke treats these as first-class i18n surfaces:
- **Visible text and attributes**: translated checks must include `innerText`
plus `title`, `aria-label`, `placeholder`, and `alt`. Tooltips and icon-only
buttons are user-facing copy, not implementation details.
- **Dynamic detail cards**: info cards opened from Earth markers, cruise cards,
BGP markers, compute centers, vessels, and news must render field labels,
status values, source tags, action buttons, and disabled/tooltips in the active
language.
- **English content safety**: English mode must not fall back to Chinese news
titles, summaries, feed names, measure words, or generic status labels. If no
English localization exists, hide the item or use a neutral English fallback.
- **Brand assets**: locale switching must update both text and image assets.
The default Earth HUD brand uses `title-zh.png` for Chinese and `title-en.png`
for English while keeping the same top-left layout and logo position.
- **Controls and state**: switch/segmented-control visuals must follow the real
checked/pressed state after both direct clicks and programmatic panel changes.
A control is not valid if the state changes but the thumb, active pill, or
`aria-*` state stays stale.
- **Runtime copy entrypoints**: dynamic status, loading, startup, and error copy
must enter through `earthMessage(...)` plus the centralized
`EARTH_MESSAGE_TEMPLATES` map. Do not hide direct strings behind
`showStatusMessage`, `queueStatusMessage`, `showGestureStatusMessage`,
`showError`, `setLoadingMessage`, `resolveStartupMessage`, `startupMessage`,
or `earth:status` events.
- **Capsules and tags**: pills, tags, chips, badges, and small buttons must not
overflow their panel. Prefer a slightly wider owning panel for important
status information; otherwise use `min-width: 0`, wrapping, or ellipsis with a
translated tooltip.
Current frontend smoke explicitly covers the Earth English locale flow: brand
image swap, settings language controls, panel switch visual sync, English news
filtering, English detail-card text and tooltips, and TV default/source labels.
## Environment Requirements
Required for normal development:
@@ -155,9 +220,26 @@ Optional for delivery smoke:
- Docker daemon for image builds
- Helm for chart lint/template checks
If a required local tool is missing, do not install system software
automatically. Report the gap and point to `./planet.sh init` or
`scripts/bootstrap-dev.sh` as the existing bootstrap path.
For routine harness validation, do not install missing system software
automatically. Report the gap and point to the explicit bootstrap entry points.
`./planet.sh init` can install missing Docker Engine, Compose v2, and Buildx on
Ubuntu / Ubuntu WSL, start the local service, and configure Docker group access.
This bootstrap behavior is intentional; do not invoke it merely to make harness
checks pass. `scripts/bootstrap-dev.sh` only prepares application dependencies.
Docker bootstrap regression checks use isolated command stubs and never install
packages or modify the host daemon:
```bash
uv run --frozen --project . python scripts/harness/test_docker_bootstrap.py
uv run --frozen --project . python scripts/harness/test_database_startup.py
```
Database startup regressions also run in quick-check. They cover Compose
reconciliation of existing containers, visible startup errors, published-port
checks, bounded recreation that preserves volumes, and the backend connection
gate before schema initialization. Their command stubs and driver mocks do not
modify the host Docker environment.
## What Agents Must Not Change Automatically
+4 -1
View File
@@ -102,6 +102,8 @@ The repository uses `.gitea/workflows/`, not `.github/workflows/`.
| Admin/docs shell layouts can reintroduce brittle viewport sizing after a responsive fix. | Changed the admin and Docs route shells to use the existing `html/body/#root` 100% height chain, and added a frontend rules failure for exact `100vh` / `100vw` shell sizing in those CSS files. |
| Compact workspaces can drift back into card-in-card layouts or implicit AntD `Space` wrappers. | Added frontend rules failures for nested `Card` components, AntD imports, and `<Space>` layout primitives in active frontend source. |
| Connection-test controls can drift back into detached toolbar buttons. | Added a shared `ConnectionTestInput` suffix pattern for AI Provider and WebSearch Base URL fields, disabled WebSearch configuration/test controls when the tool is off, and made the frontend rules check fail detached AI/WebSearch connection-test buttons. |
| Same-category UI styles can fragment into page-local lookalikes. | Added same-category style owner warnings for semantic `badge`, `chip`, `pill`, `tag`, and `status` CSS selectors outside the approved shared React and Earth CSS owner files. |
| Visual fixes can go wrong when agents guess from missing screenshot paths. | Documented screenshots and images as primary visual evidence: if the path is not available, agents must search alternate attachment/local locations or report the blocker instead of inferring image content. |
| Public docs can reference stale admin section URLs. | Added docs consistency validation for documented `?section=` links and rendered smoke coverage for documented AI / collector deep links. |
| Active plan docs can preserve old admin deep-link assumptions after the technical docs are corrected. | Extended docs consistency checks to active `docs/plans/*.md` files for stale admin tab-query terms and actual `?section=` validity; corrected the docs audience split plan to current section routes. |
| Top-level README can drift from the actual frontend stack while technical docs stay current. | Updated README from Ant Design Pro to Tactile UI / Radix primitives / lucide-react and added README stale admin-stack terms to docs consistency checks. |
@@ -135,6 +137,7 @@ index is the routing layer; this table is the coverage/evidence layer.
| `docs` | User manuals must match real console routes and deep links. | `docs-consistency-check.sh` compares manual console tables with `frontend/src/admin/routes/manifest.tsx` and validates documented `?section=` links from actual `AdminRoutes.tsx` plus `PlainResourcePages.tsx` section config. | Screenshots and UI-copy nuance are not exhaustively validated. |
| `uiux` | Admin pages are compact single-screen workspaces with explicit overflow ownership. | `frontend-rules-check.sh` fails missing admin shell height-chain declarations (`.admin-theme-root`, `.admin`, `.admin__sider`, `.admin__nav-scroll`, `.admin__account`, `.admin__content`, `.admin__content-inner`), warns on suspicious `overflow: hidden`, and blocks exact `100vh` / `100vw` shell sizing in admin/Docs CSS. `frontend-smoke.mjs` checks every admin route at desktop/mobile and verifies `.admin` equals viewport height, `#root`/document/body have no vertical overflow, and desktop sidebar account/preferences stay in the first viewport. Zoom passes still cover 125% / 150% rendering. | Visual density, hierarchy, and whether a scroll owner feels ergonomic remain manual QA. |
| `uiux` | Controls use expected patterns and accessible icon buttons. | `frontend-rules-check.sh` blocks icon `Button` without `aria-label` and `title`, native `<button>` without explicit `type`, nested Cards, AntD imports, `<Space>`, and detached connection-test buttons. Smoke exercises search, tabs, dialogs, data toggles, and connection-test actions. | Native buttons with visible text are not treated as icon-only by static checks; semantics still need review when adding custom controls. |
| `uiux` | Same-category visual surfaces should use one style system per product area. | `frontend-rules-check.sh` warns when semantic `badge`, `chip`, `pill`, `tag`, or `status` selectors appear outside approved shared React and Earth CSS owner files. `docs/HARNESS.md` also makes screenshots/images primary evidence for visual fixes and forbids guessing when an image path is unavailable. | Final visual cohesion across screenshots still needs human/Playwright review, especially for page-specific cards, panels, and toolbar controls that static selector checks cannot classify perfectly. |
| `uiux` | Text should fit, avoid viewport-scaled font sizes, and keep letter spacing at zero. | `frontend-rules-check.sh` fails viewport/container-width font-size units and non-zero `letter-spacing` / `letterSpacing`. `frontend-smoke.mjs` checks rendered routes for global overflow across desktop/mobile. | Per-element text clipping without page-level overflow is not exhaustively detected and needs visual review for changed screens. |
| `frontend` | Keep shared behavior in reusable components and existing project patterns. | `frontend-rules-check.sh` enforces shared `ConnectionTestInput`, route/link/search consistency, no debug output, native button safety, Tactile/Radix/lucide direction instead of AntD/Space, and whitelist-driven public Docs. `bun x tsc --noEmit` and `bun run build` verify TypeScript/build health. | Broad casts, inline styles, and overflow issues are warnings when context may be legitimate; review changed lines before accepting them. |
| `frontend` | Responsive adaptations must preserve the primary action path. | `frontend-smoke.mjs` clicks every visible admin menu entry on desktop and mobile, opens protected routes unauthenticated and authenticated, verifies root/unknown route fallback, and exercises core auth flows. | Deep feature workflows beyond smoke data, such as destructive or long-running actions, require targeted tests before behavior changes. |
@@ -151,7 +154,7 @@ index is the routing layer; this table is the coverage/evidence layer.
| `scripts/harness/doctor.sh` | Environment and repository-shape check. |
| `scripts/harness/security-check.sh` | High-confidence secret and tracked environment/key file check. |
| `scripts/harness/backend-rules-check.sh` | Backend app debug-call guard for direct stdout/debugger usage. |
| `scripts/harness/frontend-rules-check.sh` | Bun-only, route manifest, literal internal link, admin-search route target, debug-output, native-button safety, icon-button accessibility, Card nesting, AntD/Space avoidance, ConnectionTestInput, admin shell one-screen height-chain declarations, admin/docs shell viewport sizing, viewport-font, zero-letter-spacing, and UI rules static check. |
| `scripts/harness/frontend-rules-check.sh` | Bun-only, route manifest, literal internal link, admin-search route target, debug-output, native-button safety, icon-button accessibility, Card nesting, AntD/Space avoidance, ConnectionTestInput, admin shell one-screen height-chain declarations, admin/docs shell viewport sizing, same-category style owner warnings, viewport-font, zero-letter-spacing, and UI rules static check. |
| `scripts/harness/docs-consistency-check.sh` | Frontend/backend Docs metadata alignment, public Docs metadata, full technical-doc bilingual pair, link-title, language-scoped technical link, supported credential collector contracts, manual console route coverage, documented route, admin-config-derived section deep-link consistency, and harness rules-coverage note check. |
| `scripts/harness/frontend-smoke.mjs` | Playwright route, Docs detail/language/theme/search interaction, public auth form interaction, desktop/mobile/zoom rendering, admin shell one-screen/overflow checks, safe admin navigation/search/tab/dialog/Earth News interactions, and authenticated admin route/section smoke for the built frontend preview. |
| `scripts/harness/quick-check.sh` | Fast deterministic local validation. |
+3 -3
View File
@@ -3,7 +3,7 @@
**状态**:待实施
**创建日期**:2026-05-12
**校正日期**:2026-06-26,控制台深链已从旧 tab 查询口径更新为当前 `?section=` 口径。
**核心目标**:把 `docs/technical/{zh,en}/manual.md` 拆成"纯客户视角"的使用手册,把 `planet.sh`、日志、LAN、故障排查这类运维内容迁到独立 `ops-runbook.md`,并把分层规则写进 `documentation-coverage-rules.md` 和 `.claude/commands/docs.md`,让以后写文档时自动按受众归档。
**核心目标**:把 `docs/technical/{zh,en}/manual.md` 拆成"纯客户视角"的使用手册,把 `planet.sh`、日志、LAN、故障排查这类运维内容迁到独立 `ops-runbook.md`,并把分层规则写进 `documentation-coverage-rules.md` 和 `.codex/skills/docs/SKILL.md`,让以后写文档时自动按受众归档。
## 背景
@@ -80,7 +80,7 @@
> - 新增客户可见 UI 流 → 同时更新 `manual.md` zh+en 与 `docs-content.ts`
> - 新增 ops 命令或脚本 → 只更新 `ops-runbook.md` zh+en
## .claude/commands/docs.md 增量
## `.codex/skills/docs/SKILL.md` 增量
在 "Step 2 — Decide Scope" 后插一段:
@@ -100,7 +100,7 @@
- `docs/technical/zh/quickstart.md` & `en/quickstart.md` — 重写
- `docs/technical/zh/ops-runbook.md` & `en/ops-runbook.md` *(新)*
- `docs/documentation-coverage-rules.md` — 加受众分层段
- `.claude/commands/docs.md` — 加 Document Audience Routing 段
- `.codex/skills/docs/SKILL.md` — 加 Document Audience Routing 段
- `frontend/src/pages/Docs/docs-content.ts` — 注册 `ops-runbook` 到 `DOCS_METADATA`(`docs_admin` 组)
## 依赖
+7 -1
View File
@@ -75,7 +75,11 @@ This is currently the most critical UI control entry point for the Earth fronten
Earth settings are now grouped by `data-settings-tab` and `data-settings-tab-panel`. Desktop and mobile share the same category semantics: Runtime, Display, Panels, Motion, Shortcuts, and System. When adding a setting, first choose its category, then add the DOM, persistence field, and restore logic; do not keep growing one long undifferentiated panel.
The news category selector in Display reuses the same chip-selector pattern as Cruise Modules. It only filters news categories for the current browser on the Earth frontend. It does not toggle layers, basemap, boundaries, TV, data points, BGP, vessels, satellites, or compute centers; those remain owned by the layer panel, media panel, and admin configuration. `controls.js` persists only `shared.newsCategoryFilters` and broadcasts `earth:news-category-filters-change`; `news.js` sends the selected categories to `/api/v1/news/earth-feed?categories=...&locale=zh-CN`, so Web and UE clients share the same backend category filtering path.
Earth runs inside an independent iframe / static application, so it cannot directly reuse React Admin's `react-i18next` context. `public/earth` uses its own [i18n.js](/home/ray/dev/linkong/planet/frontend/public/earth/js/i18n.js) runtime to read and write the global `planet-locale`, while keeping the legacy `docs-lang` in sync. This keeps Docs, the console, and Earth on the same language preference. The language switch belongs in the Settings `System` tab, and desktop/mobile both use the same `data-earth-locale` buttons; do not put language selection into layer, display, or runtime-mode settings.
The news category selector in Display reuses the same chip-selector pattern as Cruise Modules. It only filters news categories for the current browser on the Earth frontend. It does not toggle layers, basemap, boundaries, TV, data points, BGP, vessels, satellites, or compute centers; those remain owned by the layer panel, media panel, and admin configuration. `controls.js` persists only `shared.newsCategoryFilters` and broadcasts `earth:news-category-filters-change`; `news.js` sends the selected categories and current locale to `/api/v1/news/earth-feed?categories=...&locale=...`, so Web and UE clients share the same backend category filtering path.
In English mode, Earth news must render only English title/summary text. Chinese source items without `en-US` localization are filtered from the visible cards/ticker/cruise until the backend enrichment finishes, and source/feed labels fall back to English-safe names instead of rendering Chinese labels.
The news panel, ticker, and news cruise must consume `items` / `cruise_items` from the same `/api/v1/news/earth-feed` response instead of keeping separate regional caches. `news.js` builds a refresh request key from region, category, source, and limit; only concurrent requests with the same key reuse the promise, and stale responses from an older region are dropped by token. Source filtering is also region-scoped: when the user moves from Asia Pacific to Europe or another region, source IDs saved for the old region must not be appended to the next fetch. After the new payload arrives, the saved source list is intersected with the available `sources`; if the intersection is empty, the current region falls back to all available sources. This keeps the ticker, panel, and cruise cards aligned after region switches.
@@ -242,6 +246,8 @@ Earth settings are stored in `localStorage`. The key is typically a namespaced s
Settings that affect visual layers and surface interaction (terrain opacity, day/night mode, satellite display style, satellite idle breathing, real satellite altitude, track display, hover tooltip mode, etc.) are read during initialization and applied immediately.
Language preference is the exception: Earth language is not a private `planet.earth.settings.v2` field. It shares `planet-locale` with Docs/Admin. When language changes, `i18n.js` updates `document.documentElement.lang`, translates static and dynamically inserted DOM, synchronizes language button state, and passes the current locale to news requests. The news module refreshes after a language change so an English UI does not reuse a Chinese news payload.
The surface hover tooltip preference is persisted by `controls.js` as `shared.surfaceHoverInfoMode`, while `main.js` composes the actual tooltip in the globe-surface hover branch. `Country` shows country details only when a country polygon is hit and stays silent over ocean; `Position` shows latitude, longitude, and sampled terrain elevation and clears country-boundary hover; `Full` shows country + position on land and position over ocean.
The real satellite altitude preference is persisted by `controls.js`, while the rendering state lives in `satellites.js`. When enabled, the real radius from SGP4 is compressed logarithmically into the current Earth visual radius range. When disabled, satellite dots, trails, and predicted orbits all return to the legacy same-sphere display. Toggling this setting must refresh satellite positions and clear trail buffers so a trail never mixes both height models. `maxRealAltitudeOffset = 25` is a visual cap tuned for the current camera and `earthRadius = 100`: GEO / MEO remain clearly higher than LEO, but the highest orbits stay within about 25% beyond the globe radius so selection targets, red trails, and the globe do not feel disconnected.
+2
View File
@@ -144,6 +144,8 @@ The Web Earth client and UE client both consume `GET /api/v1/news/earth-feed`. T
- `categories`: comma-separated news category keys, for example `business,ecommerce`. Omit it when all categories are selected.
- `locale`: display locale, currently `zh-CN` or `en-US`, defaulting to `zh-CN`. Chinese RSS items are stored as Chinese source content and enriched with `en-US`; English RSS items are enriched with `zh-CN`.
For `locale=en-US`, the API must not fall back to Chinese source title/summary. If a Chinese source item has not yet received an `en-US` localization, `display_title` and `display_summary` stay empty so the Earth client can show an English pending/empty state instead of mixing languages.
Examples:
```http
@@ -387,6 +387,7 @@ Current boundary:
`/earth-content` reuses the same single-screen tab container from [Settings.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx), but its ownership is separate from System Settings:
- `TV Livestream` owns the Earth media-panel source configuration.
- `Branding` owns Earth HUD brand assets. `Logo URL` and `Title Image URL` use inline upload controls inside the fields; the upload buttons keep the primary `TactileButton` style, and dropping an image onto the matching field shows a low-saturation drag reaction instead of the old global asset-picker toolbar.
- `Boundary Precision` owns the Earth static boundary asset state: provider, low-precision fallback, high-precision manifest/PMTiles, source JSON, and build action.
- `Base Map`, `Layer Resources`, `3D Assets`, and `News Anchor Strategy` are placeholders only. They show module status and do not invent fake APIs or fake data.
+1 -1
View File
@@ -192,7 +192,7 @@ TV livestreams and boundary precision moved to `/earth-content`; collectors and
`/earth-content` is under the console's Operations and Configuration group and owns resources used by the Earth frontend:
- **Brand Assets**: manages the logo, title image, title text, subtitle, and description used by the Earth HUD. Uploaded images are saved as Earth brand assets and read by the Earth page immediately.
- **Brand Assets**: manages the logo, title image, title text, subtitle, and description used by the Earth HUD. The `Logo URL` and `Title Image URL` fields each include their own Upload button, and image files can be dropped directly onto the matching field. After upload, the field receives the new asset URL; save the brand configuration to make the Earth page use it.
- **About**: manages the About card shown in Earth settings, including logo, kicker, title, version, description, and metadata.
- **TV Livestream**: manages sources shown in the Earth media panel.
- **News Content**: browses news grouped by RSS source and manual group. RSS items remain read-only; manual groups support create, JSON import, edit, delete, and reprocess.
+3
View File
@@ -28,6 +28,9 @@ This document standardizes terms used across Intelligent Planet, the console, ba
| AI Provider | AI Provider | Service name |
| tool | 工具 | Web Search, OCR, and similar integrations |
| Playground | Playground | Interactive debugging entry |
| branding | 品牌标识 | Earth HUD brand configuration section under `/earth-content` |
| brand assets | 品牌资源 | Logo, title image, and related HUD copy assets |
| title image | 标题图 | Earth HUD title image |
## Data Types
+42
View File
@@ -2,6 +2,48 @@
This runbook is for deployment, on-call, and maintenance engineers. End-user UI flows live in the [Intelligent Planet Manual](/home/ray/dev/linkong/planet/docs/technical/en/manual.md); this document only covers shell, Docker, logs, environment variables, and troubleshooting.
## Docker Initialization and Access
Initialize a new machine before starting the application services:
```bash
zsh ./planet.sh init --non-motion-agent && zsh ./planet.sh start --non-motion-agent
```
The entry point still requires `zsh`, `curl`, and reachable package repositories. Before synchronizing Python and frontend dependencies, `init` prepares Docker:
- Reuse working Docker, Compose v2, and Buildx (at least 0.17.0).
- On Ubuntu / Ubuntu WSL, use apt to install the missing parts of `docker.io`, `docker-compose-v2`, and `docker-buildx`. When Docker CE CLI is already installed, use the configured Docker CE repository and corresponding plugin packages to keep the package family consistent.
- If the local daemon is unavailable, check that `docker.service` exists, then enable and start it. WSL must have systemd enabled; unavailable service management produces an explicit Docker preparation error.
- If the current user cannot read and write the Docker socket, check for `usermod`, install its `passwd` package when needed, and add the user to the `docker` group. This group grants privileged control of the local Docker engine. The script uses `sudo` to refresh group access as the original user and continue the original command with its arguments preserved. It does not depend on `sg` or run application processes as root.
When elevation is needed, sudo authentication runs in the foreground. Missing sudo for an unprivileged user, authentication failure, repository errors, or insufficient versions after installation stop initialization with a specific error.
Subsequent `planet.sh start` and other service commands in the same old terminal also refresh Docker group membership when it has been granted but is not yet active. Open a new Ubuntu session to use `docker` directly in the terminal.
When Docker Desktop is present but its WSL integration is unavailable, the script asks the operator to start Desktop and enable WSL Integration for the distribution. Unreachable remote or rootless endpoints produce a diagnostic for that environment; neither case installs a second local engine automatically. Automatic installation on other operating systems is not currently supported.
`planet.sh` calls `scripts/lib/docker-bootstrap.zsh` for preparation. Missing CLI, missing service units, socket permissions, and stopped daemons receive separate diagnostics. Advice to start `docker.socket` is shown only after confirming that the unit exists. Verify the result with:
```bash
docker info
docker compose version
docker buildx version
```
## Database Initialization and Connection Checks
`init` reconciles PostgreSQL / Redis containers through Compose, including port configuration on existing containers. A plain `docker start` cannot apply configuration changes. Compose failures retain their specific errors, such as an occupied port, instead of falling back to an old container and reporting success.
The container's `pg_isready` check only establishes that the server accepts connections; it does not validate the host backend's address and credentials. Once containers are healthy, `init` runs `scripts/check_database_connection.py` using the backend's effective `DATABASE_URL`. It checks the local PostgreSQL published port and executes a read-only `SELECT 1` before reporting database readiness or creating tables and seed data.
- If the actual local port mapping is still missing or mismatched, the script recreates PostgreSQL once from Compose while preserving its data volume, then checks again. A second failure stops initialization.
- Authentication, database-name, and network failures stop before schema changes. Diagnostics show the host, port, and database name without passwords, full connection strings, or raw driver exceptions.
- A process-level `DATABASE_URL` overrides `backend/.env`. Changing `POSTGRES_PASSWORD` alone updates neither the connection string nor the password stored in an existing data volume. Existing environment files are retained and their effective configuration must be checked.
- Explicit external databases do not require a local container mapping. Host networking also does not require published ports. Both still require the real connection check.
For `port is already allocated` or `address already in use`, inspect `docker ps` port information and `ss -ltnp '( sport = :5432 )'`. With WSL mirrored networking, also inspect Windows listeners. Initialization does not kill other database services to acquire a port, delete data volumes, or reset passwords.
## First Startup
```bash
+4 -3
View File
@@ -34,9 +34,10 @@ After landing on the `/admin` dashboard, here's a recommended walk-through:
1. `/collection-management?section=collector_credentials`: pick a collector and click the plug icon to test connectivity. Free collectors (e.g. open BGP) usually work right away; credential-bearing ones like `AISStream` or `BarentsWatch` need an API key / client secret first
2. `/ai?section=integrations`: fill an LLM provider (e.g. `minimax` / `openai`), model, base URL, API key, and click the plug at the end of the base URL to test. WebSearch / OCR tools are optional
3. `/datasources` or `/data`: check whether collectors have produced data. Use `/datasources -> Built-in Sources` for finite collectors: with no rows selected, click `Trigger All`; after selecting rows, the primary button becomes `Trigger Selected N`. The top-right queue button shows progress. Use `/datasources -> Realtime Sources` for AISStream / WebSocket health and counters
4. `/alerts/system`: verify system alerts look right
5. `/users` (super_admin only): open accounts for teammates or adjust their groups
3. `/earth-content?section=brand`: maintain the Earth HUD logo and title image in Branding. The Upload button inside each URL field opens a file picker, and image files can also be dropped directly onto the matching field. Save the brand configuration after upload
4. `/datasources` or `/data`: check whether collectors have produced data. Use `/datasources -> Built-in Sources` for finite collectors: with no rows selected, click `Trigger All`; after selecting rows, the primary button becomes `Trigger Selected N`. The top-right queue button shows progress. Use `/datasources -> Realtime Sources` for AISStream / WebSocket health and counters
5. `/alerts/system`: verify system alerts look right
6. `/users` (super_admin only): open accounts for teammates or adjust their groups
## 4. Open Earth
+7 -1
View File
@@ -75,7 +75,11 @@ Earth 收到 `/ws` 的 `earth_updates` 时只把它当作刷新提示,真实
Earth 设置面板现在按 `data-settings-tab` 和 `data-settings-tab-panel` 分类组织。桌面端和移动端使用同一组分类语义:运行、显示、面板、动捕、快捷键、系统。新增设置项时应先判断它属于哪个分类,再补 DOM、持久化字段和恢复逻辑;不要把所有控件继续堆到一个长面板里。
`显示` 分类里的新闻类型选择复用巡航模块的 chip 选择器形态,只控制星球端当前浏览器的新闻分类显示。它不会打开或关闭图层、底图、边界、TV、数据点、BGP、船舶、卫星或算力中心;这些仍由图层面板、媒体面板和控制台配置各自负责。`controls.js` 只持久化 `shared.newsCategoryFilters` 并广播 `earth:news-category-filters-change`,`news.js` 会把选中的类型拼到 `/api/v1/news/earth-feed?categories=...&locale=zh-CN`,让 Web 和 UE 走同一套后端类型过滤。
Earth 运行在独立 iframe / 静态应用里,不能直接复用 React Admin 的 `react-i18next` 上下文。`public/earth` 自己通过 [i18n.js](/home/ray/dev/linkong/planet/frontend/public/earth/js/i18n.js) 读取并写回全局 `planet-locale`,同时同步旧的 `docs-lang`,这样 Docs、控制台和 Earth 的语言偏好保持一致。语言切换控件属于设置里的 `系统` tab,桌面和移动端都使用同一组 `data-earth-locale` 按钮;不要把语言选择塞进图层、显示或运行模式设置里。
`显示` 分类里的新闻类型选择复用巡航模块的 chip 选择器形态,只控制星球端当前浏览器的新闻分类显示。它不会打开或关闭图层、底图、边界、TV、数据点、BGP、船舶、卫星或算力中心;这些仍由图层面板、媒体面板和控制台配置各自负责。`controls.js` 只持久化 `shared.newsCategoryFilters` 并广播 `earth:news-category-filters-change`,`news.js` 会把选中的类型和当前 locale 拼到 `/api/v1/news/earth-feed?categories=...&locale=...`,让 Web 和 UE 走同一套后端类型过滤。
英文模式下,Earth 新闻只能渲染英文标题和摘要。中文来源新闻如果还没有 `en-US` 本地化,会先从可见卡片、滚动条和巡航中隐藏,直到后端增强完成;来源和 feed 标签也必须回退到英文安全名称,避免英文界面混入中文标签。
新闻面板、滚动条和新闻巡航必须消费同一次 `/api/v1/news/earth-feed` 响应里的 `items` / `cruise_items`,不能各自缓存区域状态。`news.js` 的刷新请求以区域、类型、来源和数量生成 request key;只有 key 相同的并发请求才复用 promise,旧区域请求返回时会被 token 丢弃。来源过滤也必须按区域作用域处理:当用户从亚太切到欧洲等其它区域时,旧区域保存的来源 ID 不允许继续拼到下一次 fetch 里;拿到新 payload 后再与 `sources` 列表做交集,若没有交集则回退到当前区域所有可用来源。这样滚动条、面板和巡航才会在区域切换后展示同一批新闻。
@@ -457,6 +461,8 @@ Earth 设置面板当前由 [controls.js](/home/ray/dev/linkong/planet/frontend/
也就是说,Earth 设置不是一次性 UI 状态了,而是本地设备级偏好。后续如果再加入新的设置项,应优先接入同一条持久化链,而不是各自散着写 `localStorage`。
语言偏好例外:Earth 语言不是 `planet.earth.settings.v2` 的私有字段,而是与 Docs/Admin 共用 `planet-locale`。切换语言时,`i18n.js` 会更新 `document.documentElement.lang`、翻译静态和动态插入的 DOM、同步语言按钮状态,并向新闻请求传递当前 locale;新闻模块在语言变化后会重新刷新,避免英文界面复用中文新闻 payload。
地表 hover 提示由 `controls.js` 持久化为 `shared.surfaceHoverInfoMode`,实际 tooltip 在 `main.js` 的地表 hover 分支组合。`国家` 模式只在命中国家时显示国家信息,海洋区域不显示地表 tooltip;`位置` 模式只显示纬度、经度和地形采样海拔,并清除国家边界 hover;`完整` 模式在陆地显示国家 + 位置,在海洋显示位置。
卫星真实高度开关由 `controls.js` 持久化,实际渲染状态在 `satellites.js`。开启时,SGP4 得到的真实半径会按对数压缩到当前 Earth 视觉半径范围;关闭时,卫星点、轨迹和预测轨道都回到旧版同层球面。切换时必须刷新卫星位置并清理轨迹缓存,避免同一条轨迹混入两个高度模型。`maxRealAltitudeOffset = 25` 是当前相机和 `earthRadius = 100` 下的视觉上限:它让 GEO / MEO 比 LEO 明显更高,但把最高轨道控制在地球半径外约 25%,避免选择点、红色轨迹和主体地球之间出现过大的空场。
+2
View File
@@ -144,6 +144,8 @@ JSON 导入首版只支持数组:
- `categories`:逗号分隔的新闻类型 key,例如 `business,ecommerce`。全选时可以不传。
- `locale`:展示语言,支持 `zh-CN` 和 `en-US`,默认 `zh-CN`。中文 RSS 会以中文原文入库,并由后台补 `en-US`;英文 RSS 则由后台补 `zh-CN`。
当 `locale=en-US` 时,接口不能回退展示中文原文标题或摘要。中文来源新闻尚未生成 `en-US` 本地化时,`display_title` 和 `display_summary` 保持为空,由 Earth 前端展示英文待处理或空态,避免英文界面混入中文新闻内容。
示例:
```http
@@ -418,6 +418,7 @@ AI 配置不再挂在 `/settings` 下;`/playground` 应跳转到 `/ai?section=
`/earth-content` 复用 [Settings.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx) 的单屏 tab 容器,但页面责任与系统设置分离:
- `电视直播` 迁移原直播源配置,继续管理 Earth 媒体面板内容源。
- `品牌标识` 管理 Earth HUD 的品牌资源。`Logo 地址` 与 `标题图地址` 使用字段内上传控件,上传按钮保持 `TactileButton` 的 primary 样式;图片拖到对应字段时显示低饱和拖拽反应,避免回到旧的全局“选择资产/上传”工具栏。
- `国界精度` 管理 Earth 静态国界资产:provider 状态、低精 fallback、高精 manifest/PMTiles、源配置 JSON 和构建动作。
- `地球底图`、`图层资源`、`三维素材`、`新闻锚点策略` 是占位页,只显示模块待接入,不造假接口或假数据。
+1 -1
View File
@@ -191,7 +191,7 @@ Base URL 输入框尾端的插头图标会触发连接测试。测试通过会
`/earth-content` 位于控制台“运维与配置”下,面向智能星球前端体验资源:
- **品牌资源**:维护智能星球 HUD 使用的 logo、标题图、标题文本、副标题和描述;上传的图片会保存为智能星球品牌资产并立即供智能星球页面读取。
- **品牌资源**:维护智能星球 HUD 使用的 logo、标题图、标题文本、副标题和描述。`Logo 地址` 和 `标题图地址` 字段内各有独立的“上传”按钮,也可以把图片直接拖到对应字段;上传成功后字段会写入新的资产地址,保存品牌配置后供智能星球页面读取。
- **关于**:维护智能星球设置面板里的关于卡片,包括 logo、眉标、标题、版本、描述和元信息。
- **电视直播**:维护智能星球媒体面板里的直播源。
- **新闻内容**:按 RSS 来源和手动新闻组查看新闻。RSS 新闻保持只读;手动新闻组可以新增、批量导入 JSON、编辑、删除和重新处理。
+3
View File
@@ -28,6 +28,9 @@
| AI Provider | AI Provider | 服务名,保留英文 |
| tool | 工具 | Web Search、OCR 等工具配置 |
| Playground | Playground | 交互调试入口,保留英文 |
| branding | 品牌标识 | `/earth-content` 中的 Earth HUD 品牌配置分区 |
| brand assets | 品牌资源 | Logo、标题图和相关 HUD 文案资源 |
| title image | 标题图 | Earth HUD 标题图片,不写作“标题图片地址”以外的混合名 |
## 数据类型
+42
View File
@@ -2,6 +2,48 @@
这份手册面向部署、值班和二次开发的运维人员。客户面向的 UI 使用流程见 [智能星球使用手册](/home/ray/dev/linkong/planet/docs/technical/zh/manual.md),本手册只覆盖 shell、Docker、日志、环境变量和故障排查。
## Docker 初始化与访问权限
新机器应先执行初始化,再启动应用服务:
```bash
zsh ./planet.sh init --non-motion-agent && zsh ./planet.sh start --non-motion-agent
```
脚本入口仍需先安装 `zsh`、`curl`,并保证软件源可访问。`init` 在同步 Python 和前端依赖之前准备 Docker:
- 已有可用的 Docker、Compose v2 和 Buildx(至少 0.17.0)时直接复用。
- Ubuntu / Ubuntu WSL 缺少依赖时,通过 apt 安装 `docker.io`、`docker-compose-v2`、`docker-buildx` 中缺失的部分。若已安装 Docker CE CLI,则使用已配置的 Docker CE 软件源和对应插件包,避免混用软件包系列。
- 本地 Docker daemon 未运行时,确认 `docker.service` 存在后启用并启动它。WSL 必须启用 systemd;如果服务管理不可用,脚本会在 Docker 准备阶段明确报错。
- 当前用户不能读写 Docker socket 时,检查并补装提供 `usermod` 的 `passwd` 包,将用户加入 `docker` 组。该组拥有管理本机 Docker 的高权限。脚本使用 `sudo` 以原用户身份刷新组权限并继续原命令,保留参数,不依赖 `sg`,也不会把应用进程改为 root 用户运行。
需要提权时,脚本会在前台请求 sudo 认证。普通用户缺少 sudo、认证失败、软件源不可用或安装后版本仍不满足要求时,初始化会停止并报告具体原因。
同一旧终端随后执行 `planet.sh start` 等命令时,也会检测已加入但尚未生效的 Docker 组权限并刷新。若要在终端直接使用 `docker`,重新打开 Ubuntu 会话即可。
Docker Desktop 已存在但 WSL 集成不可用时,脚本提示启动 Desktop 并启用当前发行版的 WSL Integration。已有远程或 rootless endpoint 无法连接时,提示检查当前环境;这些情况不会自动安装另一套本地引擎。其他操作系统的自动安装暂未支持。
安装逻辑由 `planet.sh` 调用 `scripts/lib/docker-bootstrap.zsh`;缺少 CLI、没有服务单元、socket 权限不足和 daemon 未启动会分别诊断。仅在确认 `docker.socket` 单元存在时才给出启动该单元的建议。验证准备结果可执行:
```bash
docker info
docker compose version
docker buildx version
```
## 数据库初始化与连接检查
`init` 会先通过 Compose 同步 PostgreSQL / Redis 容器配置,包括已有容器的端口映射;仅执行 `docker start` 无法应用配置变化。Compose 同步失败时会保留具体错误,例如端口被占用,不会继续复用旧容器并报告成功。
容器内部的 `pg_isready` 只检查服务是否接受连接,不能证明宿主机上的后端使用正确地址和密码。容器健康后,`init` 通过 `scripts/check_database_connection.py` 读取与后端相同的有效 `DATABASE_URL`,检查本地 PostgreSQL 的实际发布端口并执行只读 `SELECT 1`;通过后才显示“数据库服务已就绪”并创建表和默认数据。
- 如果本地实际端口映射仍缺失或不匹配,脚本会保留数据卷,按 Compose 配置重建一次 PostgreSQL 并重新检查;再次失败就停止。
- 认证、库名或网络错误会在建表前停止,诊断只显示目标主机、端口和库名,不输出密码、完整连接串或驱动异常原文。
- 进程环境变量中的 `DATABASE_URL` 优先于 `backend/.env`。单独修改 `POSTGRES_PASSWORD` 不会自动更新连接串,也不会改变已有数据卷内的密码。已有环境文件会保留,需要核对其有效配置。
- 显式配置的外部数据库不要求本地容器端口匹配;host 网络模式也不要求发布端口,两者仍须通过实际连接检查。
出现 `port is already allocated` 或 `address already in use` 时,检查 `docker ps` 的端口信息和 `ss -ltnp '( sport = :5432 )'`;WSL 镜像网络下还需检查 Windows 侧监听。初始化不会为了占用数据库端口而自动结束其他数据库服务,也不会删除数据卷或重设密码。
## 首次启动
```bash
+4 -3
View File
@@ -34,9 +34,10 @@
1. `/collection-management?section=collector_credentials`:选一个采集器,点插头图标做连接测试。免费 collector(开源 BGP 等)通常直接可用;像 `AISStream`、`BarentsWatch` 这类需要凭证的,需要先填 API Key/Client Secret
2. `/ai?section=integrations`:填一个 LLM provider(例如 `minimax` / `openai`)、模型名、Base URL、API Key,点 Base URL 末端的插头测试连接。WebSearch / OCR 工具可选
3. `/datasources` 或 `/data`:看采集器是否已经产出数据。有限采集器看 `/datasources -> 内置源`,不勾选时点“触发全部”,勾选后主按钮会变成“触发已选 N”;右上角队列按钮可查看进度。AISStream / WebSocket 长连接看 `/datasources -> 实时源` 的健康状态和计数
4. `/alerts/system`:看系统告警是否正常
5. `/users`(仅 `super_admin`):根据需要给同事开账号或调权限组
3. `/earth-content?section=brand`:在“品牌标识”里维护智能星球的 Logo 和标题图;对应地址字段内的“上传”按钮支持选择文件,也支持把图片直接拖到字段上,保存后会应用到智能星球 HUD
4. `/datasources` 或 `/data`:看采集器是否已经产出数据。有限采集器看 `/datasources -> 内置源`,不勾选时点“触发全部”,勾选后主按钮会变成“触发已选 N”;右上角队列按钮可查看进度。AISStream / WebSocket 长连接看 `/datasources -> 实时源` 的健康状态和计数
5. `/alerts/system`:看系统告警是否正常
6. `/users`(仅 `super_admin`):根据需要给同事开账号或调权限组
## 4. 打开智能星球
+5 -1
View File
@@ -16,12 +16,16 @@
## Current Version
- `main` 当前主线历史推导到:`0.16.5`
- `dev` 当前开发分支历史推导到:`0.73.0`
- `dev` 当前开发分支历史推导到:`0.74.3`
## Timeline
| Version | Type | Branch | Commit | Summary |
| --- | --- | --- | --- | --- |
| `0.74.3` | improvement | `dev` | `v0.74.3` | Ubuntu / WSL 初始化自动准备 Docker 及用户权限,修正启动诊断,并在建表前核对数据库端口、实际连接和认证 |
| `0.74.2` | bugfix | `dev` | `pending` | 收敛 agent harness 到根规则和 Codex skills,删除旧 Claude command 重复入口,并强化视觉证据路径解析与 OCR fallback 规则 |
| `0.74.1` | improvement | `dev` | `pending` | 将品牌标识上传收敛到 Logo/标题图字段内,新增字段级拖拽反馈和 Tactile UI primary 上传按钮,并同步中英文使用文档 |
| `0.74.0` | feature | `dev` | `pending` | 扩展统一 i18n 到 Web Earth 动态入口、控制台/API 错误和公开页面,修复 Earth 通知胶囊、语言 switch、品牌栏、legend、tooltip、新闻/TV 英文态裁切与中文残留,并加入 harness 回归覆盖 |
| `0.73.0` | feature | `dev` | `pending` | 新增前端统一 i18n、控制台语言/主题偏好入口、英文态 legacy 过渡翻译和 admin 一屏/状态指示器布局验证 |
| `0.72.0` | feature | `dev` | `pending` | 新增完整 agent harness、单一 AGENTS 入口、Earth News smoke 覆盖和 collector 结构化日志清理,并同步控制台/Earth/Docs 响应式维护文档 |
| `0.71.1` | bugfix | `dev` | `pending` | 修复 Earth 新闻区域切换、滚动条/面板/巡航一致性和新闻精修队列饿死问题,并补充 agent harness 与双语维护文档 |
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "planet-frontend",
"version": "0.73.0",
"version": "0.74.3",
"private": true,
"packageManager": "bun@1",
"dependencies": {
+48 -13
View File
@@ -1157,15 +1157,18 @@
.earth-mobile-tv-overview-tags {
display: flex;
flex-wrap: nowrap;
flex-wrap: wrap;
gap: 4px;
margin-top: 1px;
overflow: hidden;
min-width: 0;
overflow: visible;
}
.earth-mobile-tv-overview-tag {
display: inline-flex;
align-items: center;
min-width: 0;
max-width: 100%;
min-height: 20px;
padding: 0 6px;
border-radius: 999px;
@@ -1173,8 +1176,9 @@
background: rgba(255, 255, 255, 0.06);
color: var(--hud-text);
font-size: 0.62rem;
line-height: 1;
white-space: nowrap;
line-height: 1.15;
overflow-wrap: anywhere;
white-space: normal;
}
.earth-mobile-tv-overview-tag--status {
@@ -1817,11 +1821,15 @@
.earth-mobile-settings-pill {
position: relative;
z-index: 1;
min-width: 0;
border: 0;
border-radius: 999px;
background: transparent;
color: var(--hud-text-soft);
padding: 10px 14px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.earth-mobile-settings-pill.is-active {
@@ -1835,6 +1843,9 @@
}
.earth-mobile-settings-chip {
flex: 0 1 auto;
min-width: 0;
max-width: 100%;
border: 1px solid rgba(212, 227, 244, 0.12);
border-radius: 999px;
background: rgba(255, 255, 255, 0.04);
@@ -1844,6 +1855,9 @@
font-size: 0.82rem;
font-weight: 600;
letter-spacing: 0.02em;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
cursor: pointer;
transition:
background 0.18s ease,
@@ -1900,11 +1914,13 @@
transition: transform 0.18s ease;
}
.earth-mobile-settings-switch input:checked + .earth-mobile-settings-switch-track {
.earth-mobile-settings-switch input:checked + .earth-mobile-settings-switch-track,
.earth-mobile-settings-switch.is-checked .earth-mobile-settings-switch-track {
background: rgba(122, 180, 255, 0.34);
}
.earth-mobile-settings-switch input:checked + .earth-mobile-settings-switch-track::after {
.earth-mobile-settings-switch input:checked + .earth-mobile-settings-switch-track::after,
.earth-mobile-settings-switch.is-checked .earth-mobile-settings-switch-track::after {
transform: translate(16px, -50%);
}
@@ -2145,10 +2161,10 @@ label.is-disabled.earth-mobile-settings-card {
.earth-status-message,
.earth-error-message {
position: absolute;
top: calc(var(--hud-offset) + calc(2px * var(--hud-scale)));
top: calc(var(--hud-offset) + calc(44px * var(--hud-scale)));
left: min(
calc(var(--hud-offset) + calc(340px * var(--hud-scale)) + calc(12px * var(--hud-scale))),
calc(100vw - min(calc(440px * var(--hud-scale)), 74vw) - var(--hud-offset))
calc(100vw - min(calc(620px * var(--hud-scale)), 82vw) - var(--hud-offset))
);
transform: translateY(-18px);
display: none;
@@ -2172,8 +2188,8 @@ label.is-disabled.earth-mobile-settings-card {
backdrop-filter: blur(12px);
-webkit-backdrop-filter: blur(12px);
text-align: left;
min-width: min(calc(160px * var(--hud-scale)), 58vw);
max-width: min(calc(440px * var(--hud-scale)), 74vw);
min-width: 0;
max-width: min(calc(620px * var(--hud-scale)), 82vw);
color: var(--hud-text);
opacity: 0;
transition:
@@ -2236,6 +2252,7 @@ label.is-disabled.earth-mobile-settings-card {
align-items: center;
flex: 1 1 auto;
min-width: 0;
overflow-wrap: anywhere;
}
/* Loading: three-dot sequential pulse */
@@ -2869,6 +2886,7 @@ label.is-disabled.earth-mobile-settings-card {
.earth-settings-segmented-btn {
position: relative;
z-index: 1;
min-width: 0;
border: 0;
background: transparent;
color: var(--hud-text-soft);
@@ -2878,6 +2896,9 @@ label.is-disabled.earth-mobile-settings-card {
font-size: calc(0.7rem * var(--hud-scale));
font-weight: 600;
letter-spacing: 0.02em;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
cursor: pointer;
transition:
color 0.18s ease,
@@ -2979,6 +3000,9 @@ label.is-disabled.earth-mobile-settings-card {
}
.earth-settings-chip {
flex: 0 1 auto;
min-width: 0;
max-width: 100%;
border: 1px solid rgba(212, 227, 244, 0.1);
border-radius: 999px;
background:
@@ -2990,6 +3014,9 @@ label.is-disabled.earth-mobile-settings-card {
font-size: calc(0.7rem * var(--hud-scale));
font-weight: 600;
letter-spacing: 0.02em;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
cursor: pointer;
transition:
background 0.18s ease,
@@ -3253,12 +3280,18 @@ label.is-disabled.earth-mobile-settings-card {
position: relative;
display: inline-flex;
align-items: center;
justify-content: center;
width: calc(38px * var(--hud-scale));
height: calc(22px * var(--hud-scale));
flex: 0 0 auto;
cursor: pointer;
}
.earth-settings-switch input {
position: absolute;
inset: 0;
opacity: 0;
pointer-events: none;
cursor: pointer;
}
.earth-settings-switch-track {
@@ -3285,12 +3318,14 @@ label.is-disabled.earth-mobile-settings-card {
transition: transform 0.18s ease;
}
.earth-settings-switch input:checked + .earth-settings-switch-track {
.earth-settings-switch input:checked + .earth-settings-switch-track,
.earth-settings-switch.is-checked .earth-settings-switch-track {
background: linear-gradient(180deg, rgba(143, 185, 255, 0.72), rgba(104, 147, 221, 0.78));
border-color: rgba(223, 236, 252, 0.28);
}
.earth-settings-switch input:checked + .earth-settings-switch-track::after {
.earth-settings-switch input:checked + .earth-settings-switch-track::after,
.earth-settings-switch.is-checked .earth-settings-switch-track::after {
transform: translate(calc(16px * var(--hud-scale)), -50%);
}
+54 -2
View File
@@ -145,6 +145,22 @@
.hud-panel-brand .earth-brand--en .earth-brand__subtitle,
.hud-panel-brand .earth-brand--en .earth-brand__description {
font-family: "Roboto Condensed", "Arial Narrow", "Trebuchet MS", "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
overflow: visible;
text-overflow: clip;
white-space: normal;
word-break: normal;
overflow-wrap: normal;
letter-spacing: 0;
}
.hud-panel-brand .earth-brand--en .earth-brand__subtitle {
font-size: calc(0.58rem * var(--hud-scale) * var(--brand-scale));
line-height: 1.15;
}
.hud-panel-brand .earth-brand--en .earth-brand__description {
font-size: calc(0.5rem * var(--hud-scale) * var(--brand-scale));
line-height: 1.15;
}
/* ── Info detail panel (floating, positioned near click by JS) ── */
@@ -152,7 +168,7 @@
.hud-panel-info {
position: absolute;
z-index: 50;
width: min(calc(300px * var(--hud-scale)), calc(100vw - 32px));
width: min(calc(340px * var(--hud-scale)), calc(100vw - 32px));
border-radius: 0;
padding: 0;
overflow: hidden;
@@ -349,12 +365,17 @@
}
.info-card-label {
min-width: 0;
max-width: 42%;
color: var(--hud-text-soft);
font-size: calc(0.68rem * var(--hud-scale));
letter-spacing: 0.1em;
text-transform: uppercase;
cursor: pointer;
flex-shrink: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
transition: color 0.18s ease;
user-select: none;
-webkit-user-select: none;
@@ -365,17 +386,35 @@
}
.info-card-value {
min-width: 0;
color: var(--hud-text);
font-weight: 600;
font-size: calc(0.82rem * var(--hud-scale));
line-height: 1.45;
text-align: right;
max-width: calc(180px * var(--hud-scale));
max-width: calc(220px * var(--hud-scale));
word-break: break-word;
user-select: none;
-webkit-user-select: none;
}
.info-card-source-tag {
display: inline-flex;
max-width: 100%;
min-width: 0;
margin-left: calc(4px * var(--hud-scale));
padding: 0 calc(5px * var(--hud-scale));
border: 1px solid rgba(214, 229, 245, 0.14);
border-radius: 999px;
color: var(--hud-text-soft);
font-size: calc(0.64rem * var(--hud-scale));
line-height: 1.35;
vertical-align: middle;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
/* Type-specific header accent colors */
.info-card.cable .info-card-header {
background: rgba(255, 200, 0, 0.12);
@@ -681,15 +720,25 @@
justify-content: space-between;
gap: 8px;
align-items: center;
min-width: 0;
}
.info-card-compute-candidate-precision {
flex: 0 1 auto;
min-width: 0;
max-width: 44%;
color: #cfe1ff;
font-weight: 600;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.info-card-compute-candidate-preview {
position: relative;
flex: 0 1 auto;
min-width: 0;
max-width: calc(96px * var(--hud-scale));
background: transparent;
color: #c9dcff;
border: 1px solid rgba(214, 229, 245, 0.18);
@@ -697,6 +746,9 @@
cursor: pointer;
padding: 2px 6px;
font-size: calc(0.68rem * var(--hud-scale));
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.info-card-compute-candidate-preview:hover {
+10 -3
View File
@@ -4,7 +4,7 @@
/* Lives inside .earth-left-column — narrower than brand panel intentionally */
border-radius: 0;
padding: 0;
width: calc(260px * var(--hud-scale));
width: calc(276px * var(--hud-scale));
z-index: 10;
overflow: hidden;
margin-top: calc(12px * var(--hud-scale));
@@ -184,7 +184,7 @@
display: flex;
align-items: center;
gap: calc(8px * var(--hud-scale));
padding: calc(9px * var(--hud-scale)) calc(10px * var(--hud-scale));
padding: calc(9px * var(--hud-scale)) calc(12px * var(--hud-scale));
border-bottom: 1px solid var(--hud-line);
transition: background 0.14s ease;
min-height: calc(56px * var(--hud-scale));
@@ -241,6 +241,9 @@
letter-spacing: 0.08em;
text-transform: uppercase;
line-height: 1.2;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
/* ── Toggle switch ────────────────────────────────────────────── */
@@ -329,12 +332,13 @@
appearance: none;
position: absolute;
top: calc(4px * var(--hud-scale));
left: calc(19px * var(--hud-scale));
left: calc(21px * var(--hud-scale));
z-index: 2;
display: inline-flex;
align-items: center;
justify-content: center;
min-width: calc(16px * var(--hud-scale));
max-width: calc(38px * var(--hud-scale));
height: calc(16px * var(--hud-scale));
padding: 0 calc(4px * var(--hud-scale));
border: 1px solid rgba(255, 226, 186, 0.62);
@@ -348,6 +352,9 @@
font-weight: 700;
font-variant-numeric: tabular-nums;
line-height: 1;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
cursor: pointer;
transition:
filter 0.16s ease,
+12 -3
View File
@@ -5,7 +5,7 @@
left: var(--hud-offset);
border-radius: 0;
padding: 0;
width: min(calc(200px * var(--hud-scale)), calc(100vw - 32px));
width: min(calc(280px * var(--hud-scale)), calc(100vw - 32px));
z-index: 10;
overflow: hidden;
}
@@ -51,14 +51,17 @@
display: inline-flex;
align-items: center;
min-width: 0;
max-width: 100%;
padding: calc(3px * var(--hud-scale)) calc(7px * var(--hud-scale));
border-radius: calc(4px * var(--hud-scale));
border: 1px solid rgba(120, 180, 255, 0.2);
background: rgba(120, 180, 255, 0.12);
color: var(--hud-accent-strong);
font-size: calc(0.68rem * var(--hud-scale));
letter-spacing: 0.08em;
letter-spacing: 0.02em;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
/* ── Bar action buttons ───────────────────────────────────────── */
@@ -92,6 +95,7 @@
.legend-list {
display: flex;
flex-direction: column;
min-width: 0;
padding: calc(4px * var(--hud-scale)) 0;
overflow-y: auto;
max-height: calc(220px * var(--hud-scale));
@@ -110,6 +114,7 @@
display: flex;
align-items: center;
gap: calc(8px * var(--hud-scale));
min-width: 0;
padding: calc(5px * var(--hud-scale)) calc(10px * var(--hud-scale));
}
@@ -135,6 +140,9 @@
}
.legend-label {
flex: 1 1 auto;
min-width: 0;
max-width: 100%;
color: var(--hud-text);
font-size: calc(0.78rem * var(--hud-scale));
font-weight: 400;
@@ -142,6 +150,7 @@
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
letter-spacing: 0;
}
/* ── Layout-expanded ──────────────────────────────────────────── */
@@ -156,7 +165,7 @@
position: fixed;
left: 8px;
bottom: calc(84px + var(--safe-bottom));
width: min(172px, calc(100vw - 16px));
width: min(208px, calc(100vw - 16px));
z-index: 205;
}
+20
View File
@@ -306,6 +306,8 @@
display: inline-flex;
align-items: center;
gap: calc(6px * var(--hud-scale));
min-width: 0;
max-width: 100%;
min-height: calc(30px * var(--hud-scale));
border: 1px solid rgba(201, 225, 247, 0.1);
border-radius: calc(12px * var(--hud-scale));
@@ -330,6 +332,11 @@
}
.news-filter-pill strong {
min-width: 0;
max-width: calc(160px * var(--hud-scale));
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
color: var(--hud-accent-strong);
font-size: calc(0.7rem * var(--hud-scale));
font-weight: 700;
@@ -391,6 +398,8 @@
}
.news-filter-chip {
min-width: 0;
max-width: 100%;
border: 1px solid rgba(201, 225, 247, 0.12);
border-radius: calc(14px * var(--hud-scale));
padding: calc(7px * var(--hud-scale)) calc(10px * var(--hud-scale));
@@ -398,6 +407,10 @@
background: rgba(255, 255, 255, 0.04);
font: inherit;
font-size: calc(0.74rem * var(--hud-scale));
line-height: 1.25;
text-align: center;
overflow-wrap: anywhere;
white-space: normal;
cursor: pointer;
}
@@ -539,6 +552,7 @@
.news-story-meta {
justify-content: space-between;
min-width: 0;
}
.news-story-tags {
@@ -549,6 +563,7 @@
.news-story-time,
.news-story-origin,
.news-story-tag {
min-width: 0;
color: var(--hud-text-soft);
font-size: calc(0.66rem * var(--hud-scale));
}
@@ -563,6 +578,7 @@
.news-story-origin {
color: rgba(188, 212, 238, 0.56);
max-width: 100%;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
@@ -582,9 +598,13 @@
}
.news-story-tag {
max-width: 100%;
border-radius: 999px;
padding: calc(3px * var(--hud-scale)) calc(7px * var(--hud-scale));
background: rgba(255, 255, 255, 0.04);
line-height: 1.25;
overflow-wrap: anywhere;
white-space: normal;
}
.news-story-tag--breaking {
+5 -1
View File
@@ -154,7 +154,9 @@
}
.tv-panel-tag {
flex: 0 0 auto;
flex: 0 1 auto;
min-width: 0;
max-width: 100%;
border: 1px solid rgba(137, 179, 217, 0.22);
border-radius: calc(999px * var(--hud-scale));
background: rgba(108, 153, 192, 0.12);
@@ -164,6 +166,8 @@
font-weight: 700;
line-height: 1.35;
letter-spacing: 0.04em;
overflow-wrap: anywhere;
white-space: normal;
}
.tv-panel-tag--status {
+20
View File
@@ -1211,6 +1211,16 @@
</div>
<div class="earth-mobile-settings-group" data-settings-tab-panel="system" hidden>
<div class="earth-mobile-settings-title">系统</div>
<div class="earth-mobile-settings-card earth-mobile-settings-card--stacked">
<div class="earth-mobile-settings-copy">
<span class="earth-mobile-settings-label">星球语言</span>
<span class="earth-mobile-settings-subtitle">同步 Docs 和控制台语言偏好</span>
</div>
<div class="earth-mobile-settings-segmented" role="group" aria-label="星球语言">
<button type="button" class="earth-mobile-settings-pill is-active" data-earth-locale="zh-CN" aria-pressed="true">中文</button>
<button type="button" class="earth-mobile-settings-pill" data-earth-locale="en-US" aria-pressed="false">English</button>
</div>
</div>
<div class="earth-mobile-settings-actions">
<button id="mobile-settings-reset" class="earth-mobile-action-btn earth-mobile-action-btn--ghost" type="button">重置设置</button>
<a class="earth-mobile-action-btn" href="/admin" target="_blank" rel="noreferrer noopener">打开控制台</a>
@@ -1769,6 +1779,16 @@
<section class="earth-settings-section" data-settings-tab-panel="system" hidden>
<div class="earth-settings-section-title">系统</div>
<div class="earth-settings-list">
<div class="earth-settings-item earth-settings-item--stacked">
<div class="earth-settings-copy">
<span class="earth-settings-item-title">星球语言</span>
<span class="earth-settings-item-subtitle">同步 Docs 和控制台语言偏好</span>
</div>
<div class="earth-settings-segmented" role="group" aria-label="星球语言">
<button type="button" class="earth-settings-segmented-btn is-active" data-earth-locale="zh-CN" aria-pressed="true">中文</button>
<button type="button" class="earth-settings-segmented-btn" data-earth-locale="en-US" aria-pressed="false">English</button>
</div>
</div>
<a
class="earth-settings-item earth-settings-link"
href="/admin"
+67 -6
View File
@@ -17,11 +17,25 @@ const BRANDS = {
logoSrc: "/earth/assets/brand/earth-logo.png",
titleSrc: "/earth/assets/brand/title-en.png",
titleText: "Intelligent Planet Program",
subtitle: "Physical-Universe Holography",
description: "Satellites · Cables · Compute Infra",
subtitle: "Reality Layer Situational Awareness System",
description: "Satellites · Subsea Cables · Compute Infrastructure",
},
};
const DEFAULT_BRAND_TITLE_BY_VARIANT = {
zh: BRANDS.zh.titleSrc,
en: BRANDS.en.titleSrc,
};
const LOCALIZED_FIELD_NAMES = {
ariaLabel: ["aria_label", "ariaLabel"],
titleAlt: ["title_alt", "titleAlt"],
titleSrc: ["title_src", "titleSrc"],
titleText: ["title_text", "titleText"],
subtitle: ["subtitle"],
description: ["description"],
};
export function getDefaultBrandConfig(variant = DEFAULT_BRAND_LANGUAGE) {
return BRANDS[variant] ?? BRANDS[DEFAULT_BRAND_LANGUAGE];
}
@@ -35,18 +49,65 @@ function escapeHtml(value = "") {
.replace(/'/g, "&#39;");
}
function hasCjkText(value = "") {
return /[\u3400-\u9fff]/.test(String(value ?? ""));
}
function readConfigValue(config, keys = []) {
for (const key of keys) {
if (config[key] !== undefined && config[key] !== null && config[key] !== "") {
return config[key];
}
}
return undefined;
}
function readLocalizedConfigValue(config, fieldName, variant, fallback) {
const keys = LOCALIZED_FIELD_NAMES[fieldName] || [fieldName];
const localeSuffix = variant === "en" ? "en" : "zh";
const localeKeys = keys.flatMap((key) => [
`${key}_${localeSuffix}`,
`${key}${localeSuffix.charAt(0).toUpperCase()}${localeSuffix.slice(1)}`,
]);
const localized = readConfigValue(config, localeKeys);
if (localized !== undefined) return localized;
const generic = readConfigValue(config, keys);
return generic ?? fallback;
}
function normalizeBrandConfig(config = {}, variant = DEFAULT_BRAND_LANGUAGE) {
const defaults = getDefaultBrandConfig(variant);
const sourceTitleSrc = readLocalizedConfigValue(config, "titleSrc", variant, undefined);
const normalized = {
...defaults,
...config,
ariaLabel: config.aria_label ?? config.ariaLabel ?? defaults.ariaLabel,
titleAlt: config.title_alt ?? config.titleAlt ?? defaults.titleAlt,
ariaLabel: readLocalizedConfigValue(config, "ariaLabel", variant, defaults.ariaLabel),
titleAlt: readLocalizedConfigValue(config, "titleAlt", variant, defaults.titleAlt),
logoSrc: config.logo_src ?? config.logoSrc ?? defaults.logoSrc,
titleSrc: config.title_src ?? config.titleSrc ?? defaults.titleSrc,
titleText: config.title_text ?? config.titleText ?? defaults.titleText,
titleSrc: sourceTitleSrc ?? defaults.titleSrc,
titleText: readLocalizedConfigValue(config, "titleText", variant, defaults.titleText),
subtitle: readLocalizedConfigValue(config, "subtitle", variant, defaults.subtitle),
description: readLocalizedConfigValue(config, "description", variant, defaults.description),
};
if (
variant === "en" &&
(
!sourceTitleSrc ||
sourceTitleSrc === DEFAULT_BRAND_TITLE_BY_VARIANT.zh ||
hasCjkText(normalized.titleText) ||
hasCjkText(normalized.titleAlt) ||
hasCjkText(normalized.ariaLabel)
)
) {
normalized.titleSrc = DEFAULT_BRAND_TITLE_BY_VARIANT.en;
normalized.titleAlt = defaults.titleAlt;
normalized.titleText = defaults.titleText;
normalized.ariaLabel = defaults.ariaLabel;
normalized.subtitle = defaults.subtitle;
normalized.description = defaults.description;
}
if (!normalized.titleText) normalized.titleText = defaults.titleText;
if (!normalized.ariaLabel) normalized.ariaLabel = normalized.titleText;
if (!normalized.titleAlt) normalized.titleAlt = normalized.titleText;
+5 -4
View File
@@ -13,6 +13,7 @@ import { getSurfaceMarkerCameraScale, latLonToVector3 } from "./utils.js";
import { setEarthStatValue, updateEarthStats, showStatusMessage } from "./ui.js";
import { showInfoCard } from "./info-card.js";
import { setLegendItems, setLegendMode } from "./legend.js";
import { earthMessage } from "./i18n.js";
export let cableLines = [];
export let landingPoints = [];
@@ -324,7 +325,7 @@ export function clearCableData(earthObj = null) {
export async function loadGeoJSONFromPath(scene, earthObj, options = {}) {
const { silent = false } = options;
if (!silent) {
showStatusMessage("正在加载电缆数据...", "warning");
showStatusMessage(earthMessage("loading.cableData"), "warning");
}
const response = await fetch(PATHS.cablesApi, { cache: "no-store" });
@@ -423,7 +424,7 @@ export async function loadGeoJSONFromPath(scene, earthObj, options = {}) {
});
if (!silent) {
showStatusMessage(`成功加载 ${cableLines.length} 条电缆`, "success");
showStatusMessage(earthMessage("status.loadedCables", { count: cableLines.length }), "success");
}
return cableLines.length;
}
@@ -512,7 +513,7 @@ export async function loadLandingPoints(scene, earthObj, options = {}) {
setEarthStatValue("landing-point-count", `${validCount}个`);
if (!silent) {
showStatusMessage(`成功加载 ${validCount} 个登陆点`, "success");
showStatusMessage(earthMessage("status.loadedLandingPoints", { count: validCount }), "success");
}
return validCount;
}
@@ -532,7 +533,7 @@ export function handleCableClick(cable) {
rfs: data.rfs,
});
showStatusMessage(`已锁定: ${data.name}`, "info");
showStatusMessage(earthMessage("status.locked", { name: data.name }), "info");
}
export function clearCableSelection() {
+119 -73
View File
@@ -109,6 +109,7 @@ import {
setLayerButtonState,
updateLayerButtonState,
} from "./layer-button-state.js";
import { earthMessage, translateText } from "./i18n.js";
import {
DEFAULT_MOTION_PROVIDER,
MOTION_GESTURES,
@@ -428,12 +429,12 @@ function getShortcutForAction(actionId) {
function getAutoRotateShortcutStatusMessage(isActive) {
if (rotationMode === ROTATION_MODE.CRUISE) {
return isActive ? "巡航已恢复" : "巡航已暂停";
return earthMessage("status.runtimePaused", { label: "巡航", active: isActive });
}
if (rotationMode === ROTATION_MODE.MOTION) {
return isActive ? "动捕已恢复" : "动捕已暂停";
return earthMessage("status.runtimePaused", { label: "动捕", active: isActive });
}
return isActive ? "旋转已恢复" : "旋转已暂停";
return earthMessage("status.runtimePaused", { label: "旋转", active: isActive });
}
function getShortcutOwnerByBinding(binding, { excludeActionId = null } = {}) {
@@ -731,7 +732,7 @@ function toggleLayoutExpandedFromShortcut() {
const container = document.getElementById("container");
if (!(container instanceof HTMLElement)) return;
const expanded = toggleLayoutExpanded(container);
showStatusMessage(expanded ? "布局已最大化" : "布局已恢复", "info");
showStatusMessage(earthMessage("status.layoutExpanded", { expanded }), "info");
}
async function toggleLayerFromShortcut(layerId) {
@@ -739,11 +740,17 @@ async function toggleLayerFromShortcut(layerId) {
if (!definition) return;
const button = getLayerButton(layerId);
if (button?.disabled || button?.classList.contains("is-disabled")) {
showStatusMessage(`${definition.label}当前不可用`, "warning");
showStatusMessage(earthMessage("status.layerUnavailable", { layer: definition.label }), "warning");
return;
}
await definition.setVisible(!definition.getVisible());
showStatusMessage(`${definition.label}${definition.getVisible() ? "已显示" : "已隐藏"}`, "info");
showStatusMessage(
earthMessage("status.layerVisibility", {
layer: definition.label,
visible: definition.getVisible(),
}),
"info",
);
}
function executeKeyboardShortcut(actionId, event = null) {
@@ -1378,7 +1385,7 @@ function getZoomResetTooltipText(zoom) {
}
function getZoomResetStatusMessage(zoom) {
return `缩放已重置到${formatZoomPercent(zoom)}`;
return earthMessage("status.zoomReset", { zoom: formatZoomPercent(zoom) });
}
function normalizeAutoRotationSpeed(value) {
@@ -2090,7 +2097,7 @@ export function setEarthNewsCategoryEnabled(
persistEarthSettings();
}
if (!suppressStatus) {
showStatusMessage(Boolean(enabled) ? "新闻类型已显示" : "新闻类型已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "新闻类型", visible: Boolean(enabled) }), "info");
}
return true;
}
@@ -2147,7 +2154,13 @@ export function setCruiseModules(nextModules, { persist = true, suppressStatus =
if (!suppressStatus) {
const labels = normalizedModules.map((moduleId) => CRUISE_MODULE_LABELS[moduleId] || moduleId);
showStatusMessage(`巡航模块已切换为:${labels.join(" + ")}`, "info");
showStatusMessage(
earthMessage("status.modulesChanged", {
label: "巡航模块",
value: labels.map((label) => translateText(label)).join(" + "),
}),
"info",
);
}
return normalizedModules;
@@ -2178,7 +2191,7 @@ export function setCruiseQueueMode(
: normalizedMode === CRUISE_QUEUE_MODES.RANDOM
? "随机"
: "默认";
showStatusMessage(`巡航队列已切换为:${label}`, "info");
showStatusMessage(earthMessage("status.valueChanged", { label: "巡航队列", value: label }), "info");
}
return normalizedMode;
@@ -2203,7 +2216,7 @@ export function setCruiseRegionOrder(
if (persist) persistEarthSettings();
if (!suppressStatus) {
showStatusMessage("巡航大区顺序已更新", "info");
showStatusMessage(earthMessage("status.updated", { label: "巡航大区顺序" }), "info");
}
return normalizedOrder;
@@ -2237,7 +2250,7 @@ export function setSatelliteDisplayStyle(
normalizedStyle === SATELLITE_DISPLAY_STYLES.GROUND_FOOTPRINT
? "真实地表覆盖"
: "自身发光";
showStatusMessage(`卫星显示风格已切换为:${nextLabel}`, "info");
showStatusMessage(earthMessage("status.valueChanged", { label: "卫星显示风格", value: nextLabel }), "info");
}
return normalizedStyle;
@@ -2256,7 +2269,7 @@ export function setSatelliteIdleBreathingEnabled(
persistEarthSettings();
}
if (!suppressStatus) {
showStatusMessage(enabled ? "卫星呼吸闪烁已开启" : "卫星呼吸闪烁已关闭", "info");
showStatusMessage(earthMessage("status.booleanSetting", { label: "卫星呼吸闪烁", enabled }), "info");
}
return enabled;
}
@@ -2275,7 +2288,9 @@ export function setSatelliteRealAltitudeEnabled(
}
if (!suppressStatus) {
showStatusMessage(
enabled ? "卫星真实高度已开启" : "卫星已切换为旧版同层高度",
enabled
? earthMessage("status.booleanSetting", { label: "卫星真实高度", enabled })
: earthMessage("status.valueChanged", { label: "卫星", value: "旧版同层高度" }),
"info",
);
}
@@ -2295,7 +2310,7 @@ export function setInteractableCompactDotsEnabled(
persistEarthSettings();
}
if (!suppressStatus) {
showStatusMessage(enabled ? "低缩放彩色圆点已开启" : "低缩放彩色圆点已关闭", "info");
showStatusMessage(earthMessage("status.booleanSetting", { label: "低缩放彩色圆点", enabled }), "info");
}
return enabled;
}
@@ -2330,7 +2345,7 @@ export function setSurfaceHoverInfoMode(
: normalizedMode === SURFACE_HOVER_INFO_MODES.POSITION
? "位置"
: "完整";
showStatusMessage(`悬停提示已切换为:${label}`, "info");
showStatusMessage(earthMessage("status.valueChanged", { label: "悬停提示", value: label }), "info");
}
return normalizedMode;
@@ -2508,12 +2523,13 @@ export function setMotionDebugEnabled(
persistEarthSettings();
}
if (!suppressStatus && changed) {
const message = motionDebugEnabled
? rotationMode === ROTATION_MODE.MOTION
? "动捕调试模式已开启"
: "动捕调试模式将在下次进入动捕时开启"
: "动捕调试模式已关闭";
showStatusMessage(message, "info");
showStatusMessage(
earthMessage("status.motionDebugMode", {
enabled: motionDebugEnabled,
pending: rotationMode !== ROTATION_MODE.MOTION,
}),
"info",
);
}
return motionDebugEnabled;
}
@@ -2537,12 +2553,7 @@ export function setMotionProvider(
persistEarthSettings();
}
if (!suppressStatus && changed) {
showStatusMessage(
motionProvider === "motion_agent"
? "动捕输入源已切换为 Motion Agent"
: "动捕输入源已切换为浏览器摄像头",
"info",
);
showStatusMessage(earthMessage("status.motionProvider", { provider: motionProvider }), "info");
}
return motionProvider;
}
@@ -2566,10 +2577,7 @@ export function setMotionDebugSkeletonOnly(
persistEarthSettings();
}
if (!suppressStatus && changed) {
showStatusMessage(
motionDebugSkeletonOnly ? "动捕调试已切换为只显示骨骼" : "动捕调试已显示实时画面",
"info",
);
showStatusMessage(earthMessage("status.motionDebugView", { skeletonOnly: motionDebugSkeletonOnly }), "info");
}
return motionDebugSkeletonOnly;
}
@@ -2597,7 +2605,7 @@ export function setMotionEnabledGestures(
persistEarthSettings();
}
if (!suppressStatus && changed) {
showStatusMessage("动捕识别动作已更新", "info");
showStatusMessage(earthMessage("status.motionGesturesUpdated"), "info");
}
return getMotionEnabledGestures();
}
@@ -2626,7 +2634,7 @@ function resetEarthSettings() {
}
}
void applyEarthSettings(defaults).then(() => {
showStatusMessage("Earth 设置已重置", "info");
showStatusMessage(earthMessage("status.settingsReset"), "info");
});
}
@@ -2638,7 +2646,7 @@ async function setTerrainEnabled(button, enabled, { persist = true, silent = fal
syncMobileLayerCards();
if (persist) persistEarthSettings();
if (!silent) {
showStatusMessage("地形已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "真实地形", visible: false }), "info");
}
return false;
}
@@ -2651,7 +2659,7 @@ async function setTerrainEnabled(button, enabled, { persist = true, silent = fal
statusText: "加载中",
});
if (!silent) {
showStatusMessage("正在加载真实地形数据...", "info");
showStatusMessage(earthMessage("loading.realTerrainData"), "info");
}
await ensureTerrainReady();
}
@@ -2661,7 +2669,7 @@ async function setTerrainEnabled(button, enabled, { persist = true, silent = fal
syncMobileLayerCards();
if (persist) persistEarthSettings();
if (!silent) {
showStatusMessage("真实地形已显示", "success");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "真实地形", visible: true }), "success");
}
return true;
} catch (error) {
@@ -2670,7 +2678,7 @@ async function setTerrainEnabled(button, enabled, { persist = true, silent = fal
syncMobileLayerCards();
if (persist) persistEarthSettings();
if (!silent) {
showStatusMessage("真实地形暂时不可用", "error");
showStatusMessage(earthMessage("status.terrainUnavailable"), "error");
}
return false;
}
@@ -2688,7 +2696,7 @@ async function setSatellitesLayerEnabled(button, enabled, { persist = true, sile
}
await setSatellitesEnabled(enabled, { suppressStatus: silent, suppressLoadingUi: silent });
if (!enabled && !silent) {
showStatusMessage("卫星已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "卫星", visible: false }), "info");
} else if (enabled) {
setEarthStatValue("satellite-count", `${getSatelliteCount()} 颗`);
}
@@ -2718,7 +2726,7 @@ function setGridLinesLayerEnabled(button, enabled, { persist = true, silent = fa
syncMobileLayerCards();
if (persist) persistEarthSettings();
if (!silent) {
showStatusMessage(enabled ? "经纬线已显示" : "经纬线已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "经纬线", visible: enabled }), "info");
}
return enabled;
}
@@ -2806,7 +2814,7 @@ function setBGPLayerEnabled(button, enabled, { persist = true, silent = false }
syncMobileLayerCards();
if (persist) persistEarthSettings();
if (!silent) {
showStatusMessage(enabled ? "BGP观测已显示" : "BGP观测已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "BGP观测", visible: enabled }), "info");
}
return enabled;
}
@@ -2822,7 +2830,7 @@ function setComputeCentersLayerEnabled(button, enabled, { persist = true, silent
syncMobileLayerCards();
if (persist) persistEarthSettings();
if (!silent) {
showStatusMessage(enabled ? "算力中心已显示" : "算力中心已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "算力中心", visible: enabled }), "info");
}
return enabled;
}
@@ -2891,7 +2899,7 @@ function setTrailsDisplayEnabled(enabled, { persist = true, silent = false } = {
syncMobileLayerCards();
if (persist) persistEarthSettings();
if (!silent) {
showStatusMessage(enabled ? "轨迹已显示" : "轨迹已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "轨迹", visible: enabled }), "info");
}
return enabled;
}
@@ -3001,7 +3009,7 @@ function getBuiltinLayerDefinitions() {
startupMode: "preload",
startupAlwaysLoad: true,
startupLabel: "海陆基座",
startupMessage: "正在加载海陆基座...",
startupMessage: earthMessage("startup.landOceanBase"),
getVisible: () => getShowCountryBoundaries(),
setVisible: (visible, options = {}) =>
setCountryBoundariesLayerEnabled(getLayerButton("countryBoundaries"), visible, options),
@@ -3018,7 +3026,7 @@ function getBuiltinLayerDefinitions() {
startupPriority: 30,
startupMode: "visible",
startupLabel: "高清材质",
startupMessage: "正在启用高清材质...",
startupMessage: earthMessage("startup.hdTexture"),
getVisible: () => getHighResTextureEnabled(),
setVisible: (visible, options = {}) =>
setHighResTextureLayerEnabled(getLayerButton("earthHighResTexture"), visible, options),
@@ -3053,8 +3061,8 @@ function getBuiltinLayerDefinitions() {
startupMode: "visible",
startupLabel: "海缆",
startupMessage: {
prepare: "正在加载登陆点...",
load: "正在加载海缆...",
prepare: earthMessage("startup.landingPoints"),
load: earthMessage("startup.cables"),
},
getVisible: () => getShowCables(),
setVisible: (visible, options = {}) =>
@@ -3072,7 +3080,7 @@ function getBuiltinLayerDefinitions() {
startupPriority: 60,
startupMode: "preload",
startupLabel: "算力中心",
startupMessage: "正在加载算力中心...",
startupMessage: earthMessage("startup.computeCenters"),
getVisible: () => getShowComputeCenters(),
setVisible: (visible, options = {}) =>
setComputeCentersLayerEnabled(getLayerButton("computeCenters"), visible, options),
@@ -3089,7 +3097,7 @@ function getBuiltinLayerDefinitions() {
startupPriority: 70,
startupMode: "preload",
startupLabel: "BGP态势",
startupMessage: "正在加载BGP态势...",
startupMessage: earthMessage("startup.bgp"),
getVisible: () => getShowBGP(),
setVisible: (visible, options = {}) =>
setBGPLayerEnabled(getLayerButton("bgp"), visible, options),
@@ -3106,7 +3114,7 @@ function getBuiltinLayerDefinitions() {
startupPriority: 65,
startupMode: "visible",
startupLabel: "船只",
startupMessage: "正在加载船只...",
startupMessage: earthMessage("startup.vessels"),
getVisible: () => getVesselsEnabled(),
setVisible: (visible, options = {}) =>
setVesselsLayerEnabled(getLayerButton("vessels"), visible, options),
@@ -3123,7 +3131,7 @@ function getBuiltinLayerDefinitions() {
startupPriority: 80,
startupMode: "visible",
startupLabel: "卫星",
startupMessage: "正在加载卫星...",
startupMessage: earthMessage("startup.satellites"),
getVisible: () => getSatellitesEnabled(),
setVisible: (visible, options = {}) =>
setSatellitesLayerEnabled(getLayerButton("satellites"), visible, options),
@@ -3140,7 +3148,7 @@ function getBuiltinLayerDefinitions() {
startupPriority: null,
startupMode: "visible",
startupLabel: "地形",
startupMessage: "正在渲染地形...",
startupMessage: earthMessage("startup.terrain"),
statusTarget: "terrain-status",
getVisible: () => showTerrain,
setVisible: (visible, options = {}) =>
@@ -3345,7 +3353,10 @@ export function showZoomStatusCapsule({ force = false, zoom = null } = {}) {
const currentZoom = Number.isFinite(Number(zoom))
? clampEarthZoomLevel(zoom)
: syncZoomLevelFromCamera(activeCamera);
showGestureStatusMessage(`缩放 ${Math.round(currentZoom * 100)}%`, "info");
showGestureStatusMessage(
earthMessage("status.zoomPercent", { percent: Math.round(currentZoom * 100) }),
"info",
);
}
function cancelSettingsSheetAnimation() {
@@ -3602,10 +3613,17 @@ function syncSettingsToggle(panelId, visible) {
inputs.forEach((input) => {
if (input instanceof HTMLInputElement) {
input.checked = visible;
syncSettingsSwitchVisual(input, visible);
}
});
}
function syncSettingsSwitchVisual(input, visible = input?.checked === true) {
if (!(input instanceof HTMLInputElement)) return;
const switchShell = input.closest(".earth-settings-switch, .earth-mobile-settings-switch");
switchShell?.classList.toggle("is-checked", Boolean(visible));
}
function syncAllHudPanelToggles() {
HUD_PANEL_IDS.forEach((panelId) => {
const panel = document.getElementById(panelId);
@@ -3775,12 +3793,15 @@ function startBoundaryBuildPolling() {
setHighPrecisionBoundariesEnabled(true);
await reloadCountryBoundaries({ suppressStatus: true });
await refreshBoundaryPrecisionStatus().catch(() => {});
showStatusMessage("高精国界已下载并应用", "info");
showStatusMessage(earthMessage("status.boundaryDownloaded"), "info");
}
}
} catch (error) {
stopBoundaryBuildPolling();
showStatusMessage(`高清国界进度读取失败:${error.message || error}`, "warning");
showStatusMessage(
earthMessage("status.failure", { label: "高清国界进度读取失败", error: error.message || error }),
"warning",
);
}
}, 1000);
}
@@ -3791,7 +3812,7 @@ async function startBoundaryPrecisionBuild() {
});
boundaryBuildAttemptedThisSession = true;
await fetchBoundaryPrecisionJson("/api/v1/earth/boundaries/build", { method: "POST", body: "{}" });
showStatusMessage("高精国界构建已启动", "info");
showStatusMessage(earthMessage("status.boundaryBuildStarted"), "info");
startBoundaryBuildPolling();
}
@@ -3806,7 +3827,10 @@ async function setupBoundaryPrecisionControls() {
}
} catch (error) {
renderBoundaryPrecisionStatus({});
showStatusMessage(`高清国界状态读取失败:${error.message || error}`, "warning");
showStatusMessage(
earthMessage("status.failure", { label: "高清国界状态读取失败", error: error.message || error }),
"warning",
);
}
els.buildButtons.forEach((buildButton) => {
@@ -3820,14 +3844,17 @@ async function setupBoundaryPrecisionControls() {
if (getHighPrecisionBoundariesEnabled()) return;
setHighPrecisionBoundariesEnabled(true);
await reloadCountryBoundaries({ suppressStatus: true });
showStatusMessage("已切换到高精国界", "info");
showStatusMessage(earthMessage("status.boundaryPrecision", { high: true }), "info");
await refreshBoundaryPrecisionStatus().catch(() => {});
return;
}
await startBoundaryPrecisionBuild();
} catch (error) {
await refreshBoundaryPrecisionStatus().catch(() => {});
showStatusMessage(`高精国界切换失败:${error.message || error}`, "warning");
showStatusMessage(
earthMessage("status.failure", { label: "高精国界切换失败", error: error.message || error }),
"warning",
);
}
});
});
@@ -3838,7 +3865,10 @@ async function setupBoundaryPrecisionControls() {
await startBoundaryPrecisionBuild();
} catch (error) {
await refreshBoundaryPrecisionStatus().catch(() => {});
showStatusMessage(`高精国界重建启动失败:${error.message || error}`, "warning");
showStatusMessage(
earthMessage("status.failure", { label: "高精国界重建启动失败", error: error.message || error }),
"warning",
);
}
});
});
@@ -3849,10 +3879,13 @@ async function setupBoundaryPrecisionControls() {
if (!getHighPrecisionBoundariesEnabled()) return;
setHighPrecisionBoundariesEnabled(false);
await reloadCountryBoundaries({ suppressStatus: true });
showStatusMessage("已切换到低精国界", "info");
showStatusMessage(earthMessage("status.boundaryPrecision", { high: false }), "info");
await refreshBoundaryPrecisionStatus().catch(() => {});
} catch (error) {
showStatusMessage(`低精国界切换失败:${error.message || error}`, "warning");
showStatusMessage(
earthMessage("status.failure", { label: "低精国界切换失败", error: error.message || error }),
"warning",
);
}
});
});
@@ -4043,7 +4076,7 @@ function setShortcutBinding(actionId, binding, { persist = true } = {}) {
if (!normalizedBinding) return false;
const owner = getShortcutOwnerByBinding(normalizedBinding, { excludeActionId: actionId });
if (owner) {
showStatusMessage(`快捷键已被「${owner.label}」使用`, "warning");
showStatusMessage(earthMessage("status.shortcutConflict", { owner: owner.label }), "warning");
return false;
}
const nextShortcuts = normalizeKeyboardShortcuts(keyboardShortcuts);
@@ -4083,7 +4116,7 @@ function setShortcutEnabled(actionId, enabled, { persist = true } = {}) {
if (enabled) {
const owner = getShortcutOwnerByBinding(currentShortcut.binding, { excludeActionId: actionId });
if (owner) {
showStatusMessage(`快捷键已被「${owner.label}」使用`, "warning");
showStatusMessage(earthMessage("status.shortcutConflict", { owner: owner.label }), "warning");
renderShortcutSettings();
return false;
}
@@ -4110,7 +4143,7 @@ function resetAllShortcutBindings() {
capturingShortcutActionId = null;
renderShortcutSettings();
persistEarthSettings();
showStatusMessage("快捷键已恢复默认", "info");
showStatusMessage(earthMessage("status.shortcutsReset"), "info");
}
function moveCruiseRegionInOrder(region, targetRegion) {
@@ -4270,11 +4303,15 @@ function setupSettingsControls() {
const toggleInputs = document.querySelectorAll("[data-settings-panel]");
toggleInputs.forEach((input) => {
if (input instanceof HTMLInputElement) {
syncSettingsSwitchVisual(input);
}
bindListener(input, "change", (event) => {
const target = event.currentTarget;
if (!(target instanceof HTMLInputElement)) return;
const panelId = target.dataset.settingsPanel;
if (!panelId) return;
syncSettingsSwitchVisual(target, target.checked);
setHudPanelVisibility(panelId, target.checked);
});
});
@@ -5247,7 +5284,10 @@ function setupRotateControls(camera) {
: rotationMode === ROTATION_MODE.MOTION
? "动捕"
: "自动旋转";
showStatusMessage(isRotating ? `${label}已开启` : `${label}已暂停`, "info");
showStatusMessage(
earthMessage("status.runtimePaused", { label, active: isRotating }),
"info",
);
});
updateRotateUI();
@@ -5518,7 +5558,7 @@ function setupTerrainControls() {
bindListener(layoutBtn, "click", () => {
const expanded = toggleLayoutExpanded(container);
showStatusMessage(expanded ? "布局已最大化" : "布局已恢复", "info");
showStatusMessage(earthMessage("status.layoutExpanded", { expanded }), "info");
});
const mediaVisible =
@@ -5552,7 +5592,13 @@ function setupKeyboardControls() {
if (!nextBinding) return;
if (setShortcutBinding(capturingShortcutActionId, nextBinding)) {
const definition = KEYBOARD_SHORTCUT_DEFINITION_BY_ID.get(capturingShortcutActionId);
showStatusMessage(`${definition?.label || "快捷键"}已设置为 ${getShortcutDisplayLabel(nextBinding)}`, "info");
showStatusMessage(
earthMessage("status.shortcutSet", {
label: definition?.label || "快捷键",
binding: getShortcutDisplayLabel(nextBinding),
}),
"info",
);
capturingShortcutActionId = null;
syncShortcutCaptureUi();
}
@@ -6012,9 +6058,9 @@ function updateRotateUI() {
? "动捕"
: "自动旋转";
if (tooltip) {
tooltip.textContent = autoRotate ? `暂停${activeLabel}` : `开始${activeLabel}`;
tooltip.textContent = translateText(autoRotate ? `暂停${activeLabel}` : `开始${activeLabel}`);
}
btn.title = `${getRotationModeLabel()} · ${activeLabel}`;
btn.title = translateText(`${getRotationModeLabel()} · ${activeLabel}`);
}
syncRotationModeButtons();
@@ -6056,7 +6102,7 @@ export function setAutoRotationSpeed(value, { persist = true, suppressStatus = f
persistEarthSettings();
}
if (changed && !suppressStatus) {
showStatusMessage(`旋转转速已设为 ${formatAutoRotationSpeed(normalizedSpeed)}`, "info");
showStatusMessage(earthMessage("status.rotateSpeed", { speed: formatAutoRotationSpeed(normalizedSpeed) }), "info");
}
return normalizedSpeed;
}
@@ -6079,7 +6125,7 @@ export function setRotationMode(nextMode, { persist = true, suppressStatus = fal
persistEarthSettings();
}
if (changed && !suppressStatus) {
showStatusMessage(`已切换到${getRotationModeLabel(normalizedMode)}`, "info");
showStatusMessage(earthMessage("status.switchedTo", { label: getRotationModeLabel(normalizedMode) }), "info");
}
}
@@ -6151,7 +6197,7 @@ export function focusEarthView(camera, options = {}) {
earthObj.rotation.y = nextRotation.y;
earthObj.rotation.z = nextRotation.z;
if (!suppressStatus) {
showStatusMessage("视角已重置", "info");
showStatusMessage(earthMessage("status.viewReset"), "info");
}
resolve();
},
File diff suppressed because it is too large. Load diff
+124 -101
View File
@@ -1,5 +1,12 @@
// info-card.js - Unified info card module
import { showStatusMessage } from './ui.js';
import {
earthMessage,
getEarthLocale,
hasCjkText,
localizeCountryName,
translateText,
} from './i18n.js';
import {
getNewsDisplaySummary,
getNewsDisplayTitle,
@@ -85,8 +92,8 @@ function clearLocationCollectState(contextOrKey) {
}
function getWebSearchDisabledTitle(capability = computeCenterLocationCapability) {
if (!capability) return '正在检查 WebSearch 状态,稍候即可定位。';
return capability.reason || 'WebSearch 未开启,无法进行事实核查定位。';
if (!capability) return infoText('正在检查 WebSearch 状态,稍候即可定位。');
return infoText(capability.reason || 'WebSearch 未开启,无法进行事实核查定位。');
}
function isComputeCenterLocationBlocked() {
@@ -134,7 +141,7 @@ function setLocationButtonLoading(button, loading, label) {
button.classList.toggle('is-loading', Boolean(loading));
button.toggleAttribute('aria-busy', Boolean(loading));
if (label) {
button.dataset.loadingLabel = label;
button.dataset.loadingLabel = infoText(label);
}
updateComputeCenterLocationCapabilityDom();
}
@@ -188,14 +195,27 @@ function formatInfoCardValue(field, rawValue) {
if (IDENTIFIER_FIELD_KEYS.has(field.key)) {
value = String(value);
} else if (typeof value === 'number') {
value = value.toLocaleString();
value = value.toLocaleString(getEarthLocale());
}
if (field.key === 'country') {
value = localizeCountryName(value) || value;
}
if (field.unit && value !== '-') {
value = value + ' ' + field.unit;
value = value + ' ' + translateText(field.unit);
} else if (typeof value === 'string') {
value = translateText(value);
}
return value;
}
function infoText(value, fallback = '') {
const translated = translateText(value);
if (getEarthLocale() === 'en-US' && hasCjkText(translated) && fallback) {
return fallback;
}
return translated;
}
function escapeInfoCardHtml(value) {
return String(value ?? '').replace(/[&<>"']/g, (char) => ({
'&': '&amp;',
@@ -299,18 +319,18 @@ function renderNewsCardContent(content, data) {
const metaHtml = metaItems.length
? `<div class="info-card-news-meta-grid">${metaItems.map(([label, value]) => `
<div class="info-card-news-meta-item">
<span>${escapeInfoCardHtml(label)}</span>
<span>${escapeInfoCardHtml(infoText(label))}</span>
<strong>${escapeInfoCardHtml(value)}</strong>
</div>
`).join('')}</div>`
: '';
content.innerHTML = `
<div class="info-card-news-layout">
<div class="info-card-news-kicker">新闻信号</div>
<div class="info-card-news-kicker">${escapeInfoCardHtml(infoText('新闻信号'))}</div>
<div class="info-card-news-title">${escapeInfoCardHtml(title)}</div>
${metaHtml}
<div class="info-card-news-summary-shell">
<div class="info-card-news-summary-label">概要</div>
<div class="info-card-news-summary-label">${escapeInfoCardHtml(infoText('概要'))}</div>
<div class="info-card-news-summary" data-news-summary></div>
</div>
</div>
@@ -332,18 +352,18 @@ function renderMobileNewsCardContent(content, data) {
const metaHtml = metaItems.length
? `<div class="info-card-news-meta-grid info-card-news-meta-grid--mobile">${metaItems.map(([label, value]) => `
<div class="info-card-news-meta-item">
<span>${escapeInfoCardHtml(label)}</span>
<span>${escapeInfoCardHtml(infoText(label))}</span>
<strong>${escapeInfoCardHtml(value)}</strong>
</div>
`).join('')}</div>`
: '';
content.innerHTML = `
<div class="earth-mobile-news-detail">
<div class="earth-mobile-news-detail-kicker">新闻信号</div>
<div class="earth-mobile-news-detail-kicker">${escapeInfoCardHtml(infoText('新闻信号'))}</div>
<div class="earth-mobile-news-detail-title">${escapeInfoCardHtml(title)}</div>
${metaHtml}
<div class="earth-mobile-news-detail-summary-shell">
<div class="earth-mobile-news-detail-summary-label">概要</div>
<div class="earth-mobile-news-detail-summary-label">${escapeInfoCardHtml(infoText('概要'))}</div>
<div class="earth-mobile-news-detail-summary" data-news-summary></div>
</div>
</div>
@@ -371,7 +391,7 @@ function renderMobileDetailContent(type, config, data) {
const value = formatInfoCardValue(field, data[field.key]);
html += `
<div class="earth-mobile-detail-row">
<span class="earth-mobile-detail-row-label">${field.label}</span>
<span class="earth-mobile-detail-row-label">${escapeInfoCardHtml(infoText(field.label))}</span>
<span class="earth-mobile-detail-row-value">${value}</span>
</div>
`;
@@ -428,7 +448,7 @@ function renderDefaultCardContent(content, config, data) {
const sourceLabel = getFieldSourceLabel(data, field.key);
html += `
<div class="info-card-property">
<span class="info-card-label">${field.label}</span>
<span class="info-card-label">${escapeInfoCardHtml(infoText(field.label))}</span>
<span class="info-card-value">${value}${sourceLabel}</span>
</div>
`;
@@ -519,8 +539,8 @@ function buildLocationCollectContext(config, data) {
function renderLocationCollectSection(context) {
const buttonLabel = context.needsConfirmation
? '重新自动采集坐标'
: '自动采集坐标候选';
? infoText('重新自动采集坐标')
: infoText('自动采集坐标候选');
const cacheKey = getLocationCollectCacheKey(context);
const cached = getLocationCollectState(cacheKey);
ensureComputeCenterLocationCapability();
@@ -559,7 +579,7 @@ function hydrateLocationCollectRoot(root, state) {
const statusEl = root.querySelector('[data-collect-status], [data-unresolved-status]');
const candidatesEl = root.querySelector('[data-collect-candidates], [data-unresolved-candidates]');
const button = root.querySelector('[data-collect-action="run"], [data-unresolved-collect]');
if (statusEl) statusEl.textContent = state?.statusText || '';
if (statusEl) statusEl.textContent = infoText(state?.statusText || '');
if (candidatesEl) candidatesEl.innerHTML = renderCachedCollectCandidates(state);
if (button instanceof HTMLButtonElement) {
button.classList.toggle('is-loading', state?.loading === true);
@@ -654,15 +674,15 @@ function ensureCandidateActionBindings(rootOrChild, context) {
if (typeof actionContext.save !== 'function') return;
const statusEl = root.querySelector('[data-collect-status], [data-unresolved-status]');
button.disabled = true;
if (statusEl) statusEl.textContent = '正在保存所选坐标...';
if (statusEl) statusEl.textContent = infoText('正在保存所选坐标...');
try {
const saveResult = await actionContext.save(candidate);
setLocationCollectState(actionContext, {
loading: false,
statusText: '坐标已保存',
statusText: infoText('坐标已保存'),
candidates: [],
});
if (statusEl) statusEl.textContent = '坐标已保存';
if (statusEl) statusEl.textContent = infoText('坐标已保存');
window.dispatchEvent(
new CustomEvent('earth:compute-center-location-saved', {
detail: {
@@ -685,7 +705,7 @@ function ensureCandidateActionBindings(rootOrChild, context) {
}
} catch (error) {
console.error('save compute-center location failed', error);
if (statusEl) statusEl.textContent = `保存失败:${error?.message || error}`;
if (statusEl) statusEl.textContent = infoText(`保存失败:${error?.message || error}`);
button.disabled = false;
}
});
@@ -695,14 +715,14 @@ function formatLocationCollectFailure(result) {
const regularReason = result?.failure_reason || '常规来源没有可用坐标候选';
const llmReason = result?.llm_failure_reason;
if (llmReason) {
return `常规来源无结果;LLM 兜底未生成可用候选:${llmReason}`;
return infoText(`常规来源无结果;LLM 兜底未生成可用候选:${llmReason}`);
}
const attempted = Array.isArray(result?.attempted_queries) ? result.attempted_queries : [];
const attemptedLlm = attempted.some((query) => String(query || '').startsWith('llm_factcheck:'));
if (attemptedLlm) {
return `常规来源无结果;LLM 兜底已尝试但没有返回可用候选。${regularReason}`;
return infoText(`常规来源无结果;LLM 兜底已尝试但没有返回可用候选。${regularReason}`);
}
return regularReason;
return infoText(regularReason);
}
function bindLocationCollectControls(content, context) {
@@ -728,7 +748,7 @@ function bindLocationCollectControls(content, context) {
setLocationButtonLoading(button, true, '正在定位');
setLocationCollectState(context, {
loading: true,
statusText: '正在采集坐标候选...',
statusText: infoText('正在采集坐标候选...'),
candidates: [],
});
try {
@@ -736,7 +756,7 @@ function bindLocationCollectControls(content, context) {
if (!result?.success) {
setLocationCollectState(context, {
loading: false,
statusText: `未能采集到坐标:${formatLocationCollectFailure(result)}`,
statusText: infoText(`未能采集到坐标:${formatLocationCollectFailure(result)}`),
candidates: [],
result,
});
@@ -745,7 +765,7 @@ function bindLocationCollectControls(content, context) {
const candidates = Array.isArray(result.candidates) ? result.candidates : [];
setLocationCollectState(context, {
loading: false,
statusText: `共找到 ${candidates.length} 个候选位置`,
statusText: infoText(`共找到 ${candidates.length} 个候选位置`),
candidates,
result,
});
@@ -753,7 +773,7 @@ function bindLocationCollectControls(content, context) {
console.error('collect-location failed', error);
setLocationCollectState(context, {
loading: false,
statusText: `采集失败:${error?.message || error}`,
statusText: infoText(`采集失败:${error?.message || error}`),
candidates: [],
});
} finally {
@@ -773,22 +793,22 @@ function renderCollectCandidateRow(candidate, isBest, index) {
? `${Math.round(Number(candidate.confidence) * 100)}%`
: '-';
const safeIndex = Number.isFinite(Number(index)) ? Number(index) : 0;
const name = escapeInfoCardHtml(candidate.matched_location_name || candidate.display_name || '候选');
const name = escapeInfoCardHtml(candidate.matched_location_name || candidate.display_name || infoText('候选'));
const sourceLabel = escapeInfoCardHtml(candidate.source || '');
return `
<div class="info-card-compute-candidate ${isBest ? 'is-best' : ''}">
<div class="info-card-compute-candidate-line">
<span class="info-card-compute-candidate-name">${name}</span>
<span class="info-card-compute-candidate-precision">${escapeInfoCardHtml(precisionLabel)}</span>
<span class="info-card-compute-candidate-precision">${escapeInfoCardHtml(infoText(precisionLabel))}</span>
</div>
<div class="info-card-compute-candidate-line">
<span class="info-card-compute-candidate-source">${sourceLabel}</span>
<span class="info-card-compute-candidate-confidence">置信 ${escapeInfoCardHtml(confidence)}</span>
<span class="info-card-compute-candidate-confidence">${escapeInfoCardHtml(infoText(`置信 ${confidence}`))}</span>
</div>
<div class="info-card-compute-candidate-line">
<span class="info-card-compute-candidate-coords">${Number(candidate.latitude).toFixed(4)}, ${Number(candidate.longitude).toFixed(4)}</span>
<button type="button" class="info-card-compute-candidate-preview" data-preview-candidate data-candidate-index="${safeIndex}">预览</button>
<button type="button" class="info-card-compute-candidate-preview" data-save-candidate data-candidate-index="${safeIndex}">保存</button>
<button type="button" class="info-card-compute-candidate-preview" data-preview-candidate data-candidate-index="${safeIndex}">${escapeInfoCardHtml(infoText('预览'))}</button>
<button type="button" class="info-card-compute-candidate-preview" data-save-candidate data-candidate-index="${safeIndex}">${escapeInfoCardHtml(infoText('保存'))}</button>
</div>
</div>
`;
@@ -803,7 +823,7 @@ function getUnresolvedComputeCenterContext(item) {
entityId: item?.source_id || item?.id || '',
sourceId: item?.source_id || item?.id || '',
recordId: item?.id || item?.record_id || '',
name: item?.name || item?.title || '未命名算力中心',
name: item?.name || item?.title || infoText('未命名算力中心'),
site_type: item?.site_type || metadata.site_type || '',
operator: item?.operator || item?.vendor || metadata.operator || '',
site: item?.site || metadata.site || metadata.organization || '',
@@ -821,7 +841,7 @@ function renderComputeCenterUnresolvedContent(content, data) {
if (!items.length) {
content.innerHTML = `
<div class="info-card-unresolved-empty">
当前没有待定位算力中心
${escapeInfoCardHtml(infoText('当前没有待定位算力中心'))}
</div>
`;
return;
@@ -835,7 +855,7 @@ function renderComputeCenterUnresolvedContent(content, data) {
const cached = getLocationCollectState(cacheKey);
const meta = [context.site || context.operator, context.city, context.country]
.filter(Boolean)
.join(' · ') || '缺少可用地址字段';
.join(' · ') || infoText('缺少可用地址字段');
return `
<div class="info-card-unresolved-item" data-unresolved-item data-collect-cache-key="${escapeInfoCardHtml(cacheKey)}">
<div class="info-card-unresolved-main">
@@ -847,10 +867,10 @@ function renderComputeCenterUnresolvedContent(content, data) {
<button type="button" class="info-card-compute-candidate-preview"
data-unresolved-collect
data-requires-web-search="true"
data-ready-title="采集坐标候选"
title="${escapeInfoCardHtml(blocked ? disabledTitle : '采集坐标候选')}"
data-ready-title="${escapeInfoCardHtml(infoText('采集坐标候选'))}"
title="${escapeInfoCardHtml(blocked ? disabledTitle : infoText('采集坐标候选'))}"
${blocked ? 'disabled aria-disabled="true"' : ''}
data-context-json="${contextJson}">采集</button>
data-context-json="${contextJson}">${escapeInfoCardHtml(getEarthLocale() === 'en-US' ? 'Collect' : '采集')}</button>
</div>
<div class="info-card-compute-collect-status" data-unresolved-status>${escapeInfoCardHtml(cached?.statusText || '')}</div>
<div class="info-card-compute-collect-candidates" data-unresolved-candidates>
@@ -863,14 +883,14 @@ function renderComputeCenterUnresolvedContent(content, data) {
content.innerHTML = `
<div class="info-card-unresolved-summary">
<span data-unresolved-summary-text>${items.length} 个算力中心没有可信坐标</span>
<span data-unresolved-summary-text>${escapeInfoCardHtml(infoText(`${items.length} 个算力中心没有可信坐标`))}</span>
<button type="button" class="info-card-compute-candidate-preview info-card-unresolved-adopt"
data-unresolved-adopt-all
data-requires-web-search="true"
data-ready-title="一键定位并采用最高置信候选"
title="${escapeInfoCardHtml(blocked ? disabledTitle : '一键定位并采用最高置信候选')}"
data-ready-title="${escapeInfoCardHtml(infoText('一键定位并采用最高置信候选'))}"
title="${escapeInfoCardHtml(blocked ? disabledTitle : infoText('一键定位并采用最高置信候选'))}"
${blocked ? 'disabled aria-disabled="true"' : ''}>
一键定位
${escapeInfoCardHtml(infoText('一键定位'))}
</button>
</div>
<div class="info-card-compute-collect-status" data-unresolved-batch-status>${escapeInfoCardHtml(computeCenterUnresolvedBatchState.statusText || '')}</div>
@@ -888,8 +908,8 @@ function updateUnresolvedSummary(content) {
const summaryText = content.querySelector('[data-unresolved-summary-text]');
if (summaryText) {
summaryText.textContent = remainingCount > 0
? `${remainingCount} 个算力中心没有可信坐标`
: '当前没有待定位算力中心';
? infoText(`${remainingCount} 个算力中心没有可信坐标`)
: infoText('当前没有待定位算力中心');
}
const adoptAllButton = content.querySelector('[data-unresolved-adopt-all]');
if (adoptAllButton instanceof HTMLButtonElement) {
@@ -948,7 +968,7 @@ async function collectUnresolvedComputeCenterCandidates(context, options = {}) {
async function saveBestUnresolvedComputeCenterCandidate(context, progressLabel = '') {
setLocationCollectState(context, {
loading: true,
statusText: progressLabel || '正在一键定位并采用最高置信候选...',
statusText: infoText(progressLabel || '正在一键定位并采用最高置信候选...'),
candidates: [],
});
const { mod, result, candidates } = await collectUnresolvedComputeCenterCandidates(
@@ -958,7 +978,7 @@ async function saveBestUnresolvedComputeCenterCandidate(context, progressLabel =
if (!result?.success) {
setLocationCollectState(context, {
loading: false,
statusText: `未找到可采用候选:${formatLocationCollectFailure(result)}`,
statusText: infoText(`未找到可采用候选:${formatLocationCollectFailure(result)}`),
candidates: [],
result,
});
@@ -966,7 +986,7 @@ async function saveBestUnresolvedComputeCenterCandidate(context, progressLabel =
}
setLocationCollectState(context, {
loading: true,
statusText: `找到 ${candidates.length} 个候选,正在保存最高置信位置...`,
statusText: infoText(`找到 ${candidates.length} 个候选,正在保存最高置信位置...`),
candidates,
result,
});
@@ -974,7 +994,7 @@ async function saveBestUnresolvedComputeCenterCandidate(context, progressLabel =
if (!bestCandidate) {
setLocationCollectState(context, {
loading: false,
statusText: '未找到包含有效经纬度的候选',
statusText: infoText('未找到包含有效经纬度的候选'),
candidates,
result,
});
@@ -983,7 +1003,7 @@ async function saveBestUnresolvedComputeCenterCandidate(context, progressLabel =
const saveResult = await mod.saveComputeCenterLocation(context.sourceId, bestCandidate, context);
setLocationCollectState(context, {
loading: false,
statusText: '坐标已保存,等待图层刷新',
statusText: infoText('坐标已保存,等待图层刷新'),
candidates,
result,
savedCandidate: bestCandidate,
@@ -1052,7 +1072,7 @@ function bindComputeCenterUnresolvedControls(content) {
setLocationButtonLoading(button, true, '正在定位');
setLocationCollectState(context, {
loading: true,
statusText: '正在采集坐标候选...',
statusText: infoText('正在采集坐标候选...'),
candidates: [],
});
try {
@@ -1060,7 +1080,7 @@ function bindComputeCenterUnresolvedControls(content) {
if (!result?.success) {
setLocationCollectState(context, {
loading: false,
statusText: `未能采集到坐标:${formatLocationCollectFailure(result)}`,
statusText: infoText(`未能采集到坐标:${formatLocationCollectFailure(result)}`),
candidates: [],
result,
});
@@ -1068,7 +1088,7 @@ function bindComputeCenterUnresolvedControls(content) {
}
setLocationCollectState(context, {
loading: false,
statusText: `共找到 ${candidates.length} 个候选位置`,
statusText: infoText(`共找到 ${candidates.length} 个候选位置`),
candidates,
result,
});
@@ -1084,7 +1104,7 @@ function bindComputeCenterUnresolvedControls(content) {
console.error('collect unresolved compute-center location failed', error);
setLocationCollectState(context, {
loading: false,
statusText: `采集失败:${error?.message || error}`,
statusText: infoText(`采集失败:${error?.message || error}`),
candidates: [],
});
} finally {
@@ -1127,7 +1147,7 @@ function bindComputeCenterUnresolvedControls(content) {
processed: 0,
saved: 0,
missed: 0,
statusText: `一键定位进行中 0/${pendingItems.length}...`,
statusText: infoText(`一键定位进行中 0/${pendingItems.length}...`),
});
let savedCount = 0;
@@ -1136,7 +1156,7 @@ function bindComputeCenterUnresolvedControls(content) {
for (const [index, { itemRoot, context }] of pendingItems.entries()) {
const itemStatusEl = itemRoot.querySelector('[data-unresolved-status]');
itemRoot.classList.add('is-locating');
const progressText = `正在定位并采用最高置信候选 ${index + 1}/${pendingItems.length}...`;
const progressText = infoText(`正在定位并采用最高置信候选 ${index + 1}/${pendingItems.length}...`);
setUnresolvedBatchState({
statusText: progressText,
processed: index,
@@ -1147,7 +1167,7 @@ function bindComputeCenterUnresolvedControls(content) {
try {
const saveOutcome = await saveBestUnresolvedComputeCenterCandidate(context, progressText);
if (!saveOutcome.saved) {
if (itemStatusEl) itemStatusEl.textContent = getLocationCollectState(context)?.statusText || '未找到可采用候选';
if (itemStatusEl) itemStatusEl.textContent = getLocationCollectState(context)?.statusText || infoText('未找到可采用候选');
missedCount += 1;
continue;
}
@@ -1157,11 +1177,11 @@ function bindComputeCenterUnresolvedControls(content) {
console.error('adopt unresolved compute-center location failed', error);
setLocationCollectState(context, {
loading: false,
statusText: `一键定位失败:${error?.message || error}`,
statusText: infoText(`一键定位失败:${error?.message || error}`),
candidates: [],
});
if (itemStatusEl) {
itemStatusEl.textContent = `一键采用失败:${error?.message || error}`;
itemStatusEl.textContent = infoText(`一键采用失败:${error?.message || error}`);
}
missedCount += 1;
} finally {
@@ -1170,14 +1190,14 @@ function bindComputeCenterUnresolvedControls(content) {
processed: index + 1,
saved: savedCount,
missed: missedCount,
statusText: `一键定位进行中 ${index + 1}/${pendingItems.length},已保存 ${savedCount} 个${missedCount ? `,失败 ${missedCount} 个` : ''}`,
statusText: infoText(`一键定位进行中 ${index + 1}/${pendingItems.length},已保存 ${savedCount} 个${missedCount ? `,失败 ${missedCount} 个` : ''}`),
});
}
}
const finalStatus = savedCount > 0
? `已定位并采用 ${savedCount} 个最高置信候选${missedCount ? `,${missedCount} 个仍需手动处理` : ''}`
: `${missedCount} 个都没有可自动采用的候选,需要手动处理`;
? infoText(`已定位并采用 ${savedCount} 个最高置信候选${missedCount ? `,${missedCount} 个仍需手动处理` : ''}`)
: infoText(`${missedCount} 个都没有可自动采用的候选,需要手动处理`);
if (statusEl) statusEl.textContent = finalStatus;
setUnresolvedBatchState({
running: false,
@@ -1213,7 +1233,7 @@ function getFieldSourceLabel(data, fieldKey) {
if (!sources || typeof sources !== 'object') return '';
const source = sources[fieldKey];
if (!source) return '';
return ` <span class="info-card-source-tag" title="字段来源">${source}</span>`;
return ` <span class="info-card-source-tag" title="${escapeInfoCardHtml(infoText('字段来源'))}">${escapeInfoCardHtml(infoText(source))}</span>`;
}
function renderVesselEnrichmentSection(enrichment) {
@@ -1223,8 +1243,8 @@ function renderVesselEnrichmentSection(enrichment) {
if (!profile && !media) {
return `
<div class="info-card-enrichment info-card-enrichment--empty">
<div class="info-card-enrichment-title">船舶资料</div>
<div class="info-card-enrichment-status">资料缓存中</div>
<div class="info-card-enrichment-title">${escapeInfoCardHtml(infoText('船舶资料'))}</div>
<div class="info-card-enrichment-status">${escapeInfoCardHtml(infoText('资料缓存中'))}</div>
</div>
`;
}
@@ -1244,11 +1264,11 @@ function renderVesselEnrichmentSection(enrichment) {
inner += renderEnrichmentMeta('媒体', media);
}
if (!inner) {
inner = '<div class="info-card-enrichment-status">资料缓存中</div>';
inner = `<div class="info-card-enrichment-status">${escapeInfoCardHtml(infoText('资料缓存中'))}</div>`;
}
return `
<div class="info-card-enrichment">
<div class="info-card-enrichment-title">船舶资料</div>
<div class="info-card-enrichment-title">${escapeInfoCardHtml(infoText('船舶资料'))}</div>
${inner}
</div>
`;
@@ -1261,8 +1281,8 @@ function renderEnrichmentPayloadRows(payload) {
if (typeof value === 'object') continue;
rows += `
<div class="info-card-property">
<span class="info-card-label">${key}</span>
<span class="info-card-value">${String(value)}</span>
<span class="info-card-label">${escapeInfoCardHtml(infoText(key))}</span>
<span class="info-card-value">${escapeInfoCardHtml(infoText(String(value)))}</span>
</div>
`;
}
@@ -1271,45 +1291,45 @@ function renderEnrichmentPayloadRows(payload) {
function renderEnrichmentMeta(label, record) {
const parts = [];
if (record.source) parts.push(`来源 ${record.source}`);
if (record.fetched_at) parts.push(`更新 ${record.fetched_at}`);
if (record.source) parts.push(infoText(`来源 ${record.source}`));
if (record.fetched_at) parts.push(infoText(`更新 ${record.fetched_at}`));
if (record.confidence !== null && record.confidence !== undefined) {
parts.push(`置信 ${Number(record.confidence).toFixed(2)}`);
parts.push(infoText(`置信 ${Number(record.confidence).toFixed(2)}`));
}
if (!parts.length) return '';
return `<div class="info-card-enrichment-meta">${label}:${parts.join(' · ')}</div>`;
return `<div class="info-card-enrichment-meta">${escapeInfoCardHtml(infoText(label))}: ${escapeInfoCardHtml(parts.join(' · '))}</div>`;
}
// ── Mobile popup ─────────────────────────────────────────────
function getMobilePopupTitle(type, data) {
switch (type) {
case 'cable': return data.name || '海缆';
case 'landing_point': return data.name || '登陆点';
case 'satellite': return data.name || '卫星';
case 'bgp': return data.anomaly_type || 'BGP事件';
case 'cable': return data.name || infoText('海缆');
case 'landing_point': return data.name || infoText('登陆点');
case 'satellite': return data.name || infoText('卫星');
case 'bgp': return data.anomaly_type || infoText('BGP事件');
case 'news': return getNewsCardTitle(data);
case 'bgp_collector': return data.collector || 'BGP观测站';
case 'compute_center_unresolved': return '待定位算力中心';
case 'supercomputer': return data.name || '超算';
case 'gpu_cluster': return data.name || 'GPU集群';
case 'vessel': return data.name || '船只';
default: return '详情';
case 'bgp_collector': return data.collector || infoText('BGP观测站');
case 'compute_center_unresolved': return infoText('待定位算力中心');
case 'supercomputer': return data.name || infoText('超算');
case 'gpu_cluster': return data.name || infoText('GPU集群');
case 'vessel': return data.name || infoText('船只');
default: return infoText('详情');
}
}
function getMobilePopupSubtitle(type, data) {
switch (type) {
case 'cable': return data.owner || data.status || '海缆';
case 'landing_point': return data.country || '登陆点';
case 'satellite': return data.norad_id ? `NORAD ${data.norad_id}` : '卫星';
case 'bgp': return data.severity || 'BGP路由异常';
case 'news': return getNewsCardSummaryPreview(data, 30) || '态势新闻';
case 'bgp_collector': return data.location || 'BGP观测站';
case 'compute_center_unresolved': return `${data?.totalCount || 0} 个待定位`;
case 'supercomputer': return data.country || '超级计算机';
case 'gpu_cluster': return data.country || 'GPU集群';
case 'vessel': return data.vessel_type || 'AIS 船只';
case 'cable': return infoText(data.owner || data.status || '海缆');
case 'landing_point': return localizeCountryName(data.country) || infoText('登陆点');
case 'satellite': return data.norad_id ? `NORAD ${data.norad_id}` : infoText('卫星');
case 'bgp': return infoText(data.severity || 'BGP路由异常');
case 'news': return getNewsCardSummaryPreview(data, 30) || infoText('态势新闻');
case 'bgp_collector': return data.location || infoText('BGP观测站');
case 'compute_center_unresolved': return infoText(`${data?.totalCount || 0} 个待定位`);
case 'supercomputer': return localizeCountryName(data.country) || infoText('超级计算机');
case 'gpu_cluster': return localizeCountryName(data.country) || infoText('GPU集群');
case 'vessel': return data.vessel_type || infoText('AIS 船只');
default: return '';
}
}
@@ -1809,8 +1829,8 @@ function mountCard() {
<div id="info-card" class="info-card">
<div class="info-card-header hud-panel-drag-handle">
<span class="info-card-icon" id="info-card-icon">🛰️</span>
<h3 id="info-card-title">详情</h3>
<button class="info-card-close hud-panel-close" type="button" aria-label="关闭详情">
<h3 id="info-card-title">${escapeInfoCardHtml(infoText('详情'))}</h3>
<button class="info-card-close hud-panel-close" type="button" aria-label="${escapeInfoCardHtml(infoText('关闭详情'))}">
<span class="material-symbols-rounded">close</span>
</button>
</div>
@@ -1850,16 +1870,19 @@ function mountCard() {
const value = valueEl?.textContent?.trim();
if (!value || value === '-') {
showStatusMessage('无可复制内容', 'warning');
showStatusMessage(earthMessage("status.copyEmpty"), 'warning');
return;
}
try {
await navigator.clipboard.writeText(value);
showStatusMessage(`已复制${label.textContent}:${value}`, 'success');
showStatusMessage(
earthMessage("status.copyValue", { label: label.textContent, value }),
'success',
);
} catch (error) {
console.error('Copy failed:', error);
showStatusMessage('复制失败', 'error');
showStatusMessage(earthMessage("status.copyFailed"), 'error');
}
});
@@ -1885,7 +1908,7 @@ function positionPanel(panel, x, y, options = {}) {
const scale = parseFloat(
getComputedStyle(document.documentElement).getPropertyValue('--hud-scale')
) || 1;
const estW = Math.min(300 * scale, vpW - 32);
const estW = Math.min(340 * scale, vpW - 32);
const estH = Math.min(420 * scale, vpH * 0.7);
if (options.absolute === true) {
@@ -2000,11 +2023,11 @@ export function showInfoCard(type, data, options = {}) {
if (title) {
title.textContent = type === 'news'
? getNewsCardTitle(data)
: config.title;
: infoText(config.title);
}
if (typeLabel) {
typeLabel.textContent = type === 'news'
? '新闻信号'
? infoText('新闻信号')
: type.replaceAll('_', ' ');
}
@@ -2041,7 +2064,7 @@ export function showInfoCard(type, data, options = {}) {
icon.textContent = config.icon;
title.textContent = type === 'news'
? getNewsCardTitle(data)
: config.title;
: infoText(config.title);
if (type === 'news') {
renderNewsCardContent(content, data);
@@ -1,10 +1,13 @@
import { translateText } from "./i18n.js";
export function setButtonTooltip(button, text) {
const translatedText = translateText(text);
if (button instanceof HTMLElement) {
button.title = text;
button.title = translatedText;
}
const tooltip = button?.querySelector(".earth-toolbar-tooltip");
if (tooltip) {
tooltip.textContent = text;
tooltip.textContent = translatedText;
}
}
@@ -32,6 +32,7 @@ import {
loadCountryBoundaries,
toggleCountryBoundaries,
} from "./country-boundaries.js";
import { earthMessage } from "./i18n.js";
/**
* Layer startup task registry.
@@ -101,7 +102,7 @@ function registerVesselStartupTask() {
if (!context.getShowVessels()) return;
context.setLoadingMessage(
resolveStartupMessage(layer, "load", "正在加载船只..."),
resolveStartupMessage(layer, "load", earthMessage("startup.vessels")),
);
await context.yieldFrame(12);
try {
@@ -125,7 +126,7 @@ function registerCableStartupTask() {
if (!context.isCablesEnabled()) return;
context.setLoadingMessage(
resolveStartupMessage(layer, "prepare", "正在加载登陆点..."),
resolveStartupMessage(layer, "prepare", earthMessage("startup.landingPoints")),
);
await context.yieldFrame(12);
try {
@@ -137,7 +138,7 @@ function registerCableStartupTask() {
await context.yieldFrame(16);
context.setLoadingMessage(
resolveStartupMessage(layer, "load", "正在加载海缆..."),
resolveStartupMessage(layer, "load", earthMessage("startup.cables")),
);
await context.yieldFrame(12);
try {
@@ -161,7 +162,7 @@ function registerSatelliteStartupTask() {
if (!context.isSatellitesEnabled()) return;
context.setLoadingMessage(
resolveStartupMessage(layer, "load", "正在加载卫星..."),
resolveStartupMessage(layer, "load", earthMessage("startup.satellites")),
);
await context.yieldFrame(12);
try {
@@ -200,7 +201,7 @@ function registerSatelliteStartupTask() {
function registerBGPStartupTask() {
registerLayerStartupTask("bgp", (context) => async (layer) => {
context.setLoadingMessage(
resolveStartupMessage(layer, "load", "正在加载BGP态势..."),
resolveStartupMessage(layer, "load", earthMessage("startup.bgp")),
);
await context.yieldFrame(12);
try {
@@ -223,7 +224,7 @@ function registerEarthTextureStartupTask() {
if (!context.isEarthTextureVisible()) return;
context.setLoadingMessage(
resolveStartupMessage(layer, "load", "正在加载地球纹理..."),
resolveStartupMessage(layer, "load", earthMessage("startup.hdTexture")),
);
await context.yieldFrame(12);
try {
@@ -241,7 +242,7 @@ function registerCloudStartupTask() {
if (!context.isCloudsEnabled()) return;
context.setLoadingMessage(
resolveStartupMessage(layer, "load", "正在加载大气云图..."),
resolveStartupMessage(layer, "load", earthMessage("startup.clouds")),
);
await context.yieldFrame(12);
try {
@@ -257,7 +258,7 @@ function registerCloudStartupTask() {
function registerCountryBoundaryStartupTask() {
registerLayerStartupTask("countryBoundaries", (context) => async (layer) => {
context.setLoadingMessage(
resolveStartupMessage(layer, "load", "正在加载海陆基座..."),
resolveStartupMessage(layer, "load", earthMessage("startup.landOceanBase")),
);
await context.yieldFrame(12);
try {
@@ -283,7 +284,7 @@ function registerCountryBoundaryStartupTask() {
function registerComputeCenterStartupTask() {
registerLayerStartupTask("computeCenters", (context) => async (layer) => {
context.setLoadingMessage(
resolveStartupMessage(layer, "load", "正在加载算力中心..."),
resolveStartupMessage(layer, "load", earthMessage("startup.computeCenters")),
);
await context.yieldFrame(12);
try {
+40 -7
View File
@@ -1,8 +1,9 @@
import { createHUDPanel } from "./hud-panels.js";
import { getEarthLocale, translateText } from "./i18n.js";
const LEGEND_MODES = {
cables: { title: "海缆" },
satellites: { title: "卫星" },
cables: { title: "海缆", compactTitleEn: "Cables" },
satellites: { title: "卫星", compactTitleEn: "Orbits" },
countryBoundaries: { title: "国界" },
computeCenters: { title: "算力" },
vessels: { title: "船只" },
@@ -11,6 +12,7 @@ const LEGEND_MODES = {
let currentLegendMode = "cables";
let legendPanel = null;
let legendLocaleListenerBound = false;
let legendItemsByMode = {
cables: [],
satellites: [],
@@ -40,6 +42,14 @@ export function initLegend() {
});
}
if (!legendLocaleListenerBound) {
legendLocaleListenerBound = true;
window.addEventListener("earth:locale-change", () => {
syncCurrentLabel(currentLegendMode);
renderLegend(currentLegendMode);
});
}
syncCurrentLabel(currentLegendMode);
renderLegend(currentLegendMode);
}
@@ -68,24 +78,38 @@ export function setLegendItems(mode, items) {
}
function syncCurrentLabel(mode) {
const nextLabel = LEGEND_MODES[mode]?.title || LEGEND_MODES.cables.title;
const nextLabel = getLegendModeTitle(mode);
[document.getElementById("legend-current-label"), document.getElementById("mobile-situation-legend-mode")]
.forEach((labelEl) => {
if (labelEl) {
labelEl.textContent = nextLabel;
const translatedLabel = getEarthLocale() === "en-US" ? nextLabel : translateText(nextLabel);
labelEl.textContent = translatedLabel;
labelEl.dataset.i18nOriginalTitle = translatedLabel;
labelEl.title = translatedLabel;
}
});
}
function getLegendModeTitle(mode) {
const definition = LEGEND_MODES[mode] || LEGEND_MODES.cables;
if (getEarthLocale() === "en-US" && definition.compactTitleEn) {
return definition.compactTitleEn;
}
return definition.title;
}
function renderLegend(mode) {
const items = legendItemsByMode[mode] || [];
const html = items
.map(
(item) => `
(item) => {
const label = escapeLegendHtml(translateText(item.label));
return `
<div class="legend-item">
<span class="legend-dot legend-dot--${item.shape || "dot"}" style="background:${item.color}; color:${item.color}"></span>
<span class="legend-label">${item.label}</span>
</div>`,
<span class="legend-label" title="${label}">${label}</span>
</div>`;
},
)
.join("");
@@ -99,3 +123,12 @@ function renderLegend(mode) {
mobileList.innerHTML = html;
}
}
function escapeLegendHtml(value) {
return String(value ?? "")
.replace(/&/g, "&amp;")
.replace(/</g, "&lt;")
.replace(/>/g, "&gt;")
.replace(/"/g, "&quot;")
.replace(/'/g, "&#39;");
}
+210 -86
View File
@@ -1,5 +1,13 @@
import * as THREE from "three";
import {
earthMessage,
getEarthLocale,
initEarthI18n,
localizeCountryName,
onEarthLocaleChange,
translateText,
} from "./i18n.js";
import {
CONFIG,
CRUISE_MODULES,
@@ -304,6 +312,12 @@ import {
setMotionDebugPanelVisible,
} from "./motion-debug-panel.js";
initEarthI18n();
window.addEventListener("earth:status", (event) => {
const message = event.detail?.message;
if (message) showStatusMessage(message, event.detail?.type || "info");
});
const EARTH_RADIUS_KM = 6371;
const EARTH_GRAVITATIONAL_PARAMETER_KM3_S2 = 398600.4418;
const SECONDS_PER_DAY = 86400;
@@ -343,6 +357,7 @@ let earthTexture = null;
let animationFrameId = null;
let initialized = false;
let destroyed = false;
let runtimeBrandConfig = null;
let isDataLoading = false;
let currentLoadToken = 0;
let cablesEnabled = true;
@@ -357,6 +372,21 @@ let calloutConnector = null;
let cruiseBGPAdapter = null;
let cruiseNewsAdapter = null;
let cruiseSequencer = null;
function getEarthBrandLanguage() {
return getEarthLocale() === "en-US" ? "en" : (HUD_CONFIG.brandLanguage || "zh");
}
function getLocalizedBrandConfig(config = null) {
if (config && typeof config === "object") {
return { ...config, variant: config.variant || getEarthBrandLanguage() };
}
return getEarthBrandLanguage();
}
function remountEarthBrand() {
mountBrand(document.getElementById("brand-root"), getLocalizedBrandConfig(runtimeBrandConfig));
}
let cruiseRandomQueueSignature = "";
let cruiseRandomQueueItems = [];
let earthUpdatesSocket = null;
@@ -419,6 +449,21 @@ const VESSEL_POINTER_RADIUS_PX = 22;
const INTERACTABLE_POINTER_RADIUS_PX = 24;
const MOTION_FOCUS_RADIUS_PX = 180;
const MOTION_FOCUS_REFRESH_MS = 350;
function isEnglishEarthLocale() {
return getEarthLocale() === "en-US";
}
function formatUnresolvedComputeTitle(count) {
return isEnglishEarthLocale()
? `${count} compute centers pending location`
: `${count} 个算力中心待定位`;
}
function formatUnresolvedComputeSuffix(count) {
if (count <= 0) return "";
return isEnglishEarthLocale() ? ` (${count} pending location)` : `(${count} 个待定位)`;
}
const MOTION_MARKER_ANCHOR_SIZE_PX = 24;
const MOTION_SATELLITE_ANCHOR_SIZE_PX = 18;
const MOTION_CABLE_ANCHOR_SIZE_PX = 14;
@@ -881,7 +926,9 @@ function getPrimaryClusterHit(...intersectionGroups) {
function getClusterBriefHtml(hit) {
const count = Number(hit?.clusterCount || hit?.clusterMarkers?.length || 0);
return `<strong>共 ${count} 个对象</strong><br><span>放大后可查看单个图标</span>`;
const title = isEnglishEarthLocale() ? `${count} objects` : `共 ${count} 个对象`;
const hint = isEnglishEarthLocale() ? "Zoom in to inspect individual markers" : "放大后可查看单个图标";
return `<strong>${title}</strong><br><span>${hint}</span>`;
}
function getPrimaryBGPHoverTarget(bgpAnomalyIntersects, bgpCollectorIntersects) {
@@ -1336,7 +1383,7 @@ async function applyMotionSharedCruiseFocus(direction = "next") {
const presented = await sequencer.presentSpecificItem(targetItem, { interrupt: true });
if (presented) {
showStatusMessage("动捕: 已切换巡航目标", "info");
showStatusMessage(earthMessage("status.motionCruiseTargetSwitched"), "info");
}
return Boolean(presented);
}
@@ -1465,7 +1512,10 @@ export async function applyMotionFocus(direction = "next") {
refreshMotionFocusCandidates({ force: true });
if (motionFocusCandidates.length === 0) {
const layer = getCurrentMotionFocusLayer();
showStatusMessage(layer ? `动捕: ${layer.label}当前视野没有可选目标` : "动捕: 当前没有可用图层", "info");
showStatusMessage(
earthMessage("status.motionNoTarget", { layer: layer?.label || "" }),
"info",
);
return false;
}
const delta = direction === "prev" ? -1 : 1;
@@ -1473,7 +1523,10 @@ export async function applyMotionFocus(direction = "next") {
const candidate = motionFocusCandidates[motionFocusIndex];
applyMotionFocusVisual(candidate);
await presentMotionCandidate(candidate);
showStatusMessage(`动捕: 已切换到${getMotionCandidateLabel(candidate)}`, "info");
showStatusMessage(
earthMessage("status.motionSwitchedTo", { label: getMotionCandidateLabel(candidate) }),
"info",
);
return true;
} finally {
releaseGate();
@@ -1486,7 +1539,7 @@ export async function applyMotionLayerSwitch(direction = "next") {
try {
const layers = getVisibleMotionLayerDefinitions();
if (layers.length === 0) {
showStatusMessage("动捕: 当前没有可切换的可见图层", "info");
showStatusMessage(earthMessage("status.motionNoVisibleLayer"), "info");
return false;
}
const currentIndex = layers.findIndex((layer) => layer.id === motionFocusLayerId);
@@ -1505,7 +1558,10 @@ export async function applyMotionLayerSwitch(direction = "next") {
if (candidate) {
await presentMotionCandidate(candidate);
}
showStatusMessage(`动捕: 已切换到${nextLayer.label}图层`, "info");
showStatusMessage(
earthMessage("status.motionSwitchedTo", { label: nextLayer.label, layer: true }),
"info",
);
return true;
} finally {
releaseGate();
@@ -1673,7 +1729,10 @@ function confirmMotionCandidate(candidate, { showMotionStatus = true } = {}) {
});
window.dispatchEvent(new CustomEvent("earth:open-details-tab"));
if (showMotionStatus) {
showStatusMessage(`动捕: 已确认${getMotionCandidateLabel(candidate)}`, "info");
showStatusMessage(
earthMessage("status.motionConfirmed", { label: getMotionCandidateLabel(candidate) }),
"info",
);
}
return true;
}
@@ -1693,7 +1752,7 @@ function showCableInfo(cable, coords) {
function getCableBriefHtml(cable) {
const name = cable.userData.name || "未知海缆";
const status = cable.userData.status || "";
return `<strong>${name}</strong>${status ? `<br>${status}` : ""}`;
return `<strong>${translateText(name)}</strong>${status ? `<br>${translateText(status)}` : ""}`;
}
function showSatelliteInfo(props, coords) {
@@ -1822,7 +1881,7 @@ function showVesselInfo(marker, coords) {
status: formatVesselStatus(marker.userData?.nav_status),
length: marker.userData?.length ?? "-",
received_at: marker.userData?.received_at
? new Date(marker.userData.received_at).toLocaleString("zh-CN", { hour12: false })
? new Date(marker.userData.received_at).toLocaleString(getEarthLocale(), { hour12: false })
: "-",
}, coords);
}
@@ -1846,31 +1905,31 @@ function getEarthInteractableBriefHtml(marker) {
const ud = marker?.userData || {};
const name = ud.label || ud.name || "交互点";
const kind = ud.kind || "数据点";
return `<strong>${name}</strong><br>${kind}`;
return `<strong>${translateText(name)}</strong><br>${translateText(kind)}`;
}
function getVesselBriefHtml(marker) {
const name = marker.userData?.name || `MMSI ${marker.userData?.mmsi}`;
const speed = marker.userData?.sog ?? "-";
const vesselType = marker.userData?.vessel_type_display || marker.userData?.vessel_type_name || "Vessel";
return `<strong>${name}</strong><br>${vesselType} · ${speed} kn`;
return `<strong>${translateText(name)}</strong><br>${translateText(vesselType)} · ${speed} kn`;
}
function getComputeCenterBriefHtml(marker) {
const name = marker.userData?.name || "算力中心";
const type = formatComputeCenterTypeLabel(marker.userData?.site_type);
const location = [marker.userData?.city, marker.userData?.country]
const location = [marker.userData?.city, localizeCountryName(marker.userData?.country)]
.filter(Boolean)
.join(", ");
const precision = marker.userData?.is_estimated ? " · 估算位置" : "";
return `<strong>${name}</strong><br>${type}${location ? ` · ${location}` : ""}${precision}`;
const precision = marker.userData?.is_estimated ? ` · ${translateText("估算位置")}` : "";
return `<strong>${translateText(name)}</strong><br>${translateText(type)}${location ? ` · ${location}` : ""}${precision}`;
}
function getCountryBoundaryBriefHtml(country) {
const name = country?.nameZh || country?.name || "未知国家";
const name = localizeCountryName(country) || translateText("未知国家");
const code = country?.isoA3 || country?.isoA2 || "-";
const continent = country?.continent || "-";
return `<strong>${name}</strong><br>ISO: ${code}<br>大洲: ${continent}`;
const continent = translateText(country?.continent || "-");
return `<strong>${name}</strong><br>ISO: ${code}<br>${translateText("大洲")}: ${continent}`;
}
function getSurfacePositionBriefHtml(coords) {
@@ -1880,7 +1939,7 @@ function getSurfacePositionBriefHtml(coords) {
? `${(elevMeters / 1000).toFixed(2)} km`
: `${Math.round(elevMeters)} m`
: "—";
return `纬度: ${coords.lat}°<br>经度: ${coords.lon}°<br>海拔: ${elevText}`;
return `${translateText("纬度")}: ${coords.lat}°<br>${translateText("经度")}: ${coords.lon}°<br>${translateText("海拔")}: ${elevText}`;
}
function showBGPInfo(marker, coords) {
@@ -1920,7 +1979,9 @@ function showBGPInfo(marker, coords) {
),
prefix:
Array.isArray(marker.userData.prefixes) && marker.userData.prefixes.length > 1
? `${marker.userData.prefixes[0]} 等${marker.userData.prefixes.length}个`
? isEnglishEarthLocale()
? `${marker.userData.prefixes[0]} + ${marker.userData.prefixes.length - 1}`
: `${marker.userData.prefixes[0]} 等${marker.userData.prefixes.length}个`
: marker.userData.prefix,
as_path_display:
Array.isArray(marker.userData.as_path) && marker.userData.as_path.length > 0
@@ -1932,7 +1993,9 @@ function showBGPInfo(marker, coords) {
: marker.userData.origin_asn,
new_origin_asn:
Array.isArray(marker.userData.affected_asns) && marker.userData.affected_asns.length > 3
? `共${marker.userData.affected_asns.length}个ASN`
? isEnglishEarthLocale()
? `${marker.userData.affected_asns.length} ASNs`
: `共${marker.userData.affected_asns.length}个ASN`
: marker.userData.new_origin_asn,
confidence: formatBGPConfidence(marker.userData.confidence),
collector: marker.userData.collector,
@@ -1941,7 +2004,9 @@ function showBGPInfo(marker, coords) {
related_cables: relatedCables,
related_satellites:
marker.userData.related_satellite_count > 0
? `${marker.userData.related_satellite_count}颗事件附近卫星`
? isEnglishEarthLocale()
? `${marker.userData.related_satellite_count} nearby event satellites`
: `${marker.userData.related_satellite_count}颗事件附近卫星`
: "-",
location:
marker.userData.location ||
@@ -1983,7 +2048,8 @@ function showBGPCollectorInfo(marker, coords) {
function getBGPCollectorBriefHtml(marker) {
const name = marker.userData.collector || "观测站";
const count = marker.userData.anomaly_count ?? 0;
return `<strong>${name}</strong><br>${count} 条事件`;
const eventText = isEnglishEarthLocale() ? `${count} events` : `${count} 条事件`;
return `<strong>${translateText(name)}</strong><br>${eventText}`;
}
function getSearchCardCoords() {
@@ -2157,7 +2223,10 @@ async function focusSearchLandingPoint(point) {
});
applyLandingPointVisualState(relatedCableNames, relatedCableNames.length === 0, camera);
showLandingPointInfo(point, getSearchCardCoords());
showStatusMessage(`已定位登陆点:${point.userData?.name || "未知登陆点"}`, "info");
showStatusMessage(
earthMessage("status.located", { target: "登陆点", name: point.userData?.name || "未知登陆点" }),
"info",
);
}
async function focusSearchSatellite(index) {
@@ -2191,7 +2260,13 @@ async function focusSearchSatellite(index) {
}
}
showSatelliteInfo(sat.properties, getSearchCardCoords());
showStatusMessage(`已定位卫星:${sat.properties.name || sat.properties.norad_cat_id || "未知卫星"}`, "info");
showStatusMessage(
earthMessage("status.located", {
target: "卫星",
name: sat.properties.name || sat.properties.norad_cat_id || "未知卫星",
}),
"info",
);
}
async function focusSearchBGPMarker(marker) {
@@ -2215,7 +2290,13 @@ async function focusSearchBGPMarker(marker) {
showBGPEventOverlay(marker, earth);
applyBGPEventSatelliteHighlights(marker);
showBGPInfo(marker, getSearchCardCoords());
showStatusMessage(`已定位 BGP 事件:${marker.userData?.collector || "未知观测站"}`, "info");
showStatusMessage(
earthMessage("status.located", {
target: "BGP 事件",
name: marker.userData?.collector || "未知观测站",
}),
"info",
);
return;
}
@@ -2225,7 +2306,13 @@ async function focusSearchBGPMarker(marker) {
lockedObjectType = "bgp_collector";
showBGPCollectorCoverageOverlay(marker, earth);
showBGPCollectorInfo(marker, getSearchCardCoords());
showStatusMessage(`已定位观测站:${marker.userData?.collector || "未知观测站"}`, "info");
showStatusMessage(
earthMessage("status.located", {
target: "观测站",
name: marker.userData?.collector || "未知观测站",
}),
"info",
);
}
}
@@ -2247,7 +2334,10 @@ async function focusSearchComputeCenter(marker) {
lockedObjectType = "compute_center";
showComputeCenterInfo(marker, getSearchCardCoords());
showStatusMessage(
`已定位算力中心:${marker.userData?.name || "未知节点"}`,
earthMessage("status.located", {
target: "算力中心",
name: marker.userData?.name || "未知节点",
}),
"info",
);
}
@@ -2310,7 +2400,7 @@ async function spawnComputeCenterAfterLocationSave(detail = {}) {
lockedObject = result.marker;
lockedObjectType = "compute_center";
}
showStatusMessage("算力中心坐标已保存", "success");
showStatusMessage(earthMessage("status.computeCoordinatesSaved"), "success");
return result;
}
@@ -2336,7 +2426,10 @@ async function focusSearchVessel(marker) {
console.warn("船只轨迹加载失败:", error);
});
showStatusMessage(
`已定位船只:${marker.userData?.name || marker.userData?.mmsi || "未知船只"}`,
earthMessage("status.located", {
target: "船只",
name: marker.userData?.name || marker.userData?.mmsi || "未知船只",
}),
"info",
);
}
@@ -2645,16 +2738,16 @@ async function loadEarthStatsSummary({
function updateComputeCenterHud(computeCenterResult) {
const computeBtn = document.getElementById("toggle-compute-centers");
const unresolvedCount = Number(computeCenterResult?.unresolvedCount) || 0;
const unresolvedTooltip =
unresolvedCount > 0 ? `(${unresolvedCount} 个待定位)` : "";
const unresolvedTooltip = formatUnresolvedComputeSuffix(unresolvedCount);
if (computeBtn) {
const tooltip = getShowComputeCenters()
? `隐藏算力中心${unresolvedTooltip}`
: `显示算力中心${unresolvedTooltip}`;
setLayerButtonState(computeBtn, {
active: getShowComputeCenters(),
loading: false,
tooltip: getShowComputeCenters()
? `隐藏算力中心${unresolvedTooltip}`
: `显示算力中心${unresolvedTooltip}`,
tooltip: translateText(tooltip),
});
updateComputeCenterUnresolvedBadge(computeBtn, unresolvedCount);
}
@@ -2690,8 +2783,12 @@ function updateComputeCenterUnresolvedBadge(computeBtn, unresolvedCount) {
computeBtn.dataset.unresolvedCount = String(count);
badge.textContent = count > 99 ? "99+" : String(count);
badge.title = `${count} 个算力中心待定位`;
badge.setAttribute("aria-label", `${count} 个算力中心待定位,点击查看`);
const title = formatUnresolvedComputeTitle(count);
badge.title = title;
badge.setAttribute(
"aria-label",
isEnglishEarthLocale() ? `${title}, click to view` : `${title},点击查看`,
);
}
function syncComputeCenterUnresolvedCount(unresolvedCount) {
@@ -2773,12 +2870,12 @@ function prepareToolInfoCard(type) {
if (hadCruisePresentation || restoreCruise) {
stopCruiseMode({ preserveCard: false });
showStatusMessage("已暂停巡航,正在打开候选列表", "info");
showStatusMessage(earthMessage("status.cruisePausedOpenCandidates"), "info");
} else if (hadMotionPresentation) {
presentationController?.dismiss?.("tool_card_open");
motionCruiseSequencer?.stop?.();
motionSharedCruiseSequencer?.stop?.();
showStatusMessage("已暂停动捕目标展示,正在打开候选列表", "info");
showStatusMessage(earthMessage("status.motionPausedOpenCandidates"), "info");
}
activeToolInfoCard = {
@@ -2809,7 +2906,7 @@ function resumeCruiseAfterToolInfoCard(context) {
return;
}
showStatusMessage("候选列表已关闭,巡航已恢复", "info");
showStatusMessage(earthMessage("status.candidatesClosedCruiseResumed"), "info");
ensureCruisePolling();
syncCruiseModuleKnownEventIds()
.catch((error) => {
@@ -3522,12 +3619,12 @@ function handleCruiseQueueSettingsChange() {
function handleCruiseNextCardShortcut() {
if (!isCruiseModeActive()) {
showStatusMessage("切换到巡航模式后可切换卡片", "info");
showStatusMessage(earthMessage("status.cruiseModeRequired"), "info");
return;
}
if (!getAutoRotate()) {
showStatusMessage("巡航已暂停,按空格恢复", "info");
showStatusMessage(earthMessage("status.cruisePausedSpace"), "info");
return;
}
@@ -3770,12 +3867,7 @@ function getSatellitePointerIntersections(event) {
function buildLoadErrorMessage(errors) {
if (errors.length === 0) return "";
return errors
.map(
({ label, reason }) =>
`${label}加载失败: ${reason?.message || String(reason)}`,
)
.join(";");
return earthMessage("status.loadFailedList", { items: errors });
}
function updateSatelliteToggleUi(enabled, satelliteCount = getSatelliteCount()) {
@@ -4128,15 +4220,30 @@ export function init() {
destroyed = false;
initialized = true;
updateHudScale();
const brandRoot = document.getElementById("brand-root");
mountBrand(brandRoot, HUD_CONFIG.brandLanguage);
remountEarthBrand();
fetchEarthBrandConfig()
.then((brandConfig) => {
mountBrand(brandRoot, brandConfig);
runtimeBrandConfig = brandConfig;
remountEarthBrand();
})
.catch((error) => {
console.warn("Earth brand config unavailable, using defaults.", error);
});
cleanupFns.push(onEarthLocaleChange(() => {
remountEarthBrand();
updateCableToggleUi(getShowCables());
updateSatelliteToggleUi(getShowSatellites());
updateComputeCenterHud({
totalCount: getComputeCenterCount(),
unresolvedCount: getUnresolvedComputeCenters().length,
});
updateVesselToggleUi(getShowVessels());
updateBGPHud({
totalCount: getBGPCount(),
collectorCount: getBGPCollectorCount(),
});
updateStatsSummary();
}));
initTVPanel();
initEarthAbout();
initEarthOobe();
@@ -4280,7 +4387,7 @@ export function applyMotionRotate(axisOrDirection, directionOrIntensity = 1, may
up: "向上旋转",
down: "向下旋转",
}[direction] || "旋转";
showStatusMessage(`动捕: ${label}`, "info");
showStatusMessage(earthMessage("status.motionPrefix", { text: label }), "info");
return true;
}
@@ -4309,10 +4416,10 @@ export function applyMotionConfirm() {
}
if (lockedObject || lockedSatellite) {
window.dispatchEvent(new CustomEvent("earth:open-details-tab"));
showStatusMessage("动捕: 已确认当前目标", "info");
showStatusMessage(earthMessage("status.motionConfirmCurrent"), "info");
return true;
}
showStatusMessage("动捕: 请先选择目标", "info");
showStatusMessage(earthMessage("status.motionSelectTargetFirst"), "info");
return false;
} finally {
releaseGate();
@@ -4783,7 +4890,7 @@ async function loadData() {
clearSatelliteData();
clearCountryBoundaryHover();
setLoadingMessage("正在初始化...");
setLoadingMessage(earthMessage("loading.initializing"));
setLoading(true);
await yieldFrame(18);
if (loadToken !== currentLoadToken) { isDataLoading = false; return; }
@@ -4860,7 +4967,7 @@ async function loadData() {
const terrainMessage = resolveStartupMessage(
terrainLayer,
"load",
"正在渲染地形...",
earthMessage("startup.terrain"),
);
setLoadingMessage(terrainMessage);
await yieldFrame(24);
@@ -4891,7 +4998,7 @@ async function loadData() {
queueStatusMessage(errorMessage, "error");
} else {
hideError();
queueStatusMessage("数据已加载", "success");
queueStatusMessage(earthMessage("status.dataLoaded"), "success");
}
applyDeferredLayerVisibilitySettings()
@@ -4935,13 +5042,13 @@ export async function setCablesEnabled(
clearSelectionAndInfo();
disableCables();
if (!suppressStatus) {
showStatusMessage("线缆已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "线缆", visible: false }), "info");
}
return 0;
}
if (!suppressLoadingUi) {
setLoadingMessage("正在加载线缆数据...");
setLoadingMessage(earthMessage("loading.cableData"));
setLoading(true);
hideError();
}
@@ -4949,19 +5056,20 @@ export async function setCablesEnabled(
try {
const cableCount = await ensureCablesEnabled();
if (!suppressStatus) {
showStatusMessage("线缆已显示", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "线缆", visible: true }), "info");
}
return cableCount;
} catch (error) {
cablesEnabled = false;
clearCableData(getEarth());
updateCableToggleUi(false);
const message = `线缆加载失败: ${error?.message || String(error)}`;
const reason = error?.message || String(error);
const message = earthMessage("status.layerLoadFailed", { layer: "线缆", error: reason });
void reportEarthClientLog({
level: "error",
category: "layer-toggle",
module: "cables",
message,
message: `线缆加载失败: ${reason}`,
detail: error,
});
if (!suppressLoadingUi) {
@@ -4986,7 +5094,7 @@ export async function setCountryBoundariesEnabled(
toggleCountryBoundaries(false);
clearCountryBoundaryHover();
if (!suppressStatus) {
showStatusMessage("国界已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "国界", visible: false }), "info");
}
return 0;
}
@@ -5002,18 +5110,19 @@ export async function setCountryBoundariesEnabled(
setLegendItems("countryBoundaries", getCountryBoundaryLegendItems());
refreshLegend();
if (!suppressStatus) {
showStatusMessage("国界已显示", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "国界", visible: true }), "info");
}
return countryCount;
} catch (error) {
toggleCountryBoundaries(false);
clearCountryBoundaryHover();
const message = `国界加载失败: ${error?.message || String(error)}`;
const reason = error?.message || String(error);
const message = earthMessage("status.layerLoadFailed", { layer: "国界", error: reason });
void reportEarthClientLog({
level: "error",
category: "layer-toggle",
module: "country-boundaries",
message,
message: `国界加载失败: ${reason}`,
detail: error,
});
if (!suppressStatus) {
@@ -5082,7 +5191,7 @@ export async function setHighResTextureEnabled(enabled, { suppressStatus = false
}
}
if (!suppressStatus) {
showStatusMessage(enabled ? "高清材质已启用" : "高清材质已隐藏", "info");
showStatusMessage(earthMessage("status.layerEnabled", { layer: "高清材质", enabled }), "info");
}
return enabled;
}
@@ -5103,7 +5212,7 @@ export async function setAtmosphereCloudsEnabled(enabled, { suppressStatus = fal
}
}
if (!suppressStatus) {
showStatusMessage(enabled ? "大气云图已显示" : "大气云图已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "大气云图", visible: enabled }), "info");
}
return enabled;
}
@@ -5128,7 +5237,7 @@ export async function setSatellitesEnabled(
}
if (!suppressLoadingUi) {
setLoadingMessage("正在加载卫星数据...");
setLoadingMessage(earthMessage("loading.satelliteData"));
setLoading(true);
hideError();
}
@@ -5136,19 +5245,20 @@ export async function setSatellitesEnabled(
try {
const satelliteCount = await ensureSatellitesEnabled();
if (!suppressStatus) {
showStatusMessage("卫星已显示", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "卫星", visible: true }), "info");
}
return satelliteCount;
} catch (error) {
satellitesEnabled = false;
resetSatelliteState();
updateSatelliteToggleUi(false, 0);
const message = `卫星加载失败: ${error?.message || String(error)}`;
const reason = error?.message || String(error);
const message = earthMessage("status.layerLoadFailed", { layer: "卫星", error: reason });
void reportEarthClientLog({
level: "error",
category: "layer-toggle",
module: "satellites",
message,
message: `卫星加载失败: ${reason}`,
detail: error,
});
if (!suppressLoadingUi) {
@@ -5178,13 +5288,13 @@ export async function setVesselsEnabled(
clearSelectionAndInfo();
disableVessels();
if (!suppressStatus) {
showStatusMessage("船只已隐藏", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "船只", visible: false }), "info");
}
return 0;
}
if (!suppressLoadingUi) {
setLoadingMessage("正在加载船只数据...");
setLoadingMessage(earthMessage("loading.vesselData"));
setLoading(true);
hideError();
}
@@ -5192,19 +5302,20 @@ export async function setVesselsEnabled(
try {
const vesselCount = await ensureVesselsEnabled();
if (!suppressStatus) {
showStatusMessage("船只已显示", "info");
showStatusMessage(earthMessage("status.layerVisibility", { layer: "船只", visible: true }), "info");
}
return vesselCount;
} catch (error) {
vesselsEnabled = false;
clearVesselData(getEarth());
updateVesselToggleUi(false, 0);
const message = `船只加载失败: ${error?.message || String(error)}`;
const reason = error?.message || String(error);
const message = earthMessage("status.layerLoadFailed", { layer: "船只", error: reason });
void reportEarthClientLog({
level: "error",
category: "layer-toggle",
module: "vessels",
message,
message: `船只加载失败: ${reason}`,
detail: error,
});
if (!suppressLoadingUi) {
@@ -5258,13 +5369,13 @@ function setupEventListeners() {
// for the user-visible confirmation.
return refreshComputeCentersAfterLocationSave()
.then(() => {
showStatusMessage("算力中心坐标已保存", "success");
showStatusMessage(earthMessage("status.computeCoordinatesSaved"), "success");
})
.catch((error) => {
// Swallow refresh failure: the save itself succeeded, so we
// must not surface this as a save failure.
console.warn("后台校准算力中心图层失败:", error);
showStatusMessage("坐标已保存,地图稍后同步", "info");
showStatusMessage(earthMessage("status.coordinatesSavedLater"), "info");
});
}
// Optimistic marker is on screen; reconcile in the background.
@@ -5275,10 +5386,10 @@ function setupEventListeners() {
})
.catch((error) => {
console.warn("即时生成算力中心交互物件失败,改用后台刷新:", error);
showStatusMessage("坐标已保存,正在同步地图...", "info");
showStatusMessage(earthMessage("status.coordinatesSavedSyncing"), "info");
refreshComputeCentersAfterLocationSave()
.then(() => {
showStatusMessage("算力中心坐标已保存", "success");
showStatusMessage(earthMessage("status.computeCoordinatesSaved"), "success");
})
.catch((refreshError) => {
console.warn("后台校准算力中心图层失败:", refreshError);
@@ -5945,7 +6056,11 @@ function onClick(event) {
const incidentSummary = getBGPInfrastructureSummary(clickedMarker);
showBGPInfo(clickedMarker, { x: event.clientX, y: event.clientY });
showStatusMessage(
`已选择BGP事件: ${clickedMarker.userData.collector} · ${incidentSummary.regionCount}个区域 / ${incidentSummary.cableCount}条相关海缆`,
earthMessage("status.bgpSelected", {
collector: clickedMarker.userData.collector,
regionCount: incidentSummary.regionCount,
cableCount: incidentSummary.cableCount,
}),
"info",
);
return;
@@ -5969,7 +6084,7 @@ function onClick(event) {
clickedMarker.userData.related_satellite_count = 0;
showBGPCollectorInfo(clickedMarker, { x: event.clientX, y: event.clientY });
showStatusMessage(
`已选择观测站: ${clickedMarker.userData.collector}`,
earthMessage("status.selected", { target: "观测站", name: clickedMarker.userData.collector }),
"info",
);
return;
@@ -5986,7 +6101,10 @@ function onClick(event) {
setAutoRotate(false);
showComputeCenterInfo(clickedMarker, { x: event.clientX, y: event.clientY });
showStatusMessage(
`已选择算力中心: ${clickedMarker.userData?.name || "未知节点"}`,
earthMessage("status.selected", {
target: "算力中心",
name: clickedMarker.userData?.name || "未知节点",
}),
"info",
);
return;
@@ -6006,7 +6124,10 @@ function onClick(event) {
console.warn("船只轨迹加载失败:", error);
});
showStatusMessage(
`已选择船只: ${clickedMarker.userData?.name || clickedMarker.userData?.mmsi}`,
earthMessage("status.selected", {
target: "船只",
name: clickedMarker.userData?.name || clickedMarker.userData?.mmsi,
}),
"info",
);
return;
@@ -6021,7 +6142,10 @@ function onClick(event) {
distancePxSq: 0,
}, { showMotionStatus: false })) {
showStatusMessage(
`已选择交互点: ${clickedMarker.userData?.label || clickedMarker.userData?.name || clickedMarker.userData?.id || "未知目标"}`,
earthMessage("status.selected", {
target: "交互点",
name: clickedMarker.userData?.label || clickedMarker.userData?.name || clickedMarker.userData?.id || "未知目标",
}),
"info",
);
}
@@ -6079,7 +6203,7 @@ function onClick(event) {
screen: { x: event.clientX, y: event.clientY },
distancePxSq: 0,
}, { showMotionStatus: false });
showStatusMessage("已选择: " + sat.properties.name, "info");
showStatusMessage(earthMessage("status.selected", { name: sat.properties.name }), "info");
return;
}
@@ -3,6 +3,7 @@ import * as THREE from "three";
import { CONFIG, CONNECTOR_CONFIG, CRUISE_CONFIG } from "./constants.js";
import { showInfoCard, hideInfoCard } from "./info-card.js";
import { latLonToVector3 } from "./utils.js";
import { formatLocaleDateTime, getEarthLocale, hasCjkText } from "./i18n.js";
import {
createConnectorPath,
resolveConnectorAnchor,
@@ -20,8 +21,9 @@ import {
getNewsFetchChannelLabel,
getNewsFeedLabel,
getNewsLocationSourceLabel,
getNewsRegionLabel,
getNewsRegionDisplayLabel,
getNewsSourceTypeLabel,
getNewsSourceNameLabel,
} from "./news-locale.js";
const CRUISE_PRESENTATION_HIDE_MS = 220;
@@ -38,10 +40,10 @@ function getItemTimestamp(item) {
}
function formatPublishedAt(rawValue) {
if (!rawValue) return "刚刚同步";
if (!rawValue) return getEarthLocale() === "en-US" ? "Just synced" : "刚刚同步";
const parsed = new Date(rawValue);
if (Number.isNaN(parsed.getTime())) return "刚刚同步";
return parsed.toLocaleString("zh-CN", {
if (Number.isNaN(parsed.getTime())) return getEarthLocale() === "en-US" ? "Just synced" : "刚刚同步";
return formatLocaleDateTime(parsed, {
hour12: false,
month: "2-digit",
day: "2-digit",
@@ -94,6 +96,10 @@ function mapNewsItemToCruiseEvent(item) {
const rawFeedName = item.feed_name || "";
const sourceType = item.source_type || (String(rawFeedName).startsWith("Global Monitor /") ? "aggregated" : "rss");
const regionLabel = getNewsRegionDisplayLabel(item.region, item.display_region);
const locationLabel = getEarthLocale() === "en-US" && hasCjkText(item.location_label)
? regionLabel
: item.location_label || regionLabel;
return {
id: `news:${item.id}`,
@@ -101,21 +107,21 @@ function mapNewsItemToCruiseEvent(item) {
type: "news",
title: getNewsDisplayTitle(item),
summary: getNewsDisplaySummary(item),
source: item.source || "",
source: getNewsSourceNameLabel({ id: item.source_id, name: item.source || "" }),
feedName: getNewsFeedLabel(rawFeedName),
rawFeedName,
feedSourceTypeLabel: getNewsSourceTypeLabel(sourceType),
fetchChannelLabel: getNewsFetchChannelLabel(rawFeedName, sourceType),
categoryLabel: getNewsCategoryLabel(item.category),
region: item.region || "global",
regionLabel: item.display_region || getNewsRegionLabel(item.region),
regionLabel,
url: item.url || "",
publishedAt: item.published_at || null,
publishedAtDisplay: formatPublishedAt(item.published_at),
latitude,
longitude,
locationLabel: item.location_label || item.display_region || getNewsRegionLabel(item.region),
sourceLocationLabel: item.location_label || item.display_region || getNewsRegionLabel(item.region),
locationLabel,
sourceLocationLabel: locationLabel,
targetLocationConfidence: item.location_meta?.target?.confidence ?? null,
targetLocationSource: item.location_source || "",
targetLocationSourceLabel: getNewsLocationSourceLabel(item.location_source),
+336 -102
View File
@@ -1,182 +1,414 @@
const DEFAULT_LOCALE = "zh-CN";
import { getEarthLocale, hasCjkText, normalizeLocale } from "./i18n.js";
const REGION_LABELS = {
americas: "美洲",
europe: "欧洲",
"middle-east-africa": "中东与非洲",
"asia-pacific": "亚太",
global: "全球",
"zh-CN": {
americas: "美洲",
europe: "欧洲",
"middle-east-africa": "中东与非洲",
"asia-pacific": "亚太",
global: "全球",
},
"en-US": {
americas: "Americas",
europe: "Europe",
"middle-east-africa": "Middle East & Africa",
"asia-pacific": "Asia Pacific",
global: "Global",
},
};
const FEED_LABELS = {
"Global Monitor / World": "区域监测",
"Global Monitor / Americas": "区域监测",
"Global Monitor / Europe": "区域监测",
"Global Monitor / MEA": "区域监测",
"Global Monitor / APAC": "区域监测",
"zh-CN": {
"Global Monitor / World": "区域监测",
"Global Monitor / Americas": "区域监测",
"Global Monitor / Europe": "区域监测",
"Global Monitor / MEA": "区域监测",
"Global Monitor / APAC": "区域监测",
},
"en-US": {
"Global Monitor / World": "Regional Monitor",
"Global Monitor / Americas": "Regional Monitor",
"Global Monitor / Europe": "Regional Monitor",
"Global Monitor / MEA": "Regional Monitor",
"Global Monitor / APAC": "Regional Monitor",
},
};
const CATEGORY_LABELS = {
politics: "政治",
business: "商业",
ecommerce: "电商",
finance: "金融",
sports: "体育",
technology: "科技",
military: "军事",
disaster: "灾害",
energy: "能源",
society: "社会",
culture: "文化",
other: "其他",
"zh-CN": {
politics: "政治",
business: "商业",
ecommerce: "电商",
finance: "金融",
sports: "体育",
technology: "科技",
military: "军事",
disaster: "灾害",
energy: "能源",
society: "社会",
culture: "文化",
other: "其他",
},
"en-US": {
politics: "Politics",
business: "Business",
ecommerce: "E-commerce",
finance: "Finance",
sports: "Sports",
technology: "Technology",
military: "Military",
disaster: "Disaster",
energy: "Energy",
society: "Society",
culture: "Culture",
other: "Other",
},
};
const BREAKING_LEVEL_LABELS = {
watch: "关注",
breaking: "突发",
critical: "严重突发",
"zh-CN": {
watch: "关注",
breaking: "突发",
critical: "严重突发",
},
"en-US": {
watch: "Watch",
breaking: "Breaking",
critical: "Critical",
},
};
const BREAKING_SCOPE_LABELS = {
regional: "区域",
global: "全球",
"zh-CN": {
regional: "区域",
global: "全球",
},
"en-US": {
regional: "Regional",
global: "Global",
},
};
const SOURCE_TYPE_LABELS = {
rss: "RSS",
atom: "Atom",
aggregated: "Aggregated",
manual: "手动添加",
reference: "Reference",
"zh-CN": {
rss: "RSS",
atom: "Atom",
aggregated: "Aggregated",
manual: "手动添加",
reference: "Reference",
},
"en-US": {
rss: "RSS",
atom: "Atom",
aggregated: "Aggregated",
manual: "Manual",
reference: "Reference",
},
};
const LOCATION_SOURCE_LABELS = {
region_anchor: "区域锚点",
ai_inferred_target: "AI 推断位置",
headline_location_hint: "标题位置线索",
headline_country_hint: "标题国家线索",
"zh-CN": {
region_anchor: "区域锚点",
ai_inferred_target: "AI 推断位置",
headline_location_hint: "标题位置线索",
headline_country_hint: "标题国家线索",
},
"en-US": {
region_anchor: "Region Anchor",
ai_inferred_target: "AI-inferred Location",
headline_location_hint: "Headline Location Hint",
headline_country_hint: "Headline Country Hint",
},
};
const ENRICHMENT_STATUS_LABELS = {
pending: "待增强",
queued: "增强排队中",
attempted: "增强中",
success: "已汉化",
content_only: "已汉化",
location_only: "位置已增强",
unavailable: "AI 未配置",
provider_error: "增强失败",
parse_error: "增强解析失败",
no_result: "暂无增强结果",
"zh-CN": {
pending: "待增强",
queued: "增强排队中",
attempted: "增强中",
success: "已汉化",
content_only: "已汉化",
location_only: "位置已增强",
unavailable: "AI 未配置",
provider_error: "增强失败",
parse_error: "增强解析失败",
no_result: "暂无增强结果",
},
"en-US": {
pending: "Pending",
queued: "Queued",
attempted: "Enhancing",
success: "Localized",
content_only: "Localized",
location_only: "Location Enhanced",
unavailable: "AI Unconfigured",
provider_error: "Enhancement Failed",
parse_error: "Parse Failed",
no_result: "No Enhancement",
},
};
const SOURCE_NAME_LABELS = {
"en-US": {
"36氪": "36Kr",
"亿邦动力": "Ebrun",
"商务数据中心": "MOFCOM Data Center",
"商务部电商动态": "MOFCOM E-Commerce",
"国家统计局数据发布": "National Bureau of Statistics",
"电商物流指数": "China E-Commerce Logistics Index",
},
};
const SOURCE_ID_LABELS = {
"en-US": {
"36kr": "36Kr",
ebrun: "Ebrun",
"mofcom-data": "MOFCOM Data Center",
"mofcom-ecommerce": "MOFCOM E-Commerce",
"stats-china-online-retail": "National Bureau of Statistics",
"china-ecommerce-logistics-index": "China E-Commerce Logistics Index",
},
};
const FEED_NAME_LABELS = {
"en-US": {
"综合资讯": "General",
"文章资讯": "Articles",
"最新快讯": "Newsflash",
"动态内容": "Updates",
"零售": "Retail",
"服务": "Services",
"数据": "Data",
"政策": "Policy",
"数据发布": "Data Releases",
},
};
const TITLE_PLACEHOLDERS = {
queued: "新闻汉化排队中",
attempted: "新闻汉化中",
provider_error: "新闻汉化失败,正在重试",
parse_error: "新闻解析失败,正在重试",
unavailable: "等待 AI 配置",
no_result: "新闻汉化待重试",
location_only: "新闻汉化待重试",
"zh-CN": {
queued: "新闻汉化排队中",
attempted: "新闻汉化中",
provider_error: "新闻汉化失败,正在重试",
parse_error: "新闻解析失败,正在重试",
unavailable: "等待 AI 配置",
no_result: "新闻汉化待重试",
location_only: "新闻汉化待重试",
},
"en-US": {
queued: "English translation queued",
attempted: "English translation in progress",
provider_error: "English translation retrying",
parse_error: "English translation retrying",
unavailable: "Waiting for AI configuration",
no_result: "English translation pending",
location_only: "English translation pending",
},
};
const SUMMARY_PLACEHOLDERS = {
queued: "中文概要正在生成,请稍后刷新。",
attempted: "中文概要正在生成,请稍后刷新。",
provider_error: "中文概要生成失败,系统会重新提交增强任务。",
parse_error: "中文概要解析失败,系统会重新提交增强任务。",
unavailable: "AI 服务配置完成后将生成中文概要。",
no_result: "中文概要暂未生成,系统会继续重试。",
location_only: "已完成位置增强,中文概要将继续重试。",
"zh-CN": {
queued: "中文概要正在生成,请稍后刷新。",
attempted: "中文概要正在生成,请稍后刷新。",
provider_error: "中文概要生成失败,系统会重新提交增强任务。",
parse_error: "中文概要解析失败,系统会重新提交增强任务。",
unavailable: "AI 服务配置完成后将生成中文概要。",
no_result: "中文概要暂未生成,系统会继续重试。",
location_only: "已完成位置增强,中文概要将继续重试。",
},
"en-US": {
queued: "English summary is being generated. Refresh shortly.",
attempted: "English summary is being generated. Refresh shortly.",
provider_error: "English summary generation failed and will be retried.",
parse_error: "English summary parsing failed and will be retried.",
unavailable: "English summary will be generated after AI is configured.",
no_result: "English summary is pending and will be retried.",
location_only: "Location is ready; English summary is still pending.",
},
};
function normalizeText(value) {
return String(value ?? "").replace(/\s+/g, " ").trim();
}
function getLocalization(item, locale = DEFAULT_LOCALE) {
function getLocale(locale = getEarthLocale()) {
return normalizeLocale(locale);
}
function getLabels(table, locale = getEarthLocale()) {
const normalizedLocale = getLocale(locale);
return table[normalizedLocale] || table["zh-CN"] || {};
}
function isEnglishLocale(locale = getEarthLocale()) {
return getLocale(locale) === "en-US";
}
function isEnglishContent(item) {
const language = String(item?.content_language || "").toLowerCase();
return language === "en" || language.startsWith("en-") || language.startsWith("en_");
}
function getPlaceholder(table, status, locale = getEarthLocale(), fallbackKey = "no_result") {
const labels = getLabels(table, locale);
return labels[status] || labels[fallbackKey] || "";
}
function safeEnglishText(value) {
const text = normalizeText(value);
return text && !hasCjkText(text) ? text : "";
}
function sourceIdFallback(id) {
const value = normalizeText(id);
if (!value) return "";
return value
.replace(/[-_]+/g, " ")
.replace(/\b\w/g, (letter) => letter.toUpperCase());
}
function getLocalization(item, locale = getEarthLocale()) {
const localizations = item?.localizations;
const localized = localizations && typeof localizations === "object"
? localizations[locale]
? localizations[getLocale(locale)]
: null;
return localized && typeof localized === "object" ? localized : {};
}
export function getNewsDisplayTitle(item, locale = DEFAULT_LOCALE) {
export function getNewsDisplayTitle(item, locale = getEarthLocale()) {
const normalizedLocale = getLocale(locale);
const localized = getLocalization(item, locale).title;
if (localized || item?.display_title) {
if (normalizedLocale === "zh-CN" && (item?.display_title || localized)) {
return normalizeText(item?.display_title || localized);
}
if (normalizedLocale === "en-US") {
return safeEnglishText(localized)
|| safeEnglishText(item?.display_title)
|| (isEnglishContent(item) ? safeEnglishText(item?.title) : "")
|| getPlaceholder(TITLE_PLACEHOLDERS, item?.enrichment_status, locale);
}
if (localized) {
return normalizeText(localized);
}
if (item?.title) {
return normalizeText(item.title);
}
return normalizeText(
TITLE_PLACEHOLDERS[item?.enrichment_status]
|| "新闻汉化中",
);
return normalizeText(getPlaceholder(TITLE_PLACEHOLDERS, item?.enrichment_status, locale, "attempted"));
}
export function getNewsDisplaySummary(item, locale = DEFAULT_LOCALE) {
export function getNewsDisplaySummary(item, locale = getEarthLocale()) {
const normalizedLocale = getLocale(locale);
const localized = getLocalization(item, locale).summary;
if (localized || item?.display_summary) {
if (normalizedLocale === "zh-CN" && (item?.display_summary || localized)) {
return normalizeText(item?.display_summary || localized);
}
if (normalizedLocale === "en-US") {
return safeEnglishText(localized)
|| safeEnglishText(item?.display_summary)
|| (isEnglishContent(item) ? safeEnglishText(item?.summary) : "")
|| getPlaceholder(SUMMARY_PLACEHOLDERS, item?.enrichment_status, locale);
}
if (localized) {
return normalizeText(localized);
}
if (item?.summary) {
return normalizeText(item.summary);
}
return normalizeText(
SUMMARY_PLACEHOLDERS[item?.enrichment_status]
|| "中文概要生成中,请稍后刷新。",
);
return normalizeText(getPlaceholder(SUMMARY_PLACEHOLDERS, item?.enrichment_status, locale, "attempted"));
}
export function isNewsContentReady(item, locale = DEFAULT_LOCALE) {
export function isNewsContentReady(item, locale = getEarthLocale()) {
const localized = getLocalization(item, locale);
const title = normalizeText(item?.display_title || localized.title || item?.title);
const summary = normalizeText(item?.display_summary || localized.summary || item?.summary);
const normalizedLocale = getLocale(locale);
if (normalizedLocale === "en-US") {
const title = safeEnglishText(localized.title)
|| safeEnglishText(item?.display_title)
|| (isEnglishContent(item) ? safeEnglishText(item?.title) : "");
const summary = safeEnglishText(localized.summary)
|| safeEnglishText(item?.display_summary)
|| (isEnglishContent(item) ? safeEnglishText(item?.summary) : "");
return Boolean(title && summary);
}
const title = normalizeText(
item?.display_title || localized.title || item?.title,
);
const summary = normalizeText(
item?.display_summary || localized.summary || item?.summary,
);
return Boolean(title && summary);
}
export function getNewsRegionLabel(region, fallback = "") {
return REGION_LABELS[region] || fallback || region || REGION_LABELS.global;
export function getNewsRegionLabel(region, fallback = "", locale = getEarthLocale()) {
const labels = getLabels(REGION_LABELS, locale);
return labels[region] || fallback || region || labels.global;
}
export function getNewsFeedLabel(feedName) {
return FEED_LABELS[feedName] || feedName || "聚合源";
export function getNewsFeedLabel(feedName, locale = getEarthLocale()) {
const normalizedLocale = getLocale(locale);
const mappedFeed = getLabels(FEED_NAME_LABELS, locale)[feedName];
if (mappedFeed) return mappedFeed;
if (normalizedLocale === "en-US" && hasCjkText(feedName)) return "News Feed";
return getLabels(FEED_LABELS, locale)[feedName]
|| feedName
|| (normalizedLocale === "en-US" ? "Aggregated Source" : "聚合源");
}
export function getNewsCategoryLabel(category) {
return CATEGORY_LABELS[category] || category || CATEGORY_LABELS.other;
export function getNewsCategoryLabel(category, locale = getEarthLocale()) {
const labels = getLabels(CATEGORY_LABELS, locale);
return labels[category] || category || labels.other;
}
export function getNewsBreakingLabel(level, scope = "regional") {
export function getNewsBreakingLabel(level, scope = "regional", locale = getEarthLocale()) {
const normalizedLevel = normalizeText(level).toLowerCase();
if (!normalizedLevel || normalizedLevel === "none") return "";
const levelLabel = BREAKING_LEVEL_LABELS[normalizedLevel] || level;
const scopeLabel = BREAKING_SCOPE_LABELS[normalizeText(scope).toLowerCase()] || BREAKING_SCOPE_LABELS.regional;
return `${scopeLabel}${levelLabel}`;
const levelLabels = getLabels(BREAKING_LEVEL_LABELS, locale);
const scopeLabels = getLabels(BREAKING_SCOPE_LABELS, locale);
const levelLabel = levelLabels[normalizedLevel] || level;
const scopeLabel = scopeLabels[normalizeText(scope).toLowerCase()] || scopeLabels.regional;
return getLocale(locale) === "en-US" ? `${scopeLabel} ${levelLabel}` : `${scopeLabel}${levelLabel}`;
}
export function getNewsSourceTypeLabel(sourceType) {
export function getNewsSourceTypeLabel(sourceType, locale = getEarthLocale()) {
const normalized = normalizeText(sourceType).toLowerCase();
return SOURCE_TYPE_LABELS[normalized] || sourceType || "RSS";
return getLabels(SOURCE_TYPE_LABELS, locale)[normalized] || sourceType || "RSS";
}
export function getNewsSourceNameLabel(sourceOrName, locale = getEarthLocale()) {
const normalizedLocale = getLocale(locale);
const source = sourceOrName && typeof sourceOrName === "object" ? sourceOrName : null;
const name = normalizeText(source ? source.name : sourceOrName);
if (normalizedLocale !== "en-US") return name;
const id = normalizeText(source?.id || source?.source_id);
return getLabels(SOURCE_ID_LABELS, locale)[id]
|| getLabels(SOURCE_NAME_LABELS, locale)[name]
|| safeEnglishText(name)
|| sourceIdFallback(id)
|| "News Source";
}
export function getNewsRegionDisplayLabel(region, fallback = "", locale = getEarthLocale()) {
return getNewsRegionLabel(region, isEnglishLocale(locale) ? "" : fallback, locale);
}
export function isRegionalMonitorFeed(feedName) {
return Object.prototype.hasOwnProperty.call(FEED_LABELS, feedName);
return Object.values(FEED_LABELS).some((labels) =>
Object.prototype.hasOwnProperty.call(labels, feedName),
);
}
export function getNewsFetchChannelLabel(feedName, sourceType = "") {
const normalized = normalizeText(sourceType).toLowerCase();
if (isRegionalMonitorFeed(feedName) || normalized === "aggregated") return "区域监测";
if (normalized === "manual") return "手动添加";
if (normalized === "atom") return "单源 Atom";
if (normalized === "reference") return "配置保留";
return "单源 RSS";
const english = getEarthLocale() === "en-US";
if (isRegionalMonitorFeed(feedName) || normalized === "aggregated") return english ? "Regional Monitor" : "区域监测";
if (normalized === "manual") return english ? "Manual" : "手动添加";
if (normalized === "atom") return english ? "Single-source Atom" : "单源 Atom";
if (normalized === "reference") return english ? "Reserved" : "配置保留";
return english ? "Single-source RSS" : "单源 RSS";
}
export function getNewsLocationSourceLabel(source) {
return LOCATION_SOURCE_LABELS[source] || source || "位置来源";
export function getNewsLocationSourceLabel(source, locale = getEarthLocale()) {
return getLabels(LOCATION_SOURCE_LABELS, locale)[source]
|| source
|| (getLocale(locale) === "en-US" ? "Location Source" : "位置来源");
}
export function getNewsEnrichmentStatusLabel(statusOrItem) {
@@ -184,9 +416,11 @@ export function getNewsEnrichmentStatusLabel(statusOrItem) {
const status = item ? item.enrichment_status : statusOrItem;
const language = String(item?.content_language || "").toLowerCase();
if (language.startsWith("zh") && status !== "success" && status !== "content_only") {
if (status === "queued" || status === "attempted") return "英文补译中";
if (status === "provider_error" || status === "parse_error" || status === "no_result") return "中文原文";
return "中文原文";
if (status === "queued" || status === "attempted") return getEarthLocale() === "en-US" ? "English Translation Pending" : "英文补译中";
if (status === "provider_error" || status === "parse_error" || status === "no_result") return getEarthLocale() === "en-US" ? "Chinese Original" : "中文原文";
return getEarthLocale() === "en-US" ? "Chinese Original" : "中文原文";
}
return ENRICHMENT_STATUS_LABELS[status] || status || "增强状态";
return getLabels(ENRICHMENT_STATUS_LABELS)[status]
|| status
|| (getEarthLocale() === "en-US" ? "Enhancement Status" : "增强状态");
}
+128 -55
View File
@@ -1,4 +1,11 @@
import { showStatusMessage } from "./ui.js";
import {
applyEarthI18n,
earthMessage,
getEarthLocale,
onEarthLocaleChange,
translateText,
} from "./i18n.js";
import {
getNewsDisplaySummary,
getNewsDisplayTitle,
@@ -6,8 +13,11 @@ import {
getNewsBreakingLabel,
getNewsEnrichmentStatusLabel,
getNewsFetchChannelLabel,
getNewsFeedLabel,
getNewsRegionLabel,
getNewsRegionDisplayLabel,
getNewsSourceTypeLabel,
getNewsSourceNameLabel,
isNewsContentReady,
} from "./news-locale.js";
import {
@@ -129,17 +139,18 @@ function formatCoord(value, positiveLabel, negativeLabel) {
}
function formatRelativeTime(raw) {
if (!raw) return "刚刚同步";
const english = getEarthLocale() === "en-US";
if (!raw) return english ? "Just synced" : "刚刚同步";
const date = new Date(raw);
if (Number.isNaN(date.getTime())) return "刚刚同步";
if (Number.isNaN(date.getTime())) return english ? "Just synced" : "刚刚同步";
const diff = Date.now() - date.getTime();
const minutes = Math.max(1, Math.round(diff / 60000));
if (minutes < 60) return `${minutes} 分钟前`;
if (minutes < 60) return english ? `${minutes}m ago` : `${minutes} 分钟前`;
const hours = Math.round(minutes / 60);
if (hours < 24) return `${hours} 小时前`;
if (hours < 24) return english ? `${hours}h ago` : `${hours} 小时前`;
const days = Math.round(hours / 24);
return `${days} 天前`;
return english ? `${days}d ago` : `${days} 天前`;
}
export function updateNewsToggleUI(visible) {
@@ -371,7 +382,7 @@ function escapeNewsHtml(value) {
function getDisplayableNewsItems(items) {
return Array.isArray(items)
? items.filter(isNewsContentReady)
? items.filter((item) => isNewsContentReady(item))
: [];
}
@@ -430,25 +441,30 @@ function normalizeNewsSourceType(value) {
function getNewsSourceDescriptor(item, sourcesByName, sourcesById) {
const feedName = String(item?.feed_name || "").trim();
const sourceName = String(item?.source || feedName || "NEWS").trim();
const rawSourceName = String(item?.source || feedName || "NEWS").trim();
const sourceId = String(item?.source_id || "").trim();
const sourceConfig = sourcesById.get(sourceId) || sourcesByName.get(feedName) || null;
const sourceType = normalizeNewsSourceType(item?.source_type || sourceConfig?.source_type)
|| (feedName.startsWith("Global Monitor /") ? "aggregated" : "rss");
const sourceTypeLabel = getNewsSourceTypeLabel(sourceType);
const channelLabel = getNewsFetchChannelLabel(feedName, sourceType);
const sourceGroupName = String(sourceConfig?.name || "").trim();
const sourceName = getNewsSourceNameLabel(
sourceConfig || { id: sourceId, name: rawSourceName },
);
const feedLabel = getNewsFetchChannelLabel(feedName, sourceType);
const sourceGroupName = sourceConfig ? getNewsSourceNameLabel(sourceConfig) : "";
const originLabel = sourceGroupName
? `${sourceGroupName} · ${channelLabel}`
: feedName && feedName !== sourceName
? `${feedName} · ${sourceTypeLabel}`
? `${feedLabel} · ${sourceTypeLabel}`
: `${channelLabel} · ${sourceTypeLabel}`;
const english = getEarthLocale() === "en-US";
const tooltip = [
`媒体来源:${sourceName}`,
sourceGroupName ? `来源组:${sourceGroupName}` : "",
feedName ? `RSS 来源:${feedName}` : "",
`源类型:${sourceTypeLabel}`,
`抓取通道:${channelLabel}`,
`${english ? "Media source" : "媒体来源"}: ${sourceName}`,
sourceGroupName ? `${english ? "Source group" : "来源组"}: ${sourceGroupName}` : "",
feedName ? `${english ? "RSS feed" : "RSS 来源"}: ${getNewsFeedNameForTooltip(feedName)}` : "",
`${english ? "Source type" : "源类型"}: ${sourceTypeLabel}`,
`${english ? "Fetch channel" : "抓取通道"}: ${channelLabel}`,
].filter(Boolean).join("\n");
return {
sourceName,
@@ -461,6 +477,43 @@ function getNewsSourceDescriptor(item, sourcesByName, sourcesById) {
};
}
function getNewsFeedNameForTooltip(feedName) {
return getEarthLocale() === "en-US"
? getNewsFeedLabel(feedName)
: feedName;
}
function getFocusRegionText(focus = {}) {
return getNewsRegionDisplayLabel(focus.region, focus.display_region);
}
function getFocusLabelText(focus = {}) {
if (getEarthLocale() === "en-US") {
return getNewsRegionDisplayLabel(focus.region, focus.label);
}
return focus.label || "全球焦点";
}
function formatNewsSourceCount(enabledCount, totalCount) {
if (getEarthLocale() === "en-US") return `${enabledCount || totalCount} / ${totalCount} sources`;
return `${enabledCount || totalCount} / ${totalCount} 路来源`;
}
function formatNewsStatus({ displayCount, totalCount, stale, hasErrors }) {
if (getEarthLocale() === "en-US") {
if (displayCount !== totalCount) return `Showing ${displayCount} / ${totalCount} stories`;
if (stale) return `Showing the latest available news cache, ${totalCount} stories`;
return hasErrors
? `Aggregated ${totalCount} stories; some sources are unavailable`
: `Aggregated ${totalCount} situation stories`;
}
if (displayCount !== totalCount) return `展示 ${displayCount} / ${totalCount} 条态势新闻`;
if (stale) return `当前显示最近一次可用新闻缓存,共 ${totalCount} 条`;
return hasErrors
? `已聚合 ${totalCount} 条,部分源不可用`
: `已聚合 ${totalCount} 条态势新闻`;
}
function getEnabledNewsCategoryKeys(filters = activeNewsCategoryFilters) {
if (!filters || typeof filters !== "object") return [...NEWS_CATEGORY_KEYS].sort();
return Object.entries(filters)
@@ -548,10 +601,10 @@ function setNewsSourceFilters(enabledIds, { persist = true } = {}) {
}
function summarizeSelection(enabledCount, totalCount) {
if (totalCount <= 0) return "暂无";
if (enabledCount <= 0) return "未选";
if (enabledCount === totalCount) return "全部";
return `${enabledCount} 项`;
if (totalCount <= 0) return translateText("暂无");
if (enabledCount <= 0) return translateText("未选");
if (enabledCount === totalCount) return translateText("全部");
return translateText(`${enabledCount} 项`);
}
function syncFilterSummaries(nextPayload = payload) {
@@ -567,10 +620,12 @@ function syncFilterSummaries(nextPayload = payload) {
});
document.querySelectorAll('[data-news-filter-summary="limit"]').forEach((el) => {
const total = Array.isArray(nextPayload?.items) ? nextPayload.items.length : 0;
el.textContent = newsFullListMode ? "全部" : `${Math.min(NEWS_SUMMARY_LIMIT, total || NEWS_SUMMARY_LIMIT)} 条`;
el.textContent = newsFullListMode
? translateText("全部")
: translateText(`${Math.min(NEWS_SUMMARY_LIMIT, total || NEWS_SUMMARY_LIMIT)} 条`);
});
document.querySelectorAll("[data-news-view-mode-label]").forEach((el) => {
el.textContent = newsFullListMode ? "返回摘要" : "查看全部";
el.textContent = translateText(newsFullListMode ? "返回摘要" : "查看全部");
});
}
@@ -601,7 +656,9 @@ function renderCategoryFilterChips() {
function renderSourceFilterChips() {
const sources = Array.isArray(payload?.sources) ? payload.sources : [];
const enabled = new Set(getEnabledNewsSourceIds());
if (!sources.length) return `<span class="news-filter-popover__hint">暂无可筛选来源。</span>`;
if (!sources.length) {
return `<span class="news-filter-popover__hint">${escapeNewsHtml(translateText("暂无可筛选来源。"))}</span>`;
}
return sources
.map((source) => {
const id = String(source?.id || "").trim();
@@ -613,15 +670,15 @@ function renderSourceFilterChips() {
type="button"
data-news-source-toggle="${escapeNewsHtml(id)}"
aria-pressed="${active ? "true" : "false"}"
>${escapeNewsHtml(source?.name || id)}</button>
>${escapeNewsHtml(getNewsSourceNameLabel(source || { id }))}</button>
`;
})
.join("");
}
function renderFilterPopover(kind) {
const title = kind === "source" ? "新闻来源" : "新闻类型";
const hint = kind === "source" ? "按大来源筛选,不影响后台抓取。" : "按新闻内容分类筛选。";
const title = translateText(kind === "source" ? "新闻来源" : "新闻类型");
const hint = translateText(kind === "source" ? "按大来源筛选,不影响后台抓取。" : "按新闻内容分类筛选。");
const content = kind === "source" ? renderSourceFilterChips() : renderCategoryFilterChips();
activeFilterPopover = kind;
@@ -675,19 +732,19 @@ function renderTicker(nextPayload) {
const focus = nextPayload?.focus || {};
if (tickerRegion instanceof HTMLElement) {
tickerRegion.textContent = focus.display_region || getNewsRegionLabel(focus.region);
tickerRegion.textContent = getFocusRegionText(focus);
tickerRegion.style.color = focus.accent || "";
}
if (items.length === 0) {
tickerTrack.textContent = "正在准备全球态势新闻...";
tickerTrack.textContent = translateText("正在准备全球态势新闻...");
tickerTrack.style.removeProperty("--news-ticker-duration");
return;
}
const visibleItems = getDisplayableNewsItems(items).slice(0, 6);
if (visibleItems.length === 0) {
tickerTrack.textContent = "当前新闻类型没有可显示新闻...";
tickerTrack.textContent = translateText("当前新闻类型没有可显示新闻...");
tickerTrack.style.removeProperty("--news-ticker-duration");
return;
}
@@ -695,7 +752,10 @@ function renderTicker(nextPayload) {
tickerTrack.innerHTML = tickerItems
.map((item) => `
<span class="earth-news-ticker__item" data-news-id="${escapeTickerText(item.id || "")}">
<span class="earth-news-ticker__source">${escapeTickerText(item.source || item.feed_name || "NEWS")}</span>
<span class="earth-news-ticker__source">${escapeTickerText(getNewsSourceNameLabel({
id: item.source_id,
name: item.source || item.feed_name || "NEWS",
}))}</span>
<span>${escapeTickerText(getNewsDisplaySummary(item))}</span>
</span>
`)
@@ -711,7 +771,7 @@ function renderEmptyState(message) {
empty.textContent = message;
}
if (status) {
status.textContent = "等待聚合新闻源";
status.textContent = translateText("等待聚合新闻源");
}
if (openBtn) openBtn.disabled = true;
renderTicker({ items: [], focus: payload?.focus || { region: "global" } });
@@ -762,7 +822,7 @@ function renderPayload(nextPayload) {
}
if (regionChip) {
regionChip.textContent = focus.display_region || getNewsRegionLabel(focus.region);
regionChip.textContent = getFocusRegionText(focus);
regionChip.style.setProperty("--news-accent", focus.accent || "#d6e6ff");
}
@@ -772,25 +832,22 @@ function renderPayload(nextPayload) {
return;
}
focusLabel.textContent = focus.label || "全球焦点";
focusLabel.textContent = getFocusLabelText(focus);
if (typeof focus.lat === "number" && typeof focus.lon === "number") {
focusCoords.textContent = `${formatCoord(focus.lat, "N", "S")} · ${formatCoord(focus.lon, "E", "W")}`;
} else {
focusCoords.textContent = "跟随当前视角自动聚焦";
focusCoords.textContent = translateText("跟随当前视角自动聚焦");
}
const enabledSourceCount = getEnabledNewsSourceIds(nextPayload).length;
sourceCount.textContent = `${enabledSourceCount || sources.length} / ${sources.length} 路来源`;
if (displayItems.length !== items.length) {
status.textContent = `展示 ${displayItems.length} / ${items.length} 条态势新闻`;
} else if (nextPayload?.stale) {
status.textContent = `当前显示最近一次可用新闻缓存,共 ${items.length} 条`;
} else {
status.textContent = nextPayload?.errors?.length
? `已聚合 ${items.length} 条,部分源不可用`
: `已聚合 ${items.length} 条态势新闻`;
}
sourceCount.textContent = formatNewsSourceCount(enabledSourceCount, sources.length);
status.textContent = formatNewsStatus({
displayCount: displayItems.length,
totalCount: items.length,
stale: Boolean(nextPayload?.stale),
hasErrors: Boolean(nextPayload?.errors?.length),
});
if (feedAnchor) {
const matchedSource = sources.find((source) => source.region === focus.region) || sources[0];
@@ -806,8 +863,8 @@ function renderPayload(nextPayload) {
if (empty) {
empty.hidden = false;
empty.textContent = items.length === 0
? "当前未拉到可用新闻,请稍后刷新或切换视角区域。"
: "当前新闻类型没有可显示新闻。";
? translateText("当前未拉到可用新闻,请稍后刷新或切换视角区域。")
: translateText("当前新闻类型没有可显示新闻。");
}
return;
}
@@ -827,7 +884,7 @@ function renderPayload(nextPayload) {
const title = getNewsDisplayTitle(item);
const summaryText = getNewsDisplaySummary(item);
const leadText = summaryText || title;
const regionLabel = item.display_region || getNewsRegionLabel(item.region);
const regionLabel = getNewsRegionDisplayLabel(item.region, item.display_region);
const categoryLabel = getNewsCategoryLabel(item.category);
const statusLabel = getNewsEnrichmentStatusLabel(item);
const breakingLabel = getNewsBreakingLabel(breakingLevel, breakingScope);
@@ -962,17 +1019,24 @@ async function fetchNews(lat, lon, context = {}) {
const categorySignature = context.categorySignature ?? getNewsCategorySignature();
const sourceSignature = context.sourceSignature ?? getNewsSourceSignatureForFetch(lat, lon);
if (categorySignature === "__none__" || sourceSignature === "__none__") {
const locale = getEarthLocale();
return {
...(payload || {}),
generated_at: new Date().toISOString(),
focus: payload?.focus || { lat, lon, region: "global", label: "全球焦点", display_region: "全球" },
focus: payload?.focus || {
lat,
lon,
region: "global",
label: translateText("全球焦点"),
display_region: getNewsRegionLabel("global"),
},
sources: payload?.sources || [],
filters: {
region: payload?.focus?.region || "global",
categories: categorySignature === "__none__" ? [] : getEnabledNewsCategoryKeys(),
sources: sourceSignature === "__none__" ? [] : getEnabledNewsSourceIds(),
limit: getNewsLimit(),
locale: "zh-CN",
locale,
},
items: [],
cruise_items: [],
@@ -986,7 +1050,7 @@ async function fetchNews(lat, lon, context = {}) {
if (categorySignature) url.searchParams.set("categories", categorySignature);
if (sourceSignature) url.searchParams.set("sources", sourceSignature);
url.searchParams.set("limit", String(getNewsLimit()));
url.searchParams.set("locale", "zh-CN");
url.searchParams.set("locale", getEarthLocale());
const controller = new AbortController();
const timeoutId = window.setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
@@ -1011,6 +1075,7 @@ async function refreshNews(lat, lon, { silent = false } = {}) {
categorySignature,
sourceSignature,
getNewsLimit(),
getEarthLocale(),
].join("|");
if (refreshPromise && refreshRequestKey === requestKey) return refreshPromise;
@@ -1034,9 +1099,10 @@ async function refreshNews(lat, lon, { silent = false } = {}) {
if (Array.isArray(nextPayload?.items) && nextPayload.items.length === 0) {
const { status } = getElements();
if (status) {
status.textContent = "当前区域暂无可用新闻,已完成一次聚合尝试";
status.textContent = translateText("当前区域暂无可用新闻,已完成一次聚合尝试");
}
}
applyEarthI18n();
return nextPayload;
})
.catch((error) => {
@@ -1045,12 +1111,12 @@ async function refreshNews(lat, lon, { silent = false } = {}) {
}
console.error("加载 Earth RSS 新闻失败:", error);
const message = error?.name === "AbortError"
? "新闻聚合请求超时,请稍后重试"
: `新闻聚合暂时不可用: ${error?.message || "未知错误"}`;
? translateText("新闻聚合请求超时,请稍后重试")
: `${translateText("新闻聚合暂时不可用")}: ${error?.message || (getEarthLocale() === "en-US" ? "Unknown error" : "未知错误")}`;
if (!payload) {
renderEmptyState(message);
} else if (!silent) {
showStatusMessage("态势新闻同步失败", "error");
showStatusMessage(earthMessage("status.newsSyncFailed"), "error");
}
throw error;
})
@@ -1185,7 +1251,7 @@ export function initNewsPanel() {
initialized = true;
updateNewsToggleUI(true);
renderEmptyState("正在准备全球态势新闻聚合源...");
renderEmptyState(translateText("正在准备全球态势新闻聚合源..."));
const { ticker, hudCloseBtn } = getElements();
ticker?.addEventListener("click", (event) => {
@@ -1252,6 +1318,13 @@ export function initNewsPanel() {
lastFetchAt = 0;
refreshNews(lastFocus?.lat, lastFocus?.lon, { silent: true }).catch(() => {});
});
onEarthLocaleChange(() => {
syncFilterSummaries();
if (activeFilterPopover) renderFilterPopover(activeFilterPopover);
lastFetchAt = 0;
refreshRequestKey = "";
refreshNews(lastFocus?.lat, lastFocus?.lon, { silent: true }).catch(() => {});
});
setupNewsHudResize();
connectNewsRealtime();
@@ -1260,9 +1333,9 @@ export function initNewsPanel() {
refreshBtn?.addEventListener("click", async () => {
try {
await refreshNews(lastFocus?.lat, lastFocus?.lon);
showStatusMessage("态势新闻已刷新", "info");
showStatusMessage(earthMessage("status.newsRefresh", { ok: true }), "info");
} catch {
showStatusMessage("态势新闻刷新失败", "error");
showStatusMessage(earthMessage("status.newsRefresh", { ok: false }), "error");
}
});
});
+110 -33
View File
@@ -1,6 +1,14 @@
import Hls from "hls.js";
import { showStatusMessage } from "./ui.js";
import { createHUDPanel } from "./hud-panels.js";
import {
earthMessage,
formatLocaleDateTime,
getEarthLocale,
hasCjkText,
onEarthLocaleChange,
translateText,
} from "./i18n.js";
// Naming convention:
// - #media-panel is the outer HUD shell, responsible for drag/resize/show-hide
@@ -63,6 +71,59 @@ const HLS_SOURCE_FAILURE_DETAILS = new Set([
"fragLoadTimeOut",
]);
const TV_SOURCE_TYPE_LABELS = {
hls: "HLS",
video: "Video",
iframe: "Web",
external: "External",
youtube: "YouTube",
};
function isEnglishLocale() {
return getEarthLocale() === "en-US";
}
function titleCaseIdentifier(value) {
return String(value || "")
.replace(/[-_]+/g, " ")
.replace(/\b\w/g, (letter) => letter.toUpperCase())
.trim();
}
function safeTVText(value, fallback = "") {
const text = String(value ?? "").trim();
if (!text) return fallback;
if (isEnglishLocale() && hasCjkText(text)) return fallback;
return text;
}
function getTVSourceName(source) {
if (!source) return translateText("暂无可用频道");
return safeTVText(
source.name,
titleCaseIdentifier(source.id) || "Live Channel",
);
}
function getTVSourceTypeLabel(sourceType) {
const normalized = String(sourceType || "").trim().toLowerCase();
return TV_SOURCE_TYPE_LABELS[normalized] || safeTVText(sourceType, translateText("频道"));
}
function getTVSourceField(value, fallback = "") {
return safeTVText(value, fallback);
}
function getTVCollectorLabel(value) {
const collector = getTVSourceField(value, "Collector");
return `${translateText("采集")}: ${collector}`;
}
function getTVNotes(source) {
if (!source?.notes) return translateText("支持后台配置默认源与采集器补充源。");
return safeTVText(source.notes, translateText("配置于控制台"));
}
function isVideoActuallyPlaying(video) {
return (
video instanceof HTMLVideoElement
@@ -157,9 +218,9 @@ function syncMetaToggleState(collapsed) {
desktopToggle.setAttribute("aria-expanded", collapsed ? "false" : "true");
desktopToggle.setAttribute(
"aria-label",
collapsed ? "展开新闻直播内容" : "折叠新闻直播内容",
translateText(collapsed ? "展开新闻直播内容" : "折叠新闻直播内容"),
);
desktopToggle.title = collapsed ? "展开新闻直播内容" : "折叠新闻直播内容";
desktopToggle.title = translateText(collapsed ? "展开新闻直播内容" : "折叠新闻直播内容");
}
}
@@ -328,11 +389,11 @@ function updateToggleButton(visible) {
icon.textContent = "live_tv";
}
const title = visible ? "关闭 Live 新闻" : "打开 Live 新闻";
toggleBtn.title = title;
toggleBtn.setAttribute("aria-label", title);
toggleBtn.title = translateText(title);
toggleBtn.setAttribute("aria-label", translateText(title));
const tooltip = toggleBtn.querySelector(".earth-toolbar-tooltip");
if (tooltip) {
tooltip.textContent = title;
tooltip.textContent = translateText(title);
}
}
@@ -628,30 +689,30 @@ function syncMobileOverviewSummary(source) {
const summary = document.getElementById("mobile-tv-overview-summary");
const tags = document.getElementById("mobile-tv-overview-tags");
if (headline instanceof HTMLElement) {
headline.textContent = source?.name || "暂无可用频道";
headline.textContent = getTVSourceName(source);
}
if (summary instanceof HTMLElement) {
if (!source) {
summary.textContent = "点击查看当前频道来源、目录和补充说明";
summary.textContent = translateText("点击查看当前频道来源、目录和补充说明");
} else {
const parts = [
source.provider,
source.region,
source.language,
getTVSourceField(source.provider),
getTVSourceField(source.region),
getTVSourceField(source.language),
].filter(Boolean);
summary.textContent = parts.length
? parts.join(" · ")
: "点击查看完整频道信息";
: translateText("点击查看完整频道信息");
}
}
if (tags instanceof HTMLElement) {
const tagValues = source
? [
{ label: source.source_type || "频道", kind: "status" },
source.collector_source ? { label: `采集:${source.collector_source}`, kind: "" } : { label: "内置源", kind: "" },
source.region ? { label: source.region, kind: "" } : null,
{ label: getTVSourceTypeLabel(source.source_type), kind: "status" },
source.collector_source ? { label: getTVCollectorLabel(source.collector_source), kind: "" } : { label: translateText("内置源"), kind: "" },
source.region ? { label: getTVSourceField(source.region, "Global"), kind: "" } : null,
].filter(Boolean).slice(0, 3)
: [{ label: "待加载", kind: "status" }];
: [{ label: translateText("待加载"), kind: "status" }];
tags.replaceChildren(
...tagValues.map(({ label, kind }) => {
const chip = document.createElement("span");
@@ -727,7 +788,7 @@ function getCurrentSource() {
function setPanelMessage(message) {
const { status } = getElements();
if (status) {
status.textContent = message || TV_STATUS_MESSAGE.idle;
status.textContent = translateText(message || TV_STATUS_MESSAGE.idle);
if (status.id === "tv-source-status") {
const normalized = message || TV_STATUS_MESSAGE.idle;
status.classList.toggle(
@@ -762,7 +823,7 @@ function resetVideo(video) {
function showEmptyState(empty, message) {
if (!(empty instanceof HTMLElement)) return;
empty.hidden = false;
empty.textContent = message;
empty.textContent = translateText(message);
}
function hideEmptyState(empty) {
@@ -797,11 +858,11 @@ function renderSourceOptions() {
const fragment = document.createDocumentFragment();
sources.forEach((source) => {
const defaultMark = source.id === tvPayload?.default_source_id ? " · 默认" : "";
const defaultMark = source.id === tvPayload?.default_source_id ? ` · ${translateText("默认")}` : "";
const failMark = failedSourceIds.has(source.id) ? " ⚠" : "";
const option = document.createElement("option");
option.value = source.id;
option.textContent = `${source.name}${defaultMark}${failMark}`;
option.textContent = `${getTVSourceName(source)}${defaultMark}${failMark}`;
fragment.appendChild(option);
});
@@ -820,27 +881,37 @@ function renderSource(source) {
const isExternalOnly = Boolean(source) && !embeddedUrl && !videoUrl && Boolean(externalUrl);
if (title) {
title.textContent = source?.name || "暂无可用频道";
title.textContent = getTVSourceName(source);
}
if (origin instanceof HTMLElement) {
origin.textContent = source?.collector_source ? "采集" : source ? "内置" : "待加载";
origin.title = source?.collector_source ? `采集源:${source.collector_source}` : source ? "内置源" : "待加载";
origin.textContent = source?.collector_source ? translateText("采集") : source ? translateText("内置") : translateText("待加载");
origin.title = source?.collector_source ? `${translateText("采集源")}: ${getTVSourceField(source.collector_source, "Collector")}` : source ? translateText("内置源") : translateText("待加载");
}
if (meta) {
meta.textContent = source
? `${source.provider} · ${source.region} · ${source.language} · ${source.source_type}`
: "当前未配置可播放新闻直播源";
const metaParts = source
? [
getTVSourceField(source.provider),
getTVSourceField(source.region),
getTVSourceField(source.language),
getTVSourceTypeLabel(source.source_type),
].filter(Boolean)
: [];
meta.textContent = metaParts.length
? metaParts.join(" · ")
: translateText("当前未配置可播放新闻直播源");
}
if (catalog) {
const sourceCount = tvPayload?.source_count || tvPayload?.sources?.length || 0;
const latestUpdatedAt = tvPayload?.latest_updated_at || tvPayload?.generated_at || "";
const latestLabel = latestUpdatedAt
? `最近同步 ${new Date(latestUpdatedAt).toLocaleString("zh-CN", { hour12: false })}`
: "尚未同步";
catalog.textContent = `共 ${sourceCount} 个频道 · ${latestLabel}`;
? `${translateText("最近同步")} ${formatLocaleDateTime(latestUpdatedAt)}`
: translateText("尚未同步");
catalog.textContent = isEnglishLocale()
? `${sourceCount} channels · ${latestLabel}`
: `共 ${sourceCount} 个频道 · ${latestLabel}`;
}
if (notes) {
notes.textContent = source?.notes || "支持后台配置默认源与采集器补充源。";
notes.textContent = getTVNotes(source);
}
syncMobileOverviewSummary(source);
@@ -954,8 +1025,8 @@ export function initTVPanel() {
collapseBtn: metaToggle,
bodyCollapsedClass: "is-collapsed",
preferredDirection: "up",
expandLabel: "展开新闻直播信息",
collapseLabel: "折叠新闻直播信息",
expandLabel: translateText("展开新闻直播信息"),
collapseLabel: translateText("折叠新闻直播信息"),
});
}
@@ -965,6 +1036,12 @@ export function initTVPanel() {
updateToggleButton(mediaPanel?.isVisible() ?? !panel?.classList.contains("hud-panel-hidden"));
syncSettingsToggle(mediaPanel?.isVisible() ?? !panel?.classList.contains("hud-panel-hidden"));
onEarthLocaleChange(() => {
syncMetaToggleState(isMetaCollapsed());
updateToggleButton(mediaPanel?.isVisible() ?? !panel?.classList.contains("hud-panel-hidden"));
if (tvPayload) renderPanel();
else renderSource(null);
});
toggleBtn?.addEventListener("click", async (event) => {
event.preventDefault();
@@ -973,12 +1050,12 @@ export function initTVPanel() {
if (!currentlyVisible) {
setPanelVisible(true);
await ensureTVPanelReady();
showStatusMessage("Live 新闻窗口已打开", "info");
showStatusMessage(earthMessage("status.newsPanel", { open: true }), "info");
return;
}
setPanelVisible(false);
showStatusMessage("Live 新闻窗口已关闭", "info");
showStatusMessage(earthMessage("status.newsPanel", { open: false }), "info");
});
[select, document.getElementById("mobile-tv-source-select"), document.getElementById("tv-source-select")]
+60 -22
View File
@@ -1,5 +1,14 @@
// ui.js - UI update functions
import {
applyEarthI18n,
earthMessage,
formatEarthMessage,
getEarthLocale,
onEarthLocaleChange,
translateText,
} from "./i18n.js";
let statusTimeoutId = null;
let statusHideTimeoutId = null;
const STATUS_BASE_CLASS = "earth-status-message";
@@ -27,14 +36,30 @@ function getEarthStatTargets(statKey) {
);
}
function formatEarthStatValue(value) {
return translateText(value);
}
function syncEarthStatElement(element) {
if (!(element instanceof HTMLElement)) return;
const sourceValue = element.dataset.earthStatSourceValue;
if (sourceValue === undefined) return;
element.textContent = formatEarthStatValue(sourceValue);
}
export function setEarthStatValue(statKey, value) {
getEarthStatTargets(statKey).forEach((element) => {
if (element instanceof HTMLElement) {
element.textContent = value;
element.dataset.earthStatSourceValue = String(value ?? "");
syncEarthStatElement(element);
}
});
}
onEarthLocaleChange(() => {
document.querySelectorAll("[data-earth-stat-source-value]").forEach(syncEarthStatElement);
});
function setElementDisplay(element, visible, displayValue = "block") {
if (!element) return;
element.style.display = visible ? displayValue : "none";
@@ -82,7 +107,7 @@ function buildStatusContent(statusEl, message, type) {
const text = document.createElement("span");
text.className = "earth-status-text";
text.textContent = message;
text.textContent = formatEarthMessage(message);
statusEl.appendChild(indicator);
statusEl.appendChild(text);
@@ -92,23 +117,20 @@ function getStatusSidePlacement(statusEl) {
if (!(statusEl instanceof HTMLElement)) return false;
if (document.querySelector(".layout-mode-mobile")) return false;
const ticker = document.getElementById("desktop-news-ticker");
const brand = document.getElementById("brand-panel");
if (!(ticker instanceof HTMLElement) || !(brand instanceof HTMLElement)) return false;
if (ticker.classList.contains("is-hidden") || ticker.offsetParent === null) return false;
if (!(brand instanceof HTMLElement)) return false;
const tickerRect = ticker.getBoundingClientRect();
const brandRect = brand.getBoundingClientRect();
const statusWidth = Math.ceil(statusEl.getBoundingClientRect().width || statusEl.scrollWidth || 0);
if (!statusWidth || !tickerRect.width || !brandRect.width) return false;
if (!statusWidth || !brandRect.width) return false;
const rootStyle = getComputedStyle(document.documentElement);
const hudScale = Number.parseFloat(rootStyle.getPropertyValue("--hud-scale")) || 1;
const requiredGap = Math.max(10, Math.round(12 * hudScale));
const availableWidth = tickerRect.left - brandRect.right - requiredGap * 2;
const left = Math.round(brandRect.right + requiredGap);
const availableWidth = window.innerWidth - left - requiredGap;
return {
shouldStack: availableWidth < statusWidth,
left: Math.round(brandRect.right + requiredGap),
left,
maxWidth: Math.max(160, Math.floor(availableWidth)),
};
}
@@ -122,9 +144,8 @@ function syncStatusPlacement(statusEl) {
return;
}
const placement = getStatusSidePlacement(statusEl);
const shouldStack = !placement || placement.shouldStack;
statusEl.classList.toggle(STATUS_TICKER_STACK_CLASS, shouldStack);
if (!placement || shouldStack) {
statusEl.classList.remove(STATUS_TICKER_STACK_CLASS);
if (!placement) {
statusEl.style.left = "";
statusEl.style.maxWidth = "";
return;
@@ -134,10 +155,12 @@ function syncStatusPlacement(statusEl) {
}
function syncVisibleStatusPlacement() {
const statusEl = getElement("status-message");
if (statusEl?.classList.contains("visible")) {
syncStatusPlacement(statusEl);
}
["status-message", "error-message"].forEach((id) => {
const el = getElement(id);
if (el?.classList.contains("visible")) {
syncStatusPlacement(el);
}
});
}
function buildPersistentErrorContent(errorEl, message) {
@@ -237,7 +260,9 @@ export function updateCoordinatesDisplay(lat, lon, alt = 0) {
if (longitudeEl) longitudeEl.textContent = lon.toFixed(2) + "°";
if (latitudeEl) latitudeEl.textContent = lat.toFixed(2) + "°";
if (mouseCoordsEl) {
mouseCoordsEl.textContent = `鼠标: ${lat.toFixed(2)}°, ${lon.toFixed(2)}°`;
mouseCoordsEl.textContent = getEarthLocale() === "en-US"
? `Mouse: ${lat.toFixed(2)}°, ${lon.toFixed(2)}°`
: `鼠标: ${lat.toFixed(2)}°, ${lon.toFixed(2)}°`;
}
}
@@ -253,7 +278,11 @@ export function updateZoomDisplay(zoomLevel, distance) {
const label = `${percent}%`;
zoomValueEl.textContent = label;
}
if (zoomLevelEl) zoomLevelEl.textContent = "缩放: " + percent + "%";
if (zoomLevelEl) {
zoomLevelEl.textContent = getEarthLocale() === "en-US"
? `Zoom: ${percent}%`
: `缩放: ${percent}%`;
}
if (slider) slider.value = zoomLevel;
if (cameraDistanceEl) cameraDistanceEl.textContent = distance + " km";
}
@@ -276,7 +305,14 @@ export function updateEarthStats(stats) {
setEarthStatValue("bgp-collector-count", String(stats.bgpCollectorCount || 0));
}
if (has("bgpStatusSummary")) setEarthStatValue("bgp-status-summary", stats.bgpStatusSummary || "-");
if (has("terrainOn")) setEarthStatValue("terrain-status", stats.terrainOn ? "开启" : "关闭");
if (has("terrainOn")) {
setEarthStatValue(
"terrain-status",
getEarthLocale() === "en-US"
? (stats.terrainOn ? "On" : "Off")
: (stats.terrainOn ? "开启" : "关闭"),
);
}
if (has("textureQuality")) setEarthStatValue("texture-quality", stats.textureQuality || "8K 卫星图");
}
@@ -292,7 +328,7 @@ export function setLoading(loading) {
clearLoadingWidthLock(statusEl);
buildStatusContent(
statusEl,
pendingLoadingMessage || "正在加载...",
pendingLoadingMessage || earthMessage("loading.default"),
"loading",
);
pendingLoadingMessage = "";
@@ -331,7 +367,7 @@ export function setLoadingMessage(title) {
}
const textEl = statusEl.querySelector(".earth-status-text");
if (textEl) {
textEl.textContent = title;
textEl.textContent = formatEarthMessage(title);
requestAnimationFrame(() => {
updateLoadingWidthLock(statusEl);
syncStatusPlacement(statusEl);
@@ -344,6 +380,7 @@ export function showTooltip(x, y, content) {
const tooltip = getElement("tooltip");
if (!tooltip) return;
tooltip.innerHTML = content;
applyEarthI18n(tooltip);
tooltip.style.left = x + "px";
tooltip.style.top = y + "px";
setElementDisplay(tooltip, true);
@@ -364,6 +401,7 @@ export function showError(message) {
buildPersistentErrorContent(errorEl, message);
errorEl.className = `${STATUS_BASE_CLASS} earth-error-message error`;
setElementDisplay(errorEl, true, "inline-flex");
syncStatusPlacement(errorEl);
errorEl.offsetHeight;
errorEl.classList.add("visible");
}
+7 -6
View File
@@ -14,6 +14,7 @@ import { useEffect, useMemo, useState } from 'react'
import { Link } from 'react-router-dom'
import Scrollbar from '../../components/Scrollbar/Scrollbar'
import { useWebSocket } from '../../hooks/useWebSocket'
import { describeApiError, describeApiValue } from '../../i18n/api-errors'
import { useAuthStore } from '../../stores/auth'
import { formatDateTimeZhCN } from '../../utils/datetime'
import { AdminLayout } from '../components/layout/AdminLayout'
@@ -148,14 +149,14 @@ function DashboardContent() {
setRestartTaskId(res.data.task_id)
setRestartStartedAt(Date.now())
setRestartStage('waiting_for_shutdown')
setRestartMessage(res.data.message || '已发送重启指令,正在等待服务进入重启流程。')
setRestartMessage(describeApiValue(res.data.message, '已发送重启指令,正在等待服务进入重启流程。'))
setRestartLogs((current) => [...current, `任务已创建: ${res.data.task_id}`])
} catch (restartError: unknown) {
const err = restartError as { response?: { data?: { detail?: string } } }
const restartFailureMessage = describeApiError(restartError, '提交重启任务失败')
setRestartStage('failed')
setRestartMessage(err.response?.data?.detail || '提交重启任务失败')
setRestartMessage(restartFailureMessage)
setRestartLogs((current) => [...current, '提交重启任务失败'])
toast({ tone: 'error', title: '提交失败', description: err.response?.data?.detail || '提交重启任务失败' })
toast({ tone: 'error', title: '提交失败', description: restartFailureMessage })
} finally {
setRestartSubmitting(false)
}
@@ -191,7 +192,7 @@ function DashboardContent() {
try {
const taskRes = await axios.get<RestartTask>(`/api/v1/system/restart-tasks/${restartTaskId}`, { timeout: 1500 })
const task = taskRes.data
if (!cancelled && task?.message) setRestartMessage(task.message)
if (!cancelled && task?.message) setRestartMessage(describeApiValue(task.message, '重启任务正在执行'))
if (!cancelled && restartAction !== 'restart-system') {
const logsRes = await axios.get<RestartTaskLogs>(`/api/v1/system/restart-tasks/${restartTaskId}/logs`, { timeout: 1500 })
if (logsRes.data.lines.length > 0) setRestartLogs(logsRes.data.lines.slice(-8))
@@ -204,7 +205,7 @@ function DashboardContent() {
}
if (!cancelled && (task.status === 'failed' || task.status === 'timeout')) {
setRestartStage(task.status === 'timeout' ? 'timeout' : 'failed')
setRestartMessage(task.message || '重启任务失败')
setRestartMessage(describeApiValue(task.message, '重启任务失败'))
return
}
} catch {
+2 -3
View File
@@ -4,6 +4,7 @@ import { useEffect, useMemo, useRef, useState } from 'react'
import { useLocation, useNavigate } from 'react-router-dom'
import Scrollbar from '../../components/Scrollbar/Scrollbar'
import { useWebSocket } from '../../hooks/useWebSocket'
import { describeApiError } from '../../i18n/api-errors'
import { useAuthStore } from '../../stores/auth'
import { AdminLayout } from '../components/layout/AdminLayout'
import { Badge } from '../components/ui/badge'
@@ -168,9 +169,7 @@ function statusLabel(status: string) {
}
function getErrorMessage(error: unknown, fallback: string) {
if (!axios.isAxiosError(error)) return fallback
const detail = error.response?.data?.detail
return typeof detail === 'string' ? detail : fallback
return describeApiError(error, fallback)
}
function formatDateTime(value?: string | null) {
File diff suppressed because it is too large. Load diff
+3 -4
View File
@@ -6,6 +6,7 @@ import { useEffect, useMemo, useState } from 'react'
import { useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { z } from 'zod'
import { describeApiError } from '../../i18n/api-errors'
import { useAuthStore } from '../../stores/auth'
import { DataTable } from '../components/data-table/DataTable'
import { AdminLayout } from '../components/layout/AdminLayout'
@@ -134,8 +135,7 @@ export default function Users() {
setModalVisible(false)
void fetchUsers()
} catch (error: unknown) {
const err = error as { response?: { data?: { detail?: string } } }
toast({ tone: 'error', title: t('common.operationFailed'), description: err.response?.data?.detail || t('users.retryLater') })
toast({ tone: 'error', title: t('common.operationFailed'), description: describeApiError(error, t('users.retryLater')) })
}
}
@@ -147,8 +147,7 @@ export default function Users() {
setDeleteTarget(null)
void fetchUsers()
} catch (error: unknown) {
const err = error as { response?: { data?: { detail?: string } } }
toast({ tone: 'error', title: t('users.deleteFailed'), description: err.response?.data?.detail || t('users.retryLater') })
toast({ tone: 'error', title: t('users.deleteFailed'), description: describeApiError(error, t('users.retryLater')) })
}
}
+199 -3
View File
@@ -123,7 +123,7 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
min-height: 0;
height: 100%;
display: grid;
grid-template-columns: 236px minmax(0, 1fr);
grid-template-columns: 264px minmax(0, 1fr);
background: var(--an-bg);
overflow: hidden;
}
@@ -151,19 +151,33 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
height: 58px;
display: flex;
align-items: center;
justify-content: flex-start;
gap: 10px;
padding: 0 14px;
border-bottom: 1px solid var(--an-border);
text-align: left;
}
.admin__brand-copy {
display: grid;
justify-items: start;
min-width: 0;
overflow: hidden;
text-align: left;
}
.admin__brand-text {
font-weight: 700;
font-size: 16px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.admin__brand-subtitle {
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.admin__brand-subtitle,
@@ -183,19 +197,29 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
}
.admin__nav {
box-sizing: border-box;
width: 100%;
min-width: 0;
padding: 10px;
display: grid;
justify-items: stretch;
gap: 6px;
text-align: left;
}
.admin__nav-group {
width: 100%;
min-width: 0;
display: grid;
justify-items: stretch;
gap: 4px;
}
.admin__nav-group-button,
.admin__nav-link {
box-sizing: border-box;
width: 100%;
min-width: 0;
border: 0;
background: transparent;
color: var(--an-text);
@@ -204,11 +228,28 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
padding: 0 10px;
display: flex;
align-items: center;
justify-content: flex-start;
gap: 10px;
text-align: left;
text-decoration: none;
cursor: pointer;
}
.admin__nav-group-button svg,
.admin__nav-link svg {
flex: 0 0 auto;
}
.admin__nav-group-button span,
.admin__nav-link span {
flex: 1 1 auto;
min-width: 0;
overflow: hidden;
text-align: left;
text-overflow: ellipsis;
white-space: nowrap;
}
.admin__nav-group-button:hover,
.admin__nav-link:hover,
.admin__nav-link.is-active {
@@ -220,7 +261,11 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
}
.admin__nav-children {
box-sizing: border-box;
width: 100%;
min-width: 0;
display: grid;
justify-items: stretch;
gap: 3px;
padding-left: 22px;
}
@@ -236,6 +281,7 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
.admin__nav-chevron {
margin-left: auto;
flex: 0 0 auto;
transition: transform 0.15s ease;
}
@@ -250,14 +296,16 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
background: color-mix(in srgb, var(--an-bg) 42%, var(--an-surface));
display: grid;
gap: 0;
text-align: left;
}
.admin__account-row {
display: flex;
align-items: center;
justify-content: space-between;
justify-content: flex-start;
gap: 12px;
font-size: 12px;
text-align: left;
}
.admin__account-row--primary {
@@ -274,19 +322,23 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
display: flex !important;
grid-template-columns: none;
align-items: center;
justify-content: flex-start;
min-width: 0;
flex: 1 1 auto;
margin-right: 6px;
text-align: left;
}
.admin__account-row .admin__account-profile {
gap: 18px;
gap: 12px;
}
.admin__account-profile > div {
min-width: 0;
display: grid;
justify-items: start;
gap: 1px;
text-align: left;
}
.admin__account-avatar {
@@ -314,6 +366,12 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
white-space: nowrap;
}
.admin__account-profile span:not(.admin__account-avatar) {
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.admin__account-actions {
display: flex !important;
grid-template-columns: none;
@@ -321,6 +379,7 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
justify-content: flex-end;
flex: 0 0 auto;
gap: 4px;
margin-left: auto;
}
.admin__account-logout,
@@ -390,7 +449,9 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
border-radius: 8px;
background: color-mix(in srgb, var(--an-bg) 62%, var(--an-surface));
display: grid;
justify-items: stretch;
gap: 8px;
text-align: left;
}
.admin__theme-control--sider {
@@ -438,6 +499,7 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
font-size: calc(10px * var(--segmented-control-scale, 1));
font-weight: 800;
line-height: 1;
padding: 0 4px;
}
.admin__logout {
@@ -1635,6 +1697,111 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
border-style: dashed;
}
.an-brand-asset-input {
position: relative;
min-width: 0;
height: 34px;
display: grid;
grid-template-columns: minmax(0, 1fr) auto;
align-items: center;
overflow: hidden;
border: 1px solid var(--an-border);
border-radius: 6px;
background: var(--an-surface);
color: var(--an-text);
transition: border-color 0.16s ease, box-shadow 0.16s ease, background-color 0.16s ease;
}
.an-brand-asset-input:focus-within {
border-color: color-mix(in srgb, var(--an-accent) 24%, var(--an-border-strong));
}
.an-brand-asset-input.is-dragging {
border-color: var(--an-border-strong);
background: color-mix(in srgb, var(--an-soft) 46%, var(--an-surface));
box-shadow: 0 2px 5px rgba(15, 23, 42, 0.1), 0 8px 18px rgba(15, 23, 42, 0.06);
}
.an-brand-asset-input__control {
width: 100%;
min-width: 0;
height: 100%;
border: 0;
outline: 0;
background: transparent;
color: inherit;
padding: 0 10px;
font: inherit;
line-height: 32px;
}
.an-brand-asset-input__control:disabled {
color: var(--an-muted);
}
.an-brand-asset-input__file {
position: absolute;
width: 1px;
height: 1px;
opacity: 0;
pointer-events: none;
}
.an-brand-asset-input__upload {
position: relative;
z-index: 1;
min-width: 72px;
height: var(--tui-control-height, 28px);
margin-right: 3px;
padding-inline: 10px;
white-space: nowrap;
}
.an-brand-asset-input__drop-overlay {
position: absolute;
inset: 0;
z-index: 2;
display: flex;
align-items: center;
justify-content: space-between;
gap: 10px;
padding: 0 12px;
border: 1px dashed var(--an-border-strong);
border-radius: 5px;
background: color-mix(in srgb, var(--an-soft) 82%, var(--an-surface));
color: var(--an-text);
pointer-events: none;
}
.an-brand-asset-input__drop-overlay > span {
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
font-size: 13px;
font-weight: 800;
}
.an-brand-asset-input__drop-overlay > strong {
min-width: max-content;
height: 28px;
padding: 0 10px;
border: 1px solid var(--an-border);
border-radius: 6px;
display: inline-flex;
align-items: center;
gap: 6px;
background: var(--an-surface);
color: var(--an-text);
box-shadow: 0 10px 24px rgba(15, 23, 42, 0.16);
font-size: 13px;
font-weight: 800;
}
.admin-theme-root[data-theme='dark'] .an-brand-asset-input__drop-overlay > strong {
box-shadow: 0 12px 30px rgba(0, 0, 0, 0.34);
}
.an-mapping-form {
display: grid;
gap: 12px;
@@ -2210,6 +2377,31 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
text-overflow: ellipsis;
}
.an-earth-brand-preview .hud-panel-brand .earth-brand--en {
--brand-copy-width: 172px;
}
.an-earth-brand-preview .hud-panel-brand .earth-brand--en .earth-brand__subtitle,
.an-earth-brand-preview .hud-panel-brand .earth-brand--en .earth-brand__description {
font-family: "Roboto Condensed", "Arial Narrow", "Trebuchet MS", "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
overflow: visible;
text-overflow: clip;
white-space: normal;
word-break: normal;
overflow-wrap: normal;
letter-spacing: 0;
}
.an-earth-brand-preview .hud-panel-brand .earth-brand--en .earth-brand__subtitle {
font-size: calc(0.58rem * var(--hud-scale) * var(--brand-scale));
line-height: 1.15;
}
.an-earth-brand-preview .hud-panel-brand .earth-brand--en .earth-brand__description {
font-size: calc(0.5rem * var(--hud-scale) * var(--brand-scale));
line-height: 1.15;
}
.an-tv-earth-preview {
--hud-scale: 0.82;
--hud-gap-xs: calc(6px * var(--hud-scale));
@@ -4006,12 +4198,16 @@ body:has(.admin-theme-root[data-theme='dark']) .an-toast {
}
.an-segmented button {
min-width: 0;
border: 0;
background: transparent;
color: var(--an-muted);
border-radius: 4px;
padding: 0 10px;
cursor: pointer;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.an-segmented button.is-active {
+10 -1
View File
@@ -41,6 +41,7 @@ const legacyTextPatternsEnUS: LegacyTextPattern[] = [
{ match: /^已导出\s+(.+)$/, replace: (match) => `Exported ${match[1]}` },
{ match: /^(.+)\s+采集失败$/, replace: (match) => `${match[1]} collection failed` },
{ match: /^(.+)\s+采集已取消$/, replace: (match) => `${match[1]} collection cancelled` },
{ match: /^选择(.+)$/, replace: (match) => `Select ${match[1]}` },
]
const legacyTextPatternsZhCN: LegacyTextPattern[] = [
@@ -69,6 +70,7 @@ const legacyTextPatternsZhCN: LegacyTextPattern[] = [
{ match: /^Exported\s+(.+)$/, replace: (match) => `已导出 ${match[1]}` },
{ match: /^(.+)\s+collection failed$/, replace: (match) => `${match[1]} 采集失败` },
{ match: /^(.+)\s+collection cancelled$/, replace: (match) => `${match[1]} 采集已取消` },
{ match: /^Select\s+(.+)$/, replace: (match) => `选择${match[1]}` },
]
function preserveOuterWhitespace(source: string, replacement: string) {
@@ -94,7 +96,14 @@ function translateText(value: string, locale: string) {
const dictionary = normalizeLocale(locale) === 'en-US' ? legacyUiTextEnUS : reverseLegacyUiText
const replacement = dictionary[text]
if (replacement) return preserveOuterWhitespace(value, replacement)
return translatePatternText(value, locale)
const patternTranslated = translatePatternText(value, locale)
if (patternTranslated !== value) return patternTranslated
if (text.length > 240) return value
const entries = Object.entries(dictionary)
.filter(([source]) => source && text.includes(source))
.sort(([left], [right]) => right.length - left.length)
if (!entries.length) return value
return entries.reduce((next, [source, target]) => next.split(source).join(target), value)
}
function translateElementAttributes(element: Element, locale: string) {
+93
View File
@@ -0,0 +1,93 @@
import i18n from './index'
import { legacyUiTextEnUS } from './legacy-ui'
import { normalizeLocale } from './locale'
type ApiErrorPayload = {
detail?: unknown
error?: unknown
message?: unknown
}
type ApiErrorLike = {
message?: unknown
response?: {
data?: ApiErrorPayload
}
}
const cjkPattern = /[\u3400-\u9fff]/
const genericEnglishFallback = 'Operation failed'
function isRecord(value: unknown): value is Record<string, unknown> {
return Boolean(value && typeof value === 'object' && !Array.isArray(value))
}
function currentLocale() {
return normalizeLocale(i18n.resolvedLanguage || i18n.language)
}
export function hasCjkText(value: string) {
return cjkPattern.test(value)
}
function englishFallbackFor(fallback: string) {
const normalized = fallback.trim()
if (!normalized) return genericEnglishFallback
if (!hasCjkText(normalized)) return normalized
return legacyUiTextEnUS[normalized] || genericEnglishFallback
}
function stringFromApiValue(value: unknown): string {
if (value === null || value === undefined || value === '') return ''
if (typeof value === 'string') return value
if (typeof value === 'number' || typeof value === 'boolean') return String(value)
if (Array.isArray(value)) {
const firstMessage = value
.map((item) => stringFromApiValue(item))
.find(Boolean)
return firstMessage || ''
}
if (isRecord(value)) {
const directMessage = stringFromApiValue(value.message || value.detail || value.error)
if (directMessage) return directMessage
const code = stringFromApiValue(value.code)
if (code) return code
try {
return JSON.stringify(value)
} catch {
return ''
}
}
return ''
}
export function localizeApiMessage(message: string, fallback = genericEnglishFallback) {
const normalized = message.trim()
if (currentLocale() !== 'en-US') return normalized || fallback
const englishFallback = englishFallbackFor(fallback)
if (!normalized) return englishFallback
const exactLegacy = legacyUiTextEnUS[normalized]
if (exactLegacy) return exactLegacy
if (hasCjkText(normalized)) return englishFallback
return normalized
}
export function describeApiValue(value: unknown, fallback = genericEnglishFallback) {
return localizeApiMessage(stringFromApiValue(value), fallback)
}
export function describeApiError(error: unknown, fallback = genericEnglishFallback) {
if (isRecord(error)) {
const apiError = error as ApiErrorLike
const payload = apiError.response?.data
if (payload) {
const responseValue = payload.detail ?? payload.message ?? payload.error
const responseMessage = describeApiValue(responseValue, fallback)
if (responseMessage) return responseMessage
}
const errorMessage = stringFromApiValue(apiError.message)
if (errorMessage) return localizeApiMessage(errorMessage, fallback)
}
if (error instanceof Error) return localizeApiMessage(error.message, fallback)
return localizeApiMessage('', fallback)
}
+268 -6
View File
@@ -18,7 +18,6 @@ export const legacyUiTextEnUS: Record<string, string> = {
'BGP观测': 'BGP Observatory',
'Feed 信息页': 'Feed info page',
'Feed 地址': 'Feed URL',
'Feed 子项': 'Feed entries',
'Feed 标签': 'Feed tags',
'Feed 类型': 'Feed type',
'Feed 名称': 'Feed name',
@@ -46,6 +45,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'供应商': 'Provider',
'供应商状态': 'Provider status',
'供应商配置': 'Provider configuration',
'事件': 'Event',
'保存': 'Save',
'保存并重试': 'Save and retry',
'保存后会进入清洗、翻译、分类和定位队列。': 'After saving, the item enters the cleaning, translation, classification, and geocoding queue.',
@@ -74,10 +74,15 @@ export const legacyUiTextEnUS: Record<string, string> = {
'其他': 'Other',
'刷新': 'Refresh',
'刷新当前 Provider 的模型配置': 'Refresh current provider model configuration',
'刷新间隔(秒)': 'Refresh interval (seconds)',
'刷新模型': 'Refresh models',
'刷新模型列表': 'Refresh model list',
'刷新线程': 'Refresh thread',
'分类': 'Category',
'副标题': 'Subtitle',
'标题图地址': 'Title image URL',
'标题图替代文本': 'Title image alt text',
'标题文字': 'Title text',
'删除 Feed 子项': 'Delete feed entry',
'删除': 'Delete',
'删除失败': 'Delete failed',
@@ -99,6 +104,9 @@ export const legacyUiTextEnUS: Record<string, string> = {
'启动实时源': 'Start realtime source',
'启动边界构建': 'Start boundary build',
'启用': 'Enabled',
'启用 WebSearch': 'Enable WebSearch',
'启用 OCR': 'Enable OCR',
'启用邮件通知': 'Enable email notifications',
'启用抓取': 'Enable fetching',
'启用映射': 'Enable mapping',
'启用筛选': 'Active filters',
@@ -106,6 +114,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'告警记录': 'Alert records',
'告警统计': 'Alert stats',
'名称': 'Name',
'认证方式': 'Auth method',
'后台账号': 'Console account',
'回到首页': 'Back to overview',
'国界精度': 'Boundary accuracy',
@@ -123,6 +132,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'已加载分区汇总': 'Loaded section total',
'工具调用': 'Tool calls',
'已保存': 'Saved',
'已保存密钥不回传明文,输入新值可替换': 'Saved secrets are not returned; enter a new value to replace it',
'已取消': 'Cancelled',
'已处理': 'Resolved',
'已提交': 'Submitted',
@@ -134,6 +144,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'已停用': 'Disabled',
'已就绪': 'Ready',
'已跳过': 'Skipped',
'有效': 'Valid',
'已有新闻': 'Existing news',
'已有任务运行': 'Task already running',
'已有账号,去登录': 'Already have an account? Log in',
@@ -161,7 +172,9 @@ export const legacyUiTextEnUS: Record<string, string> = {
'接口在线': 'Endpoints online',
'接口失败': 'Endpoint failed',
'接口请求失败': 'Endpoint request failed',
'接口路径': 'Endpoint path',
'提示': 'Info',
'操作失败': 'Operation failed',
'控制台不混入其他配置或假数据。': 'The console does not mix in unrelated configuration or mock data.',
'控制台发生错误,请刷新页面重试。': 'The console encountered an error. Please refresh and try again.',
'控制台渲染错误': 'Console render error',
@@ -172,8 +185,8 @@ export const legacyUiTextEnUS: Record<string, string> = {
'提示词': 'Prompts',
'搜索日志正文': 'Search log text',
'搜索名称、描述、元数据等': 'Search name, description, metadata, and more',
'搜索': 'Search',
'搜索供应商': 'Search provider',
'搜索': 'Search',
'搜索深度': 'Search depth',
'搜索用户、邮箱、角色': 'Search users, email, or role',
'数据源': 'Datasources',
@@ -196,6 +209,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'采集时间': 'Collected at',
'采集已取消': 'Collection cancelled',
'采集失败': 'Collection failed',
'采集成功': 'Collection succeeded',
'采集完成': 'Collection complete',
'采集中': 'Collecting',
'采集管理': 'Collection Management',
@@ -256,6 +270,8 @@ export const legacyUiTextEnUS: Record<string, string> = {
'显示 LLM API Key / Service Token': 'Show LLM API Key / Service Token',
'显示': 'Display',
'智能星球': 'Intelligent Planet',
'智能星球计划': 'Intelligent Planet Program',
'智能星球计划品牌标识': 'Intelligent Planet Program brand banner',
'智能星球内容配置': 'Intelligent Planet content configuration',
'智能星球配置详情': 'Intelligent Planet configuration details',
'智能星球内容': 'Planet Content',
@@ -301,9 +317,10 @@ export const legacyUiTextEnUS: Record<string, string> = {
'源属性': 'Source attributes',
'源详情': 'Source details',
'源健康': 'Source health',
'来源': 'Source',
'区域': 'Region',
'按数据源': 'By datasource',
'按类型': 'By type',
'按数据源': 'Source',
'按类型': 'Type',
'排序': 'Sort order',
'单条添加': 'Add one item',
'单源配置': 'Single-source configuration',
@@ -328,8 +345,10 @@ export const legacyUiTextEnUS: Record<string, string> = {
'结果': 'Results',
'系统告警列表': 'System alert list',
'系统告警': 'System Alerts',
'系统数据库日志': 'System database logs',
'系统日志': 'System Logs',
'系统显示': 'System display',
'系统名称': 'System name',
'系统设置': 'System Settings',
'系统总览与实时态势': 'System overview and realtime status',
'设置': 'Settings',
@@ -343,6 +362,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'选择左侧父级后编辑它的子配置。': 'Select a parent item on the left to edit its child configuration.',
'选择日志源后读取快照。': 'Select a log source to read its snapshot.',
'选择新闻直播源': 'Select news stream source',
'层级': 'Level',
'纬度': 'Latitude',
'经度': 'Longitude',
'统计': 'Stats',
@@ -354,6 +374,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'网络': 'Network',
'自定义': 'Custom',
'自定义源': 'Custom sources',
'演示模式': 'Demo mode',
'自治系统统计': 'Autonomous system stats',
'自动回退': 'Auto fallback',
'英文标题': 'English title',
@@ -362,6 +383,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'英文分类': 'English category',
'草稿': 'Draft',
'警告': 'Warning',
'警告告警通知': 'Warning alerts',
'设备统计': 'Device stats',
'触发全部': 'Trigger all',
'触发采集': 'Trigger collection',
@@ -375,6 +397,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'请稍后重试': 'Please try again later',
'连接失败': 'Connection failed',
'连接中': 'Connecting',
'正在连接': 'Connecting',
'连接测试': 'Connection test',
'连通性': 'Connectivity',
'连通正常': 'Connectivity normal',
@@ -390,6 +413,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'返回上一级详情': 'Back to parent details',
'返回列表': 'Back to list',
'通知策略': 'Notification policy',
'通知邮箱': 'Notification email',
'配置错误': 'Configuration error',
'配置源': 'Configuration source',
'重要度与健康策略': 'Importance and health policy',
@@ -435,11 +459,17 @@ export const legacyUiTextEnUS: Record<string, string> = {
'Docker 不可用': 'Docker unavailable',
'GPU 集群': 'GPU clusters',
'HTTP 失败': 'HTTP failed',
'Anthropic 版本': 'Anthropic version',
'Earth 左上角品牌实际渲染预览': 'Rendered preview of the top-left Earth brand',
'LLM 基础地址': 'LLM base URL',
'Logo 替代文本': 'Logo alt text',
'当前分区没有可用后端能力,控制台不混入其他配置或假数据。': 'This section has no backend capability yet; the console does not mix in unrelated configuration or fake data.',
'当前分区没有可配置项。': 'This section has no configurable items.',
'当前模块暂无数据': 'No data in this module',
'当前已是默认': 'Already default',
'当前已是默认频道': 'Already the default channel',
'当前配置可以连通。': 'Current configuration can connect.',
'当前配置连通性检查失败。': 'Configuration connectivity check failed.',
'当前采集源没有可查看的历史版本。': 'This collection source has no historical versions.',
'待定位': 'Pending location',
'后端能力未提供': 'Backend capability unavailable',
@@ -454,6 +484,11 @@ export const legacyUiTextEnUS: Record<string, string> = {
'只重启前端开发服务,页面会短暂不可用,恢复后自动刷新。': 'Restart only the frontend dev service. The page will be briefly unavailable and refresh after recovery.',
'失败时页面仍可操作': 'Page remains usable when requests fail',
'打开': 'Open',
'观测台': 'Observatory',
'概览': 'Overview',
'概览摘要': 'Overview summary',
'告警详情': 'Alert details',
'查看智能星球图层缓存': 'View Intelligent Planet layer cache',
'描述来源属性,不是媒体来源名;多个标签用逗号分隔,例如 business_news, ecommerce, china。': 'Describe source attributes, not media source names. Separate multiple tags with commas, for example business_news, ecommerce, china.',
'浏览采集结果、筛选数据源和查看原始元数据。': 'Browse collected results, filter datasources, and inspect raw metadata.',
'管理采集器、采集调度和采集历史 / 快照。': 'Manage collectors, collection schedules, and collection history / snapshots.',
@@ -462,6 +497,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'管理系统显示、通知策略、安全策略和 SMTP 邮件。': 'Manage system display, notification policy, security policy, and SMTP email.',
'统一查看内置源、自定义源、实时源与任务状态,保留触发、启停和连接状态入口。': 'View built-in, custom, and realtime sources plus task status in one place, with trigger, start/stop, and connectivity entries.',
'严重告警': 'Critical alerts',
'严重告警通知': 'Critical alerts',
'查看日志源、读取快照、复制原始输出,按控制台阅读方式组织。': 'View log sources, read snapshots, and copy raw output in a console-friendly layout.',
'查看日志源、按级别/日期/搜索条件读取快照,并复制原始输出。': 'View log sources, read snapshots by level, date, and search filters, then copy raw output.',
'显示系统告警记录和统计,不混入 BGP 概览以外的数据。': 'Shows system alert records and stats without mixing in data outside the BGP overview.',
@@ -476,6 +512,39 @@ export const legacyUiTextEnUS: Record<string, string> = {
'仅展示数据源相关接口,不混入其他设置对象。': 'Only datasource endpoints are shown; unrelated settings objects are not mixed in.',
'仅展示智能星球品牌、边界构建和电视内容配置。': 'Only Intelligent Planet branding, boundary builds, and TV content configuration are shown.',
'读取快照': 'Read snapshot',
'触发全部数据源': 'Trigger all datasources',
'数据源任务,暂无任务': 'Datasource tasks, no tasks',
'生成 BGP AI 简报': 'Generate BGP AI brief',
'生成系统告警 AI 简报': 'Generate system alert AI brief',
'生成态势告警 AI 简报': 'Generate situational alert AI brief',
'生成简报': 'Generate brief',
'模块': 'Module',
'模块分区': 'Module sections',
'指标': 'Metric',
'支持 png, jpg, jpeg, webp, svg': 'Supports png, jpg, jpeg, webp, svg',
'协议适配': 'Protocol adapter',
'代理 Token': 'Proxy token',
'代理地址': 'Proxy URL',
'设为默认': 'Set as default',
'输入新的 LLM API Key': 'Enter new LLM API key',
'输入新的代理 Token': 'Enter new proxy token',
'显示LLM API Key': 'Show LLM API key',
'隐藏LLM API Key': 'Hide LLM API key',
'显示代理 Token': 'Show proxy token',
'隐藏代理 Token': 'Hide proxy token',
'显示API Key': 'Show API key',
'隐藏API Key': 'Hide API key',
'最大输出 Tokens': 'Max output tokens',
'超时(秒)': 'Timeout (seconds)',
'拖动调整详情宽度': 'Drag to resize details',
'异常': 'Anomaly',
'播放类型': 'Playback type',
'上次状态': 'Last status',
'上次执行': 'Last run',
'需要凭证': 'Requires credentials',
'凭证提供方': 'Credential provider',
'凭证教程': 'Credential guide',
'接口地址': 'Endpoint URL',
'输入要发送给 AI 的内容': 'Enter content to send to AI',
'发送': 'Send',
'会话': 'Conversation',
@@ -485,6 +554,31 @@ export const legacyUiTextEnUS: Record<string, string> = {
'目标': 'Objective',
'约束': 'Constraints',
'描述': 'Description',
'每日摘要': 'Daily digest',
'Logo 地址': 'Logo URL',
'上传 Logo': 'Upload logo',
'上传标题图片': 'Upload title image',
'上传中': 'Uploading',
'将图片拖到这里': 'Drop file here',
'复制为 Logo': 'Copy as logo',
'复制为标题图': 'Copy as title image',
'Logo 图片已上传': 'Logo image uploaded',
'标题图片已上传': 'Title image uploaded',
'请拖入图片文件': 'Drop an image file',
'API 基础地址': 'API base URL',
'Firecrawl 抓取路径': 'Firecrawl scrape path',
'Firecrawl 搜索路径': 'Firecrawl search path',
'SearXNG 分类': 'SearXNG categories',
'SerpAPI 引擎': 'SerpAPI engine',
'OCR 基础地址': 'OCR base URL',
'OCR 供应商': 'OCR provider',
'包含答案': 'Include answer',
'包含原始内容': 'Include raw content',
'包含正文': 'Include text',
'输入新的 OCR API Key': 'Enter new OCR API key',
'输入新的 WebSearch API Key': 'Enter new WebSearch API key',
'每个搜索 provider 有独立 API 与高级参数': 'Each search provider has its own API and advanced parameters',
'OCR provider、模型、语言和文件限制': 'OCR provider, model, language, and file limits',
'优先级': 'Priority',
'边界状态': 'Boundary status',
'边界构建': 'Boundary build',
@@ -518,6 +612,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'重启 PostgreSQL 和 Redis 容器,前端页面保持在线。': 'Restart the PostgreSQL and Redis containers while the frontend stays online.',
'重启前后端和相关服务,页面会短暂不可用,恢复后自动刷新。': 'Restart frontend, backend, and related services. The page will be briefly unavailable and refresh after recovery.',
'已发送重启指令,正在等待服务进入重启流程。': 'Restart command sent. Waiting for services to enter the restart flow.',
'重启任务正在执行': 'Restart task is running',
'服务已恢复,正在刷新页面。': 'Service recovered. Refreshing the page.',
'前端已恢复,正在刷新页面。': 'Frontend recovered. Refreshing the page.',
'前端正在重启,正在等待页面入口恢复访问。': 'Frontend is restarting. Waiting for the page entry to recover.',
@@ -530,6 +625,7 @@ export const legacyUiTextEnUS: Record<string, string> = {
'导出 JSON': 'Export JSON',
'导出 CSV': 'Export CSV',
'数据详情': 'Data details',
'数据保留天数': 'Data retention days',
'按级别/日期/搜索条件读取快照': 'Read snapshots by level, date, and search filters',
'点击左侧聚合项查看每次发生时间。': 'Click an aggregation on the left to view each occurrence time.',
'管理员敏感操作和安全审计记录。': 'Sensitive admin operations and security audit records.',
@@ -564,8 +660,6 @@ export const legacyUiTextEnUS: Record<string, string> = {
'条结果': 'results',
'筛选': 'Filters',
'共': 'Total',
'智能星球计划': 'Intelligent Planet Plan',
'智能星球计划品牌标识': 'Intelligent Planet Plan branding',
'现实层宇宙全息感知系统': 'Reality-layer holographic awareness system',
'卫星 · 海底光缆 · 算力基础设施': 'Satellites · Submarine cables · Computing infrastructure',
'选择/拖入资产': 'Select / drop asset',
@@ -586,4 +680,172 @@ export const legacyUiTextEnUS: Record<string, string> = {
'卫星': 'Satellite',
'算力': 'Compute',
'媒体': 'Media',
'参考': 'Reference',
'参考链接': 'Reference link',
'参考链接不参与抓取': 'Reference links are not fetched',
'亚太': 'Asia-Pacific',
'中国': 'China',
'中东与非洲': 'Middle East and Africa',
'全球': 'Global',
'欧洲': 'Europe',
'美国': 'United States',
'美洲': 'Americas',
'36氪': '36Kr',
'亿邦动力': 'Ebrun',
'商务数据中心': 'MOFCOM Data Center',
'商务部电商动态': 'MOFCOM E-Commerce',
'国家统计局数据发布': 'National Bureau of Statistics',
'电商物流指数': 'China E-Commerce Logistics Index',
'综合资讯': 'General',
'文章资讯': 'Articles',
'最新快讯': 'Newsflash',
'动态内容': 'Updates',
'零售': 'Retail',
'服务': 'Services',
'商业': 'Business',
'政治': 'Politics',
'金融': 'Finance',
'科技': 'Technology',
'无条目': 'No entries',
'格式错误': 'Format error',
'超时': 'Timeout',
'尚未测试当前源。': 'This source has not been tested yet.',
'来源官网、栏目页或报告页,不作为抓取入口。': 'Official site, section page, or report page. It is not used as the fetch entry.',
'默认类型': 'Default category',
'重要度权重': 'Importance weight',
'抓取间隔(分钟)': 'Fetch interval (minutes)',
'失败阈值': 'Failure threshold',
'熔断冷却(分钟)': 'Circuit-breaker cooldown (minutes)',
'熔断开关': 'Circuit breaker',
'组名 / 来源名': 'Group / source name',
'组类型': 'Group type',
'新闻数量': 'News count',
'内容来源': 'Content source',
'原文链接': 'Original URL',
'缺省区域': 'Default region',
'Feed 子项': 'Feed entries',
'每个子项都是一个真实 RSS/Atom/Aggregated 抓取入口,可单独启停和设置默认新闻类型。': 'Each entry is a real RSS/Atom/Aggregated fetch entry and can be enabled, disabled, and assigned its own default category.',
'添加一个真实 RSS/Atom/Aggregated 地址后才能抓取。': 'Add a real RSS/Atom/Aggregated URL before fetching.',
'启用 Feed': 'Enable feed',
'停用 Feed': 'Disable feed',
'用于新闻排序、抓取频率、超时和熔断控制。': 'Used for news ranking, fetch frequency, timeout, and circuit-breaker control.',
'频道身份、状态和排序。': 'Channel identity, status, and sort order.',
'播放地址、封面、YouTube 信息和其他高级字段。': 'Playback URL, cover image, YouTube metadata, and other advanced fields.',
'配置表单': 'Configuration form',
'常用字段直接编辑;复杂对象保留结构化子字段,不再把整条记录只丢进 JSON。': 'Common fields are edited directly; complex objects keep structured child fields instead of sending the whole record into JSON only.',
'查看完整 JSON': 'View full JSON',
'原始数据': 'Raw data',
'日志正文': 'Log text',
'正在加载数据': 'Loading data',
'同步中': 'Syncing',
'就绪': 'Ready',
'进度': 'Progress',
'取消任务': 'Cancel task',
'清空已结束队列项': 'Clear completed queue items',
'暂无数据源任务': 'No datasource tasks',
'进行': 'Running',
'跳过': 'Skipped',
'可选模型': 'Available models',
'快照版本': 'Snapshot version',
'快照摘要': 'Snapshot summary',
'采集任务': 'Collection task',
'当前没有运行中的任务。': 'No task is currently running.',
'没有可用 WebSearch 证据,已保留默认教程。': 'No WebSearch evidence is available, so the default guide was kept.',
'首版只支持顶层为数组的 JSON 文件;取消不会清空当前新闻组详情。': 'The first version only supports JSON files whose top-level value is an array. Canceling does not clear the current news group details.',
'选择文件': 'Select file',
'实时启停': 'Start / stop realtime source',
'采集位置': 'Collect location',
'拉取详情': 'Fetch details',
'预览': 'Preview',
'预览映射': 'Preview mapping',
'到采集管理编辑': 'Edit in Collection Management',
'测试启用源': 'Test enabled sources',
'重置默认新闻源': 'Reset default news sources',
'重置新闻源': 'Reset news sources',
'删除数据': 'Delete data',
'清理数据源缓存': 'Clear datasource cache',
'停止删除': 'Stop deletion',
'停止已选': 'Stop selected',
'触发已选': 'Trigger selected',
'已取消新增直播源': 'New stream source cancelled',
'已取消新增新闻源': 'New news source cancelled',
'已取消新增配置': 'New configuration cancelled',
'已恢复当前项': 'Current item restored',
'表单已恢复到加载时状态。': 'The form has been restored to its loaded state.',
'当前分区未找到该数据源': 'Datasource not found in the current section',
'可切回内置源或刷新后再查看。': 'Switch back to built-in sources or refresh before viewing it again.',
'无法重试': 'Cannot retry',
'当前列表中没有找到对应数据源。': 'The matching datasource was not found in the current list.',
'读取凭证失败': 'Failed to read credentials',
'JSON 格式错误': 'Invalid JSON',
'请修正高级编辑内容后再保存。': 'Fix the advanced editor content before saving.',
'请修正映射内容后再保存。': 'Fix the mapping content before saving.',
'请修正映射内容后再预览。': 'Fix the mapping content before previewing.',
'新闻源配置不完整': 'News source configuration is incomplete',
'参考链接不能启用抓取,请改为 RSS/Atom/Aggregated 或关闭启用。': 'Reference links cannot be fetched. Use RSS/Atom/Aggregated or disable fetching.',
'RSS/Atom/Aggregated 新闻源需要至少一个 Feed 子项。': 'RSS/Atom/Aggregated news sources need at least one feed entry.',
'新闻标题不能为空。': 'News title is required.',
'坐标必须是数字。': 'Coordinates must be numeric.',
'坐标超出范围。': 'Coordinates are out of range.',
'新闻源缺少已启用的 Feed 子项。': 'The news source has no enabled feed entries.',
'OCR 配置': 'OCR configuration',
'个入口': 'entries',
'条消息': 'messages',
'发送一条消息开始测试 AI 链路。': 'Send a message to test the AI link.',
'数据源健康': 'Datasource health',
'链路探测': 'Link smoke test',
'AI 链路探测': 'AI link smoke test',
'BGP 告警态势简报': 'BGP alert situational brief',
'总结当前告警的主要风险、优先级与建议动作。': 'Summarize the main risks, priorities, and recommended actions for the current alerts.',
'结论要简洁\n优先给出操作建议': 'Keep conclusions concise\nPrioritize operational recommendations',
'出现新的高危告警\n部分观测站最近 24h 事件增多\n请先给出风险摘要,再列出建议动作。': 'New high-risk alerts appeared\nSome observatories have more events in the last 24h\nStart with a risk summary, then list recommended actions.',
'采集器健康检查说明': 'Collector health check guide',
'判断当前采集器失败是否属于上游接口失效、限流、结构变更或临时波动。': 'Determine whether the current collector failure is caused by upstream outage, rate limiting, schema drift, or temporary fluctuation.',
'区分事实与推断\n先给排障优先级': 'Separate facts from inference\nPrioritize troubleshooting first',
'最近 3 次任务失败\n部分数据源响应时间抬升\n个别接口返回结构不稳定\n请帮我先做排障优先级排序。': 'The last 3 tasks failed\nSome datasources have slower responses\nA few endpoints return unstable structures\nPlease prioritize troubleshooting.',
'验证 backend -> aiprovider -> model provider 调用链路是否正常。': 'Verify whether the backend -> aiprovider -> model provider call chain works.',
'输出简洁\n包含一段明确结论': 'Keep output concise\nInclude a clear conclusion',
'当前从 Playground 发起测试,希望确认 provider 配置和返回结构正常,请直接给我链路结论。': 'This Playground test should confirm provider configuration and response structure. Give the link conclusion directly.',
'无障碍标签': 'Accessibility label',
'版本': 'Version',
'版本号来自当前系统版本,只读展示,不会随关于信息提交。': 'The version comes from the current system version. It is read-only and is not submitted with About information.',
'边界': 'Boundary',
'构建': 'Build',
'内置': 'Built-in',
'Live 新闻': 'Live News',
'直播加载中': 'Live stream loading',
'个频道': 'channels',
'尚未同步': 'Not synced yet',
'提供方': 'Provider',
'地区': 'Region',
'语言': 'Language',
'可回退': 'Fallback',
'备注': 'Notes',
'播放流地址': 'Stream URL',
'嵌入地址': 'Embed URL',
'封面地址': 'Poster URL',
'YouTube 视频 ID': 'YouTube video ID',
'YouTube 频道': 'YouTube channel',
'Earth TV 实际渲染预览': 'Rendered Earth TV preview',
'商业新闻': 'Business news',
'连通不稳定': 'Unstable connectivity',
'官方数据': 'Official data',
'来源类型': 'Source type',
'条新闻。': 'news items.',
'单条标题只在这里展示,左侧保持来源/组聚合。': 'Only item titles are shown here; the left side keeps source/group aggregation.',
'可以单条添加或上传 JSON 数组导入。': 'You can add items one by one or upload a JSON array.',
'是': 'Yes',
'否': 'No',
'采集间隔(分钟)': 'Collection interval (minutes)',
'无时间': 'No timestamp',
'自动刷新': 'Auto refresh',
'会话超时(分钟)': 'Session timeout (minutes)',
'密码策略': 'Password policy',
'主机': 'Host',
'端口': 'Port',
'用户名': 'Username',
'使用 TLS': 'Use TLS',
'发件邮箱': 'Sender email',
'发件人名称': 'Sender name',
'个历史快照,选择后查看该版本详情。': 'historical snapshots. Select one to view that version.',
}
+2
View File
@@ -141,6 +141,7 @@ export const zhCN = {
},
},
docs: {
brandMark: '智',
brandTitle: '智能星球文档',
brandSubtitle: '开发者和用户手册',
documentUnavailable: '文档不可用',
@@ -354,6 +355,7 @@ export const enUS = {
},
},
docs: {
brandMark: 'IP',
brandTitle: 'Intelligent Planet Docs',
brandSubtitle: 'Developer & User Guide',
documentUnavailable: 'Document unavailable',
+1 -1
View File
@@ -308,7 +308,7 @@ export default function Docs() {
<main className="docs-page" data-theme={effectiveTheme}>
<aside className="docs-sidebar" aria-label="Documentation navigation">
<Link className="docs-brand" to="/docs">
<span className="docs-brand__mark">智</span>
<span className="docs-brand__mark">{t('docs.brandMark')}</span>
<span>
<span className="docs-brand__title">
{t('docs.brandTitle')}
@@ -2,23 +2,10 @@ import axios from 'axios'
import { useEffect, useState, type FormEvent } from 'react'
import { Trans, useTranslation } from 'react-i18next'
import { AuthButton, AuthField, AuthForm, AuthInput, AuthLinks, AuthNotice, AuthShell, BackToLogin } from '../Auth/AuthShell'
import { describeApiError } from '../../i18n/api-errors'
const API_URL = import.meta.env.VITE_API_URL || '/api/v1'
interface ErrorBody {
response?: {
data?: { detail?: string | { code?: string; message?: string; retry_after_seconds?: number } }
}
}
function extractDetail(error: unknown, fallback: string): string {
const err = error as ErrorBody
const detail = err.response?.data?.detail
if (typeof detail === 'string') return detail
if (detail && typeof detail === 'object') return detail.message || detail.code || fallback
return fallback
}
function ForgotPassword() {
const { t } = useTranslation()
const [step, setStep] = useState<'request' | 'reset'>('request')
@@ -45,7 +32,7 @@ function ForgotPassword() {
setCooldown(60)
setFeedback({ tone: 'success', text: t('auth.recoveryCodeSent') })
} catch (error) {
setFeedback({ tone: 'error', text: extractDetail(error, t('common.operationFailed')) })
setFeedback({ tone: 'error', text: describeApiError(error, t('common.operationFailed')) })
} finally {
setLoading(false)
}
@@ -62,7 +49,7 @@ function ForgotPassword() {
setNewPassword('')
setFeedback({ tone: 'success', text: t('auth.passwordResetSuccess') })
} catch (error) {
setFeedback({ tone: 'error', text: extractDetail(error, t('common.operationFailed')) })
setFeedback({ tone: 'error', text: describeApiError(error, t('common.operationFailed')) })
} finally {
setLoading(false)
}
@@ -75,7 +62,7 @@ function ForgotPassword() {
setCooldown(60)
setFeedback({ tone: 'success', text: t('auth.resendSuccess') })
} catch (error) {
setFeedback({ tone: 'error', text: extractDetail(error, t('common.operationFailed')) })
setFeedback({ tone: 'error', text: describeApiError(error, t('common.operationFailed')) })
}
}
+2 -2
View File
@@ -2,6 +2,7 @@ import { useState, type FormEvent } from 'react'
import { useTranslation } from 'react-i18next'
import { Link, useNavigate } from 'react-router-dom'
import { AuthButton, AuthField, AuthForm, AuthInput, AuthLinks, AuthNotice, AuthShell } from '../Auth/AuthShell'
import { describeApiValue } from '../../i18n/api-errors'
import { useAuthStore } from '../../stores/auth'
interface LoginError {
@@ -36,8 +37,7 @@ function Login() {
navigate(`/verify-email${email}`)
return
}
const fallback = typeof detail === 'string' ? detail : detail?.message
setFeedback({ tone: 'error', text: fallback || t('auth.loginFailed') })
setFeedback({ tone: 'error', text: describeApiValue(detail, t('auth.loginFailed')) })
} finally {
setLoading(false)
}
+4 -11
View File
@@ -3,6 +3,7 @@ import { useEffect, useState, type FormEvent } from 'react'
import { Trans, useTranslation } from 'react-i18next'
import { Link, useNavigate } from 'react-router-dom'
import { AuthButton, AuthField, AuthForm, AuthInput, AuthLinks, AuthNotice, AuthShell } from '../Auth/AuthShell'
import { describeApiError } from '../../i18n/api-errors'
import { useAuthStore } from '../../stores/auth'
const API_URL = import.meta.env.VITE_API_URL || '/api/v1'
@@ -16,14 +17,6 @@ interface ErrorBody {
}
}
function extractDetail(error: unknown, fallback: string): string {
const err = error as ErrorBody
const detail = err.response?.data?.detail
if (typeof detail === 'string') return detail
if (detail && typeof detail === 'object') return detail.message || detail.code || fallback
return fallback
}
function Register() {
const { t } = useTranslation()
const navigate = useNavigate()
@@ -53,7 +46,7 @@ function Register() {
setCooldown(RESEND_COOLDOWN_SECONDS)
setFeedback({ tone: 'success', text: t('auth.verificationSent') })
} catch (error) {
setFeedback({ tone: 'error', text: extractDetail(error, t('common.operationFailed')) })
setFeedback({ tone: 'error', text: describeApiError(error, t('common.operationFailed')) })
} finally {
setLoading(false)
}
@@ -70,7 +63,7 @@ function Register() {
axios.defaults.headers.common.Authorization = `Bearer ${access_token}`
navigate('/admin', { replace: true })
} catch (error) {
setFeedback({ tone: 'error', text: extractDetail(error, t('common.operationFailed')) })
setFeedback({ tone: 'error', text: describeApiError(error, t('common.operationFailed')) })
} finally {
setLoading(false)
}
@@ -88,7 +81,7 @@ function Register() {
const err = error as ErrorBody
const detail = err.response?.data?.detail
if (detail && typeof detail === 'object' && detail.retry_after_seconds) setCooldown(detail.retry_after_seconds)
setFeedback({ tone: 'error', text: extractDetail(error, t('common.operationFailed')) })
setFeedback({ tone: 'error', text: describeApiError(error, t('common.operationFailed')) })
} finally {
setResending(false)
}
+3 -10
View File
@@ -3,6 +3,7 @@ import { useEffect, useState, type FormEvent } from 'react'
import { useTranslation } from 'react-i18next'
import { useNavigate, useSearchParams } from 'react-router-dom'
import { AuthButton, AuthField, AuthForm, AuthInput, AuthLinks, AuthNotice, AuthShell, BackToLogin } from '../Auth/AuthShell'
import { describeApiError } from '../../i18n/api-errors'
import { useAuthStore } from '../../stores/auth'
const API_URL = import.meta.env.VITE_API_URL || '/api/v1'
@@ -13,14 +14,6 @@ interface ErrorBody {
}
}
function extractDetail(error: unknown, fallback: string): string {
const err = error as ErrorBody
const detail = err.response?.data?.detail
if (typeof detail === 'string') return detail
if (detail && typeof detail === 'object') return detail.message || detail.code || fallback
return fallback
}
function VerifyEmail() {
const { t } = useTranslation()
const navigate = useNavigate()
@@ -49,7 +42,7 @@ function VerifyEmail() {
axios.defaults.headers.common.Authorization = `Bearer ${access_token}`
navigate('/admin', { replace: true })
} catch (error) {
setFeedback({ tone: 'error', text: extractDetail(error, t('common.operationFailed')) })
setFeedback({ tone: 'error', text: describeApiError(error, t('common.operationFailed')) })
} finally {
setLoading(false)
}
@@ -67,7 +60,7 @@ function VerifyEmail() {
const err = error as ErrorBody
const detail = err.response?.data?.detail
if (detail && typeof detail === 'object' && detail.retry_after_seconds) setCooldown(detail.retry_after_seconds)
setFeedback({ tone: 'error', text: extractDetail(error, t('common.operationFailed')) })
setFeedback({ tone: 'error', text: describeApiError(error, t('common.operationFailed')) })
} finally {
setResending(false)
}
+46 -71
View File
@@ -229,6 +229,8 @@ prepare_uv_build_config() {
prepare_uv_build_config
source "$SCRIPT_DIR/scripts/lib/docker-bootstrap.zsh"
# Shell / Docker helpers
is_pid() {
[[ "${1:-}" =~ ^[0-9]+$ ]] && [ "$1" -gt 0 ]
@@ -373,14 +375,6 @@ write_port_state() {
chmod 600 "$PLANET_PORT_STATE_FILE" 2>/dev/null || true
}
compose_available() {
docker compose version >/dev/null 2>&1
}
compose_v1_available() {
command -v docker-compose >/dev/null 2>&1
}
report_missing_compose() {
clear_wait_spinner
log_error "未检测到可用的 Docker Compose"
@@ -394,27 +388,9 @@ report_missing_compose() {
return 1
}
buildx_version() {
docker buildx version 2>/dev/null | awk '{print $2}' | sed 's/^v//'
}
buildx_meets_minimum() {
local current_version="$1"
local required_version="$2"
[ -n "$current_version" ] || return 1
[ -n "$required_version" ] || return 1
if [ "$(printf '%s\n%s\n' "$required_version" "$current_version" | sort -V | head -n 1)" = "$required_version" ]; then
return 0
fi
return 1
}
log_buildx_diagnostics_if_needed() {
local current_buildx_version=""
local required_buildx_version="0.17.0"
local required_buildx_version="$DOCKER_MIN_BUILDX_VERSION"
current_buildx_version="$(buildx_version)"
@@ -440,6 +416,10 @@ compose_up() {
if docker compose "${args[@]}"; then
return 0
fi
if ! compose_v1_available; then
log_error "Docker Compose 执行失败: docker compose ${arg_text}"
return 1
fi
log_warn "docker compose 执行失败,回退到 docker-compose v1"
fi
@@ -1298,47 +1278,6 @@ format_wait_elapsed_seconds() {
'
}
docker_daemon_available() {
docker info >/dev/null 2>&1
}
log_docker_daemon_diagnostics() {
local docker_service_status=""
local docker_socket_status=""
local service_hint="sudo systemctl enable --now docker.socket && sudo systemctl restart docker"
docker_service_status="$(systemctl is-active docker 2>/dev/null || true)"
docker_socket_status="$(systemctl is-active docker.socket 2>/dev/null || true)"
if [ -S /var/run/docker.sock ] && [ ! -r /var/run/docker.sock ]; then
log_note "检测到 /var/run/docker.sock 存在,但当前用户无法访问。"
log_note "请确认当前用户已加入 docker 组,并重新登录会话。"
return 0
fi
if [ "$docker_service_status" = "active" ]; then
log_note "Docker CLI 可执行,但当前会话仍无法连接 daemon。"
log_note "请先执行: docker info"
return 0
fi
if [ "$docker_service_status" = "failed" ] || [ "$docker_socket_status" = "failed" ]; then
log_note "检测到 Docker daemon 当前未正常运行。"
log_note "可先执行: ${service_hint}"
log_note "如仍失败,继续查看: journalctl -u docker.service -n 50 --no-pager"
return 0
fi
if [ "$docker_socket_status" != "active" ]; then
log_note "检测到 Docker socket 未激活,daemon 可能无法通过 systemd socket activation 启动。"
log_note "可先执行: ${service_hint}"
return 0
fi
log_note "当前无法连接 Docker daemon,请先执行: docker info"
log_note "若 daemon 未启动,可尝试: ${service_hint}"
}
print_database_failure_diagnostics() {
if ! docker_daemon_available; then
log_note "数据库容器尚未真正开始启动,当前失败更像是 Docker 运行时不可用。"
@@ -2505,15 +2444,16 @@ wait_for_postgres_health() {
}
start_database_services() {
docker start planet_postgres planet_redis >/dev/null 2>&1 || compose_up up -d postgres redis >/dev/null 2>&1
# Reconcile existing containers too; docker start cannot apply changed port bindings.
compose_up up -d --no-deps postgres redis
}
restart_database_services() {
docker restart planet_postgres planet_redis >/dev/null 2>&1 || compose_up up -d postgres redis >/dev/null 2>&1
start_database_services && docker restart planet_postgres planet_redis
}
start_postgres_service() {
docker start planet_postgres >/dev/null 2>&1 || compose_up up -d postgres >/dev/null 2>&1
compose_up up -d --no-deps postgres
}
# Backend lifecycle helpers
@@ -4046,6 +3986,21 @@ asyncio.run(init_db())
PY
}
verify_backend_database_connection() {
local check_status=0
local check_command=("$SCRIPT_DIR/.venv/bin/python" "$SCRIPT_DIR/scripts/check_database_connection.py")
set_wait_detail "验证后端实际 PostgreSQL 地址、端口与认证"
run_command_with_spinner "验证后端数据库连接" "${check_command[@]}" || check_status=$?
# Exit 2 means missing published ports; credentials and other failures must not recreate data services.
[ "$check_status" -eq 2 ] || return "$check_status"
log_warn "PostgreSQL 实际端口映射不匹配,保留数据卷并按 Compose 配置重建一次"
compose_up up -d --no-deps --force-recreate postgres || return 1
wait_for_postgres_health || return 1
run_command_with_spinner "重新验证后端数据库连接" "${check_command[@]}"
}
planet_app_services_running() {
local backend_port=""
local frontend_port=""
@@ -4109,6 +4064,14 @@ init() {
print_splash
start_wait_session "准备 Docker 运行环境"
if ! ensure_docker_runtime "${PLANET_COMMAND_ARGS[@]}"; then
stop_wait_session
exit 1
fi
stop_wait_session
log_success "Docker / Compose / Buildx 已就绪"
start_wait_session "准备 Python 运行时"
ensure_python_runtime
stop_wait_session
@@ -4132,6 +4095,11 @@ init() {
start_wait_session "启动数据库服务"
ensure_database_services_healthy
if ! verify_backend_database_connection; then
stop_wait_session
log_error "后端数据库连接检查失败,尚未执行建表和默认数据初始化"
exit 1
fi
stop_wait_session
log_success "数据库服务已就绪"
@@ -4677,9 +4645,16 @@ parse_global_args() {
trap cleanup_failed_start EXIT
PLANET_COMMAND_ARGS=("$@")
parse_global_args "$@"
set -- "${GLOBAL_ARG_REMAINDER[@]}"
case "$1" in
init|start|restart|stop|health|log|createuser)
refresh_docker_group "${PLANET_COMMAND_ARGS[@]}" || exit 1
;;
esac
case "$1" in
init)
shift
+1 -1
View File
@@ -1,6 +1,6 @@
[project]
name = "planet"
version = "0.73.0"
version = "0.74.3"
description = "智能星球计划 - 态势感知系统"
requires-python = ">=3.14"
dependencies = [
+17
View File
@@ -161,6 +161,13 @@ rg -n "api[_-]?key|client_secret|BEGIN .*PRIVATE KEY|AKIA[0-9A-Z]" .
Always.
### Harness
- `rules.md` is the active repository rule source. Keep durable constraints here instead of duplicating them across prompt files.
- Use `.codex/skills/` for specialized Codex workflows such as cleanup, docs, goal-driven work, and release.
- Do not add new legacy harness entry points when an existing skill or rule module can carry the same instruction.
- If a harness rule is no longer true for the current toolchain, update or delete it in the same cleanup pass.
### Git
- Do not revert user changes unless explicitly requested.
@@ -173,6 +180,16 @@ Always.
- Prefer maintained, widely used libraries.
- Pin dependency versions in `pyproject.toml`, `uv.lock`, and `package.json`.
### Visual Evidence Gate
- If the user provides a screenshot, image, video frame, visual mock, browser capture, or says something like "as shown", obtain evidence from that artifact before interpreting the request or changing code.
- Path resolution is part of the task. If a provided path does not open, try reasonable local equivalents first, such as WSL/Windows path conversion, workspace-relative paths, absolute paths, and attached-file locations.
- If the artifact still cannot be found or opened, stop that visual-dependent work and report the exact path/access problem instead of guessing. Ask for an accessible file/path or a fresh screenshot.
- Do not infer visual intent from the filename, surrounding text, alt text, logs, or prior assumptions.
- OCR is acceptable evidence for text-only questions or when the active environment lacks multimodal image viewing, but state that OCR was the fallback. Layout, color, spacing, pixel, and rendering issues still require a real visual inspection or an explicit "could not verify visually" note.
- After inspecting the artifact, ground the work in at least one concrete observed detail when it affects the task.
- For UI or rendering fixes that depend on appearance, verify with a real screenshot or browser render when the project can be run locally.
### Deterministic Context
- Prefer compact CLI evidence over reading large files or full diffs:
+134
View File
@@ -0,0 +1,134 @@
#!/usr/bin/env python3
"""Check the backend's PostgreSQL target before init is allowed to change its schema."""
import asyncio
import json
import os
from pathlib import Path
import subprocess
import sys
from sqlalchemy import text
from sqlalchemy.engine import URL, make_url
from sqlalchemy.ext.asyncio import create_async_engine
from sqlalchemy.pool import NullPool
ROOT = Path(__file__).resolve().parents[1]
CONNECT_TIMEOUT_SECONDS = 10
DEFAULT_POSTGRES_PORT = 5432
POSTGRES_CONTAINER = "planet_postgres"
POSTGRES_CONTAINER_PORT = "5432/tcp"
LOOPBACK_HOSTS = {"localhost", "127.0.0.1", "::1"}
class DatabaseReadinessError(RuntimeError):
"""A safe, actionable diagnostic that does not include connection credentials."""
class MissingPortBindingError(DatabaseReadinessError):
"""Exit 2 asks planet.sh to reconcile the managed container once, preserving its volume."""
def backend_database_url() -> str:
sys.path.insert(0, str(ROOT / "backend"))
from app.core.config import settings
return settings.DATABASE_URL
def check_published_port(url: URL) -> None:
if url.host not in LOOPBACK_HOSTS:
return # An explicitly configured external database has no local container mapping.
result = subprocess.run(
[
"docker",
"inspect",
"--format",
"{{.HostConfig.NetworkMode}}\n{{json .NetworkSettings.Ports}}",
POSTGRES_CONTAINER,
],
capture_output=True,
text=True,
timeout=CONNECT_TIMEOUT_SECONDS,
check=False,
)
if result.returncode:
raise DatabaseReadinessError(
"无法读取 planet_postgres;请检查当前 Docker context 和容器状态。"
)
network_mode, ports_json = result.stdout.strip().split("\n", 1)
if network_mode == "host":
return # Host networking intentionally has no published-port table.
ports = json.loads(ports_json) or {}
bindings = ports.get(POSTGRES_CONTAINER_PORT) or []
port = str(url.port or DEFAULT_POSTGRES_PORT)
if not any(binding.get("HostPort") == port for binding in bindings):
raise MissingPortBindingError(
f"planet_postgres 未向宿主机发布后端配置的端口 {port};"
"请核对 Compose ports、DATABASE_URL 和 Docker context。"
"容器内部健康不代表宿主机可连接。"
)
async def check_connection(url: URL) -> None:
engine = create_async_engine(url, poolclass=NullPool, echo=False)
try:
async with asyncio.timeout(CONNECT_TIMEOUT_SECONDS):
async with engine.connect() as connection:
await connection.execute(text("SELECT 1"))
finally:
await engine.dispose()
def connection_diagnostic(error: BaseException) -> str:
pending = [error]
visited: set[int] = set()
while pending:
current = pending.pop()
if id(current) in visited:
continue
visited.add(id(current))
sqlstate = getattr(current, "sqlstate", None) or getattr(current, "pgcode", None)
if sqlstate in {"28P01", "28000"}:
return (
"PostgreSQL 认证失败:核对 DATABASE_URL 的账号密码及连接目标。"
"只改 POSTGRES_PASSWORD 不会更新 DATABASE_URL,也不会重设已有数据卷的密码。"
)
if sqlstate == "3D000":
return "目标数据库不存在:核对 DATABASE_URL 的库名与已有数据库。"
if isinstance(current, (TimeoutError, OSError)):
return "数据库连接被拒绝、超时或地址不可达:核对端口映射、监听服务和 Docker endpoint。"
for nested in (getattr(current, "orig", None), current.__cause__, current.__context__):
if isinstance(nested, BaseException):
pending.append(nested)
return "数据库连接检查失败:核对 backend/.env、进程环境变量和目标 PostgreSQL 服务日志。"
def main() -> int:
try:
url = make_url(backend_database_url())
print(
f"后端数据库目标: host={url.host!r} port={url.port or DEFAULT_POSTGRES_PORT} database={url.database!r}"
)
print(
"DATABASE_URL 来源: "
+ ("进程环境变量" if "DATABASE_URL" in os.environ else "backend 配置")
)
check_published_port(url)
asyncio.run(check_connection(url))
except MissingPortBindingError as error:
print(str(error), file=sys.stderr)
return 2
except DatabaseReadinessError as error:
print(str(error), file=sys.stderr)
return 1
except Exception as error:
# Driver/config exceptions can contain DSNs and passwords. Never echo their raw text.
print(connection_diagnostic(error), file=sys.stderr)
return 1
print("后端 PostgreSQL 连接与认证已通过")
return 0
if __name__ == "__main__":
raise SystemExit(main())
+2
View File
@@ -76,6 +76,8 @@ main() {
check_file docs/harness-audit.md
check_file docs/documentation-coverage-rules.md
check_file planet.sh
check_file scripts/lib/docker-bootstrap.zsh
check_file scripts/harness/test_docker_bootstrap.py
check_file pyproject.toml
check_file frontend/package.json
check_file scripts/harness/security-check.sh
+204
View File
@@ -142,6 +142,12 @@ def iter_frontend_src_files() -> list[Path]:
]
def iter_style_family_css_files() -> list[Path]:
files = sorted((root / "frontend/src").rglob("*.css"))
files.extend(sorted((root / "frontend/public/earth/css").glob("*.css")))
return files
def collect_inline_style_context(lines: list[str], start_index: int) -> str:
block = []
for line in lines[start_index:start_index + 8]:
@@ -255,6 +261,48 @@ def css_has_declaration(body: str, prop: str, value_pattern: str) -> bool:
return re.search(rf"(^|[;\n])\s*{re.escape(prop)}\s*:\s*{value_pattern}\s*;", body) is not None
STYLE_FAMILY_OWNER_FILES = {
"frontend/src/admin/styles.css",
"frontend/src/components/tactile-ui/styles.css",
"frontend/src/pages/Docs/Docs.css",
"frontend/public/earth/css/base.css",
"frontend/public/earth/css/coordinates-display.css",
"frontend/public/earth/css/earth-stats.css",
"frontend/public/earth/css/hud.css",
"frontend/public/earth/css/info-panel.css",
"frontend/public/earth/css/layer-panel.css",
"frontend/public/earth/css/legend.css",
"frontend/public/earth/css/news-panel.css",
"frontend/public/earth/css/toolbar.css",
"frontend/public/earth/css/tv-panel.css",
}
STYLE_FAMILY_PATTERN = re.compile(r"\b(?:badge|chip|pill|tag|status)\b", re.I)
def style_family_selector(selector: str) -> str | None:
for class_name in re.findall(r"\.([A-Za-z][A-Za-z0-9_-]*)", selector):
if STYLE_FAMILY_PATTERN.search(class_name):
return class_name
return None
def check_same_category_style_ownership() -> None:
for path in iter_style_family_css_files():
rel = str(path.relative_to(root))
if rel in STYLE_FAMILY_OWNER_FILES:
continue
text = path.read_text(encoding="utf-8")
for line_no, selector, _body in iter_css_blocks(text):
class_name = style_family_selector(selector)
if class_name is None:
continue
warn(
f"{rel}:{line_no}: same-category {class_name!r} styles should reuse "
"an existing shared style owner instead of introducing a page-local visual variant"
)
def check_admin_shell_height_chain() -> None:
text = read_text("frontend/src/admin/styles.css")
required: dict[str, dict[str, str]] = {
@@ -324,6 +372,160 @@ def check_debug_output() -> None:
fail(f"{rel}:{line_no}: console output must not include token material")
EARTH_RUNTIME_COPY_FILES = (
"frontend/public/earth/js/main.js",
"frontend/public/earth/js/controls.js",
"frontend/public/earth/js/cables.js",
"frontend/public/earth/js/news.js",
"frontend/public/earth/js/tv.js",
"frontend/public/earth/js/info-card.js",
"frontend/public/earth/js/layer-startup-tasks.js",
"frontend/public/earth/js/i18n.js",
)
EARTH_RUNTIME_COPY_ENTRYPOINTS = (
"showStatusMessage",
"queueStatusMessage",
"showGestureStatusMessage",
"showError",
"setLoadingMessage",
"resolveStartupMessage",
)
CJK_PATTERN = re.compile(r"[\u3400-\u9fff]")
def collect_balanced_js(text: str, start_index: int, opener: str, closer: str) -> str:
depth = 0
quote: str | None = None
template_depth = 0
cursor = start_index
while cursor < len(text):
char = text[cursor]
if quote:
if char == "\\":
cursor += 2
continue
if quote == "`" and char == "$" and cursor + 1 < len(text) and text[cursor + 1] == "{":
template_depth += 1
cursor += 2
continue
if template_depth > 0 and char == "}":
template_depth -= 1
cursor += 1
continue
if char == quote and template_depth == 0:
quote = None
cursor += 1
continue
if char in ("'", '"', "`"):
quote = char
elif char == opener:
depth += 1
elif char == closer:
depth -= 1
if depth == 0:
return text[start_index:cursor + 1]
cursor += 1
return text[start_index:]
def collect_js_call(text: str, start_index: int) -> str:
open_index = text.find("(", start_index)
if open_index == -1:
return text[start_index:]
return collect_balanced_js(text, open_index, "(", ")")
def collect_js_value(text: str, start_index: int) -> str:
cursor = start_index
while cursor < len(text) and text[cursor].isspace():
cursor += 1
if cursor >= len(text):
return ""
char = text[cursor]
if char == "{":
return collect_balanced_js(text, cursor, "{", "}")
if char == "[":
return collect_balanced_js(text, cursor, "[", "]")
if text.startswith("earthMessage", cursor):
open_index = text.find("(", cursor)
if open_index == -1:
return text[cursor:]
return text[cursor:open_index] + collect_balanced_js(text, open_index, "(", ")")
if char in ("'", '"', "`"):
quote = char
cursor += 1
while cursor < len(text):
if text[cursor] == "\\":
cursor += 2
continue
if text[cursor] == quote:
return text[start_index:cursor + 1]
cursor += 1
return text[start_index:]
end_candidates = [
index for index in (text.find(",", cursor), text.find("\n", cursor)) if index != -1
]
end_index = min(end_candidates) if end_candidates else len(text)
return text[start_index:end_index]
def check_earth_runtime_copy_entrypoints() -> None:
i18n_text = read_text("frontend/public/earth/js/i18n.js")
for token in ("EARTH_MESSAGE_TEMPLATES", "export function earthMessage", "export function formatEarthMessage"):
if token not in i18n_text:
fail(f"frontend/public/earth/js/i18n.js: missing centralized Earth runtime copy token {token}")
direct_literal_pattern = re.compile(r"^\(\s*['\"`]")
for file_path in EARTH_RUNTIME_COPY_FILES:
text = read_text(file_path)
for entrypoint in EARTH_RUNTIME_COPY_ENTRYPOINTS:
pattern = re.compile(rf"\b{re.escape(entrypoint)}\s*\(")
for match in pattern.finditer(text):
call = collect_js_call(text, match.start())
if direct_literal_pattern.search(call):
fail(
f"{file_path}:{jsx_line_number(text, match.start())}: "
f"Earth runtime copy entrypoint {entrypoint} must use earthMessage(...), not a direct string literal"
)
if CJK_PATTERN.search(call) and "earthMessage(" not in call:
fail(
f"{file_path}:{jsx_line_number(text, match.start())}: "
f"Earth runtime copy entrypoint {entrypoint} contains CJK without earthMessage(...)"
)
for match in re.finditer(r"\bstartupMessage\s*:\s*", text):
value = collect_js_value(text, match.end()).strip()
if value in {'""', "''", "``"}:
continue
if "earthMessage(" not in value:
fail(
f"{file_path}:{jsx_line_number(text, match.start())}: "
"Earth layer startupMessage must use earthMessage(...) so startup copy has one i18n entrypoint"
)
elif CJK_PATTERN.search(value) and "earthMessage(" not in value:
fail(
f"{file_path}:{jsx_line_number(text, match.start())}: "
"Earth layer startupMessage contains CJK outside the centralized runtime copy map"
)
for match in re.finditer(r"new\s+CustomEvent\(\s*['\"]earth:status['\"]", text):
call = collect_js_call(text, match.start())
if re.search(r"\bmessage\s*:\s*['\"`]", call):
fail(
f"{file_path}:{jsx_line_number(text, match.start())}: "
"earth:status event messages must use earthMessage(...) instead of direct strings"
)
if CJK_PATTERN.search(call) and "earthMessage(" not in call:
fail(
f"{file_path}:{jsx_line_number(text, match.start())}: "
"earth:status event contains CJK without earthMessage(...)"
)
def jsx_line_number(text: str, index: int) -> int:
return text.count("\n", 0, index) + 1
@@ -512,12 +714,14 @@ def main() -> None:
check_literal_internal_links()
check_admin_search_route_targets()
check_debug_output()
check_earth_runtime_copy_entrypoints()
check_native_button_safety()
check_icon_button_accessibility()
check_no_nested_cards()
check_no_antd_layout_primitives()
check_connection_test_input_pattern()
check_admin_shell_height_chain()
check_same_category_style_ownership()
check_uiux_static_warnings()
for message in warnings:
+712 -11
View File
@@ -22,6 +22,15 @@ const publicRoutes = [
{ path: '/docs/manual', text: '智能星球使用手册' },
{ path: '/docs/quickstart', text: '快速开始' },
]
const publicEnglishI18nRoutes = [
'/login',
'/register',
'/verify-email',
'/forgot-password',
'/docs',
'/docs/manual',
'/docs/quickstart',
]
const desktopViewport = { width: 1440, height: 900 }
const mobileViewport = { width: 390, height: 844 }
@@ -39,9 +48,13 @@ const interactionChecks = [
'logs raw tab',
'users add dialog',
'data distribution toggle',
'earth i18n settings',
'earth news source test',
'earth news source draft cancel',
'earth news group create',
'public english i18n sweep',
'english login backend error i18n',
'admin english i18n sweep',
'authenticated unknown route fallback',
]
const authInteractionChecks = [
@@ -49,6 +62,22 @@ const authInteractionChecks = [
'forgot password reset',
'standalone verify email',
]
const adminEnglishI18nRoutes = [
'/admin',
'/data',
'/datasources',
'/bgp',
'/alerts/system',
'/alerts/bgp',
'/alerts/situational',
'/ai',
'/earth-content',
'/collection-management',
'/logs',
'/users',
'/settings',
]
const adminEnglishAllowedCjkText = ['中文']
function readRepoText(relativePath) {
return readFileSync(new URL(`../../${relativePath}`, import.meta.url), 'utf8')
@@ -381,6 +410,26 @@ async function clickFirstVisible(locator, label) {
await item.click()
}
async function ensureAdminPreferencesOpen(page, label) {
const drawer = page.locator('.admin__preferences-drawer.is-open').first()
if (await drawer.isVisible().catch(() => false)) return
const toggle = await firstVisible(page.locator('.admin__account-preferences'), label)
await toggle.click()
await page.locator('.admin__preferences-drawer.is-open').waitFor({ state: 'visible', timeout: 5000 })
}
async function getEarthFrame(page, label) {
const iframe = page.locator('iframe[title="3D Earth"]')
await iframe.waitFor({ state: 'visible', timeout: 10000 })
const handle = await iframe.elementHandle()
const frame = await handle?.contentFrame()
if (!frame) {
throw new Error(`${label}: Earth iframe did not expose a content frame`)
}
return frame
}
async function firstVisible(locator, label, timeoutMs = 10000) {
const item = await firstVisibleOrNull(locator, timeoutMs)
if (item) return item
@@ -448,7 +497,13 @@ async function expectUrl(page, route, predicate) {
}
async function checkNoFrameworkOverlay(page, route) {
const bodyText = await page.locator('body').innerText({ timeout: 5000 }).catch(() => '')
let bodyText = await page.locator('body').innerText({ timeout: 5000 }).catch(() => '')
if (!bodyText.trim() && !(await page.locator('iframe').count())) {
await page.waitForFunction(() => (
Boolean(document.body?.innerText?.trim()) || document.querySelectorAll('iframe').length > 0
), null, { timeout: 3000 }).catch(() => {})
bodyText = await page.locator('body').innerText({ timeout: 5000 }).catch(() => '')
}
const overlayNeedles = [
'Internal server error',
'Failed to resolve import',
@@ -487,6 +542,70 @@ async function checkNoGlobalHorizontalOverflow(page, route) {
}
}
async function checkNoUnexpectedEnglishCjk(page, route) {
const result = await page.evaluate((allowed) => {
const allowedText = new Set(allowed)
const cjk = /[\u3400-\u9fff]/
const ignoredSelector = [
'script',
'style',
'code',
'pre',
'svg',
'textarea',
'.an-json-viewer',
'.an-log-output',
'.an-detail-json',
'.an-data-json',
].join(', ')
const root = document.querySelector('.admin-theme-root') || document.body
const textNodes = []
const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, {
acceptNode(node) {
const parent = node.parentElement
if (!parent || parent.closest(ignoredSelector)) return NodeFilter.FILTER_REJECT
const text = (node.textContent || '').replace(/\s+/g, ' ').trim()
if (!text || allowedText.has(text) || !cjk.test(text)) return NodeFilter.FILTER_REJECT
return NodeFilter.FILTER_ACCEPT
},
})
while (walker.nextNode()) {
const node = walker.currentNode
const parent = node.parentElement
textNodes.push({
text: (node.textContent || '').replace(/\s+/g, ' ').trim(),
tag: parent?.tagName || '',
className: typeof parent?.className === 'string' ? parent.className : '',
})
}
const attributes = []
root.querySelectorAll('*').forEach((element) => {
if (element.closest(ignoredSelector)) return
for (const attributeName of ['aria-label', 'placeholder', 'title']) {
const value = element.getAttribute(attributeName)
if (value && !allowedText.has(value) && cjk.test(value)) {
attributes.push({
attr: attributeName,
value,
tag: element.tagName,
className: typeof element.className === 'string' ? element.className : '',
})
}
}
})
return {
textNodes: textNodes.slice(0, 20),
attributes: attributes.slice(0, 20),
}
}, adminEnglishAllowedCjkText)
if (result.textNodes.length || result.attributes.length) {
throw new Error(`${route}: English UI contains unexpected Chinese text ${JSON.stringify(result)}`)
}
}
async function checkAdminShellOneScreen(page, route, options = {}) {
const { expectAccountVisible = false, expectPreferencesVisible = false } = options
const layout = await page.evaluate(() => {
@@ -785,7 +904,81 @@ function apiPayloadFor(requestUrl, method) {
if (path === '/earth/boundaries/status') return jsonResponse({ status: 'ready', provider: 'low', updated_at: now })
if (path === '/earth/boundaries/build/status') return jsonResponse({ status: 'idle', progress: 0 })
if (path === '/settings/tv') return jsonResponse({ tv: { default_source_id: 'smoke-tv', sources: [{ id: 'smoke-tv', name: 'Smoke TV', source_type: 'hls', stream_url: 'https://example.invalid/live.m3u8', is_enabled: true, sort_order: 10 }] } })
if (path === '/tv/streams') return jsonResponse({ sources: [] })
if (path === '/tv/streams') return jsonResponse({
generated_at: now,
latest_updated_at: now,
source_count: 1,
default_source_id: 'cctv-news',
selected_source: { id: 'cctv-news' },
sources: [{
id: 'cctv-news',
name: '央视新闻',
provider: '中国媒体',
region: '中国',
language: '中文',
source_type: 'external',
homepage_url: 'https://example.invalid/live',
notes: '默认直播源',
is_enabled: true,
sort_order: 10,
}],
})
if (path === '/news/earth-feed') return jsonResponse({
generated_at: now,
focus: { lat: 0, lon: 0, region: 'global', label: 'Global Focus', display_region: 'Global' },
filters: { locale: url.searchParams.get('locale') || 'zh-CN', categories: [], sources: [], limit: 12 },
sources: [
{ id: 'bbc-world', name: 'BBC World', region: 'global', homepage_url: 'https://www.bbc.com/news', source_type: 'rss', enabled: true },
{ id: '36kr', name: '36氪', region: 'asia-pacific', homepage_url: 'https://www.36kr.com/', source_type: 'rss', enabled: true },
],
items: [
{
id: 'bbc-world:smoke-english',
source_id: 'bbc-world',
title: 'Global trade ministers agree on supply-chain safeguards',
summary: 'Officials said the plan focuses on resilient logistics and energy infrastructure.',
content_language: 'en',
localizations: {},
display_title: 'Global trade ministers agree on supply-chain safeguards',
display_summary: 'Officials said the plan focuses on resilient logistics and energy infrastructure.',
url: 'https://example.invalid/news',
source: 'BBC World',
feed_name: 'BBC World',
source_type: 'rss',
category: 'business',
region: 'global',
display_region: 'Global',
published_at: now,
latitude: 0,
longitude: 0,
enrichment_status: 'success',
},
{
id: '36kr:smoke-chinese',
source_id: '36kr',
title: '中国电商平台发布季度增长数据',
summary: '平台表示,跨境电商订单量同比增长。',
content_language: 'zh-CN',
localizations: { 'zh-CN': { title: '中国电商平台发布季度增长数据', summary: '平台表示,跨境电商订单量同比增长。' } },
display_title: '',
display_summary: '',
url: 'https://example.invalid/zh-news',
source: '36氪',
feed_name: '综合资讯',
source_type: 'rss',
category: 'business',
region: 'asia-pacific',
display_region: '亚太',
published_at: now,
latitude: 31,
longitude: 121,
enrichment_status: 'queued',
},
],
cruise_items: [],
errors: [],
stale: false,
})
if (path === '/earth/news-sources') return jsonResponse({
is_default: true,
sources: [
@@ -964,7 +1157,7 @@ async function runAdminInteractionChecks(browser, failures, consoleErrors) {
await expectVisibleText(page, 'SMTP 邮件', 'global search smtp')
await page.goto(urlFor('/admin'), { waitUntil: 'domcontentloaded' })
await clickFirstVisible(page.getByRole('button', { name: '展开偏好设置' }), 'admin preferences drawer open')
await ensureAdminPreferencesOpen(page, 'admin preferences drawer open')
await page.waitForTimeout(350)
await checkAdminShellOneScreen(page, 'admin preferences drawer open', {
expectAccountVisible: true,
@@ -981,10 +1174,17 @@ async function runAdminInteractionChecks(browser, failures, consoleErrors) {
location.pathname === '/settings' && location.search.includes('section=smtp')
))
await expectVisibleText(page, 'SMTP Email', 'admin english global search smtp')
const reopenEnglishPreferences = await firstVisibleOrNull(page.getByRole('button', { name: 'Expand preferences' }), 500)
if (reopenEnglishPreferences) {
await reopenEnglishPreferences.click()
smokeProgress('admin english i18n sweep')
for (const route of adminEnglishI18nRoutes) {
const label = `admin english i18n ${route}`
smokeProgress(label, 'verbose')
await page.goto(urlFor(route), { waitUntil: 'domcontentloaded' })
await page.waitForTimeout(450)
await checkNoFrameworkOverlay(page, label)
await checkNoUnexpectedEnglishCjk(page, label)
}
await page.goto(urlFor('/settings?section=smtp'), { waitUntil: 'domcontentloaded' })
await ensureAdminPreferencesOpen(page, 'admin preferences drawer reopen')
await clickFirstVisible(
page.getByRole('group', { name: 'Console language' }).getByRole('button', { name: '中文' }),
'admin language switch chinese',
@@ -1009,15 +1209,23 @@ async function runAdminInteractionChecks(browser, failures, consoleErrors) {
await expectVisibleText(page, 'SMTP 邮件', 'section tab settings smtp')
await page.goto(urlFor('/ai?section=integrations'), { waitUntil: 'domcontentloaded' })
await clickFirstVisible(page.getByRole('button', { name: '测试 AI Provider 连通性' }), 'connection test input ai provider')
await expectVisibleText(page, 'LLM 基础地址', 'connection test input ai provider')
await clickFirstVisible(page.locator('.an-connection-test-input button'), 'connection test input ai provider')
await expectVisibleText(page, 'AI Provider连通性正常', 'connection test input ai provider')
await page.goto(urlFor('/ai?section=tools'), { waitUntil: 'domcontentloaded' })
await clickFirstVisible(page.getByRole('button', { name: /tavily/i }), 'connection test input websearch provider')
await clickFirstVisible(page.getByRole('switch', { name: '停用 WebSearch' }), 'connection test input websearch switch')
await expectVisibleText(page, 'WebSearch 已在草稿中停用', 'connection test input websearch disabled')
const webSearchEnabledInput = page.locator('[data-admin-search-field="enabled"] input[type="checkbox"]')
await firstVisible(webSearchEnabledInput, 'connection test input websearch switch')
if (await webSearchEnabledInput.first().isChecked()) {
await webSearchEnabledInput.first().click()
}
await page.waitForFunction(() => {
const input = document.querySelector('[data-admin-search-field="enabled"] input[type="checkbox"]')
return input instanceof HTMLInputElement && !input.checked
}, null, { timeout: 5000 })
await expectFirstVisibleDisabled(page.getByLabel('API 基础地址'), 'connection test input websearch base url')
await expectFirstVisibleDisabled(page.getByRole('button', { name: '测试 Web Search 连通性' }), 'connection test input websearch action')
await expectFirstVisibleDisabled(page.locator('.an-connection-test-input button'), 'connection test input websearch action')
await page.goto(urlFor('/logs'), { waitUntil: 'domcontentloaded' })
await clickFirstVisible(page.getByRole('tab', { name: /原始日志/ }), 'logs raw tab')
@@ -1259,16 +1467,487 @@ async function main() {
}
}
try {
smokeProgress('public english i18n sweep')
await page.goto(urlFor('/login'), { waitUntil: 'domcontentloaded' })
await page.evaluate(() => {
localStorage.setItem('planet-locale', 'en-US')
localStorage.setItem('docs-lang', 'en')
})
for (const route of publicEnglishI18nRoutes) {
const label = `public english i18n ${route}`
smokeProgress(label, 'verbose')
await page.goto(urlFor(route), { waitUntil: 'domcontentloaded' })
await page.waitForTimeout(450)
await checkNoFrameworkOverlay(page, label)
await checkNoUnexpectedEnglishCjk(page, label)
}
await page.evaluate(() => {
localStorage.setItem('planet-locale', 'zh-CN')
localStorage.setItem('docs-lang', 'zh')
})
} catch (error) {
failures.push(error instanceof Error ? error.message : String(error))
}
try {
smokeProgress('earth public route')
await page.evaluate(() => {
localStorage.setItem('planet-locale', 'en-US')
localStorage.setItem('docs-lang', 'en')
})
await page.goto(urlFor('/earth'), { waitUntil: 'domcontentloaded' })
await checkNoFrameworkOverlay(page, '/earth')
await page.locator('iframe[title="3D Earth"]').waitFor({ state: 'visible', timeout: 10000 })
const earthFrame = await getEarthFrame(page, '/earth')
await earthFrame.waitForFunction(() => document.documentElement.lang === 'en-US', null, { timeout: 10000 })
await earthFrame.waitForFunction(() => (
document.querySelector('.earth-brand__title')?.getAttribute('src')?.includes('title-en.png')
), null, { timeout: 10000 })
const brandState = await earthFrame.evaluate(() => {
const brand = document.querySelector('#brand-panel .earth-brand')
const panel = document.getElementById('brand-panel')
const title = document.querySelector('.earth-brand__title')
const subtitle = document.querySelector('.earth-brand__subtitle')
const description = document.querySelector('.earth-brand__description')
if (
!(brand instanceof HTMLElement)
|| !(panel instanceof HTMLElement)
|| !(title instanceof HTMLImageElement)
|| !(subtitle instanceof HTMLElement)
|| !(description instanceof HTMLElement)
) return null
const brandRect = brand.getBoundingClientRect()
const panelRect = panel.getBoundingClientRect()
const titleRect = title.getBoundingClientRect()
const subtitleRect = subtitle.getBoundingClientRect()
const descriptionRect = description.getBoundingClientRect()
return {
brandWidth: brandRect.width,
panelWidth: panelRect.width,
titleWidth: titleRect.width,
titleRight: titleRect.right,
brandRight: brandRect.right,
panelRight: panelRect.right,
subtitleText: subtitle.innerText,
descriptionText: description.innerText,
subtitleRight: subtitleRect.right,
descriptionRight: descriptionRect.right,
viewportWidth: window.innerWidth,
}
})
if (
!brandState
|| brandState.brandWidth > 285
|| brandState.panelWidth > 290
|| brandState.titleWidth < 110
|| brandState.titleRight > brandState.panelRight + 1
|| brandState.brandRight > brandState.panelRight + 1
|| brandState.subtitleRight > brandState.panelRight + 1
|| brandState.descriptionRight > brandState.panelRight + 1
|| !brandState.subtitleText
|| !brandState.descriptionText
|| /[\u4e00-\u9fff]/.test(`${brandState.subtitleText}\n${brandState.descriptionText}`)
|| brandState.brandRight > brandState.viewportWidth - 8
) {
throw new Error(`/earth i18n settings: English brand text is clipped or oversized ${JSON.stringify(brandState)}`)
}
await earthFrame.evaluate(() => document.getElementById('settings-trigger')?.click())
await earthFrame.waitForTimeout(350)
await earthFrame.evaluate(() => (
document.querySelector('.earth-settings-tabs [data-settings-tab="system"]')?.click()
))
await earthFrame.waitForFunction(() => (
!document.querySelector('.earth-settings-sheet [data-settings-tab-panel="system"]')?.hidden
), null, { timeout: 5000 })
const systemText = await earthFrame.evaluate(() => (
document.querySelector('.earth-settings-sheet [data-settings-tab-panel="system"]')?.innerText || ''
))
if (!systemText.includes('Earth Language')) {
throw new Error('/earth i18n settings: expected English language control')
}
const localeSegmentInitial = await earthFrame.evaluate(() => {
const segmented = document.querySelector('.earth-settings-sheet [data-settings-tab-panel="system"] .earth-settings-segmented')
const english = segmented?.querySelector('[data-earth-locale="en-US"]')
const chinese = segmented?.querySelector('[data-earth-locale="zh-CN"]')
if (!(segmented instanceof HTMLElement) || !(english instanceof HTMLButtonElement) || !(chinese instanceof HTMLButtonElement)) return null
return {
englishActive: english.classList.contains('is-active'),
chineseActive: chinese.classList.contains('is-active'),
activeIndex: getComputedStyle(segmented).getPropertyValue('--active-index').trim(),
itemCount: getComputedStyle(segmented).getPropertyValue('--item-count').trim(),
}
})
if (
!localeSegmentInitial?.englishActive
|| localeSegmentInitial.chineseActive
|| localeSegmentInitial.activeIndex !== '1'
|| localeSegmentInitial.itemCount !== '2'
) {
throw new Error(`/earth i18n settings: English language segmented control is not visually active ${JSON.stringify(localeSegmentInitial)}`)
}
await earthFrame.evaluate(() => document.querySelector('.earth-settings-sheet [data-earth-locale="zh-CN"]')?.click())
await earthFrame.waitForFunction(() => {
const segmented = document.querySelector('.earth-settings-sheet [data-settings-tab-panel="system"] .earth-settings-segmented')
const english = segmented?.querySelector('[data-earth-locale="en-US"]')
const chinese = segmented?.querySelector('[data-earth-locale="zh-CN"]')
return (
document.documentElement.lang === 'zh-CN'
&& segmented instanceof HTMLElement
&& english instanceof HTMLButtonElement
&& chinese instanceof HTMLButtonElement
&& chinese.classList.contains('is-active')
&& !english.classList.contains('is-active')
&& getComputedStyle(segmented).getPropertyValue('--active-index').trim() === '0'
)
}, null, { timeout: 5000 })
const zhSystemText = await earthFrame.evaluate(() => (
document.querySelector('.earth-settings-sheet [data-settings-tab-panel="system"]')?.innerText || ''
))
if (!zhSystemText.includes('星球语言')) {
throw new Error('/earth i18n settings: expected Chinese language control after switching locale')
}
await earthFrame.evaluate(() => document.querySelector('.earth-settings-sheet [data-earth-locale="en-US"]')?.click())
await earthFrame.waitForFunction(() => {
const segmented = document.querySelector('.earth-settings-sheet [data-settings-tab-panel="system"] .earth-settings-segmented')
const english = segmented?.querySelector('[data-earth-locale="en-US"]')
const chinese = segmented?.querySelector('[data-earth-locale="zh-CN"]')
return (
document.documentElement.lang === 'en-US'
&& localStorage.getItem('planet-locale') === 'en-US'
&& localStorage.getItem('docs-lang') === 'en'
&& segmented instanceof HTMLElement
&& english instanceof HTMLButtonElement
&& chinese instanceof HTMLButtonElement
&& english.classList.contains('is-active')
&& !chinese.classList.contains('is-active')
&& getComputedStyle(segmented).getPropertyValue('--active-index').trim() === '1'
)
}, null, { timeout: 5000 })
const hdTextureStatus = await earthFrame.evaluate(async () => {
const { earthMessage, formatEarthMessage } = await import('/earth/js/i18n.js?frontend_smoke_i18n')
const ui = await import('/earth/js/ui.js?frontend_smoke_i18n')
const message = earthMessage('startup.hdTexture')
const translated = formatEarthMessage(message, 'en-US')
ui.setLoading(true)
ui.setLoadingMessage(message)
return {
translated,
rendered: document.querySelector('#status-message .earth-status-text')?.textContent || '',
}
})
if (
/[\u4e00-\u9fff]/.test(`${hdTextureStatus.translated}\n${hdTextureStatus.rendered}`)
|| !hdTextureStatus.translated.includes('Enabling HD texture')
|| !hdTextureStatus.rendered.includes('Enabling HD texture')
) {
throw new Error(`/earth i18n settings: HD texture loading status is not translated: ${JSON.stringify(hdTextureStatus)}`)
}
const earthEnglishCjkAudit = await earthFrame.evaluate(() => {
const cjk = /[\u4e00-\u9fff]/
const allowed = new Set(['中文'])
const skip = 'script,style,svg,canvas,video,iframe,.material-symbols-rounded'
const isVisible = (element) => {
if (!(element instanceof HTMLElement)) return false
if (element.matches(skip) || element.closest(skip)) return false
const style = getComputedStyle(element)
if (style.visibility === 'hidden' || style.display === 'none' || Number(style.opacity) === 0) return false
const rect = element.getBoundingClientRect()
return rect.width > 0 && rect.height > 0
}
const textHits = []
const attrHits = []
document.querySelectorAll('body *').forEach((element) => {
if (!isVisible(element)) return
const ownText = Array.from(element.childNodes)
.filter((node) => node.nodeType === Node.TEXT_NODE)
.map((node) => node.textContent || '')
.join(' ')
.replace(/\s+/g, ' ')
.trim()
if (ownText && cjk.test(ownText) && !allowed.has(ownText)) {
textHits.push({
selector: element.id ? `#${element.id}` : String(element.className || element.tagName.toLowerCase()),
text: ownText,
})
}
;['title', 'aria-label', 'placeholder', 'alt'].forEach((attr) => {
const value = element.getAttribute(attr)
if (value && cjk.test(value) && !allowed.has(value)) {
attrHits.push({
selector: element.id ? `#${element.id}` : String(element.className || element.tagName.toLowerCase()),
attr,
value,
})
}
})
})
return {
textHits: textHits.slice(0, 20),
attrHits: attrHits.slice(0, 20),
}
})
if (earthEnglishCjkAudit.textHits.length || earthEnglishCjkAudit.attrHits.length) {
throw new Error(`/earth i18n settings: English UI still has visible CJK ${JSON.stringify(earthEnglishCjkAudit)}`)
}
await earthFrame.evaluate(() => (
document.querySelector('.earth-settings-tabs [data-settings-tab="panels"]')?.click()
))
await earthFrame.waitForFunction(() => (
!document.querySelector('.earth-settings-sheet [data-settings-tab-panel="panels"]')?.hidden
), null, { timeout: 5000 })
const switchState = await earthFrame.evaluate(() => {
const label = document.querySelector('label[for="toggle-view-legend"]')
const input = document.getElementById('toggle-view-legend')
if (!(label instanceof HTMLElement) || !(input instanceof HTMLInputElement)) return null
const before = input.checked
label.click()
const shell = input.closest('.earth-settings-switch')
return {
before,
checked: input.checked,
visualChecked: shell?.classList.contains('is-checked') === true,
}
})
if (
!switchState
|| switchState.checked === switchState.before
|| switchState.visualChecked !== switchState.checked
) {
throw new Error('/earth i18n settings: system switch visual state did not follow checked state')
}
await earthFrame.evaluate(() => {
const label = document.querySelector('label[for="toggle-view-legend"]')
const input = document.getElementById('toggle-view-legend')
if (input instanceof HTMLInputElement && !input.checked && label instanceof HTMLElement) {
label.click()
}
})
await earthFrame.waitForFunction(() => (
!document.getElementById('legend')?.classList.contains('hud-panel-hidden')
), null, { timeout: 5000 })
const legendState = await earthFrame.evaluate(async () => {
const legend = await import('/earth/js/legend.js')
legend.setLegendItems('satellites', [
{ color: '#ff3333', label: '赤道轨道(0-30°)' },
{ color: '#ff9933', label: '低倾角轨道(30-60°)' },
{ color: '#ffff33', label: '中倾角轨道(60-90°)' },
{ color: '#33ff33', label: '高倾角轨道(90-120°)' },
{ color: '#3333ff', label: '逆行轨道(120-180°)' },
{ color: '#5eead4', label: '低轨' },
{ color: '#93c5fd', label: '中轨' },
{ color: '#c4b5fd', label: '高轨' },
{ color: '#f9a8d4', label: '地球静止轨道' },
{ color: '#fcd34d', label: '太阳同步轨道' },
{ color: '#e5e7eb', label: '极轨' },
])
legend.setLegendMode('satellites')
const panel = document.getElementById('legend')
const panelRect = panel?.getBoundingClientRect()
const currentLabel = document.getElementById('legend-current-label')
const labels = Array.from(document.querySelectorAll('#legend-current-label, #legend .legend-label'))
const mobileLabels = Array.from(document.querySelectorAll('#mobile-situation-legend-mode, #mobile-situation-legend-list .legend-label'))
const text = labels.concat(mobileLabels)
.map((element) => `${element.textContent || ''}\n${element.getAttribute('title') || ''}`)
.join('\n')
const overflows = labels
.map((element) => {
const rect = element.getBoundingClientRect()
if (!panelRect) return null
const overflow = rect.left < panelRect.left - 1 || rect.right > panelRect.right + 1
return overflow ? {
text: element.textContent,
left: rect.left,
right: rect.right,
panelLeft: panelRect.left,
panelRight: panelRect.right,
} : null
})
.filter(Boolean)
return {
text,
overflows,
currentText: currentLabel?.textContent || '',
currentTitle: currentLabel?.getAttribute('title') || '',
}
})
if (/[\u4e00-\u9fff]/.test(legendState.text)) {
throw new Error('/earth i18n settings: English satellite legend contains Chinese text')
}
if (!legendState.text.includes('Orbits')) {
throw new Error('/earth i18n settings: English satellite legend should use compact Orbits label')
}
if (!legendState.text.includes('Low Incl.') || !legendState.text.includes('High Incl.') || !legendState.text.includes('Retrograde')) {
throw new Error(`/earth i18n settings: English satellite legend missing translated orbit labels ${JSON.stringify(legendState)}`)
}
for (const compactOrbitLabel of ['LEO', 'MEO', 'HEO', 'GEO', 'SSO', 'Polar']) {
if (!legendState.text.includes(compactOrbitLabel)) {
throw new Error(`/earth i18n settings: English satellite legend missing compact orbit label ${compactOrbitLabel} ${JSON.stringify(legendState)}`)
}
}
if (legendState.currentText !== legendState.currentTitle) {
throw new Error(`/earth i18n settings: legend current title mismatch ${JSON.stringify(legendState)}`)
}
if (legendState.overflows.length > 0) {
throw new Error(`/earth i18n settings: legend labels overflow panel ${JSON.stringify(legendState.overflows)}`)
}
const earthDynamicTranslations = await earthFrame.evaluate(async () => {
const i18n = await import('/earth/js/i18n.js')
return {
satelliteShown: i18n.translateText('卫星已显示', 'en-US'),
cruisePaused: i18n.translateText('巡航已暂停', 'en-US'),
locatedCompute: i18n.translateText('已定位算力中心:Smoke Node', 'en-US'),
loadingCables: i18n.translateText('正在加载线缆数据...', 'en-US'),
}
})
if (
earthDynamicTranslations.satelliteShown !== 'Satellites shown'
|| earthDynamicTranslations.cruisePaused !== 'Cruise paused'
|| earthDynamicTranslations.locatedCompute !== 'Located compute centers: Smoke Node'
|| earthDynamicTranslations.loadingCables !== 'Loading cable data...'
) {
throw new Error(`/earth i18n settings: dynamic status translations regressed ${JSON.stringify(earthDynamicTranslations)}`)
}
const earthNotificationState = await earthFrame.evaluate(async () => {
const ui = await import('/earth/js/ui.js')
ui.setLoading(false)
ui.showStatusMessage('成功加载 12 条电缆', 'success')
await new Promise((resolve) => window.setTimeout(resolve, 360))
const status = document.getElementById('status-message')
const brand = document.getElementById('brand-panel')
const ticker = document.getElementById('desktop-news-ticker')
const rect = status?.getBoundingClientRect()
const brandRect = brand?.getBoundingClientRect()
const tickerRect = ticker?.getBoundingClientRect()
return {
text: status?.innerText || '',
visible: status?.classList.contains('visible') === true,
left: rect?.left || 0,
top: rect?.top || 0,
brandRight: brandRect?.right || 0,
tickerBottom: tickerRect?.bottom || 0,
width: rect?.width || 0,
maxWidth: status instanceof HTMLElement ? getComputedStyle(status).maxWidth : '',
}
})
if (
/[\u4e00-\u9fff]/.test(earthNotificationState.text)
|| !earthNotificationState.text.includes('Loaded 12 cables')
|| !earthNotificationState.visible
|| earthNotificationState.left < earthNotificationState.brandRight + 8
|| earthNotificationState.left > earthNotificationState.brandRight + 28
|| earthNotificationState.top < earthNotificationState.tickerBottom + 2
|| earthNotificationState.width < 120
|| earthNotificationState.width > 240
) {
throw new Error(`/earth i18n settings: English notification text or width regressed ${JSON.stringify(earthNotificationState)}`)
}
const earthTooltipState = await earthFrame.evaluate(async () => {
const i18n = await import('/earth/js/i18n.js')
const ui = await import('/earth/js/ui.js')
const countryName = i18n.localizeCountryName({ name: 'China', nameZh: '中国', continent: 'Asia' }, 'en-US')
const content = [
`<strong>${countryName}</strong>`,
`ISO: CHN`,
`${i18n.translateText('大洲', 'en-US')}: ${i18n.translateText('亚洲', 'en-US')}`,
`${i18n.translateText('纬度', 'en-US')}: 31.2300°`,
`${i18n.translateText('经度', 'en-US')}: 121.4700°`,
`${i18n.translateText('海拔', 'en-US')}: 8 m`,
`${i18n.translateText('country', 'en-US')}: ${i18n.localizeCountryName('中国', 'en-US')}`,
].join('<br>')
ui.showTooltip(180, 180, content)
await new Promise((resolve) => requestAnimationFrame(resolve))
const tooltip = document.getElementById('tooltip')
const rect = tooltip?.getBoundingClientRect()
return {
text: tooltip?.innerText || '',
display: tooltip instanceof HTMLElement ? getComputedStyle(tooltip).display : '',
width: rect?.width || 0,
}
})
if (
/[\u4e00-\u9fff]/.test(earthTooltipState.text)
|| !earthTooltipState.text.includes('China')
|| !earthTooltipState.text.includes('Continent: Asia')
|| !earthTooltipState.text.includes('Latitude')
|| !earthTooltipState.text.includes('Longitude')
|| !earthTooltipState.text.includes('Altitude')
|| !earthTooltipState.text.includes('Country: China')
) {
throw new Error(`/earth i18n settings: English tooltip translation regressed ${JSON.stringify(earthTooltipState)}`)
}
await earthFrame.evaluate(() => document.getElementById('settings-close')?.click())
await earthFrame.waitForFunction(() => (
document.getElementById('news-ticker-track')?.innerText.includes('Officials said')
), null, { timeout: 10000 })
await earthFrame.evaluate(() => document.getElementById('desktop-news-ticker')?.click())
await earthFrame.waitForFunction(() => (
!document.getElementById('news-hud-panel')?.classList.contains('hud-panel-hidden')
), null, { timeout: 5000 })
const newsHudText = await earthFrame.evaluate(() => (
document.getElementById('news-hud-panel')?.innerText || ''
))
if (/[\u4e00-\u9fff]/.test(newsHudText)) {
throw new Error('/earth i18n settings: English news panel contains Chinese text')
}
const detailCardText = await earthFrame.evaluate(async () => {
const card = await import('/earth/js/info-card.js')
card.showInfoCard('satellite', {
name: 'SmokeSat',
norad_id: '12345',
constellation: 'Smoke',
footprint_capability: '支持 Starlink 地表覆盖',
current_display: '真实地表覆盖(Starlink)',
footprint_model: 'Starlink 单星地表覆盖',
inclination: '53.00',
period: '90.0',
perigee: '550',
apogee: '560',
field_sources: { current_display: 'smoke' },
}, { x: 460, y: 180, absolute: true })
await new Promise((resolve) => requestAnimationFrame(resolve))
const panel = document.getElementById('info-panel')
const titleText = Array.from(panel?.querySelectorAll('[title]') || [])
.map((element) => element.getAttribute('title') || '')
.join('\\n')
return [panel?.innerText || '', titleText].join('\\n')
})
if (/[\u4e00-\u9fff]/.test(detailCardText)) {
throw new Error('/earth i18n settings: English detail card contains Chinese text')
}
await earthFrame.evaluate(async () => {
const tv = await import('/earth/js/tv.js')
await tv.ensureTVPanelReady()
})
await earthFrame.waitForFunction(() => (
document.getElementById('tv-source-title')?.innerText.includes('Cctv News')
), null, { timeout: 5000 })
const tvText = await earthFrame.evaluate(() => [
document.getElementById('tv-source-title')?.innerText || '',
document.getElementById('tv-source-origin')?.innerText || '',
document.getElementById('tv-source-status')?.innerText || '',
document.getElementById('tv-source-catalog')?.innerText || '',
document.getElementById('tv-source-notes')?.innerText || '',
Array.from(document.querySelectorAll('#tv-source-select option')).map((option) => option.textContent || '').join(' '),
].join('\n'))
if (!tvText.includes('Default') || !tvText.includes('Built-in')) {
throw new Error('/earth i18n settings: English TV panel is missing localized default/built-in labels')
}
if (/[\u4e00-\u9fff]/.test(tvText)) {
throw new Error('/earth i18n settings: English TV panel contains Chinese text')
}
await page.evaluate(() => {
localStorage.setItem('planet-locale', 'zh-CN')
localStorage.setItem('docs-lang', 'zh')
})
} catch (error) {
failures.push(error instanceof Error ? error.message : String(error))
}
smokeProgress('protected route guards')
await page.evaluate(() => {
localStorage.setItem('planet-locale', 'zh-CN')
localStorage.setItem('docs-lang', 'zh')
}).catch(() => {})
for (const route of adminRoutes) {
try {
smokeProgress(`guard ${route}`, 'verbose')
@@ -1292,6 +1971,28 @@ async function main() {
failures.push(error instanceof Error ? error.message : String(error))
}
try {
smokeProgress('english login backend error i18n')
await page.goto(urlFor('/login'), { waitUntil: 'domcontentloaded' })
await page.evaluate(() => {
localStorage.setItem('planet-locale', 'en-US')
localStorage.setItem('docs-lang', 'en')
})
await page.reload({ waitUntil: 'domcontentloaded' })
await page.getByLabel('Username').fill('smoke-user')
await page.getByLabel('Password').fill('wrong-password')
await page.getByRole('button', { name: 'Log in' }).click()
await expectVisibleText(page, 'Login failed. Check your account or password.', 'english login backend error i18n')
await checkNoUnexpectedEnglishCjk(page, 'english login backend error i18n')
await checkNoFrameworkOverlay(page, 'english login backend error i18n')
await page.evaluate(() => {
localStorage.setItem('planet-locale', 'zh-CN')
localStorage.setItem('docs-lang', 'zh')
})
} catch (error) {
failures.push(error instanceof Error ? error.message : String(error))
}
await runAuthenticatedAdminChecks(browser, failures, consoleErrors, {
label: 'desktop',
viewport: desktopViewport,
+3
View File
@@ -13,6 +13,9 @@ main() {
harness_run scripts/harness/doctor.sh
harness_run git diff --check
harness_run zsh -n planet.sh
harness_run zsh -n scripts/lib/docker-bootstrap.zsh
harness_run "$uv_bin" run --frozen --project "$ROOT_DIR" python scripts/harness/test_docker_bootstrap.py
harness_run "$uv_bin" run --frozen --project "$ROOT_DIR" python scripts/harness/test_database_startup.py
harness_run bash -n scripts/bootstrap-dev.sh
harness_run bash -n scripts/harness/lib.sh
harness_run bash -n scripts/harness/doctor.sh
+274
View File
@@ -0,0 +1,274 @@
"""Database lifecycle regressions without starting or changing host containers."""
import asyncio
from contextlib import redirect_stderr, redirect_stdout
import io
import json
from pathlib import Path
import re
import subprocess
import sys
import unittest
from unittest.mock import AsyncMock, MagicMock, patch
from asyncpg import InvalidCatalogNameError, InvalidPasswordError
from sqlalchemy.engine import make_url
from sqlalchemy.exc import DBAPIError
ROOT = Path(__file__).resolve().parents[2]
sys.path.insert(0, str(ROOT / "scripts"))
import check_database_connection as probe # noqa: E402
TEST_URL = make_url("postgresql+asyncpg://postgres:test-secret@localhost:5432/planet_db")
def shell_function(name: str) -> str:
source = (ROOT / "planet.sh").read_text()
match = re.search(rf"^{name}\(\) \{{\n.*?^\}}", source, re.MULTILINE | re.DOTALL)
if match is None:
raise AssertionError(f"missing shell function: {name}")
return match.group()
def run_shell(functions: list[str], setup: str, action: str) -> subprocess.CompletedProcess[str]:
return subprocess.run(
["zsh", "-f"],
input="\n".join(["set -e", *(shell_function(name) for name in functions), setup, action]),
capture_output=True,
text=True,
timeout=10,
check=False,
)
class DatabaseLifecycleTests(unittest.TestCase):
def test_existing_container_gets_current_compose_configuration(self) -> None:
for function in ("start_database_services", "start_postgres_service"):
with self.subTest(function=function):
result = run_shell(
[function],
"""
mapped=0
docker() { return 0; }
compose_up() { mapped=1; }
""",
f"{function}\n[ $mapped -eq 1 ]",
)
self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
def test_port_conflict_is_visible_and_cannot_fall_back_to_old_container(self) -> None:
result = run_shell(
["start_database_services"],
"""
docker() { return 0; }
compose_up() { echo 'port is already allocated' >&2; return 1; }
""",
"start_database_services",
)
self.assertNotEqual(result.returncode, 0)
self.assertIn("port is already allocated", result.stderr)
def test_installed_compose_failure_is_not_reported_as_missing_compose(self) -> None:
result = run_shell(
["compose_up"],
"""
compose_available() { return 0; }
compose_v1_available() { return 1; }
docker() { echo 'address already in use' >&2; return 1; }
set_wait_detail() { :; }
log_warn() { echo "$*"; }
log_error() { echo "$*"; }
report_missing_compose() { echo MISSING_COMPOSE; return 1; }
""",
"compose_up up -d postgres",
)
self.assertNotEqual(result.returncode, 0)
self.assertIn("address already in use", result.stderr)
self.assertNotIn("MISSING_COMPOSE", result.stdout)
def run_init(self, connection_status: int) -> subprocess.CompletedProcess[str]:
return run_shell(
["init"],
f"""
for fn in parse_service_args guard_init_when_services_running print_splash \
start_wait_session stop_wait_session ensure_docker_runtime ensure_python_runtime \
sync_python_deps sync_frontend_deps ensure_planet_env_files \
prepare_motion_agent_host_dependencies set_wait_detail; do
functions[$fn]='return 0'
done
log_success() {{ echo "$*"; }}
log_error() {{ echo "$*"; }}
log_step() {{ :; }}
log_note() {{ :; }}
ensure_database_services_healthy() {{ echo CONTAINERS_HEALTHY; }}
verify_backend_database_connection() {{ echo CONNECTION_CHECK; return {connection_status}; }}
run_command_with_spinner() {{ shift; "$@"; }}
initialize_backend_database() {{ echo SCHEMA_INITIALIZED; }}
""",
"init --non-motion-agent",
)
def test_healthy_containers_do_not_allow_schema_changes_on_bad_connection(self) -> None:
result = self.run_init(1)
self.assertNotEqual(result.returncode, 0, result.stdout)
self.assertIn("CONNECTION_CHECK", result.stdout)
self.assertNotIn("SCHEMA_INITIALIZED", result.stdout)
self.assertNotIn("数据库服务已就绪", result.stdout)
def test_real_connection_is_checked_before_reporting_ready_and_creating_tables(self) -> None:
result = self.run_init(0)
self.assertEqual(result.returncode, 0, result.stderr)
self.assertIn("CONNECTION_CHECK", result.stdout)
self.assertLess(
result.stdout.index("CONNECTION_CHECK"), result.stdout.index("数据库服务已就绪")
)
self.assertLess(
result.stdout.index("数据库服务已就绪"), result.stdout.index("SCHEMA_INITIALIZED")
)
def test_only_missing_ports_trigger_one_volume_preserving_recreation(self) -> None:
for first_status, retry_status, expected_status, expected_recreates in (
(0, 0, 0, 0),
(1, 0, 1, 0),
(2, 0, 0, 1),
(2, 2, 2, 1),
):
with self.subTest(first_status=first_status, retry_status=retry_status):
result = run_shell(
["verify_backend_database_connection"],
f"""
checks=0
set_wait_detail() {{ :; }}
log_warn() {{ :; }}
compose_up() {{ echo "COMPOSE $*"; }}
wait_for_postgres_health() {{ return 0; }}
run_command_with_spinner() {{
checks=$((checks + 1))
if [ $checks -eq 1 ]; then return {first_status}; fi
return {retry_status}
}}
""",
"verify_backend_database_connection",
)
self.assertEqual(result.returncode, expected_status, result.stderr)
self.assertEqual(result.stdout.count("COMPOSE"), expected_recreates)
if expected_recreates:
self.assertIn("up -d --no-deps --force-recreate postgres", result.stdout)
self.assertNotIn("--renew-anon-volumes", result.stdout)
class DatabaseProbeTests(unittest.TestCase):
def docker_result(
self, ports: dict | None, mode: str = "bridge"
) -> subprocess.CompletedProcess:
return subprocess.CompletedProcess([], 0, f"{mode}\n{json.dumps(ports)}\n", "")
def test_missing_port_blocks_sql_even_if_container_is_healthy(self) -> None:
output = io.StringIO()
with (
patch.object(probe, "backend_database_url", return_value=TEST_URL),
patch.object(probe.subprocess, "run", return_value=self.docker_result({})),
patch.object(probe, "check_connection", new_callable=AsyncMock) as connect,
redirect_stderr(output),
redirect_stdout(output),
):
self.assertEqual(probe.main(), 2)
connect.assert_not_called()
self.assertIn("未向宿主机发布", output.getvalue())
self.assertNotIn("test-secret", output.getvalue())
def test_actual_backend_port_must_match_published_port(self) -> None:
result = self.docker_result({"5432/tcp": [{"HostIp": "0.0.0.0", "HostPort": "15432"}]})
with patch.object(probe.subprocess, "run", return_value=result):
with self.assertRaises(probe.DatabaseReadinessError):
probe.check_published_port(TEST_URL)
probe.check_published_port(TEST_URL.set(port=15432))
def test_host_networking_does_not_require_a_port_mapping(self) -> None:
with patch.object(probe.subprocess, "run", return_value=self.docker_result(None, "host")):
probe.check_published_port(TEST_URL)
def test_external_database_does_not_require_a_local_mapping(self) -> None:
with patch.object(probe.subprocess, "run") as inspect:
probe.check_published_port(TEST_URL.set(host="configured-db.example"))
inspect.assert_not_called()
def test_docker_failure_does_not_echo_raw_output(self) -> None:
result = subprocess.CompletedProcess([], 1, "", "sensitive test-secret")
with patch.object(probe.subprocess, "run", return_value=result):
with self.assertRaises(probe.DatabaseReadinessError) as error:
probe.check_published_port(TEST_URL)
self.assertIn("Docker context", str(error.exception))
self.assertNotIn("test-secret", str(error.exception))
def test_authentication_error_is_actionable_without_leaking_dsn_or_query_secrets(self) -> None:
output = io.StringIO()
url = TEST_URL.update_query_dict({"sslpassword": "query-secret"})
error = DBAPIError(
None, None, InvalidPasswordError(url.render_as_string(hide_password=False))
)
with (
patch.object(probe, "backend_database_url", return_value=url),
patch.object(probe, "check_published_port"),
patch.object(probe, "check_connection", new_callable=AsyncMock, side_effect=error),
redirect_stderr(output),
redirect_stdout(output),
):
self.assertEqual(probe.main(), 1)
self.assertIn("认证失败", output.getvalue())
self.assertNotIn("test-secret", output.getvalue())
self.assertNotIn("query-secret", output.getvalue())
self.assertNotIn("Traceback", output.getvalue())
def test_missing_database_and_network_errors_have_distinct_diagnostics(self) -> None:
self.assertIn("数据库不存在", probe.connection_diagnostic(InvalidCatalogNameError()))
for error in (ConnectionRefusedError(), TimeoutError()):
self.assertIn("地址不可达", probe.connection_diagnostic(error))
def test_invalid_config_never_echoes_validation_input(self) -> None:
output = io.StringIO()
with (
patch.object(probe, "backend_database_url", side_effect=ValueError("test-secret")),
redirect_stderr(output),
):
self.assertEqual(probe.main(), 1)
self.assertNotIn("test-secret", output.getvalue())
class DatabaseConnectionTests(unittest.IsolatedAsyncioTestCase):
async def test_connection_deadline_stops_a_stalled_probe(self) -> None:
async def stall() -> None:
await asyncio.sleep(1)
engine = MagicMock()
engine.dispose = AsyncMock()
engine.connect.return_value.__aenter__.side_effect = stall
with (
patch.object(probe, "create_async_engine", return_value=engine),
patch.object(probe, "CONNECT_TIMEOUT_SECONDS", 0.001),
):
with self.assertRaises(TimeoutError):
await probe.check_connection(TEST_URL)
engine.dispose.assert_awaited_once()
async def test_probe_only_selects_and_always_disposes_the_engine(self) -> None:
for error in (None, InvalidPasswordError("test-secret")):
with self.subTest(error=type(error).__name__):
engine = MagicMock()
engine.dispose = AsyncMock()
connection = AsyncMock()
engine.connect.return_value.__aenter__.return_value = connection
connection.execute.side_effect = error
with patch.object(probe, "create_async_engine", return_value=engine):
if error:
with self.assertRaises(InvalidPasswordError):
await probe.check_connection(TEST_URL)
else:
await probe.check_connection(TEST_URL)
self.assertEqual(str(connection.execute.call_args.args[0]), "SELECT 1")
engine.dispose.assert_awaited_once()
if __name__ == "__main__":
unittest.main()
+332
View File
@@ -0,0 +1,332 @@
"""Exercise Docker bootstrap with isolated command stubs, never the host daemon."""
import json
import os
from pathlib import Path
import shlex
import shutil
import subprocess
import sys
import tempfile
import unittest
ROOT = Path(__file__).resolve().parents[2]
MODULE = ROOT / "scripts/lib/docker-bootstrap.zsh"
COMMAND_STUB = r"""
import json
import os
from pathlib import Path
import subprocess
import sys
state_path = Path(os.environ["DOCKER_TEST_STATE"])
state = json.loads(state_path.read_text())
name = Path(sys.argv[0]).name
args = sys.argv[1:]
state["calls"].append([name, args])
def save() -> None:
state_path.write_text(json.dumps(state))
def finish(code: int = 0, output: str = "") -> None:
save()
if output:
print(output)
sys.exit(code)
def install_command(name: str) -> None:
target = state_path.parent / "bin" / name
if not target.exists():
target.symlink_to("mock-command")
if name == "id":
if args == ["-u"]:
finish(output=str(state["uid"]))
if args == ["-un"]:
finish(output="planet-test")
finish(output="planet-test" + (" docker" if state["member"] else ""))
if name == "sudo":
if state.get("sudo_denied"):
finish(1)
if args == ["-v"]:
finish()
if "-E" in args:
finish() # Record re-exec argv without executing planet.sh on this machine.
save()
sys.exit(subprocess.call(args[1:] if args[0] == "--" else args))
if name == "apt-get":
if state.get("apt_fail"):
finish(1, "simulated apt failure")
if args[0] == "install":
for package in args[2:]:
if package in ("docker.io", "docker-ce"):
state["engine"] = True
install_command("docker")
install_command("dockerd")
if package in ("docker-compose-v2", "docker-compose-plugin"):
state["compose"] = True
if package in ("docker-buildx", "docker-buildx-plugin"):
state["buildx"] = "0.20.0"
if package == "passwd":
install_command("usermod")
finish()
if name == "dpkg-query":
finish(0 if state.get("ce") else 1, "install ok installed" if state.get("ce") else "")
if name == "systemctl":
if args[0] == "show":
unit_exists = state["engine"] and (args[-1] != "docker.socket" or state["socket_unit"])
finish(output="loaded" if unit_exists else "not-found")
if args[0] == "is-active":
finish(output="active" if state["running"] else "inactive")
if state.get("service_fail"):
finish(1, "simulated service failure")
state["running"] = True
finish()
if name == "usermod":
state["member"] = True
finish()
if name == "mock-socket-access":
finish(0 if state["running"] and state["uid"] != 0 and not state["access"] else 1)
if name == "docker":
if args[0] == "info":
finish(0 if state["running"] and (state["uid"] == 0 or state["access"]) else 1)
if args[:2] == ["context", "inspect"]:
finish(output=state["endpoint"])
if args[:2] == ["compose", "version"]:
finish(0 if state["compose"] else 1)
if args[:2] == ["buildx", "version"]:
finish(0 if state["buildx"] else 1, "github.com/docker/buildx v" + state["buildx"])
finish(1)
"""
class DockerBootstrapTests(unittest.TestCase):
def setUp(self) -> None:
self.temporary = tempfile.TemporaryDirectory(prefix="planet-docker-test-")
self.addCleanup(self.temporary.cleanup)
self.folder = Path(self.temporary.name)
self.bin = self.folder / "bin"
self.bin.mkdir()
self.state_file = self.folder / "state.json"
self.state = {
"calls": [],
"uid": 1000,
"member": False,
"access": False,
"engine": False,
"running": False,
"compose": False,
"buildx": "",
"endpoint": "unix:///var/run/docker.sock",
"socket_unit": True,
}
stub = self.bin / "mock-command"
stub.write_text(f"#!{sys.executable}\n" + COMMAND_STUB)
stub.chmod(0o755)
for name in ("id", "sudo", "apt-get", "systemctl", "dpkg-query", "mock-socket-access"):
(self.bin / name).symlink_to("mock-command")
for name in ("zsh", "env", "sort", "head", "tail", "readlink", "awk", "sed"):
executable = shutil.which(name)
self.assertIsNotNone(executable, f"test prerequisite missing: {name}")
(self.bin / name).symlink_to(executable)
def existing_engine(self, *, running: bool = True, access: bool = True) -> None:
for name in ("docker", "dockerd"):
(self.bin / name).symlink_to("mock-command")
self.state.update(
engine=True, running=running, access=access, compose=True, buildx="0.20.0"
)
def run_bootstrap(
self,
action: str = "ensure_docker_runtime",
*,
extra_env: dict[str, str] | None = None,
arguments: list[str] | None = None,
) -> subprocess.CompletedProcess[str]:
self.state_file.write_text(json.dumps(self.state))
env = os.environ.copy()
for name in ("DOCKER_HOST", "DOCKER_CONTEXT", "PLANET_DOCKER_GROUP_REEXEC"):
env.pop(name, None)
env.update(
PATH=str(self.bin),
DOCKER_TEST_STATE=str(self.state_file),
TEST_OS="ubuntu",
TEST_DESKTOP="0",
PLANET_STATE_DIR=str(self.folder),
)
env.update(extra_env or {})
arguments = arguments or ["init", "--non-motion-agent"]
prelude = f"""
set -e
SCRIPT_DIR={shlex.quote(str(self.folder / "repo with ' quotes"))}
source {shlex.quote(str(MODULE))}
log_note() {{ print -r -- "$*"; }}
log_error() {{ print -r -- "$*"; }}
log_step() {{ print -r -- "$*"; }}
docker_bootstrap_os_id() {{ print -r -- "$TEST_OS"; }}
docker_desktop_present() {{ [[ "$TEST_DESKTOP" == 1 ]]; }}
docker_socket_needs_group_access() {{ mock-socket-access; }}
run_command_quiet_unless_verbose() {{ local output="$1"; shift; "$@" > "$output" 2>&1; }}
ensure_system_command() {{ command -v "$1" >/dev/null || docker_as_root apt-get install -y "$2"; }}
{action} {shlex.join(arguments)}
"""
result = subprocess.run(
[str(self.bin / "zsh"), "-f", "-c", prelude],
env=env,
text=True,
capture_output=True,
timeout=20,
)
self.state = json.loads(self.state_file.read_text())
return result
def calls(self, name: str) -> list[list[str]]:
return [args for command, args in self.state["calls"] if command == name]
def test_working_environment_is_reused_without_privilege_or_installation(self) -> None:
self.existing_engine()
result = self.run_bootstrap()
self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
self.assertEqual(self.calls("apt-get"), [])
self.assertEqual(self.calls("sudo"), [])
self.assertEqual(self.calls("systemctl"), [])
def test_fresh_root_install_starts_and_validates_engine(self) -> None:
self.state["uid"] = 0
result = self.run_bootstrap()
self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
self.assertEqual(
self.calls("apt-get"),
[
["update", "--error-on=any"],
["install", "-y", "docker.io", "docker-compose-v2", "docker-buildx"],
],
)
self.assertIn(["enable", "--now", "docker.service"], self.calls("systemctl"))
self.assertTrue(self.state["running"])
def test_fresh_user_installs_missing_usermod_and_reexecutes_without_sg(self) -> None:
args = ["--verbose", "init", "--non-motion-agent", "a 'quoted' $(argument)"]
result = self.run_bootstrap(arguments=args)
self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
self.assertIn(["install", "-y", "passwd"], self.calls("apt-get"))
self.assertEqual(self.calls("usermod"), [["-aG", "docker", "planet-test"]])
reexec = self.calls("sudo")[-1]
self.assertEqual(reexec[:7], ["-E", "-u", "planet-test", "-g", "docker", "--", "env"])
self.assertEqual(reexec[7], "PLANET_DOCKER_GROUP_REEXEC=1")
self.assertEqual(reexec[8], f"PATH={self.bin}")
self.assertEqual(reexec[10], str(self.folder / "repo with ' quotes/planet.sh"))
self.assertEqual(reexec[11:], args)
self.assertFalse((self.bin / "sg").exists())
def test_existing_group_membership_refreshes_start_without_installing(self) -> None:
self.existing_engine(access=False)
self.state["member"] = True
result = self.run_bootstrap("refresh_docker_group", arguments=["start", "--allow-lan"])
self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
self.assertEqual(self.calls("sudo")[-1][-2:], ["start", "--allow-lan"])
self.assertEqual(self.calls("apt-get"), [])
def test_failed_group_refresh_does_not_loop(self) -> None:
self.existing_engine(access=False)
self.state["member"] = True
result = self.run_bootstrap(
"refresh_docker_group", extra_env={"PLANET_DOCKER_GROUP_REEXEC": "1"}
)
self.assertNotEqual(result.returncode, 0)
self.assertEqual(self.calls("sudo"), [])
def test_stopped_existing_engine_is_started_without_installation(self) -> None:
self.existing_engine(running=False)
result = self.run_bootstrap()
self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
self.assertEqual(self.calls("apt-get"), [])
self.assertTrue(self.state["running"])
def test_missing_or_outdated_plugins_are_installed_without_replacing_engine(self) -> None:
self.existing_engine()
self.state.update(compose=False, buildx="0.16.0")
result = self.run_bootstrap()
self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
self.assertEqual(
self.calls("apt-get")[-1], ["install", "-y", "docker-compose-v2", "docker-buildx"]
)
def test_existing_docker_ce_keeps_its_package_family(self) -> None:
self.existing_engine()
self.state.update(compose=False, buildx="", ce=True)
result = self.run_bootstrap()
self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
self.assertEqual(
self.calls("apt-get")[-1],
["install", "-y", "docker-compose-plugin", "docker-buildx-plugin"],
)
def test_install_failure_stops_before_daemon_start(self) -> None:
self.state["apt_fail"] = True
result = self.run_bootstrap()
self.assertNotEqual(result.returncode, 0)
self.assertEqual(self.calls("systemctl"), [])
self.assertIn("simulated apt failure", result.stdout)
def test_missing_sudo_reports_requirement_without_attempting_install(self) -> None:
(self.bin / "sudo").unlink()
result = self.run_bootstrap()
self.assertNotEqual(result.returncode, 0)
self.assertIn("缺少 sudo", result.stdout)
self.assertEqual(self.calls("apt-get"), [])
def test_desktop_and_nonlocal_contexts_are_not_replaced(self) -> None:
result = self.run_bootstrap(extra_env={"TEST_DESKTOP": "1"})
self.assertNotEqual(result.returncode, 0)
self.assertIn("Docker Desktop", result.stdout)
self.assertEqual(self.calls("apt-get"), [])
result = self.run_bootstrap(extra_env={"DOCKER_HOST": "ssh://remote-docker"})
self.assertNotEqual(result.returncode, 0)
self.assertEqual(self.calls("apt-get"), [])
def test_working_remote_environment_is_reused(self) -> None:
self.existing_engine()
result = self.run_bootstrap(extra_env={"DOCKER_HOST": "ssh://remote-docker"})
self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
self.assertEqual(self.calls("sudo"), [])
def test_unsupported_os_has_an_explicit_error(self) -> None:
result = self.run_bootstrap(extra_env={"TEST_OS": "debian"})
self.assertNotEqual(result.returncode, 0)
self.assertIn("自动安装目前支持 Ubuntu", result.stdout)
self.assertEqual(self.calls("apt-get"), [])
def test_missing_cli_diagnostic_never_suggests_a_socket_unit(self) -> None:
result = self.run_bootstrap("log_docker_daemon_diagnostics")
self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
self.assertIn("未找到 Docker CLI", result.stdout)
self.assertNotIn("systemctl", result.stdout)
self.assertEqual(self.calls("systemctl"), [])
def test_missing_service_diagnostic_never_suggests_a_socket_unit(self) -> None:
(self.bin / "docker").symlink_to("mock-command")
result = self.run_bootstrap("log_docker_daemon_diagnostics")
self.assertIn("未检测到可用的 docker.service", result.stdout)
self.assertNotIn("enable --now docker.socket", result.stdout)
def test_service_without_socket_unit_gets_service_only_hint(self) -> None:
self.existing_engine(running=False)
self.state["socket_unit"] = False
result = self.run_bootstrap("log_docker_daemon_diagnostics")
self.assertIn("enable --now docker.service", result.stdout)
self.assertNotIn("enable --now docker.socket", result.stdout)
def test_daemon_start_failure_is_not_reported_as_database_failure(self) -> None:
self.existing_engine(running=False)
self.state["service_fail"] = True
result = self.run_bootstrap()
self.assertNotEqual(result.returncode, 0)
self.assertIn("Docker Engine 启动失败", result.stdout)
self.assertNotIn("数据库启动失败", result.stdout)
if __name__ == "__main__":
unittest.main(verbosity=2)
+239
View File
@@ -0,0 +1,239 @@
#!/usr/bin/env zsh
# Docker prerequisites for planet.sh; lifecycle and logging remain in planet.sh.
DOCKER_MIN_BUILDX_VERSION="0.17.0"
compose_available() {
docker compose version >/dev/null 2>&1
}
compose_v1_available() {
command -v docker-compose >/dev/null 2>&1
}
buildx_version() {
docker buildx version 2>/dev/null | awk '{print $2}' | sed 's/^v//'
}
buildx_meets_minimum() {
local current_version="$1"
local required_version="$2"
[ -n "$current_version" ] || return 1
[ -n "$required_version" ] || return 1
if [ "$(printf '%s\n%s\n' "$required_version" "$current_version" | sort -V | head -n 1)" = "$required_version" ]; then
return 0
fi
return 1
}
docker_daemon_available() {
command -v docker >/dev/null 2>&1 && command docker info >/dev/null 2>&1
}
docker_uses_local_engine() {
local endpoint="${DOCKER_HOST:-}"
if [ -n "${DOCKER_CONTEXT:-}" ] || [ -z "$endpoint" ]; then
if command -v docker >/dev/null 2>&1; then
endpoint="$(command docker context inspect --format '{{.Endpoints.docker.Host}}' 2>/dev/null)" || return 1
elif [ -n "${DOCKER_CONTEXT:-}" ]; then
return 1
else
endpoint="unix:///var/run/docker.sock"
fi
fi
case "$endpoint" in
unix:///var/run/docker.sock|unix:///run/docker.sock) return 0 ;;
*) return 1 ;;
esac
}
docker_desktop_present() {
local docker_path=""
[ -d /mnt/wsl/docker-desktop ] && return 0
docker_path="$(command -v docker 2>/dev/null || true)"
[ -n "$docker_path" ] || return 1
docker_path="$(readlink -f "$docker_path" 2>/dev/null || true)"
[[ "$docker_path" == */docker-desktop/* ]]
}
docker_systemd_unit_exists() {
command -v systemctl >/dev/null 2>&1 || return 1
[ "$(systemctl show --property=LoadState --value "$1" 2>/dev/null)" = "loaded" ]
}
docker_socket_needs_group_access() {
[ -S /var/run/docker.sock ] && { [ ! -r /var/run/docker.sock ] || [ ! -w /var/run/docker.sock ]; }
}
docker_require_sudo() {
[ "$(id -u)" -eq 0 ] && return 0
if ! command -v sudo >/dev/null 2>&1; then
log_error "缺少 sudo,无法安装或配置 Docker;请先由管理员安装 sudo 并授予当前用户权限。"
return 1
fi
# Authenticate in the foreground, before command output is redirected to a log.
sudo -v
}
docker_as_root() {
if [ "$(id -u)" -eq 0 ]; then
"$@"
else
sudo -- "$@"
fi
}
refresh_docker_group() {
[ "$(id -u)" -ne 0 ] || return 0
command -v docker >/dev/null 2>&1 || return 0
docker_uses_local_engine || return 0
docker_socket_needs_group_access || return 0
local username="$(id -un)"
local groups="$(id -nG "$username")"
[[ " $groups " == *" docker "* ]] || return 0
if [ "${PLANET_DOCKER_GROUP_REEXEC:-0}" = "1" ]; then
log_error "刷新组权限后仍无法访问 Docker socket,请检查 socket 的属组和权限。"
return 1
fi
docker_require_sudo || return 1
log_note "刷新 Docker 组权限,以当前用户继续执行。"
# Preserve WSL interop/tool paths even when sudo applies secure_path.
# argv stays an array: repository paths and arguments are never evaluated as shell text.
exec sudo -E -u "$username" -g docker -- env PLANET_DOCKER_GROUP_REEXEC=1 "PATH=$PATH" \
"$(command -v zsh)" "$SCRIPT_DIR/planet.sh" "$@"
}
docker_bootstrap_os_id() {
[ -r /etc/os-release ] || return 1
(. /etc/os-release; printf '%s\n' "$ID")
}
install_docker_prerequisites() {
local log_file="$PLANET_STATE_DIR/docker_install.log"
local engine_package="docker.io"
local compose_package="docker-compose-v2"
local buildx_package="docker-buildx"
local -a packages=()
if [ "$(docker_bootstrap_os_id)" != "ubuntu" ] || ! command -v apt-get >/dev/null 2>&1; then
log_error "Docker 自动安装目前支持 Ubuntu / Ubuntu WSL;请先安装本系统的 Docker Engine、Compose v2 和 Buildx。"
return 1
fi
if command -v dpkg-query >/dev/null 2>&1 &&
[ "$(dpkg-query -W -f='${Status}' docker-ce-cli 2>/dev/null)" = "install ok installed" ]; then
engine_package="docker-ce"
compose_package="docker-compose-plugin"
buildx_package="docker-buildx-plugin"
fi
if ! command -v docker >/dev/null 2>&1 ||
{ ! docker_daemon_available && ! command -v dockerd >/dev/null 2>&1; }; then
packages+=("$engine_package")
fi
compose_available || packages+=("$compose_package")
buildx_meets_minimum "$(buildx_version)" "$DOCKER_MIN_BUILDX_VERSION" || packages+=("$buildx_package")
[ "${#packages[@]}" -gt 0 ] || return 0
docker_require_sudo || return 1
log_step "安装 Docker 依赖: ${packages[*]}"
if ! run_command_quiet_unless_verbose "$log_file" docker_as_root apt-get update --error-on=any ||
! run_command_quiet_unless_verbose "$log_file" docker_as_root apt-get install -y "${packages[@]}"; then
log_error "Docker 依赖安装失败,请检查软件源、网络和 apt 错误。"
tail -20 "$log_file" 2>/dev/null || true
return 1
fi
rehash
}
start_local_docker_engine() {
local log_file="$PLANET_STATE_DIR/docker_service.log"
if ! docker_systemd_unit_exists docker.service; then
log_error "没有可用的 docker.service;请确认 Docker Engine 已安装且 systemd 正常运行。"
log_note "Ubuntu WSL 可在 /etc/wsl.conf 的 [boot] 下启用 systemd=true,再重启 WSL。"
return 1
fi
docker_require_sudo || return 1
if ! run_command_quiet_unless_verbose "$log_file" docker_as_root systemctl enable --now docker.service; then
log_error "Docker Engine 启动失败。"
tail -20 "$log_file" 2>/dev/null || true
log_note "查看原因: journalctl -u docker.service -n 50 --no-pager"
return 1
fi
}
ensure_docker_user_access() {
[ "$(id -u)" -ne 0 ] || return 0
docker_socket_needs_group_access || return 0
docker_require_sudo || return 1
ensure_system_command usermod passwd "usermod" || return 1
log_note "将当前用户加入 docker 组(该组可管理本机 Docker)。"
docker_as_root usermod -aG docker "$(id -un)" || return 1
refresh_docker_group "$@"
}
ensure_docker_runtime() {
if docker_daemon_available && compose_available &&
buildx_meets_minimum "$(buildx_version)" "$DOCKER_MIN_BUILDX_VERSION"; then
return 0
fi
if docker_desktop_present; then
log_error "检测到 Docker Desktop,但当前 WSL 的 Docker / Compose / Buildx 尚不可用。"
log_note "请启动 Docker Desktop,并为当前发行版启用 WSL Integration。"
return 1
fi
if ! docker_uses_local_engine; then
log_error "当前 Docker 使用其他 context 或远程/rootless endpoint,请先检查该环境的连接和插件。"
return 1
fi
install_docker_prerequisites || return 1
if ! command -v docker >/dev/null 2>&1 || ! compose_available ||
! buildx_meets_minimum "$(buildx_version)" "$DOCKER_MIN_BUILDX_VERSION"; then
log_error "安装后 Docker CLI、Compose v2 或 Buildx >= ${DOCKER_MIN_BUILDX_VERSION} 仍不可用。"
return 1
fi
if ! docker_daemon_available; then
start_local_docker_engine || return 1
ensure_docker_user_access "$@" || return 1
fi
if ! docker_daemon_available; then
log_error "Docker 已安装,但当前用户仍无法连接 daemon。"
log_docker_daemon_diagnostics
return 1
fi
}
log_docker_daemon_diagnostics() {
if ! command -v docker >/dev/null 2>&1; then
log_note "未找到 Docker CLI,尚未安装 Docker;Ubuntu / WSL 请先执行 ./planet.sh init。"
return 0
fi
if docker_desktop_present; then
log_note "请启动 Docker Desktop,并确认当前 WSL 已启用 WSL Integration。"
return 0
fi
if ! docker_uses_local_engine; then
log_note "当前使用其他 Docker endpoint;请检查 docker context ls 和 docker info。"
return 0
fi
if docker_socket_needs_group_access; then
log_note "Docker socket 存在,但当前用户没有读写权限;请执行 ./planet.sh init 配置 docker 组。"
return 0
fi
if ! docker_systemd_unit_exists docker.service; then
log_note "未检测到可用的 docker.service;Ubuntu / WSL 请执行 ./planet.sh init 检查安装。"
return 0
fi
if [ "$(systemctl is-active docker.service 2>/dev/null)" = "active" ]; then
log_note "Docker 服务已启动,但 CLI 无法连接;请检查 docker context ls 和 docker info。"
return 0
fi
if docker_systemd_unit_exists docker.socket; then
log_note "可先执行: sudo systemctl enable --now docker.socket && sudo systemctl restart docker.service"
else
log_note "可先执行: sudo systemctl enable --now docker.service"
fi
log_note "如仍失败,查看: journalctl -u docker.service -n 50 --no-pager"
}
Generated
+1 -1
View File
@@ -757,7 +757,7 @@ wheels = [
[[package]]
name = "planet"
version = "0.73.0"
version = "0.74.3"
source = { virtual = "." }
dependencies = [
{ name = "aiofiles" },