# web-wiki

**Repository Path**: linbirg/web-wiki

## Basic Information

- **Project Name**: web-wiki
- **Description**: 展示wiki的web
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 易观阁 · 知识库

基于 Obsidian 知识库的 Wiki 展示站点。

## 技术栈

- **前端**: Vue 3 + Vite + vue-router
- **后端**: Python FastAPI + Uvicorn
- **数据源**: 本地 Obsidian Markdown 文件 → SQLite
- **数据库**: SQLite（yom-sqlite ORM）

## 快速开始

```bash
# 后端
cd backend
VAULT_PATH=/home/donghai/obsidian/ uv run uvicorn main:app --reload

# 前端
cd frontend
pnpm dev
```

## 项目结构

```
web-wiki/
├── backend/     # FastAPI 后端
├── frontend/    # Vue 3 前端
├── docs/         # 设计文档
└── AGENTS.md    # AI 助手行为指南
```

## 部署

### SPA 路由 fallback

前端使用 History 模式路由，部署到 Nginx 时需配置：

```nginx
location / {
    try_files $uri $uri/ /index.html;
}
```

### 环境变量

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `VAULT_PATH` | Obsidian vault 根目录 | `/home/donghai/obsidian/` |
| `DATABASE_PATH` | SQLite 数据库路径 | `data/wiki.db` |
```