PuzzleTide Puzzle Generator

PuzzleTide CLI — generator pencarian kata, teka-teki silang & sudoku

Generator pencarian kata, generator teka-teki silang, dan generator + pemecah sudoku dalam satu generator puzzle CLI yang mengutamakan lokal — dengan lembar kerja PDF yang dapat dicetak, bank kata awal, evaluasi LLM yang dapat diverifikasi, dan keterampilan agen yang dibundel. Dari pembuat puzzletide.com.

Instalasi

npm install -g puzzletide
ptide --version

Paket ini menginstal kedua biner:

• ptide
• puzzletide

Mengapa menghasilkan puzzle dengan CLI

Minta model bahasa untuk menulis pencarian kata dan Anda akan mendapatkan kisi di mana setengah katanya rusak; minta sudoku dan Anda biasanya mendapatkan satu dengan beberapa solusi, atau tidak ada sama sekali. Kisi adalah jenis keluaran yang buruk bagi LLM dan baik bagi kode deterministik.

PuzzleTide CLI adalah kode deterministik itu:

• Setiap kata pencarian kata ditempatkan dan dapat diverifikasi — koordinat penempatan adalah bagian dari keluaran, dan generator diuji propertinya.
• Setiap sudoku yang dihasilkan diperiksa untuk memastikan hanya memiliki satu solusi.
• Setiap teka-teki silang divalidasi terhadap petunjuknya sendiri sebelum dikembalikan.
• --seed yang sama masuk, puzzle yang sama keluar, di mesin mana pun.

Paket ini juga menyertakan keterampilan agen SKILL.md, sehingga agen pengkodean (sistem berbasis Pi, Hermes, OpenClaw, dan SKILL.md lainnya) menggunakan CLI alih-alih menulis kisi secara manual.

Model perintah

ptide <namespace> <operation> [input] [options]   # for humans
ptide run <tool-id> [input] [options] --json      # canonical, for scripts/agents
ptide tools list | search <q> | info <id> | docs <id>
ptide agent manifest

Gunakan perintah pendek secara interaktif dan id alat kanonis dalam otomatisasi:

ptide sudoku generate --difficulty hard
ptide run puzzle.sudoku.generate --difficulty hard --json

Generator pencarian kata

Delapan arah penempatan dengan preset mudah/sedang/sulit, kisi berukuran otomatis (6–30), normalisasi aksen/spasi/tanda hubung. Kata berasal dari flag, file, atau tema yang dibundel:

# Word search from your own words, printed in the terminal
ptide wordsearch generate --words "coral,shark,kelp,wave,tide"

# Themed printable word search (puzzle page + solution page)
ptide wordsearch generate --theme animals/ocean-animals --pdf ocean.pdf

# Kids mode: easy = forward-only words
ptide wordsearch generate --theme seasonal/halloween --difficulty easy

Generator teka-teki silang

Penempatan saling terkait dengan penomoran teka-teki silang standar, validasi petunjuk-kisi, dan petunjuk fallback deterministik untuk kata tema. Kata yang tidak dapat saling terkait dilaporkan alih-alih dihilangkan secara diam-diam:

# Crossword with your clues
ptide crossword generate --words "PARIS: Capital of France; TOKYO: Capital of Japan"

# From a JSON file, as a printable PDF
ptide crossword generate --file words.json --pdf review.pdf --title "Unit 4 Review"

Generator dan pemecah sudoku

Sudoku mudah, sedang, sulit, dan ahli (17–21 angka diberikan) dengan jaminan keunikan, pemecah instan, dan validator yang melaporkan konflik, kemampuan dipecahkan, dan keunikan solusi:

ptide sudoku generate --difficulty expert --seed 42
ptide sudoku solve "53..7....6..195....98....6.8...6...34..8.3..17...2...6.6....28....419..5....8..79"
ptide sudoku validate --file puzzle.txt
ptide daily        # today's daily sudoku, same for everyone on a given UTC day

