Lampio 知识库

主题

品牌改名实施计划（rename-plan） ​

物理仓库位置：~/reading-browser（RB 桌面端本体所在单仓） 创建：2026-07-24 ｜ 状态订正：2026-08-30 状态：定名 = Lampio；阶段一 / DB / 阶段二 / 阶段三主体 / 阶段四 RVH 全部 ✅， 按本文件 §2 的勾选状态只剩 4 项： ① Vercel 重部署 landing + 注册 lampio.app + NEXT_PUBLIC_SITE_URL（用户实测）· ② dev/prod identifier 拆分（com.lampio.dev / com.lampio）—— 刻意留到正式 1.0， 与 schema.sql 冻结点同批 · ③ admin 侧改名（§G）· ④ 首个签名版目标版本待填。

🔴 原状态行说反话：它写着「仓改名/push 待办」，而同一份文件 §2 阶段二第 2、3 项 明明勾着「2026-07-25 完成」，两个远端今天也确实都叫 lampio。 这是本仓反复踩的同一个病 —— 状态行只在创建时写一次、之后不维护，比没有更坏 （见 docs/plans/README.md 的「🔒 每份 plan 必须有状态行」）。 ⚠️ 上面那 4 项是照 §2 勾选状态转录的，不是 2026-08-30 重新实测的结果； 动手前逐项现查。 关联：docs/brand/lampio-{icon,mark}.svg（logo 母图）· docs/plans/trademark-clearance-brief.md（可选注册 brief）· docs/product.md（定位真相源）· memory project_brand_rename / project_brand_primary_cross_end

0. 决策纪要 ​

为什么改名 ​

现名 ReadBrowser 带「Browser（浏览器）」感，与定位冲突——产品是「兴趣驱动的沉浸阅读学习工具」，竞品是 Kindle 不是 Duolingo，既非浏览器也非背单词工具。

定名 = Lampio（lam-PEE-oh） ​

  • 词义：芬兰语「灯笼 / 灯」→ 与 logo「词点亮」概念天然契合（满屏文字里，值得学的词像灯一样亮起）。
  • 过全部判准：域名 .app/.io/.com 全空 · 无同拼写项目 · 商标未注册 · 中文拼音/谐音干净 · 发音稳定 · 图义（点亮）契合。
  • 次选 Lampyra 落败（.io 被 crypto 占 + 同拼写项目 + 发音易读错）。

决策历程（留痕） ​

ReadBrowser → 约 30 个候选逐轮被淘汰（真词难拥有 / rov-·lume 拥挤带 / 短名碰撞密；清单见 memory project_brand_rename）→ Faren 一度锁定后弃（faren.app/.com 被占 + 「faren=法人」拼音）→ 新会话按「域名前置 + 拼音避雷 + 少量候选」流程定 Lampio。

其他已定决策 ​

  • 统一品牌：一个名字覆盖桌面(RB)+移动(RVH)，不再两个割裂名。
  • 品牌绿不变：#1f4e3d（亮）/#7fb590（暗）保持，本次改名不碰颜色（改色须另行通知 RVH）。
  • Logo：docs/brand/lampio-{icon,mark}.svg（词点亮内核 · 绿底 + 琥珀点亮词 · 避开沙漏/地球/毕业帽/猫头鹰）。Figma 微调 → 导出 1024 PNG → pnpm tauri icon。
  • 商标：个人开发者 + 内测前，「先用后注册」——发版不需注册；Lampio 自查已过「无同领域完全相同竞品」。可选：首个签名版前顺带一次免费在线代理清查；要防御再注册第 9+42(+41) 类。

1. Blast Radius（分层 + 当前状态） ​

代入：品牌名 = Lampio；小写标识 = lampio；bundle id = com.lampio（dev: com.lampio.dev）。

A. 🔴 身份关键 ​

位置状态
tauri.conf.json productName → Lampio✅ 已改（2026-07-25，阶段三提前做）——app 名/窗口标题/.app 包名/二进制名（二进制名下次发版才生效）
identifier → com.lampio.dev + lib.rs:238 数据目录 + 脚本/skill 路径✅ 已改（cargo OK）——用户数据目录变 com.lampio.dev（存量 dev 数据重置，用户接受）；dev/prod 拆分仍留 1.0（Release Prep）
用户库 readbrowser.db → lampio.db（commands.ts / lib.rs:40 / helpers.rs:79 / db_readonly.rs:82 共 4 处）✅ 已改（存量本地库重置，用户确认可重装；cargo check OK）

B. 🟡 应用内用户可见文案 — ✅ 完成 ​

  • AuthGate.tsx h1 + zh/en settings.appVersionLine → Lampio。
  • content-script 17 处经核实全是日志前缀/注释（非 UI），不改。

C. 🟡 landing 卫星子项目 — ✅ 文案完成 ​

  • dictionaries.ts（badge/heading/title/description/keywords zh+en）+ layout.tsx siteName + footer.tsx + opengraph-image.tsx → Lampio；siteUrl fallback → https://lampio.app。
  • ⏳ 二进制资产名 ReadBrowser_0.1.0_*（download.tsx）留阶段三重新发版随 productName 变。

