# magic-pen

**Repository Path**: f4_/magic-pen

## Basic Information

- **Project Name**: magic-pen
- **Description**: 乾坤袋在任意网页上帮你总结、抓取、标注、朗读、截图，并把读过的内容整理成 PPT。 不用配置，装上就能用。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://leixiangjian.github.io/magic-pen/
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🖋️ 乾坤袋

> **一句话：** 在任意网页上总结、抓取、标注、朗读、截图，并把读过的内容生成 PPT。
>
> **许可证：** 本项目采用PolyForm Noncommercial 1.0.0 许可证，禁止商业用途。详见 [LICENSE](LICENSE)。
>
> [项目介绍页](index.html) · [隐私政策](privacy.html) · [安装说明](#使用)

![乾坤袋](assets/hero.png)

## 它帮你解决什么

- **读得快**：总结、抓取、中文解析，把正文和重点从导航、广告里拎出来。
- **记得住**：标注、备注、拼音、朗读，把看过的东西变成能复习、能引用的笔记。
- **带得走**：Markdown、PNG、PPT，直接进入你的笔记、汇报和下一次分享。

乾坤袋是一个装进浏览器的阅读与效率工具。点击右下角图标，从 **11 件法器 + 13 件工具**里选一件，再点向网页。

**零配置、装上即用。** 不需要 Token，不需要接口地址，不需要技能 ID。

## 十一件法器

### 视觉系

| 法器 | 效果 |
| --- | --- |
| 🌠 星陨杖 | 流星雨自天而降，星光在点击处炸裂 |
| ⚡ 雷霆之矛 | 锯齿闪电劈落，全屏闪光 + 震屏 |
| ❄️ 霜华之刃 | 冰晶从指尖生长，目标被冰封 |
| 🔥 炎龙之息 | 火焰喷涌、余烬上升，目标被灼烧 |
| 🕳️ 虚空之喉 | 目标被吸入虚空漩涡，化作尘埃 |
| 🌈 棱彩之镜 | 整页披上流动的幻彩滤镜 |
| 🌪️ 风卷残云 | 狂风盘旋成涡，吹得目标摇晃 |
| 💧 潮汐之握 | 潮水漫过目标，留下湿漉漉的蓝 |
| 🌙 月蚀 | 月影吞光，目标沉入暗夜 |

### 禁术系

| 法器 | 能力 |
| --- | --- |
| 🎨 网页风格转变 | 打开风格面板，一键把整页变成星陨 / 雷霆 / 霜华 / 炎龙 / 虚空 / 棱彩 / 风 / 潮汐 / 月蚀等 13 套气质 |
| ⏳ 时间凝滞 | 暂停页面 CSS 动画、过渡和音视频 |

## 十三件实用工具

| 工具 | 能力 |
| --- | --- |
| 📝 内容总结 | 点一段正文，提炼 3-5 条要点；优先浏览器内置总结模型，失败回退本地摘要 |
| 📋 内容抓取 | 把区域转成 Markdown，支持复制、下载 `.md` |
| 🖼️ 图片获取 | 收集图片，勾选批量下载；点缩略图在新标签打开原图 |
| 📸 区域截图 | 拖拽框选，保存 PNG；右上角 ✕ 或 Esc 取消，下载走扩展后台 |
| ✏️ 文字改写 | 点网页文字直接编辑，完成 / 取消，可撤销 |
| 🐱 萌宠变形 | 给人物 / 图片叠加猫、狗、兔、熊猫耳朵与胡须 |
| 🧠 过目不忘 | 自动记住看过的网页正文，勾选后生成真正的 `.pptx` |
| 🈶 中文解析 | 拼音、声调、词语、关键词、成语统计，支持朗读 |
| 🔊 指哪读哪 | 点哪段读哪段，逐句朗读、暂停、上一句 / 下一句、变速 |
| 🧩 网页解剖 | 识别框架 / CMS / 统计工具，输出 DOM 结构、地标与可改进项 |
| 🫀 活化术 | 让静态人物 / 图片轻轻呼吸、摆动、发光（本地 CSS 活化，不是 AI 视频） |
| 🖍️ 标注留痕 | 选中文字标注、写备注、跨页面留痕，可随时回到原文 |
| 🌐 译语 | 点英文区域，原地翻译成中文；优先浏览器内置翻译，缺失时走备用接口 |

## 使用

1. 打开 `chrome://extensions/`，开启「开发者模式」，加载本项目文件夹。
2. 刷新任意网页，右下角出现发光的乾坤袋图标。
3. 点击右下角图标（或工具栏扩展图标）→ 乾坤袋展开，顶部可在「工具 / 法器」两个页签之间切换。
4. 选择法器或工具（点击卡片，或按 `1`-`9`），然后点击网页区域。

### 网页风格转变

- 选「网页风格转变」→ 点页面 → 打开风格面板。
- 13 套风格：星陨之夜、雷霆高塔、霜华极地、炎龙熔炉、虚空深渊、棱彩幻境、风卷残云、潮汐之握、月蚀、暗夜、赛博霓虹、羊皮古卷、矩阵。
- 点任意风格立即预览，水墙 + 粒子过渡；可「随机一种」或「恢复原样」。
- 风格使用页面滤镜 + 轻量色彩层，不改动网页 DOM，原件不受影响。

### 截图

- 点「区域截图」→ 点页面 → 拖拽框选。
- 右上角 **✕** 或 **Esc** 取消。
- 截好后点「💾 下载 PNG」，通过扩展后台下载，默认保存到浏览器下载目录。

### 过目不忘

- 浏览网页时自动把正文保存在本地（每页最多 12 万字，最多 200 页）。
- 点工具 → 打开「阅读记忆」页 → 勾选页面 → 「生成 PPT」。
- 生成 16:9 `.pptx`：封面 + 每页一张要点卡 + 最后的「带走这些」。
- 一次最多 20 个页面；所有内容只在本地处理。

### 中文解析 / 指哪读哪

- 中文解析：点一段中文，查看拼音、声调、词语、关键词、四字词，可朗读或复制拼音。
- 指哪读哪：点一段文字，底部出现朗读条，逐句朗读；可暂停、跳句、变速，点另一段自动切换。

### 网页解剖

- 点页面任意位置，查看识别到的技术栈、DOM 深度、标题结构、地标数量，以及图片 alt、H1、输入框标签等可改进项。
- 支持一键复制完整报告。

### 活化术

- 点一张人物 / 图片，画面会进入呼吸、轻微摆动、金色光晕和粒子效果。
- 再次选别的图片会切换目标；用乾坤袋「↺ 复原页面」停止。
- 这是本地 CSS 动效，不是 AI 换脸或视频生成。

### 标注留痕

1. 选「标注留痕」，点页面进入标注模式。
2. 用鼠标选中文字 → 在弹出卡片里选颜色、写备注 → 「保存标注」。
3. 高亮会留在页面上；点高亮可查看备注、打开原文或删除。
4. 点左下角「留痕记录」查看所有页面的标注，可「回到原文」或导出 Markdown。
5. 刷新 / 重新打开页面，标注会自动复原；数据只存在本地。

## 关于联网

- 「译语」优先使用 Chrome 内置翻译模型；没有内置模型时才调用 `translate.googleapis.com`，只发送点选区域内的英文。
- 「内容总结」「过目不忘」优先使用浏览器内置总结模型；没有模型时使用本地摘要算法，不联网。
- 「指哪读哪 / 中文解析」使用浏览器 `speechSynthesis` 朗读，是否联网取决于系统语音包。
- 截图、图片下载、文字改写、萌宠变形、标注留痕、网页解剖全部在本地完成。
- 阅读记忆与标注保存在 `chrome.storage.local`，不会上传。

## 权限说明

| 权限 | 用途 |
| --- | --- |
| `storage` | 记住法器、音效、阅读记忆、标注 |
| `scripting` | 扩展安装 / 更新后向旧页面补注入 |
| `activeTab` | 点击工具栏图标时临时访问当前页 |
| `downloads` | 保存图片、截图、PPT |
| `unlimitedStorage` | 保存阅读记忆全文与标注历史 |
| `host_permissions`（`<all_urls>`） | 区域截图读取当前标签页画面；翻译兜底接口 |

## 常见问题

- **点了扩展图标没反应？** 会自动给旧页面补注入；仍无效就刷新页面。`chrome://`、应用商店、PDF 等页面无法注入，图标会闪 `!`。
- **截图下载没反应？** 本版已改走扩展后台下载；若浏览器禁止下载，检查下载权限 / 下载目录。右上角 ✕ 可取消截图框。
- **中文解析没有拼音？** 刷新页面让 `vendor/pinyin-pro.js` 重新注入。
- **朗读没有声音？** 检查系统中文语音包与音量；部分无语音的浏览器会提示不支持。
- **阅读记忆为空？** 正文需超过 250 字，且页面不是 `chrome://` 等受限页面；浏览后稍等 2 秒。
- **PPT 打不开？** 确认下载完整；生成的是标准 `.pptx`，可用 PowerPoint / WPS / Keynote 打开。

## 许可证

**本项目采用PolyForm Noncommercial 1.0.0 许可证，禁止商业用途。**

- 允许：个人学习、研究、实验、爱好项目，以及非商业组织在许可证允许范围内的使用。
- 禁止：任何商业用途，包括但不限于销售、付费分发、商业产品集成、商业服务、以营利为目的的内部使用。
- 商业授权：如需商业使用，必须事先联系作者并获得单独的书面商业授权。
- 完整条款：[LICENSE](LICENSE)
- 官方文本：<https://polyformproject.org/licenses/noncommercial/1.0.0>

## 目录结构

```
manifest.json      扩展清单（MV3）
background.js      图标开袋、补注入、截图、下载、记忆/标注存储
effects.js         Canvas 特效引擎
tools.js           总结 / 抓取 / 图片 / 截图 / 改字 / 萌宠 / 记忆 / 中文 / 朗读 / 解剖 / 活化
annotation.js      标注、高亮、留痕记录、原文回溯
memory-content.js  过目不忘的正文自动采集
memory.html        阅读记忆页
memory.css         阅读记忆页样式
memory.js          摘要与 PptxGenJS 生成
vendor/            pinyin-pro、PptxGenJS
content.js         乾坤袋、法器、撤销
style.css          注入样式（限定作用域）
icons/             16/32/48/128 图标
index.html         项目介绍首页
privacy.html       隐私政策
LICENSE            PolyForm Noncommercial 1.0.0 许可证
```

## 更新日志

见 [CHANGELOG.md](CHANGELOG.md)。