Dev Tools - 开发者工具箱

功能概览

快速开始

环境要求

安装运行

# 克隆项目
git clone https://github.com/yourname/dev-tools.git
cd dev-tools
# 配置阿里云机器翻译凭证
export ALIBABA_CLOUD_ACCESS_KEY_ID='your-access-key-id'
export ALIBABA_CLOUD_ACCESS_KEY_SECRET='your-access-key-secret'
# 运行开发服务器
cargo run
# 或构建发布版本
cargo build --release
./target/release/dev-tools

Docker 部署

方式一:Docker Compose (推荐)

# 配置阿里云机器翻译凭证
export ALIBABA_CLOUD_ACCESS_KEY_ID='your-access-key-id'
export ALIBABA_CLOUD_ACCESS_KEY_SECRET='your-access-key-secret'
# 构建并启动
docker compose up -d
# 查看日志
docker compose logs -f
# 停止服务
docker compose down

方式二:Docker 直接构建

# 构建镜像
docker build -t dev-tools:latest .
# 运行容器
docker run -d \
 --name dev-tools \
 -p 3000:3000 \
 -e RUST_LOG=info \
 -e TZ=Asia/Shanghai \
 -e ALIBABA_CLOUD_ACCESS_KEY_ID='your-access-key-id' \
 -e ALIBABA_CLOUD_ACCESS_KEY_SECRET='your-access-key-secret' \
 --restart unless-stopped \
 dev-tools:latest

方式三:使用预构建镜像

# 拉取镜像 (如果已发布到 Docker Hub)
docker pull yourname/dev-tools:latest
# 运行容器
docker run -d \
 --name dev-tools \
 -p 3000:3000 \
 -e ALIBABA_CLOUD_ACCESS_KEY_ID='your-access-key-id' \
 -e ALIBABA_CLOUD_ACCESS_KEY_SECRET='your-access-key-secret' \
 --restart unless-stopped \
 yourname/dev-tools:latest

Docker 配置说明

Docker 常用命令

# 查看容器状态
docker ps
# 查看实时日志
docker logs -f dev-tools
# 进入容器
docker exec -it dev-tools sh
# 重启容器
docker restart dev-tools
# 停止并删除容器
docker rm -f dev-tools
# 删除镜像
docker rmi dev-tools:latest

工具详解

1. 时间转换

2. JSON 格式化

3. Python Dict 转 JSON

# 输入
{'name': 'test', 'active': True, 'data': None, 'items': (1, 2, 3)}
# 输出
{
 "name": "test",
 "active": true,
 "data": null,
 "items": [1, 2, 3]
}

4. 翻译工具

5. Markdown 渲染

6. HTTP 请求

7. 订阅转换

API 端点

时间转换 /api/time

JSON 工具 /api/json

翻译 /api/translate

Markdown /api/markdown

HTTP 客户端 /api/http

订阅转换 /api/sub

{
 "subscription_url": "https://example.com/sub?token=abc",
 "template": "1",
 "file": "1",
 "ua": "clashmeta",
 "emoji": "1",
 "eps": "ssr"
}

技术栈

项目结构

dev-tools/
├── src/
│ ├── main.rs # 入口文件,路由注册
│ ├── tools.rs # 模块导出
│ └── tools/
│ ├── time_convert.rs # 时间转换模块
│ ├── json_tools.rs # JSON 工具模块
│ ├── translate.rs # 翻译模块
│ ├── markdown.rs # Markdown 渲染模块
│ ├── http_client.rs # HTTP 客户端模块
│ └── sub_convert/ # sing-box 订阅转换模块
├── static/
│ └── index.html # 前端页面
├── Cargo.toml
└── README.md

测试

# 运行所有测试
cargo test
# 运行特定模块测试
cargo test tools::http_client

开发

# 开发模式运行 (带热重载需配合 cargo-watch)
cargo run
# 检查代码
cargo clippy
# 格式化
cargo fmt

License