@xx-in/tools 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +88 -0
- package/dist/cli.js +2668 -0
- package/package.json +40 -0
package/README.md
ADDED
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# tools
|
|
2
|
+
|
|
3
|
+
终端命令行工具，跨平台统一工具。
|
|
4
|
+
|
|
5
|
+
## 安装为全局命令
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
npm install -g @xx-in/tools
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
安装完成后，终端中可使用 `xx <命令>` 运行各子功能。更新到最新版：
|
|
12
|
+
|
|
13
|
+
```sh
|
|
14
|
+
xx upgrade
|
|
15
|
+
# 或
|
|
16
|
+
npm install -g @xx-in/tools@latest
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## 功能列表
|
|
20
|
+
|
|
21
|
+
安装完成后，你可以在终端中通过 `xx <命令>` 运行以下功能：
|
|
22
|
+
|
|
23
|
+
### 1. 文件与目录管理
|
|
24
|
+
|
|
25
|
+
- **`create <path>`**：递归创建文件或目录。
|
|
26
|
+
- 若路径以 `/` 或 `\` 结尾，则直接创建多级目录。
|
|
27
|
+
- 若路径不以斜杠结尾，则将其视作文件，自动确保上级目录被递归创建后，再行建立空文件。
|
|
28
|
+
- **`remove <path>`**：递归删除文件或目录。
|
|
29
|
+
- 删除前会智能判断目标类型，并将内容删除到回收站。
|
|
30
|
+
- **`copy <source> <target>`**：复制文件或目录。
|
|
31
|
+
- 支持递归复制目录。若目标路径是一个已存在的文件夹，则会自动将源文件或源目录复制进该文件夹中。
|
|
32
|
+
- **`move <source> <target>`**：移动或重命名文件及目录。
|
|
33
|
+
- 智能检测并保证目标父目录的递归创建。若跨磁盘分区移动，程序会自动降级采用“复制+原文件删除”策略，确保正常完成。
|
|
34
|
+
- **`list [path]`**：目录内容列出工具。
|
|
35
|
+
- 按字典顺序对项目进行升序排序，且文件夹优先排在前面。
|
|
36
|
+
- 完整列出目录中的所有项目，包括以 `.` 开头的隐藏文件和隐藏文件夹。
|
|
37
|
+
- **`open [path]`**：文件管理器目录打开工具。
|
|
38
|
+
- 在系统内置文件管理器中打开指定目录。若未提供参数，则默认打开当前的工作目录。
|
|
39
|
+
|
|
40
|
+
### 2. Linux 桌面应用管理
|
|
41
|
+
|
|
42
|
+
- **`application`**：Linux 桌面应用辅助管理工具集，包含以下嵌套子命令 [3]：
|
|
43
|
+
- **`shortcut <path>`**：为本地 AppImage、普通可执行二进制文件、或 Flatpak 应用 ID（例如 `org.gimp.GIMP`）生成标准的 Linux `.desktop` 快捷文件并放置到系统的应用选单中 [3]。
|
|
44
|
+
- **`install <path>`**：安装软件包。支持本地 `.deb` 安装包，或解压 `.tar.gz` 绿色软件（自动释放到 `~/GreenApp/` [3]，并自适应扫描根目录下的执行文件创建图标）。
|
|
45
|
+
- **`remove <package>`**：卸载已安装的软件包。支持传入包名或本地 `.deb` 路径（将自动分析提取其 Metadata 进行安全卸载）。
|
|
46
|
+
|
|
47
|
+
### 3. 压缩与解压
|
|
48
|
+
|
|
49
|
+
- **`zip [directory]`**：递归复制目录并根据忽略规则过滤并打包为 ZIP。
|
|
50
|
+
- 自动检索目标目录或当前目录下的 `.cpzipignore` 忽略配置文件。若未配置，则直接应用内置默认过滤规则（自动忽略 `node_modules`、`.git`、`.DS_Store`、`dist`、`*.zip` 等）。
|
|
51
|
+
- 复制过滤后的纯净项目至临时目录，打包为与目录同名的压缩包并彻底清理临时工作区。
|
|
52
|
+
- **`unzip [zipfile]`**：解压 ZIP 压缩包。
|
|
53
|
+
- 支持交互式路径输入，或直接传入 ZIP 文件。
|
|
54
|
+
- 可通过 `-d` 标志自定义解压的目标文件夹。若未指定，则默认解压至当前目录下与压缩包同名的文件夹内。
|
|
55
|
+
|
|
56
|
+
### 4. 代码格式化
|
|
57
|
+
|
|
58
|
+
- **`format [path]`**：代码格式化工具。
|
|
59
|
+
- 调用并集成了 Prettier (v3) 工具链。支持传入单个文件或目录（自动递归扫描）。
|
|
60
|
+
- 自动定位并读取本地方案中配置的 `.prettierrc`，并对代码格式进行重写修复。
|
|
61
|
+
|
|
62
|
+
### 5. 系统与网络探测
|
|
63
|
+
|
|
64
|
+
- **`ip`**：本地活跃网卡及网关探测。
|
|
65
|
+
- 过滤回环地址与虚拟网卡，探测当前正在使用的物理网卡。
|
|
66
|
+
- 展现网卡名称、本机 IP、子网掩码、MAC 地址、IP 协议版本，并根据当前系统智能匹配探测路由出口网关。
|
|
67
|
+
|
|
68
|
+
### 6. 园区镜像打包下载
|
|
69
|
+
|
|
70
|
+
- **`park [image]`**：园区离线打包镜像下载工具。
|
|
71
|
+
- 支持提交 Docker 镜像至远程打包服务器进行触发任务。
|
|
72
|
+
- 自动解析服务器返回的跳转头部并拉取镜像结果，终端支持渲染百分比与下载进度条。
|
|
73
|
+
- 支持 `-g` 配置并持久化本地的全局默认下载目录（保存于 `.park_config.json` 中）。
|
|
74
|
+
|
|
75
|
+
### 7. 多语言翻译
|
|
76
|
+
|
|
77
|
+
- **`translate [text]`**：终端翻译工具。
|
|
78
|
+
- 不带参数运行时，会自动进入终端交互（REPL）模式，输入 `exit` 可退出。
|
|
79
|
+
- 支持智能中英双向互译：若内容包含英文字母，默认翻译为中文；否则翻译为英文。支持通过 `-t` 手动指定强制的目标语种。
|
|
80
|
+
|
|
81
|
+
### 8. 自动补全与更新
|
|
82
|
+
|
|
83
|
+
- **`completion [shell]`**：自动部署或生成 Shell 命令提示脚本。
|
|
84
|
+
- 执行 `xx completion`，本工具会自动检测你当前的系统平台与正在运行的 Shell 容器，全量刷新补全定义（支持 A-Z 全称子命令推荐与各级命令的多层次 Tab 补全提示）。
|
|
85
|
+
- **`upgrade`**：检查并更新本工具至最新版本。
|
|
86
|
+
- 自动重装并覆盖当前全局可执行文件，流式展示重装过程，并在重装成功后**强制原地刷新覆盖**本机的 Shell 自动补全脚本。
|
|
87
|
+
- **`help [command]`**：内置命令帮助。
|
|
88
|
+
- 显示指定命令的使用文档与参数说明。
|