Skip to content

添加开发文档。 - #5437

Closed
zhangzhichaolove wants to merge 2 commits into
QuantumNous:mainfrom
zhangzhichaolove:main
Closed

添加开发文档。#5437
zhangzhichaolove wants to merge 2 commits into
QuantumNous:mainfrom
zhangzhichaolove:main

Conversation

@zhangzhichaolove

@zhangzhichaolove zhangzhichaolove commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

⚠️ 提交说明 / PR Notice

Important

  • 请提供人工撰写的简洁摘要,避免直接粘贴未经整理的 AI 输出。

📝 变更描述 / Description

为项目添加了完整的开发文档(DEVELOPMENT.md),帮助开发者快速搭建本地开发环境。

主要内容:

  • 环境要求说明(Go、Bun、数据库)
  • 本地开发快速启动步骤(首次构建前端 → 启动后端 → 启动前端)
  • 前后端开发指南、技术栈说明、项目结构
  • 常见问题解答(go:embed 报错、端口冲突等)

为什么这样改:

  • 原项目缺少面向开发者的本地开发指南,README 只包含用户部署文档
  • //go:embed 机制导致开发时需要特殊处理,未说明会导致新手开发者遇到报错
  • Rsbuild 默认端口与后端冲突问题需要明确说明
  • 支持 5 种语言(简体中文、繁体中文、英文、法语、日语),与 README 语言保持一致

变更细节:

  • 新增 docs/development/DEVELOPMENT.*.md(5 个语言版本)
  • 更新所有 README 文档部分的快速导航表格,添加开发指南入口

🚀 变更类型 / Type of change

  • 📝 文档更新 (Documentation)

🔗 关联任务 / Related Issue

✅ 提交前检查项 / Checklist

  • 人工确认: 我已亲自整理并撰写此描述,没有直接粘贴未经处理的 AI 输出。
  • 非重复提交: 我已搜索现有的 IssuesPRs,确认不是重复提交。
  • Bug fix 说明: 不适用(文档更新)
  • 变更理解: 我已理解这些更改的工作原理及可能影响。
  • 范围聚焦: 本 PR 未包含任何与当前任务无关的代码改动。
  • 本地验证: 已按照开发文档步骤在本地完整验证前后端启动流程。
  • 安全合规: 代码中无敏感凭据,且符合项目代码规范。

📸 运行证明 / Proof of Work

已在本地成功验证以下流程:

  1. 按照文档步骤构建前端 → 启动后端(3000 端口)
  2. 启动前端开发服务器(5173 端口),正常访问并代理后端 API
  3. 验证 5 种语言的开发文档互相链接正常,README 导航链接正确

文档位置: docs/development/DEVELOPMENT.md 及其他语言版本
README 更新: 所有语言版本的文档部分已添加"开发指南"入口

Summary by CodeRabbit

  • Documentation
    • Added a multilingual Development Guide (English, French, Japanese, Simplified Chinese, Traditional Chinese) with setup steps, development workflows, common troubleshooting, and production build notes.
    • Updated README quick-navigation tables in all supported languages to include links to the new Development Guide.

Copilot AI review requested due to automatic review settings June 11, 2026 15:24

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds multilingual development documentation and links it from each localized README to help contributors set up local dev environments consistently.

Changes:

  • Added new Development Guide docs in English, Simplified Chinese, Traditional Chinese, Japanese, and French under docs/development/.
  • Added “Development Guide” links to the localized READMEs pointing to the new local documentation.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
docs/development/DEVELOPMENT.md Adds English local development guide and troubleshooting.
docs/development/DEVELOPMENT.zh_CN.md Adds Simplified Chinese version of the development guide.
docs/development/DEVELOPMENT.zh_TW.md Adds Traditional Chinese version of the development guide.
docs/development/DEVELOPMENT.ja.md Adds Japanese version of the development guide.
docs/development/DEVELOPMENT.fr.md Adds French version of the development guide.
README.md Adds a link to the new English development guide.
README.en.md Adds a link to the new English development guide.
README.zh_CN.md Adds a link to the new Simplified Chinese development guide.
README.zh_TW.md Adds a link to the new Traditional Chinese development guide.
README.ja.md Adds a link to the new Japanese development guide.
README.fr.md Adds a link to the new French development guide.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

