Skip to content

feat(proto): add Logi-inspired AhaKey web shell prototype#24

Draft
abraxas914 wants to merge 3 commits intoAhakeyAI:mainfrom
abraxas914:prototype/logi-web-shell
Draft

feat(proto): add Logi-inspired AhaKey web shell prototype#24
abraxas914 wants to merge 3 commits intoAhakeyAI:mainfrom
abraxas914:prototype/logi-web-shell

Conversation

@abraxas914
Copy link
Copy Markdown

@abraxas914 abraxas914 commented May 6, 2026

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/icons platform 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.md and REVIEW_GUIDE.md to 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.mdREVIEW_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 / 审阅路径

  1. bun install

  2. bun run build

  3. bun run preview -- --host 127.0.0.1 --port 4173

  4. Open http://127.0.0.1:4173/ and verify:

    • Home defaults to the no-device state and keeps the top-right actions light.
    • Add Device supports back, scan, discovered device, and handoff into Studio.
    • Studio keeps hardware pages in a desktop three-part layout, docks the inspector on the right, and collapses the left rail while the inspector is open.
    • Voice, Background Service, Device Info, and Settings stay aligned with the lighter Logi/macOS pacing.
    • Light and dark themes both remain readable.
  5. bun install

  6. bun run build

  7. bun run preview -- --host 127.0.0.1 --port 4173

  8. 打开 http://127.0.0.1:4173/ 后重点检查:

    • Home 默认进入无设备态,右上角操作区保持轻量。
    • Add Device 支持返回、扫描、发现设备,以及进入 Studio 的连接流转。
    • Studio 在硬件页保持桌面三段式布局,Inspector 固定在右侧,打开时左 rail 自动收起。
    • 语音、后台服务、设备信息、Settings 与更轻的 Logi/macOS 节奏保持一致。
    • light / dark 主题都保持可读。

Companion Docs PR / 配套文档 PR

Screenshots / 截图

Home

Studio

Settings

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant