diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx
index dee993987..5210c0030 100644
--- a/ai/llmstxt.mdx
+++ b/ai/llmstxt.mdx
@@ -121,3 +121,12 @@ Mintlify automatically hosts an `llms-full.txt` file at the root of your project
To add a custom `llms.txt` or `llms-full.txt` file, create an `llms.txt` or `llms-full.txt` file at the root of your project. Adding a custom file overrides the automatically generated file of the same name. If you delete a custom file, Mintlify restores the automatically generated file.
Your custom `llms.txt` or `llms-full.txt` file must have a site title as an H1 heading. Other content is optional. See [Format](https://llmstxt.org/#format) in the `llms.txt` specification for more information on optional sections and best practices.
+
+### Custom files on authenticated sites
+
+On sites with [authentication](/deploy/authentication-setup) enabled, Mintlify checks the pages that your custom file links to or embeds each time your site updates:
+
+- If every linked page is public, Mintlify serves your custom file to all visitors, including AI tools that cannot authenticate.
+- If any linked page requires authentication or is restricted to user groups, Mintlify serves your custom file only to authenticated users. Anonymous visitors receive the automatically generated file instead.
+
+If anonymous visitors see the generated file instead of your custom file, see [Fix a custom llms.txt that anonymous visitors cannot see](/help-center/custom-llms-txt-shows-generated-index).
diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx
index bf460f857..df71907b1 100644
--- a/deploy/authentication-setup.mdx
+++ b/deploy/authentication-setup.mdx
@@ -509,7 +509,7 @@ Some features behave differently or are unavailable when you enable authenticati
| Feature | Public | Fully authenticated (all pages protected) | Partially authenticated (some public pages) |
| :------ | :---------- | :---------------------------------- | :-------------------------------- |
-| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files | Publicly accessible, reflecting public pages only |
+| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files | Publicly accessible, reflecting public pages only. [Custom files](/ai/llmstxt#custom-files-on-authenticated-sites) that link only to public pages are served publicly |
| [MCP server](/ai/model-context-protocol) | Full support | Requires authentication to connect | Available without authentication for public pages and with authentication for protected pages |
| [Markdown export](/ai/markdown-export) | Full support | Full support, respects user groups | Full support, respects user groups |
| [PDF export](/optimize/pdf-exports) | Full support | Full support, respects user groups. Authenticated pages export with images and assets included. | Full support, respects user groups. Authenticated pages export with images and assets included. |
diff --git a/docs.json b/docs.json
index a917458ea..6c14d0dd5 100644
--- a/docs.json
+++ b/docs.json
@@ -487,7 +487,8 @@
"help-center/domain-already-claimed-by-another-organization",
"help-center/configure-oauth-with-auth0",
"help-center/private-repo-missing-when-creating-second-deployment",
- "help-center/static-file-not-served"
+ "help-center/static-file-not-served",
+ "help-center/custom-llms-txt-shows-generated-index"
]
}
]
diff --git a/es.json b/es.json
index 1b51be683..6e93d8a6e 100644
--- a/es.json
+++ b/es.json
@@ -465,7 +465,8 @@
"es/help-center/domain-already-claimed-by-another-organization",
"es/help-center/configure-oauth-with-auth0",
"es/help-center/private-repo-missing-when-creating-second-deployment",
- "es/help-center/static-file-not-served"
+ "es/help-center/static-file-not-served",
+ "es/help-center/custom-llms-txt-shows-generated-index"
]
}
]
diff --git a/es/ai/llmstxt.mdx b/es/ai/llmstxt.mdx
index fb173516a..d5da8706c 100644
--- a/es/ai/llmstxt.mdx
+++ b/es/ai/llmstxt.mdx
@@ -129,3 +129,14 @@ Mintlify aloja automáticamente un archivo `llms-full.txt` en la raíz de tu pro
Para agregar un archivo personalizado `llms.txt` o `llms-full.txt`, crea un archivo `llms.txt` o `llms-full.txt` en la raíz de tu proyecto. Agregar un archivo personalizado reemplazará el archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, Mintlify restaura el archivo generado automáticamente.
Tu archivo personalizado `llms.txt` o `llms-full.txt` debe incluir el título del sitio como encabezado H1. El resto del contenido es opcional. Consulta [Format](https://llmstxt.org/#format) en la especificación de `llms.txt` para obtener más información sobre secciones opcionales y buenas prácticas.
+
+
+ ### Archivos personalizados en sitios autenticados
+
+
+En los sitios con [autenticación](/es/deploy/authentication-setup) habilitada, Mintlify comprueba las páginas que tu archivo personalizado enlaza o incrusta cada vez que tu sitio se actualiza:
+
+- Si todas las páginas enlazadas son públicas, Mintlify sirve tu archivo personalizado a todos los visitantes, incluidas las herramientas de IA que no pueden autenticarse.
+- Si alguna página enlazada requiere autenticación o está restringida a grupos de usuarios, Mintlify sirve tu archivo personalizado solo a usuarios autenticados. Los visitantes anónimos reciben el archivo generado automáticamente en su lugar.
+
+Si los visitantes anónimos ven el archivo generado en lugar de tu archivo personalizado, consulta [Corregir un llms.txt personalizado que los visitantes anónimos no pueden ver](/es/help-center/custom-llms-txt-shows-generated-index).
diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx
index b88460193..d0d5bf000 100644
--- a/es/deploy/authentication-setup.mdx
+++ b/es/deploy/authentication-setup.mdx
@@ -572,7 +572,7 @@ Algunas funciones se comportan de manera diferente o no están disponibles cuand
| Función | Público | Totalmente autenticado (todas las páginas protegidas) | Parcialmente autenticado (algunas páginas públicas) |
| :----------------------------------------------------------- | :---------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |
-| [llms.txt and llms-full.txt](/es/ai/llmstxt) | Compatibilidad completa | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos |
+| [llms.txt and llms-full.txt](/es/ai/llmstxt) | Compatibilidad completa | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | Accesibles públicamente, reflejando solo las páginas públicas. Los [archivos personalizados](/es/ai/llmstxt#custom-files-on-authenticated-sites) que solo enlazan a páginas públicas se sirven públicamente |
| [Servidor MCP](/es/ai/model-context-protocol) | Compatibilidad completa | Requiere autenticación para conectarse | Disponible sin autenticación para páginas públicas y con autenticación para páginas protegidas |
| [Exportación a Markdown](/es/ai/markdown-export) | Compatibilidad completa | Compatibilidad completa, respeta los grupos de usuarios | Compatibilidad completa, respeta los grupos de usuarios |
| [Exportación a PDF](/es/optimize/pdf-exports) | Compatibilidad completa | Compatibilidad completa, respeta los grupos de usuarios. Las páginas autenticadas se exportan con imágenes y recursos incluidos. | Compatibilidad completa, respeta los grupos de usuarios. Las páginas autenticadas se exportan con imágenes y recursos incluidos. |
diff --git a/es/help-center/custom-llms-txt-shows-generated-index.mdx b/es/help-center/custom-llms-txt-shows-generated-index.mdx
new file mode 100644
index 000000000..fcaf598eb
--- /dev/null
+++ b/es/help-center/custom-llms-txt-shows-generated-index.mdx
@@ -0,0 +1,28 @@
+---
+title: "Corregir un llms.txt personalizado que los visitantes anónimos no pueden ver"
+description: "Diagnostica por qué los visitantes anónimos de tu sitio de documentación autenticado reciben el llms.txt generado en lugar de tu archivo llms.txt o llms-full.txt personalizado."
+keywords: ["custom llms.txt not showing", "llms.txt generated index", "llms-full.txt override", "authentication llms.txt", "anonymous visitors"]
+---
+
+En los sitios de documentación con [autenticación](/es/deploy/authentication-setup) habilitada, Mintlify solo sirve un [archivo `llms.txt` o `llms-full.txt` personalizado](/es/ai/llmstxt#custom-files) a los visitantes anónimos cuando todas las páginas a las que hace referencia el archivo son públicas. Si tu archivo personalizado hace referencia a alguna página protegida, los visitantes anónimos reciben el archivo generado automáticamente en su lugar, mientras que los usuarios autenticados siguen recibiendo tu archivo personalizado.
+
+## Cómo decide Mintlify la visibilidad
+
+Cada vez que tu sitio se actualiza, Mintlify examina tu archivo personalizado en busca de referencias a páginas en dos formas:
+
+- Enlaces de Markdown, como `[Quickstart](/quickstart)` o `[Quickstart](https://docs.example.com/quickstart.md)`.
+- Líneas `Source:` que incrustan el contenido de una página, que aparecen en archivos de estilo `llms-full.txt`.
+
+Una página referenciada cuenta como pública cuando su frontmatter establece `public: true` y no tiene restricción de `groups`. Si todas las páginas referenciadas son públicas, o el archivo no hace referencia a ninguna página, Mintlify sirve el archivo personalizado a todos. Si alguna página referenciada está protegida, el archivo personalizado solo se sirve a usuarios autenticados.
+
+Esta comprobación se aplica a los archivos `llms.txt` y `llms-full.txt` personalizados. Otros archivos de reemplazo, como `robots.txt` y `sitemap.xml`, no se ven afectados.
+
+## Solucionar el problema
+
+1. Abre tu archivo personalizado y enumera todas las páginas que enlaza o incrusta.
+2. Para cada página, confirma que el frontmatter de la página incluye `public: true` y no tiene la propiedad `groups`. Consulta [Hacer páginas públicas](/es/deploy/authentication-setup#make-pages-public).
+3. Elimina o reemplaza las referencias a páginas que deben permanecer protegidas.
+4. Confirma el cambio y espera a que se complete el despliegue. Mintlify vuelve a evaluar la visibilidad en cada actualización.
+5. Verifica solicitando el archivo sin iniciar sesión, por ejemplo `curl https://docs.example.com/llms.txt`.
+
+Si todo tu sitio requiere autenticación, no hay páginas públicas a las que hacer referencia, por lo que un archivo personalizado que enlaza a tu documentación siempre se sirve tras la autenticación.
diff --git a/fr.json b/fr.json
index 7c90170ea..6669c4759 100644
--- a/fr.json
+++ b/fr.json
@@ -465,7 +465,8 @@
"fr/help-center/domain-already-claimed-by-another-organization",
"fr/help-center/configure-oauth-with-auth0",
"fr/help-center/private-repo-missing-when-creating-second-deployment",
- "fr/help-center/static-file-not-served"
+ "fr/help-center/static-file-not-served",
+ "fr/help-center/custom-llms-txt-shows-generated-index"
]
}
]
diff --git a/fr/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx
index a5f9130c0..395ad1fb2 100644
--- a/fr/ai/llmstxt.mdx
+++ b/fr/ai/llmstxt.mdx
@@ -129,3 +129,14 @@ Mintlify héberge automatiquement un fichier `llms-full.txt` à la racine de vot
Pour ajouter un fichier `llms.txt` ou `llms-full.txt` personnalisé, créez un fichier `llms.txt` ou `llms-full.txt` à la racine de votre projet. L'ajout d'un fichier personnalisé remplace le fichier généré automatiquement portant le même nom. Si vous supprimez un fichier personnalisé, Mintlify restaure le fichier généré automatiquement.
Votre fichier `llms.txt` ou `llms-full.txt` personnalisé doit comporter le titre du site en tant que niveau de titre H1. Le reste du contenu est facultatif. Consultez [Format](https://llmstxt.org/#format) dans la spécification `llms.txt` pour plus d'informations sur les sections facultatives et les bonnes pratiques.
+
+
+ ### Fichiers personnalisés sur les sites authentifiés
+
+
+Sur les sites avec l'[authentification](/fr/deploy/authentication-setup) activée, Mintlify vérifie les pages que votre fichier personnalisé lie ou intègre à chaque mise à jour de votre site :
+
+- Si toutes les pages liées sont publiques, Mintlify sert votre fichier personnalisé à tous les visiteurs, y compris les outils d'IA qui ne peuvent pas s'authentifier.
+- Si une page liée nécessite une authentification ou est restreinte à des groupes d'utilisateurs, Mintlify ne sert votre fichier personnalisé qu'aux utilisateurs authentifiés. Les visiteurs anonymes reçoivent le fichier généré automatiquement à la place.
+
+Si les visiteurs anonymes voient le fichier généré au lieu de votre fichier personnalisé, consultez [Corriger un llms.txt personnalisé invisible pour les visiteurs anonymes](/fr/help-center/custom-llms-txt-shows-generated-index).
diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx
index e4d6aff5a..2d02633bb 100644
--- a/fr/deploy/authentication-setup.mdx
+++ b/fr/deploy/authentication-setup.mdx
@@ -572,7 +572,7 @@ Certaines fonctionnalités se comportent différemment ou ne sont pas disponible
| Fonctionnalité | Public | Entièrement authentifié (toutes les pages protégées) | Partiellement authentifié (certaines pages publiques) |
| :------------------------------------------------------- | :----------------------- | :--------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- |
-| [llms.txt and llms-full.txt](/fr/ai/llmstxt) | Prise en charge complète | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers |
+| [llms.txt and llms-full.txt](/fr/ai/llmstxt) | Prise en charge complète | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers | Accessibles publiquement, en ne reflétant que les pages publiques. Les [fichiers personnalisés](/fr/ai/llmstxt#custom-files-on-authenticated-sites) qui ne lient que des pages publiques sont servis publiquement |
| [MCP server](/fr/ai/model-context-protocol) | Prise en charge complète | Nécessite une authentification pour se connecter | Disponible sans authentification pour les pages publiques et avec authentification pour les pages protégées |
| [Markdown export](/fr/ai/markdown-export) | Prise en charge complète | Prise en charge complète, respecte les groupes d’utilisateurs | Prise en charge complète, respecte les groupes d’utilisateurs |
| [Export PDF](/fr/optimize/pdf-exports) | Prise en charge complète | Prise en charge complète, respecte les groupes d'utilisateurs. Les pages authentifiées sont exportées avec les images et les ressources incluses. | Prise en charge complète, respecte les groupes d'utilisateurs. Les pages authentifiées sont exportées avec les images et les ressources incluses. |
diff --git a/fr/help-center/custom-llms-txt-shows-generated-index.mdx b/fr/help-center/custom-llms-txt-shows-generated-index.mdx
new file mode 100644
index 000000000..c33afe46f
--- /dev/null
+++ b/fr/help-center/custom-llms-txt-shows-generated-index.mdx
@@ -0,0 +1,28 @@
+---
+title: "Corriger un llms.txt personnalisé invisible pour les visiteurs anonymes"
+description: "Diagnostiquez pourquoi les visiteurs anonymes de votre site de documentation authentifié reçoivent le llms.txt généré au lieu de votre fichier llms.txt ou llms-full.txt personnalisé."
+keywords: ["custom llms.txt not showing", "llms.txt generated index", "llms-full.txt override", "authentication llms.txt", "anonymous visitors"]
+---
+
+Sur les sites de documentation avec l'[authentification](/fr/deploy/authentication-setup) activée, Mintlify ne sert un [fichier `llms.txt` ou `llms-full.txt` personnalisé](/fr/ai/llmstxt#custom-files) aux visiteurs anonymes que lorsque toutes les pages référencées par le fichier sont publiques. Si votre fichier personnalisé référence une page protégée, les visiteurs anonymes reçoivent le fichier généré automatiquement à la place, tandis que les utilisateurs authentifiés reçoivent toujours votre fichier personnalisé.
+
+## Comment Mintlify détermine la visibilité
+
+À chaque mise à jour de votre site, Mintlify analyse votre fichier personnalisé à la recherche de références à des pages sous deux formes :
+
+- Les liens Markdown, comme `[Quickstart](/quickstart)` ou `[Quickstart](https://docs.example.com/quickstart.md)`.
+- Les lignes `Source:` qui intègrent le contenu d'une page, présentes dans les fichiers de type `llms-full.txt`.
+
+Une page référencée compte comme publique lorsque son frontmatter définit `public: true` et qu'elle n'a pas de restriction `groups`. Si toutes les pages référencées sont publiques, ou si le fichier ne référence aucune page, Mintlify sert le fichier personnalisé à tout le monde. Si une page référencée est protégée, le fichier personnalisé n'est servi qu'aux utilisateurs authentifiés.
+
+Cette vérification s'applique aux fichiers `llms.txt` et `llms-full.txt` personnalisés. Les autres fichiers de remplacement, comme `robots.txt` et `sitemap.xml`, ne sont pas concernés.
+
+## Résoudre le problème
+
+1. Ouvrez votre fichier personnalisé et listez toutes les pages qu'il lie ou intègre.
+2. Pour chaque page, confirmez que le frontmatter de la page inclut `public: true` et n'a pas de propriété `groups`. Consultez [Rendre des pages publiques](/fr/deploy/authentication-setup#make-pages-public).
+3. Supprimez ou remplacez les références aux pages qui doivent rester protégées.
+4. Validez la modification et attendez la fin du déploiement. Mintlify réévalue la visibilité à chaque mise à jour.
+5. Vérifiez en demandant le fichier sans vous connecter, par exemple `curl https://docs.example.com/llms.txt`.
+
+Si l'ensemble de votre site nécessite une authentification, il n'y a pas de pages publiques à référencer, donc un fichier personnalisé qui lie votre documentation est toujours servi derrière l'authentification.
diff --git a/help-center/custom-llms-txt-shows-generated-index.mdx b/help-center/custom-llms-txt-shows-generated-index.mdx
new file mode 100644
index 000000000..9e3ab643a
--- /dev/null
+++ b/help-center/custom-llms-txt-shows-generated-index.mdx
@@ -0,0 +1,28 @@
+---
+title: "Fix a custom llms.txt that anonymous visitors cannot see"
+description: "Diagnose why anonymous visitors to your authenticated docs site get the generated llms.txt instead of your custom llms.txt or llms-full.txt file."
+keywords: ["custom llms.txt not showing", "llms.txt generated index", "llms-full.txt override", "authentication llms.txt", "anonymous visitors"]
+---
+
+On documentation sites with [authentication](/deploy/authentication-setup) enabled, Mintlify only serves a [custom `llms.txt` or `llms-full.txt` file](/ai/llmstxt#custom-files) to anonymous visitors when every page the file references is public. If your custom file references any protected page, anonymous visitors receive the automatically generated file instead, while authenticated users still receive your custom file.
+
+## How Mintlify decides visibility
+
+Each time your site updates, Mintlify scans your custom file for page references in two forms:
+
+- Markdown links, like `[Quickstart](/quickstart)` or `[Quickstart](https://docs.example.com/quickstart.md)`.
+- `Source:` lines that embed page content, which appear in `llms-full.txt` style files.
+
+A referenced page counts as public when its frontmatter sets `public: true` and it has no `groups` restriction. If every referenced page is public, or the file references no pages at all, Mintlify serves the custom file to everyone. If any referenced page is protected, the custom file is only served to authenticated users.
+
+This check applies to custom `llms.txt` and `llms-full.txt` files. Other overrides, like `robots.txt` and `sitemap.xml`, are not affected.
+
+## Fix the issue
+
+1. Open your custom file and list every page it links to or embeds.
+2. For each page, confirm the page's frontmatter includes `public: true` and no `groups` property. See [Make pages public](/deploy/authentication-setup#make-pages-public).
+3. Remove or replace references to pages that must stay protected.
+4. Commit the change and wait for the deployment to complete. Mintlify re-evaluates visibility on every update.
+5. Verify by requesting the file without signing in, for example `curl https://docs.example.com/llms.txt`.
+
+If your entire site requires authentication, there are no public pages to reference, so a custom file that links to your documentation is always served behind authentication.
diff --git a/zh.json b/zh.json
index d0dba6a96..3fe63ef99 100644
--- a/zh.json
+++ b/zh.json
@@ -465,7 +465,8 @@
"zh/help-center/domain-already-claimed-by-another-organization",
"zh/help-center/configure-oauth-with-auth0",
"zh/help-center/private-repo-missing-when-creating-second-deployment",
- "zh/help-center/static-file-not-served"
+ "zh/help-center/static-file-not-served",
+ "zh/help-center/custom-llms-txt-shows-generated-index"
]
}
]
diff --git a/zh/ai/llmstxt.mdx b/zh/ai/llmstxt.mdx
index fe5f875ac..c0f71c7e3 100644
--- a/zh/ai/llmstxt.mdx
+++ b/zh/ai/llmstxt.mdx
@@ -129,3 +129,14 @@ Mintlify 会在你的项目根目录自动托管一个 `llms-full.txt` 文件。
要添加自定义的 `llms.txt` 或 `llms-full.txt` 文件，请在项目根目录创建同名文件。添加自定义文件会覆盖同名的自动生成文件。如果你删除自定义文件，Mintlify 会恢复使用同名的自动生成文件。
自定义的 `llms.txt` 或 `llms-full.txt` 文件必须包含一个以 H1 标题呈现的站点标题。其他内容为可选。有关可选部分和最佳实践的更多信息，请参阅 `llms.txt` 规范中的[Format](https://llmstxt.org/#format)。
+
+
+ ### 启用身份验证的站点上的自定义文件
+
+
+在启用了[身份验证](/zh/deploy/authentication-setup)的站点上，每次站点更新时，Mintlify 都会检查自定义文件中链接或嵌入的页面：
+
+- 如果所有链接的页面都是公开的，Mintlify 会向所有访问者提供你的自定义文件，包括无法进行身份验证的 AI 工具。
+- 如果任何链接的页面需要身份验证或仅限特定用户组访问，Mintlify 只向已通过身份验证的用户提供你的自定义文件。匿名访问者将收到自动生成的文件。
+
+如果匿名访问者看到的是生成的文件而不是你的自定义文件，请参阅[修复匿名访问者无法看到的自定义 llms.txt](/zh/help-center/custom-llms-txt-shows-generated-index)。
diff --git a/zh/deploy/authentication-setup.mdx b/zh/deploy/authentication-setup.mdx
index a36383b43..89361eb7e 100644
--- a/zh/deploy/authentication-setup.mdx
+++ b/zh/deploy/authentication-setup.mdx
@@ -572,7 +572,7 @@ groups: ["admin"]
| 功能 | 公开 | 完全认证 (所有页面受保护) | 部分认证 (部分页面公开) |
| :------------------------------------------------------- | :--- | :----------------------------- | :----------------------------- |
-| [llms.txt 和 llms-full.txt](/zh/ai/llmstxt) | 完全支持 | 需要通过认证后才能访问，因此 AI 工具可能无法访问这些文件 | 可公开访问，仅反映公开页面 |
+| [llms.txt 和 llms-full.txt](/zh/ai/llmstxt) | 完全支持 | 需要通过认证后才能访问，因此 AI 工具可能无法访问这些文件 | 可公开访问，仅反映公开页面。仅链接公开页面的[自定义文件](/zh/ai/llmstxt#custom-files-on-authenticated-sites)会公开提供 |
| [MCP 服务器](/zh/ai/model-context-protocol) | 完全支持 | 连接时需要认证 | 公开页面无需认证即可使用，受保护页面则需要认证 |
| [Markdown 导出](/zh/ai/markdown-export) | 完全支持 | 完全支持，尊重用户分组 | 完全支持，尊重用户分组 |
| [PDF 导出](/zh/optimize/pdf-exports) | 完全支持 | 完全支持，尊重用户分组。已认证页面在导出时会包含图片和资源。 | 完全支持，尊重用户分组。已认证页面在导出时会包含图片和资源。 |
diff --git a/zh/help-center/custom-llms-txt-shows-generated-index.mdx b/zh/help-center/custom-llms-txt-shows-generated-index.mdx
new file mode 100644
index 000000000..99f0384be
--- /dev/null
+++ b/zh/help-center/custom-llms-txt-shows-generated-index.mdx
@@ -0,0 +1,28 @@
+---
+title: "修复匿名访问者无法看到的自定义 llms.txt"
+description: "诊断为什么启用身份验证的文档站点的匿名访问者收到的是自动生成的 llms.txt，而不是你的自定义 llms.txt 或 llms-full.txt 文件。"
+keywords: ["custom llms.txt not showing", "llms.txt generated index", "llms-full.txt override", "authentication llms.txt", "anonymous visitors"]
+---
+
+在启用了[身份验证](/zh/deploy/authentication-setup)的文档站点上，只有当[自定义 `llms.txt` 或 `llms-full.txt` 文件](/zh/ai/llmstxt#custom-files)引用的所有页面都是公开的时，Mintlify 才会向匿名访问者提供该文件。如果你的自定义文件引用了任何受保护的页面，匿名访问者将收到自动生成的文件，而已通过身份验证的用户仍会收到你的自定义文件。
+
+## Mintlify 如何判定可见性
+
+每次站点更新时，Mintlify 都会扫描你的自定义文件中两种形式的页面引用：
+
+- Markdown 链接，例如 `[Quickstart](/quickstart)` 或 `[Quickstart](https://docs.example.com/quickstart.md)`。
+- 嵌入页面内容的 `Source:` 行，常见于 `llms-full.txt` 风格的文件。
+
+当被引用页面的 frontmatter 设置了 `public: true` 且没有 `groups` 限制时，该页面才算公开。如果所有被引用的页面都是公开的，或者文件没有引用任何页面，Mintlify 会向所有人提供该自定义文件。如果任何被引用的页面受保护，该自定义文件只会提供给已通过身份验证的用户。
+
+此检查适用于自定义的 `llms.txt` 和 `llms-full.txt` 文件。其他覆盖文件（如 `robots.txt` 和 `sitemap.xml`）不受影响。
+
+## 解决问题
+
+1. 打开你的自定义文件，列出它链接或嵌入的所有页面。
+2. 对于每个页面，确认页面的 frontmatter 包含 `public: true` 且没有 `groups` 属性。参见[将页面设为公开](/zh/deploy/authentication-setup#make-pages-public)。
+3. 删除或替换对必须保持受保护的页面的引用。
+4. 提交更改并等待部署完成。Mintlify 会在每次更新时重新评估可见性。
+5. 在未登录的情况下请求该文件进行验证，例如 `curl https://docs.example.com/llms.txt`。
+
+如果你的整个站点都需要身份验证，则没有可引用的公开页面，因此链接到文档的自定义文件始终只在身份验证后提供。