https://github.com/slimenull/null.fastrun
一个快捷工具集管理工具, 可以设定从名称到路径的映射, 随后你便可以从任何地方通过"运行"来访问它们
https://github.com/slimenull/null.fastrun
tool yaml
Last synced: about 2 months ago
JSON representation
一个快捷工具集管理工具, 可以设定从名称到路径的映射, 随后你便可以从任何地方通过"运行"来访问它们
- Host: GitHub
- URL: https://github.com/slimenull/null.fastrun
- Owner: SlimeNull
- Created: 2022-02-17T15:01:52.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-04-09T16:51:08.000Z (about 4 years ago)
- Last Synced: 2025-05-20T23:13:43.299Z (about 1 year ago)
- Topics: tool, yaml
- Language: C#
- Homepage:
- Size: 180 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Null.FastRun
 
一个快捷工具集管理工具, 设定从名称到路径的映射, 程序将自动帮你创建快捷方式, 符号链接或硬链接, 并添加到 PATH 环境变量, 至此, 你便可以用通过 '运行对话框' 或着其他任何东西直接访问到你的程序, 文件或目录.
你也可以将你的工具与配置打包, 只需要用程序一键导入, 即可在朋友的电脑上部署它们.
## 程序
## 说明
程序以 yaml 格式存储配置信息, 默认的配置文件包含以下内容:
```yaml
# 存放链接的位置
links_path: C:\WINDOWS\NFastRun
# 链接类型 Shortcut, Symbolic 或 Hard
links_mode: Shortcut
# 链接映射, 在这里添加键值对
links:
```
添加一个映射, 可以使用 GUI 程序编辑, 也可以直接在 links 项下添加键值对:
```yaml
links:
me: C:\Users\SlimeNull
translate: C:\NShare\Programs\Translator.py
```
在程序应用配置时, 将会做以下行为:
1. 清空旧的链接并创建新的
2. 检查 PATH 环境变量, 并应用
> 这意味着, 如果您直接通过配置文件更改 links_path 节点, 旧的路径会残留在 PATH 环境变量中, 不要这么做
> 在 GUI 程序中, 应用配置同时会保存配置到配置文件
如果你已经应用过配置, 并且希望更改 links_path, 你可以
- 使用 Cli 运行 uninstall 指令
- 通过 GUI 程序在配置窗口中卸载配置
> 该操作会删除程序在 PATH 应用的路径, 并删除软链接目录.
## 使用
通过 Null.FastRun.Cli, 你可以方便的使用多个配置, 你也可以使用这种方式为你的工具分门别类.
```bash
# 创建 main.yaml 配置文件 (此时可以不指定拓展名)
Null.FastRun.Cli new main
# 应用 main.yaml
Null.FastRun.Cli apply main.yaml
# 卸载 main.yaml
Null.FastRun.Cli uninstall main.yaml
```
> 在创建配置时, 如果指定的文件名不以 '.yaml' 结尾, 那么程序会自动添加后缀 '.yaml'
如果你不喜欢使用 Cli 工具, 也可以使用窗体程序直接操作.
在程序主界面, 你可以拖动文件或目录到列表以快速添加映射, 随后你可以更改它们的名称.
单击 `应用` 来应用程序配置, 单击 `配置` 可以进入配置对话框, 在其中, 你可以卸载配置, 变更链接路径以及链接类型
## 相对路径
在 Null.FastRun 的配置文件中, 你可以使用相对路径, 在生成链接的时候, 程序会自动将相对路径以配置文件所在目录为基地址转换为绝对路径
通过这个操作, 你可以将一些工具集打包在一起, 然后编写一个配置文件, 这样, 该工具集便能够方便的共享给其他人, 例如:
创建文件与目录
```
|- .executable
| | translator.py
| | tts.exe
|
|- config.yaml
```
然后在配置文件中编辑为以下内容:
```yaml
links_path: C:\WINDOWS\NFastRun.MyTools
links_mode: Shortcut
links:
translator: .executable\translator.py
tts: .executable\tts.exe
```
## 程序集
程序的核心在 NullLib.FastRun 项目中, 该项目包含访问系统环境变量以及使用 WinAPI 创建软链接的逻辑.
Null.FastRun.Cli 是配置管理器命令行工具, 需要管理员权限才可以执行, 你可以使用它创建配置, 应用配置, 以及卸载配置.
Null.FastRun.WinForm 是管理器的 GUI 版本, 但是它依赖于 Cli, 在应用或卸载配置时, 它会调用 Cli 来实现功能.
> 之所以需要使用 Null.FastRun.WinForm 来调用 Null.FastRun.Cli, 是因为如果 GUI 程序拥有管理员权限, 那么用户将无法从没有管理员权限的普通进程中拖动文件到窗口中.