chore(github): translate templates to English and slim down contribut…

.github/CONTRIBUTING.md

@@ -1,46 +1,39 @@
-# LiveAgent 贡献指南
+# Contributing to LiveAgent
 
-感谢你对 LiveAgent 的关注!为了让协作高效、降低审核成本,本项目对 issue 与 PR 有明确的流程要求。**不符合流程的 PR 会被自动转为 draft**,补齐后再点击 "Ready for review" 即可重新触发检查。
+This guide covers the contribution process only. Technical details live in the project docs and stay authoritative there — this file should rarely need updates.
 
-## 核心流程:先 Issue,后 PR
+## Getting started
 
-1. **先提 issue**:无论缺陷还是新功能,先用对应的 issue 模板提交,写清需求说明 / 复现步骤。
-2. **等待确认**:功能类提案请等维护者确认方向后再动手,避免白做。
-3. **再提 PR**:PR 正文必须用 `Closes #123` / `Fixes #123` 关联对应 issue。
-4. 内部维护者的日常开发同样遵守"PR 关联 issue"——差别只是可以自己先补一个简要 issue 再提 PR。
+- Toolchain: run `mise install` in the repository root to install every version pinned in `mise.toml`.
+- Local development, build, test commands, ports: see [docs/operations/development.md](../docs/operations/development.md), or run `make help` for the full command list.
+- Architecture and module boundaries: start from the [docs index](../docs/README.md).
+- Locating source code by feature: see [docs/reference/source-map.md](../docs/reference/source-map.md).
 
-不允许无 issue 直接提 PR。琐碎修复(错别字、注释、明显笔误)可在 PR 说明中注明豁免理由,由维护者判断。
+Note: project docs and code comments are primarily written in Chinese.
 
-## PR 硬性要求(自动检查)
+## Verify before submitting
 
-以下任一不满足,PR 会被自动转为 draft 并附检查报告:
+Run the checks for the modules you touched. The CI definition in [`.github/workflows/ci.yml`](workflows/ci.yml) is the source of truth for what must pass; [docs/operations/development.md](../docs/operations/development.md) explains how to run the equivalents locally.
 
-| 检查项 | 要求                                                                                               |
-| --- |----------------------------------------------------------------------------------------------------|
-| 关联 issue | 正文包含 `Closes #N` / `Fixes #N` / `Resolves #N`                                                  |
-| 截图 / 预览 | UI 改动必须附截图或录屏(强制);后端 / CLI 改动附请求响应示例或运行日志等文字材料即可,由人工审核把关 |
-| 无合并冲突 | 与目标分支冲突时请先在自己的分支解决(merge 或 rebase 基线),维护者不代为解冲突                      |
+## Code requirements
 
-被转为 draft 后:按报告补齐 → 点击 **Ready for review** → 重新检查。
+- **Stay focused**: one PR does one thing. No unrelated refactors or reformatting.
+- **Keep comments and docs in sync**: match the comment language of the surrounding code; update affected comments and docs when you change code — stale comments are worse than none.
+- **Never hand-edit generated code**: proto-generated Go code, WebUI build output, etc. must be regenerated via their commands (CI verifies they are in sync).
+- **No secrets**: API keys, tokens, personal data, `.env` files, and local configuration must never be committed.
 
-## PR 内容要求
+## Pull request process
 
-- **保持聚焦**:一个 PR 只做一件事,不混入无关重构或格式化。
-- **写清改动范围**:按模板列出涉及模块与关键路径(`agent-gui` / `agent-gateway` / `src-tauri`),降低审核复杂度,也便于 AI review。
-- **通过 CI**:提交前在本地跑对应模块的检查:
-  - Gateway(Go):`cd crates/agent-gateway && go test ./...`,proto 变更需 `make proto-check`
-  - GUI 前端:`cd crates/agent-gui && pnpm build && pnpm lint && pnpm test:frontend`
-  - Tauri(Rust):`cargo check --manifest-path crates/agent-gui/src-tauri/Cargo.toml --tests`
-  - Gateway WebUI:`cd crates/agent-gateway/web && pnpm build && pnpm lint && pnpm test`
-- **不提交敏感信息**:API Key、token、个人数据、`.env`、本地配置一律不入库。
-- **同步文档与注释**:影响用户行为、部署或配置的变更,同步更新文档;修改代码后同步修改受影响的注释。
+Open an issue first (feature request / bug report), wait for it to be confirmed, then open a PR that references it with `Closes #N`. The following rules are enforced automatically — a PR failing any of them is **converted to draft**; fix it and click "Ready for review" to re-run the checks:
 
