常用命令速查

日常推送

每次更新网站内容后的标准流程：

git pull --rebase origin main
git add .
git commit -m "描述改动内容"
git push origin main

本地预览：

pnpm dev

网站内容管理

新增工具文章

新建 src/content/docs/tools/文件名.md，写入 frontmatter：
```
---
title: "文章标题"
description: "一句话描述"
---
```
在 astro.config.mjs 的 sidebar 对应分组里加一行：
```
{ label: "显示名称", slug: "tools/文件名" }
```

新增书签条目

编辑 src/data/bookmarks.ts，在对应分类的 items 里加：

{ name: '工具名', url: 'https://...', desc: '一句话描述', opensource: true }

新增书签分类

bookmarks.ts 新增对象：

{ category: '新分类', icon: '🔧', items: [...] }

bookmarks.mdx 加两行：

## 新分类
<BookmarkGrid category="新分类" />

BookmarkGrid.astro 的 iconMap 加对应图标映射。

新增左侧目录分组

在 astro.config.mjs 的 sidebar 加：

{
  label: "分组名称",
  items: [
    { label: "页面名", slug: "路径/文件名" },
  ],
},

网站维护

新电脑克隆仓库

生成 SSH 密钥并添加到 GitHub：
Terminal window
```
ssh-keygen -t ed25519 -C "your_email@example.com"
cat ~/.ssh/id_ed25519.pub
```
复制公钥 → GitHub → Settings → SSH and GPG keys → New SSH key。

克隆仓库：

git clone git@github.com:0xshai/bookmarks.git
cd bookmarks
pnpm dev

如果 pnpm 版本切换报错：
Terminal window
```
pnpm config set pmOnFail ignore
```
再重新运行 pnpm dev。

Git

查看与切换远程地址

# 查看当前用的哪种
git remote -v

# 切换为 SSH（推荐）
git remote set-url origin git@github.com:0xshai/仓库名.git

# 切换为 HTTPS
git remote set-url origin https://github.com/0xshai/仓库名.git

常用操作

git status                   # 查看状态
git log --oneline -10        # 查看提交历史
git pull origin main         # 拉取最新代码
git reset --soft HEAD~1      # 撤销最后一次提交（保留改动）
git reset --hard HEAD        # 丢弃所有本地改动
git diff 文件路径             # 查看某文件改动

HTTPS 方式（用 Token）

git clone https://github.com/0xshai/仓库名.git

提交信息规范

feat:     新功能
fix:      修复问题
docs:     文档改动
style:    样式调整
refactor: 重构
chore:    杂项（依赖更新等）

示例：git commit -m "feat: 新增工具说明分类"

PowerShell

代理 / 网络切换

# 设置代理（当前会话有效）
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"

# 取消代理（切回直连）
Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue

# Git 单独设置代理
git config --global http.proxy http://127.0.0.1:7890

# 取消 Git 代理
git config --global --unset http.proxy
git config --global --unset https.proxy

断网修复

右键管理员运行以下脚本，或提前保存为 fix-network.bat 放到桌面备用：

@echo off
echo 正在修复网络...

echo [1/5] 释放 IP 地址...
ipconfig /release

echo [2/5] 清除 DNS 缓存...
ipconfig /flushdns

echo [3/5] 重新获取 IP 地址...
ipconfig /renew

echo [4/5] 重置 Winsock...
netsh winsock reset

echo [5/5] 重置 TCP/IP 协议栈...
netsh int ip reset

echo.
echo 修复完成，请重启电脑。
pause

修复前后可用以下命令测试网络连通性：

ping 8.8.8.8      # 测试网络是否通（不依赖 DNS）
ping github.com   # 测试 DNS 解析是否正常

文件操作

Get-Content 文件路径                                    # 查看文件内容
Get-Content 文件路径 | Select-Object -Index (9..19)    # 查看指定行（第10-20行）
Select-String -Path 文件路径 -Pattern "关键词"          # 搜索文件内容
Remove-Item -Recurse -Force 文件夹路径                  # 删除文件夹
New-Item -ItemType Directory -Path 文件夹路径           # 新建文件夹
Copy-Item 源路径 目标路径                               # 复制文件
netstat -ano | findstr :4321                           # 查看端口占用

验证文件 Hash

(Get-FileHash "文件路径" -Algorithm SHA256).Hash -eq "官方SHA256值"

Scoop

scoop install 软件名      # 安装
scoop uninstall 软件名    # 卸载
scoop update 软件名       # 更新单个
scoop update *            # 更新所有
scoop update              # 更新 Scoop 本身
scoop list                # 查看已安装列表
scoop search 关键词       # 搜索
scoop cleanup *           # 清理旧版本
scoop info 软件名         # 查看软件信息
scoop bucket add extras   # 添加 bucket
scoop bucket add versions

多媒体处理

ImageMagick 批量转 AVIF

magick mogrify -format avif -quality 80 *.jpg

FFmpeg

ffmpeg -i 文件名                                                        # 查看文件信息
ffmpeg -i 输入.mp4 输出.mkv                                            # 转换格式
ffmpeg -i 输入.mp4 -ss 00:01:00 -to 00:02:00 -c copy 输出.mp4         # 无损剪切
ffmpeg -i 输入.mp4 -vn -acodec copy 输出.aac                           # 提取音频

HandBrake CLI（AV1 编码）

HandBrakeCLI -i 输入.mp4 -o 输出.mp4 --encoder svt_av1 --quality 30 --encoder-preset 6

Windows 快捷键

截图与录屏

快捷键	功能
`Win + Shift + S`	区域截图（截后点通知可标注）
`PrtScn`	全屏截图到剪贴板
`Win + PrtScn`	全屏截图自动保存到图片文件夹
`Win + G`	打开 Xbox Game Bar
`Win + Alt + R`	开始/停止录制当前窗口

窗口管理

快捷键	功能
`Win + ←/→`	窗口贴左/右半屏
`Win + ↑`	窗口最大化
`Win + ↓`	还原/最小化窗口
`Win + D`	显示桌面
`Win + Tab`	任务视图（所有虚拟桌面）
`Alt + Tab`	切换窗口
`Win + Ctrl + ←/→`	切换虚拟桌面

文件资源管理器

快捷键	功能
`Win + E`	打开文件资源管理器
`Alt + ←/→`	后退/前进
`Alt + ↑`	返回上级目录
`F2`	重命名
`Ctrl + Shift + N`	新建文件夹

系统

快捷键	功能
`Win + L`	锁屏
`Win + I`	打开设置
`Win + V`	剪贴板历史
`Win + .`	表情符号面板
`Ctrl + Shift + Esc`	直接打开任务管理器

参考文档

Starlight 文档

starlight.astro.build/zh-cn