feat(proto): add Logi-inspired AhaKey web shell prototype#24
Draft
abraxas914 wants to merge 3 commits intoAhakeyAI:mainfrom
Draft
feat(proto): add Logi-inspired AhaKey web shell prototype#24abraxas914 wants to merge 3 commits intoAhakeyAI:mainfrom
abraxas914 wants to merge 3 commits intoAhakeyAI:mainfrom
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary / 概要
This draft PR adds a Logi-inspired AhaKey web shell prototype under
platforms/macos/client/docs/prototypes/logi-web-shell/so we can review the front-end shell, information disclosure, and visual hierarchy in the browser before touching native shells.这个 draft PR 在
platforms/macos/client/docs/prototypes/logi-web-shell/下新增了一个受 Logi Options+ 启发的 AhaKey Web 原型,用来先在浏览器里审阅前台壳层、信息披露层级和视觉基调,再进入原生壳实现。Why / 为什么
Validate the Home -> Add Device -> Studio -> Settings flow, plus Voice / Background Service / Device Info pages, in a fast browser review loop.
Lock down the Studio disclosure model before SwiftUI or Electron packaging work.
Keep the exploration isolated from Swift, BLE, and backend integration risk.
用更快的浏览器迭代去验证 Home -> Add Device -> Studio -> Settings,以及语音 / 后台服务 / 设备信息页面。
在进入 SwiftUI 或 Electron 打包前,先把 Studio 的信息披露结构收稳。
让这轮探索与 Swift、BLE、后端接入风险解耦。
What Changed / 改动内容
Scaffolded a standalone Bun + React + Vite + TypeScript prototype with local Lexend loading and
@lobehub/iconsplatform logos.Added browser-reviewable Home, Add Device, Studio, Settings, Voice, Background Service, and Device Info flows with light/dark token sets and local mock state.
Kept platform visibility exclusive to the Studio top-right logo switcher and removed visible platform branding from page body, inspector, and system pages.
Reworked Home, Add Device, Studio, and Settings toward a lighter Logi/macOS hierarchy with fewer borders, quieter controls, and a right-docked inspector.
Added
DESIGN_NOTES.mdandREVIEW_GUIDE.mdto document the visual rules and review path for this prototype.搭建了一个独立的 Bun + React + Vite + TypeScript 原型工程,并接入本地 Lexend 字体与
@lobehub/icons平台 logo。补齐了可在浏览器中审阅的 Home、Add Device、Studio、Settings、语音、后台服务、设备信息页面,并提供 light/dark token 和本地 mock 状态。
将平台可见性收束到 Studio 右上角 logo 切换器,正文、Inspector 和系统页不再重复暴露平台品牌。
把 Home、Add Device、Studio、Settings 重新压向更轻的 Logi/macOS 层级,减少重边框、按钮感和解释性文案,并让 Inspector 固定停靠右侧。
新增
DESIGN_NOTES.md与REVIEW_GUIDE.md,沉淀这套原型的设计规则和审阅路径。Not Included / 不包含
No BLE / Agent / Voice backend integration
No Electron shell packaging
No Swift or macOS native code changes
No public API changes
不包含 BLE / Agent / Voice 后端接入
不包含 Electron 壳打包
不包含 Swift 或 macOS 原生代码修改
不包含公共 API 变更
Review Guide / 审阅路径
bun installbun run buildbun run preview -- --host 127.0.0.1 --port 4173Open http://127.0.0.1:4173/ and verify:
bun installbun run buildbun run preview -- --host 127.0.0.1 --port 4173打开 http://127.0.0.1:4173/ 后重点检查:
Companion Docs PR / 配套文档 PR
Screenshots / 截图