Compare commits
12 Commits
develop
...
feature-v0
| Author | SHA1 | Date | |
|---|---|---|---|
| 3db8945e16 | |||
| 219a6b3d51 | |||
| 9e1051737a | |||
| 8aba995fb0 | |||
| 0ac7a07133 | |||
| 75103dae3c | |||
| c7999a90f6 | |||
| 428da76a81 | |||
| f59040c11e | |||
| e3cb065b35 | |||
| 5e69a6a980 | |||
| ed5439eaa1 |
1
.gitignore
vendored
1
.gitignore
vendored
@@ -1,4 +1,5 @@
|
||||
/target
|
||||
/.vscode
|
||||
/.idea
|
||||
*.exe
|
||||
./Cargo.lock
|
||||
|
||||
333
Cargo.lock
generated
333
Cargo.lock
generated
@@ -2,6 +2,21 @@
|
||||
# It is not intended for manual editing.
|
||||
version = 4
|
||||
|
||||
[[package]]
|
||||
name = "aho-corasick"
|
||||
version = "1.1.5"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "c982642fa9e8606056828ee9a8505737230110bb1099153c79efe865c59d12ba"
|
||||
dependencies = [
|
||||
"memchr",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "anyhow"
|
||||
version = "1.0.104"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "330a5ed07fa54e4702c9d6c4174f74427fc0ef6e214bbd677ae50a5099946470"
|
||||
|
||||
[[package]]
|
||||
name = "autocfg"
|
||||
version = "1.5.1"
|
||||
@@ -26,9 +41,9 @@ dependencies = [
|
||||
|
||||
[[package]]
|
||||
name = "cc"
|
||||
version = "1.4.2"
|
||||
version = "1.4.3"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "5d262e149917187838d5b42777c8253bcb64500067342904e7d429499a6f277e"
|
||||
checksum = "509591b7bcd67f4ef775afad7662703b4935daaa6ec0e5605cfb1090b32a2b6d"
|
||||
dependencies = [
|
||||
"find-msvc-tools",
|
||||
"shlex",
|
||||
@@ -40,6 +55,33 @@ version = "1.0.4"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
|
||||
|
||||
[[package]]
|
||||
name = "crossbeam-channel"
|
||||
version = "0.5.16"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "d85363c37faeca707aef026efa9f3b34d077bce547e48f770770625c6013679e"
|
||||
dependencies = [
|
||||
"crossbeam-utils",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "crossbeam-utils"
|
||||
version = "0.8.22"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "61803da095bee82a81bb1a452ecc25d3b2f1416d1897eb86430c6159ef717c17"
|
||||
|
||||
[[package]]
|
||||
name = "deranged"
|
||||
version = "0.5.8"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "7cd812cc2bc1d69d4764bd80df88b4317eaef9e773c75226407d9bc0876b211c"
|
||||
|
||||
[[package]]
|
||||
name = "dunce"
|
||||
version = "1.0.5"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "92773504d58c093f6de2459af4af33faa518c13451eb8f2b5698ed3d36e7c813"
|
||||
|
||||
[[package]]
|
||||
name = "either"
|
||||
version = "1.17.0"
|
||||
@@ -48,18 +90,15 @@ checksum = "9e5e8f6c15a24b9a3ee5efec809ccd006d3b30e8b3bb63c39af737c7f87daa1d"
|
||||
|
||||
[[package]]
|
||||
name = "find-msvc-tools"
|
||||
version = "0.1.10"
|
||||
version = "0.1.11"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "26b73573e6edcd2af0cdf47bd6cb58f0b3839491263c314eaad1ccf24430e1de"
|
||||
checksum = "d45db016d36b838f563236e9193d0ee6ce38f3f68b6c94e914b4929c96bbb890"
|
||||
|
||||
[[package]]
|
||||
name = "fs-err"
|
||||
version = "3.3.1"
|
||||
name = "lazy_static"
|
||||
version = "1.5.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "b91aa448ca50d7e79433bdf3ee8d99215430d2ec02ade5aefab2a073a1822e8a"
|
||||
dependencies = [
|
||||
"autocfg",
|
||||
]
|
||||
checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
|
||||
|
||||
[[package]]
|
||||
name = "libc"
|
||||
@@ -76,6 +115,12 @@ dependencies = [
|
||||
"scopeguard",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "log"
|
||||
version = "0.4.33"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "0ceec5bc11778974d1bcb055b18002eba7f4b3518b6a0081b3af5f21666da9ad"
|
||||
|
||||
[[package]]
|
||||
name = "lua-src"
|
||||
version = "550.1.1"
|
||||
@@ -95,12 +140,35 @@ dependencies = [
|
||||
"which",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "matchers"
|
||||
version = "0.2.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "d1525a2a28c7f4fa0fc98bb91ae755d1e2d1505079e05539e35bc876b5d65ae9"
|
||||
dependencies = [
|
||||
"regex-automata",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "memchr"
|
||||
version = "2.8.3"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
|
||||
|
||||
[[package]]
|
||||
name = "mirror"
|
||||
version = "0.1.0"
|
||||
dependencies = [
|
||||
"anyhow",
|
||||
"dunce",
|
||||
"mlua",
|
||||
"tinyjson",
|
||||
"tracing",
|
||||
"tracing-appender",
|
||||
"tracing-subscriber",
|
||||
"windows-sys",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "mlua"
|
||||
version = "0.12.0"
|
||||
@@ -130,6 +198,21 @@ dependencies = [
|
||||
"pkg-config",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "nu-ansi-term"
|
||||
version = "0.50.3"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "7957b9740744892f114936ab4a57b3f487491bbeafaf8083688b16841a4240e5"
|
||||
dependencies = [
|
||||
"windows-sys",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "num-conv"
|
||||
version = "0.2.2"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "521739c6d2bac4aa25192232afe6841231376b2b26d4d9fae5ecf8ca5772e441"
|
||||
|
||||
[[package]]
|
||||
name = "num-traits"
|
||||
version = "0.2.19"
|
||||
@@ -139,6 +222,12 @@ dependencies = [
|
||||
"autocfg",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "once_cell"
|
||||
version = "1.21.4"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
|
||||
|
||||
[[package]]
|
||||
name = "parking_lot"
|
||||
version = "0.12.5"
|
||||
@@ -163,10 +252,22 @@ dependencies = [
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "pkg-config"
|
||||
version = "0.3.33"
|
||||
name = "pin-project-lite"
|
||||
version = "0.2.17"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "19f132c84eca552bf34cab8ec81f1c1dcc229b811638f9d283dceabe58c5569e"
|
||||
checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd"
|
||||
|
||||
[[package]]
|
||||
name = "pkg-config"
|
||||
version = "0.3.34"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "f6b464fbc74e149a392436b17d523f769e057cb6877f6a5c4618bc6f11800548"
|
||||
|
||||
[[package]]
|
||||
name = "powerfmt"
|
||||
version = "0.2.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "439ee305def115ba05938db6eb1644ff94165c5ab5e9420d1c1bcedbba909391"
|
||||
|
||||
[[package]]
|
||||
name = "proc-macro2"
|
||||
@@ -196,16 +297,22 @@ dependencies = [
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "rshim"
|
||||
version = "0.1.0"
|
||||
name = "regex-automata"
|
||||
version = "0.4.18"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "ad8553b9b26413251cbf30e620595c7a41b3887f03da04579c0e6b0d6a06b4b2"
|
||||
dependencies = [
|
||||
"fs-err",
|
||||
"mlua",
|
||||
"thiserror",
|
||||
"unicode-bom",
|
||||
"winapi",
|
||||
"aho-corasick",
|
||||
"memchr",
|
||||
"regex-syntax",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "regex-syntax"
|
||||
version = "0.8.11"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
|
||||
|
||||
[[package]]
|
||||
name = "rustc-hash"
|
||||
version = "2.1.3"
|
||||
@@ -235,7 +342,16 @@ checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"syn",
|
||||
"syn 3.0.3",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "sharded-slab"
|
||||
version = "0.1.7"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "f40ca3c46823713e0d4209592e8d6e826aa57e928f09752619fc696c499637f6"
|
||||
dependencies = [
|
||||
"lazy_static",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
@@ -250,6 +366,23 @@ version = "1.15.2"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "8ed6a63f02c8539c91a8685a86f4099661ba3da017932f6ebbea6de3f0fa7c90"
|
||||
|
||||
[[package]]
|
||||
name = "symlink"
|
||||
version = "0.1.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "a7973cce6668464ea31f176d85b13c7ab3bba2cb3b77a2ed26abd7801688010a"
|
||||
|
||||
[[package]]
|
||||
name = "syn"
|
||||
version = "2.0.119"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"unicode-ident",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "syn"
|
||||
version = "3.0.3"
|
||||
@@ -278,14 +411,127 @@ checksum = "bc04cd3e1236dd4a98afca4569f2deb3f120e5422a4023be2cb683f8486292af"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"syn",
|
||||
"syn 3.0.3",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "unicode-bom"
|
||||
version = "2.0.3"
|
||||
name = "thread_local"
|
||||
version = "1.1.10"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "7eec5d1121208364f6793f7d2e222bf75a915c19557537745b195b253dd64217"
|
||||
checksum = "1ad99c4c6d32803332c548b1af0540b357b3f5fc0be8f6c6bfe8b2e6ae784070"
|
||||
dependencies = [
|
||||
"cfg-if",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "time"
|
||||
version = "0.3.55"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "cdb87b95ec50ddfa440816d227a17b2ccbdda963a316a727fda0fc4334f7d134"
|
||||
dependencies = [
|
||||
"deranged",
|
||||
"num-conv",
|
||||
"powerfmt",
|
||||
"serde_core",
|
||||
"time-core",
|
||||
"time-macros",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "time-core"
|
||||
version = "0.1.9"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "9e1c906769ad99c88eaa54e728060edef082f8e358ff32030cb7c7d315e81109"
|
||||
|
||||
[[package]]
|
||||
name = "time-macros"
|
||||
version = "0.2.32"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "7e689342a48d2ea927c87ea50cabf8594854bf940e9310208848d680d668ed85"
|
||||
dependencies = [
|
||||
"num-conv",
|
||||
"time-core",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "tinyjson"
|
||||
version = "2.5.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "9ab95735ea2c8fd51154d01e39cf13912a78071c2d89abc49a7ef102a7dd725a"
|
||||
|
||||
[[package]]
|
||||
name = "tracing"
|
||||
version = "0.1.44"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "63e71662fa4b2a2c3a26f570f037eb95bb1f85397f3cd8076caed2f026a6d100"
|
||||
dependencies = [
|
||||
"pin-project-lite",
|
||||
"tracing-attributes",
|
||||
"tracing-core",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "tracing-appender"
|
||||
version = "0.2.5"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "050686193eb999b4bb3bc2acfa891a13da00f79734704c4b8b4ef1a10b368a3c"
|
||||
dependencies = [
|
||||
"crossbeam-channel",
|
||||
"symlink",
|
||||
"thiserror",
|
||||
"time",
|
||||
"tracing-subscriber",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "tracing-attributes"
|
||||
version = "0.1.31"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "7490cfa5ec963746568740651ac6781f701c9c5ea257c58e057f3ba8cf69e8da"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"syn 2.0.119",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "tracing-core"
|
||||
version = "0.1.36"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "db97caf9d906fbde555dd62fa95ddba9eecfd14cb388e4f491a66d74cd5fb79a"
|
||||
dependencies = [
|
||||
"once_cell",
|
||||
"valuable",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "tracing-log"
|
||||
version = "0.2.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "ee855f1f400bd0e5c02d150ae5de3840039a3f54b025156404e34c23c03f47c3"
|
||||
dependencies = [
|
||||
"log",
|
||||
"once_cell",
|
||||
"tracing-core",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "tracing-subscriber"
|
||||
version = "0.3.23"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "cb7f578e5945fb242538965c2d0b04418d38ec25c79d160cd279bf0731c8d319"
|
||||
dependencies = [
|
||||
"matchers",
|
||||
"nu-ansi-term",
|
||||
"once_cell",
|
||||
"regex-automata",
|
||||
"sharded-slab",
|
||||
"smallvec",
|
||||
"thread_local",
|
||||
"tracing",
|
||||
"tracing-core",
|
||||
"tracing-log",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "unicode-ident"
|
||||
@@ -293,6 +539,12 @@ version = "1.0.24"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
|
||||
|
||||
[[package]]
|
||||
name = "valuable"
|
||||
version = "0.1.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "ba73ea9cf16a25df0c8caa16c51acb937d5712a8429db78a3ee29d5dcacd3a65"
|
||||
|
||||
[[package]]
|
||||
name = "which"
|
||||
version = "8.0.5"
|
||||
@@ -302,30 +554,17 @@ dependencies = [
|
||||
"libc",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "winapi"
|
||||
version = "0.3.9"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"
|
||||
dependencies = [
|
||||
"winapi-i686-pc-windows-gnu",
|
||||
"winapi-x86_64-pc-windows-gnu",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "winapi-i686-pc-windows-gnu"
|
||||
version = "0.4.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
|
||||
|
||||
[[package]]
|
||||
name = "winapi-x86_64-pc-windows-gnu"
|
||||
version = "0.4.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
|
||||
|
||||
[[package]]
|
||||
name = "windows-link"
|
||||
version = "0.2.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
|
||||
|
||||
[[package]]
|
||||
name = "windows-sys"
|
||||
version = "0.61.2"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
|
||||
dependencies = [
|
||||
"windows-link",
|
||||
]
|
||||
|
||||
48
Cargo.toml
48
Cargo.toml
@@ -1,32 +1,38 @@
|
||||
[package]
|
||||
name = "rshim"
|
||||
name = "mirror"
|
||||
version = "0.1.0"
|
||||
authors = ["anonymous <anonymous@example.com>"]
|
||||
edition = "2024"
|
||||
|
||||
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
|
||||
|
||||
rust-version = "1.94"
|
||||
license = "MIT OR Unlicense"
|
||||
description = "A fast, safe Rust shim launcher for Scoop"
|
||||
|
||||
[profile.release]
|
||||
opt-level = "z"
|
||||
panic = "abort"
|
||||
|
||||
[dependencies]
|
||||
fs-err = "3.3.1"
|
||||
unicode-bom = "2.0.3"
|
||||
thiserror={version = "2.0.20"}
|
||||
mlua = { version = "0.12.0", features = ["lua54", "vendored"] }
|
||||
winapi = { version = "0.3", features = [
|
||||
"wincon",
|
||||
"consoleapi",
|
||||
"minwindef",
|
||||
"shellapi",
|
||||
"winuser",
|
||||
"synchapi",
|
||||
"combaseapi",
|
||||
"winbase",
|
||||
"processthreadsapi",
|
||||
"objbase",
|
||||
"impl-default"
|
||||
anyhow = "1.0.104"
|
||||
|
||||
mlua = { version = "0.12.0", features = ["lua54", "vendored","send"] }
|
||||
windows-sys = { version = "0.61.2", features = [
|
||||
"Win32_Foundation",
|
||||
"Win32_System_Com",
|
||||
"Win32_System_Console",
|
||||
"Win32_System_Registry",
|
||||
"Win32_System_Threading",
|
||||
"Win32_UI_Shell",
|
||||
"Win32_UI_WindowsAndMessaging",
|
||||
"Win32_Globalization"
|
||||
] }
|
||||
dunce = "1.0.5"
|
||||
|
||||
# 日志
|
||||
tracing = "0.1.44"
|
||||
tracing-subscriber = { version = "0.3", features = ["env-filter","fmt"] }
|
||||
tracing-appender = "0.2"
|
||||
tinyjson="2.5.1"
|
||||
|
||||
|
||||
[features]
|
||||
default = ["args"]
|
||||
args=[]
|
||||
21
build.rs
21
build.rs
@@ -18,30 +18,29 @@ fn main() {
|
||||
// 在 target/debug/ 或 target/release/ 下创建 bin2 目录
|
||||
let output_dir = target_dir.join(&profile).join("bin2");
|
||||
|
||||
|
||||
// cargo:rerun-if-changed -> 当指定文件变化时，重新运行 xxx
|
||||
println!("cargo:rerun-if-changed=build.rs");
|
||||
println!("cargo:rerun-if-changed=shims.lua");
|
||||
println!("cargo:rerun-if-changed=mirror.lua");
|
||||
println!("cargo:rustc-env=OUTPUT_DIR={}", output_dir.display());
|
||||
|
||||
// 创建目录
|
||||
let dirs = ["bin", "tools"];
|
||||
for dir in &dirs {
|
||||
let path = output_dir.join(dir);
|
||||
let subdirs = ["bin", "tools"];
|
||||
for subdir in &subdirs {
|
||||
let path = output_dir.join(subdir);
|
||||
if !path.exists() {
|
||||
fs::create_dir_all(&path).expect(&format!("Failed to create {} directory", dir));
|
||||
fs::create_dir_all(&path).expect(&format!("Failed to create {} directory", subdir));
|
||||
println!("Created: {:?}", path);
|
||||
}
|
||||
}
|
||||
|
||||
// 复制文件
|
||||
let source = PathBuf::from(&manifest_dir).join("shims.lua");
|
||||
let destination = output_dir.join("shims.lua");
|
||||
let source = PathBuf::from(&manifest_dir).join("mirror.lua");
|
||||
let destination = output_dir.join("mirror.lua");
|
||||
|
||||
if source.exists() {
|
||||
fs::copy(&source, &destination).expect("Failed to copy shims.lua");
|
||||
println!("Copied shims.lua to: {:?}", destination);
|
||||
fs::copy(&source, &destination).expect("Failed to copy mirror.lua");
|
||||
println!("Copied mirror.lua to: {:?}", destination);
|
||||
} else {
|
||||
panic!("shims.lua not found at: {:?}", source);
|
||||
panic!("mirror.lua not found at: {:?}", source);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
-- shims.lua (总控制台)
|
||||
-- __SHIM_DIR__ 已经在 Rust 中注入完毕，并且是正斜杠格式 (例如 C:/Tools)
|
||||
local base_dir = __SHIM_DIR__
|
||||
-- mirror.lua (总控制台)
|
||||
-- __MIRROR_DIR__ 已经在 Rust 中注入完毕，并且是正斜杠格式 (例如 C:/Tools)
|
||||
local base_dir = __MIRROR_DIR__
|
||||
|
||||
-- 1. 自定义局部变量，方便复用与后续维护
|
||||
local python_home = base_dir .. "/tools/python39"
|
||||
@@ -9,8 +9,20 @@ return {
|
||||
---------------------------------------------------
|
||||
-- 1. 标准相对路径 + 正斜杠拼接 (最推荐，绿色便携)
|
||||
---------------------------------------------------
|
||||
["numa"] = {
|
||||
target = base_dir .. "/tools/numa/numa.exe",
|
||||
-- 追加参数
|
||||
args = { "--help" },
|
||||
|
||||
aliases = {},
|
||||
-- 注入环境变量，使用 get_env 获取宿主机当前值
|
||||
env = {
|
||||
PATH = { base_dir .. "/tools/numa", get_env("PATH") }
|
||||
}
|
||||
},
|
||||
|
||||
["git"] = {
|
||||
path = base_dir .. "/git/bin/git.exe",
|
||||
target = base_dir .. "/git/bin/git.exe",
|
||||
-- 追加参数
|
||||
args = { "--no-pager" },
|
||||
-- 注入环境变量，使用 get_env 获取宿主机当前值
|
||||
@@ -24,7 +36,7 @@ return {
|
||||
---------------------------------------------------
|
||||
["python"] = {
|
||||
-- 在 [[]] 内部，\ 不需要写成 \\，直接粘贴即可
|
||||
path = [[C:\Python310\python.exe]],
|
||||
target = [[C:\Python310\python.exe]],
|
||||
args = { "-B" },
|
||||
-- 空字典也是合法的，等同于不设置
|
||||
env = {
|
||||
@@ -46,12 +58,13 @@ return {
|
||||
-- 3. 极简参数覆盖 (没有 args 和 env)
|
||||
---------------------------------------------------
|
||||
["curl"] = {
|
||||
path = base_dir .. "/curl/curl.exe"
|
||||
target = base_dir .. "/curl/curl.exe"
|
||||
},
|
||||
|
||||
---------------------------------------------------
|
||||
-- 4. 模块化路由 (得益于 Rust 注入的 package.path)
|
||||
-- require 能够直接在当前目录 或 conf.d/ 目录下寻找 node.lua
|
||||
-- require 能够直接在当前目录 或 tools/ 目录下寻找 node.lua
|
||||
-- 模块缺失时由 Rust 侧记录日志并跳过该条目（见 runtime.rs）
|
||||
---------------------------------------------------
|
||||
["node"] = require("node"),
|
||||
|
||||
50
src/error.rs
50
src/error.rs
@@ -1,27 +1,25 @@
|
||||
use std::path::PathBuf;
|
||||
use thiserror::Error; // 推荐引入 thiserror 库，若不使用可手动实现 std::fmt::Display
|
||||
|
||||
#[derive(Debug, Error)]
|
||||
pub enum ShimError {
|
||||
#[error("路径解析失败: {0}")]
|
||||
PathResolutionError(String),
|
||||
|
||||
#[error("获取环境信息失败: {0}")]
|
||||
EnvError(String),
|
||||
|
||||
#[error("配置文件未找到: {0}")]
|
||||
ConfigNotFound(String),
|
||||
|
||||
#[error("Lua 运行时/语法错误 [{file}]: {source}")]
|
||||
LuaExecutionError {
|
||||
file: String,
|
||||
#[source]
|
||||
source: mlua::Error,
|
||||
},
|
||||
|
||||
#[error("配置格式非法: {0}")]
|
||||
InvalidConfig(String),
|
||||
|
||||
#[error("IO 错误: {0}")]
|
||||
Io(#[from] std::io::Error),
|
||||
// 构造一个带上下文的 FromLua 转换错误，便于定位配置问题
|
||||
/// 配置校验错误
|
||||
pub fn validation_error(message: impl Into<String>) -> mlua::Error {
|
||||
mlua::Error::RuntimeError(message.into())
|
||||
}
|
||||
/// 将底层 Lua 语法错误转换为用户友好的提示
|
||||
pub fn syntax_error(err: mlua::Error) -> mlua::Error {
|
||||
match &err {
|
||||
mlua::Error::SyntaxError { message, .. } => {
|
||||
if message.contains("invalid escape sequence") || message.contains("unfinished string")
|
||||
{
|
||||
return validation_error(format!(
|
||||
"配置文件语法错误：检测到非法的字符串转义。\n\
|
||||
提示：在 Windows 路径末尾或字符串中使用反斜杠 '\\' 时：\n\
|
||||
1. 请使用双反斜杠转义，例如: \"D:\\\\CNWei\\\\CNW\\\\Rust\\\\\"\n\
|
||||
2. 或使用 Lua 原始字符串 (Raw String)，例如: [[D:\\CNWei\\CNW\\Rust\\]]\n\
|
||||
底层错误: {}",
|
||||
message
|
||||
));
|
||||
}
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
err
|
||||
}
|
||||
67
src/layout.rs
Normal file
67
src/layout.rs
Normal file
@@ -0,0 +1,67 @@
|
||||
use anyhow::{Context, Result, bail};
|
||||
use std::env;
|
||||
use std::path::{Path, PathBuf};
|
||||
use tracing::debug;
|
||||
pub struct Layout {
|
||||
pub base_dir: PathBuf,
|
||||
pub bin_dir: PathBuf,
|
||||
pub tools_dir: PathBuf,
|
||||
pub lua_file: PathBuf,
|
||||
}
|
||||
|
||||
impl Layout {
|
||||
/// 自动解析目录布局：
|
||||
/// 1. 优先使用环境变量 MIRROR_HOME
|
||||
/// 2. 兜底回退到当前垫片可执行文件所在目录推断 (exe -> bin -> root)
|
||||
pub fn discover(current_exe: &Path) -> Result<Self> {
|
||||
// 策略 1: 环境变量优先
|
||||
if let Ok(home_val) = env::var("MIRROR_HOME") {
|
||||
let trimmed = home_val.trim();
|
||||
if !trimmed.is_empty() {
|
||||
debug!(home = %trimmed, "检测到 MIRROR_HOME，采用环境变量配置");
|
||||
return Self::from_base_dir(PathBuf::from(trimmed));
|
||||
}
|
||||
}
|
||||
|
||||
// 策略 2: 相对路径自动推断兜底
|
||||
debug!("未配置 MIRROR_HOME，尝试从当前可执行文件路径推断根目录");
|
||||
Self::from_executable(current_exe)
|
||||
}
|
||||
|
||||
/// 基于确定的根目录构建完整布局
|
||||
fn from_base_dir(base_dir: PathBuf) -> Result<Self> {
|
||||
if !base_dir.is_dir() {
|
||||
bail!("指定的根目录不存在或不是有效目录: [{}]", base_dir.display());
|
||||
}
|
||||
|
||||
let bin_dir = base_dir.join("bin");
|
||||
let tools_dir = base_dir.join("tools");
|
||||
let lua_file = base_dir.join("../mirror.lua");
|
||||
|
||||
Ok(Self {
|
||||
base_dir,
|
||||
bin_dir,
|
||||
tools_dir,
|
||||
lua_file,
|
||||
})
|
||||
}
|
||||
|
||||
/// 从当前可执行文件解析 shim 安装目录布局
|
||||
fn from_executable(exe_path: &Path) -> Result<Self> {
|
||||
// let exe_path = exe_path.as_ref();
|
||||
let bin_dir = exe_path
|
||||
.parent()
|
||||
.with_context(|| format!("无法获取程序 [{}] 的父级 bin 目录", exe_path.display()))?
|
||||
.to_path_buf();
|
||||
|
||||
debug!("bin_dir目录 {}", bin_dir.display());
|
||||
|
||||
let base_dir = bin_dir
|
||||
.parent()
|
||||
.with_context(|| format!("无法获取 bin 目录 [{}] 的父级 root 目录", bin_dir.display()))?
|
||||
.to_path_buf();
|
||||
debug!("base_dir 目录 {}", base_dir.display());
|
||||
|
||||
Self::from_base_dir(base_dir)
|
||||
}
|
||||
}
|
||||
23
src/lib.rs
Normal file
23
src/lib.rs
Normal file
@@ -0,0 +1,23 @@
|
||||
extern crate core;
|
||||
|
||||
pub mod error;
|
||||
mod layout;
|
||||
mod loader;
|
||||
mod logger;
|
||||
mod mirror;
|
||||
mod runtime;
|
||||
mod spec;
|
||||
pub mod sys;
|
||||
mod utils;
|
||||
mod validators;
|
||||
|
||||
pub use layout::Layout;
|
||||
pub use mirror::Mirror;
|
||||
pub use runtime::LuaRuntime;
|
||||
pub use spec::MirrorSpec;
|
||||
// pub use sys::{
|
||||
// ERROR_ELEVATION_REQUIRED, EXIT_FAILED_LOAD_SHIM, EXIT_FAILED_SPAWN_PROG, EXIT_FAILED_WAIT_PROG,
|
||||
// EXIT_PROG_TERMINATED, execute_elevated, set_console_ctrl_handler,
|
||||
// };
|
||||
|
||||
pub use utils::{lua_string_2_os_string, normalize_path_for_lua, parse_tokens};
|
||||
99
src/loader.rs
Normal file
99
src/loader.rs
Normal file
@@ -0,0 +1,99 @@
|
||||
use crate::spec::MirrorSpec;
|
||||
use crate::{Layout, LuaRuntime};
|
||||
use anyhow::{Context, Result, bail};
|
||||
use mlua::Table;
|
||||
use std::path::PathBuf;
|
||||
use tracing::{debug, trace, warn};
|
||||
|
||||
pub enum Source {
|
||||
Lua(LuaRuntime),
|
||||
Json,
|
||||
}
|
||||
|
||||
/// MirrorSpec 加载器，统一对外暴露多源解析接口
|
||||
pub struct SpecLoader;
|
||||
|
||||
impl SpecLoader {
|
||||
pub fn resolve_spec(source: &Source, layout: &Layout, target_name: &str) -> Result<MirrorSpec> {
|
||||
match source {
|
||||
Source::Lua(r) => Self::resolve_lua_spec(&r, layout, target_name),
|
||||
Source::Json => Self::load_from_json(layout),
|
||||
}
|
||||
}
|
||||
/// 从 Lua 脚本字符串加载 ShimSpec
|
||||
fn resolve_lua_spec(
|
||||
runtime: &LuaRuntime,
|
||||
layout: &Layout,
|
||||
target_name: &str,
|
||||
) -> Result<MirrorSpec> {
|
||||
// 策略 1: 尝试加载全局配置文件 mirror.lua
|
||||
let global_config = layout.base_dir.join("mirror.lua");
|
||||
|
||||
if global_config.is_file() {
|
||||
trace!(path = %global_config.display(), "发现全局配置文件，尝试解析");
|
||||
let root_table: Table = runtime.eval_script(&global_config)?;
|
||||
|
||||
// 检查 mirror.lua 中是否存在以 target_name 命名的 Table 节点
|
||||
if root_table
|
||||
.contains_key(target_name)
|
||||
.context("检查全局配置失败")?
|
||||
{
|
||||
let target_val: MirrorSpec = root_table
|
||||
.get(target_name)
|
||||
.with_context(|| format!("解析配置 [{}] 失败: ", target_name))?;
|
||||
debug!(
|
||||
target = %target_name,
|
||||
source = %global_config.display(),
|
||||
"成功从全局配置文件中匹配到目标工具"
|
||||
);
|
||||
|
||||
return Ok(target_val);
|
||||
}
|
||||
// 穿透：若全局配置文件存在但未包含当前程序的 key，继续向下探查
|
||||
trace!(target = %target_name, "全局配置文件中未包含该目标，继续探查独立配置");
|
||||
}
|
||||
|
||||
let tools_dir: Option<PathBuf> = runtime.tools_dir()?;
|
||||
// 策略 2: 降级寻找独立文件 ({exe}.lua)，优先顺序：tools/ > root/
|
||||
let target_filename = format!("{}.lua", target_name);
|
||||
|
||||
let effective_tools_dir = match tools_dir {
|
||||
Some(t) => {
|
||||
if t.is_absolute() {
|
||||
t.join(&target_filename)
|
||||
} else {
|
||||
layout.base_dir.join(t).join(&target_filename)
|
||||
}
|
||||
}
|
||||
None => layout.tools_dir.join(&target_filename),
|
||||
};
|
||||
|
||||
let candidates = [
|
||||
// layout.tools_dir.join(&target_filename),
|
||||
effective_tools_dir,
|
||||
layout.base_dir.join(&target_filename),
|
||||
];
|
||||
|
||||
for config_path in &candidates {
|
||||
if config_path.is_file() {
|
||||
debug!(path = %config_path.display(), "找到独立配置文件，开始加载");
|
||||
// 直接泛型反序列化为 MirrorSpec
|
||||
return runtime.eval_script::<MirrorSpec>(config_path);
|
||||
}
|
||||
trace!(path = %config_path.display(), "独立配置文件不存在，跳过");
|
||||
}
|
||||
|
||||
// 策略 3: 所有查找失败，抛出错误
|
||||
warn!(target = %target_name, "未找到任何匹配的配置文件");
|
||||
bail!(
|
||||
"未找到关于 '{}' 的配置。请检查 mirror.lua 或特定的 {}.lua 文件",
|
||||
target_name,
|
||||
target_name
|
||||
);
|
||||
}
|
||||
|
||||
/// 从 Lua 脚本文件加载 ShimSpec
|
||||
fn load_from_json(layout: &Layout) -> Result<MirrorSpec> {
|
||||
todo!("实现json来源")
|
||||
}
|
||||
}
|
||||
39
src/logger.rs
Normal file
39
src/logger.rs
Normal file
@@ -0,0 +1,39 @@
|
||||
use std::path::Path;
|
||||
use tracing_appender::non_blocking::WorkerGuard;
|
||||
use tracing_subscriber::{EnvFilter, fmt};
|
||||
|
||||
/// 初始化日志系统，返回的 `_guard` 必须在 main 作用域内保持存活直到程序退出
|
||||
pub fn init_file_logger(log_dir: impl AsRef<Path>) -> Option<WorkerGuard> {
|
||||
// 允许通过环境变量动态控制日志级别，如 SHIM_LOG=debug，默认 debug 或 info
|
||||
let filter = EnvFilter::try_from_env("SHIM_LOG").unwrap_or_else(|_| EnvFilter::new("debug"));
|
||||
|
||||
// 1. 创建按天滚动的日志追加器 (每天生成类似 shim.2026-08-14.log)
|
||||
let file_appender = tracing_appender::rolling::daily(log_dir, "shim.log");
|
||||
|
||||
// 2. 包装为非阻塞后台写入（不会拖慢主程序的启动与执行速度）
|
||||
let (non_blocking, guard) = tracing_appender::non_blocking(file_appender);
|
||||
|
||||
// 3. 构建 Subscriber，只输出到文件，不输出到控制台
|
||||
tracing_subscriber::fmt()
|
||||
.with_env_filter(filter)
|
||||
.with_writer(non_blocking) // 写入文件
|
||||
.with_ansi(false) // 关闭终端彩色转义字符
|
||||
.with_target(false) // 隐藏模块前缀（可选）
|
||||
.init();
|
||||
|
||||
Some(guard)
|
||||
}
|
||||
|
||||
// 调用
|
||||
// fn main() -> Result<(), Box<dyn std::error::Error>> {
|
||||
// // 假设日志存放在安装根目录下的 logs 文件夹
|
||||
// // 也可以先快速推导 layout 拿到 log_dir
|
||||
// let log_dir = "path/to/root_dir/logs";
|
||||
// let _guard = init_file_logger(log_dir);
|
||||
//
|
||||
// // 此处写你的 Shim 业务逻辑
|
||||
// // 业务代码中所有的 debug!/info!/warn! 都会静默写入文件，控制台干干净净
|
||||
// let config = Shim::load()?;
|
||||
//
|
||||
// Ok(())
|
||||
// }
|
||||
177
src/main.rs
177
src/main.rs
@@ -1,102 +1,61 @@
|
||||
use std::{
|
||||
env,
|
||||
ffi::CString,
|
||||
mem::size_of,
|
||||
path::Path,
|
||||
process::{Command, exit},
|
||||
ptr::null_mut,
|
||||
};
|
||||
mod shims;
|
||||
mod error;
|
||||
use mirror::Mirror;
|
||||
use mirror::sys::*;
|
||||
use std::ffi::OsString;
|
||||
use std::{env, process::exit};
|
||||
use tracing_subscriber::{EnvFilter, fmt};
|
||||
|
||||
use shims::Shim;
|
||||
|
||||
use winapi::{
|
||||
shared::minwindef::{BOOL, DWORD, FALSE, TRUE},
|
||||
um::{
|
||||
combaseapi::CoInitializeEx,
|
||||
consoleapi,
|
||||
objbase::{COINIT_APARTMENTTHREADED, COINIT_DISABLE_OLE1DDE},
|
||||
processthreadsapi::GetExitCodeProcess,
|
||||
shellapi::{SEE_MASK_NOASYNC, SEE_MASK_NOCLOSEPROCESS, SHELLEXECUTEINFOA, ShellExecuteExA},
|
||||
synchapi::WaitForSingleObject,
|
||||
winbase::INFINITE,
|
||||
wincon,
|
||||
winuser::SW_NORMAL,
|
||||
},
|
||||
};
|
||||
|
||||
unsafe extern "system" fn routine_handler(evt: DWORD) -> BOOL {
|
||||
match evt {
|
||||
wincon::CTRL_C_EVENT => TRUE, //eprintln!("ctrl_c handled!"),
|
||||
wincon::CTRL_BREAK_EVENT => TRUE, //eprintln!("ctrl_break handled!"),
|
||||
wincon::CTRL_CLOSE_EVENT => TRUE, //eprintln!("ctrl_close handled!"),
|
||||
wincon::CTRL_LOGOFF_EVENT => TRUE, //eprintln!("ctrl_logoff handled!"),
|
||||
wincon::CTRL_SHUTDOWN_EVENT => TRUE, //eprintln!("ctrl_shutdown handled!"),
|
||||
other => {
|
||||
eprintln!("未知的系统事件编号: {}，未处理！", other);
|
||||
FALSE
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
const EXIT_FAILED_LOAD_SHIM: i32 = 1;
|
||||
const EXIT_FAILED_SPAWN_PROG: i32 = 2;
|
||||
const EXIT_FAILED_WAIT_PROG: i32 = 3;
|
||||
const EXIT_PROG_TERMINATED: i32 = 4;
|
||||
|
||||
const ERROR_ELEVATION_REQUIRED: i32 = 740;
|
||||
fn main() {
|
||||
let res: BOOL = unsafe { consoleapi::SetConsoleCtrlHandler(Some(routine_handler), TRUE) };
|
||||
if res == FALSE {
|
||||
eprintln!("警告: 注册控制台中断事件处理器失败。");
|
||||
}
|
||||
|
||||
let calling_args: Vec<_> = env::args().skip(1).collect();
|
||||
let shim = match Shim::init() {
|
||||
//初始化日志：输出到 stderr，避免污染 shim 子进程的 stdout
|
||||
fmt()
|
||||
.with_writer(std::io::stderr)
|
||||
.with_env_filter(
|
||||
EnvFilter::try_from_env("SHIM_LOG").unwrap_or_else(|_| EnvFilter::new("warn")),
|
||||
)
|
||||
.init();
|
||||
// 2. 注册 Windows 控制台信号
|
||||
set_console_ctrl_handler();
|
||||
// 3. 解析调用参数与代理 Mirror 配置
|
||||
let calling_args: Vec<_> = env::args_os().skip(1).collect();
|
||||
let mr = match Mirror::new() {
|
||||
Ok(v) => v,
|
||||
Err(e) => {
|
||||
eprintln!("加载代理(shim)配置时发生错误: {}", e);
|
||||
eprintln!("加载代理(mirror)配置时发生错误: {}", e);
|
||||
exit(EXIT_FAILED_LOAD_SHIM);
|
||||
}
|
||||
};
|
||||
let combined_args = mr.spec.args.iter().chain(calling_args.iter());
|
||||
|
||||
let args = if let Some(mut shim_args) = shim.args {
|
||||
shim_args.extend_from_slice(calling_args.as_slice());
|
||||
shim_args
|
||||
} else {
|
||||
calling_args
|
||||
};
|
||||
// ======= 【修改位置 1：构建 Command 并注入环境变量】 =======
|
||||
let mut cmd_builder = Command::new(&shim.target_path);
|
||||
cmd_builder.args(&args);
|
||||
// 构建 Command：复用 ShimConfig::to_command（含 args/env 注入），避免重复逻辑
|
||||
let mut cmd = mr.to_command(combined_args);
|
||||
|
||||
// 仅作用于目标子进程，完全 Safe 且隔离
|
||||
if let Some(ref envs) = shim.envs {
|
||||
cmd_builder.envs(envs);
|
||||
}
|
||||
let mut cmd = match cmd_builder.spawn() {
|
||||
let mut child = match cmd.spawn() {
|
||||
Ok(v) => v,
|
||||
Err(e) if e.raw_os_error() == Some(ERROR_ELEVATION_REQUIRED) => exit(execute_elevated(
|
||||
&shim.target_path,
|
||||
&args,
|
||||
shim.envs.as_ref(),
|
||||
)),
|
||||
Err(e) if e.raw_os_error() == Some(ERROR_ELEVATION_REQUIRED) => {
|
||||
// 提权回退时需要完整参数：配置默认参数 + 调用方透传参数
|
||||
let elevated_args: Vec<OsString> = cmd.get_args().map(|s| s.to_os_string()).collect();
|
||||
|
||||
exit(execute_elevated(
|
||||
&mr.spec.target,
|
||||
&elevated_args,
|
||||
Some(&mr.spec.env),
|
||||
))
|
||||
}
|
||||
Err(e) => {
|
||||
eprintln!(
|
||||
"启动目标程序 [{}] 时发生错误: {}",
|
||||
shim.target_path.to_string_lossy(),
|
||||
mr.spec.target.to_string_lossy(),
|
||||
e
|
||||
);
|
||||
exit(EXIT_FAILED_SPAWN_PROG);
|
||||
}
|
||||
};
|
||||
let status = match cmd.wait() {
|
||||
// 5. 等待子进程退出
|
||||
let status = match child.wait() {
|
||||
Ok(v) => v,
|
||||
Err(e) => {
|
||||
eprintln!(
|
||||
"等待目标程序 [{}] 执行完毕时发生错误: {}",
|
||||
shim.target_path.to_string_lossy(),
|
||||
mr.spec.target.to_string_lossy(),
|
||||
e
|
||||
);
|
||||
exit(EXIT_FAILED_WAIT_PROG);
|
||||
@@ -104,67 +63,3 @@ fn main() {
|
||||
};
|
||||
exit(status.code().unwrap_or(EXIT_PROG_TERMINATED))
|
||||
}
|
||||
|
||||
fn execute_elevated(
|
||||
program: &Path,
|
||||
args: &[String],
|
||||
envs: Option<&std::collections::HashMap<String, String>>,
|
||||
) -> i32 {
|
||||
// 若提权启动，在此处将环境变量设置给当前进程（即将弹窗 UAC 的进程，随后会被子进程继承）
|
||||
if let Some(env_map) = envs {
|
||||
for (k, v) in env_map {
|
||||
unsafe {
|
||||
env::set_var(k, v);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
let runas = CString::new("runas").unwrap();
|
||||
let program = CString::new(program.to_str().unwrap()).unwrap();
|
||||
let mut params = String::new();
|
||||
for arg in args.iter() {
|
||||
params.push(' ');
|
||||
if arg.len() == 0 {
|
||||
params.push_str("\"\"");
|
||||
} else if arg.find(&[' ', '\t', '"'][..]).is_none() {
|
||||
params.push_str(&arg);
|
||||
} else {
|
||||
params.push('"');
|
||||
for c in arg.chars() {
|
||||
match c {
|
||||
'\\' => params.push_str("\\\\"),
|
||||
'"' => params.push_str("\\\""),
|
||||
c => params.push(c),
|
||||
}
|
||||
}
|
||||
params.push('"');
|
||||
}
|
||||
}
|
||||
|
||||
let params = CString::new(¶ms[..]).unwrap();
|
||||
let mut info = SHELLEXECUTEINFOA::default();
|
||||
info.cbSize = size_of::<SHELLEXECUTEINFOA>() as DWORD;
|
||||
info.fMask = SEE_MASK_NOASYNC | SEE_MASK_NOCLOSEPROCESS;
|
||||
info.lpVerb = runas.as_ptr();
|
||||
info.lpFile = program.as_ptr();
|
||||
info.lpParameters = params.as_ptr();
|
||||
info.nShow = SW_NORMAL;
|
||||
let res = unsafe {
|
||||
CoInitializeEx(
|
||||
null_mut(),
|
||||
COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE,
|
||||
);
|
||||
ShellExecuteExA(&mut info as *mut _)
|
||||
};
|
||||
if res == FALSE || info.hProcess == null_mut() {
|
||||
return EXIT_FAILED_SPAWN_PROG;
|
||||
}
|
||||
let mut code: DWORD = 0;
|
||||
unsafe {
|
||||
WaitForSingleObject(info.hProcess, INFINITE);
|
||||
if GetExitCodeProcess(info.hProcess, &mut code as *mut _) == FALSE {
|
||||
return EXIT_FAILED_WAIT_PROG;
|
||||
}
|
||||
}
|
||||
code as i32
|
||||
}
|
||||
|
||||
105
src/mirror.rs
Normal file
105
src/mirror.rs
Normal file
@@ -0,0 +1,105 @@
|
||||
use crate::loader::Source;
|
||||
use crate::loader::SpecLoader;
|
||||
use crate::{Layout, LuaRuntime, MirrorSpec};
|
||||
use anyhow::{Context, Result};
|
||||
use std::collections::HashMap;
|
||||
use std::env;
|
||||
use std::ffi::OsString;
|
||||
use std::process::Command;
|
||||
use tracing::debug;
|
||||
pub struct Mirror {
|
||||
pub spec: MirrorSpec,
|
||||
pub layout: Layout,
|
||||
pub target_name: String,
|
||||
}
|
||||
|
||||
impl Mirror {
|
||||
pub fn new() -> Result<Self> {
|
||||
let current_exe = env::current_exe().context("获取代理程序路径失败: {}")?;
|
||||
debug!("当前目录 {}", current_exe.display());
|
||||
|
||||
let target_name = current_exe
|
||||
.file_stem()
|
||||
.and_then(|s| s.to_str())
|
||||
.with_context(|| format!("无法从路径 [{}] 提取有效的程序名称", current_exe.display()))?
|
||||
.to_lowercase();
|
||||
debug!(
|
||||
target_name = %target_name,
|
||||
current_exe = %current_exe.display(),
|
||||
"开始加载 Mirror 配置"
|
||||
);
|
||||
let layout = Layout::discover(¤t_exe)?;
|
||||
|
||||
debug!(
|
||||
root_dir = %layout.base_dir.display(),
|
||||
bin_dir = %layout.bin_dir.display(),
|
||||
tools_dir = %layout.tools_dir.display(),
|
||||
"Mirror 目录布局解析完成"
|
||||
);
|
||||
|
||||
let runtime = LuaRuntime::new(&layout)?;
|
||||
let spec = SpecLoader::resolve_spec(&Source::Lua(runtime), &layout, &target_name)?;
|
||||
|
||||
Ok(Self {
|
||||
spec,
|
||||
layout,
|
||||
target_name,
|
||||
})
|
||||
}
|
||||
|
||||
/// 1. 核心参数路由解析（Delegation 到 Spec 的路由逻辑）
|
||||
fn resolve_args<I, S>(&self, args: I, aliases: &HashMap<String, Vec<OsString>>) -> Vec<OsString>
|
||||
where
|
||||
I: IntoIterator<Item = S>,
|
||||
S: AsRef<std::ffi::OsStr>,
|
||||
{
|
||||
let arg_iter = args.into_iter();
|
||||
|
||||
// 1. 预分配容量：利用迭代器的下限提示，避免多次 Realloc
|
||||
let (lower_bound, _) = arg_iter.size_hint();
|
||||
let mut expanded_args: Vec<OsString> = Vec::with_capacity(lower_bound);
|
||||
|
||||
for i in arg_iter {
|
||||
let os_str = i.as_ref();
|
||||
|
||||
let arg_str = os_str.to_string_lossy();
|
||||
|
||||
// 检查参数是否带有 mr: 前缀
|
||||
if let Some(alias_key) = arg_str.strip_prefix("mr:") {
|
||||
// 如果在加载期打平好的字典中找到了对应的别名，直接展开追加
|
||||
if let Some(alias_values) = aliases.get(alias_key) {
|
||||
expanded_args.extend(alias_values.iter().cloned());
|
||||
} else {
|
||||
// 如果找不到对应的别名，按原样参数追加
|
||||
expanded_args.push(os_str.to_os_string());
|
||||
}
|
||||
} else {
|
||||
// 普通参数，直接追加
|
||||
expanded_args.push(os_str.to_os_string());
|
||||
}
|
||||
}
|
||||
expanded_args
|
||||
}
|
||||
|
||||
pub fn to_command<I, S>(&self, combined_args: I) -> Command
|
||||
where
|
||||
I: IntoIterator<Item = S>,
|
||||
S: AsRef<std::ffi::OsStr>,
|
||||
{
|
||||
let mut cmd = Command::new(&self.spec.target);
|
||||
|
||||
// 2. 传入预打平的别名字典，查表并展开所有以 `mr:` 为前缀的别名
|
||||
let final_args = self.resolve_args(combined_args, &self.spec.aliases);
|
||||
println!("拼接后的命令行参数{:?}",final_args);
|
||||
// 3. 将解析展开后的无环参数一次性注入 Command
|
||||
cmd.args(&final_args);
|
||||
|
||||
// 4. 注入配置好的环境变量
|
||||
for (key, val) in &self.spec.env {
|
||||
// 直接应用环境变量（Lua 端已经处理好字符串拼接或列表合并）
|
||||
cmd.env(key, val);
|
||||
}
|
||||
|
||||
cmd
|
||||
}
|
||||
}
|
||||
327
src/runtime.rs
Normal file
327
src/runtime.rs
Normal file
@@ -0,0 +1,327 @@
|
||||
use crate::Layout;
|
||||
use crate::error::syntax_error;
|
||||
use crate::utils::normalize_path_for_lua;
|
||||
use anyhow::{Context, Result};
|
||||
use mlua::{FromLua, Lua, StdLib, Table, Value};
|
||||
use std::path::{Path, PathBuf};
|
||||
use std::{env, fs};
|
||||
|
||||
const MIRROR_DIR: &str = "__MIRROR_DIR__";
|
||||
const MIRROR_TOOLS_DIR: &str = "__MIRROR_TOOLS_DIR__";
|
||||
// const MIRROR_LOG_LEVEL: &str = "__MIRROR_LOG_LEVEL__";
|
||||
const MIRROR_LOG_DIR: &str = "__MIRROR_LOG_DIR__";
|
||||
|
||||
pub struct LuaRuntime {
|
||||
lua: Lua,
|
||||
}
|
||||
|
||||
impl LuaRuntime {
|
||||
/// 初始化限定权限的 Lua 沙箱环境
|
||||
pub fn new(layout: &Layout) -> Result<Self> {
|
||||
// 只加载安全的标准库，剥离 os / io 等风险模块
|
||||
let lua = Lua::new_with(
|
||||
StdLib::TABLE | StdLib::STRING | StdLib::MATH | StdLib::PACKAGE,
|
||||
mlua::LuaOptions::default(),
|
||||
)
|
||||
.context("初始化 Lua 失败")?;
|
||||
|
||||
// 统一使用 POSIX 风格路径规范化路径字符串
|
||||
let base_dir = normalize_path_for_lua(&layout.base_dir);
|
||||
let tools_dir = normalize_path_for_lua(&layout.tools_dir);
|
||||
|
||||
// 1. 注入锚点变量 __MIRROR_DIR__（shim 安装根目录）
|
||||
Self::register_mirror_dir(&lua, &base_dir)?;
|
||||
|
||||
// 2. 安全暴露 get_env 供配置读取环境变量
|
||||
// 返回按平台路径分隔符拆分后的段数组（自动剥离引号包裹），
|
||||
// 便于 PATH 等列表变量直接嵌入数组：PATH = { prefix, get_env("PATH") }
|
||||
Self::register_get_env(&lua)?;
|
||||
// 3. 初始化并配置安全/容错的 require 机制
|
||||
Self::setup_require(&lua, &base_dir, &tools_dir)?;
|
||||
Ok(Self { lua })
|
||||
}
|
||||
|
||||
/// 执行指定脚本文件，直接返回完整的 Lua Table
|
||||
pub fn eval_script<T: FromLua>(&self, path: impl AsRef<Path>) -> Result<T> {
|
||||
let path = path.as_ref();
|
||||
|
||||
let bytes =
|
||||
fs::read(path).with_context(|| format!("无法读取配置文件: {}", path.display()))?;
|
||||
|
||||
let code = String::from_utf8(bytes).with_context(|| {
|
||||
format!(
|
||||
"{} 不是有效的 UTF-8 文件（请将 Lua 配置文件保存为 UTF-8 编码）",
|
||||
path.display()
|
||||
)
|
||||
})?;
|
||||
tracing::trace!("code {:?}", code);
|
||||
// 使用 @<path> 格式标记 Chunk 名称，确保 Lua 报错时能精确回溯到对应的源文件名与行号。
|
||||
let chunk_name = format!("@{}", path.display());
|
||||
|
||||
self.lua
|
||||
.load(&code)
|
||||
.set_name(&chunk_name)
|
||||
.eval::<T>()
|
||||
.map_err(syntax_error)
|
||||
.with_context(|| format!("执行 Lua 配置文件失败: {}", path.display()))
|
||||
}
|
||||
|
||||
pub fn tools_dir(&self) -> Result<Option<PathBuf>> {
|
||||
self.lua
|
||||
.globals()
|
||||
.get(MIRROR_TOOLS_DIR)
|
||||
.context(format!("设置 {MIRROR_TOOLS_DIR} 失败"))
|
||||
}
|
||||
}
|
||||
impl LuaRuntime {
|
||||
/// 注入全局锚点变量
|
||||
fn register_mirror_dir(lua: &Lua, base_dir: &str) -> Result<()> {
|
||||
lua.globals()
|
||||
.set(MIRROR_DIR, base_dir)
|
||||
.context(format!("设置 {MIRROR_DIR} 环境变量失败"))?;
|
||||
Ok(())
|
||||
}
|
||||
|
||||
///注入 get_env 供配置读取环境变量
|
||||
fn register_get_env(lua: &Lua) -> Result<()> {
|
||||
let globals = lua.globals();
|
||||
let get_env = lua
|
||||
.create_function(|lua, key: String| -> mlua::Result<Table> {
|
||||
// 缺失变量视为空字符串，拆分后得到空表（不贡献任何路径段）
|
||||
let value = env::var_os(key).unwrap_or_default();
|
||||
// 空输入返回空表；否则按平台分隔符拆分（split_paths 会剥离引号包裹）
|
||||
if value.is_empty() {
|
||||
return lua.create_table();
|
||||
}
|
||||
let table = lua.create_table()?;
|
||||
for (i, p) in env::split_paths(&value).enumerate() {
|
||||
// 3. 跨平台提取原始字节并转为 LuaString，保证 100% 无损
|
||||
#[cfg(unix)]
|
||||
let lua_str = {
|
||||
use std::os::unix::ffi::OsStrExt;
|
||||
lua.create_string(p.as_os_str().as_bytes())?
|
||||
};
|
||||
|
||||
#[cfg(windows)]
|
||||
let lua_str = {
|
||||
// Windows 路径是 UTF-16，转成字符串或保持其字节表达
|
||||
let s = p.to_string_lossy();
|
||||
lua.create_string(s.as_bytes())?
|
||||
};
|
||||
|
||||
table.set(i + 1, lua_str)?;
|
||||
}
|
||||
|
||||
Ok(table)
|
||||
})
|
||||
.context("注册 get_env 函数失败")?;
|
||||
|
||||
globals
|
||||
.set("get_env", get_env)
|
||||
.context("挂载 get_env 全局函数失败")?;
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// 通用的路径注册闭包生成器
|
||||
fn register_dir_reset_fn(
|
||||
lua: &Lua,
|
||||
global_fn_name: &str,
|
||||
target_global_key: &'static str,
|
||||
) -> Result<()> {
|
||||
let get_env = lua.create_function(move |lua, rel_path: String| {
|
||||
let clean_path = rel_path.trim().trim_start_matches('/');
|
||||
|
||||
lua.globals().set(target_global_key, clean_path)?;
|
||||
|
||||
Ok(())
|
||||
})?;
|
||||
|
||||
// 4. 将函数绑定至 Lua 全局作用域，供 Lua 调用
|
||||
lua.globals().set(global_fn_name, get_env)?;
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn register_reset_tools_dir(lua: &Lua) -> Result<()> {
|
||||
Self::register_dir_reset_fn(lua, "reset_tools_dir", MIRROR_TOOLS_DIR)
|
||||
}
|
||||
fn register_reset_log_dir(lua: &Lua) -> Result<()> {
|
||||
Self::register_dir_reset_fn(lua, "reset_log_dir", MIRROR_LOG_DIR)
|
||||
}
|
||||
/// 配置 package.path 并包装 require，拦截加载失败以提高容错性
|
||||
fn setup_require(lua: &Lua, base_dir: &str, tools_dir: &str) -> Result<()> {
|
||||
let globals = lua.globals();
|
||||
|
||||
// 1. 安全加固并拓展 package 搜索路径
|
||||
if let Ok(package) = globals.get::<Table>("package") {
|
||||
let _ = package.set("cpath", "");
|
||||
let _ = package.set("loadlib", Value::Nil);
|
||||
|
||||
if let Ok(path) = package.get::<String>("path") {
|
||||
let new_path = format!(
|
||||
"{};{}/?.lua;{}/?/init.lua;{}/?.lua;{}/?/init.lua",
|
||||
path, base_dir, base_dir, tools_dir, tools_dir
|
||||
);
|
||||
let _ = package.set("path", new_path);
|
||||
}
|
||||
}
|
||||
|
||||
// 2. 获取原生 require 并通过闭包直接持有（无需向全局表注入备份变量）
|
||||
let original_require: mlua::Function = globals
|
||||
.get("require")
|
||||
.context("获取内置 require 函数失败")?;
|
||||
|
||||
let wrapped_require = lua
|
||||
.create_function(move |_lua, module: String| -> mlua::Result<Value> {
|
||||
match original_require.call::<Value>(module.as_str()) {
|
||||
Ok(value) => Ok(value),
|
||||
Err(e) => {
|
||||
tracing::warn!(
|
||||
module = %module,
|
||||
error = %e,
|
||||
"配置模块加载失败，已跳过该条目（可在独立配置文件中定义）"
|
||||
);
|
||||
Ok(Value::Nil)
|
||||
}
|
||||
}
|
||||
})
|
||||
.context("创建包装版 require 函数失败")?;
|
||||
|
||||
// 3. 覆盖全局 require
|
||||
globals
|
||||
.set("require", wrapped_require)
|
||||
.context("重载 require 函数失败")?;
|
||||
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use crate::{Layout, MirrorSpec};
|
||||
|
||||
fn test_layout() -> Layout {
|
||||
let root = std::env::temp_dir().join("rshim-test-layout");
|
||||
Layout {
|
||||
base_dir: root.clone(),
|
||||
bin_dir: root.join("bin"),
|
||||
tools_dir: root.join("tools"),
|
||||
lua_file: Default::default(),
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn missing_module_require_returns_nil() {
|
||||
let runtime = LuaRuntime::new(&test_layout()).unwrap();
|
||||
let value: Value = runtime
|
||||
.lua
|
||||
.load(r#"return require("rshim_test_no_such_module")"#)
|
||||
.eval()
|
||||
.unwrap();
|
||||
assert!(matches!(value, Value::Nil));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn builtin_module_require_still_works() {
|
||||
let runtime = LuaRuntime::new(&test_layout()).unwrap();
|
||||
let value: Value = runtime
|
||||
.lua
|
||||
.load(r#"return pcall(require, "string")"#)
|
||||
.eval()
|
||||
.unwrap();
|
||||
assert!(matches!(value, Value::Boolean(true)));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn get_env_returns_split_table() {
|
||||
let runtime = LuaRuntime::new(&test_layout()).unwrap();
|
||||
let value: Value = runtime
|
||||
.lua
|
||||
.load(r#"return get_env("PATH")"#)
|
||||
.eval()
|
||||
.unwrap();
|
||||
let table = match value {
|
||||
Value::Table(t) => t,
|
||||
other => panic!("expected table, got {}", other.type_name()),
|
||||
};
|
||||
assert!(
|
||||
table.raw_len() >= 1,
|
||||
"PATH should have at least one segment"
|
||||
);
|
||||
|
||||
// split_paths 会剥离引号包裹，拆分段不应再含双引号
|
||||
for i in 1..=table.raw_len() {
|
||||
let seg: String = table.raw_get(i).unwrap();
|
||||
assert!(
|
||||
!seg.contains('"'),
|
||||
"segment should not contain quote: {seg:?}"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn get_env_missing_returns_empty_table() {
|
||||
let runtime = LuaRuntime::new(&test_layout()).unwrap();
|
||||
let value: Value = runtime
|
||||
.lua
|
||||
.load(r#"return get_env("RSHIM_TEST_NO_SUCH_VAR_12345")"#)
|
||||
.eval()
|
||||
.unwrap();
|
||||
match value {
|
||||
Value::Table(t) => assert_eq!(t.raw_len(), 0),
|
||||
other => panic!("expected table, got {}", other.type_name()),
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn path_with_get_env_joins_without_quote_error() {
|
||||
// 复现用户场景：PATH = { base_dir .. "/tools/numa", get_env("PATH") }
|
||||
// 宿主 PATH 即使含双引号，也应拆分后正常拼接，而不是报错
|
||||
let runtime = LuaRuntime::new(&test_layout()).unwrap();
|
||||
let cfg: MirrorSpec = runtime
|
||||
.lua
|
||||
.load(
|
||||
r#"
|
||||
return {
|
||||
target = __SHIM_DIR__ .. "/tools/numa/numa.exe",
|
||||
args = { "--help" },
|
||||
env = {
|
||||
PATH = { __SHIM_DIR__ .. "/tools/numa", get_env("PATH") }
|
||||
}
|
||||
}
|
||||
"#,
|
||||
)
|
||||
.eval()
|
||||
.unwrap();
|
||||
|
||||
let path = cfg.env.get("PATH").unwrap().to_str().unwrap();
|
||||
let prefix = std::env::temp_dir()
|
||||
.join("rshim-test-layout")
|
||||
.to_string_lossy()
|
||||
.replace('\\', "/")
|
||||
+ "/tools/numa;";
|
||||
assert!(path.starts_with(&prefix), "unexpected PATH: {path}");
|
||||
|
||||
// 宿主 PATH 的段应被附加在配置前缀之后
|
||||
let host = std::env::var("PATH").unwrap_or_default();
|
||||
if !host.is_empty() {
|
||||
let host_first = std::env::split_paths(&host)
|
||||
.next()
|
||||
.unwrap()
|
||||
.to_string_lossy()
|
||||
.into_owned();
|
||||
assert!(
|
||||
path.contains(&host_first),
|
||||
"missing host PATH segment: {host_first}"
|
||||
);
|
||||
}
|
||||
|
||||
// 宿主 PATH 里引号包裹的畸形段（如 "D:\\...\\bin;"）应被原样保留，
|
||||
// 而不是让整个配置加载失败
|
||||
if host.contains('"') {
|
||||
assert!(
|
||||
path.contains('"'),
|
||||
"quoted host segments should be preserved"
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
283
src/shims.rs
283
src/shims.rs
@@ -1,283 +0,0 @@
|
||||
use crate::error::ShimError;
|
||||
use mlua::{Error as LuaError, FromLua, Lua, StdLib, Table, Value};
|
||||
use std::process::Command;
|
||||
use std::{
|
||||
collections::HashMap,
|
||||
env, fs,
|
||||
io::{Error, ErrorKind},
|
||||
path::{Path, PathBuf},
|
||||
};
|
||||
|
||||
/// 将 Path 转换为适合 Lua 使用的安全字符串路径
|
||||
fn normalize_path_for_lua(path: &Path) -> String {
|
||||
let path_str = path.to_string_lossy();
|
||||
|
||||
// 1. 剥离 Windows UNC 规范路径前缀 (\\?\)
|
||||
let clean_str = path_str.strip_prefix(r"\\?\").unwrap_or(&path_str);
|
||||
|
||||
// 2. 将反斜杠转换成正斜杠（在非 UNC 路径下，Windows 和 Lua 均完美支持 /）
|
||||
// 这样既避免了 Lua 字符串转义隐患，又不会破坏 Windows 路径
|
||||
clean_str.replace('\\', "/")
|
||||
}
|
||||
|
||||
pub struct ShimEnv {
|
||||
pub bin_dir: PathBuf,
|
||||
pub root_dir: PathBuf,
|
||||
pub tools_dir: PathBuf,
|
||||
pub target_name: String,
|
||||
}
|
||||
|
||||
impl ShimEnv {
|
||||
/// 提取当前代理程序的运行环境信息
|
||||
pub fn new(current_exe: PathBuf) -> Result<Self, ShimError> {
|
||||
let bin_dir = current_exe
|
||||
.parent()
|
||||
.ok_or_else(|| {
|
||||
ShimError::PathResolutionError(format!(
|
||||
"无法获取程序 [{}] 的父级 bin 目录",
|
||||
current_exe.display()
|
||||
))
|
||||
})?
|
||||
.to_path_buf();
|
||||
println!("bin_dir目录 {}", bin_dir.display());
|
||||
|
||||
let root_dir = bin_dir
|
||||
.parent()
|
||||
.ok_or_else(|| {
|
||||
ShimError::PathResolutionError(format!(
|
||||
"无法获取 bin 目录 [{}] 的父级 root 目录",
|
||||
bin_dir.display()
|
||||
))
|
||||
})?
|
||||
.to_path_buf();
|
||||
println!("root_dir 目录 {}", root_dir.display());
|
||||
|
||||
let tools_dir = root_dir.join("tools");
|
||||
println!("tools_dir 目录 {}", tools_dir.display());
|
||||
|
||||
let target_name = current_exe
|
||||
.file_stem()
|
||||
.and_then(|s| s.to_str())
|
||||
.ok_or_else(|| {
|
||||
ShimError::PathResolutionError(format!(
|
||||
"无法从路径 [{}] 提取有效的程序名称",
|
||||
current_exe.display()
|
||||
))
|
||||
})?
|
||||
.to_lowercase();
|
||||
println!("程序名称 {}", target_name);
|
||||
|
||||
Ok(Self {
|
||||
bin_dir,
|
||||
root_dir,
|
||||
tools_dir,
|
||||
target_name,
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct ShimConfig {
|
||||
pub target_path: PathBuf,
|
||||
pub args: Option<Vec<String>>,
|
||||
pub envs: Option<HashMap<String, String>>,
|
||||
}
|
||||
|
||||
impl ShimConfig {
|
||||
/// 根据配置快速构建准备执行的 Command 对象
|
||||
pub fn to_command(&self) -> Command {
|
||||
let mut cmd = Command::new(&self.target_path);
|
||||
|
||||
if let Some(args) = &self.args {
|
||||
cmd.args(args);
|
||||
}
|
||||
|
||||
if let Some(envs) = &self.envs {
|
||||
for (key, val) in envs {
|
||||
// 直接应用环境变量（Lua 端已经处理好字符串拼接或列表合并）
|
||||
cmd.env(key, val);
|
||||
}
|
||||
}
|
||||
|
||||
cmd
|
||||
}
|
||||
}
|
||||
|
||||
/// 实现 FromLua Trait，由 mlua 自动处理 Table 转换
|
||||
impl FromLua for ShimConfig {
|
||||
fn from_lua(value: Value, _lua: &Lua) -> mlua::Result<Self> {
|
||||
match value {
|
||||
Value::Table(table) => {
|
||||
let path_str: String = table.get("path")?;
|
||||
let args: Option<Vec<String>> = table.get("args")?;
|
||||
// 解析 env Table
|
||||
let mut envs_map = HashMap::new();
|
||||
if let Ok(env_table) = table.get::<Table>("env") {
|
||||
// 获取当前系统的路径分隔符（Windows 为 ";"，Unix 为 ":"）
|
||||
#[cfg(windows)]
|
||||
let sep = ";";
|
||||
#[cfg(not(windows))]
|
||||
let sep = ":";
|
||||
|
||||
for pair in env_table.pairs::<String, Value>() {
|
||||
let (k, v) = pair?;
|
||||
match v {
|
||||
// 情况 1: 普通字符串，如 HOME = "C:/path" -> 直接覆盖
|
||||
Value::String(s) => {
|
||||
envs_map.insert(k, s.to_str()?.to_string());
|
||||
}
|
||||
// 情况 2: 数组 Table，如 PATH = { bin_dir, get_env("PATH") }
|
||||
Value::Table(arr) => {
|
||||
let paths: Vec<String> = arr
|
||||
// 将 arr 作为序列（数组）处理，每个元素转为 String
|
||||
.sequence_values::<String>()
|
||||
.filter_map(|r| r.ok())
|
||||
.filter(|s| !s.is_empty()) // 过滤空串，防止生成不必要的连续 ;;
|
||||
.collect();
|
||||
|
||||
let combined = paths.join(sep);
|
||||
envs_map.insert(k, combined);
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
let envs = if envs_map.is_empty() {
|
||||
None
|
||||
} else {
|
||||
Some(envs_map)
|
||||
};
|
||||
|
||||
Ok(ShimConfig {
|
||||
target_path: PathBuf::from(path_str),
|
||||
args,
|
||||
envs,
|
||||
})
|
||||
}
|
||||
_ => Err(mlua::Error::FromLuaConversionError {
|
||||
from: value.type_name(),
|
||||
to: "ShimConfig".into(),
|
||||
message: Some("Expected a Lua table".to_string()),
|
||||
}),
|
||||
}
|
||||
}
|
||||
}
|
||||
pub struct LuaRuntime {
|
||||
lua: Lua,
|
||||
}
|
||||
|
||||
impl LuaRuntime {
|
||||
/// 初始化限定权限的 Lua 沙箱环境
|
||||
pub fn new(shim_env: &ShimEnv) -> Result<Self, ShimError> {
|
||||
// 只加载安全的标准库，剥离 os / io 等风险模块
|
||||
let lua = Lua::new_with(
|
||||
StdLib::TABLE | StdLib::STRING | StdLib::MATH | StdLib::PACKAGE,
|
||||
mlua::LuaOptions::default(),
|
||||
)
|
||||
.map_err(|e| ShimError::EnvError(format!("初始化 Lua 失败: {}", e)))?;
|
||||
|
||||
let globals = lua.globals();
|
||||
|
||||
// 统一使用 POSIX 风格路径规范化路径字符串
|
||||
let root_dir_str = normalize_path_for_lua(&shim_env.root_dir);
|
||||
let tools_dir_str = normalize_path_for_lua(&shim_env.tools_dir);
|
||||
|
||||
// 1. 注入锚点变量
|
||||
globals
|
||||
.set("__SHIM_DIR__", root_dir_str.clone())
|
||||
.map_err(|e| ShimError::EnvError(e.to_string()))?;
|
||||
|
||||
// 2. 安全暴露 get_env 供配置读取环境变量
|
||||
let get_env = lua
|
||||
.create_function(|_, key: String| -> mlua::Result<String> {
|
||||
Ok(env::var(key).unwrap_or_default())
|
||||
})
|
||||
.map_err(|e| ShimError::EnvError(e.to_string()))?;
|
||||
|
||||
globals
|
||||
.set("get_env", get_env)
|
||||
.map_err(|e| ShimError::EnvError(e.to_string()))?;
|
||||
|
||||
// 3. 配置 package.path，确保 require 行为正常
|
||||
if let Ok(package) = globals.get::<Table>("package") {
|
||||
if let Ok(path) = package.get::<String>("path") {
|
||||
let new_path = format!(
|
||||
"{};{}/?.lua;{}/?/init.lua;{}/?.lua;{}/?/init.lua",
|
||||
path, root_dir_str, root_dir_str, tools_dir_str, tools_dir_str
|
||||
);
|
||||
let _ = package.set("path", new_path);
|
||||
}
|
||||
}
|
||||
|
||||
Ok(Self { lua })
|
||||
}
|
||||
|
||||
/// 执行指定脚本文件，直接返回完整的 Lua Table
|
||||
pub fn evaluate_lua_script(&self, path: &Path) -> Result<Table, ShimError> {
|
||||
let code = fs::read_to_string(path)?;
|
||||
|
||||
self.lua
|
||||
.load(&code)
|
||||
.set_name(path.to_string_lossy())
|
||||
.eval::<Table>()
|
||||
.map_err(|e| ShimError::LuaExecutionError {
|
||||
file: path.display().to_string(),
|
||||
source: e,
|
||||
})
|
||||
}
|
||||
|
||||
/// 将 Lua Value 解析转化为 ShimConfig 数据对象
|
||||
pub fn parse_config(&self, value: Value) -> Result<ShimConfig, ShimError> {
|
||||
ShimConfig::from_lua(value, &self.lua).map_err(|e| ShimError::InvalidConfig(e.to_string()))
|
||||
}
|
||||
}
|
||||
pub struct Shim;
|
||||
|
||||
impl Shim {
|
||||
pub fn init() -> Result<ShimConfig, ShimError> {
|
||||
let current_exe = env::current_exe()
|
||||
.map_err(|e| Error::new(ErrorKind::Other, format!("获取代理程序路径失败: {}", e)))?;
|
||||
println!("当前目录 {}", current_exe.display());
|
||||
let shim_env = ShimEnv::new(current_exe)?;
|
||||
let runtime = LuaRuntime::new(&shim_env)?;
|
||||
|
||||
Self::resolve_config(&runtime, &shim_env)
|
||||
}
|
||||
|
||||
fn resolve_config(engine: &LuaRuntime, env: &ShimEnv) -> Result<ShimConfig, ShimError> {
|
||||
// 策略 1: 尝试加载全局配置文件 shims.lua
|
||||
let global_config = env.root_dir.join("shims.lua");
|
||||
if global_config.is_file() {
|
||||
let root_table = engine.evaluate_lua_script(&global_config)?;
|
||||
|
||||
// 检查 shims.lua 中是否存在以 target_name 命名的 Table 节点
|
||||
if let Ok(target_val) = root_table.get::<Value>(env.target_name.as_str()) {
|
||||
if matches!(target_val, Value::Table(_)) {
|
||||
return engine.parse_config(target_val);
|
||||
}
|
||||
}
|
||||
// 穿透：若全局配置文件存在但未包含当前程序的 key，继续向下探查
|
||||
}
|
||||
|
||||
// 策略 2: 降级寻找独立文件 ({exe}.lua)，优先顺序：tools/ > root/
|
||||
let target_filename = format!("{}.lua", env.target_name);
|
||||
let candidates = [
|
||||
env.tools_dir.join(&target_filename),
|
||||
env.root_dir.join(&target_filename),
|
||||
];
|
||||
|
||||
for config_path in &candidates {
|
||||
if config_path.is_file() {
|
||||
let table = engine.evaluate_lua_script(config_path)?;
|
||||
return engine.parse_config(Value::Table(table));
|
||||
}
|
||||
}
|
||||
|
||||
// 策略 3: 所有查找失败，抛出错误
|
||||
Err(ShimError::ConfigNotFound(format!(
|
||||
"未找到关于 '{}' 的配置。请检查 shims.lua 或特定的 {}.lua 文件",
|
||||
env.target_name, env.target_name
|
||||
)))
|
||||
}
|
||||
}
|
||||
109
src/spec.rs
Normal file
109
src/spec.rs
Normal file
@@ -0,0 +1,109 @@
|
||||
use crate::error::validation_error;
|
||||
use crate::validators::{JsonValidator, LuaValidator};
|
||||
use anyhow::{Result, anyhow};
|
||||
use mlua::{FromLua, Lua, Value};
|
||||
use std::collections::HashMap;
|
||||
use std::ffi::OsString;
|
||||
use std::path::PathBuf;
|
||||
use std::str::FromStr;
|
||||
use tinyjson::JsonValue;
|
||||
|
||||
|
||||
#[derive(Debug, Clone, Default)]
|
||||
pub struct MirrorSpec {
|
||||
pub target: PathBuf,
|
||||
pub args: Vec<OsString>,
|
||||
pub aliases: HashMap<String, Vec<OsString>>,
|
||||
pub env: HashMap<String, OsString>,
|
||||
}
|
||||
|
||||
/// 实现 FromLua Trait，由 mlua 自动处理 Table 转换
|
||||
impl FromLua for MirrorSpec {
|
||||
fn from_lua(value: Value, _lua: &Lua) -> mlua::Result<Self> {
|
||||
// 脚本返回必须是一个 Table 变体
|
||||
let table = match value {
|
||||
Value::Table(t) => t,
|
||||
_ => {
|
||||
return Err(validation_error(format!(
|
||||
"期望得到一个 Lua Table 配置对象，实际是 {}",
|
||||
value.type_name()
|
||||
)));
|
||||
}
|
||||
};
|
||||
|
||||
// 必填字段: target（严格限定为字符串，避免数字被 mlua 宽松转为字符串后掩盖错误）
|
||||
let target = match table.get::<Option<Value>>("target")? {
|
||||
None | Some(Value::Nil) => {
|
||||
return Err(validation_error("缺少必填字段 target（应为字符串路径）"));
|
||||
}
|
||||
Some(target_val) => LuaValidator::parse_target(&target_val)?,
|
||||
};
|
||||
|
||||
// 可选字段: args（缺失或 nil 时默认空列表；保留空字符串参数，与提权路径的 "" 语义一致）
|
||||
let args = match table.get::<Option<Value>>("args")? {
|
||||
None | Some(Value::Nil) => Vec::new(),
|
||||
Some(args_val) => LuaValidator::parse_args(&args_val)?,
|
||||
};
|
||||
|
||||
// 可选字段: env（只允许缺失/nil，其他类型由 Option<Table> 转换报错，不再静默忽略）
|
||||
let env = match table.get::<Option<Value>>("env")? {
|
||||
None | Some(Value::Nil) => HashMap::new(),
|
||||
Some(env_val) => LuaValidator::parse_env(&env_val)?,
|
||||
};
|
||||
|
||||
// 可选字段: aliases（只允许缺失/nil，其他类型由 Option<Table> 转换报错，不再静默忽略）
|
||||
let aliases = match table.get::<Option<Value>>("aliases")? {
|
||||
None | Some(Value::Nil) => HashMap::new(),
|
||||
Some(env_val) => LuaValidator::parse_aliases(&env_val)?,
|
||||
};
|
||||
// println!("环境变量结果：{:?}", env);
|
||||
Ok(MirrorSpec {
|
||||
target,
|
||||
args,
|
||||
aliases,
|
||||
env,
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
impl TryFrom<&str> for MirrorSpec {
|
||||
type Error = anyhow::Error;
|
||||
|
||||
fn try_from(json_str: &str) -> Result<Self> {
|
||||
// 1. 解析 JSON 字符串为 JsonValue 树
|
||||
let root = JsonValue::from_str(json_str).map_err(|e| anyhow!("JSON 语法错误: {}", e))?;
|
||||
|
||||
// 根节点必须是一个 JSON Object
|
||||
let map: &HashMap<String, JsonValue> = root
|
||||
.get()
|
||||
.ok_or_else(|| anyhow!("JSON 根节点必须是 Object 对象"))?;
|
||||
|
||||
// 1. target (必填)
|
||||
let target_val = map
|
||||
.get("target")
|
||||
.ok_or_else(|| anyhow!("缺少必填字段: target"))?;
|
||||
let target = JsonValidator::parse_target(target_val)?;
|
||||
|
||||
// 2. args (选填)
|
||||
let args = match map.get("args") {
|
||||
Some(args_val) => JsonValidator::parse_args(args_val)?,
|
||||
None => Vec::new(),
|
||||
};
|
||||
|
||||
// 3. env (选填)
|
||||
let env = match map.get("env") {
|
||||
Some(env_val) => JsonValidator::parse_env(env_val)?,
|
||||
None => HashMap::new(),
|
||||
};
|
||||
let aliases = match map.get("aliases") {
|
||||
Some(env_val) => JsonValidator::parse_aliases(env_val)?,
|
||||
None => HashMap::new(),
|
||||
};
|
||||
Ok(MirrorSpec {
|
||||
target,
|
||||
args,
|
||||
aliases,
|
||||
env,
|
||||
})
|
||||
}
|
||||
}
|
||||
6
src/sys.rs
Normal file
6
src/sys.rs
Normal file
@@ -0,0 +1,6 @@
|
||||
mod win;
|
||||
|
||||
pub use win::{
|
||||
ERROR_ELEVATION_REQUIRED, EXIT_FAILED_LOAD_SHIM, EXIT_FAILED_SPAWN_PROG, EXIT_FAILED_WAIT_PROG,
|
||||
EXIT_PROG_TERMINATED, execute_elevated, set_console_ctrl_handler,
|
||||
};
|
||||
152
src/sys/win.rs
Normal file
152
src/sys/win.rs
Normal file
@@ -0,0 +1,152 @@
|
||||
use std::os::windows::ffi::OsStrExt;
|
||||
use std::{env, mem::size_of, path::Path, ptr::null_mut};
|
||||
|
||||
use std::ffi::{OsStr, OsString};
|
||||
|
||||
use windows_sys::Win32::UI::Shell::{SHELLEXECUTEINFOW, ShellExecuteExW};
|
||||
|
||||
use windows_sys::Win32::Foundation::CloseHandle;
|
||||
use windows_sys::{
|
||||
Win32::{
|
||||
Foundation::{FALSE, TRUE},
|
||||
System::{
|
||||
Com::{COINIT_APARTMENTTHREADED, COINIT_DISABLE_OLE1DDE, CoInitializeEx},
|
||||
Console::{
|
||||
CTRL_BREAK_EVENT, CTRL_C_EVENT, CTRL_CLOSE_EVENT, CTRL_LOGOFF_EVENT,
|
||||
CTRL_SHUTDOWN_EVENT, SetConsoleCtrlHandler,
|
||||
},
|
||||
Threading::{GetExitCodeProcess, INFINITE, WaitForSingleObject},
|
||||
},
|
||||
UI::{
|
||||
Shell::{SEE_MASK_NOASYNC, SEE_MASK_NOCLOSEPROCESS},
|
||||
WindowsAndMessaging::SW_NORMAL,
|
||||
},
|
||||
},
|
||||
core::BOOL,
|
||||
};
|
||||
|
||||
pub const EXIT_FAILED_LOAD_SHIM: i32 = 1;
|
||||
pub const EXIT_FAILED_SPAWN_PROG: i32 = 2;
|
||||
pub const EXIT_FAILED_WAIT_PROG: i32 = 3;
|
||||
pub const EXIT_PROG_TERMINATED: i32 = 4;
|
||||
|
||||
pub const ERROR_ELEVATION_REQUIRED: i32 = 740;
|
||||
|
||||
unsafe extern "system" fn console_ctrl_handler(evt: u32) -> BOOL {
|
||||
match evt {
|
||||
CTRL_C_EVENT => TRUE, //eprintln!("ctrl_c handled!"),
|
||||
CTRL_BREAK_EVENT => TRUE, //eprintln!("ctrl_break handled!"),
|
||||
CTRL_CLOSE_EVENT => TRUE, //eprintln!("ctrl_close handled!"),
|
||||
CTRL_LOGOFF_EVENT => TRUE, //eprintln!("ctrl_logoff handled!"),
|
||||
CTRL_SHUTDOWN_EVENT => TRUE, //eprintln!("ctrl_shutdown handled!"),
|
||||
other => {
|
||||
eprintln!("未知的系统事件编号: {}，未处理！", other);
|
||||
FALSE
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
pub fn set_console_ctrl_handler() {
|
||||
let res: BOOL = unsafe { SetConsoleCtrlHandler(Some(console_ctrl_handler), TRUE) };
|
||||
if res == FALSE {
|
||||
eprintln!("警告: 注册控制台中断事件处理器失败。");
|
||||
}
|
||||
}
|
||||
|
||||
fn to_wide_null(s: impl AsRef<OsStr>) -> Vec<u16> {
|
||||
s.as_ref().encode_wide().chain(std::iter::once(0)).collect()
|
||||
}
|
||||
|
||||
pub fn execute_elevated(
|
||||
program: &Path,
|
||||
args: &[OsString],
|
||||
env_vars: Option<&std::collections::HashMap<String, OsString>>,
|
||||
) -> i32 {
|
||||
// 若提权启动，在此处将环境变量设置给当前进程（即将弹窗 UAC 的进程，随后会被子进程继承）
|
||||
if let Some(env_map) = env_vars {
|
||||
for (k, v) in env_map {
|
||||
unsafe {
|
||||
env::set_var(k, v);
|
||||
}
|
||||
}
|
||||
}
|
||||
// 2. 将参数列表按 Windows 命令行规则拼装为单个命令行字符串
|
||||
let mut arguments_os = OsString::new();
|
||||
for (i, arg) in args.iter().enumerate() {
|
||||
if i > 0 {
|
||||
arguments_os.push(" ");
|
||||
}
|
||||
let arg_str = arg.to_string_lossy();
|
||||
if arg_str.is_empty() {
|
||||
arguments_os.push("\"\"");
|
||||
} else if !arg_str.contains([' ', '\t', '"']) {
|
||||
arguments_os.push(arg);
|
||||
} else {
|
||||
// 包含空格或引号时进行标准转义包裹
|
||||
arguments_os.push("\"");
|
||||
for c in arg_str.chars() {
|
||||
match c {
|
||||
'\\' => arguments_os.push("\\\\"),
|
||||
'"' => arguments_os.push("\\\""),
|
||||
_ => arguments_os.push(c.to_string()),
|
||||
}
|
||||
}
|
||||
arguments_os.push("\"");
|
||||
}
|
||||
}
|
||||
|
||||
// 3. 准备 Windows 宽字符参数
|
||||
let runas = to_wide_null("runas");
|
||||
let program_wide = to_wide_null(program.as_os_str());
|
||||
let arguments_wide = to_wide_null(&arguments_os);
|
||||
|
||||
let mut info = SHELLEXECUTEINFOW {
|
||||
cbSize: size_of::<SHELLEXECUTEINFOW>() as u32,
|
||||
fMask: SEE_MASK_NOASYNC | SEE_MASK_NOCLOSEPROCESS,
|
||||
hwnd: null_mut(),
|
||||
lpVerb: runas.as_ptr(),
|
||||
lpFile: program_wide.as_ptr(),
|
||||
lpParameters: arguments_wide.as_ptr(),
|
||||
lpDirectory: null_mut(),
|
||||
nShow: SW_NORMAL as i32,
|
||||
hInstApp: null_mut(),
|
||||
lpIDList: null_mut(),
|
||||
lpClass: null_mut(),
|
||||
hkeyClass: null_mut(),
|
||||
dwHotKey: 0,
|
||||
Anonymous: unsafe { std::mem::zeroed() },
|
||||
hProcess: null_mut(),
|
||||
};
|
||||
// let arguments = CString::new(&arguments[..]).unwrap();
|
||||
// let mut info = SHELLEXECUTEINFOA::default();
|
||||
// info.cbSize = size_of::<SHELLEXECUTEINFOA>() as u32;
|
||||
// info.fMask = SEE_MASK_NOASYNC | SEE_MASK_NOCLOSEPROCESS;
|
||||
// info.lpVerb = runas.as_ptr().cast::<u8>();
|
||||
// info.lpFile = program.as_ptr().cast::<u8>();
|
||||
// info.lpParameters = arguments.as_ptr().cast::<u8>();
|
||||
// info.nShow = SW_NORMAL;
|
||||
let res = unsafe {
|
||||
CoInitializeEx(
|
||||
null_mut(),
|
||||
(COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE) as u32,
|
||||
);
|
||||
// ShellExecuteExA(&mut info as *mut _)
|
||||
ShellExecuteExW(&mut info)
|
||||
};
|
||||
if res == FALSE || info.hProcess == null_mut() {
|
||||
return EXIT_FAILED_SPAWN_PROG;
|
||||
}
|
||||
// 5. 等待提权子进程执行结束并获取退出状态码
|
||||
let mut exit_code: u32 = 0;
|
||||
unsafe {
|
||||
WaitForSingleObject(info.hProcess, INFINITE);
|
||||
let ok = GetExitCodeProcess(info.hProcess, &mut exit_code);
|
||||
CloseHandle(info.hProcess); // 释放进程句柄，防止资源泄露
|
||||
|
||||
if ok == FALSE {
|
||||
return EXIT_FAILED_WAIT_PROG;
|
||||
}
|
||||
}
|
||||
|
||||
exit_code as i32
|
||||
}
|
||||
233
src/utils.rs
Normal file
233
src/utils.rs
Normal file
@@ -0,0 +1,233 @@
|
||||
use mlua::LuaString;
|
||||
use std::ffi::OsString;
|
||||
use std::path::Path;
|
||||
|
||||
/// 将 Path 转换为适合 Lua 使用的安全字符串路径
|
||||
pub fn normalize_path_for_lua(path: &Path) -> String {
|
||||
// 自动将 Windows UNC 规范路径转回传统路径
|
||||
let simplified = dunce::simplified(path);
|
||||
simplified.to_string_lossy().replace('\\', "/")
|
||||
}
|
||||
|
||||
/// 将 Lua 字符串转为 Rust 字符串；非 UTF-8 按系统默认的 ANSI/OEM (如 GBK) 进行安全解码
|
||||
pub fn lua_string_2_os_string(s: &LuaString) -> mlua::Result<OsString> {
|
||||
let raw_bytes = &s.as_bytes();
|
||||
// 1. Unix 平台：直接零拷贝透传原始字节（无损支持任意编码）
|
||||
#[cfg(unix)]
|
||||
{
|
||||
use std::os::unix::ffi::OsStrExt;
|
||||
Ok(OsStr::from_bytes(raw_bytes).to_os_string())
|
||||
}
|
||||
// 2. Windows 平台：优先按 UTF-8 解码，失败则按当前系统本地代码页 (ANSI/GBK) 转换
|
||||
#[cfg(windows)]
|
||||
{
|
||||
// 先尝试标准的 UTF-8
|
||||
if let Ok(utf8_str) = std::str::from_utf8(raw_bytes) {
|
||||
return Ok(OsString::from(utf8_str));
|
||||
}
|
||||
|
||||
unsafe {
|
||||
use std::os::windows::ffi::OsStringExt;
|
||||
use windows_sys::Win32::Globalization::{
|
||||
CP_ACP, MB_ERR_INVALID_CHARS, MultiByteToWideChar,
|
||||
};
|
||||
|
||||
if raw_bytes.is_empty() {
|
||||
return Ok(OsString::new());
|
||||
}
|
||||
|
||||
let len = MultiByteToWideChar(
|
||||
CP_ACP,
|
||||
MB_ERR_INVALID_CHARS,
|
||||
raw_bytes.as_ptr(),
|
||||
raw_bytes.len() as i32,
|
||||
std::ptr::null_mut(),
|
||||
0,
|
||||
);
|
||||
|
||||
if len <= 0 {
|
||||
// 构造一个带上下文的 FromLua 转换错误，便于定位配置问题
|
||||
return Err(mlua::Error::FromLuaConversionError {
|
||||
from: "LuaString",
|
||||
to: "OsString".to_string(),
|
||||
message: Some(
|
||||
format!("字符串{:?}包含无效或当前系统无法识别的编码字节", s).to_string(),
|
||||
),
|
||||
});
|
||||
}
|
||||
|
||||
let mut buf = vec![0u16; len as usize];
|
||||
MultiByteToWideChar(
|
||||
CP_ACP,
|
||||
MB_ERR_INVALID_CHARS,
|
||||
raw_bytes.as_ptr(),
|
||||
raw_bytes.len() as i32,
|
||||
buf.as_mut_ptr(),
|
||||
len,
|
||||
);
|
||||
|
||||
Ok(OsString::from_wide(&buf))
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 将输入的字符串按 Shell 规则切分为独立的 CLI 参数 Token
|
||||
/// - 自动过滤连续空格
|
||||
/// - 支持单引号 `'...'` 和双引号 `"..."` 包裹包含空格的参数
|
||||
pub fn parse_tokens(input: &str) -> Vec<OsString> {
|
||||
let mut tokens = Vec::new();
|
||||
let mut current_token = String::new();
|
||||
let mut in_quote: Option<char> = None;
|
||||
let mut chars = input.chars().peekable();
|
||||
|
||||
while let Some(ch) = chars.next() {
|
||||
match (ch, in_quote) {
|
||||
// 处理转义字符 (例如 \")
|
||||
('\\', _quote) => {
|
||||
if let Some(&next_ch) = chars.peek() {
|
||||
let should_escape = if cfg!(windows) {
|
||||
// Windows 策略：只有在转义引号、反斜杠本身时才剥离 \
|
||||
// （如果在双引号内部，空格也不应该被 \ 转义）
|
||||
next_ch == '"' || next_ch == '\'' || next_ch == '\\'
|
||||
} else {
|
||||
// Unix 策略：标准 Shell 转义（引号、反斜杠、空格等）
|
||||
next_ch == '"'
|
||||
|| next_ch == '\''
|
||||
|| next_ch == '\\'
|
||||
|| next_ch.is_whitespace()
|
||||
};
|
||||
|
||||
if should_escape {
|
||||
chars.next(); // 消耗掉下一个字符
|
||||
current_token.push(next_ch);
|
||||
} else {
|
||||
// 保留 Windows 路径分隔符或未知转义中的 \
|
||||
current_token.push('\\');
|
||||
}
|
||||
} else {
|
||||
// 结尾孤立的 \
|
||||
current_token.push('\\');
|
||||
}
|
||||
}
|
||||
// 遇到引号：开启或关闭引号包裹
|
||||
('"' | '\'', None) => {
|
||||
in_quote = Some(ch);
|
||||
}
|
||||
('"' | '\'', Some(q)) if q == ch => {
|
||||
in_quote = None;
|
||||
}
|
||||
// 引号外部遇到空白字符：切分出一个完整的 Token
|
||||
(ch, None) if ch.is_whitespace() => {
|
||||
if !current_token.is_empty() {
|
||||
tokens.push(OsString::from(std::mem::take(&mut current_token)));
|
||||
}
|
||||
}
|
||||
// 其他字符或引号内部字符：直接追加
|
||||
(ch, _) => {
|
||||
current_token.push(ch);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 收尾最后一个 Token
|
||||
if !current_token.is_empty() {
|
||||
tokens.push(OsString::from(current_token));
|
||||
}
|
||||
|
||||
tokens
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use std::ffi::OsString;
|
||||
/// 辅助宏：简化声明与断言对比
|
||||
macro_rules! assert_tokens {
|
||||
($input:expr, $expected:expr) => {
|
||||
let actual = parse_tokens($input);
|
||||
let expected_os: Vec<OsString> = $expected.into_iter().map(OsString::from).collect();
|
||||
assert_eq!(
|
||||
actual, expected_os,
|
||||
"\n测试输入: {:?}\n期望输出: {:?}\n实际输出: {:?}",
|
||||
$input, expected_os, actual
|
||||
);
|
||||
};
|
||||
}
|
||||
#[test]
|
||||
fn test_parse_tokens_basic_split() {
|
||||
// 场景 1：基础多参数拆分（空格分隔）
|
||||
assert_tokens!("cargo run --verbose", vec!["cargo", "run", "--verbose"]);
|
||||
assert_tokens!("git status", vec!["git", "status"]);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_parse_tokens_multi_alias_ref() {
|
||||
// 场景 2：多别名混合与组合引用
|
||||
assert_tokens!(
|
||||
"mr:run --bin mr:base_flags",
|
||||
vec!["mr:run", "--bin", "mr:base_flags"]
|
||||
);
|
||||
assert_tokens!(
|
||||
"mr:app1 mr:app2 --flag",
|
||||
vec!["mr:app1", "mr:app2", "--flag"]
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_parse_tokens_continuous_whitespaces() {
|
||||
// 场景 3：连续多空格与制表符过滤
|
||||
assert_tokens!(
|
||||
"mr:run --bin \t my_app",
|
||||
vec!["mr:run", "--bin", "my_app"]
|
||||
);
|
||||
assert_tokens!(" cargo build ", vec!["cargo", "build"]);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_parse_tokens_double_quotes() {
|
||||
// 场景 4：双引号包裹包含空格的参数
|
||||
assert_tokens!(
|
||||
"git commit -m \"fix a bug\"",
|
||||
vec!["git", "commit", "-m", "fix a bug"]
|
||||
);
|
||||
assert_tokens!("echo \"hello world\"", vec!["echo", "hello world"]);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_parse_tokens_single_quotes() {
|
||||
// 场景 5：单引号包裹包含空格的参数
|
||||
assert_tokens!(
|
||||
"gcc -O2 'my file.c' -o app",
|
||||
vec!["gcc", "-O2", "my file.c", "-o", "app"]
|
||||
);
|
||||
assert_tokens!(
|
||||
"python 'script with space.py'",
|
||||
vec!["python", "script with space.py"]
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_parse_tokens_escaped_characters() {
|
||||
// 场景 6：反斜杠转义字符
|
||||
assert_tokens!("echo hello\\ world", vec!["echo", "hello\\", "world"]);
|
||||
assert_tokens!(
|
||||
"echo \"hello \\\"world\\\"\"",
|
||||
vec!["echo", "hello \"world\""]
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_parse_tokens_single_scalar_and_edge_cases() {
|
||||
// 场景 7：单标量参数与边界情况
|
||||
assert_tokens!("git", vec!["git"]);
|
||||
assert_tokens!("8000", vec!["8000"]);
|
||||
assert_tokens!("", Vec::<&str>::new());
|
||||
assert_tokens!(" ", Vec::<&str>::new());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn test_parse_tokens_unclosed_quotes() {
|
||||
// 场景 8：未闭合引号的容错处理（会尽量追加到当前 Token 中）
|
||||
assert_tokens!("echo \"hello world", vec!["echo", "hello world"]);
|
||||
}
|
||||
}
|
||||
810
src/validators.rs
Normal file
810
src/validators.rs
Normal file
@@ -0,0 +1,810 @@
|
||||
use crate::error::validation_error;
|
||||
use crate::{lua_string_2_os_string, parse_tokens};
|
||||
use anyhow::{Context, Result, anyhow};
|
||||
use mlua::{LuaString, Table, Value};
|
||||
use std::collections::{HashMap, HashSet};
|
||||
use std::ffi::OsString;
|
||||
use std::fmt;
|
||||
use std::path::PathBuf;
|
||||
use std::str::FromStr;
|
||||
use tinyjson::JsonValue;
|
||||
|
||||
/// Lua 值校验器：针对不同上下文定义校验规则
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub enum LuaValidator {
|
||||
/// 目标程序路径：必须是字符串路径
|
||||
Target,
|
||||
/// 命令行参数元素：仅支持一维基础标量，禁止嵌套 Table
|
||||
Args,
|
||||
/// 环境变量值：支持基础标量及多维嵌套 Table（递归展平）
|
||||
Env,
|
||||
Aliases,
|
||||
}
|
||||
|
||||
impl fmt::Display for LuaValidator {
|
||||
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||
match self {
|
||||
Self::Target => write!(f, "目标路径 (target)"),
|
||||
Self::Args => write!(f, "命令行参数 (args)"),
|
||||
Self::Env => write!(f, "环境变量 (env)"),
|
||||
Self::Aliases => write!(f, "命令行别名 (aliases)"),
|
||||
}
|
||||
}
|
||||
}
|
||||
impl LuaValidator {
|
||||
fn parse_sequence(&self, index: i64, item: &Value) -> mlua::Result<()> {
|
||||
match item {
|
||||
Value::String(_) | Value::Integer(_) | Value::Number(_) | Value::Boolean(_) => Ok(()),
|
||||
Value::Table(tbl) => match self {
|
||||
Self::Env | Self::Aliases => self.validate_sequence_table(tbl),
|
||||
Self::Args => Err(validation_error(format!(
|
||||
"{} 仅支持一维数组，不能包含嵌套 Table,索引位置: {index}",
|
||||
self
|
||||
))),
|
||||
Self::Target => Err(validation_error(format!("{} 仅支持字符串", self))),
|
||||
},
|
||||
other => Err(validation_error(format!(
|
||||
"{} 第 {} 个元素类型无效: {}",
|
||||
self,
|
||||
index,
|
||||
other.type_name()
|
||||
))),
|
||||
}
|
||||
}
|
||||
|
||||
/// 校验 Table 是否为严格连续的纯数组，并递归校验其内部元素
|
||||
fn validate_sequence_table(&self, tbl: &Table) -> mlua::Result<()> {
|
||||
let mut index = 1i64;
|
||||
|
||||
// 1. 顺序遍历连续整数索引 1..N
|
||||
loop {
|
||||
let item: Value = tbl.raw_get(index)?;
|
||||
if matches!(&item, Value::Nil) {
|
||||
break;
|
||||
}
|
||||
self.parse_sequence(index, &item)?;
|
||||
|
||||
index += 1;
|
||||
}
|
||||
|
||||
// 2. 查漏：校验是否存在空洞索引或字典键 (Key-Value 键值对)
|
||||
for pair in tbl.pairs::<Value, Value>() {
|
||||
let (key, _) = pair?;
|
||||
match key {
|
||||
Value::Integer(i) if i >= 1 && i < index => {} // 已遍历放行
|
||||
Value::Integer(_) => {
|
||||
return Err(validation_error(format!(
|
||||
"{} 第 {} 个元素为 nil 或不存在（请检查漏写引号或变量未定义）",
|
||||
self, index
|
||||
)));
|
||||
}
|
||||
_ => {
|
||||
return Err(validation_error(format!(
|
||||
"{} 必须是纯列表，不能包含键值对/字典结构",
|
||||
self
|
||||
)));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// 底层 NUL 字符跨平台安全检查
|
||||
fn ensure_no_nul(context: &impl fmt::Display, os_str: &std::ffi::OsStr) -> mlua::Result<()> {
|
||||
#[cfg(unix)]
|
||||
{
|
||||
use std::os::unix::ffi::OsStrExt;
|
||||
if os_str.as_bytes().contains(&0) {
|
||||
return Err(conversion_error(format!(
|
||||
"{} 的值不能包含 NUL 字符",
|
||||
context
|
||||
)));
|
||||
}
|
||||
}
|
||||
#[cfg(windows)]
|
||||
{
|
||||
use std::os::windows::ffi::OsStrExt;
|
||||
if os_str.encode_wide().any(|c| c == 0) {
|
||||
return Err(validation_error(format!(
|
||||
"{} 的值不能包含 NUL 字符",
|
||||
context
|
||||
)));
|
||||
}
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
|
||||
/// 【纯粹数据转换与展开】将已通过校验的 Value 递归解析为 OsString 动态数组
|
||||
fn collect_value_into(&self, value: &Value, out: &mut Vec<OsString>) -> mlua::Result<()> {
|
||||
match value {
|
||||
Value::Nil => {}
|
||||
Value::String(s) => {
|
||||
let os_str = lua_string_2_os_string(s)?;
|
||||
match self {
|
||||
Self::Args | Self::Aliases => {
|
||||
if let Some(str_ref) = os_str.to_str() {
|
||||
// 使用 Tokenizer 切分空格与引号
|
||||
out.extend(parse_tokens(str_ref));
|
||||
} else {
|
||||
// 对于无法转为 UTF-8 的特殊二进制数据，作为整体追加
|
||||
out.push(os_str);
|
||||
}
|
||||
}
|
||||
Self::Env => {
|
||||
out.push(os_str);
|
||||
}
|
||||
Self::Target => {}
|
||||
}
|
||||
}
|
||||
Value::Integer(i) => out.push(OsString::from(i.to_string())),
|
||||
Value::Number(n) => {
|
||||
tracing::warn!(%self, value = %n, "浮点数将按十进制格式转换为字符串");
|
||||
out.push(OsString::from(n.to_string()));
|
||||
}
|
||||
Value::Boolean(b) => {
|
||||
tracing::warn!(%self, value = %b, "布尔值将转换为字符串");
|
||||
out.push(OsString::from(b.to_string()));
|
||||
}
|
||||
Value::Table(tbl) => {
|
||||
let mut index = 1i64;
|
||||
loop {
|
||||
let item: Value = tbl.raw_get(index)?;
|
||||
if matches!(item, Value::Nil) {
|
||||
break;
|
||||
}
|
||||
|
||||
Self::collect_value_into(self, &item, out)?;
|
||||
index += 1;
|
||||
}
|
||||
}
|
||||
_ => unreachable!("传入收集器的 Value 应已通过 validate 校验"),
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
fn parse_name(name: &Value) -> mlua::Result<String> {
|
||||
let name_str = match name {
|
||||
Value::String(s) => match s.to_str() {
|
||||
Ok(str_ref) => str_ref.to_string(),
|
||||
Err(_) => return Err(validation_error("环境变量名必须是合法的 UTF-8 字符串")),
|
||||
},
|
||||
other => {
|
||||
return Err(validation_error(format!(
|
||||
"环境变量键名类型错误：期望 string，实际是 {}",
|
||||
other.type_name()
|
||||
)));
|
||||
}
|
||||
};
|
||||
if name_str.is_empty() {
|
||||
return Err(validation_error("环境变量名不能为空"));
|
||||
}
|
||||
if name_str.contains('=') {
|
||||
return Err(validation_error(format!(
|
||||
"环境变量名 [{}] 不能包含 '='",
|
||||
name_str
|
||||
)));
|
||||
}
|
||||
if name_str.contains('\0') {
|
||||
return Err(validation_error(format!(
|
||||
"环境变量名 [{}] 不能包含 NUL 字符",
|
||||
name_str
|
||||
)));
|
||||
}
|
||||
Ok(name_str)
|
||||
}
|
||||
fn parse_val(&self, name: &str, value: &Value) -> mlua::Result<()> {
|
||||
match value {
|
||||
Value::Nil
|
||||
| Value::String(_)
|
||||
| Value::Integer(_)
|
||||
| Value::Number(_)
|
||||
| Value::Boolean(_) => Ok(()),
|
||||
Value::Table(tbl) => self.validate_sequence_table(tbl),
|
||||
other => Err(validation_error(format!(
|
||||
"{} [{}]不支持 {} 类型, 仅支持 string/number/boolean 或嵌套数组",
|
||||
self,
|
||||
name,
|
||||
other.type_name()
|
||||
))),
|
||||
}
|
||||
}
|
||||
}
|
||||
impl LuaValidator {
|
||||
/// 解析并校验 `target`
|
||||
pub fn parse_target(value: &Value) -> mlua::Result<PathBuf> {
|
||||
let ctx = Self::Target;
|
||||
match value {
|
||||
Value::String(s) => {
|
||||
let os_str = lua_string_2_os_string(&s)?;
|
||||
Self::ensure_no_nul(&ctx, &os_str)?;
|
||||
Ok(PathBuf::from(os_str))
|
||||
}
|
||||
Value::Nil => Err(validation_error("缺少必填字段 target（应为字符串路径）")),
|
||||
other => Err(validation_error(format!(
|
||||
"{} 需为有效的路径且类型必须是字符串，实际类型是 {}",
|
||||
ctx,
|
||||
other.type_name()
|
||||
))),
|
||||
}
|
||||
}
|
||||
|
||||
/// 解析并校验 `args`
|
||||
pub fn parse_args(value: &Value) -> mlua::Result<Vec<OsString>> {
|
||||
{
|
||||
println!("跟踪args1{}", value.type_name());
|
||||
#[cfg(not(feature = "args"))]
|
||||
Ok(Vec::new())
|
||||
}
|
||||
#[cfg(feature = "args")]
|
||||
{
|
||||
println!("跟踪args1{}", value.type_name());
|
||||
let ctx = Self::Args;
|
||||
match value {
|
||||
Value::Table(tbl) => {
|
||||
ctx.validate_sequence_table(tbl)?;
|
||||
|
||||
let capacity = tbl.raw_len().min(128);
|
||||
|
||||
let mut raw_parts = Vec::with_capacity(capacity);
|
||||
|
||||
Self::collect_value_into(&ctx, value, &mut raw_parts)?;
|
||||
|
||||
for part in &raw_parts {
|
||||
Self::ensure_no_nul(&ctx, &part)?;
|
||||
}
|
||||
Ok(raw_parts)
|
||||
}
|
||||
other => Err(validation_error(format!(
|
||||
"{} 必须是数组列表，实际类型是 {}",
|
||||
ctx,
|
||||
other.type_name()
|
||||
)))?,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 校验环境变量名的合法性（Windows 约束：非空、不含 '='、不含 NUL）
|
||||
fn parse_env_name(name: &Value) -> mlua::Result<String> {
|
||||
Self::parse_name(name)
|
||||
}
|
||||
|
||||
/// 解析、校验并拼接单个环境变量键值对 (`key`, `value`) -> (`OsString`)
|
||||
fn parse_env_val(
|
||||
context: &LuaValidator,
|
||||
name: &str,
|
||||
raw_val: &Value,
|
||||
) -> mlua::Result<OsString> {
|
||||
context.parse_val(name, raw_val)?;
|
||||
|
||||
// let ctx = format!("{} [{}]", context, name);
|
||||
let capacity = match raw_val {
|
||||
Value::Table(t) => t.raw_len().min(128),
|
||||
Value::Nil => 0,
|
||||
_ => 1,
|
||||
};
|
||||
|
||||
let mut parts = Vec::with_capacity(capacity);
|
||||
|
||||
Self::collect_value_into(&context, raw_val, &mut parts)?;
|
||||
// context.collect_value_into(raw_val, &mut parts)?;
|
||||
|
||||
// 校验每个展开元素的 NUL 字符
|
||||
for part in &parts {
|
||||
Self::ensure_no_nul(&name, part)?;
|
||||
}
|
||||
// 3. 使用系统路径分隔符拼接数组列表
|
||||
let joined_os_str = std::env::join_paths(parts).map_err(|e| {
|
||||
validation_error(format!("{} 的值无法用系统路径分隔符拼接: {}", context, e))
|
||||
})?;
|
||||
Ok(joined_os_str)
|
||||
}
|
||||
|
||||
/// 解析整个 `env` Table，直接返回安全的环境变量 Map
|
||||
pub fn parse_env(value: &Value) -> mlua::Result<HashMap<String, OsString>> {
|
||||
let ctx = Self::Env;
|
||||
|
||||
let Value::Table(tbl) = value else {
|
||||
// 这里作为防御性校验，外部虽然 match 过了，但内层仍保持强类型安全
|
||||
return Err(validation_error(format!(
|
||||
"{} 必须是键值表 (table)，实际类型是 {}",
|
||||
ctx,
|
||||
value.type_name()
|
||||
)));
|
||||
};
|
||||
|
||||
let mut env_map = HashMap::new();
|
||||
let mut n = 0i32;
|
||||
|
||||
for pair in tbl.pairs::<Value, Value>() {
|
||||
n += 1;
|
||||
|
||||
let (raw_key, raw_val) = pair?;
|
||||
println!("env {} {}", n, raw_val.type_name());
|
||||
|
||||
// 1. 解析并校验 Key，拿到安全的 String
|
||||
let key = Self::parse_env_name(&raw_key)?;
|
||||
|
||||
// 2. 借用 &name 传递给 Value 解析器作为上下文
|
||||
let val = Self::parse_env_val(&ctx, &key, &raw_val)?;
|
||||
|
||||
env_map.insert(key, val);
|
||||
}
|
||||
|
||||
Ok(env_map)
|
||||
}
|
||||
}
|
||||
|
||||
impl LuaValidator {
|
||||
/// 校验环境变量名的合法性（Windows 约束：非空、不含 '='、不含 NUL）
|
||||
fn parse_aliases_name(name: &Value) -> mlua::Result<String> {
|
||||
Self::parse_name(name)
|
||||
}
|
||||
fn parse_aliases_val(
|
||||
context: &LuaValidator,
|
||||
name: &str,
|
||||
raw_val: &Value,
|
||||
) -> mlua::Result<Vec<OsString>> {
|
||||
context.parse_val(name, raw_val)?;
|
||||
|
||||
// let ctx = format!("{} [{}]", context, name);
|
||||
// 预估容量：标量为 1，表取其实际长度（设置上限以防止异常输入）
|
||||
let capacity = match raw_val {
|
||||
Value::Table(t) => (t.raw_len() as usize).min(16),
|
||||
Value::Nil => 0,
|
||||
_ => 1,
|
||||
};
|
||||
|
||||
let mut parts = Vec::with_capacity(capacity);
|
||||
Self::collect_value_into(context, raw_val, &mut parts)?;
|
||||
Ok(parts)
|
||||
}
|
||||
/// 解析并打平别名表 (aliases)
|
||||
/// - 支持输入为 Nil / None / Table
|
||||
/// - 别名的值支持：String, Number, Boolean, Nil, " " 空白串, Table(连续数组)
|
||||
/// - 字符串作为整体参数保存，仅做 trim() 清理首尾空格，不按空格拆分
|
||||
/// - 包含拓扑展开与死环检测
|
||||
pub fn parse_aliases(value: &Value) -> mlua::Result<HashMap<String, Vec<OsString>>> {
|
||||
let ctx = Self::Aliases;
|
||||
// 1. 处理 nil / None 的情况，直接返回空 HashMap
|
||||
let Value::Table(table) = value else {
|
||||
return Err(validation_error(format!(
|
||||
"{} 必须是键值表 (table) ，当前类型: {}",
|
||||
ctx,
|
||||
value.type_name()
|
||||
)));
|
||||
};
|
||||
|
||||
// 阶段一：提取原始别名映射 (Raw Extraction)
|
||||
let mut raw_aliases: HashMap<String, Vec<OsString>> = HashMap::new();
|
||||
|
||||
for pair in table.pairs::<Value, Value>() {
|
||||
let (raw_key, raw_val) = pair?;
|
||||
let key = Self::parse_aliases_name(&raw_key)?;
|
||||
let val = Self::parse_aliases_val(&ctx, &key, &raw_val)?;
|
||||
|
||||
raw_aliases.insert(key, val);
|
||||
}
|
||||
// 阶段二：递归拓扑打平与循环引用检测 (Flattening & Cycle Detection)
|
||||
let mut visited_stack = HashSet::new();
|
||||
|
||||
for key in raw_aliases.keys() {
|
||||
visited_stack.clear();
|
||||
Self::detect_alias_cycle(key, &raw_aliases, &mut visited_stack)?;
|
||||
}
|
||||
|
||||
// 阶段三：无环前提下的高效展开
|
||||
let mut flattened_aliases: HashMap<String, Vec<OsString>> =
|
||||
HashMap::with_capacity(raw_aliases.len());
|
||||
|
||||
let mut resolved_args = Vec::new();
|
||||
|
||||
for key in raw_aliases.keys() {
|
||||
resolved_args.clear();
|
||||
Self::expand_alias_dfs(key, &raw_aliases, &mut resolved_args);
|
||||
flattened_aliases.insert(key.clone(), resolved_args.clone());
|
||||
}
|
||||
|
||||
Ok(flattened_aliases)
|
||||
}
|
||||
|
||||
/// 仅用于校验别名依赖图中是否存在死循环（不消耗额外的参数拼接内存）
|
||||
fn detect_alias_cycle(
|
||||
current_key: &str,
|
||||
raw_aliases: &HashMap<String, Vec<OsString>>,
|
||||
visited_stack: &mut HashSet<String>,
|
||||
) -> mlua::Result<()> {
|
||||
// 递归栈中再次遇到相同的 Key，说明存在死循环
|
||||
if visited_stack.contains(current_key) {
|
||||
return Err(validation_error(format!(
|
||||
"配置加载失败: 检测到别名循环嵌套依赖 'mr:{}'",
|
||||
current_key
|
||||
)));
|
||||
}
|
||||
|
||||
if let Some(args) = raw_aliases.get(current_key) {
|
||||
// 压栈
|
||||
visited_stack.insert(current_key.to_string());
|
||||
|
||||
for arg in args {
|
||||
let arg_str = arg.to_string_lossy();
|
||||
if let Some(sub_key) = arg_str.strip_prefix("mr:") {
|
||||
// 如果引用的子别名在映射表中存在，则深度优先校验
|
||||
if raw_aliases.contains_key(sub_key) {
|
||||
Self::detect_alias_cycle(sub_key, raw_aliases, visited_stack)?;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 出栈（回溯）
|
||||
visited_stack.remove(current_key);
|
||||
}
|
||||
|
||||
Ok(())
|
||||
}
|
||||
/// 安全拓扑展开：在保证绝对无环的前提下递归展开 mr: 前缀参数
|
||||
fn expand_alias_dfs(
|
||||
current_key: &str,
|
||||
raw_aliases: &HashMap<String, Vec<OsString>>,
|
||||
out: &mut Vec<OsString>,
|
||||
) {
|
||||
if let Some(args) = raw_aliases.get(current_key) {
|
||||
for arg in args {
|
||||
let arg_str = arg.to_string_lossy();
|
||||
if let Some(sub_key) = arg_str.strip_prefix("mr:") {
|
||||
if raw_aliases.contains_key(sub_key) {
|
||||
// 安全地直接递归展开，无需再检查死循环
|
||||
Self::expand_alias_dfs(sub_key, raw_aliases, out);
|
||||
} else {
|
||||
// 找不到对应的别名，按原样参数输出
|
||||
out.push(arg.clone());
|
||||
}
|
||||
} else {
|
||||
// 普通参数，直接输出
|
||||
out.push(arg.clone());
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 专用于 JSON (tinyjson) 的类型校验与字段提取器
|
||||
//当前JsonValidator还为完全可用，后期会对其lua配置特别需要处理动态函数生成的值如：get_env("PATH")
|
||||
// 数据结构：{
|
||||
// "target": "C:/tools/git.exe",
|
||||
// "args": [
|
||||
// "--no-pager",
|
||||
// 2,
|
||||
// true
|
||||
// ],
|
||||
// "env": {
|
||||
// "PATH": ["C:/tools/git/bin", "C:/Windows"],
|
||||
// "HOME": "C:/tools/home",
|
||||
// "CONST": 3,
|
||||
// "BOOL": true
|
||||
// }
|
||||
// }
|
||||
pub struct JsonValidator;
|
||||
|
||||
impl JsonValidator {
|
||||
/// 校验并解析 target (必填，非空字符串)
|
||||
pub fn parse_target(val: &JsonValue) -> Result<PathBuf> {
|
||||
let s: &String = val
|
||||
.get()
|
||||
.ok_or_else(|| anyhow!("字段 'target' 必须是字符串"))?;
|
||||
|
||||
if s.trim().is_empty() {
|
||||
return Err(anyhow!("字段 'target' 不能为空字符串"));
|
||||
}
|
||||
Ok(PathBuf::from(s))
|
||||
}
|
||||
|
||||
/// 校验并解析 args (选填，必须为字符串数组)
|
||||
pub fn parse_args(val: &JsonValue) -> Result<Vec<OsString>> {
|
||||
let args_vec: &Vec<JsonValue> =
|
||||
val.get().ok_or_else(|| anyhow!("字段 'args' 必须是数组"))?;
|
||||
|
||||
args_vec
|
||||
.iter()
|
||||
.map(|item| {
|
||||
let s: &String = item
|
||||
.get()
|
||||
.ok_or_else(|| anyhow!("'args' 数组内的元素必须全为字符串"))?;
|
||||
Ok(OsString::from(s))
|
||||
})
|
||||
.collect()
|
||||
}
|
||||
|
||||
/// 校验并解析 env (选填，必须为 KV 对象)
|
||||
pub fn parse_env(val: &JsonValue) -> Result<HashMap<String, OsString>> {
|
||||
let env_map: &HashMap<String, JsonValue> = val
|
||||
.get()
|
||||
.ok_or_else(|| anyhow!("字段 'env' 必须是 Object 键值对"))?;
|
||||
let mut result = HashMap::new();
|
||||
for (k, v) in env_map {
|
||||
let mut segments = Vec::new();
|
||||
Self::collect_env_segments(v, &mut segments)?;
|
||||
|
||||
if !segments.is_empty() {
|
||||
// 根据操作系统自动拼接环境变量分隔符 (Windows 为 ';', Unix 为 ':')
|
||||
#[cfg(windows)]
|
||||
let sep = std::ffi::OsStr::new(";");
|
||||
#[cfg(not(windows))]
|
||||
let sep = std::ffi::OsStr::new(":");
|
||||
|
||||
let joined = segments.join(sep);
|
||||
result.insert(k.clone(), joined);
|
||||
}
|
||||
}
|
||||
|
||||
Ok(result)
|
||||
}
|
||||
pub fn parse_aliases(val: &JsonValue) -> Result<HashMap<String, Vec<OsString>>> {
|
||||
todo!()
|
||||
}
|
||||
// =========================================================================
|
||||
// 私有辅助方法
|
||||
// =========================================================================
|
||||
|
||||
/// 单个标量节点转换为 OsString (支持 String, Number, Boolean)
|
||||
fn value_to_os_string(val: &JsonValue, ctx: &str) -> Result<OsString> {
|
||||
if let Some(s) = val.get::<String>() {
|
||||
Ok(OsString::from(s))
|
||||
} else if let Some(n) = val.get::<f64>() {
|
||||
Ok(OsString::from(n.to_string()))
|
||||
} else if let Some(b) = val.get::<bool>() {
|
||||
Ok(OsString::from(b.to_string()))
|
||||
} else {
|
||||
Err(anyhow!("{} 内只支持字符串、数字或布尔类型", ctx))
|
||||
}
|
||||
}
|
||||
|
||||
/// 递归打平 env 节点中的数组/标量值
|
||||
fn collect_env_segments(val: &JsonValue, segments: &mut Vec<OsString>) -> Result<()> {
|
||||
if let Some(arr) = val.get::<Vec<JsonValue>>() {
|
||||
for item in arr {
|
||||
Self::collect_env_segments(item, segments)?;
|
||||
}
|
||||
} else {
|
||||
let parsed_segment = Self::value_to_os_string(val, "'env' 节点的 Value")?;
|
||||
segments.push(parsed_segment);
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use crate::MirrorSpec;
|
||||
use mlua::{FromLua, Lua};
|
||||
|
||||
fn parse(src: &str) -> mlua::Result<MirrorSpec> {
|
||||
let lua = Lua::new();
|
||||
// 模拟 runtime 注入的 get_env：返回按平台分隔符拆分的段数组（空变量返回空表）
|
||||
let get_env = lua
|
||||
.create_function(|lua, key: String| -> mlua::Result<Table> {
|
||||
let value = std::env::var(key).unwrap_or_default();
|
||||
let segments: Vec<String> = if value.is_empty() {
|
||||
Vec::new()
|
||||
} else {
|
||||
std::env::split_paths(std::ffi::OsStr::new(&value))
|
||||
.map(|p| p.to_string_lossy().into_owned())
|
||||
.collect()
|
||||
};
|
||||
lua.create_sequence_from(segments)
|
||||
})
|
||||
.unwrap();
|
||||
lua.globals().set("get_env", get_env).unwrap();
|
||||
|
||||
let value = lua.load(src).eval::<Value>()?;
|
||||
let t = MirrorSpec::from_lua(value, &lua);
|
||||
println!("读取出的数据：{:?}", t.clone()?);
|
||||
t
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn parses_basic_config() {
|
||||
let cfg = parse(
|
||||
r#"
|
||||
return {
|
||||
target = "C:/tools/git.exe",
|
||||
args = { "--no-pager",2},
|
||||
env = {
|
||||
PATH = { "C:/tools/git/bin", "C:/Windows", get_env("PATH")},
|
||||
HOME = "C:/tools/home",
|
||||
CONST = 3,
|
||||
BOOL = true,
|
||||
},
|
||||
aliases = {
|
||||
-- 1. 整体字符串（会自动 trim 首尾空格，保留为单个参数）
|
||||
st = "status -s",
|
||||
|
||||
-- 2. 连续数组表 (Sequence Table)
|
||||
lg = { "log", "--oneline", "-n", 10 },
|
||||
|
||||
-- 3. 标量数字与布尔值支持
|
||||
v = 1,
|
||||
quiet = true,
|
||||
|
||||
-- 4. 嵌套别名组合（加载期会自动展开并进行死环检测）
|
||||
base_log = "log --graph",
|
||||
all_log = { "mr:base_log", "--all","D:\\CNWei\\CNW\\Rust","D:/CNWei/CNW/Rust/" ,[[D:\CNWei\CNW\Rust\]]},
|
||||
|
||||
-- 5. nil 或空字符串（解析为空参数列表）
|
||||
empty_alias = nil,
|
||||
blank = " "
|
||||
}
|
||||
}
|
||||
"#,
|
||||
)
|
||||
.unwrap();
|
||||
assert_eq!(cfg.target, PathBuf::from("C:/tools/git.exe"));
|
||||
// assert_eq!(cfg.args, vec!["--no-pager", "2"]);
|
||||
assert_eq!(cfg.env.get("HOME").unwrap().to_str(), Some("C:/tools/home"));
|
||||
// PATH 前缀来自配置，随后附加 get_env("PATH") 拆出的宿主 PATH 段
|
||||
let path = cfg.env.get("PATH").unwrap().to_str().unwrap();
|
||||
assert!(
|
||||
path == "C:/tools/git/bin;C:/Windows"
|
||||
|| path.starts_with("C:/tools/git/bin;C:/Windows;"),
|
||||
"unexpected PATH: {path}"
|
||||
);
|
||||
// ==================== aliases 断言校验 ====================
|
||||
|
||||
// 1. 整体字符串：保留原样（trim 后），不切分空格
|
||||
assert_eq!(
|
||||
cfg.aliases.get("st").unwrap(),
|
||||
&vec![OsString::from("status"), OsString::from("-s")]
|
||||
);
|
||||
|
||||
// 2. 连续数组表：按顺序转为 OsString 列表
|
||||
assert_eq!(
|
||||
cfg.aliases.get("lg").unwrap(),
|
||||
&vec![
|
||||
OsString::from("log"),
|
||||
OsString::from("--oneline"),
|
||||
OsString::from("-n"),
|
||||
OsString::from("10")
|
||||
]
|
||||
);
|
||||
|
||||
// 3. 标量数字与布尔值支持
|
||||
assert_eq!(cfg.aliases.get("v").unwrap(), &vec![OsString::from("1")]);
|
||||
assert_eq!(
|
||||
cfg.aliases.get("quiet").unwrap(),
|
||||
&vec![OsString::from("true")]
|
||||
);
|
||||
|
||||
// 4. 嵌套别名组合：加载期递归拓扑打平
|
||||
// base_log 本身为 "log --graph"
|
||||
assert_eq!(
|
||||
cfg.aliases.get("base_log").unwrap(),
|
||||
&vec![OsString::from("log"), OsString::from("--graph")]
|
||||
);
|
||||
// all_log 展开 mr:base_log 替换为 "log --graph"，追加 "--all"
|
||||
assert_eq!(
|
||||
cfg.aliases.get("all_log").unwrap(),
|
||||
&vec![
|
||||
OsString::from("log"),
|
||||
OsString::from("--graph"),
|
||||
OsString::from("--all"),
|
||||
OsString::from("D:\\CNWei\\CNW\\Rust"),
|
||||
OsString::from("D:/CNWei/CNW/Rust/"),
|
||||
OsString::from("D:\\CNWei\\CNW\\Rust\\"),
|
||||
]
|
||||
);
|
||||
|
||||
// 5. nil 与纯空白字符串：解析为空 Vec
|
||||
assert_eq!(cfg.aliases.get("blank").unwrap(), &Vec::<OsString>::new());
|
||||
// nil 键在遍历表时会被当作空或不存在，不产生 key 或值为空 Vec
|
||||
assert!(
|
||||
cfg.aliases
|
||||
.get("empty_alias")
|
||||
.map_or(true, |v| v.is_empty())
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn missing_args_and_env_are_empty() {
|
||||
let cfg = parse(r#"return { target = "t.exe" }"#).unwrap();
|
||||
assert!(cfg.args.is_empty());
|
||||
assert!(cfg.env.is_empty());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn keeps_empty_args() {
|
||||
let cfg = parse(r#"return { target = "t.exe", args = { "" } }"#).unwrap();
|
||||
assert_eq!(cfg.args, vec![""]);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn keeps_empty_env_value() {
|
||||
let cfg = parse(r#"return { target = "t.exe", env = { FOO = "" } }"#).unwrap();
|
||||
assert_eq!(cfg.env.get("FOO").unwrap().to_str(), Some(""));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn empty_array_clears_env_var() {
|
||||
let cfg = parse(r#"return { target = "t.exe", env = { PATH = {} } }"#).unwrap();
|
||||
assert_eq!(cfg.env.get("PATH").unwrap().to_str(), Some(""));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn expands_nested_env_array() {
|
||||
// get_env("PATH") 现在返回拆分后的段数组，嵌套表应被递归展开
|
||||
let cfg = parse(
|
||||
r#"return { target = "t.exe", env = { PATH = { "C:/a", { "C:/b", "C:/c" } } } }"#,
|
||||
)
|
||||
.unwrap();
|
||||
assert_eq!(
|
||||
cfg.env.get("PATH").unwrap().to_str(),
|
||||
Some("C:/a;C:/b;C:/c")
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_wrong_env_type() {
|
||||
assert!(parse(r#"return { target = "t.exe", env = "PATH=C:/x" }"#).is_err());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_sparse_env_array() {
|
||||
assert!(parse(r#"return { target = "t.exe", env = { P = { "a", nil, "b" } } }"#).is_err());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_mixed_key_env_array() {
|
||||
assert!(parse(r#"return { target = "t.exe", env = { P = { a = "b" } } }"#).is_err());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_invalid_env_key() {
|
||||
assert!(parse(r#"return { target = "t.exe", env = { ["FOO=1"] = "x" } }"#).is_err());
|
||||
assert!(parse(r#"return { target = "t.exe", env = { [""] = "x" } }"#).is_err());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_nul_in_env_value() {
|
||||
assert!(parse(r#"return { target = "t.exe", env = { P = { string.char(0) } } }"#).is_err());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_quote_in_env_value() {
|
||||
// Windows 的 join_paths 对含双引号的路径元素返回错误
|
||||
assert!(
|
||||
parse(r#"return { target = "t.exe", env = { P = { string.char(34) } } }"#).is_err()
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_unsupported_env_value_type() {
|
||||
assert!(parse(r#"return { target = "t.exe", env = { F = function() end } }"#).is_err());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn missing_target_is_error() {
|
||||
assert!(parse(r#"return { args = { "x" } }"#).is_err());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_non_string_target() {
|
||||
assert!(parse(r#"return { target = 123 }"#).is_err());
|
||||
assert!(parse(r#"return { target = false }"#).is_err());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_non_string_args_element() {
|
||||
// ValueShunt::Args 允许基础标量（数字/布尔）转字符串，仅禁止嵌套表
|
||||
let cfg = parse(r#"return { target = "t.exe", args = { 1, true } }"#).unwrap();
|
||||
assert_eq!(cfg.args, vec!["1", "true"]);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_sparse_args() {
|
||||
assert!(parse(r#"return { target = "t.exe", args = { "a", nil, "b" } }"#).is_err());
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn rejects_non_table_args() {
|
||||
assert!(parse(r#"return { target = "t.exe", args = "-B" }"#).is_err());
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user