D. 🟢 后端 cosmetic ​

  • Edge Function UA ×3（tts-synthesize/discover-sites/analyze-articles）'ReadBrowser...' → 未改，随 edge-deploy 随手。

E. 🟠 仓库 / 外部身份 — 代码已跟改，仓改名待用户 ​

  • ✅ 代码：download.tsx BASE → lampio-releases · scripts/release.sh REPO → ttfishnet/lampio · release/SKILL.md 仓名引用 · siteUrl → lampio.app。
  • ⏳ 【用户】GitHub 改名 reading-browser→lampio + readbrowser-releases→lampio-releases；Gitee 同步；注册 lampio.app + Vercel NEXT_PUBLIC_SITE_URL。
  • ⏳ 【我，用户改完后】git remote set-url github+origin → 新 URL，然后 push 全部 commit 双推 + 触发 Vercel 重部署；验 Vercel 连接。
  • 本地目录 /Users/larry/reading-browser 改名 = 独立可选（改则连带修 skill 硬编码 cd 路径 + 符号链接；建议先不动）。

F. 🔵 跨端 RVH（必须新会话，CLAUDE.md §9） ​

  • RVH（Flutter/Dart，独立仓）也统一为 Lampio：app 名 / bundle id（iOS/Android）/ 应用内文案 / 本地库文件名（若含旧名→数据迁移）/ 上架名。用 lampio-*.svg 产移动端图标。本轮桌面+landing 先行，RVH later。

