pretend1111 / inko-skill

# Inko 手写 Skill
**简体中文 | English**
**1.6.0（2026-10-08）：Lyric 1 / Logic 1 手写推理免费开放。** 网页、API 和 Skill 都不按字收费，没有最低消费，余额为 0 也可生成。
网站内 DeepSeek 助手仅按实际 API 用量计费；本 Skill 的手写接口不调用 DeepSeek，接入 AI 自身的模型费用由其服务商收取。
每个用户另有 **1 个免费专属字迹席位**。旧版请重新安装，避免 AI 沿用旧收费规则。
**1.5.0（2026-10-06）：skill 不再抄写「模型能写什么」。** 正文里各模型能写哪些不常见的字（希腊字母、拼音声调、上下标、`½`、罗马数字、`⑪`、`「」`、`°` …）
和 Logic 公式能用哪些 LaTeX 命令，改为从服务器实时读取——新命令 `inko.py charset` 和 `inko.py models --symbols`——模型学会新字，skill 不用更新也是对的；
网站上的排版助手从同一处取。`doctor`、`models`、`charset` 发现有更新版 skill 时会提示。同一天模型学会了 33 个希腊字母、拼音声调、上下标、`½`、罗马数字、`⑪`–`⑳` 等。
**1.4.0（2026-10-05）：跟进网站上的排版助手。** 英文手写重新训练过；长公式在等号 / 加减号处折行，不再整条缩小，生成的公式
和文字一样大；Logic 可以单独设常用字迹（`default-style 编号 --model logic-1`）；补上「哪些字写不了、怎么问用户」的说明；
数学题不再为模型 / 字迹是否兼容停下来问；新增 `inko.py delivered`（API 的交付确认）；去掉显式标识只需签署协议。
**1.3.0：只产出标准二维平面图片与 PDF。** 已移除拍照拟真、桌面场景、透视、纸张卷曲、扫描/复印效果和照片贴字功能。
用 Inko 将笔记、书信、作文、数学解答写成自然笔迹的平面页面：
- 标准 PNG 图片与 PDF，白纸、米黄纸、方格纸、横线纸、作文纸、田字格
- 自定义排版、标题、文本框与行距
- 修改墨色、笔型、粗细和字间距，保留可编辑笔迹包
- 可以读取题目照片作为输入，但结果只交付独立的平面答题页
> 「把这三道数学题写成横线纸上的手写解答，给我 PNG 和 PDF」
> 「把 notes.md 写成方格纸笔记，用蓝色圆珠笔」
> 「把这封信写在米黄色纸上，输出标准图片」
Logic 仍沿用 1.2.1 的最新符号规则：`\eta` 写成 n，`\wedge` / `\vee` 支持；详见数学说明。
## 怎么用（给用户）
1. 在 **https://inkotype.com** → 账户 → API key 创建一个 key。建议给 AI 单独建一个，并设置每日花费上限。
2. 把这个仓库链接和 key 发给你的 AI 助手，比如：
 「帮我安装这个手写 skill：https://github.com/pretend1111/inko-skill ，我的 Inko API key 是 ink_live_…」
3. 直接提要求。Lyric / Logic 手写推理免费，无需充值。AI 会先校验字符与排版，报价为 0 后按你的要求生成，不再反复询问付费确认。
 新注册用户一次性赠送 ¥0.10 的 DeepSeek 体验额度，与免费手写推理分开；实际余额以账户接口为准。
4. 可选：在网站的字迹库里设一款**常用字迹**、收藏几款喜欢的。之后 AI 默认用你的常用字迹写，除非你另外指定；需要它来挑时，先从你的收藏里挑。跟它说「以后都用这个字迹」，它会帮你把常用字迹改过去。
5. 可选：用**你自己的字**（专属字迹）。每个用户有且仅有 1 个免费席位，包含 2 次训练。在网站上录入字样后，AI 就能用它来写（Lyric 1）。
## 给 AI 助手：安装步骤
在用户的项目目录里执行。不要把 API key 回显给用户，也不要把它写进项目文件或提交记录。
1. **下载**（放在临时目录即可）：
 [code] 
 没有 git：下载并解压 `https://github.com/pretend1111/inko-skill/archive/refs/heads/main.zip`。
2. **安装**（需要 Python 3.9+；缺 Pillow / numpy 时会自动 pip 安装）：
 [code] 
 它会识别你是哪种 AI 助手，把 `inko-handwriting/` 复制到 `.claude/skills/`（Claude Code）或 `.agents/skills/`
 （Codex、Cursor、GitHub Copilot、Gemini CLI、OpenCode、goose、Amp）；可用 `--agent claude|agents|both` 指定。
 输出 JSON，含 `installed_to` 和下一步。之后可以删掉 `inko-skill-src`。
3. **保存 key**（从标准输入传入，不出现在命令参数里）：
 [code] 
 PowerShell：`'ink_live_…' | python \scripts\inko.py auth`。key 会先经 API 验证，再存到用户配置目录
 （`~/.config/inko/key`，Windows 为 `%APPDATA%\inko\key`）；加 `--project` 则存到 `./.inko/key`（已自动 git 忽略）。
 用户也可以自己设置环境变量 `INKO_API_KEY`。
4. **自检**：`python /scripts/inko.py doctor`，看到 `"ok": true`、key 有效、余额。
5. **开始**：现在就读 ` /SKILL.md` 并照做——有的助手要重开会话才会列出新 Skill，但你不必等。
 告诉用户已装好、key 存在哪里，并建议在网站上给这个 key 设每日花费上限。
以后更新：重复第 1–2 步即可（覆盖安装的副本，不动 key）。
## 里面有什么
| 文件 | 作用 |
|---|---|
| `SKILL.md`、`references/` | 标准平面输出流程、数学符号、排版、字迹、API 与排错 |
| `scripts/inko.py` | 自检、字迹、报价、排版预览、生成与下载 |
| `scripts/scene.py` | 可编辑笔迹包：移动、间距、笔型、浏览器编辑器、平面导出 |
| `scripts/ink.py` | 修改墨色、粗细、深浅，提取透明手写层 |
| `scripts/paper.py make` | 绘制标准二维纸张背景，不识别或处理照片 |
| `scripts/compose.py drift` | 可选的二维行位置微调，不改变纸张几何 |
| `scripts/pdf.py` | 平面图片合成 PDF |
图