InkDiary

KO | EN

gitlite — search

#python #react #ai #macos #nodejs #java #windows #cli #awesome-list #security #mcp #ios #openai #open-source

(★ 20)

Handwritten AI diary for iPad — Tom Riddle-style magic journal with sketch generation

InkDiary Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 墨迹日记 (InkDiary)

复刻 reMarkable「魔法日记」手写 AI Demo 的 iPad/iPhone 原生应用。

在纸面上用 Apple Pencil 手写提问或说「画一只狗」——停笔约 2 秒后笔迹淡出，AI 以花体文字或简笔彩绘在纸上浮现回信。人格灵感来自《哈利·波特》中汤姆·里德尔的日记。

![Platform](https://img.shields.io/badge/platform-iOS%20%7C%20iPadOS%2017%2B-blue)
![Swift](https://img.shields.io/badge/Swift-5.9-orange)
![License](https://img.shields.io/badge/license-MIT-green)

## Demo

[![Demo poster](https://raw.githubusercontent.com/andyhuo520/InkDiary/main/docs/demo-poster.jpg)](./docs/demo.mp4)

[▶ 观看完整演示视频](./docs/demo.mp4)（iPad 真机：手写问答 + 绘图回复）

## 功能

- **手写问答** — PencilKit 纸面书写，停笔自动提交，多模态 LLM 识别 + 回答
- **语言镜像** — 写什么语言，回信用什么语言（英文/中文/日文等）
- **绘图回复** — 手写「画一只猫」等指令，APIMart 生成简笔/彩绘并淡入纸面
- **花体浮现** — 文字回信逐字「洇」出；中文自动切换龙藏体/马善政体
- **长期记忆** — 跨会话记住书写者，设置页可查看/清空
- **真实纸感** — 程序化纸张纹理、颗粒与暗角

## 演示流程

```
书写 → 停笔 2s → 笔迹淡出 → 文字/图像回信浮现 → 轻点继续
```

## 快速开始

### 依赖

- Xcode 16+
- [XcodeGen](https://github.com/yonaskolb/XcodeGen)

### 构建

```bash
git clone https://github.com/andyhuo520/InkDiary.git
cd InkDiary
xcodegen generate
open InkDiary.xcodeproj
```

真机调试：在 Xcode → Signing & Capabilities 中选择你的 Team。

### API 配置

长按屏幕**左上角**约 1 秒打开设置。

**对话模型**（OpenAI 兼容，需支持图片输入）：

| 项 | 示例 |
|---|---|
| Base URL | `https://api.openai.com/v1` 或 `https://openrouter.ai/api/v1` |
| 模型 | `gpt-4o-mini` |
| API Key | 存 Keychain，不会写入仓库 |

**图像生成**（[APIMart](https://docs.apimart.ai/cn)）：

| 项 | 示例 |
|---|---|
| Base URL | `https://api.apimart.ai/v1` |
| 模型 | `gemini-3.1-flash-lite-image`（最便宜，默认） |
| 画风 | 简笔线稿 / 可爱简笔画 / 彩绘水彩 |

## 项目结构

```
InkDiary/
├── App/InkDiaryApp.swift          # 入口
├── Views/
│   ├── DiaryPageView.swift        # 纸面状态机
│   ├── InkCanvas.swift            # PencilKit + 停笔检测
│   ├── HandwrittenReveal.swift    # 花体字浮现
│   ├── SketchReveal.swift         # 绘图淡入
│   └── PaperBackground.swift      # 纸张材质
└── Services/
    ├── LLMClient.swift            # 多模态对话 + 意图识别
    ├── ImageGenClient.swift       # APIMart 异步绘图
    ├── ConversationStore.swift    # 持久化对话与记忆
    └── Persona.swift              # 日记人格
```

## 字体

Bundled fonts under OFL license:

- [Long Cang](https://fonts.google.com/specimen/Long+Cang) — 中文行书
- [Ma Shan Zheng](https://fonts.google.com/specimen/Ma+Shan+Zheng) — 中文毛笔

## 致谢

- 灵感来源：Maxime Rivest 的 reMarkable 魔法日记 Demo
- 图像 API：[APIMart](https://docs.apimart.ai/cn)

## License

MIT — see [LICENSE](LICENSE)

InkDiary

InkDiary Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

InkDiary

InkDiary Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README