Skip to content

v1.2.0

Choose a tag to compare

@vicnoah vicnoah released this 21 Jan 08:08
· 19 commits to main since this release

[1.2.0] - 2026-01-21
Added
命令行帮助系统:为所有子命令添加 --help 支持

clearvault --help:显示所有可用命令
clearvault encrypt --help:显示 encrypt 命令详细帮助
clearvault export --help:显示 export 命令详细帮助
clearvault import --help:显示 import 命令详细帮助
clearvault server --help:显示 server 命令详细帮助
参数验证:增强必需参数的验证和错误提示

encrypt:验证 -in 和 -out 参数
export:验证 --paths 和 --output 参数
import:验证 --input 和 --share-key 参数
配置文件支持:所有子命令都支持 --config 参数

clearvault export --config config-s3.yaml ...
clearvault import --config config-s3.yaml ...
clearvault encrypt --config config.yaml ...
clearvault server --config config.yaml ...
Changed
命令结构重构:统一命令行使用方式

clearvault -in /path -out /dir → clearvault encrypt -in /path -out /dir
clearvault(无参数)→ clearvault server --config config.yaml
clearvault export --paths ... → 保持不变(新增 --config 支持)
clearvault import --input ... → 保持不变(新增 --config 支持)
代码结构优化:拆分 handleLegacyExport() 函数

新增 handleEncrypt():处理本地文件加密
新增 handleServer():处理 WebDAV 服务器启动
重构 handleExport():添加参数验证
重构 handleImport():添加参数验证
删除 handleLegacyExport() 函数
帮助信息改进:提供更清晰的使用说明

主帮助显示所有四个子命令
每个子命令都有详细的参数说明和示例
中英文混合的提示信息
Removed
旧版全局参数:移除不再使用的参数
-export-input
-export-output
Fixed
export 命令:修复不支持 --config 参数的问题
import 命令:修复不支持 --config 参数的问题
Migration Guide
从 v1.1.x 迁移到 v1.2.0
本地文件加密:

旧版

./clearvault -in /path/to/file -out /output/dir

新版

./clearvault encrypt -in /path/to/file -out /output/dir
启动 WebDAV 服务器:

旧版

./clearvault

新版

./clearvault server --config config.yaml
使用指定配置文件:

export 命令(新增支持)

./clearvault export --config config-s3.yaml --paths "/" --output output

import 命令(新增支持)

./clearvault import --config config-s3.yaml --input file.tar --share-key "password"

encrypt 命令(新增支持)

./clearvault encrypt --config config.yaml -in /path -out /output

server 命令(新增支持)

./clearvault server --config config.yaml
查看帮助:

查看所有命令

./clearvault --help

查看特定命令帮助

./clearvault encrypt --help
./clearvault export --help
./clearvault import --help
./clearvault server --help
[1.1.0] - 2026-01-19
Added
S3 远端存储支持:支持 S3 兼容存储(MinIO、Cloudflare R2、AWS S3 等)
简单分享功能:支持通过密码加密的 tar 包分享元数据
clearvault export:导出加密分享包
clearvault import:导入加密分享包
环境变量配置:支持通过环境变量配置所有参数
主密钥自动生成:首次启动时自动生成安全的主密钥
Changed
移除 SQLite 支持:统一使用 JSON 文件格式存储元数据
优化流式上传:修复大文件上传的内存溢出问题
[1.0.0] - 2026-01-18
Added
WebDAV 协议支持:完整的 WebDAV 协议实现
AES-256-GCM 加密:端到端加密支持
本地元数据存储:使用 JSON 文件存储元数据
Windows 兼容性:针对 RaiDrive 和 Windows 资源管理器优化
离线加密导出:支持本地批量加密后手动上传云端