docs: make project documentation English-first

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,58 +1,58 @@
-name: Bug 报告
-description: 报告一个可以稳定复现的问题
+name: Bug report
+description: Report a reproducible problem
 title: "[Bug]: "
 labels:
   - bug
 body:
   - type: markdown
     attributes:
       value: |
-        感谢反馈！提交前请先确认问题能在最新线上版本或 `master` 分支复现。
+        Thanks for the report. Please confirm that the problem reproduces on the latest live version or the `master` branch.
 
   - type: input
     id: browser
     attributes:
-      label: 浏览器与版本
-      placeholder: 例如 Chrome 128 / Safari 18
+      label: Browser and version
+      placeholder: e.g. Chrome 128 / Safari 18
     validations:
       required: true
 
   - type: input
     id: tool
     attributes:
-      label: 受影响的工具或页面
-      placeholder: 例如 Markdown 编辑器、二维码工具
+      label: Affected tool or page
+      placeholder: e.g. Markdown editor, QR code tool
     validations:
       required: true
 
   - type: textarea
     id: steps
     attributes:
-      label: 复现步骤
-      description: 请按顺序写出最小复现路径。
+      label: Steps to reproduce
+      description: List the smallest reproducible path in order.
       placeholder: |
-        1. 打开……
-        2. 输入……
-        3. 点击……
+        1. Open …
+        2. Enter …
+        3. Click …
     validations:
       required: true
 
   - type: textarea
     id: expected
     attributes:
-      label: 预期行为
+      label: Expected behavior
     validations:
       required: true
 
   - type: textarea
     id: actual
     attributes:
-      label: 实际行为
+      label: Actual behavior
     validations:
       required: true
 
   - type: textarea
     id: context
     attributes:
-      label: 补充信息
-      description: 可以附截图、控制台错误、操作系统或其他上下文。请先移除敏感数据。
+      label: Additional context
+      description: Add screenshots, console errors, operating-system details, or other context. Remove sensitive data first.

.github/ISSUE_TEMPLATE/bug_report_zh.yml

@@ -0,0 +1,58 @@
+name: Bug 报告（中文）
+description: 使用中文报告一个可以稳定复现的问题
+title: "[Bug][中文]: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢反馈！提交前请先确认问题能在最新线上版本或 `master` 分支复现。
+
+  - type: input
+    id: browser
+    attributes:
+      label: 浏览器与版本
+      placeholder: 例如 Chrome 128 / Safari 18
+    validations:
+      required: true
+
+  - type: input
+    id: tool
+    attributes:
+      label: 受影响的工具或页面
+      placeholder: 例如 Markdown 编辑器、二维码工具
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: 复现步骤
+      description: 请按顺序写出最小复现路径。
+      placeholder: |
+        1. 打开……
+        2. 输入……
+        3. 点击……
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: 预期行为
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: 实际行为
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: 补充信息
+      description: 可以附截图、控制台错误、操作系统或其他上下文。请先移除敏感数据。

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,11 @@
 blank_issues_enabled: true
 contact_links:
-  - name: 在线体验
+  - name: Live demo
     url: https://htool.vercel.app/
-    about: 先在最新线上版本确认问题是否可以复现。
-  - name: 使用文档
-    url: https://github.com/Hughhhhcoder/HTooL#快速开始
+    about: Confirm whether the problem reproduces on the latest live version.
+  - name: English documentation
+    url: https://github.com/Hughhhhcoder/HTooL#quick-start
+    about: Read setup, testing, deployment, and privacy guidance.
+  - name: 简体中文文档
+    url: https://github.com/Hughhhhcoder/HTooL/blob/master/README.zh-CN.md#快速开始
     about: 查看安装、测试、部署和隐私说明。

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,34 +1,34 @@
-name: 功能建议
-description: 提议一个能让 HTooL 更有用的改进
+name: Feature request
+description: Suggest an improvement that would make HTooL more useful
 title: "[Feature]: "
 labels:
   - enhancement
 body:
   - type: textarea
     id: problem
     attributes:
-      label: 要解决的问题
-      description: 请描述场景和当前遇到的限制，而不仅是解决方案。
-      placeholder: 我在……场景下，需要……
+      label: Problem to solve
+      description: Describe the scenario and current limitation, not only the solution.
+      placeholder: In …, I need …
     validations:
       required: true
 
   - type: textarea
     id: proposal
     attributes:
-      label: 建议方案
-      description: 你希望工具如何工作？
+      label: Proposed solution
+      description: How would you like the tool to work?
     validations:
       required: true
 
   - type: textarea
     id: alternatives
     attributes:
-      label: 备选方案
-      description: 你尝试过哪些替代做法？
+      label: Alternatives considered
+      description: What other approaches have you tried?
 
   - type: textarea
     id: context
     attributes:
-      label: 补充信息
-      description: 可以附示例、草图、截图或相关链接。
+      label: Additional context
+      description: Add examples, sketches, screenshots, or related links.

.github/ISSUE_TEMPLATE/feature_request_zh.yml

@@ -0,0 +1,34 @@
+name: 功能建议（中文）
+description: 使用中文提议一个能让 HTooL 更有用的改进
+title: "[Feature][中文]: "
+labels:
+  - enhancement
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: 要解决的问题
+      description: 请描述场景和当前遇到的限制，而不仅是解决方案。
+      placeholder: 我在……场景下，需要……
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 建议方案
+      description: 你希望工具如何工作？
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 备选方案
+      description: 你尝试过哪些替代做法？
+
+  - type: textarea
+    id: context
+    attributes:
+      label: 补充信息
+      description: 可以附示例、草图、截图或相关链接。

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,27 +1,29 @@
-## 变更摘要
+<p align="right">English · <a href="./PULL_REQUEST_TEMPLATE/zh-CN.md">简体中文</a></p>
 
-<!-- 简要说明这次 PR 做了什么，以及为什么需要它。 -->
+## Summary
 
-## 关联 Issue
+<!-- Briefly explain what changed and why it is needed. -->
 
-<!-- 使用 Closes #123 或 Related #123；没有则删除这一行。 -->
+## Related issue
 
-## 验证方式
+<!-- Use Closes #123 or Related #123; remove this line if there is no issue. -->
+
+## Validation
 
 - [ ] `npm run test:unit`
 - [ ] `npm run test:no-gradient`
 - [ ] `npm run build`
 - [ ] `npm run test:perf-budget`
 - [ ] `npm run test:e2e`
 
-## 检查清单
+## Checklist
 
-- [ ] 我已检查浅色和暗色模式。
-- [ ] 我已检查移动端布局。
-- [ ] 我已补充或更新了相关测试。
-- [ ] 我没有提交密钥、个人数据或真实用户文件。
-- [ ] 如果涉及 UI，我已附上截图或录屏。
+- [ ] I checked both light and dark modes.
+- [ ] I checked the mobile layout.
+- [ ] I added or updated relevant tests.
+- [ ] I did not commit secrets, personal data, or real user files.
+- [ ] I included screenshots or a recording for UI changes.
 
-## 兼容性与风险
+## Compatibility and risk
 
-<!-- 说明浏览器兼容性、性能影响、数据边界或破坏性变更。没有则填写“无”。 -->
+<!-- Describe browser compatibility, performance impact, data boundaries, or breaking changes. Write “None” when not applicable. -->

.github/PULL_REQUEST_TEMPLATE/zh-CN.md