Puzzle yang dapat dicetak: lembar kerja PDF dan SVG

Setiap generator menerima --pdf <file> untuk lembar kerja siap cetak — halaman puzzle ditambah halaman solusi (--paper letter|a4, hilangkan kunci jawaban dengan --no-solution-page) — dan --svg <file> untuk gambar vektor. Lembar pencarian kata yang dapat dicetak dan lembar sudoku yang dapat dicetak untuk paket kelas hanya berjarak satu loop:

for i in 1 2 3 4 5; do
  ptide sudoku generate --difficulty medium --seed "$i" --pdf "sudoku-$i.pdf" --title "Sudoku #$i"
done

Lebih suka lembar siap pakai? Pencarian kata misteri dan pembunuhan yang dapat dicetak adalah favorit pembaca, dengan ratusan lainnya di puzzle yang dapat dicetak.

Bank kata dan alat kata

30 tema awal (hewan laut, buah-buahan, luar angkasa, halloween, ...) — telusuri, cari, cocokkan pola, anagram, pilihan acak. Bawa daftar Anda sendiri melalui --words/--file, atau mainkan koleksi lengkap yang dikurasi di puzzletide.com:

ptide words themes --search dinosaur
ptide words match "c_r_l"        # crossword-style pattern matching
ptide words anagram coral

Ada juga permainan hangman di terminal: ptide play hangman.

Keterampilan agen

Pi dapat memuat keterampilan yang dibundel langsung dari paket npm ini:

pi install npm:puzzletide

Manifes paket mendeklarasikan:

{
  "pi": {
    "skills": ["./skills"]
  }
}

Lima keterampilan disertakan: pencarian kata, teka-teki silang, sudoku, puzzle yang dapat dicetak, dan evaluasi agen. Masing-masing lebih memilih CLI lokal dan memeriksa ptide, puzzletide, lalu npx puzzletide. Keterampilan tidak pernah menginstal otomatis apa pun; agen harus bertanya kepada pengguna sebelum menginstal.

Server MCP untuk Claude Desktop, Cursor, dan klien MCP apa pun

Paket pendamping puzzletide-mcp mengekspos setiap alat non-interaktif melalui Model Context Protocol — generator pencarian kata, generator teka-teki silang, generator/pemecah sudoku, alat kata, dan evaluasi yang sama, dapat dipanggil dari Claude Desktop, Cursor, Windsurf, atau klien MCP apa pun:

{
  "mcpServers": {
    "puzzletide": {
      "command": "npx",
      "args": ["-y", "puzzletide-mcp"]
    }
  }
}

Lihat docs/mcp.md untuk nama alat, argumen, dan pengaturan per klien.

Alat

Server MCP (dan ptide run <tool-id>) mengekspos 15 alat:

• puzzle_wordsearch_generate: Hasilkan kisi pencarian kata dari kata kustom, file, atau bank kata bertema — setiap penempatan dapat diverifikasi, dapat dicetak melalui PDF/SVG.
• puzzle_crossword_generate: Hasilkan teka-teki silang yang saling terkait dengan penomoran standar dan petunjuk yang divalidasi.
• puzzle_sudoku_generate: Hasilkan sudoku mudah, sedang, sulit, atau ahli dengan jaminan solusi unik.
• puzzle_sudoku_solve: Pecahkan sudoku dari string 81 karakternya dan laporkan apakah solusinya unik.
• puzzle_sudoku_validate: Validasi kisi sudoku — konflik, kemampuan dipecahkan, dan keunikan solusi.
• words_categories: Daftar kategori bank kata.
• words_themes: Daftar atau cari daftar kata bertema yang dibundel.
• words_list: Daftar kata dalam tema, difilter berdasarkan panjang atau jumlah.
• words_match: Temukan kata yang cocok dengan pola gaya teka-teki silang (c_r_l).
• words_anagram: Temukan anagram dari huruf yang diberikan di bank kata.
• words_random: Pilih kata acak, opsional dari satu tema.
• words_stats: Statistik bank kata.
• eval_generate: Hasilkan tugas puzzle yang dapat direproduksi dan dinilai secara objektif untuk benchmarking LLM dan agen.
• eval_check: Nilai jawaban untuk tugas evaluasi yang dihasilkan berdasarkan konstruksi — tidak ada kunci jawaban yang dipercaya.
• play_daily: Cetak sudoku harian hari ini (sama untuk semua orang pada hari UTC).

