diff --git a/CHANGELOG.md b/CHANGELOG.md
index d80c1bc..41339b1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,19 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [1.0.8] - 2026-01-18
+
+### 重构
+- **前端账单模型统一为 UIBill** - 分析链路与详情弹窗只使用一套 UI 模型（camelCase + amount:number），移除 BillRecord 混用带来的字段/类型转换散落
+  - 分析页、统计服务与各分析组件统一使用 `UIBill[]`
+  - CSV 解析（下载账单内容）直接输出 `UIBill[]`
+
+### 新增
+- **账单详情弹窗抽象组件** - 新增 `BillDetailDrawer`，复用单笔账单的查看/编辑 UI 结构
+
+### 优化
+- **前端检查更干净** - 修复图表容器的派生值捕获告警，并为趋势图增加键盘可访问性，`npm run check` 达到 0 warnings
+
 ## [1.0.7] - 2026-01-16
 
 ### 优化
diff --git a/README.md b/README.md
index 60afa16..00c9e0a 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 一个基于微服务架构的个人账单分析工具，支持微信和支付宝账单的自动解析、智能分类和可视化分析。
 
-![版本](https://img.shields.io/badge/版本-1.0.6-green)
+![版本](https://img.shields.io/badge/版本-1.0.8-green)
 ![架构](https://img.shields.io/badge/架构-微服务-blue)
 ![Go](https://img.shields.io/badge/Go-1.21-00ADD8)
 ![Python](https://img.shields.io/badge/Python-3.12-3776AB)
@@ -10,6 +10,8 @@
 ![MongoDB](https://img.shields.io/badge/MongoDB-8.0-47A248)
 ![Docker](https://img.shields.io/badge/Docker-Compose-2496ED)
 
+变更记录见 [CHANGELOG.md](CHANGELOG.md)。
+
 ## ✨ 功能特性
 
 - 📊 **账单分析** - 自动解析微信/支付宝账单，生成可视化报表
diff --git a/web/README.md b/web/README.md
index 75842c4..3b662ce 100644
--- a/web/README.md
+++ b/web/README.md
@@ -1,38 +1,34 @@
-# sv
+# BillAI Web
 
-Everything you need to build a Svelte project, powered by [`sv`](https://github.com/sveltejs/cli).
+BillAI 的前端 Web 应用，基于 SvelteKit + Tailwind，提供账单分析/复核/管理等界面。
 
-## Creating a project
-
-If you're seeing this, you've probably already done this step. Congrats!
+## 开发
 
 ```sh
-# create a new project in the current directory
-npx sv create
-
-# create a new project in my-app
-npx sv create my-app
+yarn install
+yarn dev
 ```
 
-## Developing
-
-Once you've created a project and installed dependencies with `npm install` (or `pnpm install` or `yarn`), start a development server:
+常用命令：
 
 ```sh
-npm run dev
-
-# or start the server and open the app in a new browser tab
-npm run dev -- --open
+yarn check
+yarn lint
+yarn format
 ```
 
-## Building
-
-To create a production version of your app:
+## 构建
 
 ```sh
-npm run build
+yarn build
+yarn preview
 ```
 
-You can preview the production build with `npm run preview`.
+## API 访问
 
-> To deploy your app, you may need to install an [adapter](https://svelte.dev/docs/kit/adapters) for your target environment.
+- 开发环境下通过 SvelteKit/Vite 代理访问后端（统一使用相对路径，例如 `/api/...`）
+- Docker 部署时由 `docker-compose.yaml` 将前端容器与后端容器联通
+
+## 说明
+
+前端展示层使用统一账单模型 `UIBill`（camelCase 字段 + `amount:number`），分析链路与详情编辑弹窗避免多种账单类型混用。
diff --git a/web/package.json b/web/package.json
index 1c3afa8..4ec79e7 100644
--- a/web/package.json
+++ b/web/package.json
@@ -1,7 +1,7 @@
 {
 	"name": "web",
 	"private": true,
-	"version": "1.0.7",
+	"version": "1.0.8",
 	"type": "module",
 	"scripts": {
 		"dev": "vite dev",