README.md

---
title: Interactive Checklist Master
emoji: ✅
colorFrom: indigo
colorTo: blue
sdk: docker
pinned: false
license: mit
short_description: 交互式清单生成器
---

# 交互式清单生成器 (Interactive Checklist Master)

这是一个强大的、无需代码的**交互式清单生成器**。你可以用它来创建 SOP（标准作业程序）、课程大纲、旅行清单、产品发布检查表等，并**一键导出**为独立的 HTML 文件。

导出的 HTML 文件是完全独立的（Single File HTML），包含所有逻辑和样式，**无需服务器即可运行**，非常适合作为**数字产品**（Digital Product）进行分发或销售。

## ✨ 功能特点

*   **所见即所得 (WYSIWYG)**：左侧编辑，右侧实时预览最终效果。
*   **多设备预览模式**：支持一键切换**手机、平板、桌面**视图，确保清单在任何设备上都完美展示。
*   **一键导出单页 HTML**：生成的文件可离线运行，也可部署到任何静态托管（GitHub Pages, Vercel 等）。
*   **配置备份与迁移**：支持**导出/导入 JSON 配置**，方便保存源文件或分享给他人二次编辑。
*   **丰富的预设模板**：内置“产品发布”、“旅行打包”、“项目启动”等多种模板，快速开始。
*   **本地进度保存**：导出的清单会自动使用浏览器 `localStorage` 保存用户的打钩进度，刷新不丢失。
*   **多主题支持**：内置多种精美配色方案。
*   **交互特效**：完成清单时会自动触发庆祝烟花特效 🎉。

## 🚀 快速开始

### 在 Hugging Face Spaces 上运行

本项目已配置为 Docker Space，可直接一键部署。

### 本地运行

1.  克隆仓库：
    ```bash
    git clone https://huggingface.co/spaces/duqing2026/interactive-checklist-master
    cd interactive-checklist-master
    ```

2.  安装依赖：
    ```bash
    pip install -r requirements.txt
    ```

3.  运行应用：
    ```bash
    python app.py
    ```

4.  打开浏览器访问 `http://localhost:7860`。

## 🛠️ 技术栈

*   **Backend**: Flask (Python) - 用于提供构建器界面。
*   **Frontend (Builder)**: Vue 3 + Tailwind CSS - 交互式编辑器。
*   **Exported Product**: Vue 3 + Tailwind CSS (CDN) - 独立的单页应用。
*   **Deployment**: Docker.

## 💡 使用场景 (如何赚钱?)

1.  **制作并销售 "终极发布清单"**：整理你所在行业的专业流程（如 "独立开发者产品发布清单"、"播客启动清单"），导出 HTML，打包销售。
2.  **客户交付物**：作为咨询服务的交付物，给客户提供一个可交互的执行清单，而不是死板的 PDF。
3.  **引流工具**：制作高质量的免费清单（如 "2024年前端学习路线图"），作为 Lead Magnet 获取邮箱。

## 📄 License

MIT