实用工具 on huluhuluu

Hugging Face CLI 与 Codex Agent 使用备忘

Sun, 17 May 2026 11:38:00 +0800

Hugging Face CLI 与 Codex Agent 使用备忘

本地管理 Hugging Face Hub 上的模型、数据集和 Space 时，hf CLI 比在 Python 代码里临时写下载、上传逻辑更直接,包括两类用法：

手动在终端里使用 hf-cli 进行认证、下载、上传等操作
给 Codex 安装 Hugging Face CLI Skill，让 Agent 能按当前机器上的 hf 版本调用命令

1. 安装

1.1 独立安装

Hugging Face 官方现在提供独立安装脚本，安装后会得到 hf 命令。

Windows PowerShell：

# 安装 hf CLI
powershell -ExecutionPolicy ByPass -c "irm https://hf.co/cli/install.ps1 | iex"

# 验证安装
hf --help
hf version

Linux/macOS：

# 安装 hf CLI
curl -LsSf https://hf.co/cli/install.sh | bash

# 验证安装
hf --help
hf version

或者直接在 Python 环境中使用,无需安装：

# 使用 pip
pip install -U "huggingface_hub[cli]"

# 使用 uv
uv tool install "huggingface_hub[cli]"

临时执行一次命令时，可以用 uvx，不用把工具长期安装到当前环境：

`1`	`uvx hf auth whoami`

2. 认证

下载公开模型通常不需要登录。访问 gated model、私有仓库、上传文件时，需要登录 Hugging Face 账号。

# 交互式登录，会提示输入 token, token在 `Hugging Face` -> `Settings` -> `Access Tokens` 里创建, 
# 这个token需要有 `read` 权限才能下载，有 `write` 权限才能上传，
# 并且token只在创建时能看到一次，要妥善保管。
hf auth login

# 查看当前登录账号
hf auth whoami

# 登出
hf auth logout

在 CI 或服务器上使用时，也可以把 token 放到环境变量里，再让 hf 读取：

1
2

export HF_TOKEN="hf_xxx"
hf auth login --token "$HF_TOKEN" --add-to-git-credential

--add-to-git-credential 会把 token 写入 Git credential store，后续用 git lfs 访问 Hugging Face 仓库会更顺手。共享机器上需要注意凭据清理。

3. 下载模型和数据集

3.1 下载完整仓库

# 下载模型仓库到默认缓存目录
hf download Qwen/Qwen3-8B

# 下载到指定目录，方便后续从本地路径加载
hf download Qwen/Qwen3-8B --local-dir ./Qwen3-8B

hf download 默认使用 Hugging Face Hub 缓存。指定 --local-dir 后，文件会落到当前项目目录，适合部署脚本或离线机器复用。

3.2 只下载部分文件

# 只下载 config 和 tokenizer
hf download Qwen/Qwen3-8B config.json tokenizer.json --local-dir ./Qwen3-8B

# 只下载 safetensors 权重
hf download Qwen/Qwen3-8B --include "*.safetensors" --local-dir ./Qwen3-8B

# 排除不需要的文件
hf download Qwen/Qwen3-8B --exclude "*.msgpack" "*.h5" --local-dir ./Qwen3-8B

只需要检查模型结构时，先拉 config.json、tokenizer.json、generation_config.json 就够了；真正部署再拉权重文件。

3.3 下载数据集或 Space

模型仓库可以省略 --repo-type，数据集和 Space 需要显式指定：

# 下载数据集
hf download Salesforce/wikitext --repo-type dataset --local-dir ./wikitext

# 下载 Space
hf download HuggingFaceH4/open_llm_leaderboard --repo-type space --local-dir ./open_llm_leaderboard

4. 上传和仓库管理

4.1 创建仓库

# 创建公开模型仓库
hf repos create huluhuluu/demo-model --exist-ok

# 创建私有模型仓库
hf repos create huluhuluu/demo-model-private --private --exist-ok

# 创建数据集仓库
hf repos create huluhuluu/demo-dataset --repo-type dataset --exist-ok

--exist-ok 适合写进脚本，仓库已存在时不会直接失败。

4.2 上传文件

# 上传当前目录到模型仓库根目录
hf upload huluhuluu/demo-model . . --commit-message "upload model files"

# 上传单个文件
hf upload huluhuluu/demo-model ./README.md README.md

# 上传数据集目录
hf upload huluhuluu/demo-dataset ./data . --repo-type dataset --commit-message "upload dataset files"

大目录、大量文件或经常断点续传的场景，使用 upload-large-folder：

`1`	`hf upload-large-folder huluhuluu/demo-model ./Qwen3-8B`

4.3 上传无法直连

国内网络环境下，下载可以通过镜像站解决，但上传需要写入 Hugging Face Hub 官方仓库。代理能解决连通性问题，但大模型上传会消耗大量代理流量，所以更推荐的做法是：

小文件用代理验证账号、仓库权限和命令参数
大文件放到海外服务器、GitHub Actions、Colab 或其它能稳定访问 Hugging Face 的环境上传

不要把 HF_ENDPOINT 指到只支持下载的镜像站后再上传，这类镜像通常不负责写入官方 Hub。

先用小文件验证认证和网络，再上传大文件：

Windows PowerShell：

# 按实际代理端口修改，例如 Clash 常见为 7890
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:HTTP_PROXY = "http://127.0.0.1:7890"

# 先确认 token 和网络可用
hf auth whoami

# 用 README.md 做一次小文件上传测试
hf upload huluhuluu/demo-model ./README.md README.md --commit-message "test upload via proxy"

Linux/macOS：

# 按实际代理端口修改
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

# 先确认 token 和网络可用
hf auth whoami

# 用 README.md 做一次小文件上传测试
hf upload huluhuluu/demo-model ./README.md README.md --commit-message "test upload via proxy"

网络不稳定时，大目录不要反复用普通 hf upload 从头提交，直接使用可恢复的大目录上传，并适当降低并发。这个方案适合远端机器，不建议在本地长期挂代理跑大文件上传：

`1`	`hf upload-large-folder huluhuluu/demo-model ./Qwen3-8B --repo-type model --num-workers 2`

推荐的远端上传流程是：

# 1. 在本地把待上传目录同步到远端机器
rsync -avP ./Qwen3-8B user@<server-ip>:~/uploads/Qwen3-8B

# 2. 在远端机器登录 Hugging Face
hf auth login

# 3. 在远端机器上传到 Hugging Face Hub
hf upload-large-folder huluhuluu/demo-model ~/uploads/Qwen3-8B --repo-type model --num-workers 2

这样仍然会消耗本地到远端机器的上传带宽，但不会消耗代理订阅流量；真正到 Hugging Face 的大流量发生在远端机器和 Hugging Face 之间。

5. Codex + Skill 模式

Hugging Face 提供了面向 Agent 的 hf skills 命令。它会根据本机当前安装的 hf CLI 版本生成 Skill，让 Codex 这类 Agent 知道应该如何调用 hf。

5.1 全局安装

# 安装到全局 Agent skills 目录
hf skills add --global

# 预览将要写入的 Skill 内容
hf skills preview

全局安装适合日常开发机，后续在不同项目里打开 Codex 都能使用。

5.2 项目内安装

1
2

# 在当前项目写入 .agents/skills
hf skills add

项目内安装适合团队仓库或可复现实验环境。Skill 跟着项目走，别人 clone 仓库后能看到相同的 Agent 使用说明。

5.3 更新 Skill

hf CLI 升级后，重新生成 Skill，避免 Agent 继续使用旧命令说明。

# 更新全局 Skill
hf skills upgrade --global

# 更新当前项目 Skill
hf skills upgrade

5.4 在 Codex 中使用

安装完成后，进入需要操作的目录启动 Codex：

codex

可以直接给 Codex 下达和 Hugging Face 相关的任务，例如：

`1`	`用 hf CLI 下载 Qwen/Qwen3-8B 的 config.json 和 tokenizer.json 到 ./Qwen3-8B`

或：

`1`	`检查当前目录，创建 huluhuluu/demo-model 仓库并上传 README.md，不要上传权重文件`

Agent 执行上传、删除、创建仓库这类会改远端状态的操作前，需要先确认目标仓库名、repo-type 和 token 权限。

6. 常见命令

命令	说明
`hf auth login`	登录 Hugging Face 账号
`hf auth whoami`	查看当前登录身份
`hf download <repo_id>`	下载模型仓库
`hf download <repo_id> --repo-type dataset`	下载数据集仓库
`hf upload <repo_id> <local_path> <path_in_repo>`	上传文件或目录
`hf upload-large-folder <repo_id> <folder_path>`	上传大目录
`HTTPS_PROXY=http://127.0.0.1:7890 hf upload ...`	通过代理上传
`hf repos create <repo_id>`	创建仓库
`hf cache ls`	查看本地 Hub 缓存
`hf cache prune`	清理未引用的缓存
`hf skills add --global`	给 Codex 等 Agent 安装全局 Skill
`hf skills upgrade --global`	升级全局 Skill

7. 其它补充

国内网络环境下，直连 Hugging Face 可能较慢。只做模型下载时，可以继续使用已有的 hf-mirror 或 hfd.sh 方案。
hf upload 会真实提交到远端仓库。脚本里先用小文件测试，再上传大模型权重。
gated model 需要先在网页端申请访问权限，即使本地已经 hf auth login，没有权限也会下载失败。
私有仓库和组织仓库上传失败时，优先检查 token 的 write 权限、组织权限、repo-type 是否写对。

参考链接

cc-connect 接入微信个人号

Thu, 14 May 2026 19:05:00 +0800

cc-connect 接入微信个人号备忘

cc-connect 可以把运行在服务器的多个 AI Agent (支持Claude Code、Codex、Cursor Agent、Kimi CLI、Qoder CLI、Gemini CLI、OpenCode、iFlow CLI、Pi、Devin)接到多个聊天平台上的通用连接层，支持微信个人号、企业微信、飞书、钉钉、Slack、Telegram、Discord、LINE、微博和QQ等平台。实现流程是:

`1`	`聊天平台 <-> cc-connect <-> Agent`

参考官方架构图片：

1. 安装配置

可以通过npm安装，初次配置web配置界面前后都需要启动一次cc-connect命令

# 安装 cc-connect
➜ ✗ npm install -g cc-connect

# 首次运行前需要先运行cc-connect 产生默认配置文件
➜ ✗ cc-connect    
2026/05/14 11:23:27 INFO acquired instance lock path=/root/.cc-connect/.config.toml.lock
Created default config at /root/.cc-connect/config.toml
Please edit this file to add your agent and platform credentials, then run cc-connect again.

# 推荐优先用 Web UI 管理配置
➜ ✗ cc-connect web
Web admin is not enabled. Configuring...
Web admin configured on port 9820.
Restart cc-connect for the changes to take effect.
Opening: http://localhost:9820

➜ ✗ cc-connect  # 依旧需要启动cc-connect命令

1.1 配置

通过Vscode的Live Preview插件打开上面产生的http://localhost:9820地址，这里服务器是内网环境，直接在本地启动是不能访问的(或者可以通过ssh -L 9820:localhost:9820 user@server的方式把服务器的9820端口映射到本地).

Live Preview插件安装和使用可以参考这篇文章，通过ctrl+shift+p打开Vscode命令面板，输入Live Preview: Start Server进行启动在浏览器里打开地址http://localhost:9820，就可以看到配置界面了。这里的API令牌在初次执行cc-connect命令时会自动生成在~/.cc-connect/config.toml文件中，格式如下，可以自己找到这个位置修改token

[management]
  enabled = true
  port = 9820
  token = "ababababababababab"
  cors_origins = ["*"]

cc-connect v1.3.2版本默认带一个飞书的项目，直接删除到没有项目状态会断开等重启但是报错，建议先不动。直接点击项目 -> 新建项目，输入项目名称、工作目录以及使用的Agent 接下来出现使用平台，这里可以直接选择微信个人号，后续会有微信扫码登录的流程(这一步也可以参考文档docs/weixin.md执行)。使用个人微信扫码完后需要重启项目，随后手机微信出现授权后续就可以在微信里和这个项目进行对话了。在项目 -> 设置里可以设置管理员以及权限模式，这里的管理来源应该填入设置页面最下方的平台访问控制的id

1.2 使用

直接给机器人发消息即可，此外包括下面使用方法，详见文档

/new [名称]            创建新会话
/list                  列出所有会话
/switch <id>           切换会话
/current               查看当前会话
/dir [路径|reset]      查看、切换或重置工作目录
/mode             查看可用模式
/mode yolo        # 自动批准所有工具
/mode default     # 每次工具调用前询问
/model                      列出可用模型（格式：alias - model）
/model switch <alias>       按别名切换模型
/dir                         查看当前工作目录与历史
/dir <路径>                  切换到指定目录（相对或绝对路径）
/dir <序号>                  按历史序号切换
/dir -                       返回上一个目录
/cd <路径>                   `/dir <路径>` 的兼容别名

查看路径下文件需要使用!ls命令调用bash执行。

1.3 多工作区模式

!这东西用法很迷, 不知道想表达什么, ui界面也没有相关设置…

cc-connect提供 multi-workspace 模式需要手动在配置文件~/.cc-connect/config.toml中找到对应项目名称设置mode把work_dir修改成base_dir：

[[projects]]
name = "my-project"
mode = "multi-workspace"
base_dir = "~/workspaces"

配套命令包括：

/workspace
/workspace bind <名称>
/workspace init <git-url>
/workspace list

参考链接

ccmanager 使用备忘

Thu, 14 May 2026 19:05:00 +0800

ccmanager 使用备忘

ccmanager 是一个 AI Agent Session Manager，核心目标是把 Claude Code、Codex CLI、Gemini CLI、Cursor Agent 这类终端 Agent 会话统一管理，适合“多 Agent 会话 + 多分支并行开发”的场景，可以做到在多个分支Agent会话之间快速切换。

1. 安装和启动

通过npm进行安装：

# 全局安装
npm install -g ccmanager

# 直接运行
ccmanager

1.1 配置

README 里默认快捷键有两个(快捷键可以在 CLI/config.json修改)：

Ctrl+E：从活跃会话返回菜单，可以在Configure Shortcuts里修改
Escape：取消或返回

通过CLI界面配置codex的启动: 选择Configure Command Presets -> Select preset before session start: ❌ Disabled 设置为Enabled 随后 Add New Preset -> 选择Codex，然后设置命令为codex，参数为-a on-request -> Set as Default设置成默认启动项。

➜ ✗ ccmanager     
CCManager - Claude Code Worktree Manager v4.1.15

Select a worktree to start or resume a Claude Code session:

  0 ❯ master (main)  +26            3w ago
  ────────────── Other ──────────────
  N ⊕ New Worktree
  M ⇄ Merge Worktree
  D ✕ Delete Worktree
  P ⌨ Project Configuration
❯ C ⌨ Global Configuration # 选择全局配置
  Q ⏻ Exit

➜ ✗ 
Select a configuration option:

  S ⌨  Configure Shortcuts # 这里可以配置快捷键 ctrl+e 会被vscode 吞掉 需要自己设置
  H 🔧  Configure Status Hooks
  T 🔨  Configure Worktree Hooks
  W 📁  Configure Worktree Settings
❯ C 🚀  Configure Command Presets # 选择配置命令
  M 🔀  Configure Merge/Rebase
  O 🧪  Other & Experimental
  B ← Back to Main Menu

➜ ✗ 
Configure command presets for running code sessions

  Main (default)
      Command: claude
      Detection: Claude
  ─────────────────────────
  Select preset before session start: ❌ Disabled
  ─────────────────────────
❯ Add New Preset # 选择添加新的命令预设
  ← Cancel

Press ↑↓ to navigate, Enter to select, Esc to exit

➜ ✗ 
Choose the state detection strategy for this preset:

The command will be auto-set based on the strategy (can be changed later)

  Claude
  Gemini
❯ Codex # 选择codex
  Cursor Agent
  GitHub Copilot CLI
  Cline
  OpenCode
  Kimi

Press Enter to select, Esc to cancel

➜ ✗ 
Enter command (default set by strategy, can be modified):

Auto-filled from your strategy selection. You can change this if needed.

codex # 这里会默认填充codex enter确认

Press Enter to continue, Esc to cancel

➜ ✗
Enter command arguments (space-separated):

-a on-request # 这里可以配置启动参数 如果不配置可以不适用 -a on-request是模型自动判断执行命令是否需要权限

Press Enter to continue, Esc to cancel

➜ ✗ # 后面的fallback可以默认设空 present name根据需要写 写完后如下继续选择
Configure command presets for running code sessions

  Main (default)
      Command: claude
      Detection: Claude
❯ Codex
      Command: codex
      Args: -a on-request
      Detection: Codex
  ─────────────────────────
  Select preset before session start: ❌ Disabled  # 把这里设置成enabled
  ─────────────────────────
  Add New Preset
  ← Cancel

➜ ✗ # 把codex设置为默认启动项
  Name: Codex
  Command: codex
  Arguments: -a on-request
  Fallback Arguments: (none)
  Detection Strategy: Codex
  ─────────────────────────
❯ Set as Default
  Delete Preset
  ─────────────────────────
  ← Back to List

Press ↑↓ to navigate, Enter to edit/select, Esc to go back

1.2 使用

适合同一个项目的多个分支的同步开发，通过New Worktree新建一个工作树，Merge Worktree可以把当前工作树的修改合并到另一个工作树，Delete Worktree可以删除一个工作树。

➜ ✗ ccmanager     
CCManager - Claude Code Worktree Manager v4.1.15

Select a worktree to start or resume a Claude Code session:

  0 ❯ master (main)  +26            3w ago
  ────────────── Other ──────────────
❯ N ⊕ New Worktree # 选择新建一个工作树
  M ⇄ Merge Worktree
  D ✕ Delete Worktree
  P ⌨ Project Configuration
  C ⌨ Global Configuration 
  Q ⏻ Exit

参考链接

ccmanager GitHub

VSCode 预览插件组合备忘

Thu, 14 May 2026 18:20:00 +0800

VSCode 预览插件

这里整理几个在 VSCode 里比较常用的预览相关插件。

Live Preview: 在浏览器里实时预览 Markdown 和 HTML
Markdown Preview Enhanced: 增强 Markdown 预览，支持公式、Mermaid等
Markdown All in One: 增强 Markdown 编辑体验，支持列表、目录、快捷键等

1. Live Preview

Live Preview 适合在 VSCode 里快速起一个预览服务，通过ctrl+shift+p打开Vscode命令面板，输入Live Preview: Start Server进行启动随后可以直接打开服务器上部署的网页地址，例如

2. Markdown 相关插件

直接在Vscode 插件商店里搜索markdown安装

Markdown Preview Enhanced 加强 Markdown 预览，点击markdown文件的右上角可以预览，在预览界面可以刷新/显示标题大纲。
Markdown All in One 有更强的“编辑体验”，通过ctrl + shift + p调出Vscode控制面板, 搜索Markdown All in One 可以看到它提供的功能列表，比较实用的有：创建目录等，并且提供了快捷键：加粗、斜体、等功能的快捷键。

参考链接

MeshCentral 使用备忘

Sun, 26 Apr 2026 17:10:00 +0800

MeshCentral 使用备忘

如果只是想在手机上接管一个终端，tmux + ttyd + Tailscale 已经够用了。
但如果想把多台机器统一纳管，顺手拿到终端、文件、桌面和设备信息，MeshCentral 更合适。

这次的使用结构是：

Ubuntu Server：跑 MeshCentral Server
Ubuntu 机器1：安装 Mesh Agent
Windows 机器：安装 Mesh Agent
Android：直接用浏览器访问 MeshCentral Web

1. 整体思路

可以把它理解成一个中心控制台：

Android 浏览器
       |
       v
Ubuntu Server (MeshCentral Server)
      / \
     /   \
    v     v
Ubuntu 机器1   Windows 机器
   Mesh Agent   Mesh Agent

核心点：

MeshCentral Server 提供 Web 控制台和中继能力
被控机器只需要主动安装并连接 Mesh Agent
Android 端不需要装 agent，直接浏览器登录即可

2. MeshCentral Server安装

2.1 安装 Node.js 和 npm

MeshCentral 基于 Node.js 运行，先准备运行时：

sudo apt update
sudo apt install -y nodejs npm

node -v  # v22.22.0 输出版本号表示安装成功
npm -v # 10.9.4 输出版本号表示安装成功

# 如果 node 版本过低，可以使用 nvm 安装最新版本的 nodejs
# nvm 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash 
# 如果索引不到 node，需要激活nvm
echo '
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
source ~/.zshrc
nvm --version # 验证nvm
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node # 设置镜像源
# 如果nodejs版本过低，可以使用nvm安装最新版本的nodejs
nvm install 20 # 安装nodejs 20版本

2.2 允许 Node 监听低端口

MeshCentral 默认会用到 80、443 和 4433 端口。
在 Linux 上，普通用户默认不能直接监听 1024 以下端口，所以先给 node 这个能力：

1
2

whereis node
sudo setcap cap_net_bind_service=+ep /usr/bin/node

上面的 /usr/bin/node 需要和你本机实际 node 路径一致。

2.3 安装并启动

mkdir -p ~/meshcentral
cd ~/meshcentral

npm install meshcentral
node node_modules/meshcentral # 启动demo验证

# 正式启动 指定端口
node node_modules/meshcentral --port 8009

