Ajustes para os exports dos módulos e versão e documentação

Author: nicolasaigner

NicolasAigner.SystemToolkit.psd1

@@ -4,10 +4,16 @@
     GUID              = '8b2042b8-550d-46b7-b4b8-7b34154bae01'
     Author            = 'Nícolas Aigner'
     CompanyName       = 'Nícolas Aigner'
-    Description       = 'Ferramentas PowerShell para backup/merge de variáveis de ambiente, exportação de registro e compactação tar.gz.'
+    Description       = 'Ferramentas PowerShell para backup/merge de variáveis de ambiente, exportação de registro, macro keyboard e compactação tar.gz.'
     PowerShellVersion = '5.1'
     CompatiblePSEditions = @('Desktop','Core')
-    FunctionsToExport = @('Export-EnvBackup','Merge-EnvFromBackup','Export-RegistrySelection','Compress-FolderToTarGz')
+    FunctionsToExport = @(
+        'Export-EnvBackup',
+        'Merge-EnvFromBackup',
+        'Export-RegistrySelection',
+        'Compress-FolderToTarGz',
+        'Update-MacroKeyboard'
+    )
     CmdletsToExport   = @()
     AliasesToExport   = @()
 }

README.md

@@ -2,10 +2,11 @@
 
 Ferramentas PowerShell para:
 
-* **Export-EnvBackup** — backup completo das variáveis de ambiente em `.reg` + `.json`;
-* **Merge-EnvFromBackup** — merge interativo desses backups;
-* **Export-RegistrySelection** — exportação filtrada de chaves do Registro;
+* **Export-EnvBackup** — backup completo das variáveis de ambiente em `.reg` + `.json`.
+* **Merge-EnvFromBackup** — merge interativo desses backups.
+* **Export-RegistrySelection** — exportação filtrada de chaves do Registro.
 * **Compress-FolderToTarGz** — compactação de pastas em `.tar.gz`.
+* **Update-MacroKeyboard** — valida e envia configuração do teclado macro via ch57x-keyboard-tool.
 
 ## Instalação
 
@@ -16,4 +17,36 @@ Import-Module NicolasAigner.SystemToolkit
 
 ## Build & Publish
 
-Este repositório contém workflow GitHub Actions que publica no PowerShell Gallery quando uma tag `v*` for criada. Há também manifesto winget para instalação via `winget install NicolasAigner.SystemToolkit`.
+Este repositório contém workflow GitHub Actions que publica no PowerShell Gallery quando uma tag `v*` for criada.
+
+## Uso
+
+### Export-EnvBackup
+
+```powershell
+Export-EnvBackup -BackupDir 'EnvBackup-20250429-001846'
+```
+
+### Merge-EnvFromBackup
+
+```powershell
+Merge-EnvFromBackup -BackupDir 'EnvBackup-20250429-001846'
+```
+
+### Export-RegistrySelection
+
+```powershell
+Export-RegistrySelection -Path 'HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment'
+```
+
+### Compress-FolderToTarGz
+
+```powershell
+Compress-FolderToTarGz -Path 'C:\Temp\MyFolder' -Destination 'C:\Temp\MyFolder.tar.gz'
+```
+
+### Update-MacroKeyboard
+
+```powershell
+Update-MacroKeyboard -Path "ch57x-keyboard-tool.exe" -ConfigFile "mapping.yaml"
+```