可以使用的功能
- Mac 小猫浮窗、拖动、收起、菜单栏和快捷键。
- 原录音播放、重听、慢速、按需字幕与已有假名。
- 确认后自动播放下一段的可选设置。
- 独立教材包的导入、切换、移除，整本及每课自评进度。
- 三本《いろどり》配套教材下载、公开源码与开发文档。
MIMI / DEVELOPER NOTES
认识 mimi
mimi 是一只留在 Mac 桌面上的日语精听小猫。有空时听一段原音，听不懂再看字幕，理解后点一下对号。它面向想利用短暂间隙练习听力的人。
正在用手机？你可以在这里看演示、了解进度和阅读文档。挂件本身需要 Mac 安装；目前没有 iPhone、Android 或网页版播放器。
OVERVIEW
一次很短的精听练习
打开小猫不会立刻发声。等你准备好，再播放一段教材原音。原文默认隐藏，避免一开始就变成阅读练习；需要时可以看日文、已有翻译和提示，或再听一遍。
安静地待着
收起时只有小猫头。可以拖动位置，不占用一个完整学习窗口。
帮助按需出现
重听、慢速、字幕都由你决定。有注音的词语在悬停或聚焦后显示读音。
记录自己的理解
记录无提示或借助提示的理解，查看整本与每课进度。自评不是客观掌握证明。
工具与教材分开：先安装 mimi，再选择教材。已下载的录音可离线播放，学习记录留在本机。
WALKTHROUGH
它实际长什么样？
以下使用当前播放器界面和演示数据展示流程，不包含任何人的真实学习记录。图片为浏览器渲染；Mac 原生磨砂效果会随桌面背景变化。点击图片可放大查看。
收起，不打扰
拖动只改变位置；点击才展开，也不会自动播放。
先用耳朵听
手动点击播放。默认看不到原文，可先判断自己是否理解。
需要时再看提示
看过提示后的理解会单独记录。不是每段都有原文，缺失时会明确说明。
知道自己练到哪里
按教材和课查看进度。同一音轨重复练习不会重复增加完成数。
PROJECT STATUS · 2026-09-11
现在能做什么？
这是本次更新时的项目状态，不是自动同步的实时看板。
已有方向，尚未上线
- “已熟练”手动标记：不再自动出现，并可恢复。
- LLM / TTS 生成自制教材。当前只预留格式，没有调用服务。
- 应用内浏览云端教材并下载；现在需要从网站手动下载、解压和导入。
使用范围
没有手机 App、网页版精听播放器或云端学习记录同步。没有通过自评证明“已掌握”的自动判断。不是每段都有字幕、中文翻译或分段时间轴。
Apple 签名与发行进度
| 项目 | 当前状态 |
|---|---|
| 本地准备的正式签名包 | 已使用 Developer ID 签名，启用 Hardened Runtime，并通过签名校验。 |
| Apple 公证 | 已暂停，尚未提交。没有公证票据，不能称为“已公证”。 |
| 网站 / GitHub 当前下载包 | 仍为 0.1.0 临时签名预览版；没有替换为本地正式签名包，也没有公证。 |
| 支持环境 | 预编译版：Apple Silicon、macOS 13+。Intel 源码构建尚未完成实机验证。 |
01 / GETTING STARTED
一个浮窗，按需展开
| 操作 | 结果 |
|---|---|
| 拖动小猫 | 只移动位置，保持收起。 |
| 点击小猫 | 展开播放器，等待手动播放。 |
| 打开字幕 | 查看原文和已有提示；假名在悬停或聚焦后出现。 |
| 点击对号 | 记录本次自评。可在设置里开启自动播放下一段。 |
| 更多 → 教材库 | 导入、切换教材，查看整本及每课的学习进度。 |
无提示理解与借助提示理解分别记录。重复练习不重复增加完成数；播放、跳过和关闭不算完成。
02 / ARCHITECTURE
工具、教材、学习记录
工具
Swift / AppKit 管理透明浮窗、菜单栏与本地音频；WebKit 承载交互。
教材包
JSON 描述文本、可选注音和时间轴；录音作为独立文件存放。
学习记录
本地保存，以教材、音轨和内容修订编号关联。移除教材仍保留记录。
导入教材包→校验文件与音频→离线练习→保存自评
03 / DOWNLOADS
安装工具，选择教材
mimi 0.1.0 macOS 13+
Apple Silicon 预编译版，工具本身不含课程。Intel Mac 可尝试源码构建，尚未完成实机验证。
早期版本采用本地临时签名，尚未经过 Apple 公证。其他 Mac 可能提示无法验证开发者；开发者可按文档从源码构建。
《いろどり》配套学习包
全部免费。下载 ZIP 后先解压，在 mimi 的“教材库”导入 .mimipack 文件夹或其中的 manifest.json。尚不支持应用内直接下载。
18 课 · 460 段
いろどり 入门
191 段带已有听力稿
197.4 MB · ZIP
SHA-256
d5cf6e972daea2054369257cab221502c43e9e566135819b46dbaaa51a0d05c818 课 · 326 段
いろどり 初级 1
135 段带已有听力稿
127.3 MB · ZIP
SHA-256
170325c412796a0d4c24c1bee8ed8f4f641269d360102b115c78bf91a6faa66018 课 · 338 段
いろどり 初级 2
122 段带已有听力稿
201.4 MB · ZIP
SHA-256
9e1e40df93d2db9546f06c209619ca64ad3760048c53a9bf0cb3cdde25cc53dd共有 1,124 段原始录音，其中 448 段附有已有听力稿。没有听力稿的音轨显示“暂无原文”；不填入猜测字幕，也不回退系统语音。
原始录音与听力稿：© The Japan Foundation 及其他权利人。学习包为非官方的《いろどり》配套整理，部分中文提示为 mimi 补充。教材不适用工具的 MIT 许可。请遵循原教材使用指引；也可前往官方教材网站。
04 / CONTENT FORMAT
教材包协议 v1
一个普通文件夹，包含描述文件和真实音频。格式面向人工整理和未来的 AI 生成流程，播放器不依赖内容的生成方式。
my-course.mimipack/
├── manifest.json
└── audio/
└── request-01.mp3| 字段 | 用途 |
|---|---|
id / version | 教材身份与整包版本。 |
lessons[].id / contentRevision | 稳定音轨身份与内容修订，关联学习记录。 |
text | 日文、可选注音、翻译与提示。 |
audio | 本地路径、SHA-256、实际时长。 |
segments | 可选分段时间轴；没有可靠对齐则省略。 |
transcriptStatus | available 或 missing，缺少原文须明确标注。 |
generation | 可选 LLM/TTS 来源、声线及审核状态。 |
导入会检查路径、散列、音频可读性、注音一致性和时间轴。每包最多 2,000 段、500 MB，单段音频最多 50 MB。内容包不包含脚本或可执行页面。
05 / DEVELOPMENT
参与开发
需要 macOS 13+ 和 Xcode Command Line Tools。克隆仓库后运行构建脚本；应用会使用本机已有教材目录。
git clone https://github.com/heminghaoa/mimi.git
cd mimi
zsh "启动 Mimi.command"
# 进度统计测试（需要 Node.js）
node tests/progress.cjs仓库提供合成测试音，不把真实课程作为测试依赖。对播放器的修改应在实际 Mac 上检查；编译通过不代表音频设备、窗口焦点及多屏行为已验证。
06 / CHANGELOG
开发记录
2026-09-11 · 项目全貌与发行状态补充
- 补充面向手机访客的产品介绍、界面演示、功能状态与常见问题。
- 本地 Developer ID 签名准备完成；Apple 公证暂停，公开下载包暂未更换。
- 明确区分已实现、计划中和当前不支持的能力。
2026-09-11 · 0.1.0 / 教材与工具分离
- 教材库支持导入、切换和移除，进度按整本及每课显示。
- 整理入门、初级 1、初级 2 三本音频教材，保留缺失原文状态。
- 修正小猫拖动与点击：拖动只移动，点击只展开。
- 新增公开源码、开发文档、独立工具和课程下载。
2026-09-10 · 从小测改为精听播放器
- 去掉三句中文答案，采用重听、提示、自评三个入口。
- 缩小浮窗，增加磨砂背景，收起后只保留小猫。
- 接入原始录音，隐藏默认假名；确认后自动播放由设置控制。
开发记录随代码变更更新；详细历史见 GitHub 提交记录。
07 / NEXT
已讨论，尚未实现
| 方向 | 约定 |
|---|---|
| 已熟练标记 | 手动退出常规播放与复习，可在进度页恢复；不会自动判定掌握。 |
| LLM + TTS 教材制作 | 生成草稿、校对、生成录音，最后导出同一教材包格式。 |
| 云端教材目录 | 应用内选择下载。当前网站提供手动下载，格式预留已存在。 |
| 正式桌面发行 | Developer ID 签名、公证、更多设备和多屏测试。 |
以上为设计方向，不代表已上线，也没有承诺发布日期。
QUESTIONS
朋友最可能想知道的事
我只有手机，可以用吗？
可以用手机浏览这个网站、查看演示、阅读文档和访问 GitHub。mimi 挂件需要 macOS，不能在手机桌面运行。课程 ZIP 也需要在 Mac 上解压并导入后使用。
需要付费、注册账号或者一直联网吗？
当前工具开源，网站上的配套教材免费下载。mimi 不要求账号，已下载教材可离线播放，记录保存在本机。下载课程需要网络；未来 AI 功能尚未接入，也未确定费用方案。
三本教材包含什么？
入门 460 段、初级 1 326 段、初级 2 338 段，共 1,124 段原始录音。448 段附有现有听力稿，其余标明“暂无原文”。这些是《いろどり》的非官方配套学习包，版权仍属于原权利人。
点击对号，是不是就算学会了？
对号只是你对本次理解的自评。系统区分无提示与借助提示的理解，用于记录和安排复习；它不是考试成绩，也不能证明整体会话能力。“特别熟练后不再出现”目前还没有实现。
这里会展示我的学习记录吗？
不会。网站介绍产品和公开开发状态，不连接个人的本地进度文件。这里的进度图使用专门的演示数据。
哪里可以反馈问题或查看开发细节？
可以在 GitHub Issues 反馈问题，或继续阅读本站的架构、教材格式与开发记录。源码按 MIT 开源，教材不适用 MIT 许可。