Hyday Vault Layout 是一个用于定位、浏览和导航 Hyday 笔记库（vault）的技能。Hyday 笔记库本质上只是电脑上的一个普通文件夹，其中以明文 .md 文件读写内容，不锁在数据库里。该技能描述了文件夹约定，让智能体能够正确放置、查找和重命名文件。
用途：在使用任何其他 Hyday 技能（如 hyday-markdown、hyday-lifelog、hyday-whiteboard）前，先确定笔记库根目录。若跳过此步骤，可能把文件写到错误目录或静默失败。
主要能力：解析笔记库根路径。第 0 步要求优先读取 Hyday 配置文件中的 journalPath 字段，而不是猜测或直接询问用户。配置文件位置：macOS 为 ~/Library/Application Support/Hyday/settings.json，Windows 为 %APPDATA%\Hyday\settings.json。解析顺序为：显式覆盖（用户输入路径或环境变量 HYDAY_DATA_ROOT）、读取 settings.json 的 journalPath、回退到 ~/.hyday-recovery、最后才询问用户。解析后需做合理性检查：目录存在，且满足以下之一——存在 journal/<year>/ 子文件夹、根目录有带 YAML frontmatter 的 .md 文件、或存在 templates/ 或 .hyday/ 子文件夹。
文件夹约定：journal/<year>/ 存放每日日志，文件名 YYYY-MM-DD.md；templates/ 存放笔记模板，会出现在 Hyday 的“新增筆記 → 從範本”菜单；assets/ 存放图片和附件，不作为笔记索引；其余 .md 文件作为常规笔记索引。此外还兼容旧格式：<vault-root>/<YYYY>/<YYYY-MM-DD>.md 和 <vault-root>/<YYYY-MM-DD>.md，新笔记库推荐 journal/<year>/<date>.md。
文件命名：日志必须为 YYYY-MM-DD.md 或 YYYY.MM.DD.md，其他类似日期但不符合规则的按常规笔记处理。常规笔记用描述性文件名加 .md 结尾，避免 macOS/Windows 非法字符，避免日期形状文件名。
自动写入内容：Hyday 会自动维护 .notes-index/ 索引缓存、.hyday/whiteboards-v2.json 白板数据、.hyday/ 其他 sidecar 以及 *.tlayout 表格布局等。智能体不应直接改动这些，只读写 .md 文件和 assets/ 内文件；白板数据应通过 hyday-whiteboard MCP 服务器操作。
使用方式：新增笔记时先判断类型——日志放 journal/<year>/<YYYY-MM-DD>.md，常规笔记放 <vault-root>/<slug>.md 或非保留子文件夹，模板放 templates/<slug>.md；写入正确相对路径和 frontmatter，Hyday 通常几秒内自动拾取，无需重启。查找笔记时先按标题搜索，因为显示名来自 frontmatter 标题而非文件名；可用 grep -l 'title: "Project Alpha"' <vault-root>/**/*.md 查找；日志文件名即日期，直接定位。重命名文件时若标题不变，反向链接不受影响；若改标题，需扫描并更新 [[old-title]] 形式的反向链接。
适用场景：需要外部智能体或脚本在 Hyday 笔记库中读写笔记、日志、模板等文件时。限制：必须遵守解析顺序和合理性检查；不要触碰索引、白板、sidecar 等自动生成内容；不要假设默认目录；Hyday 无默认位置。其他更细节的 frontmatter、日志标记、白板结构分别见 hyday-markdown、hyday-lifelog、hyday-whiteboard 技能。