docs(redesign): add Logi reference spec and capture catalog#25
Draft
abraxas914 wants to merge 2 commits intoAhakeyAI:mainfrom
Draft
docs(redesign): add Logi reference spec and capture catalog#25abraxas914 wants to merge 2 commits intoAhakeyAI:mainfrom
abraxas914 wants to merge 2 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 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 from00-index.mdthrough10-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
.gitignoresocaptures/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.md到10-inspector-content-spec.md,覆盖信息架构、Studio 布局、状态机、视觉系统、Web/Electron 原型策略,以及 Inspector 内容归属。新增
captures/README.md、00-capture-index.md、按页面拆分的 manifest、notes,以及 Home、Device Studio、Settings、Agent、Voice 的 tracked 参考资产。更新
.gitignore,确保captures/raw-local/继续是本地工作区,不进入 git 历史。Not Included / 不包含
No
raw-localsource screenshot batchesNo runtime prototype code
No Swift or macOS implementation work
No backend integration artifacts
不包含
raw-local原始截图批次不包含原型运行时代码
不包含 Swift 或 macOS 实现
不包含后端接入产物
Review Guide / 审阅路径
Start with
platforms/macos/client/docs/redesign/00-redesign-index.md.Read
logi-options-plus-reference-spec/09-web-electron-prototype-spec.mdand10-inspector-content-spec.mdfor the latest prototype-facing rules.Review
04-device-studio-spec.md,06-state-machine-spec.md, and07-visual-system-spec.mdfor the core Studio behavior and styling decisions.Finish with
captures/README.md,captures/00-capture-index.md, and the page manifests undercaptures/tracked/.先看
platforms/macos/client/docs/redesign/00-redesign-index.md。再看
logi-options-plus-reference-spec/09-web-electron-prototype-spec.md与10-inspector-content-spec.md,这两份最直接对应当前原型。然后看
04-device-studio-spec.md、06-state-machine-spec.md、07-visual-system-spec.md,把 Studio 的核心行为和样式决策补全。最后看
captures/README.md、captures/00-capture-index.md,以及captures/tracked/下的各页 manifest。Companion Prototype PR / 配套原型 PR