📂 solution-1.0

# Hermes Agent Solution

> 一个可私有化部署的 AI 助手解决方案

## 代码浏览器

所有源码可通过 **`http://code.rosicky.top/`** 在线浏览（只读）。

- 目录树浏览，GitHub 风格
- 代码语法高亮（基于 highlight.js）
- 支持所有常见语言：Python、JS、HTML、CSS、Markdown、Bash 等

> 你也可以在阿里云 DNS 加 `code` 的 A 记录指向本机 IP，即可通过 `http://code.rosicky.top/` 访问。

## 工作流

所有代码变更在 `solution-1.0/` 中进行，完成后 deploy 到实际位置：

```bash
# 1. 修改代码
vim server/chat-server/server.py
vim webchat/index.html

# 2. 部署到实际运行位置
bash deploy/deploy.sh
```

**不要直接修改实际运行位置的文件。** `solution-1.0/` 是唯一权威代码源。

## 目录结构

```
hermes-solution/
├── server/                    # 后端服务
│   ├── chat-server/          # WebSocket + HTTP 聊天服务
│   ├── auth/                 # 设备认证网关
│   └── obsidian-web/         # Wiki 文档服务
├── webchat/                  # WebChat 前端（单 HTML 文件）
├── task-org/                 # 分资产管理前端
├── deploy/                   # 部署配置
│   ├── nginx/               # Nginx 网关配置模板
│   └── systemd/             # systemd 服务单元
├── scripts/                  # 定时任务脚本
├── skills/                   # Agent 技能定义
├── data/                     # 数据目录（运行时会写入）
│   ├── db/                  # SQLite 数据库
│   └── attachments/         # 本地附件存储
└── docs/                     # 文档
```

## 快速开始

```bash
# 1. 克隆
git clone https://github.com/xxx/hermes-solution
cd hermes-solution

# 2. 配置
cp .env.example .env
# 编辑 .env → 填入你的 API Key 和域名

# 3. 部署
bash deploy/install.sh
```

## 组件

| 服务 | 端口 | 说明 |
|:--|:--:|:--|
| Chat Server | 8765/8766 | WebSocket + HTTP API |
| Auth Gateway | 8081 | 设备认证 |
| Wiki | 8080 | 文档系统 |
| Nginx | 80 | 统一网关 |

## 技术栈

- Hermes Agent（内核）
- Python 3.11（服务端）
- 原生 HTML/CSS/JS（前端，无框架）
- SQLite（数据库）
- Nginx（网关）
- 阿里云 OSS / 本地文件（附件存储）