docs: add bilingual project documentation

Author: DTW7607

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,69 +1,69 @@
 name: Bug Report
-description: 报告可复现的显示、窗口选择、输入或兼容性问题
+description: Report a reproducible display, window selection, input, or compatibility issue
 title: "[Bug] "
 labels: [bug]
 body:
   - type: checkboxes
     attributes:
-      label: 提交前检查
+      label: Pre-flight checks
       options:
-        - label: 我已搜索现有 Issue，没有找到相同问题。
+        - label: I have searched existing issues and did not find the same problem.
           required: true
-        - label: 我已保存目标应用中的重要工作，并了解项目使用私有 macOS API。
+        - label: I have saved important work in the target app and understand that this project uses private macOS APIs.
           required: true
 
   - type: input
     attributes:
-      label: Mac 型号与芯片
-      placeholder: 例如 MacBook Pro 14-inch, M4 Pro
+      label: Mac model and chip
+      placeholder: "Example: MacBook Pro 14-inch, M4 Pro"
     validations:
       required: true
 
   - type: input
     attributes:
-      label: macOS 版本
-      placeholder: 例如 macOS 26.5.1
+      label: macOS version
+      placeholder: "Example: macOS 26.5.1"
     validations:
       required: true
 
   - type: input
     attributes:
-      label: 目标应用
-      placeholder: 应用名称与版本
+      label: Target app
+      placeholder: App name and version
     validations:
       required: true
 
   - type: dropdown
     attributes:
-      label: 辅助功能权限
+      label: Accessibility permission
       options:
-        - 已授权
-        - 未授权
-        - 不确定
+        - Granted
+        - Not granted
+        - Unsure
     validations:
       required: true
 
   - type: textarea
     attributes:
-      label: 复现步骤
-      placeholder: 请按顺序描述从启动程序到问题出现的操作。
+      label: Reproduction steps
+      placeholder: Describe the exact steps from launching MacNotchKiller to seeing the issue.
     validations:
       required: true
 
   - type: textarea
     attributes:
-      label: 预期行为
+      label: Expected behavior
     validations:
       required: true
 
   - type: textarea
     attributes:
-      label: 实际行为与完整错误文本
+      label: Actual behavior and complete error text
     validations:
       required: true
 
   - type: textarea
     attributes:
-      label: 显示器环境与补充日志
-      description: 请说明外接显示器数量、排列方式，并粘贴终端日志。
+      label: Display setup and additional logs
+      description: Include the number of external displays, their arrangement, and terminal logs.
       render: shell

.github/ISSUE_TEMPLATE/bug_report_zh-CN.yml

@@ -0,0 +1,69 @@
+name: 问题报告（中文）
+description: 报告可复现的显示、窗口选择、输入或兼容性问题
+title: "[Bug] "
+labels: [bug]
+body:
+  - type: checkboxes
+    attributes:
+      label: 提交前检查
+      options:
+        - label: 我已搜索现有 Issue，没有找到相同问题。
+          required: true
+        - label: 我已保存目标应用中的重要工作，并了解项目使用私有 macOS API。
+          required: true
+
+  - type: input
+    attributes:
+      label: Mac 型号与芯片
+      placeholder: "例如 MacBook Pro 14-inch, M4 Pro"
+    validations:
+      required: true
+
+  - type: input
+    attributes:
+      label: macOS 版本
+      placeholder: "例如 macOS 26.5.1"
+    validations:
+      required: true
+
+  - type: input
+    attributes:
+      label: 目标应用
+      placeholder: 应用名称与版本
+    validations:
+      required: true
+
+  - type: dropdown
+    attributes:
+      label: 辅助功能权限
+      options:
+        - 已授权
+        - 未授权
+        - 不确定
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: 复现步骤
+      placeholder: 请按顺序描述从启动 MacNotchKiller 到问题出现的操作。
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: 预期行为
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: 实际行为与完整错误文本
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: 显示器环境与补充日志
+      description: 请说明外接显示器数量、排列方式，并粘贴终端日志。
+      render: shell

CONTRIBUTING.md

@@ -1,52 +1,54 @@
-# 贡献指南
+# Contributing
 
-感谢你改进 MacNotchKiller。这个项目依赖 macOS 私有显示接口，提交问题或代码时，请尽量提供可复现、可验证的信息。
+Thanks for improving MacNotchKiller. This project depends on private macOS display APIs, so issues and patches should be reproducible and grounded in real behavior.
 
-## 开发环境
+[简体中文](CONTRIBUTING.zh-CN.md)
 
-- macOS 13 或更高版本
+## Development environment
+
+- macOS 13 or later
 - Apple Silicon Mac