Evaluasi LLM yang dapat diverifikasi

Jawaban puzzle dapat diperiksa tanpa kunci jawaban: jawaban sudoku memenuhi aturan dan mempertahankan angka yang diberikan atau tidak; jawaban pencarian kata mengeja kata di sepanjang garis lurus dalam kisi atau tidak. Itu menjadikan puzzle sebagai tugas benchmark yang bersih untuk evaluasi LLM — tidak diperlukan juri LLM:

ptide eval generate --type sudoku --n 20 --difficulty hard --seed 1 --out tasks.json
# ...run your model on tasks.json, collect [{id, answer}] ...
ptide eval check --tasks tasks.json --answers answers.json --json

Tuple (tipe, kesulitan, n, seed) sepenuhnya menentukan set tugas, sehingga menamai benchmark yang dapat direproduksi.

Penggunaan pustaka

Mesinnya adalah TypeScript yang dapat diimpor tanpa melibatkan CLI:

import { generateSudoku, generateWordSearch, wordSearchPdf } from 'puzzletide';

const sudoku = generateSudoku({ difficulty: 'hard', seed: 42 });
const search = generateWordSearch({
  words: ['coral', 'shark', 'kelp'],
  directions: ['E', 'S', 'SE'],
  seed: 7,
});
const pdfBytes = await wordSearchPdf(search, { title: 'Ocean Animals' });

Dokumen lainnya:

• Perintah CLI
• Registri alat
• Keterampilan agen

Versi online

Lebih suka browser?

• PuzzleTide pencarian kata
• PuzzleTide teka-teki silang
• PuzzleTide sudoku
• PuzzleTide hangman
• Puzzle yang dapat dicetak
• Buat puzzle Anda sendiri
• Font dan pengaturan pencarian kata ramah disleksia

Privasi

Semuanya berjalan secara lokal. Tanpa akun, tanpa kunci API, tanpa telemetri, tanpa akses jaringan.

Pengembangan

npm install
npm run build     # tsc → dist/
npm test          # vitest + fast-check property tests (build first: CLI tests run dist/)

Bank kata awal adalah daftar generik dan orisinal yang ditulis untuk paket ini (scripts/wordbanks-source.json, dikompilasi dengan npm run build:wordbanks). Kontribusi tema dipersilakan — tambahkan entri ke file sumber dan jalankan build. Koleksi bank kata PuzzleTide lengkap yang dikurasi adalah hak milik puzzletide.com dan bukan bagian dari repositori ini.

Mengutip PuzzleTide CLI

Jika Anda menggunakan PuzzleTide CLI dalam pekerjaan Anda — misalnya evaluasi puzzle yang dapat diverifikasi dalam benchmark model — harap kutip (atau gunakan tombol "Cite this repository" GitHub):

@software{puzzletide_cli,
  author  = {{Caravaca Labs}},
  title   = {PuzzleTide CLI: word search, crossword \& sudoku generator with verifiable LLM evals},
  year    = {2026},
  url     = {https://github.com/Caravaca-Labs/puzzletide-cli},
  note    = {From the makers of \url{https://puzzletide.com}}
}

Teks biasa: "PuzzleTide CLI (Caravaca Labs, 2026), https://github.com/Caravaca-Labs/puzzletide-cli — dari pembuat https://puzzletide.com."

Lisensi

MIT © Caravaca Labs