第一次启动后，会在当前目录生成 meshcentral-data，配置文件也会放在这里。

2.4 首次登录

启动后，在浏览器访问：

1
2

https://服务器IP/
https://服务器域名/

第一次创建的账号会自动成为管理员账号.

默认情况下，MeshCentral 以 LAN-only 模式启动，适合同一局域网内先测试流程。

3. Ubuntu 安装 Mesh Agent

大致流程：

登录 Web 控制台
新建一个设备组，或者进入现有设备组
在组内选择添加设备 / 安装 agent
选择对应平台，例如 Linux x86-64
复制服务端生成的安装命令，到目标 Ubuntu 机器执行

这样：

agent 会自动带上当前服务端地址
会自动归到你选中的设备组
少手动拼参数，不容易把连接地址写错

安装完后，目标 Ubuntu 机器会自动回连到服务端，并出现在设备列表里。

1
2

# 下面的ip必须修改为可达ip
(wget "https://127.0.0.1:8009/meshagents?script=1" --no-check-certificate -O ./meshinstall.sh || wget "https://127.0.0.1:8009/meshagents?script=1" --no-proxy --no-check-certificate -O ./meshinstall.sh) && chmod 755 ./meshinstall.sh && sudo -E ./meshinstall.sh https://127.0.0.1:8009 '<mesh-agent-token>' || ./meshinstall.sh https://127.0.0.1:8009 '<mesh-agent-token>'

4. Windows 机器安装 Mesh Agent

Windows 端同样建议从 MeshCentral Web 里直接下载当前组对应的安装包。

流程基本一样：

登录 Web 控制台
进入目标设备组
选择 Windows 平台 agent
下载生成好的 exe
在目标 Windows 机器上运行安装

安装完成后，Windows 机器会自动上线。
按照官方文档，默认安装路径通常在：

`1`	`c:\Program Files\Mesh Agent`

如果要手动控制服务，可参考：

1
2

net start "mesh agent"
net stop "mesh agent"

BUGS: 当前MeshCentral v1.1.54版本的winodows安装有问题
- 页面刚刷新时才能下载
- 下载后双击exe无法安装，出现找不到指定程序，需要管理员模式启动pwsh，执行： .\meshagent64-codex.exe --fullinstall 参数安装

5. Android 浏览器访问

这部分是整个方案里最直接的地方：Android 不装 agent，只需要浏览器。

在手机浏览器打开：

`1`	`https://服务器IP/`

或者：

`1`	`https://服务器域名/`

登录后就可以看到已经接入的 Ubuntu 和 Windows 设备。

在手机上更实用的几个入口通常是：

Terminal：最顺手，适合命令行操作
Files：传小文件很方便
Desktop：也能用，但手机上更适合横屏

如果只是偶尔从手机管理机器，这种方式通常比远程桌面客户端更轻。

6. 网络模式说明

6.1 同一局域网

如果：

Ubuntu Server
Ubuntu 机器1
Windows 机器
Android

都在同一个局域网，默认 LAN-only 模式就足够先跑起来。

可以通过Tailscale 等的组网软件进行组网，只对自己的设备开放

6.2 跨网络访问

如果你想让外网下的 Android 浏览器也能访问，默认 LAN-only 支持不够。需要把 MeshCentral 配成 WAN/Hybrid 模式，使用固定公网 IP 或域名

参考链接

ttyd 使用备忘

Sat, 25 Apr 2026 21:10:00 +0800

ttyd 使用备忘

临时使用手机连接服务器上的 Codex，会碰到两个问题：

远程桌面在手机上比例差不顺手
纯 SSH 连接使用tmux退出的前置键位等操作不顺手

可以使用下面方案：

tmux + ttyd + Tailscale

思路很直接：

用 tmux 承载 Codex 会话
用 ttyd 把这段终端会话变成网页
用 Tailscale 把访问范围限制在自己的 tailnet 内
手机上直接打开网页终端连接

1. 准备 tmux

建议 Codex 跑在独立会话里：

`1`	`tmux new -A -s codex`

这样你电脑上 SSH 连进去可以接管，手机上通过 ttyd 打开网页也能接管，核心会话始终是同一个。

2. 准备 ttyd

2.1 安装

ttyd 是一个把终端共享成 Web 页面的工具。

Linux 安装：

1
2
3

sudo apt install ttyd -y
ttyd -v
# ttyd version 1.6.3 # 输出版本号表示安装成功

Windows 安装：

1
2
3

scoop install ttyd
ttyd -v
# ttyd version 1.7.7-40e79c7 # 输出版本号表示安装成功

2.2 最小可用命令

先直接起一个最小服务：

1
2
3

# 可选是否使用认证
ttyd -p 7681 -c admin:admin123 tmux new -A -s codex
ttyd -p 7681 tmux new -A -s codex

其中：

-p 7681：监听端口
-c admin:admin123：开启基础认证, 用户名是 admin，密码是 admin123
tmux new -A -s codex：把网页终端连接到 codex 这个 tmux 会话

然后在浏览器打开：

1
2

# 注意这里需要填当前浏览器设备可访问的服务器 IP 地址
http://服务器IP:7681

3. Tailscale 控制连接

Tailscale 能让分布在不同网络下的设备通过身份认证安全地组成一个局域网，实现内网穿透和直接访问。

3.1 安装

Linux：Tailscale 内核模式依赖 TUN，通常需要宿主机管理员权限。

curl -fsSL https://tailscale.com/install.sh | sh
# 启动服务
sudo tailscale up
# 接着会输出一个登录链接，复制到浏览器里登录后服务器就加入了你的 tailnet

无 TUN 模式：

  curl -fsSL https://tailscale.com/install.sh | sh
  # 安装完后分别在两个 shell 执行
  tailscaled \
      --tun=userspace-networking \
      --socks5-server=127.0.0.1:1055 \
      --outbound-http-proxy-listen=127.0.0.1:1055
  tailscale up
  # 接着会输出一个登录链接，复制到浏览器里登录后服务器就加入了你的 tailnet

  # 无 TUN 模式下，应用不会自动走 Tailscale，要显式走代理
  # 例如
  export ALL_PROXY=socks5://127.0.0.1:1055
  export HTTP_PROXY=http://127.0.0.1:1055
  export HTTPS_PROXY=http://127.0.0.1:1055

Windows：
- 直接从 Tailscale 官网下载 Windows 安装包，安装后登录即可。
Android：
- Google Play 可用：直接从 Google Play 安装 Android 客户端。
- Google Play 不可用：从 Tailscale 官方提供的 Android APK 手动安装。

3.2 网络连接

服务器可能在内网环境，不具有公网 IP，通过 Tailscale 可以让同一 tailnet 内的设备访问这个服务。

ttyd 只监听 127.0.0.1
用 tailscale serve 把本地端口暴露给 tailnet 内的设备

启动 ttyd：

`1`	`ttyd -i 127.0.0.1 -p 7681 tmux new -A -s codex`

随后服务器和访问设备都启动 Tailscale，并加入同一个 tailnet，就可以从访问设备访问服务器上的 ttyd 服务：

# Linux 上通过命令查找 Tailscale 分配的 IP 地址，例如
➜ tailscale ip
100.xx.xx.60
# Windows / Android 上可以在客户端界面查看分配的 IP 地址

# 在访问设备上打开浏览器访问
100.xx.xx.60:7681
# [可选]输入用户名和密码

Windows 连接：
Android 连接：

问题记录：

-c 认证可以访问 token，但在部分浏览器里可能无法正常建立连接。
默认前端 xterm.js 在 Android 设备上可能出现渲染问题，可以尝试 -t rendererType=canvas。

参考链接

Windows 本地命令库快速检索

Sat, 25 Apr 2026 21:10:00 +0800

Windows 本地命令库快速检索

需要使用的命令太多难以记全，而本地的大部分命令备忘录都写在同一个目录的不同文件内容，每次找命令打开 VS Code 再全局搜索，步骤太长。更合适的方式是：

Listary -> 启动脚本 -> rg 缩小文件范围 -> fzf 预览 -> 一键复制命令或打开原文

1. 依赖

`1`	`scoop install fzf ripgrep`

2. 脚本位置

脚本包含两个文件：

Find-UsefulToolCommand.ps1
Run-UsefulToolCommandSearch.cmd
UsefulToolCommandSearch.root.txt.example

其中：

.ps1 是真正干活的主脚本
.cmd 是给 Listary 调起用的启动器，只负责把参数原样转给 .ps1
.root.txt.example 是默认搜索目录的示例配置

调用关系是：

Listary -> Run-UsefulToolCommandSearch.cmd -> Find-UsefulToolCommand.ps1 -> rg + fzf

主脚本会：

遍历目标目录下的 Markdown
提取标题和 fenced code block
如果传入初始查询词，先用 rg 缩小候选文件范围
把候选片段送进 fzf
在右侧预览里展示代码块或标题上下文
根据按键执行复制、打开、复制路径

2.1 默认查询目录

脚本现在支持三种方式指定搜索根目录，优先级从高到低是：

启动时显式传 -Root
环境变量 USEFUL_TOOL_SEARCH_ROOT
scripts/UsefulToolCommandSearch.root.txt
如果都没有，就回退到脚本默认值，也就是 content/post/useful-tools

最省事的方式是直接在 scripts 目录下新建：

`1`	`UsefulToolCommandSearch.root.txt`

文件内容只写一行目录路径，例如：

`1`	`C:\Users\xxx\work\blog\HugoBlog\content\post\useful-tools\blog`

或者写相对路径：

`1`	`..\..\..`

2.2 主脚本使用方式

直接运行:

`1`	`pwsh -NoProfile -ExecutionPolicy Bypass -File .\Find-UsefulToolCommand.ps1`

或者给一个初始查询词：

1
2

pwsh -NoProfile -ExecutionPolicy Bypass -File .\Find-UsefulToolCommand.ps1 docker
pwsh -NoProfile -ExecutionPolicy Bypass -File .\Find-UsefulToolCommand.ps1 adb wireless

如果想临时指定搜索目录：

`1`	`pwsh -NoProfile -ExecutionPolicy Bypass -File .\Find-UsefulToolCommand.ps1 -Root 'C:\my-notes' docker`

2.3 调用 `.cmd` 启动器

也可以调用 launcher：

`1`	`.\Run-UsefulToolCommandSearch.cmd git rebase`

这里的参数会被 .cmd 原样转给 .ps1，所以：

Run-UsefulToolCommandSearch.cmd 只负责启动 PowerShell
Find-UsefulToolCommand.ps1 git rebase 才是真正执行搜索

2.4 `fzf` 内快捷键

Enter：打开文件，默认优先用 VS Code 并跳到对应行
Ctrl+O：同样打开文件
Ctrl+Y：复制当前代码块或标题内容到剪贴板
Ctrl+P：复制当前文件路径
Ctrl+/：切换预览窗口

3. Listary

Listary 在这个流程中只负责全局唤起。

3.1 设置命令

右下角托盘右键 Listary，打开 Listary -> 选项 -> 命令
新增一个自定义命令，Alias 填一个自己顺手的别名，Path 或 Program 指向脚本绝对路径，参数默认填 {query}
保存

这样以后在 Listary 里输入：

1
2

# 这里需要多输一个空格 不然解析不出来
cmdnote

就会直接拉起 fzf 让你做全量筛选，如图：

3.2 传 `Listary` 关键字给脚本

上面设置的参数 {query} 会被 Listary 替换成你输入的内容，也就是初始查询词，所以你可以在 Listary 里直接输入：

`1`	`cmdnote uv pip install`

这会把 Listary 输入的内容作为初始查询词传给脚本：

3.3 Listary 内快捷键

启动搜索面板：连按两次 Ctrl
Web 搜索：g/bing + 空格 + 查询词，分别是谷歌 / 必应搜索

参考链接

Ubuntu Proxy Configuration

Fri, 10 Apr 2026 01:30:00 +0800

Ubuntu Proxy Configuration

内网服务器通常无法直接访问外网，需要通过代理访问。本文介绍三种常用方案：Clash 内核、SSH 反向端口转发、Tailscale 组网。

方案对比

方案	优点	缺点	适用场景
Clash 内核	独立运行，不依赖外部	需要在服务器上运行代理程序	服务器资源充足，长期使用
SSH 反向转发	简单快速，无需额外软件	需要 PC 在线，连接可能断开	临时使用，PC 和服务器在同一局域网
Tailscale 组网	稳定可靠，跨网络可用	需要注册账号，额外安装软件	多台设备互联，跨网络访问

方案一：Clash 内核

在服务器上直接运行 Clash 内核，服务器独立使用代理, 当前clash-for-linux项目提供了更加完整、更优雅的 Linux Clash / Mihomo 运行平台。

1.1 下载使用

项目提供的脚本可以一键安装配置，手动提供代理链接即可：

> git clone --branch master --depth 1 https://ghfast.top/https://github.com/wnlen/clash-for-linux.git
> cd clash-for-linux
> bash install.sh
Cloning into 'clash-for-linux'...
remote: Enumerating objects: 44, done.
remote: Counting objects: 100% (44/44), done.
remote: Compressing objects: 100% (37/37), done.
remote: Total 44 (delta 1), reused 31 (delta 1), pack-reused 0 (from 0)
Receiving objects: 100% (44/44), 12.85 MiB | 5.95 MiB/s, done.
Resolving deltas: 100% (1/1), done.
⏳ 正在下载：Country.mmdb [gh-proxy]
######################################################################## 100.0%
⏳ 正在下载：geoip.metadb [gh-proxy]
######################################################################## 100.0%
⏳ 正在下载：GeoLite2-ASN.mmdb [gh-proxy]
######################################################################## 100.0%
⏳ 正在下载：GeoIP.dat [gh-proxy]
######################################################################## 100.0%
⏳ 正在下载：GeoSite.dat [gh-proxy]
######################################################################## 100.0%
⏳ 正在下载：mihomo（可在 .env 中设置 MIHOMO_DOWNLOAD_BASE / MIHOMO_DOWNLOAD_URL） [gh-proxy]
######################################################################## 100.0%
⏳ 正在下载：yq [gh-proxy]
######################################################################## 100.0%
⏳ 正在下载：subconverter [gh-proxy]
######################################################################## 100.0%
🎯 端口冲突：[mixed-port] 7890 🎲 随机分配：7892
🎯 端口冲突：[external-controller] 0.0.0.0:9090 🎲 随机分配：0.0.0.0:9091

🚀 请输入订阅链接
> http://example.com/subscription
⏳ 正在下载：subscription
######################################################################## 100.0%
✨ 订阅已生效

🎉 安装完成

🚀 当前内核：mihomo
🧬 系统架构：amd64
💻 环境模式：容器
📁 安装路径：/root/clash-for-linux
👤 安装方式：root / system
🔧 运行后端：script
📦 订阅：已配置
🔢 节点数量：46

╔════════════════════════════════════════════════╗
║                 🐱 Web 控制台                  ║
╠════════════════════════════════════════════════╣
║                                                ║
║      🔓 注意放行端口：9091                      ║
║      📶 状态：可访问                            ║
║      🏠 内网：http://127.0.0.1:9091/ui         ║
║      📡 公共：http://board.example.com         ║
║      🔑 密钥：ababaabababababa                 ║
║                                                ║
╚════════════════════════════════════════════════╝

〽️ 常用命令
  clashon            🚀 开启代理
  clashoff           ⛔ 关闭代理
  clashctl select    💫 选择节点
🕹️  控制台
  clashui            🕹️  查看 Web 控制台
  clashsecret        🔑 查看或设置 Web 密钥
📦 订阅
  clashctl add       ➕ 添加订阅
  clashctl add local ➕ 从 runtime/subscriptions 导入本地订阅
  clashctl use       💱 切换订阅
  clashctl ls        📜 查看订阅列表
📌 高级
  clashctl lan       🏠 局域网代理管理
  clashctl tun       🧪 Tun 模式管理
  clashctl mixin     🧩 Mixin 配置管理
  clashctl sub       🧩 订阅高级管理（启用 / 禁用 / 重命名 / 删除）
  clashctl upgrade   🚀 升级当前或指定内核
  clashctl update    🔄 更新项目代码
  clashctl completion 💡 导出 Bash / Zsh 补全脚本
📜 日志
  clashctl doctor    🩺 诊断面板
  clashctl log/logs  📜 查看日志

💡 显示更多帮助命令：clashctl -h

💡 clashon / clashoff 为 shell 快捷入口；新终端会自动生效
💡 当前终端若暂不可用，请先使用 clashctl on / clashctl off

1.2 配置代理

这里的Web 控制台提供本地和公共两个版本，公共控制台可以直接公网访问需要配合密钥使用，这里需要手动设置Global节点，侧栏提供监控面板监控内存使用/上传速度/下载速度等信息。服务器本地的控制台可以通过Live Preview插件访问，参考VSCode 预览插件组合备忘里介绍的使用方法。

1.3 使用代理

注意这里的端口是随机分配的，安装完成后会输出实际使用的端口号，例如上面的 7892。设置系统环境变量让应用走代理：

1
2

export http_proxy="http://127.0.0.1:7892" && export https_proxy="http://127.0.0.1:7892"
export all_proxy="socks5://127.0.0.1:7892" # 注意这里是 socks5 协议

方案二：SSH 反向端口转发

通过 SSH 将本地 PC 的代理端口转发到服务器，服务器无需运行代理程序。

2.1 原理示意

┌─────────┐                      ┌─────────┐
│   PC    │                      │ Server  │
│ (内网)   │                      │ (内网)   │
│         │    SSH 反向隧道        │         │
│ :7890 ←─┼──────────────────────┼─→ :7890 │
│ (Clash) │                      │ (转发)   │
└─────────┘                      └─────────┘

2.2 从 PC 连接到服务器

从 PC 连接到服务器搭建端口转发隧道，这里的本地端口要对应代理软件端口(可以在设置中查看)：

# 在 PC 上执行：
ssh -R 7890:127.0.0.1:7890 user@server_ip -N -f

# 此时服务器的 127.0.0.1:7890 会转发到 PC 的 127.0.0.1:7890

2.3 设置系统代理

# 在服务器上设置代理
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"
export all_proxy="socks5://127.0.0.1:7890" # 注意这里是 socks5 协议

方案三：Tailscale 组网

使用 Tailscale 等 VPN 工具组建虚拟局域网，PC 和服务器可以互相访问。

3.1 安装 Tailscale

Linux：Tailscale 内核模式依赖 TUN，通常需要宿主机管理员权限，联系服务器管理员或者使用无TUN模式。

curl -fsSL https://tailscale.com/install.sh | sh
# 启动服务
sudo tailscale up
# 接着会输出一个登录链接，复制到浏览器里登录后服务器就加入了你的 tailnet

无 TUN 模式：

  curl -fsSL https://tailscale.com/install.sh | sh
  # 安装完后分别在两个 shell 执行
  tailscaled \
      --tun=userspace-networking \
      --socks5-server=127.0.0.1:1055 \
      --outbound-http-proxy-listen=127.0.0.1:1055
  tailscale up
  # 接着会输出一个登录链接，复制到浏览器里登录后服务器就加入了你的 tailnet

  # 无 TUN 模式下，应用不会自动走 Tailscale，要显式走代理
  # 例如
  export HTTP_PROXY=http://127.0.0.1:1055
  export HTTPS_PROXY=http://127.0.0.1:1055

Windows：
- 直接从 Tailscale 官网下载 Windows 安装包，安装后登录即可。
Android：
- Google Play 可用：直接从 Google Play 安装 Android 客户端。
- Google Play 不可用：从 Tailscale 官方提供的 Android APK 手动安装。

3.2 登录并组网

# 登录 Tailscale（在 PC 和服务器上都执行）
sudo tailscale up

# 会输出一个链接，用浏览器打开登录

3.3 查看组网设备

# 查看所有设备
tailscale status

# 输出示例：
# 100.64.0.1   mypc        linux  -
# 100.64.0.2   myserver    linux  -

# PC 的 Tailscale IP: 100.64.0.1
# 服务器的 Tailscale IP: 100.64.0.2

3.4 使用代理

Tailscale 有 TUN 模式和无 TUN 模式，两种情况下使用 PC 代理的方式不同。

3.4.1 有 TUN 模式

服务器有正常的 Tailscale 网卡和路由时，可以直接访问 PC 的 Tailscale IP。PC 代理软件需要开启“允许局域网连接”功能。

# 在服务器上设置代理（使用 PC 的 Tailscale IP）
export http_proxy="http://100.64.0.1:7890"
export https_proxy="http://100.64.0.1:7890"
export all_proxy="socks5://100.64.0.1:7890"

# 测试连接
curl -x http://100.64.0.1:7890 https://www.google.com

3.4.2 无 TUN 模式

无 TUN 模式下，服务器不会得到一个正常的 Tailscale 网卡，也不会自动拥有到 100.64.0.0/10 的系统路由。

tailscaled 提供的 127.0.0.1:1055 是一个本地代理入口。它的作用是：让服务器上的应用通过这个入口访问 tailnet 里的设备，例如 PC 的 100.64.0.1。

要让服务器使用 PC 上的 Clash / Mihomo 代理，实际链路分成两段：

Server app
  -> 127.0.0.1:1055  # server 上的 Tailscale userspace proxy
  -> 100.64.0.1:7890 # PC 上的 Clash / Mihomo 代理端口
  -> Internet

