@qnroa/qtype 0.0.1

package/templates/zh/README.md

@@ -0,0 +1,64 @@
+# {{name}}
+
+一个由 LLM 维护的 **{{description}}** 打字资料，遵循 [QTYPE 规范](./QTYPE.md)。
+
+> 你选主题、扔材料。LLM Agent 生成结构化的 Markdown 卡片。用户练打字，进度存本地。
+
+## 涉及
+
+<!-- 在这里用嵌套列表定义资料覆盖的一级 / 二级主题。例如：
+
+- **英语**
+  - GRE 词汇：list 1 / list 2 / list 3
+  - 高频句型：条件句 / 虚拟语气
+- **前端**
+  - JavaScript 基础
+  - React Hooks
+
+`TODO.md` 里的"缺失 / 覆盖薄 / 已覆盖"分类由这里决定。
+-->
+
+## 目录
+
+```
+{{name}}/
+├── QTYPE.md          # 写作规范（权威规则）
+├── AGENTS.md         # 软链 → QTYPE.md（qtype init 自动生成）
+├── CLAUDE.md         # 软链 → QTYPE.md（qtype init 自动生成）
+├── GEMINI.md         # 软链 → QTYPE.md（qtype init 自动生成）
+├── README.md         # 本文件（涉及范围由人维护）
+├── TODO.md           # 待补清单（由 Agent 维护）
+├── index.md          # 全库目录
+├── log.md            # 活动日志（追加）
+├── material/            # 资料文件（每个 .md 一个 deck）
+│   └── assets/<slug>/
+├── raw/              # (可选) 原始材料，等 Agent 处理
+│   └── assets/<slug>/
+└── qtype.config.json # 打字/主题/目标速度等配置
+```
+
+## 常用操作（让 LLM 帮你做的）
+
+| 操作 | 触发 | 作用 |
+|---|---|---|
+| ingest    | `ingest <path-or-topic>` | 读材料/生成 → 建/更新 deck → 追加 log |
+| quiz-gen  | `按<主题>生成 <N> 张卡片` | 从主题生成新 deck |
+| update    | `修 <deck-slug> 里的 <字段>` | 修改现有 deck |
+| cascade   | `级联检查` | 修完一个 deck 后同步相关的 |
+| check     | `check`（或直接跑 CLI） | 校验卡片格式 |
+| level-up  | `合并/拆分 <slug>` | 把太小/太大的 deck 重组 |
+
+完整规则见 [QTYPE.md](./QTYPE.md)。
+
+## 你自己跑的 CLI 命令
+
+| 命令 | 作用 |
+|---|---|
+| `qtype check` | 校验卡片格式，**不写文件**，CI 推荐 |
+| `qtype publish build` | 构建静态站到 `dist/` |
+| `qtype publish serve` | 本地预览打字 |
+| `qtype pack` | 打包整个资料为可分享文件 |
+
+## 打字设置
+
+`qtype.config.json` 里可配：主题、hint、目标速度、Tab 键行为等。首次运行会自动生成默认值。

package/templates/zh/TODO.md

@@ -0,0 +1,7 @@
+# TODO
+
+这里是待补充的资料主题清单，由 Agent 通过操作维护，也可以由人自己写。
+
+- [ ] 缺失
+- [ ] 覆盖薄
+- [x] 已覆盖

package/templates/zh/index.md

@@ -0,0 +1,7 @@
+# 全库目录
+
+<!-- 由 Agent 维护。按标签分组列出所有 deck。 -->
+
+## 未分类
+
+(空)

package/templates/zh/log.md

@@ -0,0 +1,3 @@
+# 活动日志
+
+<!-- 只追加，最新在上。每条记录一次 Agent 操作。 -->

package/templates/zh/material/example.md

@@ -0,0 +1,47 @@
+---
+tags: [示例, 入门]
+type: normal
+difficulty: 1
+---
+
+## Q:
+
+一次一句，把它打出来。
+
+## A:
+
+一次一句，把它打出来。
+
+---
+
+---
+tags: [英语, 词汇]
+type: word
+phonetic: /ˌsɪəˈriːəl/
+gloss: 连续的；一系列的
+translation: 表示按顺序发生
+---
+
+## Q:
+
+serial
+
+## A:
+
+serial
+
+---
+
+---
+tags: [英语, 句型]
+type: sentence
+translation: 熟能生巧。
+---
+
+## Q:
+
+Practice makes perfect.
+
+## A:
+
+Practice makes perfect.