📝 [docs] Add Portuguese (pt) localization and full cmdlet help

 - Add complete Portuguese documentation and localized message catalog to support pt locale:
   - ColorScripts-Enhanced/pt/Messages.psd1
   - ColorScripts-Enhanced/pt/New-ColorScript.md
   - ColorScripts-Enhanced/pt/New-ColorScriptCache.md
   - ColorScripts-Enhanced/pt/Reset-ColorScriptConfiguration.md
   - ColorScripts-Enhanced/pt/Set-ColorScriptConfiguration.md
   - ColorScripts-Enhanced/pt/Show-ColorScript.md
   - ColorScripts-Enhanced/pt/about_ColorScripts-Enhanced.help.txt
 - Provide localized error/warning/status strings and rich, translated examples, syntax, parameters and advanced usage for all major cmdlets.

🚜 [refactor] Rework and expand Russian (ru) help content and examples
 - Substantially rewrite and harmonize many ru help pages with clearer structure, expanded examples and advanced usage (CI/CD, automation, cache strategies):
   - ColorScripts-Enhanced/ru/Add-ColorScriptProfile.md (refined syntax, -Path/-Scope handling, verification examples)
   - ColorScripts-Enhanced/ru/Clear-ColorScriptCache.md (feature-rich parameters, dry-run, pipeline usage, reporting)
   - ColorScripts-Enhanced/ru/Export-ColorScriptMetadata.md (enriched output options, IncludeFileInfo/IncludeCacheInfo, API/reporting)
   - ColorScripts-Enhanced/ru/Get-ColorScriptConfiguration.md (detailed config structure, auditing, backup/migration)
   - ColorScripts-Enhanced/ru/Get-ColorScriptList.md (Detailed/AsObject modes, performance tips)
   - ColorScripts-Enhanced/ru/New-ColorScript.md (scaffolding workflow, OutputPath/GenerateMetadataSnippet)
   - ColorScripts-Enhanced/ru/New-ColorScriptCache.md (All/Force/PassThru semantics, automation patterns)
   - ColorScripts-Enhanced/ru/Reset-ColorScriptConfiguration.md (PassThru, defaults, safety notes)
   - ColorScripts-Enhanced/ru/Show-ColorScript.md (clarified modes, ReturnText/PassThru guidance)
   - ColorScripts-Enhanced/ru/about_ColorScripts-Enhanced.help.txt (full English/clarified long-form module docs)
 - Expand advanced sections: performance measurement, filtering patterns, integration workflows, maintenance and troubleshooting.

🛠️ [fix] Polish Russian localized strings and message phrasing
 - Tidy up translation wording and fix grammatical/terminology issues within ru messages and alerts:
   - ColorScripts-Enhanced/ru/Messages.psd1 (improved phrasing for profile/cache/profile-path messages, status and warning strings)
 - Ensure consistent terminology for "profile", "cache", "session" and status labels across docs.

✨ [feat] Enrich help pages with advanced examples, pipeline & automation recipes
 - Add practical automation examples and advanced patterns across multiple help files:
   - pre-building caches, CI/CD cache deployment, progress-tracked cache builds
   - Export/metadata workflows, API-ready JSON, gallery generation and reports
   - Get-ColorScriptList / Show-ColorScript pipeline integrations and playlist examples
 - Clarify parameters like -PassThru, -ReturnText, -NoCache, -Force, -WhatIf and provide guidance for production vs development usage.

🔧 [build] Bump localized HelpInfo versions and regenerate help metadata
 - Update localized HelpInfo version stamps to reflect regenerated help files:
   - ColorScripts-Enhanced/ru/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml (version -> 2025.10.31.2127)
   - ColorScripts-Enhanced/zh-CN/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml (version -> 2025.10.31.2127)
 - Ensure help metadata and navigation links align with updated docs.

🧹 [chore] Improve cross-references and discoverability in help sets
 - Update related-links and local doc references to point to enriched md pages and GitHub repo in RU docs.
 - Add ScriptMetadata guidance references, recommended integration steps and best-practice notes (profile integration, cache tuning, backups).

🧪 [test] Add guidance for validation, auditing and troubleshooting
 - Embed health-check, cache-validation and configuration-audit examples to assist maintainers and CI:
   - examples to detect uncached/obsolete entries, measure cache impact, and perform safe rebuilds.
 - Recommend best practices for automated deployments and cross-platform use (PowerShell 7+, terminals, fonts).

