# 工具创意库 · tool.xpcool.com

> 本文档是工具箱的「创意清单」与实现进度台账。
> 所有想法均遵循项目原则：**纯前端、无后端、数据不出浏览器**；
> 必须联网的数据类工具统一走「在线服务」分类，由后端接口提供（契约见 `docs/api-contract.md`）。

## 一、现状概览

| 分类 | 数量 | 说明 | 状态 |
| --- | --- | --- | --- |
| 工作效率（work） | 18 | 开发编程、办公文本与文件处理 | ✅ |
| 开发进阶（dev） | 14 | 格式化、对比、转换与代码工具 | ✅ |
| 创意设计（design） | 3 | 渐变、占位图与字符画 | 🚧 补全中 |
| 生活助手（life） | 13 | 日常计算、查询与决策 | ✅ |
| 健康生活（health） | 0 | 睡眠、饮食与身体指标计算 | ⬜ 待实现 |
| 学习办公（study） | 0 | 拼音标注、记忆卡片与文档模板 | ⬜ 待实现 |
| 旅行出行（travel） | 0 | 出行清单、时差与距离计算 | ⬜ 待实现 |
| 趣味娱乐（fun） | 1 | 摩斯电码等小玩具 | 🚧 补全中 |
| 在线服务（online） | 6 | 依赖后端接口，后端接入中 | 🚧 后端预留 |

合计 **9 个分类 55 个工具**（在线服务 6 个为后端预留骨架）。

## 二、已实现清单（✅）

### 开发进阶 · 编程工具（11 个，2026-08-24 落地）
| 工具 | 说明 | 难度 |
| --- | --- | --- |
| 正则可视化 ✅ | 正则解析为结构树（分组/量词/断言/字符类）+ 匹配测试 | ★★★ |
| Markdown 表格 ✅ | 粘贴分隔文本 → Markdown / HTML 表格 | ★ |
| API 请求构造器 ✅ | 可视化拼接请求，生成 fetch 与 curl 代码 | ★ |
| .gitignore 生成器 ✅ | 按技术栈勾选生成忽略规则 | ★ |
| 代码转图片 ✅ | 代码渲染成卡片图片，语法高亮 + 深浅主题 | ★★ |
| 颜色命名器 ✅ | 内置 148 色表，色值匹配最近颜色名 | ★ |
| 缩进转换器 ✅ | 空格 / Tab 缩进互转 | ★ |
| 代码统计 ✅ | 总行 / 代码行 / 注释行 / 空白行，30+ 语言注释规则 | ★★ |
| Hello World 大全 ✅ | 33 种语言入门代码速查 | ★ |
| JSON 对比 ✅ | 逐键 diff（新增 / 删除 / 修改），路径级展示 | ★★ |
| 环境变量解析 ✅ | .env ↔ JSON / 键值对双向转换 | ★ |

### 在线服务 · 后端预留（6 个，🚧 骨架已就绪，待后端按契约接入）
| 工具 | 接口 | 状态 |
| --- | --- | --- |
| 汇率换算 🚧 | `GET /api/tools/exchange-rate` | 页面就绪，等后端 |
| 快递查询 🚧 | `GET /api/tools/express-query` | 页面就绪，等后端 |
| 手机号归属地 🚧 | `GET /api/tools/phone-locate` | 页面就绪，等后端 |
| IP 信息查询 🚧 | `GET /api/tools/ip-info` | 页面就绪，等后端 |
| 网络测试 🚧 | `POST /api/tools/network-test` | HTTP 检测已可用，Ping/TCP/DNS 等后端 |
| 网络测速 🚧 | `GET/POST /api/tools/speedtest/*` | 下载/延迟可用（公网源），上传等后端 |

> 前端通过 `src/api/client.ts` 统一请求，`.env` 配置 `VITE_API_BASE` 即可接入；
> 接口字段契约见 `docs/api-contract.md`。

## 三、待实现批次（⬜）

### 批次 A：健康生活（health，12 个）
| 工具 | 说明 | 难度 |
| --- | --- | --- |
| 睡眠周期计算 | 按入睡时间推荐起床时刻（90 分钟周期） | ★ |
| 喝水提醒 | 按体重算每日饮水量 + 分布时间 | ★ |
| 体脂率估算 | 性别/围度公式估算体脂率 | ★ |
| 卡路里估算 | 常见食物热量查询（内置表） | ★ |
| 预产期计算 | 末次月经推算预产期与孕周 | ★ |
| 房贷提前还款 | 提前还贷金额与节省利息测算 | ★★ |
| 生理周期记录 | 周期推算（本地存储） | ★★ |
| 运动配速计算 | 距离/时间 → 配速换算 | ★ |
| BMI 对比表 | 各标准 BMI 分级对照（已有 BMI，可增强） | ★ |
| 热量平衡计算 | 基础代谢 + 活动系数 → 每日所需热量 | ★★ |
| 理想体重 | 多种理想体重公式对照 | ★ |
| 步数时长换算 | 步数 → 距离 / 消耗热量 | ★ |