PC 端代理软件仍然需要开启“允许局域网连接”或等价的 allow-lan 配置，先用 curl 做单次测试。curl 支持 --preproxy，可以显式表达这条两级代理链：

curl \
  --preproxy socks5h://127.0.0.1:1055 \
  -x http://100.64.0.1:7890 \
  https://www.google.com

这里两个参数的含义是：

--preproxy socks5h://127.0.0.1:1055：先通过服务器本机的 Tailscale userspace proxy 进入 tailnet
-x http://100.64.0.1:7890：再使用 PC 上的 HTTP 代理端口访问目标网站

不要把环境变量直接写成下面这样：

1
2

export http_proxy="http://127.0.0.1:1055"
export https_proxy="http://127.0.0.1:1055"

这样只是让应用把请求交给 Tailscale userspace proxy，不等价于使用 PC 上的 Clash / Mihomo 出网。

通用命令行工具通常只支持一个代理地址，没法只靠 HTTP_PROXY / HTTPS_PROXY 表达两级代理链。其它应用按下面三类处理：

应用能力	做法
支持 `preproxy` / 代理链	直接按应用自己的代理链配置填写 `127.0.0.1:1055 -> 100.64.0.1:7890`
只支持一个 `HTTP_PROXY` / `HTTPS_PROXY`	在服务器本地起一个代理转发器，把两级代理链封装成本地单端口
完全不支持代理	优先用 SSH 反向端口转发，或者改用支持代理的下载/上传工具

例如用第二类，可以使用 gost 在服务器上起一个本地 HTTP 代理，把后面的两级链路封装起来：

gost \
  -L http://127.0.0.1:7891 \
  -F socks5://127.0.0.1:1055 \
  -F http://100.64.0.1:7890

之后其它应用只需要配置一个普通代理地址：

export http_proxy="http://127.0.0.1:7891"
export https_proxy="http://127.0.0.1:7891"

curl https://www.google.com

这时链路变成：

Other app
  -> 127.0.0.1:7891 # server 上的 gost 本地代理
  -> 127.0.0.1:1055 # server 上的 Tailscale userspace proxy
  -> 100.64.0.1:7890 # PC 上的 Clash / Mihomo 代理端口
  -> Internet

3.5 其他组网工具

工具	特点
Tailscale	基于 WireGuard，简单易用，免费版支持 100 设备
ZeroTier	支持自建控制器，免费版支持 25 设备
WireGuard	轻量高效，需手动配置
frp	内网穿透工具，适合有公网服务器的情况

参考链接

ADB 使用备忘

Wed, 01 Apr 2026 10:00:00 +0800

ADB 使用备忘

ADB (Android Debug Bridge) 是 Android 开发和调试的必备工具，用于与 Android 设备通信。本文记录常用命令和使用技巧。

1. 安装

1.1 Windows

# 方式1: 使用 winget
winget install Google.PlatformTools

# 方式2: 手动安装
# 下载 SDK Platform-Tools
# https://developer.android.com/studio/releases/platform-tools
# 解压后添加到 PATH 环境变量
# 或放入已有 PATH 目录如 C:\Windows

1.2 Linux

1
2

# Ubuntu/Debian
sudo apt install android-tools-adb

1.3 验证安装

1
2
3

adb version
# Android Debug Bridge version 1.0.41
# Version 34.0.5-10900879

2. 连接设备

2.1 USB 连接

手机开启开发者选项：设置 → 关于手机 → 连续点击"版本号" 7 次
开启 USB 调试：设置 → 开发者选项 → USB 调试
USB 连接电脑，选择"文件传输"模式
授权调试

# 查看已连接设备
adb devices

# 输出示例
# List of devices attached
# abc123    device

DEBUG:no permissions (user huluhulu is not in the plugdev group); ，参考

确保自己添加在组plugdev中, 第一次添加需要重新登录用户才能生效。

`1`	`sudo usermod -aG plugdev $USER`

添加 udev 规则，创建文件 /etc/udev/rules.d/51-android.rules，内容如下（根据lsusb命令的输出设置）：

huluhulu@march-dlng:~$ lsusb # 如果修改了手机的连接模式，下面id会随之变化(例如从仅充电修改成文件传输)
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 002: ID 048d:5702 Integrated Technology Express,  Inc. RGB LED Controller
Bus 001 Device 003: ID 05e3:0608 Genesys Logic,  Inc. Hub
Bus 001 Device 004: ID 05e3:0608 Genesys Logic,  Inc. Hub
Bus 001 Device 005: ID 046d:c31c Logitech,  Inc. Keyboard K120
Bus 001 Device 006: ID 046d:c53f Logitech,  Inc. USB Receiver
Bus 001 Device 011: ID 22d9:2765 OPPO Electronics Corp. Oppo N1 # ----> 这里是连接的手机 记住ID后面的数字
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub

# 例如上面手机的 ID 是 22d9:2765，分别表示厂商 ID 和产品 ID，规则内容如下

# 接下来添加`udev`规则
sudo vim /etc/udev/rules.d/51-android.rules
# 把下面内容添加到文件中，保存退出
# SUBSYSTEM=="usb",  ATTR{idVendor}=="22d9",  ATTR{idProduct}=="2765",  MODE="0666" # 这里0666表示所有用户可读写设备

# 修改权限并重启udev
sudo chmod a+rx /etc/udev/rules.d/51-android.rules
sudo service udev restart
# 重启adb服务
sudo adb kill-server
sudo adb start-server

2.2 无线连接

# 首次需要 USB 连接，开启 TCP/IP 模式
adb tcpip 5555

# 查看手机 IP
adb shell ip addr show wlan0

# 断开 USB，通过 WiFi 连接
adb connect 192.168.1.100:5555

# 断开连接
adb disconnect 192.168.1.100:5555

# Android 11+ 可直接扫码配对
# 设置 → 开发者选项 → 无线调试 → 使用配对码配对设备
adb pair 192.168.1.100:37123
# 输入配对码
adb connect 192.168.1.100:5555

2.3 多设备管理

# 查看所有设备
adb devices -l

# 指定设备执行命令
adb -s <serial> shell

# 通过 USB 连接
adb -d shell

# 通过 TCP/IP 连接
adb -e shell

3. 基本命令

3.1 设备信息

# 设备序列号
adb get-serialno

# 设备状态
adb get-state

# Android 版本
adb shell getprop ro.build.version.release

# SDK 版本
adb shell getprop ro.build.version.sdk

# 设备型号
adb shell getprop ro.product.model

# 设备品牌
adb shell getprop ro.product.brand

# 所有属性
adb shell getprop

3.2 Shell 操作

# 进入交互式 Shell
adb shell

# 执行单条命令
adb shell ls /sdcard
adb shell cat /proc/cpuinfo

# 以 root 身份运行（需设备已 root）
adb root
adb shell

# 重新挂载系统分区为可写
adb remount

4. 文件传输

4.1 推送文件到设备

# 基本语法
adb push <本地文件> <设备路径>

# 示例
adb push test.txt /sdcard/
adb push folder/ /sdcard/folder/

# 推送并设置权限
adb push script.sh /data/local/tmp/
adb shell chmod +x /data/local/tmp/script.sh

4.2 从设备拉取文件

# 基本语法
adb pull <设备路径> <本地路径>

# 示例
adb pull /sdcard/test.txt ./
adb pull /sdcard/DCIM/ ./photos/

4.3 同步文件

# 同步到设备（只传输变化的文件）
adb sync

# 指定同步目录
adb sync /sdcard/

5. 应用管理

5.1 安装应用

# 安装 APK
adb install app.apk

# 覆盖安装（保留数据）
adb install -r app.apk

# 允许降级安装
adb install -d app.apk

# 安装到 SD 卡
adb install -s app.apk

# 多个 APK（Split APK）
adb install-multiple base.apk config.arm.apk

5.2 卸载应用

# 卸载应用
adb uninstall com.example.app

# 卸载但保留数据
adb uninstall -k com.example.app

# 查看已安装应用
adb shell pm list packages
adb shell pm list packages -3  # 第三方应用
adb shell pm list packages -s  # 系统应用

5.3 清除应用数据

# 清除数据和缓存
adb shell pm clear com.example.app

