Skip to content

docs: Add Web interface usage guide to README#20

Open
jsoncm wants to merge 1 commit intowhillhill:mainfrom
jsoncm:docs/add-web-usage-guide
Open

docs: Add Web interface usage guide to README#20
jsoncm wants to merge 1 commit intowhillhill:mainfrom
jsoncm:docs/add-web-usage-guide

Conversation

@jsoncm
Copy link

@jsoncm jsoncm commented Jan 30, 2026

📝 Description

This PR adds comprehensive documentation for the Web interface usage to address issue #11.

🔍 Problem

Users were confused about how to access and use the Web interface locally. The README only mentioned the online demo link but didn't explain how to run the Web UI locally.

✨ Changes

Added a new "Web Interface" section to all README files (main, Chinese, and English versions) that includes:

  1. Docker deployment (recommended method)

    • Quick start with start-all.sh script
    • Individual service startup commands
    • Access URLs for Web and API services
  2. Local development mode

    • Step-by-step guide to start API backend
    • Instructions for starting Vue.js frontend
    • Different host mode options (local/domain)
  3. Production deployment

    • Build and preview commands
    • Deployment instructions for static file servers
  4. Online demo reference

    • Link to the live demo for users who don't want to deploy locally

🎯 Fixes

Closes #11

📸 Documentation Structure

The new section is placed after the "API Mode" section and before "Docker Deployment", providing a logical flow from API setup to Web interface usage.

✅ Checklist

  • Updated README.md (main)
  • Updated README_zh.md (Chinese)
  • Updated README_en.md (English)
  • Verified all commands and URLs are correct
  • Maintained consistent formatting across all versions

- Add comprehensive Web interface section in all README files (EN/ZH/main)
- Include Docker deployment instructions (recommended method)
- Add local development mode setup guide
- Document production deployment steps
- Fixes whillhill#11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

请教下web页面怎么用?

1 participant