# book-mcp Frontend

DoLuEdu Arco Admin Vue 管理端骨架 + book-mcp 业务模块。

## 启动

```bash
# 1. 确保 book-mcp server 在跑 (8100)
# 2. 装依赖
npm install

# 3. dev server
npm run dev    # http://localhost:5176

# 4. 构建生产
npm run build
```

## 配置

- `vite.config.dev.ts` — dev proxy `/mcp → http://localhost:8100/mcp`
- `.env.development` — `VITE_API_BASE_URL=/mcp`（用相对路径走 proxy）

## 业务模块

- `src/api/mcp.ts` — JSON-RPC 客户端（fastmcp 协议）
- `src/api/book.ts` — book CRUD
- `src/api/document.ts` — document / file CRUD + health
- `src/views/BookManage/index.vue` — 列表页（路由 `/book/list`）
- `src/views/BookManage/BookDetail/index.vue` — 详情页（路由 `/book/:id`）
- `src/views/BookManage/components/BookList.vue` — 列表组件
- `src/views/BookManage/components/DocumentItem.vue` — 文档折叠项

## MCP 后端

15 个工具，分类：

| 类别 | 工具 |
|---|---|
| 写入 | create_book / add_document / mark_html_ready / mark_json_ready / mark_failed / update_book_status |
| 查询 | get_book / list_books / get_document / list_documents / get_document_url |
| 辅助 | upload_to_rustfs / soft_delete_book / retry_failed |
| 诊断 | health |

启动：launchd `ai.book-mcp.server`（端口 8100，stateless_http + json_response）。

## 模板来源

`DoLuEdu-Template/frontend/arco-admin-vue/` 复制而来。模板规则：禁止在模板里写业务，只在骨架基础上加。

## 关键约定

- Vue 3 + TypeScript + `<script setup>`
- Arco Design Vue 2.x
- 目录 PascalCase（`BookManage/` 不是 `book-manage/`）
- API 用 axios 包 fastmcp JSON-RPC