# Skill Forge Base

> Skill Forge 基础设施。初始化数据库、运行 Dashboard 服务器、管理学习历史。

- Skill: `zjfls/skill-forge-base` (Agent Skill, multi-file: 48 files)
- Install (CLI): `npx skillmds add zjfls/skill-forge-base`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zjfls/skill-forge-base/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zjfls (https://skillmd.com/u/zjfls)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/zjfls/skill-forge-base

---


# Skill Forge Base - 基础设施与运行环境

此 Skill 管理 **Skill Forge** 学习环境。负责初始化系统、提供用户界面（Dashboard、答题、历史记录）以及管理数据库。

## 核心能力

1.  **系统初始化**：自动创建 `~/.skill-forge` 环境。
2.  **Dashboard 服务**：在 `localhost:3457` 运行 Web 界面。
3.  **历史与分析**：追踪学习进度和错题。

详细的架构和数据库 Schema 请参阅 [ARCHITECTURE.md](resources/ARCHITECTURE.md)。

## 使用说明

### 1. 初始化系统
任何操作之前，确保系统已初始化。此操作是幂等的（可重复执行）。

```bash
# 运行服务器时会自动触发初始化（首次运行会创建 ~/.skill-forge/ 目录与默认 config.json，并初始化数据库表）
node lib/server.js
```

### 2. 启动 Dashboard
要打开主界面进行答题或查看历史：

```bash
# 启动服务器（后台运行）
node lib/server.js &

# 打开 Dashboard
open "http://localhost:3457/dashboard"
```

### 3. 查看历史
要查看学习历史和生成报告：

1.  打开 Dashboard (`/dashboard`)。
2.  导航到"历史记录"部分。
3.  或通过 API 验证：`curl http://localhost:3457/api/history`

## 依赖
- **Node.js**: >= 14.0.0
- **SQLite3**: 数据存储
- **数据目录**: `~/.skill-forge/` (与 `skill-forge-quiz` 共享)

## 配置说明（重要）
- Dashboard/测验功能可在未配置 AI 模型时运行。
- 若要启用“题目深度解析”等 AI 功能，需要在 `~/.skill-forge/config.json` 中设置 `ai.model`（以及可选的 `ai.cliCommand`）。