# Wiki Frontend Pin Editor

Date: 2026-04-19

## Summary

首页现在可以直接编辑置顶配置，不再要求用户手动打开 `~/wiki/_meta/pinned-pages.yaml`。

## New Capabilities

### 1. Current pinned config panel
- 首页新增“管理置顶”区域
- 显示当前所有置顶项
- 每项显示：
  - 标题
  - 类型
  - 目标路径/标识
  - 摘要说明（若存在）
- 每项带“移除”按钮

### 2. Add pin form
- 首页新增“新增置顶项”表单
- 支持三类置顶：
  - `doc`
  - `page`
  - `raw`
- 表单字段：
  - 类型
  - 分区
  - 目标
  - 显示标题
  - 摘要说明

### 3. YAML remains source of truth
- UI 编辑最终仍写回 `~/wiki/_meta/pinned-pages.yaml`
- 配置文件格式未改，只是增加了前端入口
- 仍保持 Markdown / file-system first 架构

## Verification

- `python -m pytest /root/.hermes/wiki-ui/tests/test_app_smoke.py -q` → `12 passed`
- 本地首页检查通过：出现“管理置顶 / 新增置顶项 / 当前置顶配置”
- 反代首页检查通过：`wiki.hazim.work`