qcli 2.3.5

QuickCli - 跨平台快速启动器

一个跨平台快速启动工具，通过命令行快速打开文件夹、文件、URL，支持别名管理和 CLI 工具桥接。

安装

Windows

dotnet tool install -g qcli

Linux

# 安装 .NET SDK (如果尚未安装)
# Ubuntu/Debian:
curl -sSL https://dot.net/v/dotnet-sdk.sh | sudo -E bash -s

# 使用 dotnet tool 安装
dotnet tool install -g qcli

# 如果安装在非 PATH 位置，添加路径
echo 'export PATH="$HOME/.dotnet/tools:$PATH"' >> ~/.bashrc
source ~/.bashrc

安装后使用 q 命令：

q --help

快速开始

# 添加别名（自动识别类型）
q add soft ~/Software           # 路径别名 (Linux)
q add soft D:/Software          # 路径别名 (Windows)
q add gh https://github.com     # Web 别名
q add c claude                  # CLI 工具别名

# 使用别名
q soft                          # 打开文件夹
q gh                            # 打开 URL
q c --help                      # 执行 claude --help

命令参考

别名管理

打开方式

文本模板

其他命令

快捷别名

单字符快捷命令，安装后可直接使用：

安装快捷命令：q setup

跨平台配置

数据存储

Windows:

• 数据库：%APPDATA%/Quick/qcli.db3 (SQLite)
• 日志：%APPDATA%/Quick/logs/

Linux (XDG 标准):

• 数据库：~/.local/share/qcli/qcli.db3 (SQLite)
• 日志：~/.local/share/qcli/logs/

系统快捷命令

Windows:

• 位置：%USERPROFILE%/.dotnet/tools/*.cmd
• 示例：qt.cmd, qa.cmd

Linux:

• 位置：~/.local/bin/q*
• 示例：qt, qa
• 需要将 ~/.local/bin 添加到 PATH

自动类型识别

q add 命令会自动识别目标类型：

使用示例

路径别名

q add work ~/Work           # 添加路径别名 (Linux)
q work                       # 打开文件夹
q cd work                    # 同上（明确指定类型）

Web 别名

q add gh https://github.com  # 添加 Web 别名
q gh                         # 打开 URL
q web gh                     # 同上

CLI 工具桥接

q add c claude               # 添加 CLI 别名
q c --help                   # 执行 claude --help
q c chat                     # 执行 claude chat

文本模板

q t my@email.com mail        # 添加文本模板
q t mail                     # 复制到剪贴板

搜索别名

q search work                # 搜索包含 "work" 的别名
q s soft                     # 简写形式

开发

构建

Windows:

dotnet build src/Quick/Quick.csproj -c Release

Linux:

dotnet build src/Quick/Quick.csproj -c Release -r linux-x64

运行测试

dotnet test src/Quick.Tests/Quick.Tests.csproj

AOT 发布

Windows AOT:

dotnet publish src/Quick/Quick.csproj -c Release -r win-x64 --self-contained -o ./publish/win-x64

Linux AOT:

dotnet publish src/Quick/Quick.csproj -c Release -r linux-x64 --self-contained -o ./publish/linux-x64

打包

dotnet pack -c Release

安装本地版本

dotnet tool install -g --add-source ./src/Quick/nupkg qcli

平台特定功能

更新日志

v2.3.2

• 新增跨平台支持（Linux）
• 添加 IPlatformService 抽象层
• 支持 XDG 标准路径（Linux）
• 使用 xdg-open 替代 explorer.exe（Linux）

v2.3.1

• 修复 Windows CMD 中文编码问题（添加 chcp 65001）
• 新增系统快捷命令安装/卸载（q setup / q del setup）
• 快捷别名支持（qt, qa, qd, ql, qs, qe, qc）

v2.3.0

• 从 LiteDB 迁移到 SQLite（AOT 兼容）
• 移除 Serilog，使用内置日志
• 添加 Source Generated JSON

v2.2.2

• 新增 q edit 命令更新别名
• 新增 q search 命令搜索别名
• 新增 q --version 显示版本
• 优化代码结构，提取 CommandExecutor
• 修复异步调用模式
• 改进测试隔离，避免数据库锁定

v2.2.0

• 使用 LiteDB 替代 JSON 存储
• 统一 q add 命令自动识别类型
• 新增文本模板功能
• 新增 CLI 工具桥接
• 新增 q clean 清理无效配置

许可证

MIT License