Sentence → Paragraph → Independent Writing
A local-first English writing practice studio. Core practice works without an account, backend database or AI. Optional BYOK analysis processes only reference text selected by the visitor.
Core practice features will remain free to use: no account, subscription, advertising or AI setup is required. Optional BYOK users may choose a provider offering a free API, free tier or free model, or use a paid API. Availability, quotas, regional access and pricing are controlled by the selected provider and may change.
Live demo: https://writing-assistant.ccwu.cc/
Sentence imitation, precise copying and local rule-based analysis.
Sentence-function breakdown, guided paragraph building and independent writing.
Local folders, imported documents, public resources and chapter progress.
The project does not promise to turn every learner into a native-language author. Its more practical goal is to make English a language in which learners can express what they actually mean, with less stiffness and a more natural sense of movement.
That requires high-quality input as well as sustained output. Strong writing does not have one fixed form: an essay, news report, speech, academic paper, screenplay, short story, piece of prose and poem all organise information differently.
Writing Assistant therefore encourages observation, breakdown, imitation, transfer and independent writing rather than word-for-word movement from a sentence already completed in another language.
文字是自由的，我们要学会如何排列它们，让自己的宇宙和这个世界产生连接。
Language is information, and information is everything.
Read the full writing philosophy
- Sentence Lab: copying, structural imitation, splitting and local rule analysis.
- Paragraph Lab: sentence functions, guided planning, skeleton transfer and independent writing.
- Practice Library: folders, long documents, chapter progress and local materials.
- Browser document import for TXT, Markdown, EPUB, DOCX and PDF.
- Self-hosted browser English OCR.
- Optional BYOK reference analysis excluding learner writing, notes, plans and progress.
- User-triggered Wikipedia and Wikisource resources.
- Browser-local storage with JSON backup and restore.
Writing Assistant does not provide a shared AI account or a project-owned API key. The optional feature uses BYOK — Bring Your Own Key. Visitors obtain an API key from a provider they choose and connect to that provider directly from their browser.
Users are not required to purchase an API. They may choose a provider that offers a free API, free quota, free tier or free model, or connect a paid API when they prefer. Free plans may have request limits, model restrictions, regional restrictions or changing availability, so the provider's current console and documentation remain the source of truth.
AI analysis is designed for the reference sentence or paragraph currently being studied. It can explain meaning, grammatical structure, clauses, collocations, register, paragraph development, cohesion and transferable writing patterns. It does not read, send or evaluate learner imitation, notes, plans, labels or progress.
- Open the website and click AI Settings in the top bar.
- Choose a provider preset: OpenAI, DeepSeek, SiliconFlow, Google Gemini, Anthropic Claude, or a custom OpenAI-compatible service. A free API, free-tier account or free model can be used when the provider supports browser access.
- Paste a dedicated, low-limit and revocable API key obtained from that provider.
- Check the automatically filled Base URL, endpoint and model name against the provider's current documentation. Presets only fill the request format; model availability, free quotas and pricing may change.
- Keep Session only for the safest default, or choose encrypted local storage and create a local password of at least eight characters.
- Choose the analysis language, click Test connection, and then click Save settings.
- Open a sentence or paragraph exercise and click AI解析原文 / Analyse reference text in the right-side coach panel.
The key is excluded from ordinary Writing Assistant backup files. Session-only keys disappear when the browser tab session ends. Encrypted local storage uses a password that the project cannot recover. Some providers may block direct browser requests through CORS. Depending on the selected provider and plan, API usage may be free within its quota or may incur provider charges.
Full AI configuration and troubleshooting guide
The Copy … · AI feedback actions in Sentence Lab and Paragraph Lab assemble the reference text, the learner's writing, notes and mode-specific feedback instructions. The copied material can be pasted into ChatGPT, Gemini, DeepSeek or another AI service to identify problems in logic, grammar, collocation and naturalness.
Copying only writes to the system clipboard. It does not call the Writing Assistant BYOK API or send learner writing automatically. The text reaches an external service only after the visitor deliberately pastes and sends it. The built-in AI reference analysis continues to process reference text only.
External AI feedback copy guide
There is no shared practice database, account system, advertising tracker or first-party behavior analytics. Ordinary delivery uses Cloudflare. External requests occur only for user-triggered AI, Wikimedia or optional OCR features.
- Privacy Policy
- Terms and Disclaimer
- Copyright and Takedown
- Security Policy
- Third-party Notices
- Contact
- Public legal center
Version 0.8.1 preserves storage schema 5 and existing local data. It adds public policy pages, a footer, clearer data-flow disclosures, terms, copyright reporting, security-reporting boundaries and release checks.
Documents enter local preview before saving. Title and order changes preserve identifiers where possible. Structural changes reconcile only affected progress after confirmation. PDF.js handles text layers; browser English OCR handles scan-like pages. The larger loopback companion remains optional and experimental.
python3 -m http.server 8080
npm install --omit=dev --no-audit --no-fund
npm run vendor
npm run build:release
npm run deploydist/site is deployed through Cloudflare Workers Static Assets.
Built-in IELTS-style texts are original and unofficial. Users are responsible for lawful imported material. See CONTRIBUTING.md. Code is released under the MIT License.