From 0f4fb1898207c21741712942e5a88ac2ff3c4202 Mon Sep 17 00:00:00 2001
From: RiskeyL <7a8y@163.com>
Date: Thu, 9 Apr 2026 16:05:17 +0800
Subject: [PATCH 1/2] chore: note environments.mdx manual translation
 requirement

---
 .claude/skills/dify-docs-env-vars/SKILL.md | 4 ++++
 CLAUDE.md                                  | 1 +
 README.md                                  | 2 +-
 3 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/.claude/skills/dify-docs-env-vars/SKILL.md b/.claude/skills/dify-docs-env-vars/SKILL.md
index 734ccc9ac..62ccfeb77 100644
--- a/.claude/skills/dify-docs-env-vars/SKILL.md
+++ b/.claude/skills/dify-docs-env-vars/SKILL.md
@@ -137,6 +137,10 @@ The script reports:
 
 Use `.env.example` defaults (what Docker Compose users actually get), not Pydantic code defaults.
 
+## Translation
+
+The automated translation pipeline does not cover environment variable documentation. After editing the English file, manually update `zh/self-host/configuration/environments.mdx` and `ja/self-host/configuration/environments.mdx` to match.
+
 ## Post-Writing Verification
 
 After completing the document:
diff --git a/CLAUDE.md b/CLAUDE.md
index 85d750d35..f58873306 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2,6 +2,7 @@
 
 Documentation for Dify, built with Mintlify. English is the source language;
 Chinese and Japanese translations are generated automatically.
+Exception: `en/self-host/configuration/environments.mdx` is excluded from the translation pipeline and must be translated manually.
 
 ## Before Any Documentation Task
 
diff --git a/README.md b/README.md
index f8fc235f8..967855a59 100644
--- a/README.md
+++ b/README.md
@@ -97,7 +97,7 @@ This repository includes Claude Code skills in `.claude/skills/` that provide wr
 ### Guidelines
 
 - **One topic per PR.** Don't combine unrelated changes.
-- **English only.** Translations are handled automatically.
+- **English only.** Translations are handled automatically, except for `en/self-host/configuration/environments.mdx` which must be translated manually.
 - **Update navigation.** If you add a new page, add it to the English section of `docs.json`.
 - **Test locally.** Run `mintlify dev` to verify your changes render correctly before opening a PR.
 - **No secrets.** Never commit API keys, credentials, or `.env` files.

From 3592e15cf189057dbb1d79920842d06feb2ebf8a Mon Sep 17 00:00:00 2001
From: Riskey <36894937+RiskeyL@users.noreply.github.com>
Date: Thu, 9 Apr 2026 16:30:28 +0800
Subject: [PATCH 2/2] Update .claude/skills/dify-docs-env-vars/SKILL.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 .claude/skills/dify-docs-env-vars/SKILL.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.claude/skills/dify-docs-env-vars/SKILL.md b/.claude/skills/dify-docs-env-vars/SKILL.md
index 62ccfeb77..a1ce22cd0 100644
--- a/.claude/skills/dify-docs-env-vars/SKILL.md
+++ b/.claude/skills/dify-docs-env-vars/SKILL.md
@@ -139,7 +139,7 @@ Use `.env.example` defaults (what Docker Compose users actually get), not Pydant
 
 ## Translation
 
-The automated translation pipeline does not cover environment variable documentation. After editing the English file, manually update `zh/self-host/configuration/environments.mdx` and `ja/self-host/configuration/environments.mdx` to match.
+The automated translation pipeline does not cover `en/self-host/configuration/environments.mdx`. After editing that English file, manually update `zh/self-host/configuration/environments.mdx` and `ja/self-host/configuration/environments.mdx` to match.
 
 ## Post-Writing Verification