# Qingtian Detail Record — 2026-08-28

## 1. 系统结构方向确认

今天进一步确认整体系统由三个独立模块组成：

1. **FRO**
2. **Qingtian（晴天）**
3. **智能家居**

三个模块属于同一个整体系统，因此可以互相跳转；但是每个模块的核心功能必须独立，不能把其他模块的功能直接混进当前模块。

### 设计原则

- 同一个系统
- 三个独立功能模块
- UI 视觉风格统一
- 每个模块只展示自己的核心功能
- 可以通过方便按钮跳转到其他模块

---

## 2. FRO UI 重新定位

用户明确指出：FRO 页面必须只保留 **FRO 的功能**。

此前混入 FRO 页面、但不属于 FRO 的 Qingtian 内容或其他功能，应全部移除。

最终确认的 FRO UI 方向采用用户选定的视觉风格：

- 深蓝色左侧导航
- 紫色 / 蓝紫色主要操作按钮
- 浅色卡片式主内容区域
- 统一圆角和轻阴影
- Desktop 与 Android Mobile 保持一致的设计语言

用户认为该配色比较出色，因此后续新的 FRO UI 应继续使用这一套视觉方向。

---

## 3. FRO 核心功能

### 设备状态

用于查看 FRO 管理范围内设备，例如：

- HP Victus
- Victus Performance
- IEI Server
- QNAP NAS

状态信息可包括：

- 在线 / 离线
- Hostname
- OS
- CPU
- RAM
- Disk
- Uptime
- HTTP Status
- 最后更新时间

### Desktop Control

FRO 的远程电脑控制功能：

- Wake PC
- Restart PC
- Shutdown PC
- Check Now / Refresh

### 文件与远程办公功能

FRO 本身继续负责：

- 文件管理
- 上传文件
- FileDrop
- 传输记录
- 存储状态
- 回收站
- 设备管理
- 历史记录
- 设置

### 模块跳转

FRO 页面需要有方便按钮，可以跳转到：

- Qingtian
- 智能家居

这两个按钮是 **系统内模块入口**，不是把 Qingtian 或智能家居功能直接塞进 FRO 页面。

---

## 4. Qingtian Daily Record：双 Markdown 文件

今天继续确认 Qingtian 每日记录采用双文件结构。

### Daily Markdown

文件：

`YYYY-MM-DD.md`

用途：

- 简短每日摘要
- 已完成事项
- 当前状态
- 重要结果

### Detail Markdown

文件：

`YYYY-MM-DD-detail.md`

用途：

- 更完整的过程记录
- UI / 架构决策
- 技术测试
- 问题与排查
- 后续方向

两个文件应保存到 NAS：

`/nas/Qingtian/Records/YYYY/MM/`

例如：

`/nas/Qingtian/Records/2026/08/2026-08-28.md`

`/nas/Qingtian/Records/2026/08/2026-08-28-detail.md`

---

## 5. Qingtian 编辑页面：双编辑器方向

Qingtian Record 编辑页面已增加：

- Daily Markdown 编辑区
- Detail Markdown 编辑区

前端已确认存在：

- `id="editor"`
- `id="detail-editor"`
- `detail_content: detailEditor.value`

保存时通过同一个日期记录接口提交 Daily 内容与 Detail 内容。

之前的测试曾成功确认两个文件可以一起写入 NAS。

---

## 6. 2026-08-25 记录覆盖问题

检查 NAS 后发现：

`/nas/Qingtian/Records/2026/08/2026-08-25.md`

当前内容为：

`fgg`

而：

`/nas/Qingtian/Records/2026/08/2026-08-25-detail.md`

当前内容为：

`ggg`

文件大小均只有 3 bytes。

进一步检查 `/nas/Qingtian` 下与 2026-08-25 相关的 Markdown 文件，没有找到额外历史副本或 `.before-*` 备份文件。

因此，目前确认：

- 双 Markdown 保存机制可以工作
- 但 2026-08-25 原始正式内容已被测试保存覆盖
- 当前 NAS 路径中未找到可直接恢复的原始备份

---

## 7. OpenAI API / Qingtian Chat 讨论

今天讨论了 Qingtian Chat 与 ChatGPT Go 的关系。

确认方向是：

- ChatGPT Go 中的普通聊天不会自动完整导入 Qingtian
- 如果 Qingtian 需要自己的 AI 生成能力，需要通过 OpenAI API
- API Billing 与 ChatGPT Go / ChatGPT 订阅分开
- API 根据实际使用量计费，例如模型、输入 / 输出 tokens 等
- Billing 页面显示当前 API credit remaining 为 `$0.00`
- 因此 API 需要单独配置 Billing / payment 才能持续进行 API 调用

此前使用 `/v1/responses` 的 Python 测试返回：

`HTTP 400: Bad Request`

即请求已经到达 API，但当前请求仍需要继续查看具体错误内容、模型配置或账户 / Billing 配置。

---

## 8. 当前 UI 与系统方向总结

### FRO

只做：

- Remote Office
- 文件管理
- FileDrop
- 设备管理
- Desktop Control
- NAS / 存储
- 传输记录
- FRO 快捷操作

并提供跳转入口：

- 前往 Qingtian
- 前往智能家居

### Qingtian

负责：

- Context
- WorkLog
- Conversation
- Daily Record
- History
- AI / API 能力
- 每日 Markdown 记录

### 智能家居

独立负责：

- 智能家居相关控制与状态

**三个模块属于同一个系统，使用统一设计语言，但功能独立、入口互通。**