# 知识库

**Repository Path**: Li212123/knowledge-base

## Basic Information

- **Project Name**: 知识库
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-15
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MindVault - 个人知识库

📚 一个简洁美观的无数据库笔记管理应用

## ✨ 功能特点

- 📝 **Markdown 编辑器** - 支持实时预览，写笔记更高效
- 📂 **知识库管理** - 轻松整理和搜索所有笔记
- 📊 **仪表盘** - 一目了然查看笔记统计
- 📦 **多格式导出** - 支持 PDF、Word、Markdown、JSON 格式导出
- 🎨 **精美界面** - 现代渐变设计，视觉体验出色
- 📱 **响应式布局** - 支持各种屏幕尺寸
- 🔒 **本地存储** - 数据保存在浏览器本地，安全私密

## 🚀 快速开始

### 方法一：直接使用

1. 下载或克隆本项目
2. 双击 `index.html` 打开即可使用

### 方法二：部署到 GitHub Pages

1. Fork 本仓库
2. 进入仓库 Settings → Pages
3. Source 选择 `main` 分支和 `/(root)`
4. 点击 Save
5. 等待部署完成，访问 `https://你的用户名.github.io/仓库名`

### 方法三：同时推送到 Gitee（国内访问更快）

同一个仓库可以同时托管在 GitHub 和 Gitee，内容完全一致：

```bash
# 1) 先在 Gitee 网页端新建一个空仓库（不要勾选「使用 Readme 初始化仓库」）
# 2) 添加 Gitee 远程（地址换成你自己的）
git remote add gitee https://gitee.com/你的用户名/你的仓库名.git

# 3) 推送（首次会要求登录，密码处填 Gitee「私人令牌」而不是登录密码）
git push -u gitee main
```

之后每次更新，两边各推一次即可：

```bash
git push origin main   # GitHub
git push gitee  main   # Gitee
```

> 也可以改用 SSH：`git remote add gitee git@gitee.com:你的用户名/你的仓库名.git`
> 部署网页时，Gitee Pages 需要账号完成实名认证并开通该服务后才能使用；
> 如果只想要一个可访问的在线地址，用上面方法二的 GitHub Pages 更省事。

## 📖 使用指南

### 创建笔记

1. 点击左侧导航的"✏️ 编辑笔记"
2. 输入标题和标签
3. 在左侧编辑器中编写 Markdown 内容
4. 右侧实时预览效果
5. 点击"💾 保存"按钮保存笔记

### 导出笔记

1. 点击"📦 导出中心"
2. 选择要导出的笔记（可多选）
3. 选择导出格式：
   - 📕 **PDF** - 通过浏览器打印功能生成高质量 PDF
   - 📘 **Word** - 生成 .doc 格式文档
   - 📝 **Markdown** - 导出 .md 文件
   - 💾 **JSON** - 导出原始数据备份

### Markdown 支持的格式

```markdown
# 一级标题
## 二级标题
### 三级标题

**加粗** 和 *斜体*

- 列表项
- 列表项

> 引用文本

`代码块`

| 表格 | 示例 |
|------|------|
| 内容 | 内容 |
```

## 🔐 个人课表数据（不会上传到仓库）

「课表」页面的数据放在根目录的 `timetable.local.js`，该文件已被 `.gitignore` 忽略，
**不会被提交或推送到 GitHub / Gitee**。仓库里不预置任何课程数据，克隆后打开课表页是空的。

- **本机使用**：把 `timetable.local.example.js` 复制为 `timetable.local.js`，填入自己的
  学校 / 班级 / 课程 / 教师 / 上课地点，打开 `index.html` 即生效。
- **没有该文件时**：课表为空，可直接用页面上的「＋ 课程」手动添加；学期信息用「⚙️ 学期」填写。
- **网页里改过的课表**保存在浏览器本地（localStorage）；点课表页的「↺ 默认」会用
  `timetable.local.js` 里的数据还原。
- **确认没被误加入仓库**：`git status` 中不应出现 `timetable.local.js`，也可以用
  `git check-ignore -v timetable.local.js` 验证它已被忽略。

## 🛠️ 技术栈

- **前端框架**: 原生 HTML + CSS + JavaScript
- **数据存储**: IndexedDB（笔记/图片/每日计划/模板，突破 5MB 限制）+ LocalStorage（主题、草稿、旧数据迁移）
- **PDF 生成**: 浏览器原生打印功能
- **Word 生成**: HTML to DOC 转换
- **图标**: Emoji 表情符号

## 📁 项目结构

```
├── index.html                    # 主应用（直接打开即可使用）
├── timetable.local.js            # ⚠ 个人课表数据（仅本机，见下方「个人课表数据」）
├── timetable.local.example.js    # 个人课表数据模板（复制为 timetable.local.js 后填写）
├── 启动知识库.html              # 启动器窗口页面（桌面快捷方式入口）
├── MindVault.ico                 # 应用图标
├── 打开知识库.html              # 快捷入口页面
├── MindVault-数据备份/         # 数据备份工具（全量导出为 JSON）
│   ├── 导出数据.html            # 从 IndexedDB 读取并导出全部数据
│   └── README.txt               # 备份/恢复使用说明
├── desktop/                      # Tauri 桌面版（独立应用）
│   ├── src/                      # Rust 入口
│   ├── tauri.conf.json           # 窗口/打包配置
│   ├── copy-frontend.ps1         # 静态资源复制脚本
│   └── README.md                 # 桌面版构建与数据迁移说明
├── README.md                    # 项目说明文档
└── LICENSE                      # 开源许可证（MIT）
```

> 仓库里只有空白原版的应用本体：不包含任何个人笔记、课表或学习资料。
> 本机专用内容（已在 `.gitignore` 中，不会上传）：`timetable.local.js`（个人课表）、
> `教程资料/`（个人学习笔记）、`导入C语言计划.html`、`MindVault-数据备份/*.json`（笔记备份）、
> `发布版本/`（打包产物）。

## 🎨 界面预览

应用采用现代化的渐变色设计，包括：

- **仪表盘** - 查看笔记统计和最近笔记
- **知识库** - 管理和搜索所有笔记
- **编辑器** - Markdown 实时编辑和预览
- **导出中心** - 多格式导出笔记

## 📝 使用说明

- 所有笔记数据保存在浏览器本地（IndexedDB + LocalStorage）
- 清除浏览器缓存可能会删除笔记，建议定期用 `MindVault-数据备份/导出数据.html` 导出全量备份
- 备份恢复：打开应用 → 导出中心 → 导入 JSON 备份（笔记按 ID 去重保留较新版本，图片/计划/模板只补充缺失，不覆盖已有数据）
- 导出功能会打开新窗口或直接下载文件

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 开源许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 🙏 致谢

- [Google Fonts](https://fonts.google.com/) - 提供 Noto Sans SC 字体
- [Noto Sans SC](https://fonts.google.com/specimen/Noto+Sans+SC) - 中文字体支持

---

💡 **提示**: 如果觉得有用，请给项目点个 Star ⭐