# 清除缓存
adb shell rm -rf /data/data/com.example.app/cache/*

5.4 启动应用

# 启动应用
adb shell am start -n com.example.app/.MainActivity

# 启动特定 Activity
adb shell am start -n com.example.app/com.example.app.SecondActivity

# 带参数启动
adb shell am start -a android.intent.action.VIEW -d https://baidu.com

# 启动 Service
adb shell am startservice com.example.app/.MyService

# 停止应用
adb shell am force-stop com.example.app

5.5 应用信息

# 应用路径
adb shell pm path com.example.app

# 应用详细信息
adb shell dumpsys package com.example.app

# 当前前台应用
adb shell dumpsys activity activities | grep mCurrentFocus

6. 日志与调试

6.1 日志查看

# 查看所有日志
adb logcat

# 清除日志缓冲区
adb logcat -c

# 查看特定级别日志
adb logcat *:V    # Verbose
adb logcat *:D    # Debug
adb logcat *:I    # Info
adb logcat *:W    # Warning
adb logcat *:E    # Error

# 过滤特定标签
adb logcat -s TAG_NAME
adb logcat TAG_NAME:V *:S

# 过滤关键字
adb logcat | grep "keyword"

# 过滤应用日志（需要 PID）
adb logcat --pid=$(adb shell pidof com.example.app)

# 保存日志到文件
adb logcat > logcat.txt

# 查看内核日志
adb shell dmesg

6.2 Bug 报告

# 生成 bug 报告
adb bugreport bugreport.zip

# 快速报告
adb bugreport -k

6.3 内存信息

# 查看内存使用
adb shell dumpsys meminfo

# 特定应用内存
adb shell dumpsys meminfo com.example.app

# 查看 CPU 使用
adb shell top
adb shell dumpsys cpuinfo

7. 截图与录屏

7.1 截图

# 截图保存到设备
adb shell screencap /sdcard/screenshot.png

# 拉取到电脑
adb pull /sdcard/screenshot.png

# 一行命令截图并拉取
adb exec-out screencap -p > screenshot.png

7.2 录屏

# 开始录屏（最长 180 秒）
adb shell screenrecord /sdcard/video.mp4

# 设置时长（秒）
adb shell screenrecord --time-limit 30 /sdcard/video.mp4

# 设置分辨率
adb shell screenrecord --size 1280x720 /sdcard/video.mp4

# 设置比特率
adb shell screenrecord --bit-rate 4000000 /sdcard/video.mp4

# Ctrl+C 停止录屏，然后拉取
adb pull /sdcard/video.mp4

8. 端口转发与反向代理

8.1 正向端口转发

将电脑端口转发到设备端口：

# 电脑 8080 -> 设备 80
adb forward tcp:8080 tcp:80

# 查看转发列表
adb forward --list

# 删除转发
adb forward --remove tcp:8080

# 删除所有转发
adb forward --remove-all

8.2 反向端口转发

将设备端口转发到电脑端口：

# 设备 8080 -> 电脑 3000
adb reverse tcp:8080 tcp:3000

# 查看反向代理列表
adb reverse --list

# 删除反向代理
adb reverse --remove tcp:8080

9. 备份与恢复

# 备份应用数据
adb backup -f backup.ab com.example.app

# 备份所有应用
adb backup -f all.ab -all

# 备份应用及其 APK
adb backup -f backup.ab -apk com.example.app

# 恢复数据
adb restore backup.ab

10. 设备控制

10.1 重启

# 普通重启
adb reboot

# 重启到 Recovery
adb reboot recovery

# 重启到 Bootloader/Fastboot
adb reboot bootloader

# 重启到 EDL 模式（部分设备）
adb reboot edl

10.2 输入操作

# 发送按键事件
adb shell input keyevent KEYCODE_HOME
adb shell input keyevent KEYCODE_BACK
adb shell input keyevent KEYCODE_MENU
adb shell input keyevent KEYCODE_POWER
adb shell input keyevent KEYCODE_VOLUME_UP
adb shell input keyevent KEYCODE_VOLUME_DOWN

# 常用键值
# 3: HOME
# 4: BACK
# 24: VOLUME_UP
# 25: VOLUME_DOWN
# 26: POWER
# 27: CAMERA

# 点击屏幕
adb shell input tap 500 500

# 滑动
adb shell input swipe 100 500 1000 500      # 水平滑动
adb shell input swipe 500 1000 500 100 500  # 垂直滑动，持续 500ms

# 输入文本
adb shell input text "hello"

# 长按
adb shell input swipe 500 500 500 500 1000  # 长按 1 秒

11. 网络调试

# 查看 IP 地址
adb shell ifconfig wlan0
adb shell ip addr show wlan0

# ping 测试
adb shell ping baidu.com

# 查看网络连接
adb shell netstat

# 查看 DNS
adb shell getprop net.dns1

12. 快速参考

┌─────────────────────────────────────────────────────┐
│                    ADB 常用命令                      │
├─────────────────────────────────────────────────────┤
│  设备管理                                            │
│  adb devices              列出设备                   │
│  adb -s <id> shell        指定设备                   │
│  adb connect IP:PORT      无线连接                   │
├─────────────────────────────────────────────────────┤
│  文件操作                                            │
│  adb push <local> <remote>  推送文件                 │
│  adb pull <remote> <local>  拉取文件                 │
├─────────────────────────────────────────────────────┤
│  应用管理                                            │
│  adb install app.apk      安装应用                   │
│  adb uninstall pkg        卸载应用                   │
│  adb shell pm clear pkg   清除数据                   │
│  adb shell am start -n pkg/.Activity  启动应用       │
├─────────────────────────────────────────────────────┤
│  日志调试                                            │
│  adb logcat               查看日志                   │
│  adb logcat -c            清除日志                   │
│  adb logcat *:E           只看错误                   │
├─────────────────────────────────────────────────────┤
│  截图录屏                                            │
│  adb exec-out screencap -p > ss.png  截图           │
│  adb shell screenrecord /sdcard/v.mp4  录屏         │
└─────────────────────────────────────────────────────┘

参考链接

Wireshark 使用备忘

Mon, 30 Mar 2026 10:00:00 +0800

Wireshark 使用备忘

Wireshark 是最流行的网络协议分析工具，用于捕获和分析网络流量。本文记录常用操作和过滤技巧。

1. 安装

1.1 Windows

# 使用 winget 安装
winget install Wireshark

# 或下载安装包
# https://www.wireshark.org/download.html

2. 基本操作

2.1 选择网卡

启动 Wireshark 后，在首页选择要监听的网卡：

本地回环：Loopback: lo0（捕获本机通信）
以太网：Ethernet 或 eth0
Wi-Fi：WLAN 或 wlan0

2.2 开始/停止抓包

开始：双击网卡或点击蓝色鲨鱼图标
停止：点击红色方块按钮 Ctrl+E
重新开始：点击绿色鲨鱼图标 Ctrl+R

2.3 保存抓包

# 保存为 pcapng 文件
文件 -> 保存 (Ctrl+S)

# 导出特定数据包
文件 -> 导出特定数据包

# 另存为 pcap 格式（兼容老版本）
文件 -> 另存为 -> 选择格式

3. 显示过滤器

3.1 协议过滤

tcp              # 只显示 TCP 流量
udp              # 只显示 UDP 流量
http             # 只显示 HTTP 流量
dns              # 只显示 DNS 流量
icmp             # 只显示 ICMP 流量（ping）
ssh              # 只显示 SSH 流量
tls || ssl       # 显示 TLS/SSL 流量

3.2 IP 地址过滤

ip.addr == 192.168.1.100      # 源或目的 IP
ip.src == 192.168.1.100       # 源 IP
ip.dst == 192.168.1.100       # 目的 IP
ip.addr == 192.168.1.0/24     # 网段过滤
!(ip.addr == 192.168.1.100)   # 排除某 IP

3.3 端口过滤

tcp.port == 80                # TCP 80 端口（源或目的）
tcp.srcport == 80             # TCP 源端口
tcp.dstport == 80             # TCP 目的端口
udp.port == 53                # UDP 53 端口（DNS）
tcp.port >= 8000 && tcp.port <= 9000  # 端口范围

3.4 组合过滤

# 与
ip.addr == 192.168.1.100 && tcp.port == 80

# 或
tcp.port == 80 || tcp.port == 443

# 非
!(ip.addr == 192.168.1.100)

# 复杂组合
(ip.addr == 192.168.1.100 && tcp.port == 80) || (ip.addr == 192.168.1.200 && tcp.port == 443)

3.5 HTTP 相关

http                          # 所有 HTTP 流量
http.request.method == "GET"  # GET 请求
http.request.method == "POST" # POST 请求
http.request.uri contains "api"  # URL 包含 api
http.response.code == 200     # 响应码 200
http.response.code == 404     # 响应码 404
http.host contains "baidu"    # Host 包含 baidu

3.6 TCP 相关

tcp.flags.syn == 1            # SYN 包
tcp.flags.ack == 1            # ACK 包
tcp.flags.fin == 1            # FIN 包
tcp.flags.reset == 1          # RST 包
tcp.analysis.retransmission   # 重传包
tcp.analysis.duplicate_ack    # 重复 ACK
tcp.analysis.zero_window      # 零窗口

3.7 DNS 相关

dns                           # 所有 DNS 流量
dns.qry.name == "baidu.com"   # 查询指定域名
dns.qry.name contains "baidu" # 查询域名包含 baidu
dns.flags.response == 1       # DNS 响应
dns.flags.response == 0       # DNS 请求
dns.a                         # A 记录查询
dns.aaaa                      # AAAA 记录查询

4. 抓包过滤器

在开始抓包前设置，减少捕获的数据量：

# 语法
host 192.168.1.100            # 指定主机
net 192.168.1.0/24            # 指定网段
port 80                        # 指定端口
src host 192.168.1.100        # 源主机
dst host 192.168.1.100        # 目的主机

# 组合
host 192.168.1.100 && port 80
tcp port 80 || tcp port 443
!(port 22)                     # 排除 SSH

5. 实用功能

5.1 追踪 TCP 流

右键点击数据包 → 追踪流 → TCP 流

可以看到完整的请求和响应内容，适合分析 HTTP 通信。

5.2 导出对象

1
2

文件 -> 导出对象 -> HTTP
# 可以导出图片、文件等

5.3 统计分析

统计 -> 捕获文件属性    # 文件概况
统计 -> 协议分级        # 协议分布
统计 -> 端点           # 通信端点统计
统计 -> 对话           # 通信对话统计
统计 -> I/O 图表       # 流量图表

5.4 搜索数据包

Ctrl+F 打开搜索：

显示过滤器：使用过滤语法
十六进制值：搜索十六进制
字符串：搜索文本内容
正则表达式：正则匹配

5.5 标记数据包

1
2
3

右键 -> 标记/取消标记 (Ctrl+M)
标记的数据包会高亮显示
导出时可选择只导出标记的包

6. 常用分析场景

6.1 分析 HTTP 请求

# 过滤器
http.request

# 查看请求详情
点击数据包 -> 展开 Hypertext Transfer Protocol

# 追踪完整请求响应
右键 -> 追踪流 -> TCP 流

6.2 分析 TCP 三次握手

# 过滤器
ip.addr == 目标IP && tcp.flags.syn == 1 || tcp.flags.ack == 1

# 顺序
# 1. SYN (Client -> Server)
# 2. SYN,  ACK (Server -> Client)
# 3. ACK (Client -> Server)

6.3 分析网络延迟

# 查看 TCP 握手时间
tcp.flags.syn == 1 || tcp.flags.ack == 1

# 查看 TCP 重传
tcp.analysis.retransmission

# 查看 RTT
统计 -> TCP 流图形 -> 时间序列(Stevens)

6.4 排查 DNS 问题

# 查看 DNS 查询和响应
dns

# 查看响应时间
dns.time

# 查看失败的查询
dns.flags.rcode != 0

6.5 分析 HTTPS

# 解密 HTTPS 流量（需要浏览器导出密钥）
# 设置环境变量
export SSLKEYLOGFILE=/path/to/keylog.txt

# Wireshark 配置
编辑 -> 首选项 -> Protocols -> TLS -> (Pre)-Master-Secret log filename

# 过滤
tls || ssl

7. 命令行工具

7.1 tshark

Wireshark 的命令行版本：

# 安装
sudo apt install tshark

# 抓包
tshark -i eth0                  # 抓取 eth0 接口
tshark -i eth0 -f "port 80"     # 抓取 80 端口

# 读取文件
tshark -r capture.pcap          # 读取文件
tshark -r capture.pcap -Y "http" # 过滤 HTTP

# 输出格式
tshark -r capture.pcap -T fields -e ip.src -e ip.dst -e frame.protocols

# 统计
tshark -r capture.pcap -q -z conv, tcp    # TCP 会话统计
tshark -r capture.pcap -q -z io, phs       # 协议层级统计

# 写入文件
tshark -i eth0 -w output.pcap -c 1000  # 抓 1000 个包

7.2 常用 tshark 命令

# 实时查看 HTTP 请求
tshark -i eth0 -Y "http.request" -T fields -e http.host -e http.request.uri

# 查看 DNS 查询
tshark -i eth0 -Y "dns.qry.name" -T fields -e dns.qry.name

# 统计流量 Top 10
tshark -r capture.pcap -T fields -e ip.src | sort | uniq -c | sort -nr | head -10

参考链接

Docker 常用命令备忘

Sun, 29 Mar 2026 13:00:00 +0800

Docker 常用命令备忘

Docker 日常使用中最常用的命令速查，包括镜像管理、容器操作、网络配置、数据卷等。

1. 镜像管理

镜像分层情况：

┌─────────────────┐
│ 胶片5: 启动命令  │  ← 最后一层：定义容器启动时执行什么
│ "CMD python app.py" │
├─────────────────┤
│ 胶片4: 安装依赖  │  ← 中间层：安装 Python 包
│ "pip install flask" │
├─────────────────┤
│ 胶片3: 拷贝代码  │  ← 中间层：把代码放进容器
│ "COPY . /app"     │
├─────────────────┤
│ 胶片2: 设置环境  │  ← 中间层：配置工作目录
│ "WORKDIR /app"    │
├─────────────────┤
│ 胶片1: 基础系统  │  ← 最底层：操作系统 + 基础工具
│ "FROM ubuntu:20.04" │
└─────────────────┘

1.1 查看镜像

1
2
3

docker images              # 查看本地镜像
docker images -a           # 包含中间层镜像
docker images --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}"

1.2 搜索镜像

1
2

docker search nginx
docker search --limit 5 nginx

1.3 拉取镜像

1
2
3

docker pull nginx          # 拉取最新版
docker pull nginx:1.24     # 拉取指定版本
docker pull registry.cn-hangzhou.aliyuncs.com/xxx/xxx  # 从私有仓库拉取

1.4 删除镜像

docker rmi nginx           # 删除镜像
docker rmi -f nginx        # 强制删除
docker rmi $(docker images -q)  # 删除所有镜像
docker image prune         # 删除悬空镜像
docker image prune -a      # 删除未使用的镜像

1.5 镜像导入导出

# 保存镜像为 tar 文件
docker save -o nginx.tar nginx:latest

# 从 tar 文件加载镜像
docker load -i nginx.tar

# 导出容器为镜像
docker commit container_name myimage:v1

2. 容器管理

2.1 创建并运行容器

# 基本运行
docker run nginx

# 常用参数
docker run -d \                     # 后台运行
  --name mynginx \                  # 指定名称
  -p 8080:80 \                      # 端口映射
  -v /host/path:/container/path \   # 挂载目录
  -e MY_VAR=value \                 # 环境变量
  --restart=always \                # 自动重启策略
  --gpus all \                      # 使用 GPU
  nginx:latest

# 示例
docker run -d --name nginx -p 80:80 nginx:latest
docker run -it --name ubuntu ubuntu:latest /bin/bash
docker run -d --name mysql -e MYSQL_ROOT_PASSWORD=123456 -p 3306:3306 mysql:8

2.2 查看容器

docker ps                  # 查看运行中的容器
docker ps -a               # 查看所有容器
docker ps -q               # 只显示 ID
docker ps -l               # 最近创建的容器
docker inspect <container>   # 查看容器详情
docker logs <container>      # 查看日志
docker logs -f <container>   # 实时查看日志
docker logs --tail 100 <container>  # 最后 100 行

2.3 容器操作

# 启动/停止/重启
docker start <container>
docker stop <container>
docker restart <container>

# 强制停止
docker kill <container>

# 暂停/恢复
docker pause <container>
docker unpause <container>

# 进入容器
docker exec -it <container> /bin/bash
docker exec -it <container> sh      # Alpine 等精简镜像

# 在容器中执行命令
docker exec <container> ls /app

# 查看资源使用
docker stats <container>
docker top <container>              # 查看进程

2.4 删除容器

docker rm <container>              # 删除已停止的容器
docker rm -f <container>           # 强制删除运行中的容器
docker rm $(docker ps -aq)       # 删除所有容器
docker <container> prune           # 删除所有已停止的容器

2.5 容器与宿主机复制文件

# 宿主机 -> 容器
docker cp /host/file.txt container:/path/file.txt

# 容器 -> 宿主机
docker cp container:/path/file.txt /host/file.txt

3. 数据卷

3.1 创建和管理

# 创建数据卷
docker volume create myvolume

# 查看数据卷
docker volume ls
docker volume inspect myvolume

# 删除数据卷
docker volume rm myvolume
docker volume prune           # 删除未使用的数据卷

3.2 使用数据卷

# 挂载数据卷
docker run -v myvolume:/data nginx

# 挂载宿主机目录
docker run -v /host/path:/container/path nginx

# 只读挂载
docker run -v /host/path:/container/path:ro nginx

4. 网络

4.1 网络管理

# 查看网络
docker network ls

# 创建网络
docker network create mynet
docker network create --driver bridge mynet
docker network create --subnet=192.168.1.0/24 mynet

# 删除网络
docker network rm mynet

# 连接容器到网络
docker network connect mynet <container>
docker network disconnect mynet <container>

4.2 使用网络

# 指定网络运行容器
docker run --network mynet nginx

# 使用 host 网络
docker run --network host nginx

# 指定 IP
docker run --network mynet --ip 192.168.1.10 nginx

5. Docker Compose

5.1 基本命令

docker compose 是 Docker 官方的多容器编排工具，使用 docker-compose.yml 文件定义服务、网络和数据卷，可以使用 -f 或 --file 参数指定路径。

# 启动服务
docker compose up -d

# 停止服务
docker compose down
docker compose down -v       # 同时删除数据卷

# 查看状态
docker compose ps
docker compose logs -f
docker compose logs -f nginx

# 重启服务
docker compose restart
docker compose restart nginx

# 进入容器
docker compose exec nginx /bin/bash

6. 系统清理

# 查看磁盘使用
docker system df

# 清理未使用的资源
docker system prune          # 清理悬空镜像、停止的容器、未使用的网络
docker system prune -a       # 同时清理未使用的镜像
docker system prune -a --volumes  # 同时清理数据卷

# 分别清理
docker container prune       # 清理停止的容器
docker image prune -a        # 清理未使用的镜像
docker volume prune          # 清理未使用的数据卷
docker network prune         # 清理未使用的网络

7. 镜像加速

7.1 配置镜像源

编辑 /etc/docker/daemon.json：

{
  "registry-mirrors": [
    "https://docker.1panel.live",  // 1Panel 公益源
    "https://pull.uhub.cn",     // UCloud 镜像
    "https://dhub.kubesre.xyz", // kubesre 镜像
    "https://registry.cn-hangzhou.aliyuncs.com" // 阿里云中国区镜像
  ]
}

重启 Docker：

1
2

sudo systemctl daemon-reload
sudo systemctl restart docker

8. GPU 支持

# 安装 nvidia-container-toolkit
# Ubuntu/Debian
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
  sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
  sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list

sudo apt update
sudo apt install -y nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

# 使用 GPU 运行容器
docker run --gpus all nvidia/cuda:11.8-base nvidia-smi
docker run --gpus '"device=0, 1"' nvidia/cuda:11.8-base nvidia-smi  # 指定 GPU
docker run --gpus 2 nvidia/cuda:11.8-base nvidia-smi               # 指定数量

参考链接

华为开发板常用命令备忘

Sun, 29 Mar 2026 13:00:00 +0800

华为开发板常用命令备忘

华为 Atlas/Ascend 系列开发板（如 Atlas 200 DK、Atlas 300I）基于昇腾 NPU，用于 AI 推理和边缘计算。本文记录常用命令。

1. NPU 设备管理

1.1 新用户

创建新用户并且复制ssh公钥，同时添加到HwHiAiUser分组中

sudo adduser huluhuluu
# sudo useradd -m huluhuluu
sudo usermod -aG HwHiAiUser, docker huluhuluu
sudo usermod -aG root, wheel huluhuluu # 添加sudo权限 慎重
passwd huluhuluu # 设置密码
sudo su huluhuluu
# 设置公钥
cd /home/huluhuluu
mkdir .ssh && cd .ssh
touch authorized_keys && vim authorized_keys

# 设置权限
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

1.2 查看 NPU 状态

# 查看 NPU 设备
npu-smi info
# 查看详细芯片信息
npu-smi info -t board -i 0  # 设备 0
# 查看设备映射信息
npu-smi info -m

# 实时监控
watch -n 1 npu-smi info

1.3 nputop

nputop是一个交互式命令行工具，专门用于监视和管理Ascend NPU上运行的进程, 但是依赖python环境

# 安装uv
wget -sL https://mirrors.ustc.edu.cn/github-release/astral-sh/uv/LatestRelease/uv-installer.sh | sh

# 通过uv安装nputop
# echo 'alias nputop="uvx --from ascend-nputop nputop"' >> ~/.zshrc # 每次临时使用
uv tool install ascend-nputop # 永久安装，更加建议

# 设置uv源为华为云镜像
echo 'export UV_INDEX_URL= https://repo.huaweicloud.com/repository/pypi/simple' >> ~/.zshrc
# ustc源: https://mirrors.ustc.edu.cn/pypi/simple
# 激活配置
source ~/.zshrc
# 运行 nputop：
nputop

1.4 重启 NPU 服务

# 重启驱动服务
sudo service dcgmi restart
# 或
sudo systemctl restart ascend-docker-proxy

# 查看服务状态
sudo systemctl status ascend-docker-proxy

1.5 启动docker

# export IMAGE=quay.io/ascend/vllm-ascend:v0.13.0-a3
export IMAGE=quay.io/ascend/vllm-ascend:v0.17.0rc1 # 这里的版本需要根据实际情况调整，建议使用最新版本
docker run --privileged \
    --name vllm-ascend-huluhulu \
    --shm-size=1g \
    --net=host \
    --device /dev/davinci0 \
    --device /dev/davinci1 \
    --device /dev/davinci2 \
    --device /dev/davinci3 \
    --device /dev/davinci4 \
    --device /dev/davinci5 \
    --device /dev/davinci6 \
    --device /dev/davinci7 \
    --device /dev/davinci_manager \
    --device /dev/devmm_svm \
    --device /dev/hisi_hdc \
    -v /usr/local/dcmi:/usr/local/dcmi \
    -v /usr/local/Ascend/driver/tools/hccn_tool:/usr/local/Ascend/driver/tools/hccn_tool \
    -v /usr/local/sbin/npu-smi:/usr/local/sbin/npu-smi \
    -v /usr/local/Ascend/driver/lib64/:/usr/local/Ascend/driver/lib64/ \
    -v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info \
    -v /etc/ascend_install.info:/etc/ascend_install.info \
    -v /root/.cache:/root/.cache \
    -it $IMAGE bash -c "source /usr/local/Ascend/ascend-toolkit/set_env.sh && source /usr/local/Ascend/nnal/atb/set_env.sh && /bin/bash"

2. 安装常用包

# 换apt源
# sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup # 备份

# 写入配置（注意：必须用 sudo sh -c 包裹整个重定向）
sh -c 'echo "deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy main restricted universe multiverse
deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-updates main restricted universe multiverse
deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-backports main restricted universe multiverse
deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-security main restricted universe multiverse" > /etc/apt/sources.list'
# 更新软件包列表
apt-get update

# 安装常用工具
apt-get install sudo zsh gzip netcat pv tmux htop lsof aria2 pigz git-lfs -y

# 配置 zsh
git clone https://gitee.com/mirror-hub/ohmyzsh.git ~/.oh-my-zsh
# 插件
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
git clone https://gitee.com/mirror-hub/zsh-syntax-highlighting.git ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
git clone https://gitee.com/mirror-hub/zsh-autosuggestions.git ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions
# 启用插件
echo "autoload -U compinit && compinit" >> ~/.zshrc
sed -i '/^plugins=/c\plugins=(git sudo z zsh-syntax-highlighting zsh-autosuggestions)' ~/.zshrc
# 自动切换zsh
touch ~/.bash_profile
changeshell="exec $(which zsh) -l"
echo "$changeshell" >> ~/.bash_profile

# 切换到zsh
exec zsh -l

2.1 安装minifoge

# 下载aarch版安装脚本
wget https://mirror.nju.edu.cn/github-release/conda-forge/miniforge/LatestRelease/Miniforge3-Linux-aarch64.sh
# 安装和删除
bash Miniforge3-Linux-aarch64.sh -b
rm -rf Miniforge3-Linux-aarch64.sh
# 设置环境变量
echo 'source ~/miniforge3/etc/profile.d/conda.sh' >> ~/.zshrc # 这里的路径注意要匹配

# 可执行权限
chmod u+x ~/miniforge3/etc/profile.d/conda.sh
source ~/.zshrc # 使配置生效

# 初始化并且配置清华源
conda init zsh && source ~/.zshrc
# 配置ustc源
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/conda-forge/
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/bioconda/

参考链接

包管理器常用命令备忘

Sun, 29 Mar 2026 12:00:00 +0800

包管理器常用命令备忘

各平台常用包管理器的命令速查，包括 npm、apt、winget、brew 等。

1. 包管理器

1.1 npm

# 初始化项目
npm init                    # 交互式创建 package.json
npm init -y                 # 使用默认值创建

# 安装依赖
npm install                 # 安装 package.json 中的所有依赖
npm install package         # 安装到 dependencies
npm install package@1.2.3   # 安装指定版本
npm install -D package      # 安装到 devDependencies
npm install -g package      # 全局安装

# 卸载
npm uninstall package       # 卸载本地包
npm uninstall -g package    # 卸载全局包

# 更新
npm update                  # 更新所有依赖
npm update package          # 更新指定包
npm outdated                # 查看过时的包

# 查看
npm list                    # 查看已安装的包
npm list -g --depth=0       # 查看全局安装的包
npm view package            # 查看包信息
npm view package versions   # 查看包所有版本

# 运行脚本
npm run script-name         # 运行 package.json 中的脚本
npm start / npm test        # 运行 start/test 脚本

# 清理缓存
npm cache clean --force

# 检查安全问题
npm audit
npm audit fix

1.2 yarn

# 安装 yarn
npm install -g yarn

# 初始化
yarn init -y

# 安装依赖
yarn                        # 安装所有依赖
yarn add package            # 安装到 dependencies
yarn add -D package         # 安装到 devDependencies
yarn global add package     # 全局安装

# 卸载
yarn remove package
yarn global remove package

# 更新
yarn upgrade
yarn upgrade package

# 查看
yarn list
yarn info package

# 运行脚本
yarn script-name
yarn run script-name

1.3 apt (Debian/Ubuntu)

# 更新软件源
sudo apt update

# 升级已安装的包
sudo apt upgrade            # 升级所有包
sudo apt full-upgrade       # 完整升级（可删除包）
sudo apt install package    # 安装包
sudo apt install package=1.2.3  # 指定版本

# 卸载
sudo apt remove package     # 卸载但保留配置
sudo apt purge package      # 卸载并删除配置
sudo apt autoremove         # 清理不再需要的依赖

# 搜索和查看
apt search keyword
apt show package
apt list --installed
apt list --upgradable

# 清理缓存
sudo apt clean              # 清理下载的 deb 包
sudo apt autoclean          # 清理过期的 deb 包

# 添加 PPA
sudo add-apt-repository ppa:user/ppa-name
sudo apt update

1.4 winget

# 搜索
winget search vscode
winget search --id "Microsoft.VisualStudioCode"

# 安装
winget install Microsoft.VisualStudioCode
winget install --id "Microsoft.VisualStudioCode"
winget install -e --id "Microsoft.VisualStudioCode"  # 精确匹配

# 卸载
winget uninstall "Visual Studio Code"
winget uninstall --id "Microsoft.VisualStudioCode"

# 更新
winget upgrade              # 更新所有
winget upgrade --id "Microsoft.VisualStudioCode"

# 查看已安装
winget list
winget list --name "Visual"

# 导出/导入
winget export -o packages.json
winget import -i packages.json

1.5 scoop

# 安装 scoop
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# 安装包
scoop install git
scoop install nodejs
scoop install python

# 卸载
scoop uninstall git

# 更新
scoop update                # 更新 scoop 自身
scoop update *              # 更新所有包
scoop update git            # 更新指定包

# 搜索和查看
scoop search git
scoop list

# 清理旧版本
scoop cleanup *
scoop cache rm *

# 换源

Scoop 换源

Scoop 换源通常分两部分：

Scoop 自己的仓库地址
已添加 bucket 的 Git 远程地址

只改第 1 部分还不够，因为 main、extras 这些 bucket 本质上也是单独的 Git 仓库。

查看当前配置：

scoop config SCOOP_REPO
scoop bucket list
git -C "$HOME\scoop\apps\scoop\current" remote -v
git -C "$HOME\scoop\buckets\main" remote -v

切到 Gitee 镜像：

# 1. 修改 Scoop 自身仓库地址
scoop config SCOOP_REPO https://gitee.com/scoop-installer/scoop

# 2. 修改本地 Scoop 仓库的远程地址
git -C "$HOME\scoop\apps\scoop\current" remote set-url origin https://gitee.com/scoop-installer/scoop

# 3. 修改 main bucket 的远程地址
git -C "$HOME\scoop\buckets\main" remote set-url origin https://gitee.com/scoop-installer/Main

# 4. 更新
scoop update

如果还加过其他 bucket，例如 extras、versions，也要分别改：

1
2

git -C "$HOME\scoop\buckets\extras" remote set-url origin https://gitee.com/scoop-installer/Extras
git -C "$HOME\scoop\buckets\versions" remote set-url origin https://gitee.com/scoop-installer/Versions

切回官方 GitHub：

scoop config SCOOP_REPO https://github.com/ScoopInstaller/Scoop
git -C "$HOME\scoop\apps\scoop\current" remote set-url origin https://github.com/ScoopInstaller/Scoop
git -C "$HOME\scoop\buckets\main" remote set-url origin https://github.com/ScoopInstaller/Main
scoop update

如果 bucket 已经乱了，最直接的办法是删掉再重新添加：

1
2

scoop bucket rm main
scoop bucket add main https://gitee.com/scoop-installer/Main

常用 bucket 重新添加示例：

1
2

scoop bucket add extras https://gitee.com/scoop-installer/Extras
scoop bucket add versions https://gitee.com/scoop-installer/Versions

验证是否生效：

scoop config SCOOP_REPO
scoop bucket list
git -C "$HOME\scoop\apps\scoop\current" remote -v
git -C "$HOME\scoop\buckets\main" remote -v

本机当前示例：

scoop config SCOOP_REPO
# https://gitee.com/scoop-installer/scoop

git -C "$HOME\scoop\buckets\main" remote -v
# origin https://gitee.com/scoop-installer/Main

Codex CLI 第三方 API 配置备忘

Sun, 29 Mar 2026 11:00:00 +0800

Codex CLI 第三方 API 配置备忘

Codex CLI 是 OpenAI 官方推出的终端 AI Agent 工具，支持代码生成、文件操作等。本文记录如何配置第三方 api。

1. 安装

# 1. 依赖 Node.js 安装 下面使用 nvm 安装 nodejs
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash # 如果没有nvm
# 激活nvm
echo '
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
source ~/.zshrc
nvm --version # 验证nvm
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node # 设置镜像源
# 如果nodejs版本过低，可以使用nvm安装最新版本的nodejs
nvm install 20 # 安装nodejs 20版本

# 2. 使用 npm 安装
npm install -g @openai/codex

# 验证安装
codex --version
# codex-cli 0.117.0 # 输出版本 安装成功

2. cc-switch 配置第三方 API

2.1 安装 cc-switch

windows cli版本安装演示如下，release 界面获取复制对应的下载版本连接，参考下面内容：

# 1. 创建临时目录并下载最新版
$downloadUrl = "https://github.com/SaladDay/cc-switch-cli/releases/latest/download/cc-switch-cli-windows-x64.zip"
$zipPath = "$env:TEMP\cc-switch-cli.zip"
$extractPath = "$env:TEMP\cc-switch-extract"
Invoke-WebRequest -Uri $downloadUrl -OutFile $zipPath

# 2. 解压
Expand-Archive -Path $zipPath -DestinationPath $extractPath -Force

# 3. 移动到用户 PATH 目录（无需管理员权限）
$binPath = "$env:LOCALAPPDATA\Microsoft\WindowsApps"
if (!(Test-Path $binPath)) { New-Item -ItemType Directory -Path $binPath -Force }
Copy-Item "$extractPath\cc-switch.exe" -Destination $binPath -Force

# 4. 验证安装
cc-switch --version
# cc-switch 5.2.1 # 输出版本 安装成功

Linux CLI 版本，下面具体获取的包需要在 release 界面获取，优先获取 musl 静态编译版。

# 1. 直接脚本安装方式
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash

# 2. 下载解压方式
curl -LO https://github.com/SaladDay/cc-switch-cli/releases/download/v4.5.0/cc-switch-cli-v4.5.0-linux-x64-musl.tar.gz

tar -xzf cc-switch-cli-*.tar.gz # 解压
rm cc-switch-cli-*.tar.gz # 删除压缩包
chmod +x cc-switch # 执行权限
sudo mv cc-switch /usr/local/bin/ # 放到系统路径

2.2 设置 API Key

参考文档 (有中文版)，输入对应的模型提供商、URL、模型 ID、接口令牌等信息。部分自己搭建的第三方api的base_url需要加/v1，不然请求可能会自动路由到/login的返回界面

➜  cc-switch --app codex provider add # 添加新供应商 这里需指定app为codex
Add New Provider
==================================================
> Select provider type: Add Third-Party Provider
> Provider Name: example
> Website URL (opt.):
Generated ID: example

Configure Codex Provider:
> OpenAI API Key: sk-abababababababababababababab
> Base URL: http://example.com/v1 # 注意这里部分自建站点需要加/v1 同时注意这里的协议
> Model: gpt-5.3-codex
> Configure optional fields (notes,  sort index)? No

=== Provider Configuration Summary ===
ID: example
Provider Name:: example

Core Configuration:
  API Key: sk-b...ecdf
  Config (TOML): 10 lines
======================
>
Confirm create this provider? Yes

✓ Successfully added provider 'example' 

# 再查看就有了
➜  cc-switch provider list --app codex # 同样指定codex                                    
┌───┬──────────┬──────────┬────────────────────────────────────┐
│   ┆ ID       ┆ Name     ┆ API URL                            │
╞═══╪══════════╪══════════╪════════════════════════════════════╡
│ ✓ ┆ example  ┆ example  ┆ http://example.com/v1              │
└───┴──────────┴──────────┴────────────────────────────────────┘

ℹ Application: codex
→ Current: example # 当前使用的 example

# 在打开 codex 就可以使用了
➜ codex

2.3 配置 Skill

Skill 包含如下结构，可以理解为高级提示词。参考tutorial: 官方文档、中文tutorial

skill-name/
├── SKILL.md          # Required: Skill instructions and metadata
├── scripts/          # Optional: Helper scripts
├── templates/        # Optional: Document templates
└── resources/        # Optional: Reference files

可以在开源仓库/社区获取 Skills，如：

把下载好的 Skill 放到 Codex CLI 的 skills 目录就可以在 Codex CLI 中通过/skills命令启用：

下面以 matplotlib 为例，右边有 install 命令：

`1`	`➜ npx skills add https://github.com/davila7/claude-code-templates --skill matplotlib`

安装完成后可以导入cc-switch中统一管理：

# 扫描未管理的技能
➜ cc-switch skills scan-unmanaged  --app codex 
┌─────────────┬──────────┬─────────────┐
│ Directory   ┆ Found In ┆ Name        │
╞═════════════╪══════════╪═════════════╡
│ find-skills ┆ agents   ┆ find-skills │
├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ matplotlib  ┆ agents   ┆ matplotlib  │
└─────────────┴──────────┴─────────────┘

# 导入到cc-switch中统一管理
➜ cc-switch skills import-from-apps find-skills
✓ Imported 1 skill(s) into SSOT
➜ cc-switch skills import-from-apps matplotlib
✓ Imported 1 skill(s) into SSOT

# 查看已导入的技能
➜ cc-switch skills list            
┌─────────────┬─────────────┬────────┬───────┬────────┬──────────┐
│ Directory   ┆ Name        ┆ Claude ┆ Codex ┆ Gemini ┆ OpenCode │
╞═════════════╪═════════════╪════════╪═══════╪════════╪══════════╡
│ find-skills ┆ find-skills ┆        ┆       ┆        ┆          │
├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
│ matplotlib  ┆ matplotlib  ┆        ┆       ┆        ┆          │
└─────────────┴─────────────┴────────┴───────┴────────┴──────────┘

# 通过cc-switch启用技能
➜ cc-switch skills enable matplotlib --app codex
✓ Enabled 'matplotlib' for codex
➜ cc-switch skills enable find-skills --app codex
✓ Enabled 'find-skills' for codex
➜ cc-switch skills list 
┌─────────────┬─────────────┬────────┬───────┬────────┬──────────┐
│ Directory   ┆ Name        ┆ Claude ┆ Codex ┆ Gemini ┆ OpenCode │
╞═════════════╪═════════════╪════════╪═══════╪════════╪══════════╡
│ find-skills ┆ find-skills ┆        ┆ ✓     ┆        ┆          │
├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
│ matplotlib  ┆ matplotlib  ┆        ┆ ✓     ┆        ┆          │
└─────────────┴─────────────┴────────┴───────┴────────┴──────────┘

3 Codex 使用

1
2

# 启动交互模式
codex

第一次启动需要选择运行模式，建议使用沙盒模式Set up default sandbox，隔离环境更安全。

3.1 基本使用

# 启动交互模式
codex

# 指定模型
codex --model gpt-4o

# 执行单条命令
codex "创建一个 Python 脚本读取 JSON 文件"

# 非交互模式（自动执行）
codex --full-auto "帮我重构这个函数"

3.2 常用命令

/resume     # 恢复上次会话
/ps         # 查看后台terminal
/stop       # 停止后台terminal
/approvals  # 授权
/skills     # 管理技能
/models     # 切换模型 这里可以调整思考模式 例如high extrahigh
/statusline # 状态底栏的显示 空格选中 enter保存 esc取消
# `Alt + V` windows 图片粘贴到 Codex CLI

4. rtk

rtk 在命令输出进入上下文窗口之前对其进行压缩。更好的推理。更长的会话。更低的成本。

4.1 Linux

rtk 的 shell hook 能自动把常见命令重写成 rtk ...，并根据结果压缩上下文。

# 快速安装
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

# 初始化 Codex
rtk init -g --codex

# 重启 codex 后测试
rtk --version
rtk gain

4.2 Windows 原生 PowerShell

Windows 原生也能用 rtk，需要下载解压预编译包rtk-x86_64-pc-windows-msvc.zip,

对 Codex 的集成方式是 rtk init -g --codex
Codex 这一项的官方集成方式是 AGENTS.md + RTK.md instructions

也就是说，对 Codex 而言，核心是给 Codex 注入使用 rtk 的规则，而不是依赖 bash hook。

安装步骤：

# 1. 下载 release 里的 Windows 压缩包
# https://github.com/rtk-ai/rtk/releases

# 2. 解压后把 rtk.exe 放进 PATH
# 例如：C:\Users\xxx\.local\bin

# 3. 验证
rtk --version

# 4. 初始化 Codex
rtk init -g --codex

# 5. 重启 Codex 后查看统计
rtk gain

4.3 常用命令

# rtk 包装命令
rtk git status
rtk git diff
rtk find . -n '*.md'
rtk grep 'pattern' .
rtk read README.md
# 查看rtk压缩收益
rtk gain

更多命令与支持矩阵见：rtk仓库

5. 避免命令污染

5.1 Linux(zsh)

codex 执行命令也会记录在 zsh 历史中，污染平时使用的shell命令。Linux 下可以把 codex 执行的命令单独写到隔离的 HISTFILE，再按需清理旧历史, 整理脚本如下：

git clone https://github.com/huluhuluu/useful-sh.git
./sh/codex-zsh-history-isolation/codex-zsh-history-isolation.sh # 设置修改codex命令隔离

# 可选 清理部分历史命令
./sh/zsh-history-prune/zsh-history-prune.sh
./sh/zsh-history-prune/zsh-history-prune.sh --apply

原理：

修改 ~/.codex/config.toml
把 shell 历史写到独立 HISTFILE
创建最小化 ZDOTDIR
控制 Codex 自己的 [history].persistence

参考链接

PowerShell 7 迁移备忘

Sun, 29 Mar 2026 10:00:00 +0800

PowerShell 7 迁移备忘

PowerShell 7 (pwsh) 是 PowerShell 的跨平台版本，相比 Windows PowerShell 5.1 有更好的性能、新特性和跨平台支持，并且支持更多功能。如命令补全等，本文记录迁移过程。

1. 安装

# 使用 winget 安装
winget install Microsoft.PowerShell --source winget

# 或使用 MSI 安装包 注意这里要下载64位版本
# 下载地址: https://github.com/PowerShell/PowerShell/releases

# 验证安装，打开pwsh7终端输入命令
pwsh -Version
# PowerShell 7.6.0

1.1 与 Windows PowerShell 共存

PowerShell 7 与 Windows PowerShell 5.1 可以共存：

命令	版本
`powershell`	Windows PowerShell 5.1
`pwsh`	PowerShell 7.x

其配置文件路径不同，迁移可以参考官方指南。

# 查看当前配置文件路径
$PROFILE

# 查看所有配置文件路径
$PROFILE | Format-List -Force

1.2 设置为默认终端

打开pwsh7终端，点击设置，将pwsh7设置为默认终端，并且保存。在这个设置中可以对 PowerShell 7 的外观、字体、配色方案等进行个性化配置。

1.3 VSCode

在 VSCode 中通过Ctrl+Shift+P打开命令面板, 搜索并进入Preferences: Open User Settings (JSON)，在 settings.json 中查找配置，需要为terminal.integrated.profiles.windows添加PowerShell 7的路径配置，通常情况路径是 "C:\\Program Files\\PowerShell\\7\\pwsh.exe", 可以用where.exe pwsh命令查找：另外把默认终端设置为PowerShell 7，保存后即可。

    "terminal.integrated.profiles.windows": {
        "PowerShell 7": {   // 配置 PowerShell 7 终端路径
            "path": "C:\\Program Files\\PowerShell\\7\\pwsh.exe", 
        },  
    }
    "terminal.integrated.defaultProfile.windows": "PowerShell 7" // 设置默认终端

2. 常用 Windows 命令

2.1 文件操作

# 查看文件/目录
Get-ChildItem          # 别名: ls,  dir
Get-ChildItem -Force   # 显示隐藏文件
Get-ChildItem -Recurse # 递归查看

# 查看文件内容
Get-Content file.txt   # 别名: cat,  type
Get-Content file.txt -Head 10  # 前 10 行
Get-Content file.txt -Tail 10  # 后 10 行

# 复制/移动/删除
Copy-Item src dst      # 别名: cp,  copy
Move-Item src dst      # 别名: mv,  move
Remove-Item path       # 别名: rm,  del
Remove-Item -Recurse -Force dir  # 强制删除目录

# 创建
New-Item -ItemType File -Name "file.txt"
New-Item -ItemType Directory -Name "newdir"  # 别名: mkdir

2.2 进程管理

# 查看进程
Get-Process            # 别名: ps
Get-Process | Sort-Object CPU -Descending | Select-Object -First 10

# 查找进程
Get-Process -Name "chrome"

# 杀进程
Stop-Process -Id 1234
Stop-Process -Name "chrome"
Get-Process "node" | Stop-Process

2.3 服务管理

# 查看服务
Get-Service
Get-Service -Name "mysql*"

# 启动/停止/重启
Start-Service -Name "mysql"
Stop-Service -Name "mysql"
Restart-Service -Name "mysql"

# 设置启动类型
Set-Service -Name "mysql" -StartupType Automatic

2.4 网络相关

# 查看网络配置
Get-NetIPConfiguration
Get-NetIPAddress

# 查看端口占用
Get-NetTCPConnection -LocalPort 8080
Get-Process -Id (Get-NetTCPConnection -LocalPort 8080).OwningProcess

# 测试网络
Test-NetConnection baidu.com
Test-NetConnection -ComputerName baidu.com -Port 443

# DNS 解析
Resolve-DnsName baidu.com

2.5 系统信息

# 系统信息
Get-ComputerInfo
$PSVersionTable        # PowerShell 版本

# 磁盘空间
Get-PSDrive -PSProvider FileSystem
Get-Volume

# 环境变量
$env:PATH
$env:JAVA_HOME
[Environment]::GetEnvironmentVariable("PATH",  "User")

# 设置环境变量
$env:MY_VAR = "value"
[Environment]::SetEnvironmentVariable("MY_VAR",  "value",  "User")

2.6 压缩解压

# 压缩
Compress-Archive -Path "folder" -DestinationPath "archive.zip"

# 解压
Expand-Archive -Path "archive.zip" -DestinationPath "output"

2.7 实用技巧

# 查找文件
Get-ChildItem -Recurse -Filter "*.py" | Select-Object FullName

# 搜索文件内容
Select-String -Path "*.py" -Pattern "import"

# 剪贴板
Set-Clipboard "复制内容"   # 别名: scb
Get-Clipboard             # 别名: gcb

# 执行命令并获取输出
Invoke-Expression "echo hello"
Invoke-WebRequest "https://example.com"  # 别名: curl,  wget

3. 参考链接

Vim 常用命令备忘

Sat, 28 Mar 2026 13:00:00 +0800

Vim 常用命令备忘

Vim 日常开发中最常用的命令速查，包括模式切换、移动、编辑、搜索、窗口管理等。

1. 模式切换

命令	说明
`i`	在光标前插入
`I`	在行首插入
`a`	在光标后插入
`A`	在行尾插入
`o`	在下方新建一行并插入
`O`	在上方新建一行并插入
`v`	进入可视模式（字符选择）
`V`	进入可视模式（行选择）
`Ctrl-V`	进入可视模式（块选择）
`Esc` / `Ctrl-[`	退出当前模式
`:`	进入命令模式

2. 光标移动

2.1 基本移动

命令	说明
`h` / `j` / `k` / `l`	左 / 下 / 上 / 右
`w`	移动到下一个单词开头
`W`	移动到下一个空格分隔的单词
`b`	移动到上一个单词开头
`B`	移动到上一个空格分隔的单词
`e`	移动到当前单词末尾
`E`	移动到空格分隔的单词末尾

2.2 行内移动

命令	说明
`0`	移动到行首
`^`	移动到行首第一个非空字符
`$`	移动到行尾
`f{char}`	向后查找字符并跳转
`F{char}`	向前查找字符并跳转
`t{char}`	向后查找字符并停在其前
`T{char}`	向前查找字符并停在其后
`;`	重复上次 f/F/t/T
`,`	反向重复上次 f/F/t/T

2.3 文件内移动

命令	说明
`gg`	移动到文件开头
`G`	移动到文件末尾
`{n}G`	跳转到第 n 行
`{`	跳转到上一段落
`}`	跳转到下一段落
`%`	跳转到匹配的括号
`Ctrl-O`	跳转到上一个位置
`Ctrl-I`	跳转到下一个位置
`gd`	跳转到局部定义
`gD`	跳转到全局定义
`:N`	跳转到第 N 行

3. 编辑操作

3.1 删除

命令	说明
`x`	删除当前字符
`X`	删除前一个字符
`dw`	删除一个单词
`d$` / `D`	删除到行尾
`d0`	删除到行首
`dd`	删除整行
`{n}dd`	删除 n 行
`d{motion}`	删除到 motion 指定位置
`dG`	删除到文件末尾
`dgg`	删除到文件开头

3.2 复制与粘贴

命令	说明
`yy`	复制整行
`{n}yy`	复制 n 行
`yw`	复制一个单词
`y$`	复制到行尾
`y{motion}`	复制到 motion 指定位置
`p`	在光标后粘贴
`P`	在光标前粘贴
`"{reg}p`	粘贴指定寄存器内容

3.3 修改

命令	说明
`r{char}`	替换当前字符
`R`	进入替换模式
`cw`	修改单词
`c$` / `C`	修改到行尾
`cc`	修改整行
`s`	删除字符并进入插入模式
`S`	删除整行并进入插入模式

3.4 其他编辑

命令	说明
`u`	撤销
`Ctrl-R`	重做
`.`	重复上次操作
`J`	合并当前行和下一行
`>>`	增加缩进
`<<`	减少缩进
`==`	自动缩进
`gg=G`	全文自动缩进
`gu{motion}`	转为小写
`gU{motion}`	转为大写

4. 搜索与替换

4.1 搜索

命令	说明
`/pattern`	向下搜索
`?pattern`	向上搜索
`n`	下一个匹配
`N`	上一个匹配
`*`	搜索光标下的单词（向下）
`#`	搜索光标下的单词（向上）
`:noh`	取消搜索高亮

4.2 替换

" 基本格式
:s/old/new/      " 替换当前行第一个
:s/old/new/g     " 替换当前行所有
:s/old/new/gc    " 替换当前行所有（确认）
:%s/old/new/g    " 全文替换
:%s/old/new/gc   " 全文替换（确认）
:n, m s/old/new/g " 第 n 到 m 行替换

标志	说明
`g`	替换所有匹配
`c`	每次替换前确认
`i`	忽略大小写
`I`	区分大小写

5. 可视模式

命令	说明
`v`	字符选择
`V`	行选择
`Ctrl-V`	块选择
`o`	移动光标到选择区域另一端
`gv`	重新选择上次选中的区域

6. 文件操作

命令	说明
`:w`	保存
`:w file`	另存为
`:q`	退出
`:q!`	强制退出（不保存）
`:wq` / `:x` / `ZZ`	保存并退出
`:e file`	打开文件
`:e!`	放弃修改重新加载
`:r file`	读入文件内容到当前位置
`:saveas file`	另存为并切换到新文件

7. 折叠

命令	说明
`zf{motion}`	创建折叠
`zd`	删除折叠
`zo`	打开折叠
`zc`	关闭折叠
`za`	切换折叠状态
`zR`	打开所有折叠
`zM`	关闭所有折叠
`zE`	删除所有折叠

8. 常用配置

" ~/.vimrc 基础配置
set number           " 显示行号
set relativenumber   " 相对行号
set tabstop=4        " Tab 宽度
set shiftwidth=4     " 缩进宽度
set expandtab        " Tab 转空格
set autoindent       " 自动缩进
set cursorline       " 高亮当前行
set wrap             " 自动换行
set showcmd          " 显示命令
set wildmenu         " 命令补全菜单
set hlsearch         " 搜索高亮
set incsearch        " 增量搜索
set ignorecase       " 搜索忽略大小写
set smartcase        " 智能大小写
set termguicolors    " 真彩色支持
syntax on            " 语法高亮

参考链接

Vim 官方文档
Vim Adventures - 游戏学习 Vim
Vim Cheat Sheet
Neovim - Vim 的现代分支

FZF 使用备忘

Sat, 28 Mar 2026 12:30:00 +0800

FZF 使用备忘

FZF 是一个通用的命令行模糊搜索工具，可以与多种工具配合使用，例如CRTL+R搜索历史命令、快速打开文件等。用 Go 编写，速度非常快，tutorial与效果演示参考。

1. 安装

# 克隆仓库
git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
# 运行安装脚本
~/.fzf/install

1.1 配置zsh

# 在 ~/.zshrc 的插件中中添加 fzf，例如下面， 这里的插件使用空格分隔
plugins=(git sudo z zsh-syntax-highlighting zsh-autosuggestions fzf)

# 过程
vim ~/.zshrc
/plugins= # 命令模式直接输入前面字符串 然后回车 表示搜索这个命令
# 在末尾添加 fzf
# 保存退出 (:wq)
source ~/.zshrc # 使配置生效

2. 基本使用

2.1 文件搜索

# 搜索当前目录文件
fzf

# 搜索并打开文件
vim $(fzf)

2.2 历史命令搜索

按 Ctrl-R 搜索历史命令，输入关键字实时过滤

2.3 模糊搜索

在shell中，输入**再按tab可以进入fzf的模糊搜索模式，输入关键字后按回车即可跳转到对应目录。

2.4 子目录直达

Alt+C 可以进入fzf的子目录搜索模式，输入关键字后按回车即可跳转到对应目录。

3. 高级用法

3.1 搜索语法

在 fzf 搜索框中可以使用特殊语法：

abc          # 包含 abc
^abc         # 以 abc 开头
abc$         # 以 abc 结尾
!abc         # 不包含 abc
abc def      # 同时包含 abc 和 def
abc|def      # 包含 abc 或 def
'abc         # 精确匹配 abc（非模糊）
!^abc        # 不以 abc 开头

3.2 多选模式

1
2

# 多选文件（Tab 选择，Shift-Tab 取消）
fzf --multi

4. Windows Pwsh 配置

如果 fzf 是通过 scoop install fzf 安装的，一般已经在 PATH 中，可以先验证：

`1`	`Get-Command fzf.exe`

PowerShell 中的快捷键绑定不是 fzf 自带的，可以搭配 PSFzf 模块绑定：PSFzf 负责把 fzf 接到 PSReadLine 上，这样就能在 pwsh 里使用 Ctrl+R、Ctrl+T、Alt+C 这些快捷键。

4.1 安装fzf

`1`	`scoop install fzf`

4.2 安装 PSFzf

常规安装方式:

`1`	`Install-Module PSFzf -Scope CurrentUser`

如果 PowerShell Gallery 因为证书链问题无法安装，也可以手动把模块解压到用户模块目录：

$pkg = Join-Path $env:TEMP 'psfzf.2.7.10.nupkg'
curl.exe -L -k 'https://cdn.powershellgallery.com/packages/psfzf.2.7.10.nupkg' -o $pkg

$moduleDir = "$HOME\\Documents\\PowerShell\\Modules\\PSFzf\\2.7.10"
New-Item -ItemType Directory -Force -Path $moduleDir
Add-Type -AssemblyName System.IO.Compression.FileSystem
[IO.Compression.ZipFile]::ExtractToDirectory($pkg, $moduleDir)

4.2 写入 PowerShell Profile

PowerShell 7 的 profile 路径一般是：

# 可以通过 $PROFILE 变量查看当前 profile 路径
$PROFILE
# 例如：
C:\Users\xxx\Documents\PowerShell\Microsoft.PowerShell_profile.ps1

向 profile 中加入下面配置，不需要每次启动pwsh都手动执行：

Import-Module PSReadLine -ErrorAction SilentlyContinue

if (Get-Command fzf.exe -ErrorAction SilentlyContinue) {
    Import-Module PSFzf -ErrorAction SilentlyContinue

    if (Get-Command Set-PsFzfOption -ErrorAction SilentlyContinue) {
        Set-PsFzfOption `
            -PSReadlineChordProvider 'Ctrl+t' `
            -PSReadlineChordReverseHistory 'Ctrl+r' `
            -PSReadlineChordSetLocation 'Alt+c' `
            -TabExpansion
    }
}

配置写完后重新加载：

`1`	`. $PROFILE`

4.3 快捷键说明

Ctrl+T：在当前目录或当前输入路径下启动 fzf，选择文件或路径并插入到命令行
Ctrl+R：模糊搜索 PowerShell 历史命令，选中后回填到当前命令行
Alt+C：模糊搜索子目录并直接切换到该目录
Tab：启用 fzf 风格补全；输入路径片段或 ** 后按 Tab 可以进入选择界面

4.4 使用示例

# 先输入一部分路径，再按 Ctrl+T 补全
code .\cont

# 按 Ctrl+R 搜索历史命令
git

# 按 Alt+C 模糊切换目录
cd

4.5 检查是否生效

Get-Module PSFzf
Get-PSReadLineKeyHandler | Where-Object {
    $_.Key -in 'Ctrl+t', 'Ctrl+r', 'Alt+c', 'Tab'
}

参考链接

Zoxide 使用备忘

Sat, 28 Mar 2026 12:00:00 +0800

Zoxide 使用备忘

Zoxide 是一个更智能的 cd 命令，它会记住你经常访问的目录，让你可以用简短的别名快速跳转。用 Rust 编写，速度快于zsh z插件。

1. 安装

1
2

# Ubuntu/Debian
sudo apt install zoxide -y

2. 配置

在 shell 配置文件中添加初始化命令：

# 添加 zoxide 初始化命令到 ~/.zshrc
echo 'eval "$(zoxide init zsh)"' >> ~/.zshrc
# 从zshrc 配置文件中移除z插件
# 移除前
plugins=(git sudo z zsh-syntax-highlighting zsh-autosuggestions fzf)
# 移除后
plugins=(git sudo zsh-syntax-highlighting zsh-autosuggestions fzf)

# 具体操作
vim ~/.zshrc
/plugins= # 命令模式直接输入前面字符串 然后回车 表示搜索这个命令
# 进入编辑模式删除z插件
# 保存退出 (:wq)
source ~/.zshrc # 使配置生效

2.1 Windows Pwsh 配置

使用 scoop 安装：

1
2

scoop install zoxide
Get-Command zoxide

PowerShell 中需要执行初始化脚本，最常见的写法是：

`1`	`Invoke-Expression (& { (zoxide init powershell \| Out-String) })`

如果只想当前会话临时生效，直接在当前 pwsh 执行上面这一行即可。

如果想每次启动 pwsh 自动生效，把它写进 $PROFILE：

1
2
3

if (Get-Command zoxide.exe -ErrorAction SilentlyContinue) {
    Invoke-Expression (& { (zoxide init powershell | Out-String) })
}

例如本机的 PowerShell 7 profile 路径：

1
2

$PROFILE
# C:\Users\xxx\Documents\PowerShell\Microsoft.PowerShell_profile.ps1

写完后重新加载：

`1`	`. $PROFILE`

3. 基本使用

3.1 项目快速跳转

# 第一次访问
cd ~/work/blog/HugoBlog

# 之后只需
z hugo        # 跳转到 HugoBlog
z blog        # 跳转到 blog 相关目录
z hu blog     # 多关键字精确匹配

3.2 可视化

通过zi命令可以列出匹配的目录，上下选择进行跳转：

`1`	`zi path # 列出匹配路径，选择跳转`

在 pwsh 中常见用法：

1
2
3

z blog        # 跳到最匹配的目录
z hugo blog   # 多关键字匹配
zi blog       # 交互式选择目录

如果已经配置了 fzf，zi 的交互体验会更好，适合在大量项目目录之间快速切换。

3.3 管理数据库

# 添加目录到数据库
zoxide add /path/to/dir

# 从数据库移除目录
zoxide remove /path/to/dir

# 查看数据库中的目录
zoxide query -l

# 查看数据库路径
zoxide query -l --exclude .

# 清空数据库
zoxide query --purge

在 Windows 下，数据库默认一般位于：

`1`	`$env:LOCALAPPDATA\zoxide`

3.4 工作原理

Zoxide 会记录每个目录的访问频率和最近访问时间，计算出一个"分数"：

访问越频繁，分数越高
最近访问的目录分数更高
跳转时优先选择分数最高的匹配目录

数据库存储在 ~/.local/share/zoxide/db.zo（Linux）或 ~/.zoxide/db.zo（macOS）。

参考链接

Zoxide GitHub

SSH 命令备忘

Sat, 28 Mar 2026 00:00:00 +0800

SSH 命令备忘

SSH (Secure Shell) 是远程登录和服务器的标准协议，本文记录密钥管理、配置文件、端口转发等常用功能。

1. SSH 配置

1.1 安装并启动

1
2
3

sudo apt install openssh-server -y
sudo systemctl enable ssh
sudo systemctl start ssh

1.2 生成密钥对

1
2

# 生成密钥
ssh-keygen

密钥出现在~/.ssh目录下，以.pub结尾的是公钥，需要拷贝到对应的服务器的~/.ssh/authorized_keys文件中，私钥需要保密。

~/.ssh目录结构

~/.ssh/
├── id_ed25519          # 私钥（绝对保密）
├── id_ed25519.pub      # 公钥（可公开，放到服务器）
├── id_rsa              # RSA 私钥
├── id_rsa.pub          # RSA 公钥
├── authorized_keys     # 授权的公钥列表（服务器端）
├── known_hosts         # 已知主机
├── config              # SSH 客户端配置文件
├── known_hosts.old     # known_hosts 的备份
└── *.pem               # 其他密钥文件（如 AWS）

1.3 SSH 配置文件

~/.ssh/config 文件可以简化 SSH 连接：

# 基本格式
Host alias-name # 别名
    HostName server.example.com # ip地址或域名
    User username # 登录用户名
    Port 22 # 端口号，默认22
    IdentityFile ~/.ssh/mykey # 私钥路径,  默认是~/.ssh/id_rsa或id_ed25519

配置别名后可以直接使用别名连接：

# 配置后可直接用别名连接
ssh alias-name

# 等价于
ssh -p 22 username@server.example.com -i ~/.ssh/mykey

跳板机配置，ssh可以通过跳板机连接内网服务器，使用情况：跳板机可以外网访问，内网服务器只能被跳板机访问。此时可以在ssh配置文件中配置跳板机为ProxyJump，如：

    Host jump-host
        HostName jump.example.com
        User jumpuser
        IdentityFile ~/.ssh/jump_key
    Host internal-server
        HostName internal.example.com
        User internaluser
        IdentityFile ~/.ssh/internal_key
        ProxyJump jump-host # 通过jump-host跳转连接internal-server

1.4 密钥权限设置

# 私钥权限必须是 600
chmod 600 ~/.ssh/id_ed25519

# 公钥权限
chmod 644 ~/.ssh/id_ed25519.pub

# .ssh 目录权限
chmod 700 ~/.ssh

# authorized_keys 权限
chmod 600 ~/.ssh/authorized_keys

2. SSH 端口转发

2.1 本地端口转发 (Local Forward)

将远程服务的端口映射到本地端口：

# 基本格式
ssh -L 本地端口:目标主机:目标端口 user@server

# 配置别名后
ssh -L 本地端口:目标主机:目标端口 alias-name

2.2 远程端口转发 (Remote Forward)

将本地服务的端口暴露到远程服务器端口：

# 基本格式
ssh -R 远程端口:本地主机:本地端口 user@server
# 配置别名后
ssh -R 远程端口:本地主机:本地端口 alias-name
# 这里远程端口前如果缺远程ip 那么只能在服务器的127.0.0.1访问
# 设置成0.0.0.0则可以在服务器的任意ip访问

2.3 动态端口转发 (SOCKS 代理)

创建本地 SOCKS 代理，所有流量通过服务器转发：

# 创建 SOCKS5 代理
ssh -D 1080 user@server

# 设置代理，让流量通过服务器转发
export all_proxy="socks5://127.0.0.1:1080"

2.4 端口转发汇总

类型	参数	场景
本地转发	`-L`	访问远程服务端口
远程转发	`-R`	将本地服务端口暴露给远程
动态转发	`-D`	创建代理，流量全部走服务器

2.5 socat 远程转发端口

有一个常见限制：

机器B 上跑服务
机器A 是跳板机
机器B 通过 ssh -R 把服务转发到 机器A
但是 机器A 上没有 root，无法修改 sshd 的 GatewayPorts

这时即使使用：

`1`	`ssh -N -R 0.0.0.0:18009:127.0.0.1:8009 user@machine-a`

端口通常还是只会绑定在 127.0.0.1:18009，外部机器无法直接访问。

如果 机器A 上可以运行 socat，可以再做一层用户态转发：

1
2
3

# 机器B：先把本机服务转发到机器A的本地端口
# 注意这里的端口必须设置不同 不然无法被socat转发
ssh -N -R 127.0.0.1:18009:127.0.0.1:8009 user@machine-a

1
2

# 机器A：把本地 18009 再监听到 0.0.0.0:8009
socat TCP-LISTEN:8009,bind=0.0.0.0,fork,reuseaddr TCP:127.0.0.1:18009

这样访问链路就是：

`1`	`外部设备 -> 机器A:8009 -> socat -> 机器A:18009 -> ssh -R -> 机器B:8009`

使用时注意：

机器A 需要已安装 socat
机器A 的防火墙需要放行目标端口，例如 8009
如果目标服务是 HTTPS，浏览器访问时要用 https://机器AIP:8009/
这种方式适合临时暴露服务，长期使用更建议直接配置稳定入口，例如 Tailscale、反向代理或域名

3. 参考链接

Linux 常用命令备忘

Fri, 27 Mar 2026 23:30:00 +0800

Linux 常用命令备忘

Linux 日常开发中常用的命令速查，包括磁盘管理、进程管理、文件操作、网络工具等。

1. 磁盘与文件大小

1.1 du - 查看目录/文件大小

du -sh *              # 查看当前目录下各文件/文件夹大小（人类可读）
du -sh /path/to/dir   # 查看指定目录大小
du -h --max-depth=1   # 只显示一级子目录大小
du -sh * | sort -rh   # 按大小排序（从大到小）
du -sh * | sort -rh | head -10  # 显示最大的 10 个文件/目录

1.2 df - 查看磁盘空间

1
2
3

df -h                 # 查看所有磁盘分区使用情况
df -h /home           # 查看指定目录所在分区
df -i                 # 查看 inode 使用情况（小文件过多时有用）

2. 进程管理

2.1 查看进程

ps aux                # 查看所有进程
ps aux | grep python  # 查找指定进程

top                   # 实时进程监控
htop                  # 更友好的实时监控（需安装）

2.2 pkill - 按名称杀进程

pkill python          # 杀死所有 python 进程
pkill -f "python script.py"  # 匹配完整命令
pkill -9 python       # 强制杀死
pkill -u user python  # 杀死指定用户的进程

2.3 killall - 按名称杀进程

1
2
3

killall nginx         # 杀死所有 nginx 进程
killall -9 nginx      # 强制杀死
killall -i nginx      # 交互式确认

2.4 kill - 按 PID 杀进程

1
2
3

kill 1234             # 发送 SIGTERM (15)
kill -9 1234          # 发送 SIGKILL (强制)
kill -l               # 查看所有信号

2.5 查找进程 PID

pgrep python          # 返回 python 进程的 PID
pgrep -l python       # 同时显示进程名
pgrep -a python       # 显示完整命令
pidof nginx           # 返回 nginx 的 PID

3. 文件操作

3.1 find - 查找文件

find /home -name "*.py"        # 按文件名查找
find . -type d -name "test"    # 查找目录
find . -type f -size +100M     # 查找大于 100M 的文件
find . -mtime -7               # 查找 7 天内修改的文件
find . -mtime +30              # 查找 30 天前修改的文件
find . -name "*.log" -delete   # 查找并删除

3.2 ln - 软链接/硬链接

ln -s /path/to/target /path/to/link  # 创建软链接
ln /path/to/file /path/to/hardlink   # 创建硬链接
ls -l /path/to/link                  # 查看链接指向
readlink /path/to/link               # 查看链接目标
unlink /path/to/link                 # 删除链接
# 软链接类似快捷方式， 硬链接类似别名

3.3 tar - 压缩解压

# 压缩
tar -czvf archive.tar.gz /path/to/dir   # 压缩为 .tar.gz
tar -cjvf archive.tar.bz2 /path/to/dir  # 压缩为 .tar.bz2

# 解压
tar -xzvf archive.tar.gz                # 解压 .tar.gz
tar -xjvf archive.tar.bz2               # 解压 .tar.bz2
tar -xzvf archive.tar.gz -C /target/dir # 解压到指定目录

# 参数说明: c-创建,  x-解压,  z-gzip,  j-bzip2,  v-显示过程,  f-指定文件

4. 网络工具

4.1 端口与连接

# 查看端口占用
netstat -tlnp          # 查看监听的 TCP 端口
netstat -tunlp         # TCP + UDP
ss -tlnp               # 更现代的替代品
lsof -i :8080          # 查看占用 8080 端口的进程

# 查看连接
netstat -an | grep ESTABLISHED  # 查看已建立的连接
ss -s                  # 连接统计

4.2 网络诊断

ping baidu.com         # 测试连通性
ping -c 4 baidu.com    # 只 ping 4 次

traceroute baidu.com   # 追踪路由
mtr baidu.com          # 实时路由追踪（更好用）

curl -I https://baidu.com    # 只获取响应头
curl -v https://baidu.com    # 显示详细信息
curl -o file.html https://example.com  # 保存到文件

wget https://example.com/file.zip   # 下载文件
wget -c https://example.com/file.zip  # 断点续传

4.3 防火墙 (ufw)

sudo ufw status        # 查看状态
sudo ufw enable        # 启用
sudo ufw allow 22      # 允许 22 端口
sudo ufw allow 8080/tcp
sudo ufw deny 3306     # 禁止 3306 端口
sudo ufw delete allow 22  # 删除规则

5. 系统信息

5.1 硬件信息

# CPU
lscpu                  # CPU 信息
nproc                  # CPU 核心数
cat /proc/cpuinfo      # 详细 CPU 信息

# 内存
free -h                # 内存使用情况
cat /proc/meminfo      # 详细内存信息

# GPU
nvidia-smi             # NVIDIA GPU 信息
watch -n 1 nvidia-smi  # 每秒刷新
nvtop                  # NVIDIA GPU 监控

# 磁盘
lsblk                  # 列出块设备
fdisk -l               # 磁盘分区信息

5.2 系统信息

uname -a               # 内核信息
cat /etc/os-release    # 系统版本
hostname               # 主机名
uptime                 # 运行时间
whoami                 # 当前用户
id                     # 用户 ID 信息

6. 用户与权限

6.1 用户管理

who                    # 查看登录用户
w                      # 查看登录用户及其活动
last                   # 查看登录历史

id username            # 查看指定用户信息
groups username        # 查看用户所属组
cat /etc/group         # 查看所有组信息
adduser username       # 添加用户
userdel username       # 删除用户
usermod -aG sudo user  # 将用户加入 sudo 组
passwd username        # 修改密码

6.2 权限管理

chmod 755 file         # 修改权限（数字）
chmod +x script.sh     # 添加执行权限
chmod -R 755 dir/      # 递归修改目录权限

chown user:group file  # 修改所有者
chown -R user:group dir/  # 递归修改

# 权限数字: 7=rwx,  6=rw-,  5=r-x,  4=r--,  0=---

7. 文本处理

7.1 grep - 文本搜索

grep "pattern" file    # 搜索文本
grep -r "pattern" dir/ # 递归搜索
grep -i "pattern" file # 忽略大小写
grep -n "pattern" file # 显示行号
grep -E "p1|p2" file   # 正则表达式
grep -c "pattern" file # 统计匹配行数

8. 其他常用

8.1 定时任务

crontab -l                   # 查看定时任务
crontab -e                   # 编辑定时任务
# 格式: 分 时 日 月 周 命令
# 0 2 * * * /path/to/backup.sh  # 每天凌晨 2 点执行

8.2 环境变量

env                          # 查看所有环境变量
echo $PATH                   # 查看 PATH
export MY_VAR="value"        # 设置环境变量（临时）
echo 'export MY_VAR="value"' >> ~/.bashrc  # 永久设置 或者是 ~/.zshrc
source ~/.bashrc             # 使配置生效 或者是 ~/.zshrc

参考链接

Git 命令备忘

Fri, 27 Mar 2026 23:00:00 +0800

Git 命令备忘

Git 日常开发中常用的命令速查，包括分支管理、合并、暂存、版本回退等场景。

保存git凭证： git config --global credential.helper store

1. 分支管理

1.1 查看分支

1
2
3

git branch              # 查看本地分支
git branch -a           # 查看所有分支（含远程）
git branch -r           # 只查看远程分支

1.2 创建/切换分支

git branch feature-x    # 创建分支
git checkout feature-x  # 切换分支
git checkout -b feature-x    # 创建并切换（简写）
git switch feature-x    # 切换分支（新语法）
git switch -c feature-x # 创建并切换（新语法）

1.3 删除分支

1
2
3

git branch -d feature-x     # 删除已合并的分支
git branch -D feature-x     # 强制删除（未合并也删）
git push origin --delete feature-x  # 删除远程分支

1.4 重命名分支

1
2

git branch -m old-name new-name  # 重命名当前分支
git branch -m new-name           # 重命名当前分支

2. 合并与变基

2.1 merge

1
2

git merge feature-x    # 合并指定分支到当前分支
git merge --abort      # 取消合并（冲突时）

2.2 rebase

git rebase main        # 将当前分支变基到 main
git rebase -i HEAD~3   # 交互式变基最近 3 个提交（把最近三个提交变成一个）
git rebase --abort     # 取消变基
git rebase --continue  # 解决冲突后继续

注意：不要对已推送到远程的提交执行 rebase，会导致历史混乱。

merge vs rebase

merge 和 rebase 的主要区别是：rebase 会将 feature 分支的提交历史重写，而 merge 不会。操作前

1
2
3

      A---B---C  (feature 分支)
     /
D---E---F---G    (main 分支)

merge后

1
2
3

      A---B---C
     /         \
D---E---F---G---M  (M 是新的合并提交)

rebase后

1
2
3

              A'--B'--C' (feature 分支，提交哈希变了)
             /
D---E---F---G            (main 分支)

3. 暂存工作区

适用场景：正在开发中，临时需要切换分支处理其他事情。

git stash              # 暂存当前修改
git stash save "描述"   # 暂存并添加描述
git stash list         # 查看暂存列表
git stash pop          # 恢复最近一次暂存并删除记录
git stash apply        # 恢复最近一次暂存（保留记录）
git stash apply stash@{2}  # 恢复指定暂存
git stash drop stash@{0}   # 删除指定暂存
git stash clear        # 清空所有暂存

4. 版本回退与恢复

4.1 查看历史

git log --oneline      # 简洁查看提交历史
git log --oneline -10  # 最近 10 条
git log --oneline --graph  # 带分支图
git reflog             # 查看所有操作记录（含已删除的提交）

4.2 回退版本

1
2
3

git reset --soft commit-hash    # 回退到指定提交，保留修改在暂存区
git reset --mixed commit-hash   # 回退到指定提交，保留修改在工作区（默认）
git reset --hard commit-hash    # 回退到指定提交，丢弃所有修改（危险）

4.3 从某个版本恢复文件

1
2

# 从指定提交恢复某个文件
git checkout commit-hash -- path/to/file

4.4 撤销某次提交

1
2

git revert commit-hash   # 创建新提交来撤销指定提交（不改变历史）
git revert -n commit-hash  # 撤销但不自动提交

reset vs revert：

reset：回退历史，适合未推送的提交
revert：新增一个撤销提交，适合已推送的提交

5. 远程操作

git remote -v                    # 查看远程仓库
git remote add origin <url>      # 添加远程仓库
git fetch origin                 # 获取远程更新（不合并）
git pull origin main             # 拉取并合并
git push origin main             # 推送到远程
git push -u origin feature-x     # 推送并设置上游分支
git push -f origin main          # 强制推送（危险）

6. 子模块

git submodule add <url> path/to/submodule  # 添加子模块
git submodule update --init --recursive    # 初始化并拉取子模块
git submodule update --remote              # 更新子模块到最新
git submodule foreach git pull origin main # 批量更新所有子模块

7. 其他常用

git status             # 查看状态
git diff               # 查看未暂存的修改
git diff --staged      # 查看已暂存的修改
git diff commit-hash   # 与指定版本对比

git cherry-pick commit-hash  # 将指定提交应用到当前分支
git blame path/to/file       # 查看文件每行的修改记录

# 只提交部分文件
git add -p             # 交互式选择部分修改暂存

8. 常见`git commit`备注

类型	含义	示例
`feat`	新功能 (Feature)	`feat: add user login module`
`fix`	修复 Bug	`fix: resolve null pointer exception`
`docs`	文档变更	`docs: update API README`
`style`	代码格式 (不影响逻辑)	`style: remove trailing whitespaces`
`refactor`	重构 (既非新功能也非修bug)	`refactor: simplify database connection logic`
`perf`	性能优化	`perf: improve image loading speed`
`test`	测试相关	`test: add unit tests for payment`
`chore`	构建/辅助工具变动	`chore: update dependencies`
`ci`	CI/CD 配置变更	`ci: update GitHub Actions workflow`

参考链接

HuggingFace/ModelScope 模型下载工具

Thu, 26 Mar 2026 17:00:00 +0800

HuggingFace/ModelScope 模型下载工具备忘

在使用社区大模型时不太建议在代码内嵌模型下载，通过预先下载至本地，再从对应目录加载更加方便。

1. HuggingFace

1.1 专用下载工具

huggingface直连情况下速率较慢，可以通过镜像站进行下载，需要临时设置一次环境变量如下：

`1`	`export HF_ENDPOINT=https://hf-mirror.com`

“专用下载工具”的获取，以及赋予可执行权限：

1
2

wget https://hf-mirror.com/hfd/hfd.sh
chmod a+x hfd.sh

寻找对应模型的id，左边绿色框内表示模型id，右边红色框可以一键复制模型id

在需要下载模型的目录中执行模型下载命令：

`1`	`./hfd.sh Qwen/Qwen3.5-9B # 替换为自己需要的模型id`

部分文件下载：通过--include命令执行正则表达式的筛选，只下载需要的文件，例如下面表示只下载config.json文件
1

/hfd.sh <model_id> --include '^config.json$'
数据集下载：查找指定数据集id，执行下载命令如下：
1

./hfd.sh wikitext --dataset # wikitext是下载的数据集id

2. ModelScope

2.1 命令行

魔塔社区下载器通过python命令行形式，需要先安装python包

`1`	`pip install modelscope # 先在指定虚拟环境下安装modelscope包`

然后找到想要下载的模型的界面，旁边有下载指引在下载指引可以看到下载tutorial，通常来说，命令行下载只需要找到模型id，如上图左侧，随后执行下载命令

`1`	`modelscope download --model Qwen/Qwen3.5-9B # 最后是模型id，确保当前命令行的python环境有modescope`

特别的，可以只下载部分文件，通常会用于下载README.md或者config.json等，README.md包括模型介绍而config.json包括模型实例化的信息，可以空数据的形式加载到元设备执行，命令如下：
1

modelscope download --model Qwen/Qwen3.5-9B config.json
数据集下载：查找数据集id，把--model替换成--dataset即可
1

modelscope download --dataset datai_id

2.2 其它方式

SDK或者git方式参考官方文档或者对应模型的下载指引。

3. 参考链接

Jetson 环境配置备忘

Thu, 26 Mar 2026 17:00:00 +0800

Jetson 环境配置备忘

NVIDIA Jetson 系列 (Nano/Xavier NX/Orin) 边缘计算开发板环境配置记录。

1. 新用户

创建新用户并且复制ssh公钥，同时添加到jtop分组中

sudo adduser huluhuluu
sudo usermod -aG jtop huluhuluu
sudo usermod -aG sudo huluhuluu # 添加sudo权限 慎重
passwd huluhuluu # 设置密码
sudo su huluhuluu
cd /home/huluhuluu
mkdir .ssh && cd .ssh
touch authorized_keys && vim authorized_keys
# 设置权限
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

2. 安装常用包

# 安装常用工具
sudo apt-get install zsh gzip netcat pv tmux nvtop htop lsof aria2 pigz git-lfs -y

# 配置 zsh
git clone https://gitee.com/mirror-hub/ohmyzsh.git ~/.oh-my-zsh
# 插件
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
git clone https://gitee.com/mirror-hub/zsh-syntax-highlighting.git ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
git clone https://gitee.com/mirror-hub/zsh-autosuggestions.git ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions
# 启用插件
echo "autoload -U compinit && compinit" >> ~/.zshrc
sed -i '/^plugins=/c\plugins=(git sudo z zsh-syntax-highlighting zsh-autosuggestions)' ~/.zshrc
# 自动切换zsh
touch ~/.bash_profile
changeshell="exec $(which zsh) -l"
echo "$changeshell" >> ~/.bash_profile
# 退出当前终端，重新登录后生效

2.1 安装minifoge

# 下载aarch版安装脚本
wget https://mirror.nju.edu.cn/github-release/conda-forge/miniforge/LatestRelease/Miniforge3-Linux-aarch64.sh
# 安装和删除
bash Miniforge3-Linux-aarch64.sh -b
rm -rf Miniforge3-Linux-aarch64.sh
# 设置环境变量
echo 'source ~/miniforge3/etc/profile.d/conda.sh'  >> -a ~/.zshrc # 这里的路径注意要匹配

# 可执行权限
chmod u+x ~/miniforge3/etc/profile.d/conda.sh

# ！！重要， 配置CUDA的环境变量
echo 'export PATH="/usr/local/cuda/bin:$PATH"' >> ~/.zshrc
echo 'export LD_LIBRARY_PATH="/usr/local/cuda/lib64:$LD_LIBRARY_PATH"' >> ~/.zshrc
source ~/.zshrc

# 初始化并且配置清华源
conda init
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/bioconda/

2.2 pytorch安装

需要特定版本的pytorch，参考版本兼容表和官方安装tutorial

先查看jetpack版本和cuda版本

(base) ➜  ~ sudo apt-cache show nvidia-jetpack  # 查看jetpack版本命令
Package: nvidia-jetpack
Source: nvidia-jetpack (6.0) # jetpack版本
Version: 6.0+b106
Architecture: arm64
Maintainer: NVIDIA Corporation
Installed-Size: 194
Depends: nvidia-jetpack-runtime (= 6.0+b106),  nvidia-jetpack-dev (= 6.0+b106)
Homepage: http://developer.nvidia.com/jetson
Priority: standard
Section: metapackages
Filename: pool/main/n/nvidia-jetpack/nvidia-jetpack_6.0+b106_arm64.deb
Size: 29296
SHA256: 561d38f76683ff865e57b2af41e303be7e590926251890550d2652bdc51401f8
SHA1: ef3fca0c1b5c780b2bad1bafae6437753bd0a93f
MD5sum: 95de21b4fce939dee11c6df1f2db0fa5
Description: NVIDIA Jetpack Meta Package
Description-md5: ad1462289bdbc54909ae109d1d32c0a8

Package: nvidia-jetpack
Source: nvidia-jetpack (6.0)
Version: 6.0+b87
Architecture: arm64
Maintainer: NVIDIA Corporation
Installed-Size: 194
Depends: nvidia-jetpack-runtime (= 6.0+b87),  nvidia-jetpack-dev (= 6.0+b87)
Homepage: http://developer.nvidia.com/jetson
Priority: standard
Section: metapackages
Filename: pool/main/n/nvidia-jetpack/nvidia-jetpack_6.0+b87_arm64.deb
Size: 29298
SHA256: 70be95162aad864ee0b0cd24ac8e4fa4f131aa97b32ffa2de551f1f8f56bc14e
SHA1: 36926a991855b9feeb12072694005c3e7e7b3836
MD5sum: 050cb1fd604a16200d26841f8a59a038
Description: NVIDIA Jetpack Meta Package
Description-md5: ad1462289bdbc54909ae109d1d32c0a8

N: Ignoring file 'cuda-tegra-ubuntu2204-12-2-local.list.backup' in directory '/etc/apt/sources.list.d/' as it has an invalid filename extension

(base) ➜  ~ nvcc --version  # 查看cuda版本命令
nvcc: NVIDIA (R) Cuda compiler driver
Copyright (c) 2005-2023 NVIDIA Corporation
Built on Tue_Aug_15_22:08:11_PDT_2023
Cuda compilation tools,  release 12.2,  V12.2.140
Build cuda_12.2.r12.2/compiler.33191640_0 # cuda 版本

根据jetpack版本和cuda版本查找对应的pytorch版本与下载链接, 以nvidia-jetpack (6.0)和cuda12.2为例，在版本兼容表中找到对应的pytorch版本, 右键复制下载链接
指定pyhton版本创建虚拟环境，安装对应pytorch

# 创建/启动虚拟环境 需要制定python版本！！
sudo apt-get -y update; 
sudo apt-get install -y  python3-pip libopenblas-dev;

# 下面的链接换成上一步复制的链接
export TORCH_INSTALL=https://developer.download.nvidia.cn/compute/redist/jp/v512/pytorch/torch-2.1.0a0+41361538.nv23.06-cp38-cp38-linux_aarch64.whl
python3 -m pip install --upgrade pip; 
python3 -m pip install --no-cache $TORCH_INSTALL

验证，python交互模式中输入，能够正常输出gpu数量/gpu型号安装成功

import torch
print(torch.__version__)
torch.cuda.device_count()
torch.cuda.get_device_name(0)

注意：后续缺失的包尽量用pip安装

2.3. 常用命令

# 性能监控
sudo jtop
htop # CPU监控

# 电源调优
sudo nvpmodel -q --verbose # 查看当前模式和频率
sudo nvpmodel -q   # 查看当前模式
sudo nvpmodel -m 0 # 设置最大性能模式 (15W/30W 取决于设备)
sudo nvpmodel -m 1 # 设置省电模式

# 频率调优
sudo jetson_clocks # 启用最高性能
sudo jetson_clocks --restore # 恢复默认频率
sudo jetson_clocks --show # 查看当前状态

可以在jtop中查看当前模式和频率, 启动 jtop 后按 → 切换到 CTRL 页面可以看到左下角的NV Power Mode，同时可以看到jetpack版本，在7INFO界面可以看到cuda版本等信息

3. 参考链接

Netcat 不加密传输工具

Thu, 26 Mar 2026 17:00:00 +0800

Netcat 不加密传输工具

Netcat (nc) 是一个功能强大的网络工具，可以在局域网中以不加密方式进行文件传输，速率大于SCP加密文件传输方式。

1 安装

1
2

# Ubuntu/Debian
sudo apt install -y netcat

1.1 基本参数

参数	说明
`-l`	监听模式
`-p`	指定端口
`-v`	显示详细信息
`-n`	不解析 DNS
`-w`	超时时间 (秒)
`-q`	传输完成后等待时间
`-u`	UDP 模式

2. 文件传输

2.1 发送单个文件

可以结合 pv (Pipe Viewer) 显示传输进度, 安装 pv命令如下

`1`	`sudo apt install -y pv`

接收端需要打开端口，并且把接受到的内容保存到文件中, 下面<port>表示端口，file表示保存的文件名
1

nc -l -p <port> | pv > file
发送端需要向指定的ip和端口发送文件, 下面ip和端口表示接收端ip和端口，需要先启动接收端命令， file表示发送的文件
1

pv file | nc <ip> <port>

2.2 压缩传输

直接传输文件/目录传输量太大，结合 tar + gzip 压缩可以减少传输时间：

# 发送端 (压缩) -p 后面的数字表示线程，
# file.tar.gz表示发送的文件压缩包名，
# path/to/directory 表示发送的文件目录/文件
tar --use-compress-program="pigz -p 8" -cvf file.tar.gz /path/to/directory 

# 接收端 (解压) file.tar.gz表示接收的文件名
tar -xzvf file.tar.gz

2.3 测试ip:port连通性

从发送端设备向目标接收端对应的ip+port发送消息，测试连通性

# 接受端
nc -l -p <port>

# 发送端
echo "hello" | nc <ip> <port>

2.4 端口扫描

# 扫描单个端口
nc -zv target_ip 80

# 扫描端口范围
nc -zv target_ip 20-100

# 扫描多个端口
nc -zv target_ip 80 443 8080

2.5 注意事项

安全性：Netcat 传输不加密，敏感数据需要配合加密工具
防火墙：确保防火墙开放对应端口

3. 参考链接

Python 环境配置工具备忘

Thu, 26 Mar 2026 17:00:00 +0800

Python 环境配置工具备忘

Python环境管理是开发中的重要环节，本文介绍常用的 miniforge虚拟环境管理+uv包管理工具。

1. 虚拟环境管理工具 miniforge

miniforge 是 Anaconda/Miniconda 提供的包和环境管理器。

安装 miniforge

# 下载安装脚本
wget https://mirrors.zju.edu.cn/miniforge/Miniforge3-Linux-x86_64.sh

# 安装并且删除
./Miniforge3-Linux-x86_64.sh
rm -rf Miniforge3-Linux-x86_64.sh

# 重新打开终端初始化
conda init bash
source ~/.bashrc

1.2 配置镜像源

# 清华源
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/bioconda/

1.3 常用命令

# 创建环境
conda create -n myenv python=3.10 -y

# 激活环境
conda activate myenv

# 退出环境
conda deactivate

# 查看环境列表
conda env list

# 删除环境
conda env remove -n myenv

# 导出环境
conda env export > environment.yml

# 从配置文件创建环境
conda env create -f environment.yml

2. 包管理工具 uv

uv 是 Astral 团队开发的极速 Python 包管理器，用 Rust 编写，比 pip 快 10-100 倍。

2.1 安装

可以通过shell安装或者pip安装

# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# 或通过 pip
pip install uv

# 换源
# export UV_INDEX_URL=https://pypi.mirrors.ustc.edu.cn/simple/ # 临时生效
echo 'index-url = "https://pypi.mirrors.ustc.edu.cn/simple/"' > ~/.config/uv/uv.toml

2.2 常用命令

# 安装包
uv pip install numpy

# 从 requirements.txt 安装
uv pip install -r requirements.txt

# 指定版本
uv pip install numpy==1.26.0

# 卸载包
uv pip uninstall numpy

# 查看已安装包
uv pip list

# 导出依赖
uv pip freeze > requirements.txt

2.3 配合 conda 使用

推荐组合：conda 管理虚拟环境 + uv 管理包

# 创建 conda 环境
conda create -n myenv python=3.10
conda activate myenv

# 使用 uv 安装包 (速度更快)
uv pip install torch torchvision

参考链接

Termux 环境配置备忘

Thu, 26 Mar 2026 17:00:00 +0800

Termux 环境配置备忘

Termux 是 Android 平台上的一个终端模拟器，可以运行 Linux 环境。本文记录 Termux 的基础配置。

1. 安装 Termux

从以下渠道下载apk安装：

2. 基础配置

2.1 换源并且安装常用包

# 自动替换
termux-change-repo
pkg update && pkg upgrade -y
pkg  install zsh gzip pv tmux htop lsof aria2 pigz git-lfs git wget neofetch screenfetch python cmake which clinfo clang netcat-openbsd openssh -y

2.2 获取存储权限

1
2

termux-setup-storage
# 授权后会创建 ~/storage 目录，可以访问手机存储

2.3 SSH 配置

pkg install openssh -y
# 设置自动启动
echo "sshd" > $HOME/.bashrc

# 生成密钥 公钥在目录 ~/.ssh/id_rsa.pub
ssh-keygen

# 启动 SSH 服务
sshd

# 查看用户名 和 ip
whoami
ifconfig

# 设置密码
passwd

连接到 Termux

1
2

# 默认端口 8022
ssh -p 8022 <username>@<ip>

2.4 zsh

git clone https://gitee.com/mirror-hub/ohmyzsh.git ~/.oh-my-zsh
# 插件
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
git clone https://gitee.com/mirror-hub/zsh-syntax-highlighting.git ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
git clone https://gitee.com/mirror-hub/zsh-autosuggestions.git ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions
# 启用插件
echo "autoload -U compinit && compinit" >> ~/.zshrc
sed -i '/^plugins=/c\plugins=(git sudo z zsh-syntax-highlighting zsh-autosuggestions)' ~/.zshrc
# 自动切换zsh
touch ~/.bash_profile
changeshell="exec $(which zsh) -l"
echo "$changeshell" >> ~/.bash_profile

3. 参考链接

Ubuntu 环境配置备忘

Thu, 26 Mar 2026 17:00:00 +0800

Ubuntu 环境配置备忘

Ubuntu 开发环境配置记录，包括常用软件安装、开发工具配置等。

1. 安装常用包

# 安装常用工具
sudo apt-get install zsh gzip netcat pv tmux nvtop htop lsof aria2 pigz git-lfs zoxide -y

# 配置 tmux 鼠标模式
echo 'set -g mouse on' >> ~/.tmux.conf
# 配置 zsh
git clone https://gitee.com/mirror-hub/ohmyzsh.git ~/.oh-my-zsh
# 插件
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
git clone https://gitee.com/mirror-hub/zsh-syntax-highlighting.git ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
git clone https://gitee.com/mirror-hub/zsh-autosuggestions.git ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions
# 启用插件
echo "autoload -U compinit && compinit" >> ~/.zshrc
sed -i '/^plugins=/c\plugins=(git sudo zsh-syntax-highlighting zsh-autosuggestions fzf)' ~/.zshrc
# 自动切换zsh
touch ~/.bash_profile
changeshell="exec $(which zsh) -l"
echo "$changeshell" >> ~/.bash_profile

# zoxide安装
curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh
echo 'eval "$(zoxide init zsh)"' >> ~/.zshrc
# fzf安装
git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install --all # 运行安装脚本

# ！！重要， 配置CUDA的环境变量
echo 'export PATH="/usr/local/cuda/bin:$PATH"' >> ~/.zshrc
echo 'export LD_LIBRARY_PATH="/usr/local/cuda/lib64:$LD_LIBRARY_PATH"' >> ~/.zshrc
source ~/.zshrc # 使配置生效

2. 安装 Miniforge

# 下载安装脚本
wget https://mirror.nju.edu.cn/github-release/conda-forge/miniforge/LatestRelease/Miniforge3-Linux-x86_64.sh

# 安装和删除
bash Miniforge3-Linux-x86_64.sh -b
rm -rf Miniforge3-Linux-x86_64.sh
# 设置环境变量
echo 'source ~/miniforge3/etc/profile.d/conda.sh'  >> ~/.zshrc # 这里的路径注意要匹配

# 可执行权限
chmod u+x ~/miniforge3/etc/profile.d/conda.sh

# 初始化并且配置清华源
source ~/.zshrc
conda init zsh
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/bioconda/

3. 说明

这份配置更偏个人开发机初始化，目标是一次把常用 shell、包管理、tmux、zoxide、fzf 和 conda 环境准备好。
CUDA 环境变量部分只适用于本机确实安装了对应版本 CUDA 的情况。
Miniforge 这一节默认是 Linux x86_64，如果机器架构不同，需要替换成对应安装包。

Psmux 使用指南

Wed, 04 Mar 2026 12:00:00 +0800

Psmux 使用备忘

Psmux 是支持windows原生终端复用器，允许在一个终端窗口中创建多个会话、窗口和面板，支持会话持久化。适合远程连接服务器运行长时间命令，并且ssh连接断开/退出终端后执行的命令不会随着ssh连接断开而结束。

1. 安装

# 通过 winget 安装 也可以通过 Scoop/Chocolatey 等包管理器安装，具体参考github仓库教程：https://github.com/psmux/psmux
> winget install marlocarlo.psmux --source winget
已找到 psmux [marlocarlo.psmux] 版本 3.3.2
此应用程序由其所有者授权给你。
Microsoft 对第三方程序包概不负责，也不向第三方程序包授予任何许可证。
正在下载 https://github.com/psmux/psmux/releases/download/v3.3.2/psmux-v3.3.2-windows-x64.zip
  ██████████████████████████████  5.81 MB / 5.81 MB
已成功验证安装程序哈希
正在提取存档...
已成功提取存档
正在启动程序包安装...
添加了命令行别名： "psmux"
添加了命令行别名： "pmux"
添加了命令行别名： "tmux"
已修改路径环境变量；重启 shell 以使用新值。
已成功安装

# 验证安装
> psmux -V
psmux 3.3.2 # 输出版本号表示安装成功

2. 使用

2.1 前置键

psmux给命令起了别名tmux, 使用过程与tmux基本一致。在tmux使用各自快捷键通常会有前置键，需要先按前置组合键，再配合对应命令键位，默认前缀键是: Ctrl+B。

例如：退出会话需要Ctrl+B, d命令，先按下Ctrl+B键，再按下d键，就可以退出并不杀死会话。 后续的命令中, 表示分割，前后按键需要分两次操作。

2.2 常用会话命令

新建会话：通过tmux直接打开一个会话窗口，这个窗口的命令在退出后会话不会关闭。

1
2
3

# 新建会话
tmux                      # 默认名称
tmux new -s name          # 指定名称, 用于重新打开和kill

查看当前存在的会话:
1

tmux ls

进入会话

1
2
3

tmux attach               # 进入最近会话
tmux attach -t name       # 进入指定会话
tmux a -t name            # 简写

杀死会话

1
2

tmux kill-session -t name # 关闭指定会话
tmux kill-server # 关闭所有会话

退出会话且不关闭
1

Ctrl+B, d
退出且关闭当前会话
1

exit

2.3 Pane 分屏操作

上下分屏: Ctrl+B, %
左右分屏: Ctrl+B, "
移动当前光标到分屏：Ctrl+B, (← ↑ ↓ →) 上下左右代表方向，每次按完方向键盘需要重新按前置键，不能连续选。
移动光标到指定分屏: Ctrl+B, q，按完后会在分屏上出现数字，这时快速按下对应数字可实现光标直接跳转。
调整分屏大小：Ctrl+B, Ctrl + (← ↑ ↓ →)，分别向上下左右四个方向跳转分屏大小。
关闭分屏：Ctrl+B, x, 按完后需要再次输入y确认关闭光标所在分屏
鼠标模式：Ctrl+B, :set -g mouse on, 这里按下前置键Ctrl+B后按:键，会出现一行黄色命令行，再输入set -g mouse on命令，并回车即可临时开启鼠标模式。不开启鼠标模式通过鼠标滚轮无法上下查看shell输出。

3. TPM 插件管理器

psmux实现了一个类似于tmux的插件管理器TPM的工具Tmux Plugin Panel，可以通过它来安装和管理插件。

# 同样可以通过多种包管理器安装，下面是通过 winget 安装的示例
> winget install marlocarlo.tmuxpanel --source winget
已找到 tmuxpanel [marlocarlo.tmuxpanel] 版本 0.1.1
此应用程序由其所有者授权给你。
Microsoft 对第三方程序包概不负责，也不向第三方程序包授予任何许可证。
正在下载 https://github.com/marlocarlo/Tmux-Plugin-Panel/releases/download/v0.1.1/tmuxpanel-v0.1.1-windows-x64.zip
  ██████████████████████████████  7.38 MB / 7.38 MB
已成功验证安装程序哈希
正在提取存档...
已成功提取存档
正在启动程序包安装...
添加了命令行别名： "tmuxpanel"
添加了命令行别名： "tmuxplugins"
添加了命令行别名： "tmuxthemes"
已成功安装

安装完成后通过下面三个命令打开插件面板，可以安装和管理插件。

tmuxpanel — Main TUI plugin manager
tmuxplugins — Opens directly to the Browse tab
tmuxthemes — Opens directly to the Themes browser

以第二个命令为例，打开插件面板后可以通过Browse标签页浏览和安装插件，通过Installed标签页管理已安装的插件。这里通过左右切换左边选项，上下切换插件列表，回车安装插件，可以按p预览对应插件，预览完成需要通过exit命令退出预览界面。

Note: 这里默认走系统代理的7890端口，通过设置环境变量好像无法修改代理地址和端口。

4. 参考链接

reptyr 使用指南

Wed, 04 Mar 2026 12:00:00 +0800

reptyr 使用指南

reptyr 是一个把已经在运行的程序重新挂到当前终端的工具。最常见的场景是 SSH 连上服务器后启动了一个长任务，结果终端马上要断开，这时可以把它接到新的 tmux 或 screen 会话里继续跑。

1. 安装

Ubuntu / Debian 下直接安装：

# install reptyr
sudo apt install -y reptyr

# verify installation
➜ ✗ reptyr -v       
This is reptyr version 0.6.2.

2. 使用

reptyr 基本的命令是reptyr <pid>, 它会把目标进程的输入输出接到当前终端, 其典型的用途有两个：

在普通 SSH 终端里启动了长任务，想把它挂到 tmux / screen
一个进程已经跑起来了，但希望切到另一个终端继续交互

示例流程如下：

# 1. 启动一个长任务
top

# 2. 先挂起
Ctrl+Z

# 3. 放到后台继续跑
bg

# 4. 查看 PID
jobs -l

# 5. 从当前 shell 里解除作业管理
disown %1

# 6. 启动 tmux
tmux

# 7. 在 tmux 里接管这个进程
reptyr <pid>

接管完成后，这个进程就会从新的终端读输入、往新的终端写输出，Ctrl+C、Ctrl+Z 这类信号也会跟过去。

3. 常见问题

3.1 `ptrace_scope` 限制

reptyr 依赖 ptrace。Ubuntu Maverick 及之后的系统，默认可能会限制 ptrace。

官方 README 给的临时处理方式是：

`1`	`sudo sh -c 'echo 0 > /proc/sys/kernel/yama/ptrace_scope'`

这个修改是临时的。长期配置需要看系统里的 /etc/sysctl.d/10-ptrace.conf。

!!另外docker 里默认也限制了 ptrace，所以如果在容器里用 reptyr 需要启动docker时额外配置。

3.2 平台支持有限

官方 README 里明确写到：

reptyr 支持 Linux 和 FreeBSD
FreeBSD 上不是所有功能都完整可用

3.3 Shell 作业状态不会完全同步

README 里还提到一个限制：

进程接到新终端以后，旧 shell 的作业状态不会自动变干净
如果后续还在旧终端里处理前后台，可能还得手动 bg 或 fg

参考资料

reptyr GitHub

Tmux 使用指南

Wed, 04 Mar 2026 12:00:00 +0800

Tmux 使用备忘

Tmux (Terminal Multiplexer) 是一个终端复用器，允许在一个终端窗口中创建多个会话、窗口和面板，支持会话持久化。适合远程连接服务器运行长时间命令，并且ssh连接断开后执行的命令不会随着ssh连接断开而结束。

1. 安装

# Ubuntu/Debian
sudo apt install -y tmux

# 验证安装
tmux -V
# tmux 3.2a # 输出版本号表示安装成功

echo 'set -g mouse on' >> ~/.tmux.conf # 开启鼠标模式

2. 使用

2.1 前置键

tmux 的快捷键通常都需要先按前置键。默认前置键是 Ctrl+B。

例如退出会话但不关闭会话本身，用的是 Ctrl+B, d。这里的 , 只是表示“分两次按键”，不是同时按下。

2.2 常用会话命令

操作	命令 / 按键	说明
新建会话	`tmux`	新建默认名称会话
新建指定会话	`tmux new -s name`	方便后续重新进入或关闭
查看会话	`tmux ls`	列出当前所有会话
进入最近会话	`tmux attach`	进入最近使用的会话
进入指定会话	`tmux attach -t name`	进入指定名称会话
简写进入	`tmux a -t name`	`attach` 的简写
关闭指定会话	`tmux kill-session -t name`	关闭目标会话
关闭所有会话	`tmux kill-server`	关闭整个 `tmux` 服务
退出但不关闭	`Ctrl+B, d`	detach 当前会话
退出并关闭	`exit`	结束当前 shell，关闭当前 pane

2.3 Pane 分屏操作

操作	按键 / 命令	说明
上下分屏	`Ctrl+B, %`	创建上下 pane
左右分屏	`Ctrl+B, "`	创建左右 pane
方向切换 pane	`Ctrl+B, ←/↑/↓/→`	每次切换都要重新按前置键
数字跳转 pane	`Ctrl+B, q`	屏幕会显示数字，快速按数字可跳转
调整 pane 大小	`Ctrl+B, Ctrl+←/↑/↓/→`	按方向调整当前 pane 大小
关闭当前 pane	`Ctrl+B, x`	按完后输入 `y` 确认
重命名会话	`Ctrl+B, :rename-session name`	进入命令行后执行
开启鼠标模式	`Ctrl+B, :set -g mouse on`	临时开启鼠标支持

数字跳转 pane 的效果如下：

关闭 pane 时会出现确认提示：

重命名会话时会进入底部命令行：

开启鼠标模式的命令如下：

3. 参考链接

Zsh 配置指南

Wed, 04 Mar 2026 12:00:00 +0800

Zsh 配置指南备忘

zsh 是一个功能强大的 Unix Shell，具有丰富的自动补全、语法高亮、主题定制等特性。本文将介绍如何安装和配置 zsh，以及一些实用的插件推荐。

安装

`1`	`sudo apt install zsh -y`

配置自动补全和语法高亮

# 配置 zsh
git clone https://gitee.com/mirror-hub/ohmyzsh.git ~/.oh-my-zsh
# 插件
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
git clone https://gitee.com/mirror-hub/zsh-syntax-highlighting.git ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
git clone https://gitee.com/mirror-hub/zsh-autosuggestions.git ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions
# 启用插件
echo "autoload -U compinit && compinit" >> ~/.zshrc
sed -i '/^plugins=/c\plugins=(git sudo z zsh-syntax-highlighting zsh-autosuggestions)' ~/.zshrc
# 自动切换zsh
touch ~/.bash_profile
changeshell="exec $(which zsh) -l"
echo "$changeshell" >> ~/.bash_profile

.zshrc是zsh的配置文件，可以通过修改该文件来配置zsh。例如，启用插件、设置主题、配置环境变量等。修改完成后，执行source ~/.zshrc命令使配置生效。

参考资料

Claude Code 配置指南

Fri, 30 Jan 2026 08:00:00 +0800

Claude Code 配置指南

Claude Code 是 Anthropic 推出的一个本地运行的 Agent 框架，可以接入 Claude 或者兼容 Claude 的第三方模型，支持工具使用和技能配置。

下面是 Ubuntu 22.04 系统 的安装配置记录：

1. 安装 Claude Code

下载安装 claude code (需要魔法，参考安装tutorial)，并且为了使用第三方 API 需要禁用登录。

curl -fsSL https://claude.ai/install.sh | bash

vim ~/.claude.json
# 添加/修改下面内容为
# "hasCompletedOnboarding": true // 禁用登录

# 如果已经使用 claude 需要清理一下 ~/.claude.json 的备份
# rm -rf ~/.claude.json.*

2. 安装 cc-switch (可选)

cc-switch 是一个可以在 claude code 中同时管理并且切换不同的大模型 API，支持 Claude 和兼容 Claude 的第三方模型。

注意：如果只使用 Claude 官方模型可以跳过这一步

2.1 下载安装

选择对应的 CLI 版本，下面具体获取的包需要在 release 界面获取，优先获取 musl 静态编译版。

# 下载
curl -LO https://github.com/SaladDay/cc-switch-cli/releases/download/v4.5.0/cc-switch-cli-v4.5.0-linux-x64-musl.tar.gz

tar -xzf cc-switch-cli-*.tar.gz # 解压
rm cc-switch-cli-*.tar.gz # 删除压缩包
chmod +x cc-switch # 执行权限
sudo mv cc-switch /usr/local/bin/ # 放到系统路径


# 或者直接安装
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash

2.2 配置 API

参考文档 (有中文版)，输入对应的模型提供商、URL、模型 ID、接口令牌等信息。

➜  cc-switch provider list              # 列出所有供应商
No providers found.
Use 'cc-switch provider add' to create a new provider.

➜  ~ cc-switch provider add
Add New Provider
==================================================
> Provider Name: DeepSeek
> Website URL (optional): 
Generated ID: deepseek

Configure Claude Provider:
> API Key: ********************************
> Base URL: https://api.deepseek.com/anthropic
> Configure model names? Yes
> Default Model:： deepseek-chat
> Haiku Model:： deepseek-chat
> Sonnet Model:： deepseek-chat
> Opus Model:： deepseek-chat
> Configure optional fields (notes,  sort index)? Yes

Optional Fields Configuration:
> Notes: 
> Sort Index: 

=== Provider Configuration Summary ===
ID: deepseek
Provider Name:: DeepSeek

Core Configuration:
  API Key: sk-0...841d
  Base URL: https://api.deepseek.com/anthropic
  Model: deepseek-chat
======================
? 
Confirm create this provider? (y/N) y 

# 再查看就有了
➜  cc-switch provider list                                     
┌───┬──────────┬──────────┬────────────────────────────────────┐
│   ┆ ID       ┆ Name     ┆ API URL                            │
╞═══╪══════════╪══════════╪════════════════════════════════════╡
│ ✓ ┆ deepseek ┆ DeepSeek ┆ https://api.deepseek.com/anthropic │
└───┴──────────┴──────────┴────────────────────────────────────┘

ℹ Application: claude
→ Current: deepseek # 当前使用的 deepseek

# 在打开 claude 就可以使用了
➜ claude

模型的 URL、ID、Token 令牌等获取参考 Copilot 配置文档。这里配置的 DeepSeek 模型，下面是加入 Claude Code 的测试结果：

3. 配置 Skills

可以在开源仓库/社区获取 Skills，如：

3.1 Skill 结构

Skill 包含如下结构，可以理解为高级提示词。参考tutorial: 官方文档、中文tutorial

skill-name/
├── SKILL.md          # Required: Skill instructions and metadata
├── scripts/          # Optional: Helper scripts
├── templates/        # Optional: Document templates
└── resources/        # Optional: Reference files

3.2 安装 Skill

把下载好的 Skill 放到下面目录就可以在 Claude Code 中使用：

1
2

mkdir -p ~/.config/claude-code/skills/
cp -r skill-name ~/.config/claude-code/skills/

下面以 write-skill 为例，右边有 install 命令：

➜  npx skills add tldraw/tldraw # 中间的命令通过方向键和空格键选中
➜  ls -lah /root/.claude/skills # 可以在 skills 目录下查找到对应的 skills
total 8.0K
drwxr-xr-x 2 root root 4.0K Feb  3 19:34 .
drwxr-xr-x 9 root root 4.0K Feb  3 19:36 ..
lrwxrwxrwx 1 root root   32 Feb  3 19:34 find-skills -> ../../.agents/skills/find-skills
lrwxrwxrwx 1 root root   32 Feb  3 19:34 review-docs -> ../../.agents/skills/review-docs
lrwxrwxrwx 1 root root   34 Feb  3 19:34 skill-creator -> ../../.agents/skills/skill-creator
lrwxrwxrwx 1 root root   41 Feb  3 19:34 update-release-notes -> ../../.agents/skills/update-release-notes
lrwxrwxrwx 1 root root   32 Feb  3 19:34 write-docs -> ../../.agents/skills/write-docs
...

3.3 测试

第一次使用会询问工具权限，如果不应该使用工具可以附上应该怎么做，例如 Fetch(https://github.com/alibaba/MNN) 这一步被取消了，理由是当前目录就在 MNN 中。

flash.vscode 插件

Fri, 30 Jan 2026 08:00:00 +0800

flash.vscode 插件

使用 flash.vscode 插件可以在 VSCode 中跳转到屏幕可见的任意一行。

1. 安装插件

直接在 VSCode 插件商店下载 flash.vscode 插件

2. 使用方法

ctrl+shift+p 面板搜索选择 flash-vscode: Start Navigation，然后键入光标想去的位置的单词，例如下面我输入的是 llm

屏幕中所有可见的 llm 都被索引到并且后方出现一个字母标签，按下对应的字母标签光标就可以跳转到对应位置，例如按下位置 c，光标出现在左边分屏的第 265 行

3. 绑定快捷键

现在的启动方式还是太抽象了，ctrl+shift+p 面板搜索选择 Preferences: Open Keyboard Shortcuts (JSON)，添加快捷键绑定，现在可以通过 “ctrl” 和 “;” 启动搜索。

注意这个启动命令可能随着插件版本升级更换，具体命令见 GitHub 仓库。

{
    "key": "ctrl+;", 
    "command": "flash-vscode.start" // 可能更换
}

4. 取消搜索

取消这次搜索按 ESC 键

iFlow CLI 配置指南

Fri, 30 Jan 2026 08:00:00 +0800

iFlow CLI 配置指南

iFlow 是阿里推出的一个在终端中运行的 Agent 框架，可以接入多种大模型 API，目前提供限免的 GLM5.0、Kimi-K2.5、MiniMax-M2.5 等模型。

下面以 Windows 为例，配置记录如下：

1. 安装 NodeJS

安装 NodeJS，选择对应系统与指令集的预编译安装包，下载后双击，同意协议并安装。

2. 安装 iFlow

打开 PowerShell 安装 iFlow:

1
2
3

# 访问 https://nodejs.org/zh-cn/download 下载最新的 Node.js 安装程序
npm install -g @iflow-ai/iflow-cli@latest
iflow --version # 有输出验证安装成功

linux安装

# 1. 直接安装
bash -c "$(curl -fsSL https://gitee.com/iflow-ai/iflow-cli/raw/main/install.sh)"

# 2. 通过 npm 安装 依赖nodejs
npm i -g @iflow-ai/iflow-cli@latest
iflow --version # 有输出验证安装成功

# 如果索引不到iflow命令，可以尝试以下命令
# 激活nvm
echo '
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
nvm --version # 验证nvm
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node # 设置镜像源
# 如果nodejs版本过低，可以使用nvm安装最新版本的nodejs
nvm install 20 # 安装nodejs 20版本

3. 登录配置

打开 shell，启动 iFlow 后进入登录界面：

iflow

共有三个登录方式：

打开网页授权
使用 API Key：需要在心流 API 平台设置，这个 Key 每周会刷新，过期后可以通过 /auth 命令刷新
使用 OpenAI 兼容的第三方 API

配置好 Key 后，可以选择使用的模型：

4. 常用命令

命令	说明
`/resume`	恢复之前的对话，继续之前的上下文
`/clear`	清除之前的对话上下文，重新开始
`/compress`	压缩之前的对话上下文，保留关键信息，释放上下文空间
`/init`	初始化一个新的对话，会在目录下生成 AGENTS.md 文件，记录初始化信息

5. 结束但不是终点

公告: iFlow CLI 产品于 2026 年 3 月 20 日起停止维护，于 4 月 17 日正式关闭，iFlow API 服务、模型库同步关停。

感谢iflow团队的努力它提供了一个便捷的终端 Agent 体验，支持多种大模型 API 的接入和使用，推动终端 Agent 技术的应用。

VSCode Copilot 配置指南

Fri, 30 Jan 2026 08:00:00 +0800

VSCode Copilot 配置指南

copilot chat 在本地运行可以用本地局域网的一些大模型推理 API 接口。通过设置 UI 模式决定让对应插件运行在服务器/本地。

注意：按需配置

1. 配置 UI 模式

ctrl+shift+p 打开命令面板搜索并且选中 Preferences: Open User Settings (JSON)。这将打开本地的 VSCode 设置文件 settings.json。
在本地 settings.json 文件中添加 extensionKind 参数 (参数文档)，添加需要本地运行的插件。

"remote.extensionKind": {
	"johnny-zhao.oai-compatible-copilot" : [ // 给copilot-chat配置自定义api接口的插件
		"ui"
	], 
	"github.copilot" : [ // copilot
		"ui"
	], 
	"github.copilot-chat": [ // copilot chat
		"ui"
	]
}

这里插件 ID 可以在插件商店选中插件右键复制

2. 配置第三方 API

copilot chat 可以通过插件与其它自行购买第三方的 API 兼容。例如，在 VSCode 安装 OAI Compatible Provider for Copilot 插件，仓库链接，可以直接在 VSCode 的插件商店下载。

2.1 获取 API 信息

下面以 ModelScope 社区的 API 接口为例：

在 ModelScope 社区的 个人主页->访问控制 里新建一个访问令牌

随后在模型库搜索需要的模型，支持推理 API 的就是可以使用 API 调用的模型

点击这个模型，进入这个模型的描述页面，右侧有 API 调用的接口，存在不同格式，按需选择。

查看代码范例，中有该模型接口的 base_url 和模型 ID 信息

2.2 配置插件信息

ctrl+shift+p 命令行搜索打开 OAICopilot: Open Configuration UI

添加供应方 (Provider)：需要填写 baseurl (上面出现的 base_url) 和 token (前面新建的访问令牌)，以及对应的 API 接口格式，例如 OpenAI 格式 (这里是查看代码范例时选择的格式)

添加模型：需要填写前面添加的 provider (可以自定义) 和模型 ID (上面出现的模型 ID)

目前插件支持 openai, openai-responses, ollama, anthropic, gemini 等多种格式，具体细节见插件仓库。

每个模型可以定义采样的 temperature、top_p、top_k 等参数，细节同见仓库。

2.3 使用模型

在 Copilot Chat 界面选择对应模型就可以使用对应模型的 Copilot Chat 了

实用工具 on huluhuluu

Hugging Face CLI 与 Codex Agent 使用备忘

Hugging Face CLI 与 Codex Agent 使用备忘

1. 安装

1.1 独立安装

2. 认证

3. 下载模型和数据集

3.1 下载完整仓库

3.2 只下载部分文件

3.3 下载数据集或 Space

4. 上传和仓库管理

4.1 创建仓库

4.2 上传文件

4.3 上传无法直连

5. Codex + Skill 模式

5.1 全局安装

5.2 项目内安装

5.3 更新 Skill

5.4 在 Codex 中使用

6. 常见命令

7. 其它补充

参考链接

cc-connect 接入微信个人号

cc-connect 接入微信个人号备忘

1. 安装配置

1.1 配置

1.2 使用

1.3 多工作区模式

参考链接

ccmanager 使用备忘

ccmanager 使用备忘

1. 安装和启动

1.1 配置

1.2 使用

参考链接

VSCode 预览插件组合备忘

VSCode 预览插件

1. Live Preview

2. Markdown 相关插件

参考链接

MeshCentral 使用备忘

MeshCentral 使用备忘

1. 整体思路

2. MeshCentral Server安装

2.1 安装 Node.js 和 npm

2.2 允许 Node 监听低端口

2.3 安装并启动

2.4 首次登录

3. Ubuntu 安装 Mesh Agent

4. Windows 机器安装 Mesh Agent

5. Android 浏览器访问

6. 网络模式说明

6.1 同一局域网

6.2 跨网络访问

参考链接

ttyd 使用备忘

ttyd 使用备忘

1. 准备 tmux

2. 准备 ttyd

2.1 安装

2.2 最小可用命令

3. Tailscale 控制连接

3.1 安装

3.2 网络连接

参考链接

Windows 本地命令库快速检索

Windows 本地命令库快速检索

1. 依赖

2. 脚本位置

2.1 默认查询目录

2.2 主脚本使用方式

2.3 调用 .cmd 启动器

2.4 fzf 内快捷键

3. Listary

3.1 设置命令

3.2 传 Listary 关键字给脚本

3.3 Listary 内快捷键

参考链接

Ubuntu Proxy Configuration

Ubuntu Proxy Configuration

2.3 调用 `.cmd` 启动器

2.4 `fzf` 内快捷键

3.2 传 `Listary` 关键字给脚本