Skip to content

docs(redesign): add Logi reference spec and capture catalog#25

Draft
abraxas914 wants to merge 2 commits intoAhakeyAI:mainfrom
abraxas914:docs/logi-reference-spec
Draft

docs(redesign): add Logi reference spec and capture catalog#25
abraxas914 wants to merge 2 commits intoAhakeyAI:mainfrom
abraxas914:docs/logi-reference-spec

Conversation

@abraxas914
Copy link
Copy Markdown

@abraxas914 abraxas914 commented May 6, 2026

Summary / 概要

This draft PR adds the Logi reference spec set and capture catalog under platforms/macos/client/docs/redesign/ so the visual decisions behind the prototype can be reviewed, reused, and implemented without re-deriving them from chat history.

这个 draft PR 在 platforms/macos/client/docs/redesign/ 下补齐了 Logi 参考 spec 与 capture catalog,让原型背后的视觉判断、信息披露规则和落库方案可以被稳定复用,而不必反复从聊天记录里回溯。

Why / 为什么

  • Capture the high-priority reference hierarchy: Logi screenshots first, Logi tokens second, real AhaKey constraints next, old AI-generated spec last.

  • Make Studio disclosure, inspector boundaries, and capture storage rules explicit before native implementation begins.

  • Separate enduring product/design guidance from the runtime prototype branch.

  • 把参考优先级明确沉淀下来:Logi 截图最高,Logi token 次之,真实 AhaKey 约束再次,旧的 AI spec 最后。

  • 在原生实现开始前,把 Studio 信息披露、Inspector 边界和 capture 落库规则写清楚。

  • 将可长期复用的产品 / 设计判断与运行时代码原型分开维护。

What Changed / 改动内容

  • Added redesign index, glossary, home page, device studio page, and UX state machine docs at the root of docs/redesign/.

  • Added the dedicated logi-options-plus-reference-spec/ set from 00-index.md through 10-inspector-content-spec.md, covering IA, Studio layout, state machine, visual system, web/electron prototype guidance, and inspector content ownership.

  • Added captures/README.md, 00-capture-index.md, per-page manifests, notes, and selected tracked reference assets for Home, Device Studio, Settings, Agent, and Voice.

  • Updated .gitignore so captures/raw-local/ remains a local-only working set and does not enter git history.

  • docs/redesign/ 根级新增了 redesign index、glossary、home page、device studio page 和 UX state machine 文档。

  • 新增 logi-options-plus-reference-spec/ 专题文档集,从 00-index.md10-inspector-content-spec.md,覆盖信息架构、Studio 布局、状态机、视觉系统、Web/Electron 原型策略,以及 Inspector 内容归属。

  • 新增 captures/README.md00-capture-index.md、按页面拆分的 manifest、notes,以及 Home、Device Studio、Settings、Agent、Voice 的 tracked 参考资产。

  • 更新 .gitignore,确保 captures/raw-local/ 继续是本地工作区,不进入 git 历史。

Not Included / 不包含

  • No raw-local source screenshot batches

  • No runtime prototype code

  • No Swift or macOS implementation work

  • No backend integration artifacts

  • 不包含 raw-local 原始截图批次

  • 不包含原型运行时代码

  • 不包含 Swift 或 macOS 实现

  • 不包含后端接入产物

Review Guide / 审阅路径

  1. Start with platforms/macos/client/docs/redesign/00-redesign-index.md.

  2. Read logi-options-plus-reference-spec/09-web-electron-prototype-spec.md and 10-inspector-content-spec.md for the latest prototype-facing rules.

  3. Review 04-device-studio-spec.md, 06-state-machine-spec.md, and 07-visual-system-spec.md for the core Studio behavior and styling decisions.

  4. Finish with captures/README.md, captures/00-capture-index.md, and the page manifests under captures/tracked/.

  5. 先看 platforms/macos/client/docs/redesign/00-redesign-index.md

  6. 再看 logi-options-plus-reference-spec/09-web-electron-prototype-spec.md10-inspector-content-spec.md,这两份最直接对应当前原型。

  7. 然后看 04-device-studio-spec.md06-state-machine-spec.md07-visual-system-spec.md,把 Studio 的核心行为和样式决策补全。

  8. 最后看 captures/README.mdcaptures/00-capture-index.md,以及 captures/tracked/ 下的各页 manifest。

Companion Prototype PR / 配套原型 PR

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