From 5a44870de583b15f833fc3fd496f30b0c4646d21 Mon Sep 17 00:00:00 2001 From: AskaEth Date: Sun, 1 Nov 2026 19:51:46 +0800 Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E8=AF=AD=E6=B0=94=E4=BD=93?= =?UTF-8?q?=E6=A3=80=E2=80=94=E2=80=94=E5=8E=BB=E6=8E=89=E3=80=8C=E6=AD=A3?= =?UTF-8?q?=E7=89=88=E7=99=BB=E5=BD=95=E3=80=8D=E5=8F=8A=E5=90=8C=E7=B1=BB?= =?UTF-8?q?=E9=98=B2=E5=BE=A1=E8=85=94=E4=B8=8E=E8=87=AA=E6=88=91=E5=A3=B0?= =?UTF-8?q?=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - zh 模块表 auth 行：「Microsoft 正版登录」→「Microsoft 账户登录」，与英文 "Microsoft sign-in" 对齐 - zh/en：CLI 行去掉「完整可用」/ "is fully usable"（要读者相信的形容词） - zh/en：CPU 软渲染兜底不再承诺「完整界面」/ "the full UI"，改为陈述渲染结果 - zh/en：轨道 B 首句去掉「没有任何…任何下载都拿不到它」/ "Nothing…no download contains it" 的双重否认， 并与紧邻的「只能自己从源码编」合并为一句 - zh：轨道 A 小标题去掉「真能」的强调语气 --- README.md | 11 +++++------ README.zh-CN.md | 10 +++++----- 2 files changed, 10 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 80e2149..e3e1a9c 100644 --- a/README.md +++ b/README.md @@ -28,8 +28,8 @@ attached to other agent tooling as an MCP server. dependency. - **Two UI stacks during the rewrite**: the released UI is Slint (Royalty-Free 2.0); the next-generation UI is iced 0.14 + Material 3 Expressive and is still being written (see Status). -- **CPU software-rendering fallback**: `--software-renderer` gives the full UI on machines with no - usable GPU or with broken drivers. +- **CPU software-rendering fallback**: `--software-renderer` keeps the interface rendering + normally on machines with no usable GPU or with broken drivers. - **AI agent + MCP**: chat, setting edits and crash diagnosis inside the launcher; `ull agent serve` exposes the same core as an MCP server (stdio or Streamable HTTP) to external agent tools. - **Mod loaders**: Fabric, Quilt, NeoForge, Forge, with modpack and CurseForge / Modrinth clients in @@ -52,8 +52,8 @@ Two tracks. They are not the same product yet, so read the headings before downl already contain them. - **UI**: Slint + Metro. This is the shipped GUI — the instance, download, account, Java, log and settings pages drive the real engine (the in-app AI chat panel is a scripted placeholder). -- **CLI `ull`** is built from the same tree at the same version and is fully usable — but the - `v0.1.0` assets ship only the GUI binary. If you want the CLI, build it yourself: +- **CLI `ull`** is built from the same tree at the same version — but the `v0.1.0` assets ship + only the GUI binary. If you want the CLI, build it yourself: `cargo build --release --bin ull`. Commands: `instances`, `install`, `launch`, `accounts`, `sessions`, `logs`, `diag`, `config`, `java`, `agent`. - Windows ARM64 and Linux ARM64 slots are wired into the release pipeline; the next tagged release @@ -61,8 +61,7 @@ Two tracks. They are not the same product yet, so read the headings before downl ### Track B — in progress on `dev`: next-generation UI (iced + Material 3 Expressive) -**Nothing on this track is released, and no download contains it.** You can only see it by -building from source. +**This track is not released yet — you can see it only by building from source.** - **Locked direction**: the look is Material 3 Expressive and the framework is iced 0.14; the UI layer is written from scratch. Neither the style nor the framework will change again. diff --git a/README.zh-CN.md b/README.zh-CN.md index 2005235..ae874f4 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -24,7 +24,7 @@ Unlucky Launcher（ULL）是一个用 Rust 写的免费开源 Minecraft: Java 启动器按实例下载管理，不是启动器的依赖。 - **重写期两套 UI 并存**：已发布版本是 Slint（Royalty-Free 2.0）；下一代 UI 是 iced 0.14 + Material 3 Expressive，目前仍在写（见「当前状态」）。 -- **CPU 软渲染兜底**：`--software-renderer` 让没有可用 GPU 或驱动有问题的老机也能拿到完整界面。 +- **CPU 软渲染兜底**：`--software-renderer` 让没有可用 GPU 或驱动有问题的老机也能正常显示界面。 - **AI Agent + MCP**：启动器内可对话、改设置、读崩溃诊断；`ull agent serve` 把同一个内核以 MCP server 形态（stdio 或 Streamable HTTP）开放给外部 Agent 工具。 - **加载器**：Fabric / Quilt / NeoForge / Forge；整合包与 CurseForge / Modrinth 客户端在 core 里。 @@ -36,7 +36,7 @@ Unlucky Launcher（ULL）是一个用 Rust 写的免费开源 Minecraft: Java 两条轨道，还不是同一个东西——看小标题再决定下载什么。 -### 轨道 A —— 已发布：v0.1.0，Slint 版（现在真能下载的就是它） +### 轨道 A —— 已发布：v0.1.0，Slint 版（现在能下载的就是它） - **GitHub Releases `v0.1.0`**（2026-11-01，标记为 pre-release）：单文件产物覆盖 Windows x64（裸 `.exe`）、Linux x64、macOS（arm64 与 x64）`.tar.gz`。每个 Release 另挂 `SHA256SUMS.txt` 与 @@ -44,7 +44,7 @@ Unlucky Launcher（ULL）是一个用 Rust 写的免费开源 Minecraft: Java unix 归档里本来就装着。 - **UI**：Slint + Metro。这是已交付的图形界面——实例、下载、账户、Java、日志、设置各页驱动真实引擎 （应用内 AI 对话面板仍是脚本化的占位）。 -- **CLI `ull`** 与 v0.1.0 同源同版本、完整可用，但发布资产里只有 GUI 单文件——要用它请自己构建： +- **CLI `ull`** 与 v0.1.0 同源同版本，但发布资产里只有 GUI 单文件——要用它请自己构建： `cargo build --release --bin ull`。命令：`instances`、`install`、`launch`、`accounts`、`sessions`、 `logs`、`diag`、`config`、`java`、`agent`。 - Windows ARM64 与 Linux ARM64 两个槽位已接进发布流水线，随下一个 tag 发布；`v0.1.0` 的资产早于 @@ -52,7 +52,7 @@ Unlucky Launcher（ULL）是一个用 Rust 写的免费开源 Minecraft: Java ### 轨道 B —— dev 上的下一代 UI（iced + M3 Expressive，施工中） -**这条轨道没有任何已发布的东西，任何下载都拿不到它。** 想看只能自己从源码编。 +**这条轨道还没发布——要看只能自己从源码编。** - **方向已锁死**：视觉 = Material 3 Expressive，框架 = iced 0.14，UI 层从头写；风格与框架都不会再换。 - **已完成**：令牌 crate `crates/design`（零 UI 框架依赖、零第三方 crate——真 HCT 色彩、排版档位、 @@ -94,7 +94,7 @@ Unlucky-Launcher (cargo workspace) | `download` | 多源健康度、镜像、分块下载、边下边算 | | `game` | 版本/实例仓库、快照与继承解析 | | `launch` | 10 阶段启动管线、进程、JSONL 事件流 | -| `auth` | Microsoft 正版登录（OAuth 2.0 device code → Xbox Live → XSTS → Minecraft Services） | +| `auth` | Microsoft 账户登录（OAuth 2.0 device code → Xbox Live → XSTS → Minecraft Services） | | `addon` | 加载器安装、整合包、CurseForge / Modrinth | | `diagnose` | 五类信号采集、YAML 规则引擎、hs_err 解析 | | `platform` | OS 抽象：路径、进程、文件锁、能力探测、运行期 OS 检测 |