galbook
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GALBOOK_BOOK | Yes | Book identifier to play, e.g. 'fog-harbor' (corresponds to --book). | |
| GALBOOK_DATA | Yes | Path to the play-data directory, e.g. 'play-data' (corresponds to --data). | |
| GALBOOK_AGENT | Yes | Agent name used to keep separate progress, e.g. 'alice' (corresponds to --agent). | |
| GALBOOK_BOOKS | Yes | Path to the books directory, e.g. 'books' (corresponds to --books). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Play visual novels like a human: galbook_help first, set galbook_persona, then galbook_new / galbook_next / galbook_choose (always give a reason).
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| galbook_booksA | List playable books (slug, title, engine, routes). / 列出能玩的书 |
| galbook_helpC | How to play like a human (rules and tips). / 玩法说明 |
| galbook_statusC | Where am I in the story, pending choice, recent lines. / 现在玩到哪 |
| galbook_newC | Start a new playthrough. / 新游戏 |
| galbook_nextC | Read the next n lines; stops at a choice or ending. / 往下读 |
| galbook_chooseC | Pick an option at a choice and say why. / 选选项并写理由 |
| galbook_saveC | Save to a slot. / 存档 |
| galbook_loadC | Load a slot (auto is written at every choice). / 读档 |
| galbook_savesC | List save slots. / 存档列表 |
| galbook_rewindC | Go back to the previous choice to choose again. / 回到上个选项 |
| galbook_logC | Backlog of recent lines and choices made. / 回想 |
| galbook_personaB | Set or show your persona; it is shown to you at every choice. / 人设 |
| galbook_galleryC | Collection progress: endings, routes, CG, read ratio. / 收集进度 |
| galbook_profileD | Stats and human-likeness numbers. / 记录 |
| galbook_clickC | Click the screen. / 点一下画面 |
| galbook_lookB | Look at the current screen: the CG, or each character on stage (position + face code), as images. / 看一眼现在的画面 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Most tools are distinct (save/load/saves/rewind are clear), but several pairs overlap: galbook_status vs galbook_log both surface recent lines, galbook_gallery vs galbook_profile both report stats/progress, and galbook_click vs galbook_next both relate to advancing the screen. Descriptions help somewhat but boundaries are not crisp.
All tools use a uniform galbook_ prefix plus a single lowercase token, with no camelCase/snake_case mixing, so the pattern is highly predictable. It is not a strict verb_noun scheme (mixing verbs like choose/click with nouns like books/saves/status), but the style is consistent throughout.
16 tools is slightly above the comfortable 3-15 band but each maps to a real VN-player action (new, read, choose, save/load, rewind, inspect). The few redundant-feeling tools (click vs next, gallery vs profile) nudge it just over an ideal scope.
The surface covers the VN lifecycle well: start, list books, read, choose, save/load/list, rewind, log, persona, collection progress, and visual inspection. Minor gaps exist (no delete/rename save slot, no quit/exit or skip/auto mode), but agents can work around them.