@yg-toolkit/datapull 0.1.0

package/resources/compatibility-matrix.json

@@ -0,0 +1,315 @@
+{
+  "version": 1,
+  "policy": "仅实际验证通过的组合可声明支持；空矩阵表示开发包尚未完成发布验收。",
+  "requiredPlatforms": [
+    "windows-10-11",
+    "macos",
+    "ubuntu-lts",
+    "debian-stable",
+    "fedora-current"
+  ],
+  "requiredEngines": [
+    "mysql",
+    "postgresql",
+    "sqlserver"
+  ],
+  "requiredSkillTargets": [
+    "codex:user",
+    "codex:project",
+    "claude:user",
+    "claude:project",
+    "cursor:user",
+    "cursor:project",
+    "trae:user",
+    "trae:project"
+  ],
+  "verified": [
+    {
+      "engine": "mysql",
+      "serverVersion": "8.4.11",
+      "clientTools": "mysql=mysql  Ver 26.7.0 for Win64 on x86_64 (MySQL Community Server - GPL)",
+      "platform": "windows-10-11",
+      "osVersion": "win32 x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T14:59:41.860Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "postgresql",
+      "serverVersion": "18.6",
+      "clientTools": "psql=psql (PostgreSQL) 18.3; pg_dump=pg_dump (PostgreSQL) 18.3",
+      "platform": "windows-10-11",
+      "osVersion": "win32 x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T14:59:47.825Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "sqlserver",
+      "serverVersion": "15.0.2000.5",
+      "clientTools": "sqlcmd=Microsoft (R) SQL Server Command Line Tool; pwsh=PowerShell 7.6.6; sqlserver-module=22.4.5.1",
+      "platform": "windows-10-11",
+      "osVersion": "win32 x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T14:59:58.184Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "mysql",
+      "serverVersion": "8.4.11",
+      "clientTools": "mysql=mysql  Ver 26.7.0 for macos14.8 on x86_64 (Homebrew)",
+      "platform": "macos",
+      "osVersion": "darwin x64 macos15",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:32:31.837Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "postgresql",
+      "serverVersion": "18.6",
+      "clientTools": "psql=psql (PostgreSQL) 18.6; pg_dump=pg_dump (PostgreSQL) 18.6",
+      "platform": "macos",
+      "osVersion": "darwin x64 macos15",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:33:11.039Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "sqlserver",
+      "serverVersion": "15.0.2000.5",
+      "clientTools": "sqlcmd=sqlcmd: Install/Create/Query SQL Server, Azure SQL, and Tools; pwsh=PowerShell 7.6.4; sqlserver-module=22.4.5.1",
+      "platform": "macos",
+      "osVersion": "darwin x64 macos15",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:34:19.252Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "mysql",
+      "serverVersion": "8.4.11",
+      "clientTools": "mysql=mysql  Ver 8.0.46-0ubuntu0.24.04.4 for Linux on x86_64 ((Ubuntu))",
+      "platform": "ubuntu-lts",
+      "osVersion": "linux x64 ubuntu24",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:31:37.703Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "postgresql",
+      "serverVersion": "18.6",
+      "clientTools": "psql=psql (PostgreSQL) 18.6 (Ubuntu 18.6-1.pgdg24.04+2); pg_dump=pg_dump (PostgreSQL) 18.6 (Ubuntu 18.6-1.pgdg24.04+2)",
+      "platform": "ubuntu-lts",
+      "osVersion": "linux x64 ubuntu24",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:32:29.546Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "sqlserver",
+      "serverVersion": "15.0.2000.5",
+      "clientTools": "sqlcmd=Microsoft (R) SQL Server Command Line Tool; pwsh=PowerShell 7.6.6; sqlserver-module=22.4.5.1",
+      "platform": "ubuntu-lts",
+      "osVersion": "linux x64 ubuntu24",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:33:59.284Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "mysql",
+      "serverVersion": "8.4.11",
+      "clientTools": "mysql=mysql  Ver 8.4.11 for Linux on x86_64 (MySQL Community Server - GPL)",
+      "platform": "debian-stable",
+      "osVersion": "linux x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:23:52.618Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "postgresql",
+      "serverVersion": "18.6",
+      "clientTools": "psql=psql (PostgreSQL) 18.6 (Debian 18.6-1.pgdg13+2); pg_dump=pg_dump (PostgreSQL) 18.6 (Debian 18.6-1.pgdg13+2)",
+      "platform": "debian-stable",
+      "osVersion": "linux x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:23:57.196Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "sqlserver",
+      "serverVersion": "15.0.2000.5",
+      "clientTools": "sqlcmd=sqlcmd: Install/Create/Query SQL Server, Azure SQL, and Tools; pwsh=PowerShell 7.6.6; sqlserver-module=22.4.5.1",
+      "platform": "debian-stable",
+      "osVersion": "linux x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:24:10.099Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "mysql",
+      "serverVersion": "8.4.11",
+      "clientTools": "mysql=mysql  Ver 8.4.10 for Linux on x86_64 (Source distribution)",
+      "platform": "fedora-current",
+      "osVersion": "linux x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:29:22.634Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "postgresql",
+      "serverVersion": "18.6",
+      "clientTools": "psql=psql (PostgreSQL) 18.6; pg_dump=pg_dump (PostgreSQL) 18.6",
+      "platform": "fedora-current",
+      "osVersion": "linux x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:29:27.221Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "engine": "sqlserver",
+      "serverVersion": "15.0.2000.5",
+      "clientTools": "sqlcmd=sqlcmd: Install/Create/Query SQL Server, Azure SQL, and Tools; pwsh=PowerShell 7.6.6; sqlserver-module=22.4.5.1",
+      "platform": "fedora-current",
+      "osVersion": "linux x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "installAdapterVersion": 1,
+      "verifiedAt": "2026-09-18T15:29:35.917Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    }
+  ],
+  "platformVerifications": [
+    {
+      "platform": "windows-10-11",
+      "osVersion": "win32 x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "npmInstall": true,
+      "skillTargets": [
+        "codex:user",
+        "codex:project",
+        "claude:user",
+        "claude:project",
+        "cursor:user",
+        "cursor:project",
+        "trae:user",
+        "trae:project"
+      ],
+      "agentDiscoveryVerified": false,
+      "agentDiscoveryNote": "CI 已验证 8 个用户级/项目级安装路径与回验；Windows 上 Codex 用户级和项目级实际发现通过。Claude Code 因当前账号返回 402 未完成，Cursor、Trae 因桌面自动化运行时不可用未完成，因此整个平台仍不标记为发现通过。",
+      "verifiedAt": "2026-09-18T14:59:58.840Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "platform": "macos",
+      "osVersion": "darwin x64 macos15",
+      "nodeVersion": "v22.12.0",
+      "npmInstall": true,
+      "skillTargets": [
+        "codex:user",
+        "codex:project",
+        "claude:user",
+        "claude:project",
+        "cursor:user",
+        "cursor:project",
+        "trae:user",
+        "trae:project"
+      ],
+      "agentDiscoveryVerified": false,
+      "agentDiscoveryNote": "CI 只验证安装路径与回验；Codex、Claude Code、Cursor、Trae 实际发现仍需专用验收机确认。",
+      "verifiedAt": "2026-09-18T15:34:20.175Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "platform": "ubuntu-lts",
+      "osVersion": "linux x64 ubuntu24",
+      "nodeVersion": "v22.12.0",
+      "npmInstall": true,
+      "skillTargets": [
+        "codex:user",
+        "codex:project",
+        "claude:user",
+        "claude:project",
+        "cursor:user",
+        "cursor:project",
+        "trae:user",
+        "trae:project"
+      ],
+      "agentDiscoveryVerified": false,
+      "agentDiscoveryNote": "CI 只验证安装路径与回验；Codex、Claude Code、Cursor、Trae 实际发现仍需专用验收机确认。",
+      "verifiedAt": "2026-09-18T15:33:59.877Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "platform": "debian-stable",
+      "osVersion": "linux x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "npmInstall": true,
+      "skillTargets": [
+        "codex:user",
+        "codex:project",
+        "claude:user",
+        "claude:project",
+        "cursor:user",
+        "cursor:project",
+        "trae:user",
+        "trae:project"
+      ],
+      "agentDiscoveryVerified": false,
+      "agentDiscoveryNote": "CI 只验证安装路径与回验；Codex、Claude Code、Cursor、Trae 实际发现仍需专用验收机确认。",
+      "verifiedAt": "2026-09-18T15:24:10.429Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    },
+    {
+      "platform": "fedora-current",
+      "osVersion": "linux x64 self-hosted",
+      "nodeVersion": "v22.12.0",
+      "npmInstall": true,
+      "skillTargets": [
+        "codex:user",
+        "codex:project",
+        "claude:user",
+        "claude:project",
+        "cursor:user",
+        "cursor:project",
+        "trae:user",
+        "trae:project"
+      ],
+      "agentDiscoveryVerified": false,
+      "agentDiscoveryNote": "CI 只验证安装路径与回验；Codex、Claude Code、Cursor、Trae 实际发现仍需专用验收机确认。",
+      "verifiedAt": "2026-09-18T15:29:36.246Z",
+      "result": "passed",
+      "gitSha": "2ededdb9436e49fd71a0d5652e2f86bca62a597b"
+    }
+  ]
+}

package/resources/export-sqlserver.ps1

@@ -0,0 +1,257 @@
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$OutputDirectory
+)
+
+$ErrorActionPreference = 'Stop'
+$currentStage = '初始化'
+
+function Set-ExportStage {
+    param([string]$Stage)
+    $script:currentStage = $Stage
+    [Console]::Error.WriteLine("[datapull] SQL Server 导出阶段：$Stage")
+}
+
+function Get-RequiredEnvironmentValue {
+    param([string]$Name)
+    $value = [Environment]::GetEnvironmentVariable($Name, 'Process')
+    if ([string]::IsNullOrWhiteSpace($value)) {
+        throw "缺少内部环境变量：$Name"
+    }
+    return $value
+}
+
+function Get-SafeFileStem {
+    param([string]$Identifier)
+    $readable = [regex]::Replace($Identifier, '[<>:"/\\|?*\x00-\x1f]', '_')
+    $readable = [regex]::Replace($readable, '\s+', '_').Trim('.', ' ', '_')
+    if ([string]::IsNullOrWhiteSpace($readable)) { $readable = 'object' }
+    if ($readable.Length -gt 100) { $readable = $readable.Substring(0, 100).TrimEnd('.', ' ') }
+    $sha = [System.Security.Cryptography.SHA256]::Create()
+    try {
+        $bytes = [System.Text.Encoding]::UTF8.GetBytes($Identifier)
+        $hash = [System.BitConverter]::ToString($sha.ComputeHash($bytes)).Replace('-', '').ToLowerInvariant().Substring(0, 10)
+    }
+    finally { $sha.Dispose() }
+    return "$readable--$hash"
+}
+
+function Write-Utf8NoBom {
+    param([string]$Path, [string]$Content)
+    $encoding = New-Object System.Text.UTF8Encoding($false)
+    [System.IO.File]::WriteAllText($Path, $Content, $encoding)
+}
+
+$selectedTypes = @((Get-RequiredEnvironmentValue -Name 'DATAPULL_SQLSERVER_TYPES') | ConvertFrom-Json)
+$records = New-Object System.Collections.Generic.List[object]
+$objectsDirectory = Join-Path $OutputDirectory '_objects'
+[System.IO.Directory]::CreateDirectory($objectsDirectory) | Out-Null
+
+function Test-TypeSelected {
+    param([string]$ObjectType)
+    return $selectedTypes -contains $ObjectType
+}
+
+function Add-Record {
+    param(
+        [string]$Ddl,
+        [string]$ObjectType,
+        [AllowEmptyString()][string]$Schema,
+        [string]$Name,
+        [string]$Identity
+    )
+    if (-not (Test-TypeSelected -ObjectType $ObjectType)) { return }
+    if ([string]::IsNullOrWhiteSpace($Ddl)) { throw "对象 $Identity 的 DDL 为空。" }
+    $fileName = "$(Get-SafeFileStem -Identifier "$ObjectType.$Identity").sql"
+    $relativePath = "_objects/$fileName"
+    Write-Utf8NoBom -Path (Join-Path $objectsDirectory $fileName) -Content ($Ddl.TrimEnd() + "`n")
+    $records.Add([pscustomobject]@{
+        objectType = $ObjectType
+        schema = if ([string]::IsNullOrWhiteSpace($Schema)) { $null } else { $Schema }
+        name = $Name
+        identity = $Identity
+        file = $relativePath
+    })
+}
+
+function Add-SmoRecord {
+    param(
+        [object]$Object,
+        [string]$ObjectType,
+        [AllowEmptyString()][string]$Schema,
+        [string]$Name,
+        [string]$Identity,
+        [object]$Scripter
+    )
+    if (-not (Test-TypeSelected -ObjectType $ObjectType)) { return }
+    $fragments = @($Scripter.Script(@($Object.Urn)))
+    if ($fragments.Count -eq 0) { throw "对象 $Identity 的 DDL 为空。" }
+    $ddl = (($fragments | ForEach-Object { $_.ToString().TrimEnd() }) -join "`nGO`n")
+    Add-Record -Ddl $ddl -ObjectType $ObjectType -Schema $Schema -Name $Name -Identity $Identity
+}
+
+Set-ExportStage -Stage '加载 SqlServer 模块'
+try {
+    Import-Module SqlServer -ErrorAction Stop
+}
+catch {
+    throw "缺少或无法加载 PowerShell SqlServer 模块。请运行 Install-Module SqlServer -Scope CurrentUser。原始错误：$($_.Exception.Message)"
+}
+
+$hostName = Get-RequiredEnvironmentValue -Name 'DATAPULL_SQLSERVER_HOST'
+$port = Get-RequiredEnvironmentValue -Name 'DATAPULL_SQLSERVER_PORT'
+$databaseName = Get-RequiredEnvironmentValue -Name 'DATAPULL_SQLSERVER_DATABASE'
+$authentication = Get-RequiredEnvironmentValue -Name 'DATAPULL_SQLSERVER_AUTH'
+$encrypt = (Get-RequiredEnvironmentValue -Name 'DATAPULL_SQLSERVER_ENCRYPT') -eq 'true'
+$trustCertificate = (Get-RequiredEnvironmentValue -Name 'DATAPULL_SQLSERVER_TRUST_CERT') -eq 'true'
+
+if (-not $encrypt) {
+    throw 'DataPull 要求 SQL Server 启用加密。'
+}
+
+$serverConnection = New-Object Microsoft.SqlServer.Management.Common.ServerConnection
+$serverConnection.ServerInstance = "$hostName,$port"
+if ($serverConnection.PSObject.Properties.Name -contains 'ConnectTimeout') {
+    $serverConnection.ConnectTimeout = 30
+}
+if ($serverConnection.PSObject.Properties.Name -contains 'StatementTimeout') {
+    $serverConnection.StatementTimeout = 120
+}
+if ($authentication -eq 'integrated') {
+    $serverConnection.LoginSecure = $true
+}
+else {
+    $serverConnection.LoginSecure = $false
+    $serverConnection.Login = Get-RequiredEnvironmentValue -Name 'DATAPULL_SQLSERVER_USER'
+    $serverConnection.Password = Get-RequiredEnvironmentValue -Name 'DATAPULL_SQLSERVER_PASSWORD'
+}
+if ($serverConnection.PSObject.Properties.Name -contains 'EncryptConnection') {
+    $serverConnection.EncryptConnection = $true
+}
+if ($serverConnection.PSObject.Properties.Name -contains 'TrustServerCertificate') {
+    $serverConnection.TrustServerCertificate = $trustCertificate
+}
+elseif ($trustCertificate) {
+    throw '当前 PowerShell SqlServer 模块不支持 TrustServerCertificate，请升级模块后重试。'
+}
+
+$server = New-Object Microsoft.SqlServer.Management.Smo.Server($serverConnection)
+try {
+    Set-ExportStage -Stage '连接目标数据库'
+    $server.ConnectionContext.Connect()
+    # 过滤对象时会访问这些属性；预批量加载可避免高延迟连接上的逐对象往返查询。
+    [string[]]$schemaObjectFields = @('IsSystemObject', 'Schema', 'Name')
+    [string[]]$namedObjectFields = @('IsSystemObject', 'Name')
+    $server.SetDefaultInitFields([Microsoft.SqlServer.Management.Smo.Table], $schemaObjectFields)
+    $server.SetDefaultInitFields([Microsoft.SqlServer.Management.Smo.View], $schemaObjectFields)
+    $server.SetDefaultInitFields([Microsoft.SqlServer.Management.Smo.UserDefinedFunction], $schemaObjectFields)
+    $server.SetDefaultInitFields([Microsoft.SqlServer.Management.Smo.StoredProcedure], $schemaObjectFields)
+    $server.SetDefaultInitFields([Microsoft.SqlServer.Management.Smo.Trigger], $namedObjectFields)
+    Set-ExportStage -Stage '读取数据库元数据'
+    $database = $server.Databases[$databaseName]
+    if ($null -eq $database) { throw "数据库不存在或当前账户不可见：$databaseName" }
+    $database.Refresh()
+
+    # 表需要完整的约束和索引；视图、存储程序等对象使用轻量选项，避免触发无关元数据查询。
+    $tableOptions = New-Object Microsoft.SqlServer.Management.Smo.ScriptingOptions
+    $tableOptions.ScriptSchema = $true
+    $tableOptions.ScriptData = $false
+    $tableOptions.SchemaQualify = $true
+    $tableOptions.IncludeHeaders = $false
+    $tableOptions.IncludeIfNotExists = $false
+    $tableOptions.ScriptOwner = $false
+    $tableOptions.Permissions = $false
+    $tableOptions.NoFileGroup = $true
+    $tableOptions.DriAll = $true
+    $tableOptions.Indexes = $true
+    $tableOptions.Triggers = $false
+    $tableOptions.ExtendedProperties = $true
+
+    $objectOptions = New-Object Microsoft.SqlServer.Management.Smo.ScriptingOptions
+    $objectOptions.ScriptSchema = $true
+    $objectOptions.ScriptData = $false
+    $objectOptions.SchemaQualify = $true
+    $objectOptions.IncludeHeaders = $false
+    $objectOptions.IncludeIfNotExists = $false
+    $objectOptions.ScriptOwner = $false
+    $objectOptions.Permissions = $false
+    $objectOptions.NoFileGroup = $true
+    $objectOptions.DriAll = $false
+    $objectOptions.Indexes = $false
+    $objectOptions.Triggers = $false
+    $objectOptions.ExtendedProperties = $false
+
+    $tableScripter = New-Object Microsoft.SqlServer.Management.Smo.Scripter($server)
+    $tableScripter.Options = $tableOptions
+    $objectScripter = New-Object Microsoft.SqlServer.Management.Smo.Scripter($server)
+    $objectScripter.Options = $objectOptions
+
+    if (Test-TypeSelected -ObjectType 'schema') {
+        Set-ExportStage -Stage '导出 schema'
+        $systemSchemas = @('dbo', 'guest', 'sys', 'INFORMATION_SCHEMA')
+        foreach ($schemaObject in @($database.Schemas | Where-Object { $systemSchemas -notcontains $_.Name })) {
+            $escapedSchema = $schemaObject.Name.Replace(']', ']]')
+            Add-Record -Ddl "CREATE SCHEMA [$escapedSchema];" -ObjectType 'schema' -Schema $schemaObject.Name -Name $schemaObject.Name -Identity $schemaObject.Name
+        }
+    }
+
+    Set-ExportStage -Stage '读取 table 清单'
+    $tables = @($database.Tables | Where-Object { -not $_.IsSystemObject })
+    Set-ExportStage -Stage "脚本化 table 与表级 trigger（$($tables.Count) 个 table）"
+    foreach ($table in $tables) {
+        Add-SmoRecord -Object $table -ObjectType 'table' -Schema $table.Schema -Name $table.Name -Identity "$($table.Schema).$($table.Name)" -Scripter $tableScripter
+        foreach ($trigger in @($table.Triggers | Where-Object { -not $_.IsSystemObject })) {
+            Add-SmoRecord -Object $trigger -ObjectType 'trigger' -Schema $table.Schema -Name "$($table.Name).$($trigger.Name)" -Identity "$($table.Schema).$($table.Name).$($trigger.Name)" -Scripter $objectScripter
+        }
+    }
+    Set-ExportStage -Stage '读取 view 清单'
+    $views = @($database.Views | Where-Object { -not $_.IsSystemObject })
+    Set-ExportStage -Stage "脚本化 view（$($views.Count) 个）"
+    foreach ($view in $views) {
+        Add-SmoRecord -Object $view -ObjectType 'view' -Schema $view.Schema -Name $view.Name -Identity "$($view.Schema).$($view.Name)" -Scripter $objectScripter
+    }
+    Set-ExportStage -Stage '导出 function'
+    foreach ($function in @($database.UserDefinedFunctions | Where-Object { -not $_.IsSystemObject })) {
+        Add-SmoRecord -Object $function -ObjectType 'function' -Schema $function.Schema -Name $function.Name -Identity "$($function.Schema).$($function.Name)" -Scripter $objectScripter
+    }
+    Set-ExportStage -Stage '导出 procedure'
+    foreach ($procedure in @($database.StoredProcedures | Where-Object { -not $_.IsSystemObject })) {
+        Add-SmoRecord -Object $procedure -ObjectType 'procedure' -Schema $procedure.Schema -Name $procedure.Name -Identity "$($procedure.Schema).$($procedure.Name)" -Scripter $objectScripter
+    }
+    Set-ExportStage -Stage '导出数据库级 trigger'
+    foreach ($trigger in @($database.Triggers | Where-Object { -not $_.IsSystemObject })) {
+        Add-SmoRecord -Object $trigger -ObjectType 'trigger' -Schema '' -Name $trigger.Name -Identity "database.$($trigger.Name)" -Scripter $objectScripter
+    }
+    if ($database.PSObject.Properties.Name -contains 'Sequences') {
+        Set-ExportStage -Stage '导出 sequence'
+        foreach ($sequence in @($database.Sequences)) {
+            Add-SmoRecord -Object $sequence -ObjectType 'sequence' -Schema $sequence.Schema -Name $sequence.Name -Identity "$($sequence.Schema).$($sequence.Name)" -Scripter $objectScripter
+        }
+    }
+    if ($database.PSObject.Properties.Name -contains 'Synonyms') {
+        Set-ExportStage -Stage '导出 synonym'
+        foreach ($synonym in @($database.Synonyms)) {
+            Add-SmoRecord -Object $synonym -ObjectType 'synonym' -Schema $synonym.Schema -Name $synonym.Name -Identity "$($synonym.Schema).$($synonym.Name)" -Scripter $objectScripter
+        }
+    }
+    Set-ExportStage -Stage '导出用户定义类型'
+    foreach ($dataType in @($database.UserDefinedDataTypes)) {
+        Add-SmoRecord -Object $dataType -ObjectType 'type' -Schema $dataType.Schema -Name $dataType.Name -Identity "$($dataType.Schema).$($dataType.Name)" -Scripter $objectScripter
+    }
+    if ($database.PSObject.Properties.Name -contains 'UserDefinedTableTypes') {
+        foreach ($tableType in @($database.UserDefinedTableTypes)) {
+            Add-SmoRecord -Object $tableType -ObjectType 'type' -Schema $tableType.Schema -Name $tableType.Name -Identity "$($tableType.Schema).$($tableType.Name)" -Scripter $objectScripter
+        }
+    }
+
+    Set-ExportStage -Stage '写入对象清单'
+    [object[]]$recordArray = $records
+    Write-Utf8NoBom -Path (Join-Path $OutputDirectory 'objects.json') -Content ((ConvertTo-Json -InputObject $recordArray -Depth 5) + "`n")
+}
+catch {
+    throw "SQL Server 结构导出失败（阶段：$currentStage）。原始错误：$($_.Exception.Message)"
+}
+finally {
+    if ($serverConnection.IsOpen) { $serverConnection.Disconnect() }
+    Remove-Item Env:DATAPULL_SQLSERVER_PASSWORD -ErrorAction SilentlyContinue
+}

package/skill/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: datapull
+description: 检查并指导安装 DataPull CLI，使用已登记连接拉取 MySQL、PostgreSQL 或 SQL Server 的结构文件；适用于环境诊断、连接选择、对象范围确认和 CLI 错误恢复，不替代 CLI 管理凭证或生成 DDL。
+---
+
+# DataPull
+
+把 DataPull CLI 作为唯一执行入口。本 Skill 负责环境检查、安装指导和安全调用，不实现连接管理、依赖安装或结构文件生成。
+
+## 环境门
+
+1. 检查 Node.js 是否为 `>=22.12`、NPM 是否可用、`datapull --version` 是否成功。
+2. CLI 缺失时，只向用户提供 `npm install --global @yg-toolkit/datapull`；由用户亲自执行，不代替用户进行全局安装。
+3. CLI 存在时执行 `datapull doctor --json`，依据退出码和 `error.code` 给出下一条恢复命令。环境门完成的标准是 CLI 可执行且诊断结果已被解释。
+
+## 调用流程
+
+优先使用带 `--json` 的命令模式：
+
+- `datapull connection list --json`：列出脱敏登记连接。
+- `datapull database list --connection <alias> --json`：读取收藏、最近使用和可访问数据库。
+- `datapull pull --connection <alias> --database <database> --include <types> --yes --json`：拉取结构文件。
+
+执行拉取前向用户说明连接别名、目标数据库、对象类型和当前项目根。任一值无法从用户请求或 CLI 脱敏结果唯一确定时，停在该步骤并请用户决定；不猜测连接、数据库或对象范围。
+
+当 CLI 返回缺少工具时，说明 `actionPlan.installation` 中的工具、来源、命令、权限与下载影响。只有用户明确要求执行该安装计划后，才在下一次 CLI 调用中加入 `--install-missing --yes`。
+
+当 SQL Server 返回 `SQLSERVER_TLS_CERTIFICATE_UNTRUSTED` 时，说明连接仍可保持加密，但信任服务器证书会失去服务器身份验证并带来中间人攻击风险。由用户在“安装可信 CA”“仅本次信任”“保存到该连接”中决定；只有用户明确选择后，才分别调用：
+
+- 仅本次：在 `connection test`、`database list` 或 `pull` 中加入 `--trust-server-certificate --yes`。
+- 保存：`datapull connection update --alias <alias> --trust-server-certificate --yes --json`。
+- 恢复验证：`datapull connection update --alias <alias> --verify-server-certificate --yes --json`。
+
+Agent 不替用户选择信任证书，也不把测试环境的放宽策略推广到其他连接。
+
+## 秘密边界
+
+数据库密码或含秘密 URL 只由用户在 CLI 隐藏输入中填写，或手工更新 CLI 显示的 `credentials.env`。不要在聊天中索要、复述或传递秘密，不读取该文件内容，也不把秘密放入命令参数。
+
+## 完成标准
+
+只有在 CLI 退出码为零、JSON 中 `ok:true`，且 `outputPath`、`updatedTypes`、`preservedTypes` 与用户目标一致时，才报告拉取成功。失败时原样保留稳定 `error.code`，给出一条对应的恢复命令，并区分本地契约验证与真实数据库拉取结果。

package/skill/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "DataPull"
+  short_description: "安装并安全调用数据库结构文件拉取 CLI"
+  default_prompt: "使用 $datapull 检查环境，并指导我从已登记数据库连接拉取结构文件。"
+policy:
+  allow_implicit_invocation: true