> **Prerequisites**: Since Go uses `//go:embed` to embed frontend files, you must build the frontend once before the first startup, otherwise an error will occur.

#### 1. First-Time Setup

Comment on lines +3 to +9
<p align="center">
<a href="./DEVELOPMENT.zh_CN.md">简体中文</a> |
<a href="./DEVELOPMENT.zh_TW.md">繁體中文</a> |
<a href="./DEVELOPMENT.md">English</a> |
<a href="./DEVELOPMENT.fr.md">Français</a> |
<a href="./DEVELOPMENT.ja.md">日本語</a>
</p>
Comment thread docs/development/DEVELOPMENT.zh_TW.md Outdated
bun run build
cd ../..

# 立即刪除構建產物 (防止後端服務靜態檔案)
@coderabbitai

coderabbitai Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ae7a914b-38f7-4ccd-babf-32a81a4c0c17

📥 Commits

Reviewing files that changed from the base of the PR and between 34de8c9 and 6538c53.

📒 Files selected for processing (5)
  • docs/development/DEVELOPMENT.fr.md
  • docs/development/DEVELOPMENT.ja.md
  • docs/development/DEVELOPMENT.md
  • docs/development/DEVELOPMENT.zh_CN.md
  • docs/development/DEVELOPMENT.zh_TW.md

Walkthrough

This PR adds localized developer guides (EN/FR/JA/zh_CN/zh_TW) and updates six README files to include “Development Guide” links pointing to the corresponding DEVELOPMENT.md documents.

Changes

Multilingual Development Documentation

Layer / File(s) Summary
README Quick Navigation Updates
README.md, README.en.md, README.fr.md, README.ja.md, README.zh_CN.md, README.zh_TW.md
All six README variants add a "Development Guide" navigation link in their Quick Navigation tables, each pointing to the corresponding localized docs/development/DEVELOPMENT*.md.
Development Guide - English
docs/development/DEVELOPMENT.md
New English guide covering prerequisites, two local startup workflows (manual first-build for //go:embed and Makefile targets), frontend tooling/commands and i18n sync, backend DB configuration (SQLite/MySQL/Postgres), project layout, production build/Docker steps, setup-reset utility, and common troubleshooting.
Development Guide - French
docs/development/DEVELOPMENT.fr.md
New French guide matching the English content: prerequisites, quick-start and Makefile workflows, frontend commands and stack, i18n sync, backend DB options, development directives, production/debug instructions, troubleshooting, and references/contact.
Development Guide - Japanese
docs/development/DEVELOPMENT.ja.md
New Japanese guide covering environment requirements, local and Makefile-based startup, frontend tooling and i18n sync, DB configuration examples, project structure, development norms, production builds, reset/debug utilities, and FAQ.
Development Guide - Chinese (Simplified)
docs/development/DEVELOPMENT.zh_CN.md
New Simplified Chinese guide with full developer instructions: environment, frontend/backend startup and Makefile targets, Bun commands and i18n workflow, DB configuration, project conventions, production builds, reset/debug tooling, and troubleshooting.
Development Guide - Chinese (Traditional)
docs/development/DEVELOPMENT.zh_TW.md
New Traditional Chinese guide documenting local setup, frontend dev commands and i18n sync, backend DB workflows (including Docker), project structure, development guidelines, production builds, debug/reset commands, and troubleshooting.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • Calcium-Ion

Poem

🐇 In burrows of code I softly tread,
Five tongues sing the guide ahead,
From Go to Bun, each step is penned,
Readmes linked so paths won't bend,
Hop on, devs — the doc trail's well-fed!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The PR title is vague and generic, using minimal Chinese text ('添加开发文档' = 'Add development documentation') without specificity about the scope or key details of the comprehensive multi-language documentation addition. Consider a more descriptive title that highlights the main change, such as 'Add comprehensive development guides in multiple languages' or specify the number of languages/files added to provide clearer context.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

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.

2 participants