AskaEth/Unlucky-Launcher
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
202 Commits 2 Branches 2 Tags
31cdfd5bbd56b7a2f95261ba9319b369673f2407
Commit Graph
9 Commits
Author SHA1 Message Date
AskaEth f6e55c5c7e docs(build): 修正三处「文档说法与实测不符」的注释（M96 复审 P2-1/2/3） 
只改措辞与注释，**profile 数值一个没动**（release.package 仍是 opt-level="z" + cu16，
fast 仍是 opt-2/thin/cu16/unwind）。

P2-1 `panic = "unwind"` 的理由原本写错了：原注释说「漏了这一行 `cargo test --profile fast`
起不来（test harness 依赖 unwind）」。实测三连否掉：`cargo build --profile release -v` 的
rustc 参数里**有** `panic=abort`、`--profile fast` 里没有（这行确实生效，可作证据）；但
`cargo test --profile release -p unlucky-i18n --no-run`（abort 档）照样 Finished 并产出测试
二进制，`-v` 里 test 单元**没有** `-Cpanic=`，真跑 23 个测试全过 —— cargo 对 test 目标自己强制
unwind。所以理由改成「让 fast 档编出来的**二进制**走 unwind」，并把「能跑 cargo test」明确标为
**没有区分度**的证据。顺带记下 fast 继承 `strip="symbols"` ⇒ 能 unwind 但没有符号回溯。

P2-2 `[profile.fast.package."*"]` 的注释把机制说反了：原注释说「package 覆盖按 profile 分别
生效，release 的不影响 fast」。实测删掉这块后，fast 档的**外部依赖**直接变成 `opt-level="z"`
（`slotmap`：1 那次 3 个单元 opt-2 → 删除后 3 个单元 opt-z），说明 `inherits` 会把 release 的
package 覆盖一起带过来。所以这块是**承重墙**，删了依赖会静默退回 z。注释按实测重写。

P2-3 「收益全在 `codegen-units = 16`」删掉：三组数据的唯一自变量是 opt-level（两臂都是 cu16），
cu1→cu16 的收益本轮**没有同条件对照**，已明确标成未测、留待后续归因。同时补一句：GUI 相对旧
基线 +12.9% 里「代码增长」与「依赖 cu16」未分离（ull 只 +1.7%，在 +1~3% 口径内）。

注：P2-1 那条原始错误表述来自 tower 的 mission 任务书，不是 worker 的臆造。

验证：`cargo build --release --bins` rc=0（16m21s，产物字节与 §7.1 记录完全一致：
6,256,128 / 13,910,528 / 16,479,232），`cargo metadata` 通过，README 仍为 400 行（未破门禁）。
 2026-11-03 00:23:26 +08:00
AskaEth b9eae2bb73 perf(build): 加 fast 构建档、依赖并行 codegen、验收脚本一次 --bins 
三条慢因里两条落在构建配置上，发布档（release）的体积取向不动：

1. `[profile.fast]`（inherits = release）：opt-level 2 / lto thin / codegen-units 16，
   日常迭代与验收用它，发布仍走 release。`panic = "unwind"` 是**必须显式写**的一行——
   release 是 panic = "abort"，inherits 会照抄，漏了它 `cargo test --profile fast` 起不来
   （test harness 依赖 unwind）。
2. `[profile.release.package."*"]`：依赖的 codegen-units 放到 16（并行 codegen），
   **opt-level 保持 "z"**。最初按「优化等级高 = 编译快」把依赖抬到 opt-level 3，
   同机冷编译实测反了：opt-3 是 22m45s / GUI 19.46 MiB，opt-"z" 是 16m01s / 15.72 MiB——
   又慢 29.6% 又大 19~24%，收益全部来自 codegen-units 而不是 opt-level。
   只调优化强度，不碰 panic / strip（那两项改的是整个二进制的运行时行为）。
3. `[profile.fast.package."*"]` 显式写一遍：package 覆盖按 profile 分别生效，不赌 inherits
   会不会连覆盖一起继承（实测 594 个编译单元全部 opt-level=2 + cu16，含依赖）。

实测写进 packaging/README §6/§7.1（同机、删空 target 的冷编译、无并发负载）：
release 16m01s（GUI 15.72 / iced 13.27 / ull 5.97 MiB），fast 24m27s（36.41 / 32.02 / 15.23 MiB）。
**fast 档在本机冷编译没有收益甚至更慢**，瓶颈是两个大 UI crate + 链接 + 机械盘 IO，
它的定位是 SSD 机器与增量重编——这条照实写进文档，不为了贴近预期挑数字。

