# prompt-save-goole-plugin

**Repository Path**: ifredom/prompt-save-goole-plugin

## Basic Information

- **Project Name**: prompt-save-goole-plugin
- **Description**: 浏览器插件-提示词管家
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-18
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 💠 提示词管家（Prompt Steward）

纯本地、零后端的 Chrome 提示词收藏夹插件（Manifest V3），定位为**内容创作者的提示词工作台**：短视频、文生图、AI 漫剧、小说剧本等创作提示词，**选中即存、随时即取、一键复用**。

所有数据只存 `chrome.storage.local`，**不上传任何服务器**；不注入任何网站页面（零 `host_permissions`），界面仅中文。

---

## ✨ 功能特性

| 能力 | 说明 |
|---|---|
| 🎯 选中即存 | 网页右键「保存为提示词」→ 确认弹窗（自动带来源链接）；快捷键 `Alt+Shift+S` 直存 |
| 🎨 文生图专区 | 正向 / 负向词 / 参数三字段，复制时三选一（仅正向 / 正+负 / 含参数） |
| 📦 变量模板 | `{占位符}` 自动识别，复制时填充表单 + 实时预览 |
| 🎬 合集流程编排 | 把相关提示词编排成创作流程（如「AI漫剧项目」），↑↓ 排序，**一键按序复制整套流程** |
| 🗂️ 完整管理 | 全文搜索、标签、收藏 ⭐、置顶 📌、排序（置顶>收藏>最近使用>创建时间） |
| 📚 内置模板库 | 8 个创作模板（短视频 / 文生图 / AI漫剧 / 小说 / 剧本）一键导入 |
| 💾 数据安全 | JSON 全量导出/导入（合并/覆盖，两阶段校验），重复内容自动检测 |

---

## 🚀 安装（本地加载）

1. 打开 `chrome://extensions`，右上角开启「开发者模式」
2. 点「加载已解压的扩展程序」→ 选择本项目根目录
3. 工具栏出现「提示词管家」图标（点拼图 🧩 可固定）

> 💡 扩展 ID 已通过 `manifest.json` 的 `"key"` 字段固定（与项目外的 key.pem 公钥对应），换路径重载后 **ID 与数据保持不变**。

---

## 📖 使用说明

### 保存提示词
- **右键保存**：网页选中文字 → 右键「✂ 保存为提示词」→ 弹窗确认（可改标题 / 加标签 / 切文生图类型）
- **快捷键直存**：选中文字按 `Alt+Shift+S` → 右上角暖黄 toast「已保存」（无选中时打开面板）
- **手动新建**：面板底部「＋新建」/ 管理页「＋新建」

### 取用提示词
- 点工具栏图标 → 搜索/筛选 → 点 **⧉ 复制**（按钮变「✓」）→ 粘贴到任意 AI 对话框
- 文生图条目复制会弹**三选一**；含 `{变量}` 条目会弹**填充表单**

### 创作流程编排（合集）
1. 管理页侧栏「＋ 新建合集」（如「AI漫剧项目」）
2. 详情面板「合集」下拉把相关提示词归入
3. 点击合集进入视图 → ▲▼ 调整流程顺序 → **「⤓ 按序复制」** 输出整套创作脚本

### 备份与迁移
- 管理页「导出」→ 下载 JSON 备份（含全部条目 + 合集）
- 「导入」→ 选择备份文件 → 合并（去重）或覆盖（清空）
- 建议定期导出备份；接近 4MB 容量时管理页会出现黄色预警

---

## 📦 打包分发（.crx）

> ⚠️ **私钥 `key.pem` 存放在项目目录之外**（默认上级 `../prompt-save-goole-plugin.key.pem`）——详见 `KEY_PEM.md`。

1. 打开 `chrome://extensions` → 开发者模式
2. 点「**打包扩展程序**」
3. 「扩展程序根目录」：选择本项目根目录
4. 「**私钥文件**」：手动选择 `..\prompt-save-goole-plugin.key.pem`（项目上级目录）
5. 点「打包」→ 生成 `.crx` + `.pem`（.pem 与你选择的私钥一致）

**验证 ID 一致**：安装 .crx 后，扩展详情页 ID 应与本地加载时相同（由同一 key 派生），此前保存的数据直接可见、无需迁移。

---

## 🧪 测试

```bash
npm test        # 运行全部单元测试（TDD，82 项）
npm run gen:key # 重新生成签名密钥（已存在则跳过，勿轻易执行）
```

---

## 📁 项目结构

```
manifest.json          MV3 配置 + "key" 固定扩展 ID
background.js          service worker：右键菜单/快捷键/选中文本获取
popup/                 快速面板（搜索/筛选/复制）
manage/                完整管理页（侧栏/列表/详情/合集/导入导出）
save/                  保存确认弹窗（类型切换/创作标签）
lib/
  storage.mjs          数据访问层（CRUD/去重/合集/flowText/懒初始化）
  schema.mjs           数据模型校验与迁移
  search.mjs           全文搜索与排序
  export.mjs           导出/导入（两阶段校验）
  copy-smart.mjs       智能复制（文生图三选一/变量填充）
  view-model.mjs       列表视图组装与标记
  templates.mjs        内置创作模板库
  capacity.mjs         容量监控
  util.mjs / save-form.mjs / background-handler.mjs
tests/                 单元测试（node:test，mock chrome API）
scripts/               密钥/图标生成脚本
KEY_PEM.md             ⚠️ 私钥位置备忘（勿遗忘）
```

---

## 🏁 里程碑

- **M0** 脚手架（manifest + 图标 + 固定扩展 ID）
- **M1** 保存闭环（右键 / 快捷键 / 保存弹窗 / 去重）
- **M2** 面板与管理 + 创作增强（合集 / 按序复制 / 文生图 / 变量 / 模板库）
- **M3** 导出/导入完整闭环 + 健壮性（写失败兜底 / 容量预警 / 多标签同步）
- **M4** 打磨 + 双形态打包分发（本版本）

---

## 🔒 隐私与安全

- 零网络请求、无埋点、数据不上传
- 最小权限：`contextMenus` / `storage` / `clipboardWrite` / `scripting` + `activeTab`（无 `host_permissions`）
- 导入严格校验（两阶段）、所有渲染防 XSS、存储写失败重试兜底