zeeyado /koassistant.koplugin
A powerful AI assistant integrated into KOReader.
★ 299⑂ 23👁 1⑃ 44● 67▤ 53
+0
日增长
299
stars
23
forks
1
watchers
44
prs
67
issues
53
releases
README
KOAssistant Powerful, customizable AI assistant for KOReader. Documentation: the Wiki has a page for every feature; the full list is at the end of this page. What it does - Highlight text → translate, explain, define words, analyze passages, connect ideas, and save the answer into KOReader's notes; short answers land in a small popup at your selection. Contexts and Chat - X-Ray → a browsable guide to the book up to where you are (people, places, ideas, terms), kept current by checkpoints as you read, with known names underlined in the text. Using X-Ray - Book Groups → a series or a project with its own hub and settings; what the other books' X-Rays know is carried in for free. Book Groups and Series - Book Hub → one page per book gathering its artifacts, chats, notebook, group and settings. Book Settings and Book Hub - Reading analysis → recap, document summary and analysis, an About overview, notes analysis, discussion questions, chapter quizzes, an end-of-book suggestion. Reading Analysis Actions - Research Mode → papers with a DOI get an academic X-Ray, research-aware prompts and, with web search on, web-enriched analysis, with no setup. Research Mode - Spoiler protection → on by default: the AI stays behind your reading position, per book or for one chat. Spoiler Protection - Session controls → a chip row in the input dialog (Domain, Web, Tools, Quick, Scope, Attach, Spoiler); most chips are a tap for this chat and a hold for their default. Contexts and Chat - Dictionary and translation → actions in KOReader's dictionary popup, a compact AI dictionary, bypass modes that skip the menus, and translate views. Dictionary and Translation - Notebooks → a markdown notebook per book, an optional one-tap Add to notebook button in the highlight menu, Obsidian vault integration. Conversations, Notebooks and Export - Library → what to read next, reading patterns, comparisons across books, collection analysis. Contexts and Chat - General chat → the AI without book context. Contexts and Chat - Web search, book tools, reasoning → current information from the web, the AI searching the open book for its answers, thinking set per model. Reasoning, Web Search and Book Tools - Multilingual → chat in any language the AI understands; the plugin's UI has 26 languages. Languages - Generate images → a highlight or an X-Ray entry drawn by OpenAI, xAI, Gemini or OpenRouter, kept in a gallery on the device. Image Generation - Customizable → custom actions, behaviors, domains, per-action models, template variables, and control over every menu the plugin appears in. Actions and Menus, Prompts, Behaviors and Domains - Private by default → your highlights, notes, notebook, the book's text, library and reading habits are asked for before anything goes. Privacy and Data - Keeps itself current → one-tap updates, backups and restore. Backups and Updates Status: active development; you can also run off the main branch for the newest features (untested,
Top issues
#90Merge the Artifacts of Multiple Books that Belongs to the Same Series52 comments · 2026-06-26#73automatic checkpointing for x-ray and book summary8 comments · 2026-04-14#123[Bug] v0.24.1 — Global X-Ray settings unresponsive due to missing callbacks (fix tested)3 comments · 2026-11-03#120X-Ray marking: case-insensitive match on entity names that are also common phrases ("The Others")3 comments · 2026-10-22#118Cross device sync of artifacts2 comments · 2026-10-18#125Google Gemini API Key not compatible1 comments · 2026-11-14#121Performance: eager Lua allocations and repeated failed update checks on FM/reader switches1 comments · 2026-10-25#97Action-scoped history for recurring actions: full version (from discussion #95)1 comments · 2026-07-17
Discussions
#114Potential sponsorship / provider ecosystem collaboration with 88API1 comments · 2026-09-20#95Add optional action-scoped history for recurring custom actions4 comments · 2026-07-15#74What local models have you guys found good for this?1 comments · 2026-04-18#57Help wanted: making KOAssistant easier to learn0 comments · 2026-03-13#56Referencing most recent chat while reading.1 comments · 2026-03-12#55Help me set up chapter specific custom action1 comments · 2026-03-12#54facing issue in usability after successful installation3 comments · 2026-03-11#46Are there plans to support multiple languages?2 comments · 2026-02-18
Latest release
v0.24.1 v0.24.1 2026-10-20KOAssistant v0.24.1 Release Notes This is a maintenance release for v0.24.0. Its notes follow below. - Library actions let you pick their scan folders for each run: your default folders start ticked, recent ones are one tap away, and no folder has to be set beforehand. - Book list is called Library Scan again, Permanent Scan Folders are Default Scan Folders, and the action editor's Library Scan box is on every custom action. - The data question can skip the optional part: Continue without, or Allow once without your reading habits. - Always allow sticks when started from Quick Actions, a ges