-## Issue 要求
+| Check | Requirement |
+| --- | --- |
+| Linked issue | Body contains `Closes #N` / `Fixes #N` / `Resolves #N` |
+| Screenshots / preview | UI changes must include screenshots or a recording; backend / CLI changes should include request-response examples or logs as text |
+| No merge conflicts | Resolve conflicts with the target branch on your own branch before requesting review |
 
-- Bug 报告:提供版本、环境、最小复现步骤、预期与实际行为。
-- 需求提案:写清要解决的问题与期望方案——**需求说明是必填项**,只有一句"希望支持 XXX"的 issue 会被要求补充。
-- 安全漏洞:**不要**发公开 issue,请通过 [Security Advisories](https://github.com/Stack-Cairn/LiveAgent/security/advisories/new) 私下报告。
+Trivial fixes (typos, comments) may state an exemption reason in the PR description, at the maintainers' discretion. Do **not** report security vulnerabilities in public issues — use [Security Advisories](https://github.com/Stack-Cairn/LiveAgent/security/advisories/new) instead.
 
-## 许可
+## License
 
-提交贡献即表示你同意你的代码以本仓库的 [MIT License](../LICENSE) 发布。
+By contributing, you agree that your code is licensed under this repository's [MIT License](../LICENSE).

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,88 +1,85 @@
-name: Bug 报告 / Bug report
-description: 报告 LiveAgent 的缺陷。请提供完整的复现信息,信息不全的 issue 可能被要求补充后才会处理。
+name: Bug report
+description: Report a defect in LiveAgent. Reports missing key details may be asked to supplement before triage.
 title: "[Bug] "
 labels:
   - bug
 body:
   - type: markdown
     attributes:
       value: |
-        感谢反馈!请勿在此报告安全漏洞——请通过 [Security Advisories](https://github.com/Stack-Cairn/LiveAgent/security/advisories/new) 私下提交。
-        提交前请先搜索现有 issue,避免重复。
+        Do not report security vulnerabilities here — submit them privately via [Security Advisories](https://github.com/Stack-Cairn/LiveAgent/security/advisories/new).
   - type: dropdown
     id: area
     attributes:
-      label: 影响范围
-      description: 选择该问题主要影响的模块。
+      label: Affected area
+      description: Choose the module this issue mainly affects.
       options:
-        - 桌面端 UI(agent-gui / React)
-        - 桌面端内核(Tauri / Rust)
-        - 网关(agent-gateway / Go)
-        - Agent 会话 / 流式输出
-        - 工具执行 / MCP / Skills
-        - 模型接入 / Provider
-        - 打包 / 发布 / 安装
-        - 文档
-        - 其他
+        - Desktop UI (agent-gui / React)
+        - Desktop core (Tauri / Rust)
+        - Gateway (agent-gateway / Go)
+        - Agent sessions / streaming
+        - Tool execution / MCP / Skills
+        - Model providers
+        - Packaging / release / installation
+        - Documentation
+        - Other
     validations:
       required: true
   - type: input
     id: version
     attributes:
-      label: 版本或 commit
-      description: 发布版本号、Docker 镜像 tag、分支或 commit SHA。
+      label: Version or commit
+      description: Release version, Docker image tag, branch, or commit SHA.
       placeholder: v0.3.2 / main@f69f24dc
     validations:
       required: true
   - type: textarea
     id: environment
     attributes:
-      label: 运行环境
-      description: 操作系统与版本、部署方式(桌面端 / 网关自部署)、使用的模型 Provider 等。
+      label: Environment
+      description: OS and version, deployment mode (desktop app / self-hosted gateway), model provider, etc.
       placeholder: |
         OS: macOS 15.2 (Apple Silicon)
-        部署方式: 桌面端
-        模型 Provider: Anthropic API
+        Deployment: desktop app
+        Model provider: Anthropic API
     validations:
       required: true
   - type: textarea
     id: reproduce
     attributes:
-      label: 复现步骤
-      description: 能稳定复现问题的最小操作序列。
+      label: Steps to reproduce
+      description: The smallest sequence of steps that reliably reproduces the problem.
       placeholder: |
-        1. 打开设置页……
-        2. 点击……
-        3. 观察到……
+        1. Open the settings page...
+        2. Click...
+        3. Observe...
     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: logs
     attributes:
-      label: 日志 / 截图
-      description: 相关日志、报错信息或截图,可直接拖拽上传。请先移除密钥、token 等敏感信息。
+      label: Logs / screenshots
+      description: Relevant logs, error messages, or screenshots (drag and drop to upload). Remove secrets such as API keys and tokens first.
     validations:
       required: false
   - type: checkboxes
     id: checklist
     attributes:
-      label: 提交前确认
+      label: Pre-submit checklist
       options:
-        - label: 我已搜索现有 issue 和 PR,确认没有重复。
+        - label: I searched existing issues and pull requests and found no duplicates.
           required: true
-        - label: 内容中不包含 API Key、token、密码等敏感信息。
-          required: true
-        - label: 这不是安全漏洞(安全问题请走 Security Advisories 私下报告)。
+        - label: This is not a security vulnerability (report those privately via Security Advisories).
           required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -1,11 +1,8 @@
 blank_issues_enabled: false
 contact_links:
-  - name: 安全漏洞报告 / Security vulnerability
+  - name: Security vulnerability report
     url: https://github.com/Stack-Cairn/LiveAgent/security/advisories/new
-    about: 请勿在公开 issue 中报告安全漏洞,请通过 GitHub Security Advisories 私下提交。
-  - name: 贡献指南 / Contributing guidelines
+    about: Please do not report security vulnerabilities through public GitHub issues. Submit them privately via Security Advisories.
+  - name: Contribution guidelines
     url: https://github.com/Stack-Cairn/LiveAgent/blob/main/.github/CONTRIBUTING.md
-    about: 提交 issue 或 PR 之前,请先阅读贡献指南。
-  - name: 使用咨询 / Questions & discussions
-    url: https://github.com/Stack-Cairn/LiveAgent/discussions
-    about: 使用问题、想法讨论请使用 Discussions,issue 仅用于缺陷报告与需求提案。
+    about: Read the contribution guidelines before opening an issue or pull request.

.github/ISSUE_TEMPLATE/documentation.yml

@@ -1,47 +1,47 @@
-name: 文档问题 / Documentation
-description: 报告文档的错误、过时、缺失或表述不清的问题。
+name: Documentation
+description: Report incorrect, outdated, missing, or unclear documentation.
 title: "[Docs] "
 labels:
   - documentation
 body:
   - type: dropdown
     id: type
     attributes:
-      label: 问题类型
+      label: Problem type
       options:
-        - 内容有误(与实际行为不符)
-        - 内容过时(功能已变更但文档未更新)
-        - 内容缺失(该有说明但没有)
-        - 表述不清 / 易产生误解
-        - 其他
+        - Incorrect (does not match actual behavior)
+        - Outdated (behavior changed but docs did not)
+        - Missing (should be documented but is not)
+        - Unclear / misleading
+        - Other
     validations:
       required: true
   - type: input
     id: location
     attributes:
-      label: 文档位置
-      description: 相关文档的链接或文件路径。
-      placeholder: docs/xxx.md 或 README.md 的某一节
+      label: Location
+      description: Link or file path of the affected documentation.
+      placeholder: docs/xxx.md or a section of README.md
     validations:
       required: true
   - type: textarea
     id: problem
     attributes:
-      label: 问题描述
-      description: 说明哪里有问题。是内容错误的话,请一并说明实际的正确行为。
+      label: Problem description
+      description: Explain what is wrong. For incorrect content, also describe the actual correct behavior.
     validations:
       required: true
   - type: textarea
     id: suggestion
     attributes:
-      label: 修改建议
-      description: 如果你有建议的写法,写在这里;愿意直接提 PR 修复也请注明。
+      label: Suggested fix
+      description: Your suggested wording, if any. Mention if you are willing to submit a PR for it.
     validations:
       required: false
   - type: checkboxes
     id: checklist
     attributes:
-      label: 提交前确认
+      label: Pre-submit checklist
       options:
-        - label: 我已搜索现有 issue,确认没有重复。
+        - label: I searched existing issues and found no duplicates.
           required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,51 +1,46 @@
-name: 需求提案 / Feature request
-description: 提出新功能或改进。所有功能类 PR 必须先有对应的需求 issue,请在这里写清需求说明。
+name: Feature request
+description: Propose a new feature or improvement. Every feature PR must reference a confirmed feature issue — describe the requirement here first.
 title: "[Feature] "
 labels:
   - enhancement
 body:
-  - type: markdown
-    attributes:
-      value: |
-        本项目要求 **先 issue 后 PR**:功能开发前请先提交本表单并等待维护者确认,再开始编码。
-        未关联需求 issue 的 PR 会被直接转为 draft。
   - type: dropdown
     id: area
     attributes:
-      label: 影响范围
-      description: 选择该提案主要涉及的模块。
+      label: Affected area
+      description: Choose the module this proposal mainly involves.
       options:
-        - 桌面端 UI(agent-gui / React)
-        - 桌面端内核(Tauri / Rust)
-        - 网关(agent-gateway / Go)
-        - Agent 会话 / 流式输出
-        - 工具执行 / MCP / Skills
-        - 模型接入 / Provider
-        - 打包 / 发布 / 安装
-        - 文档
-        - 其他
+        - Desktop UI (agent-gui / React)
+        - Desktop core (Tauri / Rust)
+        - Gateway (agent-gateway / Go)
+        - Agent sessions / streaming
+        - Tool execution / MCP / Skills
+        - Model providers
+        - Packaging / release / installation
+        - Documentation
+        - Other
     validations:
       required: true
   - type: textarea
     id: problem
     attributes:
-      label: 需求说明(要解决什么问题)
-      description: 描述当前的痛点或限制、受影响的用户场景。这是需求评审的核心依据,请写具体。
-      placeholder: 当前……导致……,影响到……场景。
+      label: Problem statement (what should this solve)
+      description: Describe the current pain point or limitation and the affected user scenarios. This is the core input for review — be specific.
+      placeholder: Currently ... which causes ... and affects the ... scenario.
     validations:
       required: true
   - type: textarea
     id: proposal
     attributes:
-      label: 期望的方案或行为
-      description: 描述期望的交互、API、配置或行为变化。UI 相关的提案建议附草图或参考截图。
+      label: Proposed behavior
+      description: Describe the desired interaction, API, configuration, or behavior change. For UI proposals, sketches or reference screenshots are encouraged.
     validations:
       required: true
   - type: textarea
     id: scope
     attributes:
-      label: 预计改动范围
-      description: 如果你打算自己实现,请列出预计涉及的模块 / 目录 / 文件,便于评估复杂度。
+      label: Estimated change scope
+      description: If you plan to implement this yourself, list the modules / directories / files you expect to touch, to help assess complexity.
       placeholder: |
         crates/agent-gui/src/...
         crates/agent-gateway/internal/...
@@ -54,18 +49,18 @@ body:
   - type: textarea
     id: alternatives
     attributes:
-      label: 备选方案
-      description: 考虑过的其他方案或现有替代做法。
+      label: Alternatives considered
+      description: Other designs or existing workarounds you considered.
     validations:
       required: false
   - type: checkboxes
     id: checklist
     attributes:
-      label: 提交前确认
+      label: Pre-submit checklist
       options:
-        - label: 我已搜索现有 issue 和 PR,确认没有重复。
+        - label: I searched existing issues and pull requests and found no duplicates.
           required: true
-        - label: 本提案聚焦单一功能或改进,没有混杂多个不相关需求。
+        - label: This proposal is focused on a single feature or improvement.
           required: true
-        - label: 我了解需先经维护者确认后再提交实现 PR,否则 PR 会被转为 draft。
+        - label: I understand a PR should come after this issue is confirmed by maintainers, otherwise it will be converted to draft.
           required: true