✅ RVH 回执（2026-07-25，独立会话完成 · RVH plan ~/reading_vocab_helper/docs/plans/rename-plan.md） ​

  • 应用内文案：appTitle(en/zh/ja) English Learning App/英语学习助手/英語学習アプリ → Lampio；AppConfig.appName（about 页 + 支持邮件主题）Reading Vocab Helper → Lampio；authSignInDescription(en/zh/ja) 原「between Reading Vocab Helper and ReadingBrowser」→ 统一措辞「across Lampio on all your devices / 在你所有设备上的 Lampio 之间」（flutter gen-l10n 已重生成，flutter analyze lib/ 0 error）。
  • 身份项：
    • iOS CFBundleDisplayName+CFBundleName → Lampio；PRODUCT_BUNDLE_IDENTIFIER（6 处，含 RunnerTests）com.nikos.englishLearningApp → com.lampio.app（Tests=com.lampio.app.RunnerTests）。
    • Android strings.xml app_name → Lampio；applicationId com.nikos.reading_vocab_helper → com.lampio.app。
    • namespace 也改 com.lampio.app（2026-07-26 用户追加）：kotlin 目录迁 com/lampio/app/MainActivity.kt + package 声明；平台 channel 名 com.nikos…/share(+/share_stream) → com.lampio.app/* Kotlin+Dart 双端同改；shortcuts.xml targetPackage/targetClass 同步。仓内已无任何 com.nikos 残留。
    • bundle id 取值 = com.lampio.app：与 com.lampio.* 家族一致 + 呼应主域 lampio.app，与 RB 桌面 com.lampio(.dev) 区分。⚠️ 用户当时 away，采推荐默认；RVH 仍 pre-launch alpha，上架前可改（次选 com.lampio.mobile）。dev/prod flavor 拆分同 RB 留 1.0。
  • 本地库处理方式 = 改名 lampio.db（无迁移，卸载重装）（2026-07-26 用户确认）：RVH 用户库 documentsDirectory/reading_vocab.db → lampio.db，不做数据迁移（存量装机卸载重装；dev 阶段版本不匹配本就删库重建）。预装词库 assets/databases/reading_vocab.db 属红线 #10 byte-equal，asset load 路径保持 reading_vocab.db，git 确认未碰。

✅ 预装库重命名 reading_vocab.db → lampio_dict.db（RB 会话已执行，2026-07-26；原为下方 RVH 🔔 请求） ​

  • RB 已做：git mv 物理资产 → lampio_dict.db（字节不变）+ 全部运行时/构建/脚本/pipeline 引用同步（tauri.conf resources · helpers.rs · lemmatizer.rs · sync-rvh-vocabulary.sh · cross-end-check.sh · gen-word-illustrations.py · reset-dev-data.sh · config.yaml output_db/app_db · db_generator/build_all 注释 · phrase_eval/run.py · vocab-reseed SKILL · 活文档 · CLAUDE 红线 #10）；cargo check OK。纯改名、内容 byte-identical → 无版本 bump。历史 cross-end/* SHA 日志保留旧名（记录当时事实）。
  • RVH ✅ 已完成（2026-07-26）：assets/databases/ 下改名 lampio_dict.db + 2 处 rootBundle.load + 重跑 sync + byte-equal 校验；cutover 收口，跨端预装库文件名一致。
原 RVH 🔔 请求（存档）

🔔 RVH → RB 请求：预装库重命名（需 RB 会话驱动） ​

  • 诉求：预装 asset reading_vocab.db 命名不佳（旧描述词 + 与本地用户库 lampio.db 易混），请重命名。但它是 byte-equal 共享资产（红线 #10），权威产出方 = RB pipeline tools/vocabulary_builder_v3::generate_db，RVH 纯消费 → RVH 不单方面改，交 RB 会话驱动。
  • 建议名：lampio_dict.db（品牌 + dictionary 语义，与 lampio.db 区分）；或 brand-neutral vocab_dict.db。RB/用户定夺。
  • RB 需做：① generate_db 输出名改新名 ② RB 端预装库加载路径同步 ③ 产出新名预装库 + handoff。RVH 侧随后走 /preinstalled-db-update 更新两处 rootBundle.load 路径（app_database.dart + lemmatizer_flutter_loader.dart）+ byte-equal 校验 + bump 版本。详见 RVH docs/plans/rename-plan.md §5。
  • Logo：branding/lampio-icon-fullbleed.svg（rx=0 full-bleed）+ lampio-icon-foreground.svg（adaptive 前景）派生自本仓 docs/brand/lampio-icon.svg → rsvg-convert 1024 PNG → flutter_launcher_icons 生成 iOS 21 icons + Android 全套 mipmap/adaptive（background #1f4e3d，foreground 16% inset），品牌绿/琥珀/奶白配色一致。
  • 上架名：待 App Store / Play 上架时取 Lampio（RVH 未定发版日）。
  • 红线核对：品牌绿未动 · reading_vocab.db byte-equal 未碰 · 跨端 sync schema/共享表零改动。

G. ✅ admin 卫星（2026-07-26 完成） ​

  • 两类品牌名统一：ReadBrowser（管理的桌面产品）→ Lampio；ReadVocab Admin（工具自身）→ Lampio Admin（UI/侧栏/登录/dashboard/package.json name lampio-admin/deploy skill URL/下载名 lampio-pool/CHANGELOG/docs）。历史归档旧仓名 readvocab-admin 标注保留。admin tsc OK，双推完成。
  • ✅ 【用户】Vercel admin 项目已改名 readvocab-admin → lampio-admin（2026-07-26）。

H. ⚪ 文档 / Memory ​

  • README.md/CLAUDE.md/PROGRESS.md/CHANGELOG.md/docs/** 品牌名随触达更新；docs/archive/** 与 docs/plans/archive/** 不改（历史时点记录）。
  • memory project_brand_rename + MEMORY.md 已更新为 Lampio。

2. 分阶段执行（逐阶段用户确认后启动） ​

阶段 0（完成）

  • [x] 定名 Lampio + logo 母图 docs/brand/lampio-{icon,mark}.svg
  • [ ] Figma 微调母图 → 导出 1024 PNG →（首个签名版前顺带做一次免费代理清查）

阶段一：应用内 + landing 文案 ✅ 完成（2026-07-25）

  • [x] RB 应用内 + landing 文案 → Lampio；验证 landing tsc + RB tsc OK

DB 改名 ✅ 完成（2026-07-25）

  • [x] readbrowser.db → lampio.db（4 处一致，cargo check OK，存量本地库重置）

阶段二：仓库 / 外部身份（代码✅ / 用户操作 + push 待办）

  • [x] 代码跟改：download BASE / release.sh / SKILL.md / siteUrl → lampio
  • [x] 【用户】GitHub + Gitee 仓改名 lampio/lampio-releases（2026-07-25 完成）
  • [x] 【我】set-url remotes（github/origin → lampio）+ push 双推 4 commit（2026-07-25，github+Gitee 均到 cf7b5fe）
  • [ ] 验证：Vercel 重部署 landing 显示 Lampio + 下载链通（用户实测）；注册 lampio.app + Vercel NEXT_PUBLIC_SITE_URL（若未完成）

阶段三：身份关键 ✅ 大部完成（2026-07-25，提前做）

  • [x] productName→Lampio + identifier→com.lampio.dev + lib.rs 数据目录 + 脚本/skill 路径（cargo OK）；存量 dev 数据重置（用户接受）
  • [x] 重新发版 v0.1.0-dev.7 ✅（2026-07-26）：产出 Lampio_0.1.0_* 4 包（Win exe/msi + mac aarch64/x64 dmg）已发布对外 lampio-releases；修 release.yml（仓名+标题 Lampio 化，不再靠改名重定向）+ download.tsx（TAG→dev.7 + Lampio_* + Lampio.app）。下载页彻底 Lampio 化。
  • [ ] dev/prod identifier 拆分（com.lampio.dev / com.lampio）仍留正式 1.0（Release Prep 记忆）；与 schema.sql 冻结点同批

阶段四：跨端（新会话）

  • [x] RVH 改名 ✅（2026-07-25 独立会话完成：文案 + 身份项 com.lampio.app + logo；本地库不改名；上架名待发版。回执见 §F）
  • [ ] admin（§G）

3. 定名后填 ​

  • 锁定名：Lampio（2026-07-25）✅
  • Logo 母图：docs/brand/lampio-icon.svg + lampio-mark.svg ✅
  • 域名：lampio.app（.app/.io/.com 均空，待注册）
  • 首个签名版目标版本（identifier com.lampio 落地窗口，与 1.0 一起）：__________