Skip to content

docs: Add Web interface usage guide to README#20

Open
jsoncm wants to merge 191 commits into
ip2a:mainfrom
jsoncm:docs/add-web-usage-guide
Open

docs: Add Web interface usage guide to README#20
jsoncm wants to merge 191 commits into
ip2a:mainfrom
jsoncm:docs/add-web-usage-guide

Conversation

@jsoncm

@jsoncm jsoncm commented Jan 30, 2026

Copy link
Copy Markdown

📝 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

@ip2a
ip2a force-pushed the main branch 2 times, most recently from 9eeae41 to dec320c Compare July 21, 2026 07:16
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页面怎么用?

4 participants