### 批次 B：学习办公（study，10 个）
| 工具 | 说明 | 难度 |
| --- | --- | --- |
| 汉字拼音标注 | 基于 pinyin-pro 给整段中文标拼音 | ★ |
| 单词记忆卡 | 内置常用词表，简易间隔重复 | ★★ |
| 随机口算题 | 四则运算题批量生成（可打印） | ★ |
| 乘法表练习 | 9×9 乘法表随机练习计时 | ★ |
| 请假条生成器 | 选模板填信息生成请假条文本 | ★ |
| 会议纪要模板 | 常用会议纪要结构模板 | ★ |
| 邮件模板 | 商务邮件常用句型模板 | ★ |
| 公文格式助手 | 标题/正文/落款常用格式速查 | ★ |
| 学习计划表 | 按天生成复习/学习计划 | ★ |
| 名言摘抄本 | 分类名言收藏（本地存储） | ★ |

### 批次 C：旅行出行（travel，6 个）
| 工具 | 说明 | 难度 |
| --- | --- | --- |
| 行李清单 | 出行场景勾选清单（可勾选保存） | ★ |
| 机票折扣速算 | 全价/折扣率 → 折后价 | ★ |
| 签证材料清单 | 常见目的地材料清单 | ★ |
| 地图距离估算 | 经纬度两点距离（Haversine） | ★ |
| 时差换算 | 两地时差与会议时间推荐 | ★ |
| 小费计算器 | 金额 + 比例 → 小费与总额 | ★ |

### 批次 D：创意设计补全（design，9 个）
| 工具 | 说明 | 难度 |
| --- | --- | --- |
| 阴影生成器 | box-shadow 可视化调参 + 预设 | ★ |
| 圆角生成器 | border-radius 四角独立调节 | ★ |
| 调色板生成 | 基于主色的互补/三角/近似色板 | ★ |
| 颜色对比度检查 | WCAG 对比度评级 | ★ |
| 像素画编辑器 | 网格点画，导出 PNG | ★★ |
| 纹理生成器 | 条纹/网格/点阵/噪点 CSS 背景 | ★★ |
| 文字效果生成 | 立体字/渐变字/描边字 CSS 输出 | ★★ |
| Emoji 放大镜 | 超大 emoji 预览 + 关键词搜索 | ★ |
| 图片九宫格切图 | 一张图切成 3×3 网格导出 | ★★ |

### 批次 E：趣味娱乐补全（fun，14 个）
| 工具 | 说明 | 难度 |
| --- | --- | --- |
| 加密暗号机 | 凯撒/维吉尼亚/栅栏密码编解码 | ★ |
| Emoji 密文 | 文本 → emoji 象形编码 | ★ |
| 藏头诗生成 | 内置意象词库拼接生成 | ★★ |
| 绕口令生成器 | 内置素材库随机组合 | ★ |
| 塔罗牌占卜 | 本地随机抽牌 + 牌意说明 | ★ |
| 星座运势 | 按生日算星座 + 本地随机运势 | ★ |
| 名字评分 | 按笔画/谐音/字义趣味评分 | ★★ |
| 电子木鱼 | 点击敲木鱼，功德 +1（Web Audio） | ★ |
| 猜成语小游戏 | 内置成语库，猜中计数 | ★★ |
| 音效合成器 | Web Audio 合成提示音并导出 | ★★ |
| 节日倒计时 | 距离下个节日天数（内置列表） | ★ |
| 情侣默契问答 | 内置题目库双人问答计分 | ★★ |
| 名言警句生成 | 分类名言随机 + 作者标注 | ★ |
| 骰子塔 | 1-6 骰子多枚投掷动画 | ★ |

## 四、新增工具三步走

1. 新建 `src/views/<tool-name>/<ToolName>View.vue`，复用公共组件
   （`CopyButton` / `DownloadButton` / `ErrorAlert` / `HistoryPanel` / `UploadDrop`）
2. 在 `src/router/tools.ts` 的 `tools` 数组追加一条配置
3. 新分类在 `toolCategories` 追加 `{ key, label, desc }`，导航与首页自动渲染

> 详细约定见 `AGENTS.md`；后端接口契约见 `docs/api-contract.md`。