DevDocs/ops/macos-acceptance.sh 的构建段改动（DevDocs 被 gitignore，无法入库）见完成报告。
 2026-11-03 00:23:26 +08:00
AskaEth e77a5df6e8 feat(i18n): 建国际化地基——语言探测 / 中英消息目录 / 中文字体策略（D28） 
M92 只建地基、不接页面（页面接线是后续 mission，避免「先硬编码再全量重写」）。
新建的 crates/i18n 是**零依赖** crate：`cargo tree -p unlucky-i18n --edges normal`
只打印它自己，所以 iced 版、将来的别的壳、presenter 都能依赖它而不锁死渲染框架。

- lang：`Lang::{En, ZhCn}` + 可注入的 `LocaleSource`（`EnvLocale` 按 POSIX 优先级读
  LC_ALL > LC_MESSAGES > LANG）。未知语种一律英文——把 ja/fr 猜成中文会连带触发中文字体
  下载，比英文界面更糟。配置值（`ui.language` 的 zh_cn/en_us）走严格解析，locale 走宽松
  解析，两条路刻意分开。**已知缺口**：Windows 上这三个变量通常都不存在，
  `GetUserDefaultLocaleName` 属于 platform 的 FFI（后续 mission）。
- catalog：`Key` 枚举（拼错的 key = 编译错误，附 compile_fail 文档测试守着）
  + `catalog!` 宏「一行 = 一个 key 的全部语言」⇒ 内置两套目录缺译在结构上不可能发生。
  缺译诊断（`Catalog::diagnose`）留给注入目录与回归守门：`get` 严格返回 None、
  `text` 返回 ⟪missing⟫、`render` 返回 ⟪missing:KeyName⟫——**不回落**到另一种语言。
  带变量的句子走 `{name}` 占位符，缺参时占位符原样留在文案里（可见，不静默变空）。
- font：`decide(lang, installed)` 是纯函数。英文环境恒 `NotNeeded`（D28 的零字体/零网络）；
  中文环境按候选族名单命中系统字体，扫不到就发 `NeedsDownload(Noto Sans SC)` 信号，
  **本 crate 不联网**；`Fetcher` 是注入式接口，网络实现留给后续 mission。
  URL/哈希显式留白（`Source::PendingPin`）——不编造 CDN 路径，猜错的地址会被后面所有人当事实用。
- bridge：文案边界规则全文（R1 不许拼句 / R2 core 中文串不进 UI / R3 未知串不许画原文）
  + `classify()` 示例契约：过渡表把已知漏到界面的中文串映射到 key，品牌专名显式放行，
  其余一律 `Untranslated`（UI 只许显示兜底 key）。
- app-iced/fonts：新增 `fonts/cjk.rs` 适配层，把系统字面表喂给 `decide`；读不到字体库时给
  `Unprobeable` 而不是「需下载」（否则会误触发一次 CDN 下载）。结论并入同一行启动日志：
  `[font] … | lang=zh-CN locale=zh_CN.UTF-8 cjk=system:"Microsoft YaHei"`。

测试：26 条（i18n 22 + app-iced fonts/cjk 4），每条断言都写了「抓得住什么 / 抓不住什么」。
 2026-11-02 16:13:22 +08:00
AskaEth 1aac62f6f0 feat(palette-extract): 图片解码适配层（D40 第 2 层，唯一引入 image 的地方） 
- 新 crate unlucky-palette-extract：路径/字节 → RGBA → design 的种子
- image 只开 png + jpeg（关 default-features，不拖 rayon/avif/webp）
- 解码前按 Limits 拒超大尺寸（解压炸弹），解码后最长边缩到 256
- input(&Result<Rgba8, _>) 把失败翻成 ImageInput::Undecodable（回落链靠它区分「没设」与「坏了」）
- 11 个单测覆盖纯色/JPEG/抄错扩展名/垃圾字节/截断/缺文件/1px/灰图/大图/超限/零拷贝
 2026-11-02 11:04:52 +08:00
AskaEth f159529936 feat(presenter): 新建 unlucky-presenter，把 host/状态/DTO/设置桥从 app 迁出（M85 第 1 块） 
D26（iced 重写）的关键一次性动作：UI 框架无关的宿主层独立成 crate，
Slint 版（crates/app）与 iced 版（crates/app-iced）共用，Slint 退役后不再重写一遍。

- 新建 crates/presenter（package `unlucky-presenter` / lib `unlucky_presenter`），
  workspace 登记 + crate 文档头写清「这层为什么存在」、对外表面、UI 侧允许/禁止、
  iced 接线骨架、以及哪些东西留在了 crates/app 及为什么。
