UIED Tools - 免費在線工具集合
最近更新:修改了文檔說明,優化了項目結構介紹
這是設計師轉開發的第一個開源項目,bug和代碼規范可能有些欠缺。
這是一個功能豐富的免費在線工具集合網站,集成了多種實用工具,包括 AI 工具、設計工具、開發工具等。該項目旨在為設計師、開發者和普通用戶提供一站式工具解決方案,提高工作效率。
在線站點:UIED免費在線工具集?
開源地址
https://github.com/Tomccc520/UIED-tools
UIED-Tools: UIED Tools在線免費工具箱,純AI二次開發。
更新日志
更新日志2025.5.11
項目亮點
- 豐富多樣的工具:提供超過80種常用工具,覆蓋設計、開發、文本處理、圖片處理等多個領域,持續更新中。
- 簡潔易用的界面:采用直觀的UI設計,讓用戶快速找到并使用所需工具
- 完全免費:所有工具完全免費使用,無需注冊和付費
- 持續更新:定期添加新工具,不斷優化已有功能
- 開源共享:項目代碼完全開源,歡迎社區貢獻和改進
- 中文優化:專為中文用戶設計,提供本地化的使用體驗
UIED Tools 基于 Vue3、TypeScript 和 Element Plus 開發,支持響應式布局,能夠在桌面端和移動端提供良好的使用體驗。
快速開始
環境要求
- Node.js 版本: >= 16.0.0
- npm 版本: >= 8.0.0
安裝步驟
方法一:從源碼安裝(推薦開發者使用)
- 克隆倉庫到本地
# 從Gitee克隆
git clone https://gitee.com/tomdac/uied-tools.git# 或從GitHub克隆
git clone https://github.com/Tomccc520/UIED-tools.git# 進入項目目錄
cd uied-tools
- 安裝依賴
# 使用npm安裝(推薦)
npm install# 或使用yarn
yarn install# 或使用pnpm
pnpm install
- 啟動開發服務器
# 開發模式啟動
npm run dev# 指定端口啟動
npm run dev -- --port 3000
- 構建生產版本
# 標準構建
npm run build# 包含SEO優化的構建(推薦生產環境使用)
npm run build:pro# 預覽構建結果
npm run preview
方法二:使用Docker部署(推薦運維人員使用)
# 拉取鏡像
docker pull docker0796/tools-web:latest# 運行容器
docker run -d --name tools-web --restart unless-stopped -p 8080:80 docker0796/tools-web:latest# 訪問服務
# 瀏覽器打開 http://localhost:8080
項目結構說明
uied-tools/
├── src/ # 源代碼目錄
│ ├── components/ # 組件目錄
│ │ ├── Common/ # 公共組件
│ │ │ └── ToolsRecommend.vue # 工具推薦組件
│ │ ├── Home/ # 首頁相關組件
│ │ ├── Layout/ # 布局組件
│ │ │ ├── Left/ # 左側菜單
│ │ │ └── Right/ # 右側推薦欄
│ │ └── Tools/ # 工具組件目錄
│ │ ├── AI/ # AI相關工具
│ │ ├── Avatar/ # 頭像相關工具
│ │ ├── Copywriting/ # 文案相關工具
│ │ ├── Design/ # 設計相關工具
│ │ ├── Dev/ # 開發相關工具
│ │ ├── tools.ts # 工具配置文件
│ │ └── ToolIcon.vue # 工具圖標組件
│ ├── router/ # 路由配置
│ │ └── router.ts # 主路由文件
│ ├── store/ # 狀態管理
│ │ └── modules/ # 狀態模塊
│ ├── assets/ # 靜態資源
│ │ ├── icons/ # SVG圖標
│ │ └── styles/ # 全局樣式
│ ├── utils/ # 工具函數
│ └── App.vue # 根組件
├── public/ # 公共資源目錄
├── docs/ # 文檔目錄
├── scripts/ # 腳本目錄
├── dist/ # 構建輸出目錄
├── .env.development # 開發環境配置
├── .env.production # 生產環境配置
├── vite.config.ts # Vite配置
├── tailwind.config.js # Tailwind CSS配置
├── tsconfig.json # TypeScript配置
├── package.json # 項目依賴配置
└── README.md # 項目說明文檔
開發指南
添加新工具
添加新工具需要完成以下四個步驟:
- 創建工具組件
在?src/components/Tools
?對應分類目錄下創建新的組件文件。例如要創建一個新的AI工具,可以在?src/components/Tools/AI/
?目錄下創建:
<!-- NewAITool.vue -->
<template><div class="p-6 bg-white rounded-lg shadow-sm"><h2 class="text-xl font-bold mb-4">新AI工具</h2><!-- 工具主體內容 --><div class="mb-4"><el-input v-model="inputText" placeholder="請輸入內容" /></div><!-- 操作按鈕 --><div class="flex justify-between"><el-button type="primary" @click="processData">處理</el-button><el-button @click="resetForm">重置</el-button></div><!-- 結果展示區域 --><div v-if="result" class="mt-4 p-4 bg-gray-50 rounded"><p>{{ result }}</p></div><!-- 底部推薦工具 --><ToolsRecommend :currentPath="route.path" /></div>
</template><script setup lang="ts">
import { ref } from 'vue'
import { useRoute } from 'vue-router'
import ToolsRecommend from '@/components/Common/ToolsRecommend.vue'const route = useRoute()
const inputText = ref('')
const result = ref('')// 處理數據函數
const processData = () => {// 實現工具核心邏輯result.value = `處理結果: ${inputText.value}`
}// 重置表單函數
const resetForm = () => {inputText.value = ''result.value = ''
}
</script>
- 添加路由配置
在?src/router/router.ts
?文件中添加新工具的路由配置:
// router.ts
{path: '/tools/ai/new-tool',component: () => import('@/components/Tools/AI/NewAITool.vue'),name: 'newAITool',meta: {title: "新AI工具",keywords: 'AI工具,人工智能,新工具',description: '這是一個強大的AI新工具,可以幫助用戶快速處理數據',}
}
- 注冊工具信息
在?src/components/Tools/tools.ts
?中的合適位置添加工具信息:
// tools.ts
// 在AI工具分類中添加
{id: 123,title: "新AI工具",logo: { type: 'svg', name: 'newAITool' }, // 使用SVG圖標desc: "強大的AI工具,可快速處理數據",url: "/tools/ai/new-tool",cateId: 1,cate: 'AI工具',tags: ['新品'] // 可選:添加標簽
}
- 添加SVG圖標(可選)
如果使用SVG圖標,將圖標文件放入?src/assets/icons/
?目錄下,命名為?newAITool.svg
。
完成以上步驟后,刷新頁面即可看到新添加的工具。
注意事項
1. 環境配置
- 開發環境:使用?
.env.development
?配置文件NODE_ENV=development VITE_API_BASE_URL=http://localhost:8080/api
- 生產環境:使用?
.env.production
?配置文件NODE_ENV=production VITE_API_BASE_URL=https://api.example.com
- 本地配置:可創建?
.env.local
?進行本地覆蓋(不會提交到代碼庫)
2. 代碼規范
- TypeScript:所有新代碼必須使用TypeScript編寫
- 開啟嚴格模式:
"strict": true
- 使用類型標注:
const name: string = 'value'
- 開啟嚴格模式:
- Vue 規范:
- 使用 Vue 3 Composition API
- 使用?
<script setup>
?語法糖 - 保持組件單一職責
- 樣式規范:
- 使用 Tailwind CSS 實用類優先
- 自定義樣式使用 scoped CSS
- 遵循 Element Plus 的設計規范
3. 性能優化準則
- 路由懶加載:所有頁面組件使用動態導入
{path: '/tools/example',component: () => import('@/components/Tools/Example.vue') // 懶加載 }
- 組件按需導入:使用 Element Plus 的按需導入
import { ElButton, ElInput } from 'element-plus'
- 資源優化:
- 圖片使用WebP格式
- SVG圖標使用單色線性風格
- 大型資源使用CDN加載
4. Git提交規范
- 提交信息格式:
<類型>: <描述>
- 常用類型:
feat
:新功能fix
:bug修復docs
:文檔更新style
:代碼格式調整refactor
:代碼重構perf
:性能優化test
:測試相關chore
:構建過程或輔助工具變動
常見問題與解決方案
1. 依賴相關問題
安裝依賴失敗
# 方法1:清除npm緩存后重試
npm cache clean --force
npm install# 方法2:使用鏡像源
npm config set registry https://registry.npmmirror.com
npm install# 方法3:嘗試使用其他包管理器
yarn install
# 或
pnpm install
依賴版本沖突
# 更新依賴到兼容版本
npm update# 檢查有問題的依賴
npm ls <package-name># 強制解決沖突
npm install --force
2. 開發環境問題
開發服務器啟動失敗
- 端口占用:修改?
vite.config.ts
?中的端口export default defineConfig({server: {port: 3000 // 修改為其他端口} })
- 模塊解析錯誤:
# 刪除node_modules和lock文件后重新安裝 rm -rf node_modules package-lock.json npm install
- Node.js版本問題:使用 nvm 安裝正確版本
nvm install 16 nvm use 16
熱更新不工作
- 檢查?
vite.config.ts
?中的?server.hmr
?配置 - 確認系統文件監聽限制(Linux系統)
- 重啟開發服務器
3. 構建與部署問題
構建失敗
- 語法錯誤:檢查控制臺錯誤信息,修復對應代碼
- 內存不足:增加Node內存限制
# 增加內存限制 export NODE_OPTIONS=--max-old-space-size=4096 npm run build
- 依賴缺失:確認所有依賴正確安裝
npm install --legacy-peer-deps
部署問題
- 靜態資源路徑錯誤:檢查?
vite.config.ts
?中的?base
?配置export default defineConfig({base: '/' // 根據實際部署路徑調整 })
- Docker部署問題:參考前面的Docker部署指南
- SSR渲染問題:查看SSR構建日志,修復服務端渲染錯誤
技術棧詳解
核心技術
技術 | 版本 | 用途 | 文檔鏈接 |
---|---|---|---|
Vue | 3.3.10 | 前端框架 | Vue文檔 |
TypeScript | 5.3.3 | 類型檢查 | TS文檔 |
Vite | 5.0.10 | 構建工具 | Vite文檔 |
Pinia | 2.1.7 | 狀態管理 | Pinia文檔 |
Vue Router | 4.2.5 | 路由管理 | Router文檔 |
UI框架與樣式
技術 | 版本 | 用途 | 文檔鏈接 |
---|---|---|---|
Element Plus | 2.7.0 | UI組件庫 | Element Plus文檔 |
Tailwind CSS | 3.3.5 | 原子CSS框架 | Tailwind文檔 |
PostCSS | 8.4.32 | CSS處理器 | PostCSS文檔 |
工具庫
技術 | 用途 | 文檔鏈接 |
---|---|---|
Axios | HTTP請求 | Axios文檔 |
VueUse | 實用工具集 | VueUse文檔 |
Day.js | 日期處理 | Day.js文檔 |
ECharts | 數據可視化 | ECharts文檔 |
開發工具
技術 | 用途 | 推薦配置 |
---|---|---|
VS Code | 代碼編輯器 | 推薦插件:Volar, ESLint, Prettier |
ESLint | 代碼檢查 | 配置文件:.eslintrc.js |
Prettier | 代碼格式化 | 配置文件:.prettierrc |
Git | 版本控制 | 配合Husky進行提交校驗 |
貢獻指南
歡迎為 UIED Tools 項目做出貢獻!請遵循以下步驟:
貢獻流程
-
Fork 倉庫
- 訪問?GitHub倉庫?或?Gitee倉庫
- 點擊右上角"Fork"按鈕創建個人分支
-
克隆到本地
git clone https://github.com/你的用戶名/UIED-tools.git cd UIED-tools
-
創建功能分支
# 以功能命名分支 git checkout -b feature/新功能名稱 # 或以修復命名分支 git checkout -b fix/問題名稱
-
開發與測試
- 進行代碼修改和開發
- 運行測試確保功能正常
- 遵循代碼規范和樣式指南
-
提交更改
git add . git commit -m "feat: 添加了xxx功能"
-
推送到GitHub
git push origin feature/新功能名稱
-
創建 Pull Request
- 訪問你Fork的倉庫
- 點擊"New Pull Request"按鈕
- 選擇你的功能分支和原倉庫的主分支
- 填寫PR描述,說明更改內容和目的