From 2cb4e1a87b453d23f5501cbc85e35e45e966969e Mon Sep 17 00:00:00 2001 From: zyj Date: Wed, 4 Mar 2026 14:10:30 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=BB=A3=E7=A0=81=E6=B3=A8?= =?UTF-8?q?=E9=87=8A=E4=B8=BA=E4=B8=AD=E6=96=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- cmd/devpack/commands/capture.go | 14 +- cmd/devpack/commands/diff.go | 4 +- cmd/devpack/commands/export.go | 4 +- cmd/devpack/commands/init.go | 12 +- cmd/devpack/commands/list.go | 6 +- cmd/devpack/commands/profile.go | 12 +- cmd/devpack/commands/restore.go | 20 +- cmd/devpack/commands/root.go | 10 +- cmd/devpack/commands/scan.go | 12 +- docs/DEVELOPMENT-PLAN.md | 962 ++++++++++++++++++++++++++++ internal/collector/registry_test.go | 20 +- internal/platform/darwin.go | 6 +- internal/platform/linux.go | 6 +- internal/platform/platform.go | 2 +- internal/platform/windows.go | 4 +- pkg/version/version.go | 6 +- 16 files changed, 1031 insertions(+), 69 deletions(-) create mode 100644 docs/DEVELOPMENT-PLAN.md diff --git a/cmd/devpack/commands/capture.go b/cmd/devpack/commands/capture.go index ca9d859..85e5937 100644 --- a/cmd/devpack/commands/capture.go +++ b/cmd/devpack/commands/capture.go @@ -29,13 +29,13 @@ func newCaptureCmd() *cobra.Command { return fmt.Errorf("必须指定 Pack 名称 (--name)") } fmt.Printf("📦 Capturing environment \"%s\"...\n", name) - // TODO: Implement capture logic - // 1. Load profile - // 2. Run collectors - // 3. Write data to temp directory - // 4. Generate manifest - // 5. Encrypt sensitive data (if enabled) - // 6. Create pack + // TODO: 实现捕获逻辑 + // 1. 加载 Profile 配置 + // 2. 运行采集器 + // 3. 将数据写入临时目录 + // 4. 生成 Manifest 清单 + // 5. 加密敏感数据（如果启用） + // 6. 创建 Pack 文件 fmt.Printf("✅ Pack created: %s\n", name) fmt.Printf("\nRun 'devpack export %s -o %s.devpack' to export.\n", name, name) return nil diff --git a/cmd/devpack/commands/diff.go b/cmd/devpack/commands/diff.go index 2a4d783..4f6884e 100644 --- a/cmd/devpack/commands/diff.go +++ b/cmd/devpack/commands/diff.go @@ -30,8 +30,8 @@ func newDiffCmd() *cobra.Command { return fmt.Errorf("请指定对比目标: --current 或 --with ") } - // TODO: Implement diff logic - fmt.Println("(diff not yet implemented)") + // TODO: 实现差异对比逻辑 + fmt.Println("（差异对比功能尚未实现）") return nil }, } diff --git a/cmd/devpack/commands/export.go b/cmd/devpack/commands/export.go index 691ba1f..7fb00cb 100644 --- a/cmd/devpack/commands/export.go +++ b/cmd/devpack/commands/export.go @@ -20,7 +20,7 @@ func newExportCmd() *cobra.Command { output = packName + ".devpack" } fmt.Printf("📤 Exporting \"%s\" to %s...\n", packName, output) - // TODO: Implement export logic + // TODO: 实现导出逻辑 fmt.Printf("✅ Exported: %s\n", output) return nil }, @@ -45,7 +45,7 @@ func newImportCmd() *cobra.Command { RunE: func(cmd *cobra.Command, args []string) error { filePath := args[0] fmt.Printf("📥 Importing %s...\n", filePath) - // TODO: Implement import logic + // TODO: 实现导入逻辑 fmt.Println("✅ Import complete!") return nil }, diff --git a/cmd/devpack/commands/init.go b/cmd/devpack/commands/init.go index ff20123..0be99e4 100644 --- a/cmd/devpack/commands/init.go +++ b/cmd/devpack/commands/init.go @@ -19,12 +19,12 @@ func newInitCmd() *cobra.Command { Long: `初始化 DevPack，创建配置目录和默认配置文件。`, RunE: func(cmd *cobra.Command, args []string) error { fmt.Println("🚀 Initializing DevPack...") - // TODO: Implement init logic - // 1. Create ~/.devpack/ directory - // 2. Create config.yaml - // 3. Create profiles/ directory - // 4. Create packs/ directory - // 5. Create logs/ directory + // TODO: 实现初始化逻辑 + // 1. 创建 ~/.devpack/ 目录 + // 2. 创建 config.yaml 配置文件 + // 3. 创建 profiles/ 目录 + // 4. 创建 packs/ 目录 + // 5. 创建 logs/ 目录 fmt.Println("✅ DevPack initialized successfully!") fmt.Println("\nRun 'devpack scan' to scan your current environment.") return nil diff --git a/cmd/devpack/commands/list.go b/cmd/devpack/commands/list.go index 476f835..b2174d7 100644 --- a/cmd/devpack/commands/list.go +++ b/cmd/devpack/commands/list.go @@ -26,15 +26,15 @@ func newListCmd() *cobra.Command { switch subCmd { case "packs": fmt.Println("📦 Local Packs:") - // TODO: List packs + // TODO: 列出所有 Pack fmt.Println(" (none)") case "profiles": fmt.Println("📋 Profiles:") - // TODO: List profiles + // TODO: 列出所有 Profile fmt.Println(" (none)") case "collectors": fmt.Println("🔌 Available Collectors:") - // TODO: List collectors + // TODO: 列出所有采集器 fmt.Println(" (none)") default: return fmt.Errorf("未知的子命令: %s (可选: packs, profiles, collectors)", subCmd) diff --git a/cmd/devpack/commands/profile.go b/cmd/devpack/commands/profile.go index 15c8c06..f6cb67e 100644 --- a/cmd/devpack/commands/profile.go +++ b/cmd/devpack/commands/profile.go @@ -13,7 +13,7 @@ func newProfileCmd() *cobra.Command { Long: `创建、编辑、删除和管理 Profile 配置方案。`, } - // Subcommands + // 注册子命令 cmd.AddCommand(newProfileCreateCmd()) cmd.AddCommand(newProfileShowCmd()) cmd.AddCommand(newProfileListCmd()) @@ -33,7 +33,7 @@ func newProfileCreateCmd() *cobra.Command { RunE: func(cmd *cobra.Command, args []string) error { name := args[0] fmt.Printf("📋 Creating profile \"%s\"...\n", name) - // TODO: Create profile + // TODO: 创建 Profile 配置文件 fmt.Printf("✅ Profile \"%s\" created.\n", name) fmt.Printf("Edit with: devpack profile edit %s\n", name) return nil @@ -53,7 +53,7 @@ func newProfileShowCmd() *cobra.Command { RunE: func(cmd *cobra.Command, args []string) error { name := args[0] fmt.Printf("📋 Profile: %s\n", name) - // TODO: Show profile content + // TODO: 显示 Profile 内容 return nil }, } @@ -65,7 +65,7 @@ func newProfileListCmd() *cobra.Command { Short: "列出所有 Profile", RunE: func(cmd *cobra.Command, args []string) error { fmt.Println("📋 Profiles:") - // TODO: List profiles + // TODO: 列出所有 Profile fmt.Println(" (none)") return nil }, @@ -80,7 +80,7 @@ func newProfileDeleteCmd() *cobra.Command { RunE: func(cmd *cobra.Command, args []string) error { name := args[0] fmt.Printf("🗑️ Deleting profile \"%s\"...\n", name) - // TODO: Delete profile + // TODO: 删除 Profile 文件 fmt.Printf("✅ Profile \"%s\" deleted.\n", name) return nil }, @@ -95,7 +95,7 @@ func newProfileUseCmd() *cobra.Command { RunE: func(cmd *cobra.Command, args []string) error { name := args[0] fmt.Printf("✅ Default profile set to \"%s\".\n", name) - // TODO: Set default profile + // TODO: 设置默认 Profile return nil }, } diff --git a/cmd/devpack/commands/restore.go b/cmd/devpack/commands/restore.go index 131b380..337d688 100644 --- a/cmd/devpack/commands/restore.go +++ b/cmd/devpack/commands/restore.go @@ -28,20 +28,20 @@ func newRestoreCmd() *cobra.Command { if dryRun { fmt.Printf("🔍 Dry Run — Restore Plan for \"%s\"\n\n", packName) - // TODO: Generate and display restore plan - fmt.Println("⚠ This is a dry run. No changes were made.") - fmt.Println("Run without --dry-run to apply these changes.") + // TODO: 生成并展示还原计划 + fmt.Println("⚠ 这是一次干运行，未做任何实际更改。") + fmt.Println("去掉 --dry-run 参数以执行实际还原。") return nil } fmt.Printf("🚀 Restoring environment from \"%s\"...\n", packName) - // TODO: Implement restore logic - // 1. Load and verify pack - // 2. Check platform compatibility - // 3. Detect conflicts - // 4. Create restore point - // 5. Execute restore plan - // 6. Verify results + // TODO: 实现还原逻辑 + // 1. 加载并校验 Pack 文件 + // 2. 检查平台兼容性 + // 3. 检测冲突 + // 4. 创建还原点 + // 5. 执行还原计划 + // 6. 验证还原结果 fmt.Println("✅ Environment restored successfully!") return nil }, diff --git a/cmd/devpack/commands/root.go b/cmd/devpack/commands/root.go index 942b715..01586bb 100644 --- a/cmd/devpack/commands/root.go +++ b/cmd/devpack/commands/root.go @@ -17,7 +17,7 @@ var ( noColor bool ) -// rootCmd represents the base command +// rootCmd 根命令定义 var rootCmd = &cobra.Command{ Use: "devpack", Short: "DevPack - 开发环境打包迁移工具", @@ -29,7 +29,7 @@ var rootCmd = &cobra.Command{ Version: version.GetVersionString(), } -// Execute adds all child commands to the root command and sets flags appropriately. +// Execute 将所有子命令添加到根命令并执行 func Execute() error { return rootCmd.Execute() } @@ -37,14 +37,14 @@ func Execute() error { func init() { cobra.OnInitialize(initConfig) - // Global flags + // 全局参数 rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "配置文件路径 (默认: ~/.devpack/config.yaml)") rootCmd.PersistentFlags().BoolVarP(&verbose, "verbose", "v", false, "详细输出") rootCmd.PersistentFlags().BoolVarP(&quiet, "quiet", "q", false, "静默模式") rootCmd.PersistentFlags().StringVar(&logLevel, "log-level", "info", "日志级别 (trace|debug|info|warn|error)") rootCmd.PersistentFlags().BoolVar(&noColor, "no-color", false, "禁用彩色输出") - // Add subcommands + // 注册子命令 rootCmd.AddCommand(newInitCmd()) rootCmd.AddCommand(newScanCmd()) rootCmd.AddCommand(newCaptureCmd()) @@ -75,6 +75,6 @@ func initConfig() { viper.SetEnvPrefix("DEVPACK") viper.AutomaticEnv() - // Read config file (ignore error if not found) + // 读取配置文件（文件不存在时忽略错误） _ = viper.ReadInConfig() } diff --git a/cmd/devpack/commands/scan.go b/cmd/devpack/commands/scan.go index b882af0..ec67dde 100644 --- a/cmd/devpack/commands/scan.go +++ b/cmd/devpack/commands/scan.go @@ -22,12 +22,12 @@ func newScanCmd() *cobra.Command { Long: `扫描当前系统的开发环境，检测已安装的工具、配置和设置。`, RunE: func(cmd *cobra.Command, args []string) error { fmt.Println("🔍 Scanning development environment...") - // TODO: Implement scan logic - // 1. Load profile (if specified) - // 2. Determine which collectors to run - // 3. Run collectors in parallel - // 4. Aggregate results - // 5. Display results + // TODO: 实现扫描逻辑 + // 1. 加载 Profile（如果指定了） + // 2. 确定需要运行哪些采集器 + // 3. 并行运行采集器 + // 4. 汇总扫描结果 + // 5. 展示结果 fmt.Println("✅ Scan complete!") return nil }, diff --git a/docs/DEVELOPMENT-PLAN.md b/docs/DEVELOPMENT-PLAN.md new file mode 100644 index 0000000..2bbe7e5 --- /dev/null +++ b/docs/DEVELOPMENT-PLAN.md @@ -0,0 +1,962 @@ +# DevPack 后续开发详细计划 + +> 基于 ROADMAP.md 路线图，细化到每个文件及其所需第三方库 / 标准库 +> 更新日期：2026-03-03 + +--- + +## 依赖库总览 + +下表列出后续开发中需要引入的**所有第三方库**（go get 命令）： + +| 库 | Import Path | 用途 | 引入阶段 | +|---|---|---|---| +| zerolog | `github.com/rs/zerolog` | 结构化日志 | M1 | +| go-yaml | `gopkg.in/yaml.v3` | Profile YAML 解析 | M1 | +| uuid | `github.com/google/uuid` | Pack ID 生成 | M1 | +| color | `github.com/fatih/color` | 终端彩色输出 | M1 | +| tablewriter | `github.com/olekukonenko/tablewriter` | 终端表格渲染 | M1 | +| progressbar | `github.com/schollz/progressbar/v3` | 终端进度条 | M3 | +| survey | `github.com/AlecAivazis/survey/v2` | 交互式终端提示 | M4 | +| testify | `github.com/stretchr/testify` | 测试断言与 Mock | M1 | +| archiver | `github.com/mholt/archiver/v4` | tar.gz 高级归档（可选，也可用标准库） | M3 | +| x/crypto | `golang.org/x/crypto` | Argon2id 密钥派生 | v0.3.0 | + +> 注意：`cobra` 和 `viper` 已在 go.mod 中，无需再添加。 + +--- + +## M1: 项目基础架构（第 1-2 周） + +### 任务 1.1 — 日志系统 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/logging/logger.go` | 全局 Logger 封装、日志级别控制、文件 + 控制台双输出 | +| `internal/logging/logger_test.go` | 日志系统单元测试 | + +**所需库：** + +``` +第三方库: + github.com/rs/zerolog — 核心日志引擎 + +标准库: + os — 日志文件创建 + io — MultiWriter (控制台+文件) + time — 时间戳格式 + fmt — 格式化 + path/filepath — 日志文件路径 +``` + +**实现要点：** +- 导出全局 `Logger` 实例 +- 支持 `--verbose` / `--quiet` / `--log-level` 全局标志 +- 支持 `--log-file` 输出到文件 +- 集成到 `cmd/devpack/commands/root.go` 的 `PersistentPreRun` + +**需修改的现有文件：** + +| 文件 | 改动 | +|---|---| +| `cmd/devpack/commands/root.go` | 在 `PersistentPreRunE` 中初始化 Logger，传递 verbose/quiet/log-level/log-file 标志 | +| `go.mod` | 添加 `github.com/rs/zerolog` 依赖 | + +--- + +### 任务 1.2 — 配置系统 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/config/config.go` | 配置结构体定义 (AppConfig)、加载/保存/默认值逻辑 | +| `internal/config/config_test.go` | 配置系统单元测试 | + +**所需库：** + +``` +第三方库: + github.com/spf13/viper — 配置文件读取(已有) + gopkg.in/yaml.v3 — YAML 序列化/反序列化 + +标准库: + os — 文件操作 + path/filepath — 路径拼接 + fmt — 格式化 +``` + +**需修改的现有文件：** + +| 文件 | 改动 | +|---|---| +| `internal/config/paths.go` | 增加 `ConfigFilePath()` 方法返回 config.yaml 路径 | +| `go.mod` | 添加 `gopkg.in/yaml.v3` 依赖 | + +--- + +### 任务 1.3 — Profile 系统核心 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/profile/profile.go` | Profile 结构体、加载/保存/验证/列出/默认模板 | +| `internal/profile/profile_test.go` | Profile 单元测试 | +| `internal/profile/templates.go` | 预设模板: minimal / standard / full | + +**所需库：** + +``` +第三方库: + gopkg.in/yaml.v3 — Profile YAML 解析与生成 + +标准库: + os — 文件操作 + path/filepath — Profile 文件路径 + fmt — 错误信息 + strings — 字符串处理 +``` + +--- + +### 任务 1.4 — 平台适配层完善 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `internal/platform/platform.go` | 添加 `InstallFont()` 和 `RunAsAdmin()` 方法签名 | `os/exec` | +| `internal/platform/windows.go` | 实现 `InstallFont()` (注册表写入)、`RunAsAdmin()` (runas 动词)、完善 `SetEnvVar` (使用 `golang.org/x/sys/windows/registry`) | `os/exec`, `golang.org/x/sys/windows/registry` | +| `internal/platform/darwin.go` | 实现 `InstallFont()` (~/Library/Fonts)、`RunAsAdmin()` (osascript) | `os/exec`, `os` | +| `internal/platform/linux.go` | 实现 `InstallFont()` (~/.local/share/fonts)、`RunAsAdmin()` (pkexec/sudo) | `os/exec`, `os` | + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/platform/platform_test.go` | 平台层单元测试 (使用 build tags 分平台) | + +**额外库（仅 Windows 构建时需要）：** + +``` +第三方库: + golang.org/x/sys/windows/registry — Windows 注册表操作 (设置环境变量、安装字体) +``` + +--- + +### 任务 1.5 — init 命令实现 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `cmd/devpack/commands/init.go` | 实现完整的 init 逻辑：创建目录、写入默认 config.yaml、创建默认 Profile、支持 `--template` / `--profile` / `--force` | `internal/config`, `internal/profile`, `internal/logging` | + +**依赖的内部包：** + +``` +internal/config — DefaultPaths(), EnsureDirs() +internal/profile — 创建默认/模板 Profile +internal/logging — 日志记录 + +标准库: + os — 文件/目录创建 + fmt — 用户输出 + path/filepath — 路径 +``` + +--- + +### 任务 1.6 — 终端 UI 工具 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/ui/printer.go` | 统一输出工具：Success/Error/Warn/Info 打印、Verbose 判断 | +| `internal/ui/table.go` | 表格渲染封装 (基于 tablewriter) | +| `internal/ui/spinner.go` | 加载动画封装 (用于扫描等操作) | + +**所需库：** + +``` +第三方库: + github.com/fatih/color — 终端颜色 (绿色✓、红色✗、黄色⚠ 等) + github.com/olekukonenko/tablewriter — 终端表格 + +标准库: + fmt — 格式化输出 + os — Stdout/Stderr + io — Writer 接口 + strings — 字符串处理 + time — 动画定时 + sync — Spinner 并发控制 +``` + +**需修改的现有文件：** + +| 文件 | 改动 | +|---|---| +| `go.mod` | 添加 `github.com/fatih/color`、`github.com/olekukonenko/tablewriter` | + +--- + +### 任务 1.7 — 错误处理系统 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/errors/errors.go` | DevPackError 结构体、ErrorLevel 枚举、CollectorError、格式化输出 | +| `internal/errors/errors_test.go` | 错误处理单元测试 | + +**所需库：** + +``` +标准库: + fmt — 错误格式化 + errors — errors.Is / errors.As 兼容 + strings — 消息拼接 +``` + +--- + +## M2: 核心采集器（第 3-5 周） + +### 任务 2.1 — Go 运行时采集器 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/collector/runtime/go_collector.go` | Go 采集器: 扫描版本、GOPATH、GOROOT、go env、GOPATH/bin 下的工具 | +| `internal/collector/runtime/go_collector_test.go` | Go 采集器单元测试 | + +**所需库：** + +``` +标准库: + os/exec — 执行 `go version`、`go env -json`、`go install` + encoding/json — 解析 `go env -json` 输出 + context — 命令超时控制 + path/filepath — GOPATH/bin 扫描 + os — 文件遍历 + strings — 输出解析 + runtime — 获取当前 Go 信息 + fmt — 格式化 +``` + +**实现逻辑：** +- `Scan()`: `go version` 获取版本，`go env -json` 获取环境，遍历 `GOPATH/bin` 获取安装的工具 +- `Capture()`: 将 metadata.json (版本+env) + go-tools.json (工具列表) 写入目标目录 +- `Restore()`: 检测 Go 是否安装 → 安装缺失工具 (`go install xxx@latest`) +- `Verify()`: 验证 Go 版本和工具是否存在 + +--- + +### 任务 2.2 — Node.js 运行时采集器 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/collector/runtime/node_collector.go` | Node.js 采集器: 扫描 node/npm/nvm 版本、全局包 | +| `internal/collector/runtime/node_collector_test.go` | 单元测试 | + +**所需库：** + +``` +标准库: + os/exec — 执行 `node --version`、`npm --version`、`npm list -g --json` + encoding/json — 解析 npm list JSON + context — 超时 + strings — 版本解析 + fmt — 格式化 +``` + +**实现逻辑：** +- `Scan()`: `node --version`、`npm --version`、`npm list -g --json` 获取全局包 +- `Capture()`: 写入 metadata.json + global-packages.json +- `Restore()`: `npm install -g @` 逐个安装 +- `Verify()`: 验证 node 版本和全局包 + +--- + +### 任务 2.3 — Python 运行时采集器 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/collector/runtime/python_collector.go` | Python 采集器: 版本、pip 包、virtualenv 配置 | +| `internal/collector/runtime/python_collector_test.go` | 单元测试 | + +**所需库：** + +``` +标准库: + os/exec — 执行 `python --version`、`pip list --format=json` + encoding/json — 解析 pip list JSON + context — 超时 + strings — 解析 + fmt — 格式化 +``` + +**实现逻辑：** +- `Scan()`: `python --version`、`pip --version`、`pip list --format=json` +- `Capture()`: 写入 metadata.json + pip-packages.json +- `Restore()`: `pip install ==` 逐个安装 +- `Verify()`: 验证安装 + +--- + +### 任务 2.4 — VS Code 编辑器采集器 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/collector/editor/vscode_collector.go` | VS Code 采集器: 版本、扩展列表、settings.json、keybindings.json、代码片段 | +| `internal/collector/editor/vscode_collector_test.go` | 单元测试 | + +**所需库：** + +``` +标准库: + os/exec — 执行 `code --version`、`code --list-extensions --show-versions`、`code --install-extension` + encoding/json — 解析/生成 settings.json + os — 读取 settings.json、keybindings.json 文件 + path/filepath — VS Code 配置文件路径 (不同平台不同) + context — 超时 + strings — 扩展列表解析 + io — 文件复制 + fmt — 格式化 +``` + +**实现逻辑：** +- `Scan()`: + - `code --version` 获取版本 + - `code --list-extensions --show-versions` 获取扩展列表 + - 读取 `%APPDATA%/Code/User/settings.json` (Windows) 或 `~/Library/Application Support/Code/User/settings.json` (macOS) + - 读取 keybindings.json、snippets 目录 +- `Capture()`: 复制 settings.json / keybindings.json / snippets/ + 写入 extensions.json +- `Restore()`: `code --install-extension @` 逐个安装扩展、复制配置文件 +- `Verify()`: 验证扩展已安装 + +--- + +### 任务 2.5 — PowerShell Shell 采集器 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/collector/shell/powershell_collector.go` | PowerShell 采集器: 版本、已安装模块、Profile 脚本 | +| `internal/collector/shell/powershell_collector_test.go` | 单元测试 | + +**所需库：** + +``` +标准库: + os/exec — 执行 `pwsh -Command "Get-Module -ListAvailable | ConvertTo-Json"` + encoding/json — 解析 PowerShell JSON 输出 + os — 读取 $PROFILE 文件 + path/filepath — Profile 路径 + context — 超时 + strings — 解析 + io — 文件复制 +``` + +**实现逻辑：** +- `Scan()`: PowerShell 版本、`Get-Module -ListAvailable`、Profile 路径 +- `Capture()`: 写入 metadata.json + modules.json + profile 文件内容 +- `Restore()`: `Install-Module -Name -Force` 安装模块 + 写入 Profile +- `Verify()`: 验证模块和 Profile + +--- + +### 任务 2.6 — Scoop 包管理器采集器 (Windows) + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/collector/package/scoop_collector.go` | Scoop 采集器: 已安装包、bucket 列表 | +| `internal/collector/package/scoop_collector_test.go` | 单元测试 | + +**所需库：** + +``` +标准库: + os/exec — 执行 `scoop list`、`scoop bucket list`、`scoop install` + encoding/json — 解析 scoop export JSON + context — 超时 + strings — 输出解析 + os — Scoop 目录检测 + fmt — 格式化 +``` + +**实现逻辑：** +- `Scan()`: `scoop export` (JSON)、`scoop bucket list` +- `Capture()`: 写入 packages.json + buckets.json +- `Restore()`: 先 `scoop bucket add`，再 `scoop install ` +- `Verify()`: 验证包是否已安装 + +--- + +### 任务 2.7 — Git 配置采集器 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/collector/git/git_collector.go` | Git 采集器: 全局配置、别名 | +| `internal/collector/git/git_collector_test.go` | 单元测试 | + +**所需库：** + +``` +标准库: + os/exec — 执行 `git config --global --list`、`git config --global ` + context — 超时 + strings — key=value 解析 + bufio — 逐行读取 .gitconfig + os — 读取 ~/.gitconfig 文件 + path/filepath — 路径 + fmt — 格式化 +``` + +--- + +### 任务 2.8 — 环境变量采集器 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/collector/env/env_collector.go` | 环境变量采集器: 按 Profile 中定义的 include/exclude pattern 过滤 | +| `internal/collector/env/env_collector_test.go` | 单元测试 | + +**所需库：** + +``` +标准库: + os — os.Environ() 获取所有环境变量 + strings — key=value 拆分、pattern 匹配 + path/filepath — filepath.Match 用于 glob 匹配 + context — 超时 + fmt — 格式化 + encoding/json — 序列化 + +内部依赖: + internal/platform — SetEnvVar() 设置环境变量 (不同平台不同) +``` + +--- + +### 任务 2.9 — 采集器自动注册 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `internal/collector/registry.go` | 无需修改，现有注册机制已可用 | — | +| `cmd/devpack/main.go` | 添加 `registerCollectors()` 函数，创建 Registry 实例并注册所有内置采集器 | 所有 `internal/collector/*` 子包 | + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/collector/register.go` | `RegisterBuiltins(registry)` — 一次性注册所有内置采集器，集中管理 | + +--- + +### 任务 2.10 — scan 命令实现 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `cmd/devpack/commands/scan.go` | 实现完整扫描逻辑：解析 flags → 加载 Profile → 选择采集器 → 并发扫描 → 格式化输出 (table/json/yaml) | `internal/collector`, `internal/profile`, `internal/ui`, `internal/logging` | + +**依赖的内部包：** + +``` +internal/collector — Registry.ScanAll() / ListByCategory() +internal/profile — 加载 Profile 确定启用的采集器 +internal/ui — 表格渲染、颜色输出 +internal/logging — 日志 +internal/config — 路径 + +标准库: + encoding/json — --output json + context — 超时控制 + fmt — 输出 + strings — 逗号分隔解析 + time — 扫描耗时 +``` + +--- + +## M3: 打包引擎（第 6-7 周） + +### 任务 3.1 — Pack 引擎核心 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/pack/engine.go` | PackEngine 结构体：创建 Pack 的核心流程控制 | +| `internal/pack/engine_test.go` | Pack 引擎单元测试 | +| `internal/pack/archive.go` | tar.gz 打包/解包实现 | +| `internal/pack/archive_test.go` | 归档单元测试 | +| `internal/pack/checksum.go` | SHA-256 校验和计算与验证 | +| `internal/pack/checksum_test.go` | 校验和单元测试 | + +**所需库：** + +``` +第三方库: + github.com/google/uuid — 生成 Pack UUID + +标准库: + archive/tar — tar 格式写入/读取 + compress/gzip — gzip 压缩/解压 + crypto/sha256 — SHA-256 校验和 + encoding/hex — 校验和 hex 编码 + encoding/json — manifest.json 写入 + io — 数据流复制 + os — 文件操作 + path/filepath — 路径遍历 + time — 时间戳 + fmt — 格式化 + strings — 路径处理 +``` + +**需修改的现有文件：** + +| 文件 | 改动 | +|---|---| +| `pkg/manifest/manifest.go` | 添加 `Validate()` 方法、`NewManifest()` 构造函数 | +| `go.mod` | 添加 `github.com/google/uuid`、`github.com/schollz/progressbar/v3` | + +--- + +### 任务 3.2 — capture 命令实现 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `cmd/devpack/commands/capture.go` | 实现完整捕获流程：解析 flags → 加载 Profile → 创建临时目录 → 并发运行 Capture() → 生成 Manifest → 打包 → 输出结果 | `internal/pack`, `internal/collector`, `internal/profile`, `internal/ui`, `internal/logging` | + +**依赖的内部包：** + +``` +internal/pack — PackEngine.CreatePack() +internal/collector — Registry + 各采集器 +internal/profile — 加载 Profile +internal/ui — 进度条、表格 +internal/logging — 日志 +internal/config — 路径 (Packs 目录) +pkg/manifest — Manifest 构建 + +标准库: + os — 临时目录、文件 + path/filepath — 路径 + context — 超时 + fmt — 输出 + time — 时间戳 +``` + +--- + +### 任务 3.3 — export / import 命令实现 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `cmd/devpack/commands/export.go` | export: 从内部 Packs 目录复制 .devpack 到指定路径; import: 从外部路径复制 .devpack 到 Packs 目录并验证 | `internal/pack`, `internal/config`, `internal/ui` | + +**所需库：** + +``` +标准库: + os — 文件复制 + io — 数据流 + path/filepath — 路径 + fmt — 输出 +``` + +--- + +### 任务 3.4 — 进度条组件 + +**新建文件或修改：** + +| 文件 | 说明 | +|---|---| +| `internal/ui/progress.go` | 基于 progressbar 库的进度条封装、适配打包/还原等长时操作 | + +**所需库：** + +``` +第三方库: + github.com/schollz/progressbar/v3 — 进度条渲染 + +标准库: + os — Stderr 输出 + fmt — 格式化 +``` + +--- + +## M4: 还原引擎（第 8-10 周） + +### 任务 4.1 — 还原引擎核心 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/restore/engine.go` | RestoreEngine: 解包 → 校验 → 解析 Manifest → 平台检查 → 冲突检测 → 执行还原 → 验证 → 报告 | +| `internal/restore/engine_test.go` | 还原引擎单元测试 | +| `internal/restore/plan.go` | RestorePlan: 还原计划生成、依赖排序 (拓扑排序) | +| `internal/restore/plan_test.go` | 还原计划单元测试 | +| `internal/restore/conflict.go` | 冲突检测器: 版本对比、已存在检测、策略应用 | +| `internal/restore/conflict_test.go` | 冲突检测单元测试 | +| `internal/restore/report.go` | 还原报告: 成功/失败/跳过/警告 的汇总和输出 | + +**所需库：** + +``` +第三方库: + github.com/AlecAivazis/survey/v2 — 冲突时交互式提示 (ConflictPrompt 策略) + +标准库: + archive/tar — 解包 + compress/gzip — 解压 + crypto/sha256 — 校验和验证 + encoding/hex — hex 解码 + encoding/json — Manifest 解析 + os — 文件操作 + path/filepath — 路径 + context — 超时 + fmt — 格式化 + sort — 依赖排序 + strings — 版本对比 + time — 时间 + sync — 并发控制 +``` + +--- + +### 任务 4.2 — 干运行模式 + +**涉及文件：** + +| 文件 | 改动 | +|---|---| +| `internal/restore/engine.go` | 在 `Restore()` 中根据 `DryRun` 标志只模拟操作、输出计划但不执行 | +| `internal/restore/report.go` | DryRun 专用报告格式 | + +**所需库：** 无额外依赖，使用已有标准库 + +--- + +### 任务 4.3 — restore 命令实现 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `cmd/devpack/commands/restore.go` | 实现完整还原流程：解析 flags → 加载 Pack → 调用 RestoreEngine → 处理冲突 → 输出报告 | `internal/restore`, `internal/pack`, `internal/ui`, `internal/logging`, `internal/collector` | + +**依赖的内部包：** + +``` +internal/restore — RestoreEngine +internal/pack — Pack 解包、校验和验证 +internal/collector — 各采集器 Restore() / Verify() +internal/ui — 进度条、表格、确认提示 +internal/logging — 日志 +internal/config — 路径 +internal/profile — Profile 加载 +pkg/manifest — Manifest 解析 +``` + +--- + +### 任务 4.4 — 各采集器的 Restore 逻辑 + +此阶段需**回到每个采集器文件**实现完整的 `Restore()` 和 `Verify()` 方法： + +| 文件 | Restore 逻辑 | 所需命令 | +|---|---|---| +| `internal/collector/runtime/go_collector.go` | `go install @latest` 安装工具 | `os/exec` | +| `internal/collector/runtime/node_collector.go` | `npm install -g @` 安装全局包 | `os/exec` | +| `internal/collector/runtime/python_collector.go` | `pip install ==` 安装包 | `os/exec` | +| `internal/collector/editor/vscode_collector.go` | `code --install-extension ` + 复制配置文件 | `os/exec`, `io`, `os` | +| `internal/collector/shell/powershell_collector.go` | `Install-Module -Name ` + 写入 Profile | `os/exec`, `os` | +| `internal/collector/package/scoop_collector.go` | `scoop bucket add` + `scoop install` | `os/exec` | +| `internal/collector/git/git_collector.go` | `git config --global ` | `os/exec` | +| `internal/collector/env/env_collector.go` | 调用 `platform.SetEnvVar()` | `internal/platform` | + +--- + +## M5: 配置与打磨（第 11-12 周） + +### 任务 5.1 — profile 命令实现 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `cmd/devpack/commands/profile.go` | 实现 create/show/list/delete/use 五个子命令的完整逻辑 | `internal/profile`, `internal/config`, `internal/ui`, `internal/logging` | + +**依赖的内部包：** + +``` +internal/profile — Profile CRUD 操作 +internal/config — 路径 +internal/ui — 表格、颜色输出 +internal/logging — 日志 + +标准库: + fmt — 输出 + os — 文件操作 + path/filepath — 路径 +``` + +--- + +### 任务 5.2 — list 命令实现 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `cmd/devpack/commands/list.go` | 实现 packs/profiles/collectors 列表展示，支持 `--format` 标志 | `internal/pack`, `internal/profile`, `internal/collector`, `internal/ui` | + +**所需标准库：** + +``` + encoding/json — --format json 输出 + fmt — 格式化 + path/filepath — 扫描 Packs 目录 + os — 读取目录 + time — Pack 创建时间 +``` + +--- + +### 任务 5.3 — diff 命令实现 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `cmd/devpack/commands/diff.go` | 实现环境对比逻辑：Pack vs 当前环境 / Pack vs Pack | `internal/pack`, `internal/collector`, `internal/ui` | + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/diff/differ.go` | 差异计算引擎：逐项对比、输出 added/removed/changed | +| `internal/diff/differ_test.go` | 差异引擎单元测试 | + +**所需库：** + +``` +标准库: + encoding/json — 数据加载 + fmt — 输出 + strings — 版本对比 + sort — 排序 + +内部依赖: + internal/ui — 彩色差异输出 (红色-/绿色+/黄色~) +``` + +--- + +### 任务 5.4 — 测试覆盖率提升 + +**新建文件：** + +| 文件 | 说明 | +|---|---| +| `internal/pack/engine_integration_test.go` | Pack 引擎集成测试：完整的打包→解包流程 | +| `internal/restore/engine_integration_test.go` | 还原引擎集成测试 | +| `test/e2e/capture_restore_test.go` | 端到端测试：capture → export → import → restore | + +**所需库：** + +``` +第三方库: + github.com/stretchr/testify/assert — 断言 + github.com/stretchr/testify/require — 必要条件断言 + github.com/stretchr/testify/mock — Mock (模拟外部命令) + +标准库: + testing — Go 测试框架 + os — 临时目录 + path/filepath — 路径 + io/fs — 文件遍历 +``` + +--- + +### 任务 5.5 — version 命令增强 + +**需修改的现有文件：** + +| 文件 | 改动 | 所需库 | +|---|---|---| +| `cmd/devpack/commands/version.go` | 添加 `--check-update` 标志，从 GitHub API 检查最新版本 | `net/http`, `encoding/json` | +| `pkg/version/version.go` | 添加 `CheckLatest()` 方法 | `net/http`, `encoding/json`, `fmt` | + +--- + +## 文件总览与新增文件清单 + +### 新建文件列表 (按模块分组) + +``` +internal/ +├── logging/ +│ ├── logger.go # zerolog 封装 +│ └── logger_test.go +├── config/ +│ ├── config.go # AppConfig 配置结构 +│ └── config_test.go +├── profile/ +│ ├── profile.go # Profile CRUD +│ ├── profile_test.go +│ └── templates.go # 预设模板 +├── ui/ +│ ├── printer.go # 统一输出工具 +│ ├── table.go # 表格渲染 +│ ├── spinner.go # 加载动画 +│ └── progress.go # 进度条 +├── errors/ +│ ├── errors.go # 错误类型 +│ └── errors_test.go +├── collector/ +│ ├── register.go # RegisterBuiltins() +│ ├── runtime/ +│ │ ├── go_collector.go +│ │ ├── go_collector_test.go +│ │ ├── node_collector.go +│ │ ├── node_collector_test.go +│ │ ├── python_collector.go +│ │ └── python_collector_test.go +│ ├── editor/ +│ │ ├── vscode_collector.go +│ │ └── vscode_collector_test.go +│ ├── shell/ +│ │ ├── powershell_collector.go +│ │ └── powershell_collector_test.go +│ ├── package/ +│ │ ├── scoop_collector.go +│ │ └── scoop_collector_test.go +│ ├── git/ +│ │ ├── git_collector.go +│ │ └── git_collector_test.go +│ └── env/ +│ ├── env_collector.go +│ └── env_collector_test.go +├── pack/ +│ ├── engine.go # PackEngine +│ ├── engine_test.go +│ ├── engine_integration_test.go +│ ├── archive.go # tar.gz 归档 +│ ├── archive_test.go +│ ├── checksum.go # SHA-256 校验和 +│ └── checksum_test.go +├── restore/ +│ ├── engine.go # RestoreEngine +│ ├── engine_test.go +│ ├── engine_integration_test.go +│ ├── plan.go # 还原计划 +│ ├── plan_test.go +│ ├── conflict.go # 冲突检测 +│ ├── conflict_test.go +│ └── report.go # 还原报告 +├── diff/ +│ ├── differ.go # 差异引擎 +│ └── differ_test.go +├── platform/ +│ └── platform_test.go # 平台层测试 +test/ +└── e2e/ + └── capture_restore_test.go # 端到端测试 +``` + +**新增文件总计：约 45 个** + +--- + +## go.mod 最终依赖 + +完成 MVP 后，`go.mod` 应包含以下直接依赖： + +```go +require ( + // CLI 框架 (已有) + github.com/spf13/cobra v1.8.0 + github.com/spf13/viper v1.18.2 + + // 日志 + github.com/rs/zerolog v1.32.0 + + // 终端 UI + github.com/fatih/color v1.16.0 + github.com/olekukonenko/tablewriter v0.0.5 + github.com/schollz/progressbar/v3 v3.14.2 + + // 交互式提示 + github.com/AlecAivazis/survey/v2 v2.3.7 + + // 数据格式 + gopkg.in/yaml.v3 v3.0.1 + + // 工具 + github.com/google/uuid v1.6.0 + + // 测试 + github.com/stretchr/testify v1.9.0 +) +``` + +v0.3.0 版本额外添加： + +```go +require ( + golang.org/x/crypto v0.21.0 // Argon2id 密钥派生 + golang.org/x/sys v0.18.0 // Windows 注册表操作 +) +``` + +--- + +## 开发顺序建议 + +``` +Week 1-2: M1 (logging → config → profile → ui → errors → init → 平台完善) + ↓ +Week 3-5: M2 (go → node → python → vscode → powershell → scoop → git → env → scan) + ↓ +Week 6-7: M3 (archive → checksum → pack engine → capture → export/import) + ↓ +Week 8-10: M4 (plan → conflict → restore engine → 各采集器 restore → restore cmd) + ↓ +Week 11-12: M5 (profile cmd → list → diff → tests → 打磨) +``` + +每完成一个模块就跑 `go test ./...` 确保不引入回归。 diff --git a/internal/collector/registry_test.go b/internal/collector/registry_test.go index 85d11c0..f1c560b 100644 --- a/internal/collector/registry_test.go +++ b/internal/collector/registry_test.go @@ -11,13 +11,13 @@ func TestRegistry_Register(t *testing.T) { mock := &mockCollector{name: "test"} err := r.Register(mock) if err != nil { - t.Fatalf("unexpected error: %v", err) + t.Fatalf("注册时不应出错: %v", err) } - // Duplicate registration should fail + // 重复注册应该失败 err = r.Register(mock) if err == nil { - t.Fatal("expected error for duplicate registration") + t.Fatal("重复注册应该返回错误") } } @@ -29,15 +29,15 @@ func TestRegistry_Get(t *testing.T) { c, ok := r.Get("test") if !ok { - t.Fatal("expected to find collector") + t.Fatal("应该能找到已注册的采集器") } if c.Name() != "test" { - t.Fatalf("expected name 'test', got '%s'", c.Name()) + t.Fatalf("期望名称为 'test'，实际为 '%s'", c.Name()) } _, ok = r.Get("nonexistent") if ok { - t.Fatal("expected not to find collector") + t.Fatal("不应该找到未注册的采集器") } } @@ -50,16 +50,16 @@ func TestRegistry_List(t *testing.T) { all := r.List() if len(all) != 3 { - t.Fatalf("expected 3 collectors, got %d", len(all)) + t.Fatalf("期望 3 个采集器，实际为 %d 个", len(all)) } runtime := r.ListByCategory(CategoryRuntime) if len(runtime) != 2 { - t.Fatalf("expected 2 runtime collectors, got %d", len(runtime)) + t.Fatalf("期望 2 个运行时采集器，实际为 %d 个", len(runtime)) } } -// mockCollector implements Collector for testing +// mockCollector 用于测试的模拟采集器 type mockCollector struct { name string category Category @@ -68,7 +68,7 @@ type mockCollector struct { func (m *mockCollector) Name() string { return m.name } func (m *mockCollector) DisplayName() string { return m.name } -func (m *mockCollector) Description() string { return "mock collector" } +func (m *mockCollector) Description() string { return "模拟采集器" } func (m *mockCollector) Category() Category { return m.category } func (m *mockCollector) IsAvailable(ctx context.Context) bool { return m.available diff --git a/internal/platform/darwin.go b/internal/platform/darwin.go index ddd11bd..c2e9801 100644 --- a/internal/platform/darwin.go +++ b/internal/platform/darwin.go @@ -18,7 +18,7 @@ func NewDarwinPlatform() *DarwinPlatform { } func (p *DarwinPlatform) OS() string { return "darwin" } -func (p *DarwinPlatform) Arch() string { return "amd64" } // TODO: detect properly +func (p *DarwinPlatform) Arch() string { return "amd64" } // TODO: 正确检测架构 func (p *DarwinPlatform) HomeDir() string { return p.homeDir } func (p *DarwinPlatform) ConfigDir() string { @@ -34,13 +34,13 @@ func (p *DarwinPlatform) GetEnvVar(key string) string { } func (p *DarwinPlatform) SetEnvVar(ctx context.Context, key, value string) error { - // On macOS, set via launchctl and shell profile + // 在 macOS 上通过 launchctl 和 Shell 配置文件设置 cmd := exec.CommandContext(ctx, "launchctl", "setenv", key, value) return cmd.Run() } func (p *DarwinPlatform) AddToPath(ctx context.Context, dir string) error { - // TODO: Add to shell profile + // TODO: 添加到 Shell 配置文件 return nil } diff --git a/internal/platform/linux.go b/internal/platform/linux.go index 7c11381..8d3ec73 100644 --- a/internal/platform/linux.go +++ b/internal/platform/linux.go @@ -18,7 +18,7 @@ func NewLinuxPlatform() *LinuxPlatform { } func (p *LinuxPlatform) OS() string { return "linux" } -func (p *LinuxPlatform) Arch() string { return "amd64" } // TODO: detect properly +func (p *LinuxPlatform) Arch() string { return "amd64" } // TODO: 正确检测架构 func (p *LinuxPlatform) HomeDir() string { return p.homeDir } func (p *LinuxPlatform) ConfigDir() string { @@ -40,12 +40,12 @@ func (p *LinuxPlatform) GetEnvVar(key string) string { } func (p *LinuxPlatform) SetEnvVar(ctx context.Context, key, value string) error { - // TODO: Add to shell profile + // TODO: 写入 Shell 配置文件以持久化 return os.Setenv(key, value) } func (p *LinuxPlatform) AddToPath(ctx context.Context, dir string) error { - // TODO: Add to shell profile + // TODO: 添加到 Shell 配置文件 return nil } diff --git a/internal/platform/platform.go b/internal/platform/platform.go index 1b73ada..80aecc3 100644 --- a/internal/platform/platform.go +++ b/internal/platform/platform.go @@ -51,7 +51,7 @@ func Detect() Platform { case "linux": return NewLinuxPlatform() default: - // Fallback to Linux + // 默认回退到 Linux 实现 return NewLinuxPlatform() } } diff --git a/internal/platform/windows.go b/internal/platform/windows.go index ccce1bd..21d40b4 100644 --- a/internal/platform/windows.go +++ b/internal/platform/windows.go @@ -55,7 +55,7 @@ func (p *WindowsPlatform) AddToPath(ctx context.Context, dir string) error { } func (p *WindowsPlatform) IsAdmin() bool { - // Check if running as administrator on Windows + // 检查 Windows 上是否以管理员身份运行 cmd := exec.Command("net", "session") err := cmd.Run() return err == nil @@ -77,7 +77,7 @@ func (p *WindowsPlatform) PackageManagers() []string { func (p *WindowsPlatform) DefaultShell() string { if _, err := exec.LookPath("pwsh"); err == nil { - return "pwsh" // PowerShell 7+ + return "pwsh" // PowerShell 7+ 版本 } return "powershell" // Windows PowerShell 5.1 } diff --git a/pkg/version/version.go b/pkg/version/version.go index 1151d0d..8cd872e 100644 --- a/pkg/version/version.go +++ b/pkg/version/version.go @@ -5,19 +5,19 @@ import ( "runtime" ) -// These variables are set at build time via ldflags. +// 以下变量在构建时通过 ldflags 注入 var ( Version = "dev" Commit = "unknown" Date = "unknown" ) -// GetVersionString returns a short version string. +// GetVersionString 返回简短的版本号字符串 func GetVersionString() string { return Version } -// GetFullVersionInfo returns complete version information. +// GetFullVersionInfo 返回完整的版本信息 func GetFullVersionInfo() string { return fmt.Sprintf( "DevPack %s\n Commit: %s\n Built: %s\n Go: %s\n OS/Arch: %s/%s",