-- Swift 5.10 或更高版本工具链
+- Swift 5.10 or later
 
 ```bash
 git clone https://github.com/DTW7607/MacNotchKiller.git
 cd MacNotchKiller
 swift build
 ```
 
-## 提交问题
+## Reporting issues
 
-请使用仓库的 Bug Report 模板，并至少提供：
+Use the repository's Bug Report template. Include at least:
 
-- Mac 型号和芯片
-- macOS 完整版本号
-- 目标应用及其版本
-- 是否已授予辅助功能权限
-- 可稳定复现的操作步骤
-- 完整错误文本或终端日志
+- Mac model and chip
+- Full macOS version
+- Target app and version
+- Whether Accessibility permission has been granted
+- Stable reproduction steps
+- Complete error text or terminal logs
 
-显示器排列和输入问题请同时说明外接显示器数量及排列方式。
+For display arrangement or input issues, also include the number of external displays and how they are arranged.
 
-## 提交代码
+## Submitting code
 
-1. 从 `main` 创建短期功能分支。
-2. 保持改动范围集中，不混入构建缓存或本机配置。
-3. 对生命周期、坐标系、Event Tap 和异步回调的改动补充必要注释。
-4. 执行 `swift build` 和 `swift build -c release`。
-5. 在 Pull Request 中说明验证环境、预期行为和已知风险。
+1. Create a short-lived feature branch from `main`.
+2. Keep the change focused, and do not include build caches or local configuration.
+3. Add comments where lifecycle, coordinate systems, Event Tap behavior, or async callbacks are non-obvious.
+4. Run `swift build` and `swift build -c release`.
+5. In the pull request, describe the validation environment, expected behavior, and known risks.
 
-建议使用 Conventional Commits：
+Use Conventional Commits when practical:
 
 ```text
 feat(selection): add interactive window highlighting
 fix(display): wait for virtual display registration before positioning
 docs: document permissions and recovery shortcut
 ```
 
-## 工程约束
+## Engineering constraints
 
-- 不提交 `.build/` 或其他生成物。
-- 不直接链接私有类符号；私有 API 必须继续通过窄桥接层和运行时检测访问。
-- 不削弱 `Control + Option + Command + Q` 故障退出路径。
-- 不把真实设备上的成功结果等同于其他 macOS 版本兼容。
-- 不添加遥测、网络请求或画面上传行为，除非经过单独讨论并默认关闭。
+- Do not commit `.build/` or other generated files.
+- Do not directly link private class symbols. Private API access must remain behind the narrow bridge layer and runtime checks.
+- Do not weaken the `Control + Option + Command + Q` recovery path.
+- Do not treat success on one real device as proof of compatibility across macOS versions.
+- Do not add telemetry, network requests, or screen upload behavior unless discussed separately and disabled by default.

CONTRIBUTING.zh-CN.md

@@ -0,0 +1,54 @@
+# 贡献指南
+
+感谢你改进 MacNotchKiller。这个项目依赖 macOS 私有显示接口，提交问题或代码时，请尽量提供可复现、可验证的信息。
+
+[English](CONTRIBUTING.md) | 简体中文
+
+## 开发环境
+
+- macOS 13 或更高版本
+- Apple Silicon Mac
+- Swift 5.10 或更高版本工具链
+
+```bash
+git clone https://github.com/DTW7607/MacNotchKiller.git
+cd MacNotchKiller
+swift build
+```
+
+## 提交问题
+
+请使用仓库的 Bug Report 模板，并至少提供：
+
+- Mac 型号和芯片
+- macOS 完整版本号
+- 目标应用及其版本
+- 是否已授予辅助功能权限
+- 可稳定复现的操作步骤
+- 完整错误文本或终端日志
+
+显示器排列和输入问题请同时说明外接显示器数量及排列方式。
+
+## 提交代码
+
+1. 从 `main` 创建短期功能分支。
+2. 保持改动范围集中，不混入构建缓存或本机配置。
+3. 对生命周期、坐标系、Event Tap 和异步回调的改动补充必要注释。
+4. 执行 `swift build` 和 `swift build -c release`。
+5. 在 Pull Request 中说明验证环境、预期行为和已知风险。
+
+建议使用 Conventional Commits：
+
+```text
+feat(selection): add interactive window highlighting
+fix(display): wait for virtual display registration before positioning
+docs: document permissions and recovery shortcut
+```
+
+## 工程约束
+
+- 不提交 `.build/` 或其他生成物。
+- 不直接链接私有类符号；私有 API 必须继续通过窄桥接层和运行时检测访问。
+- 不削弱 `Control + Option + Command + Q` 故障退出路径。
+- 不把真实设备上的成功结果等同于其他 macOS 版本兼容。
+- 不添加遥测、网络请求或画面上传行为，除非经过单独讨论并默认关闭。