# tools

**Repository Path**: jiyangcd/tools

## Basic Information

- **Project Name**: tools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-27
- **Last Updated**: 2026-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🛠️ Tools 工具集项目

这是一个综合性的工具箱项目，包含了从项目构建打包、服务器部署、日志清理、反向代理到各类实用小工具的集合。旨在提升日常开发、部署和运维的效率。

## 📂 目录结构与模块说明

项目主要由以下几个核心模块组成：

### 1. `build` (项目构建与打包模块)
提供了一整套基于脚本和 Docker 容器的自动化打包工具。
- **`builders/cordova_builder/`**: 基于 Docker 的 Cordova Android 项目打包环境及脚本，解决本地 Android 编译环境配置繁琐的问题。
- **`builders/electron_builder/`**: 基于 Docker 的 Electron 应用打包环境。
- **`dotnet/`**: 包含 .NET 项目的发布脚本（支持打包为 Zip 或构建 Docker 镜像）。
- **`项目打包脚本/`**: 针对不同项目类型（Android, Docker, .NET, Electron, Vue）的入口构建脚本 (`.ps1`)。
- **`build-base.ps1`**: 构建流程的基础公共脚本。

### 2. `deploy` (项目部署模块)
提供了常见应用形态的自动化部署脚本和配置模板。
- **`docker/`**: 包含 ABP 和 ABP vNext 框架的 Docker Compose 部署配置及脚本 (`.env`, `docker-compose.yml`, `deploy.sh`)。
- **`winservice/`**: 提供将普通应用程序打包并注册为 Windows 服务的脚本，底层基于 [WinSW](https://github.com/winsw/winsw) 实现。

### 3. `dotnet` (.NET 专用工具模块)
包含针对 .NET 生态开发的独立工具。
- **`NuGetBatchTool/`**: 一个用于批量处理 NuGet 包的命令行/图形化工具。支持对指定源的 NuGet 包进行列表查询、隐藏、取消隐藏、删除和批量推送。

### 4. `frp` (内网穿透模块)
集成了 [FRP (Fast Reverse Proxy)](https://github.com/fatedier/frp) 的客户端与服务端配置。
- 包含 `frpc.exe` 以及快速启动脚本 `frpc.ps1` 和 `frps.ps1`，方便快速实现内网穿透和端口映射。

### 5. `logclear` (日志自动清理工具)
一个基于 PowerShell 的 Windows 日志清理工具。
- 自动扫描并删除指定目录下过期的按日期命名的日志文件夹。
- 提供了 `setup_startup.bat` 一键安装为开机自启后台服务，以及 `uninstall.bat` 一键卸载。

### 6. `oss` (对象存储辅助)
- 存放与 OSS (Object Storage Service) 相关的说明文档或临时数据（如 `doc.txt`）。

### 7. `cli` (个人全栈辅助 CLI 工具 - `xdev`)
一个基于 .NET 10 开发的全局命令行工具，用于将高频的“环境配置”、“数据库操作”、“Docker 切换”以及“跨端打包与远程部署”流程自动化。
- 详情请见 [cli/需求.md](./cli/需求.md)

### 8. `projects` (.NET 综合工具解决方案)
包含了 `Tools.sln` 解决方案及具体的业务工具项目。
- **`Tools.OssAgent/`**: 一个基于 ASP.NET Core 的文件下载代理服务。可通过 HTTP 代理下载远程文件，解决跨域下载或特定网络限制下的文件获取问题。
- **`Tools.WinForm/`**: 基于 Windows Forms 的桌面工具集框架，用于后续扩展图形界面相关的本地实用工具。

## 🚀 快速上手

各个模块均是独立解耦的，您可以直接进入对应模块的目录，查看该模块下的 `README.md` 文档获取详细的使用说明。例如：
- 需要使用 NuGet 批量工具：请查看 `dotnet/NuGetBatchTool/README.md`
- 需要设置日志自动清理：请查看 `logclear/README.md`
- 需要配置 Android 打包容器：请查看 `build/builders/cordova_builder/readme.md`

## 🛠️ 环境依赖

大部分脚本和工具基于以下环境，请确保您的系统已安装：
- **Windows 操作系统** (推荐 Windows 10/11 或 Windows Server)
- **PowerShell 7+** (核心脚本依赖 `.ps1`)
- **Docker Desktop** (用于 `build/builders` 和 `deploy/docker` 模块)
- **.NET 6.0/7.0 SDK** (用于编译和运行 `dotnet` 和 `projects` 目录下的项目)