DeepSeek Harness Tauri 桌面版 | Only 8mb installer, zero environment setup, preset plugins, Windows / macOS / Linux.
//! DSH 核心 Peer 依赖兼容性判定:从插件清单提取 `@deepseek-ai/dsh` 家族的
//! 依赖区间,用 semver 校验是否匹配当前运行时核心版本。任何解析异常一律
//! Fail-Open(视作兼容),避免判定失败反过来阻断正常安装。
use semver::{Comparator, Op, Version, VersionReq};
use serde::{Deserialize, Serialize};
use std::collections::BTreeMap;
/// DSH 核心包名;`@deepseek-ai/dsh-*` 子包同属一个运行时家族。
pub const DSH_PACKAGE: &str = "@deepseek-ai/dsh";
/// 只读检查结果:与前端 `PluginSearchResult` 同形(camelCase,可选字段省略)。
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct PluginInspect {
pub spec: String,
#[serde(skip_serializing_if = "Option::is_none")]
pub name: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub version: Option<String>,
pub compatible: Option<bool>,
#[serde(skip_serializing_if = "Option::is_none")]
pub peers: Option<BTreeMap<String, String>>,
#[serde(skip_serializing_if = "Option::is_none")]
pub problem: Option<String>,
}
pub fn is_dsh_package(name: &str) -> bool {
name == DSH_PACKAGE || name.starts_with("@deepseek-ai/dsh-")
}
/// 剥离声明协议前缀:`workspace:` / `catalog:` 等区间写法不是合法 semver,
/// 空值与 `*`/`^`/`~` 之类的无区间声明一律视为「无从判定」。
fn protocol_value(raw: &str) -> Option<&str> {
let trimmed = raw.trim();
if trimmed.is_empty() {
return None;
}
for prefix in ["workspace:", "catalog:", "portal:", "link:", "file:"] {
if let Some(rest) = trimmed.strip_prefix(prefix) {
let rest = rest.trim();
if rest.is_empty() || matches!(rest, "*" | "^" | "~") {
return None;
}
return Some(rest);
}
}
Some(trimmed)
}
/// 合并 `dependencies` 与 `peerDependencies` 中的 DSH 家族依赖;
/// peer 声明后处理,同名时覆盖 dependencies 的写法。
pub fn peers_from_manifest(manifest: &serde_json::Value) -> BTreeMap<String, String> {
let mut peers = BTreeMap::new();
for section in ["dependencies", "peerDependencies"] {
let Some(map) = manifest.get(section).and_then(serde_json::Value::as_object) else {
continue;
};
for (name, raw) in map {
if !is_dsh_package(name) {
continue;
}
let Some(raw) = raw.as_str() else {
continue;
};
let Some(value) = protocol_value(raw) else {
continue;
};
peers.insert(name.clone(), value.to_string());
}
}
peers
}
/// 区间是否命中给定版本——对齐内核安装校验的 `includePrerelease` 语义。
///
/// `semver` crate 对预发布版本另设门槛:必须存在比较符与本版本 major.minor.patch
/// 相同且自带 pre。`^0.1.7-rc.1` 因此漏掉 `0.1.8-rc.1` 这类同代更高补丁号的
/// 预发布核心,补一个对本版本恒真的精确比较符即可绕开门槛。
fn matches_including_prerelease(req: &VersionReq, version: &Version) -> bool {
let matched = req.matches(version);
if matched || version.pre.is_empty() {
return matched;
}
let mut bridged = req.clone();
bridged.comparators.push(Comparator {
op: Op::Exact,
major: version.major,
minor: Some(version.minor),
patch: Some(version.patch),
pre: version.pre.clone(),
});
bridged.matches(version)
}
/// 把 npm 习惯的空格分隔比较符(`>=1.2.3 <2.0.0`)归一到 `semver` crate
/// 接受的逗号分隔形式;无法归一或为空时返回 None。
fn normalize_range(raw: &str) -> Option<String> {
let mut parts: Vec<String> = Vec::new();
let mut pending: Option<String> = None;
for token in raw.split_whitespace() {
let token = token.trim_matches(',').trim();
if token.is_empty() {
continue;
}
if matches!(token, ">" | ">=" | "<" | "<=" | "=" | "^" | "~") {
pending = Some(token.to_string());
continue;
}
match pending.take() {
Some(op) => parts.push(format!("{op}{token}")),
None => match Version::parse(token.trim_start_matches('v')) {
Ok(version) => parts.push(format!("={version}")),
Err(_) => parts.push(token.to_string()),
},
}
}
if pending.is_some() || parts.is_empty() {
return None;
}
Some(parts.join(","))
}
/// 单个区间声明是否命中运行时版本。
///
/// 返回 `None` 表示无从判定(区间或运行时版本无法解析),调用方按 Fail-Open 处理;
/// `||` 分隔的备选区间任一命中即为兼容。
pub fn range_matches(raw: &str, runtime: &str) -> Option<bool> {
let range = protocol_value(raw)?;
let version = Version::parse(runtime.trim()).ok()?;
let mut parsed_any = false;
for alternative in range.split("||") {
let Some(normalized) = normalize_range(alternative) else {
continue;
};
let Ok(req) = VersionReq::parse(&normalized) else {
continue;
};
parsed_any = true;
if matches_including_prerelease(&req, &version) {
return Some(true);
}
}
if parsed_any {
Some(false)
} else {
None
}
}
/// 全量判定:无 DSH 家族依赖时返回 `None`(无从判定),否则任一声明明确不命中
/// 即不兼容;无法解析的声明一律按兼容放行。
pub fn evaluate(peers: &BTreeMap<String, String>, runtime: &str) -> Option<bool> {
if peers.is_empty() {
return None;
}
for raw in peers.values() {
if range_matches(raw, runtime) == Some(false) {
return Some(false);
}
}
Some(true)
}
#[cfg(test)]
mod tests {
use super::*;
use serde_json::json;
fn peers(entries: &[(&str, &str)]) -> BTreeMap<String, String> {
entries
.iter()
.map(|(name, raw)| (name.to_string(), raw.to_string()))
.collect()
}
#[test]
fn workspace_protocol_is_normalized_before_parsing() {
assert_eq!(range_matches("workspace:^0.2.0", "0.2.1"), Some(true));
assert_eq!(range_matches("workspace:^0.2.0", "0.3.0"), Some(false));
assert_eq!(range_matches("catalog:^0.2.0", "0.2.5"), Some(true));
assert_eq!(
range_matches("workspace:>=0.1.7-rc.1 <0.1.7-rc.5", "0.1.7-rc.3"),
Some(true)
);
}
#[test]
fn prerelease_versions_match_across_patch_bumps() {
assert_eq!(range_matches("^0.1.7-rc.1", "0.1.7-rc.2"), Some(true));
assert_eq!(range_matches("^0.1.7-rc.1", "0.1.8-rc.1"), Some(true));
assert_eq!(range_matches("^0.2.0-rc.1", "0.2.1-rc.1"), Some(true));
assert_eq!(range_matches("^0.1.7", "0.1.7-rc.1"), Some(false));
}
#[test]
fn bare_versions_are_exact_like_npm() {
assert_eq!(range_matches("0.2.0", "0.2.0"), Some(true));
assert_eq!(range_matches("0.2.0", "0.2.5"), Some(false));
assert_eq!(range_matches("0.2.0", "0.3.0"), Some(false));
assert_eq!(range_matches("=0.2.0", "0.2.5"), Some(false));
assert_eq!(range_matches(">=0.2.0 <0.3.0", "0.2.5"), Some(true));
assert_eq!(range_matches("^0.2.0", "0.2.5"), Some(true));
}
#[test]
fn invalid_range_degrades_to_unknown_and_stays_compatible() {
assert_eq!(range_matches("not a range", "0.2.0"), None);
assert_eq!(range_matches(">>>1.0.0", "0.2.0"), None);
assert_eq!(range_matches("", "0.2.0"), None);
assert_eq!(range_matches("^1.0.0", "not-a-version"), None);
assert_eq!(
evaluate(&peers(&[("@deepseek-ai/dsh", "garbage")]), "0.2.0"),
Some(true)
);
}
#[test]
fn alternatives_and_space_separated_comparators_are_supported() {
assert_eq!(range_matches("^1.0.0 || ^0.2.0", "0.2.3"), Some(true));
assert_eq!(range_matches("^1.0.0 || ^0.3.0", "0.2.3"), Some(false));
assert_eq!(range_matches(">=0.1.0 <0.3.0", "0.2.0"), Some(true));
}
#[test]
fn manifest_merges_dependencies_and_peer_dependencies_of_the_dsh_family() {
let manifest = json!({
"dependencies": {
"@deepseek-ai/dsh-fs": "^0.1.0",
"@deepseek-ai/dsh-llm": "^0.1.0",
"dshmarket": "^1.0.0",
"@deepseek-ai/other": "^1.0.0"
},
"peerDependencies": {
"@deepseek-ai/dsh-llm": "^0.1.7-rc.1",
"@deepseek-ai/dsh": "^0.2.0"
}
});
let merged = peers_from_manifest(&manifest);
assert_eq!(merged.len(), 3);
assert_eq!(
merged.get("@deepseek-ai/dsh-llm").map(String::as_str),
Some("^0.1.7-rc.1")
);
assert_eq!(
merged.get("@deepseek-ai/dsh-fs").map(String::as_str),
Some("^0.1.0")
);
assert_eq!(
merged.get("@deepseek-ai/dsh").map(String::as_str),
Some("^0.2.0")
);
assert!(!merged.contains_key("dshmarket"));
assert!(!merged.contains_key("@deepseek-ai/other"));
assert!(is_dsh_package("@deepseek-ai/dsh"));
assert!(is_dsh_package("@deepseek-ai/dsh-llm"));
assert!(!is_dsh_package("@deepseek-ai/dshx"));
}
#[test]
fn evaluate_reports_unknown_without_family_peers() {
assert_eq!(evaluate(&BTreeMap::new(), "0.2.0"), None);
assert_eq!(
evaluate(&peers(&[("@deepseek-ai/dsh", "^0.2.0")]), "0.2.0-rc.1"),
Some(false)
);
assert_eq!(
evaluate(
&peers(&[
("@deepseek-ai/dsh", "^0.2.0"),
("@deepseek-ai/dsh-llm", "^0.2.0-rc.1"),
]),
"0.2.0"
),
Some(true)
);
}
}