翻译模块

This commit is contained in:
zhongluofeng committed 2026-09-17 17:32:20 +08:00
1 parent 79c43d5340
commit f6c1cc250e
47 files changed
+10822 -104

No files matched your search

+7 -77
View File
@@ -1,22 +1,19 @@
//! 敏感串的统一存放处(Windows 系统凭据管理器,DPAPI 保护)。
//! 音乐模块的凭据键约定与便捷读取。
//!
//! 存在的理由:本项目里出现过**两种安全姿态**——WebDAV 账号密码走凭据管理器,
//! 而飞牛登录 token 与 QQ 音乐 Cookie 明文躺在 `settings.json` / localStorage。
//! 同样是可冒充身份的凭据,不该区别对待。
//! 底层读写原语已抽到 crate 级 [`crate::secrets`](同一套 `Thing` 服务名与迁移
//! 策略,翻译模块等其他使用者共享)。本文件只保留**音乐自己的键名**与
//! 「前端可达范围」这道闸门,读写一律委托给公共模块,避免出现第二套实现。
//!
//! 约定:
//! - 一律使用 `Thing` 作为凭据服务名,`key` 作为用户名(Entry 的 account)。
//! 服务名是历史值,改动会导致已有凭据读不到。
//! - 明文只允许存在于内存与系统凭据库,禁止回写 `settings.json` / localStorage。
//! - 迁移采用「先写凭据库成功、再清明文」的顺序;**写失败时保留明文**,
//! 宁可牺牲一致性也不能把用户已登录的会话弄丢。
//! - 非 Windows 平台没有凭据管理器:读取返回 None、写入报错,
//! 调用方据此退化为「明文存 settings」(功能优先)。
use crate::logger;
/// 凭据服务名(与历史实现一致,改动会导致已有 WebDAV 凭据读不到)。
#[cfg(windows)]
const SERVICE: &str = "Thing";
pub use crate::secrets::{secret_delete, secret_read, secret_write, try_store};
/// WebDAV 凭据的 key(**历史值,不可更改**)。
pub const KEY_WEBDAV: &str = "webdav-credentials";
@@ -43,79 +40,12 @@ pub fn frontend_key_allowed(key: &str) -> bool {
FRONTEND_KEYS.contains(&key)
}
/// 读取明文(未配置 → `Ok(None)`)。
#[cfg(windows)]
pub fn secret_read(key: &str) -> Result<Option<String>, String> {
let entry = keyring::Entry::new(SERVICE, key).map_err(|e| format!("无法访问系统凭据管理器: {e}"))?;
match entry.get_password() {
Ok(v) => Ok(Some(v)),
Err(keyring::Error::NoEntry) => Ok(None),
Err(e) => Err(format!("读取凭据失败: {e}")),
}
}
/// 写入明文(覆盖式)。
#[cfg(windows)]
pub fn secret_write(key: &str, value: &str) -> Result<(), String> {
let entry = keyring::Entry::new(SERVICE, key).map_err(|e| format!("无法访问系统凭据管理器: {e}"))?;
entry.set_password(value).map_err(|e| format!("保存凭据失败: {e}"))
}
/// 删除凭据(不存在视为成功)。
#[cfg(windows)]
pub fn secret_delete(key: &str) -> Result<(), String> {
let entry = keyring::Entry::new(SERVICE, key).map_err(|e| format!("无法访问系统凭据管理器: {e}"))?;
match entry.delete_credential() {
Ok(()) => Ok(()),
Err(keyring::Error::NoEntry) => Ok(()),
Err(e) => Err(format!("删除凭据失败: {e}")),
}
}
#[cfg(not(windows))]
pub fn secret_read(_key: &str) -> Result<Option<String>, String> {
Ok(None)
}
#[cfg(not(windows))]
pub fn secret_write(_key: &str, _value: &str) -> Result<(), String> {
Err("当前平台不支持系统凭据管理器".to_string())
}
#[cfg(not(windows))]
pub fn secret_delete(_key: &str) -> Result<(), String> {
Ok(())
}
/// 把明文**尽力**迁入凭据库(失败只记日志,不抛错)。
///
/// 返回「明文是否可以安全清除」:只有写入成功才为 true。
/// 调用方用这个返回值决定要不要清空内存/配置里的明文。
pub fn try_store(key: &str, value: &str) -> bool {
if value.is_empty() {
return true;
}
match secret_write(key, value) {
Ok(()) => true,
Err(e) => {
logger::log_error(
"music",
&format!("凭据 {key} 写入系统凭据管理器失败(保留明文作为降级): {e}"),
);
false
}
}
}
/// 读取飞牛连接 token;未配置或读取失败 → 空串(等价于未登录)。
pub fn read_feiniu_token(connection_id: &str) -> String {
if connection_id.is_empty() {
return String::new();
}
secret_read(&feiniu_token_key(connection_id))
.ok()
.flatten()
.unwrap_or_default()
crate::secrets::read_or_empty(&feiniu_token_key(connection_id))
}
/// 该连接是否已有可用 token(供前端展示「已登录」)。