spark magic — 系统工具

系统级实用工具：DNS 刷新、目录清理、dotfiles 部署、镜像源切换。

命令速查

spark magic flush-dns                         # 刷新 DNS 缓存
spark magic clean [-m node|python]            # 清理 node_modules 和 .venv
spark magic copy-config [<user@host:path>]    # 部署内置 nvim + ghostty 模板

# 镜像源切换（pip / go / node 通用子命令）
spark magic <pip|go|node> list                # 列出可用镜像
spark magic <pip|go|node> use <name>          # 切换镜像源
spark magic <pip|go|node> current             # 查看当前配置

spark magic flush-dns

刷新当前系统的 DNS 缓存。

spark magic flush-dns

自动检测操作系统并执行对应命令：

• macOS: sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
• Windows: ipconfig /flushdns
• Linux: sudo systemctl restart systemd-resolved

spark magic clean

递归清理项目目录中的 node_modules 和 .venv 目录。

spark magic clean                             # 清理两者
spark magic clean -m node                     # 只清理 node_modules
spark magic clean -m python                   # 只清理 .venv

行为：

• 扫描 --path 指定的目录（默认当前目录）
• 自动跳过 .git 目录
• 列出所有被清理的目录

spark magic copy-config

将编译时嵌入的 Neovim 与 Ghostty 配置模板部署到目标位置。模板源码位于 internal/templates/dotfiles/，构建时通过 //go:embed 打包进二进制。

spark magic copy-config                       # 部署到本机 ~/.config/{nvim,ghostty}
spark magic copy-config user@192.168.1.100:~/ # 通过 SSH 部署到远端
spark magic copy-config /mnt/usb/backup/      # 部署到自定义本地路径

行为：

• 无参数时写入本机默认路径（~/.config/nvim/、~/.config/ghostty/）
• 优先使用 rsync 传输，本地目标回退到 cp
• 模板为参考起点，可按需修改 internal/templates/dotfiles/ 后重新构建

spark magic pip

管理 Python pip 镜像源。

spark magic pip list                          # 列出所有可用源
spark magic pip use tsinghua                  # 切换到清华源
spark magic pip use default                   # 恢复官方源
spark magic pip current                       # 查看当前源

可用镜像源:

配置文件位置: ~/.pip/pip.conf

spark magic go

管理 Go module 代理设置。

spark magic go list                           # 列出所有可用代理
spark magic go use goproxy                    # 切换到 goproxy.cn
spark magic go use default                    # 恢复官方代理
spark magic go current                        # 查看当前代理

可用代理:

配置方式: go env -w GOPROXY=<url>

spark magic node

管理 Node.js npm registry 设置。

spark magic node list                         # 列出所有可用 registry
spark magic node use taobao                   # 切换到淘宝源
spark magic node use default                  # 恢复官方源
spark magic node current                      # 查看当前 registry

可用 Registry:

配置方式: npm config set registry <url>