# 灵感胶囊 APK 使用说明

## 产品信息

- 产品名称：灵感胶囊
- 版本号：`1.19`
- 包名：`com.lgjn.inspirationcapsule`
- APK 文件：`LingGanJiaoNang-v1.19-release.apk`
- 最低系统要求：Android `8.0` 及以上
- 推荐联网状态：已联网

## 文件位置

- APK 完整路径：`C:\Users\XYKing\Documents\Codex\2026-04-27\new-chat\LingGanJiaoNang-v1.19-release.apk`
- 产品展示页：`C:\Users\XYKing\Documents\Codex\2026-04-27\new-chat\灵感胶囊-产品展示页.html`

## 产品简介

灵感胶囊是一款围绕“随时记录灵感”设计的安卓应用，支持语音记录、文字输入、AI 提炼、桌面小组件快捷录入，以及通过音量键三击触发的无障碍快速录音流程。

应用的核心目标是：

- 快速接住一闪而过的想法
- 把原始语音或文字整理成更可复用的灵感卡片
- 降低“想到但来不及记”的损失

## 主要功能

### 1. 语音录入

- 在 App 内点击录音按钮开始录音
- 再次点击停止录音
- 录音完成后，应用会将语音转写并调用 AI 进行内容提炼
- 最终生成一条灵感卡片保存到列表中

### 2. 文字录入

- 支持手动输入文字
- 支持直接保存原文
- 支持调用 AI 对输入内容进行提炼整理

### 3. 原文保留

- 语音录入在生成灵感卡片后，会同时保留转写原文
- 便于后续核对、回看完整上下文

### 4. 卡片式浏览

- 灵感内容以卡片形式展示
- 适合快速翻阅与回顾
- 支持在提炼内容与原始转写之间切换查看

### 5. 桌面快捷组件

应用支持两类桌面小组件：

- 录音组件：适合一键开始/停止录音
- 文字输入组件：适合快速输入文字并保存或 AI 提炼

### 6. 音量键三击快捷触发

- 开启无障碍权限后
- 可通过短时间内连续三击音量上键触发录音
- 再连续三击一次可停止录音并进入 AI 处理

这个能力适合锁屏、亮屏或临时不方便打开 App 的场景。

### 7. 悬浮提示与快捷回看

- 录音保存成功后可显示悬浮提示
- 支持悬浮窗相关能力
- 用于提高“录完即确认”的反馈效率

### 8. 回收站/历史管理

- 已保存内容支持历史浏览
- 提供回收站相关页面或逻辑
- 适合误删恢复与历史整理

## 安装步骤

### 方式一：直接安装 APK

1. 将 `LingGanJiaoNang-v1.19-release.apk` 发送到安卓手机。
2. 在手机上打开 APK。
3. 如果系统提示“禁止安装未知来源应用”，先在系统设置中允许当前安装来源。
4. 继续安装。

### 方式二：USB 传输安装

1. 使用数据线连接手机和电脑。
2. 将 APK 复制到手机存储。
3. 在手机文件管理器中找到该 APK。
4. 点击并完成安装。

## 首次使用建议

安装完成后，建议按以下顺序配置：

1. 打开 App，确认基础页面能正常进入。
2. 授予麦克风权限。
3. 如果要使用 AI 提炼，保持网络连接。
4. 如果要使用悬浮提示或悬浮能力，授予悬浮窗权限。
5. 如果要使用音量键三击快捷录音，开启无障碍服务。
6. 如果要实现最快录入，将录音组件或文字组件添加到桌面。

## 权限说明

根据当前项目配置，应用可能会申请以下权限：

- 麦克风权限：用于语音录音
- 网络权限：用于 AI 转写/提炼相关能力
- 悬浮窗权限：用于悬浮提示或悬浮操作
- 前台服务权限：用于后台录音处理
- 震动权限：用于状态反馈
- 无障碍服务权限：用于监听音量上键三击触发录音
- 存储相关权限：用于兼容旧系统的文件访问能力

### 无障碍权限说明

当前项目描述中，无障碍服务的用途是：

- 监听按键事件
- 支持音量上键三击触发录音

从项目声明看，它不是为了读取屏幕内容而设计，而是为了处理快捷键录音场景。

## 典型使用流程

## 场景一：打开 App 后录音

1. 进入灵感胶囊首页。
2. 点击录音按钮开始录音。
3. 说出你的想法。
4. 再次点击停止。
5. 等待语音转写和 AI 提炼完成。
6. 在列表中查看生成的灵感卡片。

## 场景二：通过文字快速记录

1. 打开 App 或桌面文字组件。
2. 输入一段临时想法、标题、句子或方案草稿。
3. 选择直接保存，或者选择 AI 提炼。
4. 保存后到灵感列表查看结果。

## 场景三：桌面小组件录音

1. 将录音组件添加到手机桌面。
2. 点击组件上的录音按钮开始录音。
3. 再点一次停止。
4. 等待处理完成。
5. 返回 App 查看新生成内容。

## 场景四：音量键三击录音

1. 先开启无障碍服务。
2. 连续三击音量上键开始录音。
3. 说完后，再连续三击音量上键停止录音。
4. 等待 AI 处理完成。
5. 回到 App 查看结果。

## 使用建议

- 语音尽量在相对安静的环境中录制，识别效果更稳定。
- 若内容较长，可先讲完再整理，AI 提炼更适合处理成段表达。
- 对于短想法、标题、灵感关键词，推荐直接用文字组件录入。
- 对于需要即时保留上下文的内容，推荐使用语音录入。
- 如果你经常在锁屏或走路时记录，建议开启无障碍三击方案。

## 常见问题

### 1. 无法录音

可能原因：

- 未授予麦克风权限
- 其他 App 正在占用麦克风
- 系统限制后台录音

建议：

- 到系统设置中重新检查麦克风权限
- 关闭占用录音的应用后重试

### 2. 录音后没有生成内容

可能原因：

- 当前网络不可用
- AI 服务请求失败
- 录音文件为空或录制时间过短

建议：

- 先确认联网
- 重新录一条更清晰的语音
- 避免刚开始录音就立刻停止

### 3. 三击音量键没有反应

可能原因：

- 无障碍服务未开启
- 三击节奏过慢
- 手机系统对后台行为有限制

建议：

- 重新确认无障碍服务状态
- 在较短时间内连续三击音量上键
- 尝试先打开 App 再测试一次

### 4. 悬浮提示没有出现

可能原因：

- 未授予悬浮窗权限
- 系统对悬浮窗有限制

建议：

- 到系统设置中开启悬浮窗权限

### 5. 桌面组件无法使用

可能原因：

- 组件未正确添加
- 系统桌面限制了组件刷新或后台行为

建议：

- 删除组件后重新添加
- 检查系统的后台运行限制

## 适用人群

- 需要随时记录想法的个人创作者
- 做内容策划、文案、产品、短视频脚本的人
- 习惯边走边想、边说边记的人
- 希望把“碎片灵感”整理成可执行内容的人

## 版本备注

当前交付的是已打包的 `1.19` APK 文件，用于安装和体验产品能力。

如果后续继续迭代，建议同步维护：

- 版本号
- 更新日志
- 权限说明
- 产品展示页下载入口