headless-vault-cli

Headless Vault CLI 是一款通过 SSH 隧道实现 VPS 与本地计算机笔记库安全连接的工具技能。它允许用户在远程服务器上通过命令行界面管理位于个人电脑（macOS 或 Linux）上的 Markdown 笔记文件，解决了远程办公场景下无法直接访问本地知识库的难题。

核心用法围绕 vaultctl 命令行工具展开，通过预建立的反向 SSH 隧道（默认端口 2222）执行受限的文件操作。支持的功能包括浏览目录结构（tree）、查询文件元数据（info）、读取笔记内容（read）、创建新文件（create）以及向现有文件追加内容（append）。所有命令均通过 SSH 加密传输，支持 Base64 编码处理特殊字符路径，确保命令注入防护。

显著优点体现在其"最小权限"安全设计理念。与完整的文件管理系统不同，该技能明确禁用了删除（delete）、重命名（rename）、移动（move）和原地编辑（edit）等高危操作，仅允许追加式写入，极大降低了误操作或恶意操作导致数据丢失的风险。数据隐私方面表现优异，所有通信均通过用户自行控制的 SSH 隧道直连本地机器，无第三方服务器中转，无静默数据收集行为。

潜在缺点主要来自功能局限性和部署复杂度。功能上仅支持 Markdown 文件的简单读写，无法执行复杂的文件管理任务；不支持富文本或二进制文件处理；追加式编辑无法满足需要修改文件中间内容的需求。部署方面要求用户具备一定的系统管理能力，需要在本地计算机配置并持续运行 vaultctl 服务和 SSH 守护进程，且需手动维护隧道连接。此外，作为个人开发者项目（T3 来源），缺乏企业级的长期维护保障。

适合的目标群体主要包括：需要在 VPS 上处理本地笔记的远程开发者、追求数据隐私自托管的极客用户、以及希望通过自动化脚本管理知识库的高级用户。特别适用于"在云端 AI 助手协助下调取本地资料进行创作"的混合工作流场景。

使用风险主要集中在 SSH 密钥管理和服务端完整性上。用户需妥善保管 SSH 私钥，避免未授权访问；由于文件操作实际在远程端执行，需确保 vaultctl 服务端代码未被篡改；网络中断会导致服务不可用；此外，虽然技能本身无漏洞，但错误的 SSH 配置（如过于宽松的 IP 白名单）可能引入安全隐患。建议配合防火墙规则和定期备份使用。