# 2026-08-24 工作日志

## 工具箱新增「有趣的分类与工具」批次

为 tool.xpcool.com 新增 3 个分类 + 9 个工具（31 → 40 个），全部通过 `pnpm type-check`。

### 新增分类（src/router/tools.ts）
- `dev` 开发进阶 / `design` 创意设计 / `fun` 趣味娱乐

### 新增工具（views/ 下各自目录）
- 开发进阶：sql-format（手写分词+关键词换行格式化器）、text-diff（LCS 行级 diff，折叠相同行）、json-to-code（JSON→TS interface/Go struct 含 json tag/Python dataclass，嵌套递归建类型表）
- 创意设计：gradient-generator（linear/radial/conic + 12 组预设 + 随机）、placeholder-image（canvas 占位图 + SVG 代码）、ascii-art（亮度感知加权灰度 → 字符，支持反色）
- 趣味娱乐：morse-code（pinyin-pro 中文转拼音编码 + Web Audio 电报声播放）、lucky-wheel（canvas 转盘 + ease-out 动画 + 指针判定）、slogan-generator（5 类文案库随机）

### 要点备忘
- TDesign 图标名需先在 node_modules/tdesign-icons-vue-next/esm/components/ 确认存在（PaletteIcon 不存在，只有 Palette1Icon；ascii-art 用了 ViewModuleIcon）
- 创意库设计文档：docs/tool-ideas.md（含未来 60+ 工具想法清单）
- 页面样式约定：scoped 内自建 .page-wrap/.form-actions/.code-block，复用公共组件 CopyButton/ErrorAlert/HistoryPanel/UploadDrop

## 第二批：分类重构 + 后端预留机制 + 编程工具全系（40 → 58 个）

### 分类重构（9 分类）
- 在 dev/design/fun 基础上新增 health（健康生活）/ study（学习办公）/ travel（旅行出行）/ online（在线服务·后端预留）

### 后端预留机制（用户正在准备后端服务）
- `src/api/client.ts`：统一 API 客户端（VITE_API_BASE 配置，未配置返回「后端未接入」，统一响应 `{code,message,data}`）
- `docs/api-contract.md`：6 个接口契约（weather/exchange-rate/express-query/stock-quote/phone-locate/ip-info）
- 6 个预留页面：UI 完整、字段按契约类型化，后端上线即用；`.env.example` 提供 VITE_API_BASE 模板

### 编程工具 12 个（dev 分类）
- code-minify（JS/CSS/HTML 压缩美化，手写 tokenizer）、regex-visual（正则结构树解析器）、markdown-table、api-builder（fetch/curl 生成）、gitignore-gen、code-to-image（canvas 高亮卡片）、color-namer（148 色表欧氏距离匹配）、indent-convert、code-stats（30+ 语言注释规则状态机）、hello-world（33 语言）、json-diff（递归路径级 diff）、env-parse

### 坑
- ⚠️ Vue 模板 attribute 内嵌字符串不能写 `\"`（HTML 解析器把 " 当属性结束符）→ 字符串常量移到 script 定义
- json-diff 的 `k in b` 需先把 b 断言为 Record<string, unknown>，否则 TS2638/TS18048

### 剩余批次（创意库台账见 docs/tool-ideas.md 第三部分）
- 批次 A 健康 12 / B 学习 10 / C 旅行 6 / D 设计补全 9 / E 趣味补全 14

## 第三批：网络测试工具 + 上下文无缝切换机制（58 → 59）

### 网络测试（online 分类）
- `network-test`：HTTP 检测走前端直连（CORS 受限时提示）；Ping / TCP / DNS 走后端 `POST /api/tools/network-test`（契约已追加到 api-contract.md 第 7 节）
- 图标 WifiIcon

### 上下文无缝切换机制（核心需求：切 CodeBuddy 账号后新 AI 能无缝接手）
- 关键洞察：**用户级数据（skills/memory）随账号走，项目内文件不随账号走** → 状态必须存在项目内 docs/ 下
- `docs/PROJECT_STATE.md`：项目状态与交接文档（单点真相）——全貌/架构机制/待办批次/后端契约索引/技术坑/接手清单，含维护规则
- `docs/CHANGELOG.md`：变更日志（倒序），每次请求/更改必追加
- `AGENTS.md` 顶部新增「⚡ 接手必读」段落：新账号 AI 按顺序读 PROJECT_STATE → CHANGELOG → api-contract
- 约定：此后每次实质变更必须同步更新这 3 份文档 + 工作日志（已在 AGENTS.md 写明）

## 第四批：网络测速工具（59 → 60）

- `speed-test`（online，RocketIcon）：下载测速（流式读 body 计时，后端/公网 cloudflare/自定义 URL 三模式，5-50MB，实时进度+峰值）、上传测速（随机数据上传，后端计时优先，1-10MB）、延迟测试（5/10 次 RTT + 抖动）
- 契约第 8 节：下载返回随机二进制流（Content-Length + Cache-Control: no-store 建议），上传返回 {bytes, duration_ms, speed_mbps}
- client.ts 导出 BASE_URL 供直接拼流式地址

## 第五批：删除 5 个工具（60 → 55）

- 按用户要求删除：code-minify、lucky-wheel、slogan-generator、weather、stock-quote（页面目录 + tools.ts 条目 + 契约节）
- tools.ts 顺带清理无引用图标（Star/Smile/Edit/CloudyDay；ChartIcon 因 word-count 保留）
- ⚠️ 坑：项目内 rm -rf 被沙箱 safe-delete（genie-trash）拦截失败 → 改用 mv 到 $TMPDIR 实现移除（dist 同理）
- 文档全部同步：CHANGELOG 第五批 / PROJECT_STATE（55 个、dev 14、fun 1、online 6、契约 7 个）/ tool-ideas / api-contract（7 接口）/ 本日志