Notes:
 - This commit is documentation/localization-focused: it adds Portuguese localization, refactors and enriches Russian help, fixes message text, updates help metadata versions, and adds many advanced usage examples and automation recipes to improve DX and maintainability.
Signed-off-by: Nick2bad4u <20943337+Nick2bad4u@users.noreply.github.com>

Author: Nick2bad4u

ColorScripts-Enhanced/ColorScripts-Enhanced.psd1

@@ -11,7 +11,7 @@
     RootModule = 'ColorScripts-Enhanced.psm1'
 
     # Version number of this module.
-    ModuleVersion = '2025.10.31.1954'
+    ModuleVersion = '2025.10.31.2127'
 
     # Supported PSEditions
     CompatiblePSEditions = @('Desktop', 'Core')
@@ -211,7 +211,7 @@ PERFECT FOR
 
             # ReleaseNotes of this module
             ReleaseNotes = @'
-Version 2025.10.31.1954:
+Version 2025.10.31.2127:
 - Enhanced caching system with OS-wide cache in AppData
 - 6-19x performance improvement
 - Cache stored in centralized location

ColorScripts-Enhanced/de/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml

@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>de</UICultureName>
-      <UICultureVersion>2025.10.31.1954</UICultureVersion>
+      <UICultureVersion>2025.10.31.2127</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>

ColorScripts-Enhanced/en-US/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml

@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>en-US</UICultureName>
-      <UICultureVersion>2025.10.31.1954</UICultureVersion>
+      <UICultureVersion>2025.10.31.2127</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>

ColorScripts-Enhanced/es/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml

@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>es</UICultureName>
-      <UICultureVersion>2025.10.31.1954</UICultureVersion>
+      <UICultureVersion>2025.10.31.2127</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>

ColorScripts-Enhanced/fr/ColorScripts-Enhanced_f77548d7-23eb-48ce-a6e0-f64b4758d995_HelpInfo.xml

@@ -4,7 +4,7 @@
   <SupportedUICultures>
     <UICulture>
       <UICultureName>fr</UICultureName>
-      <UICultureVersion>2025.10.31.1954</UICultureVersion>
+      <UICultureVersion>2025.10.31.2127</UICultureVersion>
     </UICulture>
   </SupportedUICultures>
 </HelpInfo>

ColorScripts-Enhanced/it/Add-ColorScriptProfile.md

