AI 提示词管理工具 —— 把杂乱无章的 Prompt 文档，变成 五级分类书架 + 极速检索 + 一键复制 + 每日增量备份 的本地神器。
双击 PromptSprite.exe 即可使用。数据全部保存在本机，无任何联网行为。
| 特性 | 说明 |
|---|---|
| ① 五级分类书架 | 项目类别 → 根目录 → 一级 → 二级 → 条目；项目类别预置 5 项（日常学习记录/网上资源收集/个人梳理资源/本人创作作品/个人经验总结），根目录跨项目移动/复制 |
| ② 老数据迁移 | 旧版（根目录-一级-二级）数据升级：迁移向导人工核对映射、未命中弹窗选择、未回答兜底"未明确分类"（自动弹出/菜单重开） |
| ③ 9 字段详情 | ①名称…⑩图像方案；按根目录动态显隐；⑩图像方案可"打开"链接；编辑/悬停浮窗/图片预览 |
| ④ 一键复制 | 复制全部 / 复制中文 / 复制英文 |
| ⑤ 快捷悬停添加 | 悬停滑过分类即锁定，光标自动跳入输入框，连续录入不打断 |
| ⑥ 悬停选中与高亮 | 主界面"鼠标悬浮约 0.2 秒即选中"，选中链路高亮；状态栏按悬停层级动态统计 |
| ⑦ 安全回收 | 全局锁定（🔒）+ 删除二次确认并移入"回收站"（可恢复）+ 删除分类条目转"未分类" + 删除根目录仅解除关联 |
| ⑧ 收藏与搜索 | ⭐常用入口；全局搜索实时过滤全部文本字段（LIKE 通配符转义） |
| ⑨ 导入导出 | JSON（v2/v3 兼容，v3 含项目归属）/ Excel / HTML / MD（进度条）；导入按内容自动去重；批量事务导入 |
| ⑩ 自动全量备份 | 每次启动自动备份，仅保留最近 5 份，失败状态栏警告 |
| ⑪ 每日增量备份 | 每次关闭自动生成"当日变更"JSON v3（增量_{电脑代号}_{日期}.json，幂等重生成、保留 30 天可设）；覆盖 增/删/改/空分类 全同步；可换机导入合并、可导出 Excel/HTML 浏览 |
| ⑫ 全局热键/托盘 | Ctrl+Shift+P 唤出聚焦搜索；ESC 隐藏；托盘恢复/退出 |
| ⑬ 内置数据 | 首次启动自动导入内置完整库（精简模板：4 项目类别 / 10 根目录 / 2555 条）；升级"非破坏性合并"不丢用户数据 |
| ⑭ 用户设置 | 记住窗口大小、默认视图、详情字段策略、电脑代号、增量保留天数；"ℹ 关于"显示版本信息 |
| ⑮ 分类复制/移动 | 根目录/一级/二级可"复制到…/移动到…"：下移加前缀（A→A.C）、上移去前缀、重名自动加序号、共享分类自动复制、移动不丢条目 |
| ⑯ 界面优化 | 导航列窄宽 + 长名称悬停提示 + 🗂 项目列一键折叠/展开 |
| ⑰ 一键打包 | python build.py 自动生成单文件 EXE |
| ⑱ 条目多位置 | 关联到（一处编辑各位置同步）/ 复制到（独立副本）/ 移动到（可勾"整体转移"清空其它关联）；详情区"🧭 位置"面包屑（含 项目类别 › 根目录）可逐处解除 |
| ⑲ 就地新增入口 | 条目区醒目绿色"＋新增条目"；任一分级分类都可持有并显示本级条目，直接在该分类新增 |
| ⑳ 删除分类三级保护 | 有子分类需先处理下级；无子分类删除只解除直挂条目位置；级联整棵删除须手工输入确认短语后再二次确认 |
| ㉑ 回收站/删除历史 | 详情区底部"♻ 删除历史 / 回收站"：删除=完整快照入回收站，可恢复（原内容/收藏/多位置一并回挂）；支持逐条彻底删除与清空（图片文件在彻底清除时才释放） |
| ㉒ 新增历史 | 详情区底部"🕒 新增历史"：按 今日/近3/7/30天/全部 查看最近新增条目，每条可一键复制 中/英/全部 提示词 |
| ㉓ 初始导航与详情面包屑 | 启动仅显示顶层"项目类别"，其余列提示+新增按钮灰显；详情顶部浅色"🧭 位置"面包屑展示 项目类别 › 根目录 › 一级 › 二级 完整链 |
- 初始视图：启动仅列出顶层"项目类别"，根目录/一级/二级/条目逐级选择再展开（旧版会把全库一级分类一次铺满）；各列"新增"按钮初始灰显保留、选定上级自动点亮；
- 回收站 / 删除历史：删除条目改为"移入回收站（可恢复）"，详情区底部"♻ 删除历史 / 回收站"统一承担查看删除记录、恢复、彻底删除、清空；
- 新增历史：详情区底部"🕒 新增历史"按时间范围查看最近新增，一键复制提示词；
- 详情位置面包屑：浅色轻标签展示完整路径「项目类别 › 根目录 › 分类」，主位置浅绿、关联位置浅灰蓝；
- 悬浮与滚动体验：悬停选中延迟 0.3s→0.2s，列切换改原地高亮避免整列重建；各可滚动列自动回顶；
- 详情字段卡片化配色（①~⑩ 分色块）、删除按钮移至详情底部、"关于"补充开源仓库地址。
本版继续收录 V1.5.0 以下改进：
- 条目 关联到 / 复制到 / 移动到：目标分类多选、移动可"整体转移"、同一条目多位置编辑一处全同步；
- 名称输入框统一为详情区/新增表单首个字段 "① 条目名称（风格名称）"；顶部命令条统一为按钮：移动 / 关联 / 复制 / 收藏；
- 条目就地新增醒目入口 + 任一分级分类可新增并显示本级条目；
- 详情区多位置提示行（主位置 / 关联位置逐处解除）；删除分类三级保护（级联删除需输入确认短语）；
- 精简模式标题与"显示全部字段"按钮合并为一行，界面更紧凑。
| 项目类别 | 根目录 | 条目数 |
|---|---|---|
| 网上资源收集 | 海外AI绘画案例库 / AI绘画精选案例 / GPT Image 提示词库 / AI生图提示词大全 | 2555 |
| 日常学习记录 | 视频 / 图像 / 音频 / 文学 / 学术 / 专业报告 | 0 |
| 本人创作作品 | —（根目录已清空） | 0 |
| 个人经验总结 | —（根目录已清空） | 0 |
| 合计 | 10 | 2555 |
2026-09-07 起改用"精简模板"：仅保留"网上资源收集"示例数据，个人/梳理类内容已清理；示例数据来源含 moosl/awesome-gpt-image-2-prompts、davidwuw0811-boop、ZeroLu/awesome-gpt-image、whataicc/aiprompt 等（均已标注 origin 溯源字段）。
┌────────────────────────────────────────────────────────────────────┐
│ 🧩 PromptSprite │ 🔒锁定 │ 📂未分类 │ ⭐常用 │ [搜索] │ ⇩导入 ⇧导出 ✚快速新建 ⚙设置 │
├────────┬────────┬────────┬────────┬───────────────────────────────┤
│ 项目类别│ 根目录 │ 一级 │ 二级 │ 条目(卡片/列表) ｜ 详情(可编辑) │
│ 网上资源│ 海外AI │ Portrait│ 人像 │ 电影风格人像 ｜ 名称/收藏/删除 │
│ 日常学习│ 图像(空)│ — │ — │ （暂无条目） │ 复制/中/英 保存 │
│ … │ … │ … │ … │ … │ … │
└────────┴────────┴────────┴────────┴───────────────────────────────┘
│ 底部状态栏：总提示词数 2555｜项目类别 4｜根目录 10｜一级 79｜二级 91 │
└────────────────────────────────────────────────────────────────────┘
- 从 Releases 下载
PromptSprite_<日期YYMMDD>_V<版本号>.exe（如PromptSprite_260907_V1.6.0.exe）； - 双击运行（首次自动建库并导入内置提示词）；
- 详细图文说明见 《软件安装使用说明书 V6》。
# 1. 克隆仓库
git clone https://github.com/yihufree/PromptSprite.git
cd PromptSprite
# 2. 创建虚拟环境并安装依赖
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
# 3. 启动（以下三种方式等价）
python app/main.py # 直接运行主文件（推荐）
python run.py # 根目录启动器
python -m app.main --smoke # 冒烟测试：5 秒后自动退出python build.py # 一键打包（自动装依赖/生成图标/PyInstaller 单 EXE）产物自动按 PromptSprite_<日期YYMMDD>_V<版本号>.EXE 命名（2026-09-07 起），如 dist\PromptSprite_260907_V1.6.0.exe（单文件、无控制台窗口）。
详见 《打包发布指南 V7》。
PromptSprite/
├── app/
│ ├── main.py # 程序入口：启动编排（备份→建库→迁移向导弹出→热键/托盘）
│ ├── config.py # 全局常量：版本、目录、项目类别与映射、增量备份、meta 键
│ ├── database.py # SQLite 数据层：projects/domains/categories/entries/meta/entry_links/
│ │ # deletion_log/trash(回收站)；迁移(v1→v2→v3)、复制/移动、删除恢复、删除日志
│ ├── models.py # 数据模型：Entry（9 字段 + 图片/收藏/时间戳）
│ ├── backup.py # 启动静默全量备份（保留最近 5 份，快照不误删）
│ ├── incremental_backup.py # 每日增量备份：按日收集 条目/分类(含空分类)/删除清单，
│ │ # 生成 JSON v3、换机合并、导出 Excel/HTML、日志清理
│ ├── hotkey.py # 全局热键 Ctrl+Shift+P + 系统托盘（键盘钩子/托盘图标）
│ ├── self_test.py # 统一自测入口（database/backup/incremental/md_parser + 冒烟）
│ ├── parser/
│ │ ├── md_parser.py # Markdown 内置手册解析与"非破坏性合并"导入
│ │ ├── json_io.py # JSON v2/v3 导入导出（v3 含项目归属 + 删除清单）
│ │ ├── excel_io.py # Excel 导入导出（read_only 流式 + 判重；新建根目录归未明确分类）
│ │ └── html_export.py # HTML 分享页导出（转义 + base64 图片）
│ ├── ui/
│ │ ├── main_window.py # 主窗口：四列导航(项目/根目录/一级/二级)、详情、状态栏、锁定、
│ │ │ # 导入导出/增量入口、项目列折叠、回收站与新增历史入口
│ │ ├── history_dialog.py # 删除历史/回收站（恢复/彻底删除/清空）与 新增历史（2026-09-07）
│ │ ├── quick_add.py # 快捷悬停添加窗口（四列导航：项目→根目录→一级→二级，悬停锁定、连续录入、长名称提示）
│ │ ├── copy_move_dialog.py # "复制到/移动到"目标树（项目→根目录→分类）与预览
│ │ ├── move_selector.py # 条目"移动到分类"树形选择器
│ │ ├── migrate_dialog.py # 老版本数据迁移向导（映射核对→执行→报告）
│ │ ├── project_chooser.py # 共用项目类别选择弹窗（主窗口/快速新建复用）
│ │ ├── progress_dialog.py # 导入进度条模态窗口
│ │ └── settings_dialog.py # 设置（窗口/视图/详情/电脑代号/保留天数）+ 关于弹窗
│ └── resources/
│ ├── builtin_manual.md # 内置手册（90 条）
│ └── builtin_prompts.db # 内置完整数据库（打包时由 build.py 生成）
├── docs/ # 需求规格V7 / 审核报告V6 / 说明书V6 / 打包指南V7 / 设计·施工方案 / 开发记录
├── Icons/PSicon.png # 应用图标源
├── build.py # 一键打包（装依赖→生成图标→内嵌最新库→PyInstaller→校验）
├── run.py # 根目录启动器（等效 python -m app.main）
├── requirements.txt # 运行依赖（customtkinter/Pillow/pyperclip/openpyxl/keyboard/pystray）
├── LICENSE / .gitignore / README.md
└── *.json / *.xlsx # 数据资产文件（可直接导入）
- 分类为全局共享树（
categories），通过domain_category实现多领域共享一级分类； - 新增 projects 表（项目类别，最高层级），
domains.project_id归属项目类别； - 删除根目录仅解除关联；删除分类级联子分类、条目转入"未分类"；
- 旧库启动自动结构迁移（v1 → v2 → v3），根目录归属由"迁移向导"分配（幂等、单事务、可回退）。
| 文档 | 说明 |
|---|---|
| 项目需求规格和开发计划书（V7） | 当前版需求规格与规划 |
| 项目审核和修改建议报告（V6） | V1.4.0 六维审核结论与 P2/P3 建议 |
| 项目复审报告（V7） | 增量备份增强后复审：功能回归/冲突/依赖审计 |
| 软件安装使用说明书（V6） | 面向小白的完整使用指南 |
| 打包发布指南（V7） | 打包与 GitHub Releases 发布全流程 |
| 四级分类与增量备份改造设计方案（V1） | 改造设计与格式支持 |
| 四级分类与增量备份改造施工方案（V1） | 施工阶段与门禁 |
| 开发工作记录 06 | 2026-08-29 起记录卷（第 009 条起） |
- Fork 本仓库并创建特性分支；
- 修改代码时遵循项目约定：修改处添加
修改日期+内容注释； - 每次问答/开发内容按编号追加到开发工作记录（禁止覆盖/删除已有内容）；
- 提交遵循 Conventional Commits 规范；
- 发起 Pull Request。
本项目采用 MIT License（见 LICENSE）。引用本项目或代码请保留版权声明。