核心用法
Headless Vault CLI 是一个通过反向SSH隧道连接远程VPS与本地个人电脑（macOS/Linux）的命令行工具，用于读取和管理本地Markdown笔记库。用户需在本地运行SSH隧道服务，VPS端通过vaultctl命令执行操作。
主要命令包括：
tree：浏览笔记目录结构，支持深度限制resolve：通过标题或路径查找笔记read/info：读取笔记内容或获取元数据（行数、哈希、修改时间等）create/append：创建新笔记或向现有笔记追加内容（强制使用base64编码处理含空格的路径和内容）set-root/check：设置笔记库根目录或验证隧道连接状态
显著优点
1. 远程访问本地数据：无需将敏感笔记上传云端，通过SSH隧道实现VPS对本地文件的受控访问
2. JSON格式输出：便于程序化解析和自动化工作流集成
3. 防误写设计：create命令在文件已存在时失败，避免意外覆盖；append仅限追加模式，降低数据损坏风险
4. base64编码支持：优雅处理含空格、特殊字符的文件路径和内容
潜在局限
1. 功能受限：不支持重命名、删除、移动文件，也不支持原地编辑（只能追加到末尾）
2. 依赖本地在线：本地电脑必须保持开机且隧道运行，否则无法访问
3. 单向隧道维护：需要用户自行维护反向SSH隧道的稳定性
4. 仅限Markdown：仅支持.md文件操作，无法处理其他格式
适合人群
- 希望在远程服务器上自动化处理本地笔记的开发者
- 注重数据隐私、不愿将笔记同步到云端的知识管理用户
- 已具备SSH和网络隧道基础技术能力的用户
常规风险
- SSH密钥安全：若VPS被入侵，攻击者可能通过隧道访问本地文件系统
- 路径遍历：需确保
vaultctl服务端正确验证路径，防止访问隧道外目录 - 数据一致性：
append操作非事务性，并发写入可能导致内容混乱 - 隧道中断：网络不稳定时可能丢失写操作反馈，需通过
check命令验证状态