- `git mv`（保留文件历史）迁入：host/（25 文件）、dto/（11 文件）、state.rs(+tests)、
  prefs.rs、settings_bridge.rs、toast.rs、router.rs、dialogs.rs、wizard.rs、
  mock.rs、mock_data.rs、backend.rs。模块路径与公开 API 名称不变（`host::install` 等），
  内部实现零改动。
- 新增 `theme`：把原本混在 ui_bind/theme_runtime 里的**纯判据**（CONFIG_POLL_TICKS /
  SYSTEM_THEME_POLL_TICKS / TILE_REGENERATE_STEP / BackgroundKey / tile_viewport /
  system_theme_value / 两个 poll 判据）抽出来，附 5 个单测；app 侧改成调用它们。
- crates/app 改为消费者：删掉迁走的文件，`crate::host|state|dto|prefs|settings_bridge|
  toast|router|dialogs|wizard|mock|mock_data|backend` 全部改写为 `unlucky_presenter::*`
  （64 处），backend.rs 的 config_path/build_backend 提为 pub。
- crates/app-iced 只登记 unlucky-presenter 依赖，本 mission 不接线。
- prefs.rs 的 2 处 slint 文档引用改写；`grep -rn slint crates/presenter` 现在无输出。
 2026-11-02 09:29:31 +08:00
AskaEth df4ff373b7 feat(app-iced): M68 —— iced 0.14 骨架（后端探测/字体基座/自绘标题栏/导航轨/深浅主题/截图通道） 
新增 crates/app-iced（package `unlucky-app-iced`，bin `unlucky-launcher-iced`），与 Slint 版并存，
为 D26「UI 从头写」打地基。本 mission 只做骨架：能开窗、颜色/字体对、层级在，不做业务页面。

- 后端（D27）：启动探测 wgpu 适配器（只看 device_type，避开 WARP 误判）→ 写 ICED_BACKEND；
  auto/gpu/cpu 三条路径都保留 tiny-skia 兜底，绝不硬失败；`--renderer=cpu` 跳过探测（省 ~0.85s）
- 字体（D28 前半）：令牌三平台字体栈 → 用 iced 全局 FontSystem 查装机情况 → 族名与 400/500/700
  字重落点（缺档按 Nearest/Synthetic 记录）打一行启动日志
- 令牌适配层 theme::Ui：唯一把 unlucky-design 的值翻成 iced Color/Font/Border/Radius/Theme 的地方；
  49 个 M3 角色留在自己的 Scheme 里，iced 的 6 色 Palette 只给 devtools
- 骨架：1180×760 无边框窗口、48 高自绘标题栏（drag + 东/南 drag_resize + 最小化/最大化/关闭）、
  88 宽导航轨（56×32 SecondaryContainer 药丸，由令牌推导）、页头 56 + 一张 OutlinedCard
- 主题：系统主题探测 + --theme，切主题只重建 Ui（Theme::name 变化触发重算），不动 UI 状态
- 截图通道：`--screenshot <png>` + `--screenshot-theme`（真开窗第 3 帧出图），以及
  `--diff <a> <b>` 自带逐像素对比（CI 不依赖 Python/ImageMagick）
- 图标：令牌 SVG path → iced svg 控件（颜色走 alpha 蒙版，深浅共用一份位图缓存）
- 门禁：tests/no_hardcoded_tokens.rs 扫源码挡色值/尺寸字面量 + 挡 slint 依赖（自检也算过）

实测（Windows Server 2025 / 96 DPI / RX 6600 XT）：浅/深 × GPU/CPU 四张真开窗截图；GPU vs CPU
差异 0.72% 像素、全部落在字形/图标抗锯齿与 1px 圆角描边、最佳对齐 (0,0)、平坦区颜色逐字节相同；
release 体积双后端 6.44 MiB / 仅 CPU 3.75 MiB；首帧 GPU 1.18~1.31s、CPU 33~37ms。

未做/未验证：macOS 与 Wayland 全链路、西/北边缩放热区、letter spacing（iced 0.14 无此属性）、
中文 CDN 字体、玻璃；翻牌步骤写在 DevDocs/SubAgentsTalk/app-iced-骨架与翻牌.md（不入库）。
 2026-11-01 17:11:24 +08:00
AskaEth 65ca0ed29a feat(design): 加 unlucky-design 令牌 crate（M3 色彩/排版/形状/动效/图标） 
D26 把视觉基线锁到 Material 3 Expressive，本 crate 是「UI 整体性」的地基：
令牌唯一真源，后续 iced 页面只消费不新增。零第三方依赖、零 UI 框架依赖
（cargo tree -p unlucky-design --edges normal 只有它自己一行）。