@@ -0,0 +1,193 @@
+---
+document type: cmdlet
+external help file: ColorScripts-Enhanced-help.xml
+HelpUri: https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/blob/main/ColorScripts-Enhanced/it/Add-ColorScriptProfile.md
+Module Name: ColorScripts-Enhanced
+ms.date: 10/26/2025
+PlatyPS schema version: 2024-05-01
+---
+
+# Add-ColorScriptProfile
+
+## SYNOPSIS
+
+Aggiunge l'integrazione ColorScripts-Enhanced ai file di profilo PowerShell.
+
+## SYNTAX
+
+```
+Add-ColorScriptProfile [[-Scope] <string>] [-WhatIf] [-Confirm] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Aggiunge automaticamente l'integrazione di avvio ColorScripts-Enhanced al tuo profilo PowerShell. Questo cmdlet modifica i tuoi file di profilo per importare il modulo ColorScripts-Enhanced e opzionalmente visualizzare un colorscript all'avvio della sessione.
+
+Il cmdlet supporta tutti gli ambiti di profilo PowerShell standard:
+- CurrentUserCurrentHost: Profilo per l'utente corrente e l'host corrente
+- CurrentUserAllHosts: Profilo per l'utente corrente su tutti gli host
+- AllUsersCurrentHost: Profilo per tutti gli utenti sull'host corrente (richiede admin)
+- AllUsersAllHosts: Profilo per tutti gli utenti su tutti gli host (richiede admin)
+
+Quando eseguito, aggiunge uno snippet che:
+1. Importa il modulo ColorScripts-Enhanced
+2. Opzionalmente visualizza un colorscript casuale all'avvio
+3. Fornisce alias utili per l'accesso rapido
+
+L'integrazione è progettata per essere non intrusiva e può essere facilmente rimossa modificando direttamente i tuoi file di profilo.
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Add-ColorScriptProfile
+```
+
+Aggiunge l'integrazione ColorScripts-Enhanced al tuo profilo predefinito (CurrentUserCurrentHost).
+
+### EXAMPLE 2
+
+```powershell
+Add-ColorScriptProfile -Scope CurrentUserAllHosts
+```
+
+Aggiunge l'integrazione al tuo profilo che si applica a tutti gli host PowerShell per l'utente corrente.
+
+### EXAMPLE 3
+
+```powershell
+Add-ColorScriptProfile -Scope AllUsersCurrentHost
+```
+
+Aggiunge l'integrazione al profilo per tutti gli utenti sull'host corrente (richiede privilegi di amministratore).
+
+### EXAMPLE 4
+
+```powershell
+Add-ColorScriptProfile -WhatIf
+```
+
+Mostra quali modifiche verrebbero apportate al tuo profilo senza applicarle effettivamente.
+
+### EXAMPLE 5
+
+```powershell
+Add-ColorScriptProfile -Confirm
+```
+
+Richiede conferma prima di modificare il tuo profilo.
+
+## PARAMETERS
+
+### -Confirm
+
+Richiede conferma prima di eseguire il cmdlet.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+DefaultValue: false
+SupportsWildcards: false
+Aliases: cf
+ParameterSets:
+- Name: (All)
+  Position: Named
+  IsRequired: false
+  ValueFromPipeline: false
+  ValueFromPipelineByPropertyName: false
+  ValueFromRemainingArguments: false
+DontShow: false
+AcceptedValues: []
+HelpMessage: ''
+```
+
+### -Scope
+
+Specifica l'ambito del profilo da modificare. I valori validi sono:
+- CurrentUserCurrentHost (predefinito)
+- CurrentUserAllHosts
+- AllUsersCurrentHost
+- AllUsersAllHosts
+
+```yaml
+Type: System.String
+DefaultValue: CurrentUserCurrentHost
+SupportsWildcards: false
+Aliases: []
+ParameterSets:
+- Name: (All)
+  Position: Named
+  IsRequired: false
+  ValueFromPipeline: false
+  ValueFromPipelineByPropertyName: false
+  ValueFromRemainingArguments: false
+DontShow: false
+AcceptedValues: []
+HelpMessage: ''
+```
+
+### -WhatIf
+
+Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+DefaultValue: false
+SupportsWildcards: false
+Aliases: wi
+ParameterSets:
+- Name: (All)
+  Position: Named
+  IsRequired: false
+  ValueFromPipeline: false
+  ValueFromPipelineByPropertyName: false
+  ValueFromRemainingArguments: false
+DontShow: false
+AcceptedValues: []
+HelpMessage: ''
+```
+
+### CommonParameters
+
+Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable,
+-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
+-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. Per ulteriori informazioni, vedere
+[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+Questo cmdlet non accetta input dalla pipeline.
+
+## OUTPUTS
+
+### None
+
+Questo cmdlet non restituisce output alla pipeline.
+
+## NOTES
+
+**Author:** Nick
+**Module:** ColorScripts-Enhanced
+**Requires:** PowerShell 5.1 o successivo
+
+**Integrazione profilo:**
+Il cmdlet aggiunge uno snippet di avvio che importa ColorScripts-Enhanced e fornisce accesso conveniente. L'integrazione è progettata per essere leggera e non disturbare.
+
+**Considerazioni ambito:**
+- Gli ambiti CurrentUser modificano i file nella directory del profilo utente
+- Gli ambiti AllUsers richiedono privilegi di amministratore e influenzano tutti gli utenti
+- Le modifiche hanno effetto nelle nuove sessioni PowerShell
+
+**Funzionalità di sicurezza:**
+- Verifica l'integrazione esistente per evitare duplicazioni
+- Utilizza meccanismi di profilo PowerShell standard
+- Fornisce opzioni WhatIf e Confirm per operazioni sicure
+
+## RELATED LINKS
+
+- [Get-ColorScriptConfiguration](Get-ColorScriptConfiguration.md)
+- [Set-ColorScriptConfiguration](Set-ColorScriptConfiguration.md)
+- [Show-ColorScript](Show-ColorScript.md)
+- [Online Documentation](https://github.com/Nick2bad4u/ps-color-scripts-enhanced)