摘要
摘要
Frontend UI 是个人 Wiki 的中文知识工作台。它保持 Markdown-first 与文件系统真相层不变，同时现在采用 Apple 风格设计系统、Vite 资产管线、HTMX 局部刷新与 Alpine 轻状态交互，提供搜索优先浏览、置顶入口、section landing、更细过滤、raw 引用追踪、quick note、文件上传，以及前端直接编辑置顶配置。
正文
当前页面
Frontend UI
Key Facts / Current Understanding
- 前端仍是本地优先、Markdown-first 架构的视图层，不是第二套真相层。
- 运行栈现在是 FastAPI SSR + Jinja2 + Vite + HTMX + Alpine，而不是重型 SPA。
- 首页已是 Apple 风格 search-first workspace，而不是通用 dashboard：搜索、primary actions、置顶页面、分区入口、最近活动都在首屏组织完成。
- 置顶页面配置仍存放在
~/wiki/_meta/pinned-pages.yaml，但现在可直接从首页“管理置顶”区域增删，不必手改 YAML。 - 置顶配置支持 pin
doc、page、raw，并可自定义标题与摘要。 - 每个正式 section 与 raw section 都有稳定入口：
/section/{section}。 - section landing 现在支持更细过滤：
- 页面分区支持
type、tag、source、time range - raw 分区支持
preview type、time range - page view 现在优先展示 summary，再展示正文、目录、sources、backlinks 与低优先级 frontmatter。
- page detail 现带有 Alpine 轻状态控制，用于目录与元数据折叠。
- raw view 现在展示 metadata、下载动作、next steps，以及
Referenced by关系。 - raw 图片预览现在支持前端 lightbox；PDF 仍保持原生 iframe embed + 下载回退。
- 置顶页面增删现在支持 HTMX 局部刷新，同时同步更新置顶卡片区域。
- 界面文案已切换为中文，但页面内容本身仍保持原始知识条目语言，不做强制翻译。
- 键盘快捷键
/与Ctrl/Cmd+K可直接聚焦全局搜索。 - 公网入口仍由
wiki.hazim.work提供，反代链路未改变。
Relationships
- 它是 personal-llm-wiki 的主要浏览与录入入口。
- 页面整理、索引更新、知识沉淀逻辑仍由 hermes-agent 驱动。
- 展示和交互设计受 claritas-frontend-design-principles 约束。
- 高价值问答的展示与沉淀仍要遵循 query-filing-policy。
Open Questions / Tensions
- 置顶页面后续是否还要支持拖拽排序与直接修改既有项，而不仅是新增/移除。
- section landing 是否还要继续增加过滤维度，但又不引入重型前端状态层。
- 随着规模增长，搜索层是否需要增强，但仍不能破坏 Markdown-first 结构。
Source Notes
MVP 构建记录见 frontend build note。redesign implementation note 记录了第一次工作台式重构；chinese/config/filter note 记录了中文与置顶能力；time/source filter note 记录了 section landing 的过滤增强；pin editor note 记录了前端直接编辑置顶配置的能力；apple rewrite note 记录了 Vite/HTMX/Alpine + Apple 风格重写与验证过程。