- 色彩：49 个 M3 语义角色 × light/dark，种子色派生 6 条 tone 调色板；
  tone 轴严格用 CIELAB L*（偏差 ≤1），色相/彩度用 OKLCh 近似 CAM16 并在
  模块文档里写明口径与已知偏差（不宣称是标准 HCT 动态取色）
- 对比度：26 组文字对 × 6 组种子 × 2 模式全部 ≥4.5:1；3 条例外显式登记
  （Outline 非文字 3:1、OutlineVariant 装饰、SurfaceVariant 是容器色）
- 排版：M3 type scale 15 档 + 三平台字体族回退栈（只写族名，不内嵌受限字体）
- 形状/高程/动效：Expressive 形状刻度 + shape morph 数据、elevation 级别与
  surface container 映射、时长/缓动/弹簧（纯函数可采样）
- 图标：24 个从 Slint 版迁移的 SVG path + 4 个新增，IconKind 冻结只可末尾追加；
  写明 Slint 的 stroke-width 是绝对像素、SVG 是 viewBox 用户单位的语义差异，
  换算封装成 Icon::stroke_width
- 组件档位表：20 个组件的形状/高程/字体/动效一次取全

TODO(M63)：elevation shadow 的 blur/offset/alpha 与四组弹簧参数是占位值，
接口先定、数值待玻璃视觉规格表（tower 已通告边界）。
 2026-11-01 15:34:04 +08:00
AskaEth 76d83148ff feat(packaging): 单文件产物矩阵 + tag 触发的 Release 流水线（M46） 
- packaging/make_artifacts.py：本地与 CI 共用的打包脚本 —— 版本取自 cargo metadata
  （tag 交叉校验，不一致即失败）、按宿主判定槽位、Windows 裸 exe / UNIX tar.gz
  （内含 LICENSE/NOTICE/README.md）、SHA256SUMS.txt；打包前跑 `ull --version` 断言版本；
  tar 内 mtime/uid 归零 + gzip header mtime=0 → 同源构建 sha256 可复现
- packaging/README.md：产物矩阵与命名约定、版本唯一真相源、各平台运行时依赖、
  软渲染兜底、release profile 取舍、**本机实测**体积与冒烟证据、合规与支持矩阵
- packaging/release-notes.md：GitHub Release 说明模板（{{VERSION}}/{{SUMS}}，
  写清 Win10+ / macOS 12+ / Linux x64 支持矩阵）
- .github/workflows/release.yml：tag v* 触发四槽位矩阵 → 产物 + 重算 SHA256SUMS →
  gh release create（pre-release 默认开，workflow_dispatch 只构建）；Windows 用
  +crt-static 并以 dumpbin 导入表把"单文件"做成硬门禁；归档内容自检 LICENSE/NOTICE/README
- Cargo.toml：release profile lto thin → fat（实测 GUI 16,366,080 → 14,595,584 B
  = −10.8%，ull 7,572,992 → 6,157,824 B = −18.7%）

验证：cargo build --release 通过；GUI `--software-renderer --screenshot` 出 1180×760 PNG、
`ull --version` = 0.1.0；PE 导入表 33 个 DLL 全为系统库（无 VCRUNTIME/libwinpthread）；
cargo deny licenses/bans/sources ok；workflow 用 python yaml 解析自检。
 2026-11-01 08:33:17 +08:00
AskaEth bc41dfcf7d Unlucky Launcher v0.0.1-alpha
CI / fmt (rustfmt --check) (push) Canceled after 0s
Details
CI / clippy (ubuntu-latest) (push) Canceled after 0s
Details
CI / clippy (windows-latest) (push) Canceled after 0s
Details
CI / test (ubuntu-latest) (push) Canceled after 0s
Details
CI / test (windows-latest) (push) Canceled after 0s
Details
CI / build release (ubuntu-latest) (push) Canceled after 0s
Details
CI / build release (windows-latest) (push) Canceled after 0s
Details
Guards / core 零 UI 守门 (push) Canceled after 0s
Details
Guards / 文件行数 ≤400 守门 (push) Canceled after 0s
Details
Guards / 依赖许可与来源（cargo-deny） (push) Canceled after 0s
Details 
Rust 原生单文件 Minecraft 启动器：CLI 完整可用（install/launch/accounts/java/diagnose/agent），
MCP server 接入外部 Agent 工具，GUI 开发中。
 2026-10-31 21:54:10 +08:00