# windows11

**Repository Path**: idcims/windows11

## Basic Information

- **Project Name**: windows11
- **Description**: 原项目汉化(https://github.com/chrishtu/windows11)
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-09
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# windows11

这是一个在浏览器里运行的 Windows 11 风格桌面项目，包含桌面、任务栏、窗口系统、设置页，以及一个独立的 Live2D AI 助手。

## 技术栈

- 前端：Vue 3 + Vite
- 状态管理：Pinia
- UI：Element Plus
- 桌面壳：TypeScript
- 助手服务：独立 SSE 服务
- 配置存储：MySQL + 本地文件兜底

## 主要功能

- Windows 11 风格桌面、任务栏、开始菜单、右键菜单
- 多窗口应用系统
- 文件关联打开
- 本地设置持久化
- Live2D AI 助手浮层
- 独立 AI 后台管理页
- 回复样式支持：
  - 气泡模式
  - 字幕模式
- 用户消息弹幕飘屏
- 表情管理与真表情生成

## 独立后台

后台地址：

- `./ai-admin/`
- 表情编辑器：`./ai-expression.html`

首次启动服务会自动建库建表，并创建默认管理员账号（见 `.env.example`）。

后台使用 Vue + Vite + Pinia + Element Plus 构建，可以管理：

- 助手名称
- 回复样式
- Live2D 模型地址
- Live2D 运行时地址
- 头像位置与大小
- 字幕位置、字号、宽度、字体
- 后端平台
- 模型选择
- 系统提示词
- SSE 头部 JSON
- 连接测试
- Live2D 表情映射

后台配置会优先写入服务端数据库，桌面助手启动时也会先读取最新配置。

## 助手服务

AI 通信已经拆到独立服务里：

- 服务文件：`scripts/assistant-service.js`
- 默认地址：`http://localhost:8787`

服务提供这些接口：

公开接口：

- `GET /health`
- `GET /api/assistant-runtime` — 运行时配置（不含 API Key）
- `POST /api/chat`
- `POST /api/models`
- `POST /api/test`
- `POST /api/auth/login` — 管理员登录

需要登录（Bearer Token）：

- `GET /api/auth/me` — 验证 Token
- `GET /api/assistant-config`
- `POST /api/assistant-config`
- `POST /api/live2d/read-expression`
- `POST /api/live2d/save-expression`
- `POST /api/live2d/generate-expressions`

## 启动方式

### 一键启动前端 + 服务

```bash
npm run start
```

会同时启动：

- 前端：`http://localhost:8124/`
- 后台：`http://localhost:8124/ai-admin/`
- 助手服务：`http://localhost:8787`

### 只启动服务

```bash
npm run service
```

### 只启动前端

```bash
npm run dev
```

### 构建

```bash
npm run build
```

构建产物输出到 `dist/`。

## MySQL 配置

后台配置默认会优先保存到本地 MySQL，数据库参数可以通过环境变量配置。

默认值如下：

- `MYSQL_HOST=127.0.0.1`
- `MYSQL_PORT=3306`
- `MYSQL_USER=root`
- `MYSQL_PASSWORD=root`
- `MYSQL_DATABASE=windows11_ai`
- `MYSQL_TABLE=assistant_settings`

## 管理员账号

首次启动会自动创建默认管理员：

- 用户名：`admin`（可通过 `ADMIN_USERNAME` 配置）
- 密码：`admin123`（可通过 `ADMIN_PASSWORD` 配置）

推荐直接复制 `.env.example`，按你的环境修改后再启动。

如果 MySQL 暂时不可用，服务会自动回退到本地文件：

- `data/assistant-config.json`

## 推荐 LLM 平台

### Ollama

- 接口地址：`http://localhost:11434/api/chat`
- 模型列表来自：`GET /api/tags`

### DeepSeek

- 接口地址：`https://api.deepseek.com/chat/completions`
- 需要 `API Key`

### OpenAI

- 接口地址：`https://api.openai.com/v1/chat/completions`
- 需要 `API Key`

### Qwen

- 接口地址：`https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions`
- 需要 `API Key`

### Moonshot

- 接口地址：`https://api.moonshot.cn/v1/chat/completions`
- 需要 `API Key`

### SiliconFlow

- 接口地址：`https://api.siliconflow.cn/v1/chat/completions`
- 需要 `API Key`

## 说明

- Live2D 默认使用本地 Haru 演示模型。
- 桌面助手启动时会先从服务读取最新配置，再渲染头像和回复样式。
- 回复内容支持字幕模式，默认两行，适合电影字幕风格。
- 如果你想让 Ollama 可用，请先确保本机 `11434` 已经启动。