Files
Thing/src-tauri/src/editor/webdav/mod.rs
T
2026-10-10 14:29:48 +08:00

69 lines
2.6 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! WebDAV 子模块:客户端与会话层。
//!
//! ```text
//! client.rs ── 协议层:PROPFIND / MKCOL / GET / PUT / DELETE / MOVE(quick-xml 解析)
//! mod.rs ── 会话层:读设置 → 取 keyring 密码 → 建客户端(供命令层一步调用)
//! sync.rs ── 引擎层:清单比对 / 冲突策略 / 执行与基线维护
//! ```
//!
//! 备份(zip 快照)在 `super::backup`:它只用 `PUT`,与同步是两条独立的路径
//! (规划 §3.6 的取舍:对「只是要个备份」的用户,快照比双向同步可靠得多)。
pub mod client;
pub mod sync;
use serde::{Deserialize, Serialize};
use specta::Type;
use crate::editor::types::WebdavSettings;
use client::WebdavClient;
/// keyring 里的服务名(与 `secrets.rs` 的约定一致,服务名固定 `"Thing"`)。
pub const KEYRING_PASSWORD: &str = "editor.webdav.password";
/// 连接自检结果(设置页展示)。
#[derive(Debug, Clone, Serialize, Deserialize, Type)]
#[serde(rename_all = "camelCase")]
pub struct WebdavTestResult {
/// 是否连通
pub ok: bool,
/// 远端根目录中已有的条目数(自检时顺带列出)
pub entries: u32,
/// 本次自检自动创建的目录
pub created: Vec<String>,
/// 人话结论(失败时是原因)
pub message: String,
}
/// 由设置构造客户端(密码从 keyring 取,**不落盘**)。
///
/// 密码走系统凭据管理器而不是 `settings.json`:设置文件是明文 JSON,用户可能把库
/// 连同设置一起放到同步目录里(那就等于把密码公开了)。keyring 的键是
/// [`KEYRING_PASSWORD`],服务名沿用项目统一的 `"Thing"`。
pub fn client_from(settings: &WebdavSettings) -> Result<WebdavClient, String> {
settings.validate()?;
let password = crate::secrets::secret_read(KEYRING_PASSWORD)
.ok()
.flatten()
.unwrap_or_default();
WebdavClient::new(client::WebdavConfig {
url: settings.url.trim().to_string(),
username: settings.username.trim().to_string(),
password,
remote_root: settings.remote_root.trim().to_string(),
})
}
/// 连接自检:验证地址/凭据,并按需逐级创建远端根目录。
pub fn test_connection(settings: &WebdavSettings) -> Result<WebdavTestResult, String> {
let client = client_from(settings)?;
let created = client.ensure_root()?;
let entries = client.list_recursive()?.len() as u32;
Ok(WebdavTestResult {
ok: true,
entries,
created,
message: format!("连接正常,远端已有 {entries} 个文件"),
})
}