---
id: shared-utils
name: 共享工具函数库
area: shared
status: concept
---

## 概述

跨 app 复用的纯函数工具集，以 packages/utils 形式发布到 workspace 内部。不依赖 React，可在任何环境使用。

## 任务卡

### 💭 搭建工具库骨架
- status: concept
- complexity: S
- files: packages/utils/package.json, packages/utils/src/index.ts
- acceptance: packages/utils 可被 workspace 内任意包通过 @repo/utils 引入，导出类型声明文件

### 💭 格式化工具集
- status: concept
- complexity: S
- files: packages/utils/src/format.ts
- acceptance: 提供日期格式化、数字格式化（货币/百分比）、手机号脱敏等常用函数，每个函数有单元测试

### 💭 本地存储工具
- status: concept
- complexity: S
- files: packages/utils/src/storage.ts
- acceptance: 封装 localStorage/sessionStorage，支持 JSON 序列化和过期时间，TypeScript 泛型推导

### 💭 HTTP 请求工具
- status: concept
- complexity: M
- files: packages/utils/src/request.ts
- acceptance: 基于 fetch 封装，支持请求/响应拦截器、统一错误处理、超时控制，返回类型安全的 Promise