@@ -0,0 +1,29 @@
+<p align="right"><a href="../PULL_REQUEST_TEMPLATE.md">English</a> · 简体中文</p>
+
+## 变更摘要
+
+<!-- 简要说明这次 PR 做了什么，以及为什么需要它。 -->
+
+## 关联 Issue
+
+<!-- 使用 Closes #123 或 Related #123；没有则删除这一行。 -->
+
+## 验证方式
+
+- [ ] `npm run test:unit`
+- [ ] `npm run test:no-gradient`
+- [ ] `npm run build`
+- [ ] `npm run test:perf-budget`
+- [ ] `npm run test:e2e`
+
+## 检查清单
+
+- [ ] 我已检查浅色和暗色模式。
+- [ ] 我已检查移动端布局。
+- [ ] 我已补充或更新了相关测试。
+- [ ] 我没有提交密钥、个人数据或真实用户文件。
+- [ ] 如果涉及 UI，我已附上截图或录屏。
+
+## 兼容性与风险
+
+<!-- 说明浏览器兼容性、性能影响、数据边界或破坏性变更。没有则填写“无”。 -->

CODE_OF_CONDUCT.md

@@ -1,23 +1,25 @@
-# 行为准则
+# Code of Conduct
 
-## 我们的承诺
+<p align="right">English · <a href="./CODE_OF_CONDUCT.zh-CN.md">简体中文</a></p>
 
-为了营造开放、友善且可持续的协作环境，参与 HTooL 的每个人都应以尊重、善意和专业的方式交流，无论其经验、背景或身份如何。
+## Our commitment
 
-## 可接受的行为
+To create an open, friendly, and sustainable collaboration environment, everyone participating in HTooL is expected to communicate with respect, good faith, and professionalism, regardless of experience, background, or identity.
 
-- 使用清晰、建设性的语言提出意见；
-- 讨论实现、体验和证据，而不是评价个人；
-- 接受不同观点，并在有新信息时修正自己的判断；
-- 尊重项目维护者和其他贡献者的时间。
+## Acceptable behavior
 
-## 不可接受的行为
+- Use clear and constructive language.
+- Discuss implementation, experience, and evidence rather than judging people.
+- Stay open to different perspectives and update your view when new information appears.
+- Respect the time of maintainers and contributors.
 
-- 骚扰、歧视、威胁、人身攻击或故意羞辱；
-- 发布他人的私人信息；
-- 破坏讨论、刷屏、冒充他人或以恶意方式提交内容；
-- 任何不适合公开协作环境的行为。
+## Unacceptable behavior
 
-## 执行
+- Harassment, discrimination, threats, personal attacks, or deliberate humiliation.
+- Publishing someone else’s private information.
+- Disrupting discussions, spamming, impersonating others, or submitting content maliciously.
+- Any other behavior that is inappropriate for a public collaboration space.
 
-请通过 [维护者主页](https://github.com/Hughhhhcoder) 私下联系维护者，报告违反本准则的行为。维护者会根据事实采取适当措施，并尽可能保护报告者的隐私。
+## Enforcement
+
+Please contact the maintainer privately through the [maintainer profile](https://github.com/Hughhhhcoder) to report a violation. Reports will be reviewed based on the available facts, with the reporter’s privacy protected as far as possible.

CODE_OF_CONDUCT.zh-CN.md

@@ -0,0 +1,25 @@
+# 行为准则
+
+<p align="right"><a href="./CODE_OF_CONDUCT.md">English</a> · 简体中文</p>
+
+## 我们的承诺
+
+为了营造开放、友善且可持续的协作环境，参与 HTooL 的每个人都应以尊重、善意和专业的方式交流，无论其经验、背景或身份如何。
+
+## 可接受的行为
+
+- 使用清晰、建设性的语言提出意见；
+- 讨论实现、体验和证据，而不是评价个人；
+- 接受不同观点，并在有新信息时修正自己的判断；
+- 尊重项目维护者和其他贡献者的时间。
+
+## 不可接受的行为
+
+- 骚扰、歧视、威胁、人身攻击或故意羞辱；
+- 发布他人的私人信息；
+- 破坏讨论、刷屏、冒充他人或以恶意方式提交内容；
+- 任何不适合公开协作环境的行为。
+
+## 执行
+
+请通过 [维护者主页](https://github.com/Hughhhhcoder) 私下联系维护者，报告违反本准则的行为。维护者会根据事实采取适当措施，并尽可能保护报告者的隐私。