核心功能
Headless Vault CLI 是一套基于 SSH 反向隧道的笔记管理工具，让远程 VPS 能够安全访问本地计算机上的 Markdown 笔记库。无需将笔记上传云端，即可实现跨设备读写。
显著优点
隐私优先架构：数据始终保留在本地设备，通过加密 SSH 隧道传输，规避云同步的隐私风险。
轻量无依赖：仅需 SSH 和单个二进制文件，无需数据库或复杂服务端部署。
Obsidian 兼容：直接读写本地 Markdown 文件，与 Obsidian 等主流笔记软件无缝协作。
原子化操作：提供 tree、resolve、info、read、create、append 七个核心命令，语义清晰，可组合使用。
潜在局限
功能受限：不支持删除、重命名、移动文件，无法编辑文件中间内容（仅追加），需配合本地工具完成复杂管理。
网络依赖：本地设备必须在线且隧道保持连接，断网即无法访问。
Base64 编码门槛：路径或内容含空格/特殊字符时需手动编码，增加使用复杂度。
单用户设计：无多用户权限体系，隧道配置需手动管理。
适用人群
- 注重隐私、拒绝云同步的 Markdown 重度用户
- 已使用 Obsidian 等本地优先笔记工具的知识管理者
- 需要在远程服务器与本地笔记间自动化数据流转的技术用户
常规风险
隧道配置失误：错误暴露 SSH 端口可能引发未授权访问，需严格限制 VAULT_SSH_PORT 绑定范围。
并发写入冲突：无文件锁机制，本地与远程同时编辑同一文件可能导致内容覆盖。
编码误用：未正确使用 --base64 处理特殊字符会导致命令解析失败或意外行为。
误操作不可逆：create 命令在文件存在时直接失败，但 append 无内容校验，过量追加难以撤回。