在日常使用电脑的过程中，磁盘空间不足是一个常见的问题。传统的磁盘清理工具往往只能删除已知类型的临时文件或缓存，无法智能地识别哪些文件是真正可以安全删除的。AI Disk Cleaner 正是为了解决这个问题而诞生的 — 一款利用大语言模型（LLM）进行智能磁盘分析的开源工具。

项目简介

AI Disk Cleaner 是一款 AI 驱动的智能磁盘清理助手，通过 LLM 对磁盘文件树进行智能分析，自动识别可删除的垃圾文件，并以清晰的方式呈现分析结果。项目使用 Go 语言开发，基于 Wails 框架构建跨平台桌面应用。

核心功能

🤖 LLM 智能分析

利用大语言模型对磁盘占用情况进行分析，自动识别可以安全删除的垃圾文件，并汇总结果展示给用户。LLM 会遍历文件树，找出占用空间最大的文件，并判断其是否为可清理的垃圾。

📦 迁移管理

提供软链接的统一管理功能，支持一键将文件迁移到其他磁盘分区。这对于需要定期整理多磁盘存储的用户来说非常实用。

工作原理

AI Disk Cleaner 的整个架构分为三步：

1. 扫描文件树：使用 gdu 扫描指定位置，并将文件树加载到内存中。
2. LLM 分析：暴露文件树读取工具，让 LLM 分析文件树，找出占用空间最大的文件。在找到垃圾文件后，LLM 会调用 add_trash_file 工具来标记文件。
3. 结果展示：系统汇总 LLM 分析结果，以表格和可视化方式展示给用户。

快速开始

1. 从 Releases 页面下载最新版本的 .exe（目前仅支持 Windows）。
2. 将下载的 .exe 放在一个单独的文件夹中（应用启动后会在 exe 当前目录生成数据文件）。
3. 打开应用（推荐以管理员权限打开，否则某些删除或迁移操作可能会报错）。
4. 进入设置页面，配置大模型参数。
5. 回到首页，开始扫描。

技术栈

为什么选择 AI Disk Cleaner？

传统的磁盘清理工具依赖于预定义规则和文件扩展名匹配，容易误删重要文件或遗漏真正无用的文件。AI Disk Cleaner 的核心优势在于：

• 智能判断：LLM 能够理解文件的上下文和用途，做出更准确的删除建议
• 自然语言交互：用户可以通过自然语言与 LLM 交流，了解每个文件的详细信息
• 迁移便捷：软链接管理和一键迁移功能，让多磁盘管理变得简单高效

项目链接

• GitHub 仓库：vudsen/ai-disk-cleaner
• 许可证：MIT
• 当前版本：持续更新中

如果你正在寻找一款智能、高效的磁盘清理工具，AI Disk Cleaner 值得一试。

LaTeXSnipper 是由开发者 SakuraMathcraft 创建的一个跨平台桌面数学工作空间。它不再只是一个"截图公式转 LaTeX"工具，而是覆盖端到端数学内容工作流：

• 📸 从截图或 PDF 中识别数学公式
• ✍️ 在专用手写画布中书写并自动转换为 LaTeX
• 🧮 在集成数学工作台中编辑、计算和回写
• 🔄 支持 30+ 种导出格式（LaTeX、Markdown、MathML、HTML、Word、Typst 等）

项目亮点

安装教程

Windows（推荐）

方式一：Inno 安装包（推荐新手）

1. 前往 GitHub Releases 页面。
2. 下载 LaTeXSnipperSetup-2.4.0.exe。
3. 运行安装程序，按提示完成安装。
4. 桌面上生成快捷方式，双端启动。

方式二：Microsoft Store / MSIX

• 在 Microsoft Store 中搜索 LaTeXSnipper 进行安装。
• 或从 Release 页面下载 MSIX 包手动安装。

Linux

一键安装命令

1
2
3
4
5
6
7
8

git clone https://github.com/SakuraMathcraft/LaTeXSnipper.git
cd LaTeXSnipper

python3 -m venv .venv
source .venv/bin/activate

pip install -r requirements-linux.txt
python src/main.py

打包为 Debian/Ubuntu 安装包

1
2
3
4
5

# 构建 .deb 包
bash scripts/build_deb.sh

# 安装
sudo dpkg -i latexsnipper_*.deb

💡 Linux 平台依赖 grim、maim、gnome-screenshot 等截图工具来提升截图回退行为，这些工具需通过发行版包管理器自行安装，LaTeXSnipper 的依赖向导仅管理 Python 依赖层。

macOS

1
2
3
4
5
6
7
8

git clone https://github.com/SakuraMathcraft/LaTeXSnipper.git
cd LaTeXSnipper

python3 -m venv .venv
source .venv/bin/activate

pip install -r requirements-macos.txt
python src/main.py

macOS 打包产物为 .app.zip 和 .dmg，可从 Releases 页面下载。

更新 LaTeXSnipper

• Windows：下载新版安装包重新运行即可。
• GitHub Actions：Tag 发布时会自动构建各平台包，关注 Releases 页面获取最新版本。

快速开始

截图识别

1. 启动 LaTeXSnipper。
2. 点击截图按钮或使用快捷键捕获屏幕上的数学公式。
3. MathCraft OCR 自动识别公式并生成 LaTeX 代码。
4. 在右侧工作台中编辑、调整公式。
5. 点击"复制"或"插入"将 LaTeX 放回原文档。

手写识别

1. 打开手写窗口。
2. 使用鼠标或触控笔书写数学表达式。
3. 系统实时识别并预览 LaTeX 结果。
4. 确认后发送到主编辑器。

数学计算

在工作台中可直接对公式进行符号运算：

• 化简（Simplify）
• 数值求值（Evaluate）
• 展开（Expand）
• 因式分解（Factor）
• 求解方程（Solve）

对于更复杂的表达式，系统会自动回退到本地 SymPy/mpmath 引擎。

核心功能详解

多格式导出

LaTeXSnipper 支持 30 种导出格式：

离线优先

• 公式识别与高级求解均在本地运行，无需网络连接
• MathCraft OCR 模型通过 ONNX Runtime 推理，不依赖 PyTorch 运行时
• 所有数据保留在本地，保护学术与隐私敏感内容

项目结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

LaTeXSnipper/
├── mathcraft_ocr/          # MathCraft OCR 独立运行时与 CLI
├── src/
│   ├── main.py             # 主桌面应用入口
│   ├── distribution.py      # GitHub / Microsoft Store 渠道策略
│   ├── backend/            # OCR 封装、CUDA 诊断、截图、平台服务
│   ├── bootstrap/          # 依赖向导与运行时验证
│   ├── core/               # 文档组合、导出契约、重启契约
│   ├── editor/             # 数学工作台与公式编辑 UI
│   ├── handwriting/        # 手写画布、PDF 预览、文档工具
│   └── ...
├── requirements-linux.txt
├── requirements-macos.txt
├── LaTeXSnipper.spec       # PyInstaller 打包配置
├── Inno/                   # Windows Inno 安装脚本
├── packaging/debian/       # Debian 打包配置
└── scripts/
    ├── build_deb.sh        # Linux .deb 构建脚本
    ├── build_macos.sh      # macOS 打包脚本
    └── build_store_msix.ps1 # MSIX 打包脚本

技术栈

• 语言: Python 3.10+
• UI 框架: PyQt6 + Q Fluent Widgets
• OCR: MathCraft OCR（ONNX Runtime 推理）
• 公式编辑: MathLive math-field
• 符号计算: MathLive Compute Engine / SymPy / mpmath
• 构建: PyInstaller + Inno Setup (Windows) / PyInstaller + DMG (.macOS) / Debian (.Linux)
• 许可证: MIT License

适用场景

• 📝 学术写作：快速将论文中的手写公式或截图公式转为 LaTeX
• 📚 教学课件：从 PDF 或幻灯片中提取数学公式并复用
• 💻 Office 集成：通过 Word/PowerPoint 插件在文档中直接插入识别公式
• 🔬 科研工作：将文献中的公式离线转换为可编辑的 LaTeX 代码
• ✍️ 手写输入：使用笔输入数学表达式，实时预览 LaTeX

项目统计

• GitHub Stars: ⭐ 760
• Forks: 40
• 提交数: 332
• 最新版本: v2.4.0 LTS（2026年7月）
• 许可证: MIT License
• 项目地址: https://github.com/SakuraMathcraft/LaTeXSnipper

总结

LaTeXSnipper 是一个功能完整、离线优先的数学公式识别与编辑工作空间。它覆盖了从截图识别、手写输入到公式计算和多格式导出的完整工作流，特别适合需要频繁处理数学公式的学术工作者和科研人员。Windows 用户可以通过 Inno 安装包一键安装，Linux 和 macOS 用户也可以通过源码快速运行。作为一个开源免费无广告的项目，其持续维护和社区活跃度值得肯定。

项目地址: https://github.com/SakuraMathcraft/LaTeXSnipper

dnspick 是由开发者 palemoky 创建的一个跨平台命令行 DNS 性能测试工具。它并发基准测试一批主流及自定义 DNS 服务器，涵盖 UDP、DNS-over-TLS (DoT)、DNS-over-HTTPS (DoH) 和 DNS-over-HTTP/3 (DoH3) 四种协议，对一组常用的国内/国外域名反复查询，结合平均延迟与成功率给出综合评分，同时自动检测当前系统默认 DNS 并纳入对比，最后推荐最优选择。

项目亮点

• 🌐 跨平台：完美运行于 Windows、macOS、Linux、Raspberry Pi (ARM/ARM64) 等主流平台
• 🔒 多协议：同时测试 UDP、DoT、DoH（RFC 8484）、DoH3（基于 QUIC）
• 📊 综合评分：不仅测速，还结合成功率智能打分，避免"虽快但不稳定"的 DNS 跻身前列
• 🔍 自动检测当前 DNS：自动探测系统默认 DNS 并参与对比，给出是否需要切换的建议
• 🔄 自更新：运行时自动检查新版本，交互式终端中可原地升级
• 🌏 中英双语界面：默认跟随系统 LANG，支持手动切换

安装教程

一键安装（推荐）

脚本会自动检测操作系统与 CPU 架构，下载对应版本并安装到 PATH。

Linux / macOS

1

curl -fsSL https://raw.githubusercontent.com/palemoky/dnspick/main/install.sh | sh

Windows（PowerShell）

1

irm https://raw.githubusercontent.com/palemoky/dnspick/main/install.ps1 | iex

💡 macOS 用户无需手动处理 Gatekeeper 拦截，脚本会自动解除隔离标记。

手动安装

你也可以从 GitHub Releases 页面下载预编译版本。

1. 前往最新 Release 页面。
2. 根据你的操作系统和 CPU 架构下载对应压缩包（如 dnspick-windows-amd64.zip、dnspick-linux-arm64.tar.gz）。
3. 解压后即可在终端中使用。

建议将可执行文件移动到系统 PATH 包含的目录中：

1
2
3
4
5

# Linux / macOS
sudo mv dnspick /usr/local/bin/

# Windows（PowerShell，以管理员权限运行）
Move-Item dnspick.exe C:\Windows\System32\

更新 dnspick

随时原地升级到最新版本：

1

dnspick update

dnspick 运行时会在后台检查新版本。在交互式终端中发现新版本会自动原地更新；输出被管道接管或在 CI 中则只打印提示（不会自我修改）。该检查不阻塞主流程，离线时静默跳过。

macOS 提示「已损坏 / 移动到垃圾桶」

由于 dnspick 未经过 Apple 付费公证，macOS Gatekeeper 会拦截从网络下载的程序，出现「无法验证开发者」「已损坏，应移到废纸篓」等提示。文件并非真正损坏，任选以下方式解除即可：

1
2

# 推荐：解除下载隔离标记（一行搞定）
xattr -dr com.apple.quarantine ./dnspick

• 图形界面方式：在访达中右键点击 → 选择「打开」→ 弹窗中再次确认「打开」
• 较新 macOS：双击运行一次（会被拦截），然后到 系统设置 → 隐私与安全性，点击底部「仍要打开」

快速开始

直接运行即可开始测试：

1

dnspick

输出示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

dnspick: benchmarking 33 DNS servers against 20 domains...

Progress: 45% (594/1320)
┌──────────────┬────────┬────────────────┬────────┐
│   Domestic   │ Status │    Foreign     │ Status │
├──────────────┼────────┼────────────────┼────────┤
│ baidu.com    │ ✔      │ google.com     │ ✔      │
│ qq.com       │ ✔      │ youtube.com    │ 60%    │
│ taobao.com   │ 60%    │ github.com     │ -      │
└──────────────┴────────┴────────────────┴────────┘

--- Benchmark Results ---
┌────┬───────────────────────┬─────────────────┬─────────────┬────────────────┬────────┐
│ #  │      DNS Server       │     Address     │ Avg Latency │  Success Rate  │ Score  │
├────┼───────────────────────┼─────────────────┼─────────────┼────────────────┼────────┤
│ 1  │ Freenom 2 (UDP)       │ 80.80.81.81     │ 6.16ms      │ 100.0% (40/40) │ 162.33 │
│ 2  │ Cloudflare 2 (UDP)    │ 1.0.0.1         │ 6.227ms     │ 100.0% (40/40) │ 160.58 │
│ 3  │ DNSPod 1 (UDP)        │ 119.28.28.28   │ 6.337ms     │ 100.0% (40/40) │ 157.80 │
└────┴───────────────────────┴─────────────────┴─────────────┴────────────────┴────────┘

--- Top 3 Recommendations ---
#1: Freenom 2 (UDP) (80.80.81.81)
    Score: 162.33, avg latency: 6.16ms, success rate: 100.0%
#2: Cloudflare 2 (UDP) (1.0.0.1)
    Score: 160.58, avg latency: 6.227ms, success rate: 100.0%
#3: DNSPod 1 (UDP) (119.28.28.28)
    Score: 157.80, avg latency: 6.337ms, success rate: 100.0%

高级用法

自定义测试参数

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 查看所有可用参数
dnspick --help

# 每个域名查询 5 次，使用自定义域名列表
dnspick -q 5 -d "google.com,github.com,youtube.com"

# 单次查询超时 1 秒，并发数降到 8
dnspick -t 1s -c 8

# 强制使用英文界面
dnspick --lang en

# 输出机器可读 JSON（适合脚本和 CI）
dnspick --json | jq '.recommendation.top'

JSON 输出（用于自动化）

1

dnspick --json | jq '.recommendation.top'

JSON 输出的关键字段：

综合评分计算方式

综合评分 = (1 / 平均延迟秒数) × 成功率²

• 延迟项 1 / 平均延迟：延迟越低，分数越高，呈反比放大
• 可靠性权重 成功率²：成功率做平方惩罚，对丢包/超时非常敏感。100% 成功率乘以 1.0，90% 只剩 0.81，50% 直接砍到 0.25

这样可以避免"延迟很低但偶尔解析失败"的 DNS 排到前面。

技术细节

• 语言: Go 1.21+
• 许可证: MIT License
• 构建: GitHub Actions 跨平台自动构建，支持 Windows、macOS、Linux（含 ARM/ARM64）
• 当前版本: 持续更新中，266+ GitHub 星标
• 仓库: palemoky/dnspick

适用场景

• 🏠 家庭用户：检测 ISP 提供的 DNS 是否足够快，探索更快的公共 DNS
• 🏢 网络管理员：批量评估不同 DNS 解析器的性能，为企业网络选型
• 📊 开发者：在 CI/CD 中集成 DNS 性能监控，确保解析质量
• 🌍 跨境访问优化：对比国内外 DNS 对不同域名的解析延迟，找到最优搭配

总结

dnspick 是一个轻量但功能完整的 DNS 性能测试工具，支持四种主流 DNS 协议（UDP、DoT、DoH、DoH3），提供智能综合评分和自动当前 DNS 检测。其一键安装脚本大大降低了使用门槛，macOS 用户也不必担心 Gatekeeper 拦截（脚本自动处理）。如果你正在寻找一款能帮你选出最优 DNS 的工具，dnspick 值得一试。

项目地址: https://github.com/palemoky/dnspick

什么是桌面环境？

桌面环境（Desktop Environment，简称 DE）是提供图形用户界面交互体验的整套组件集合，包括窗口管理器、面板、菜单、系统设置、文件管理器及配套应用。不同的桌面环境在性能、美观度、可定制性上各有侧重。

各桌面环境速览对比

1. GNOME

GNOME 是当今最流行的 Linux 桌面环境之一，被 Ubuntu、Fedora、Debian 等主流发行版采用。它以简洁、现代化的设计和键盘驱动的工作流著称。

优势

• 现代化的交互设计：通过 Activities 概览和多工作区管理，提供流畅的任务切换体验
• 强大的扩展生态：通过 GNOME Shell Extensions（extensions.gnome.org）可以大幅扩展功能
• 出色的无障碍支持：内置屏幕阅读器、高对比度主题等无障碍功能
• 稳定性和一致性：严格的 UI/UX 设计规范保证了统一的用户体验

劣势

• 资源占用较高：默认情况下需要至少 4GB 内存才能流畅运行
• 原生定制能力有限：许多自定义需求依赖第三方扩展，扩展可能因版本更新而失效
• 学习曲线：与传统桌面布局差异较大，新用户需要适应

安装方法

1
2
3
4
5
6
7
8

# Ubuntu/Debian
sudo apt install gnome gnome-shell ubuntu-gnome-desktop

# Fedora（已默认安装）
sudo dnf groupinstall "GNOME Desktop Environment"

# Arch Linux
sudo pacman -S gnome gnome-extra

2. KDE Plasma

KDE Plasma 是一款功能极其丰富、可定制性极高的桌面环境，基于 Qt 工具包开发。它既有惊艳的视觉效果，又在 Plasma 6 中实现了令人惊讶的轻量级表现。

优势

• 无与伦比的定制性：从面板、小部件到窗口装饰，几乎每个像素都可以自定义
• 功能丰富：内置大量实用的 KDE 应用套件（Dolphin 文件管理器、Konsole 终端等）
• 轻量级表现：Plasma 6 优化出色，资源占用远低于预期
• KDE Connect：与手机无缝集成，支持通知同步、文件传输、远程输入等
• 多平台支持：除 Linux 外，还支持 BSD、乃至 Windows/macOS

劣势

• 选项过多：大量的设置项可能让新用户感到不知所措
• 默认配置不够精简：开箱即用的体验需要一些调整才能达到理想状态
• Wayland 过渡期：虽然 Plasma 6 已全面转向 Wayland，部分应用仍存在兼容性问题

安装方法

1
2
3
4
5
6
7
8

# Ubuntu/Kubuntu
sudo apt install kde-plasma-desktop plasma-workspace

# Fedora
sudo dnf groupinstall "KDE Plasma Workspaces"

# Arch Linux
sudo pacman -S plasma plasma-desktop plasma-wayland-session kde-applications

3. Xfce

Xfce 是一款经典的轻量级桌面环境，在性能与功能之间取得了绝佳平衡。它特别适合老旧硬件或追求极致效率的用户。

优势

• 极低的资源占用：512MB 内存即可流畅运行
• 稳定可靠：开发节奏稳健，每个版本都经过充分测试
• 高度可配置：虽然没有 KDE 那样丰富的选项，但足以满足大多数需求
• 优秀的远程体验：轻量特性使其在远程桌面和虚拟机中表现出色
• 良好的模块化设计：组件可以独立升级和替换

劣势

• 视觉风格传统：默认外观较为朴素，缺少现代化特效
• Wayland 支持滞后：直到 4.20 版本才开始实验性支持 Wayland
• 内置应用较少：相比 GNOME 和 KDE，Xfce 自带的配套应用较为基础

安装方法

1
2
3
4
5
6
7
8

# Ubuntu/Xubuntu
sudo apt install xfce4 xfce4-goodies

# Fedora
sudo dnf groupinstall "Xfce Desktop"

# Arch Linux
sudo pacman -S xfce4 xfce4-goodies

4. Cinnamon

Cinnamon 是 Linux Mint 团队从 GNOME 3 分支开发的桌面环境，旨在提供传统、熟悉且具有现代功能的桌面体验。它是 Linux Mint 旗舰版默认的桌面环境。

优势

• 熟悉的传统布局：底部面板 + 应用菜单的布局对 Windows 用户非常友好
• 开箱即用的体验：Linux Mint 对 Cinnamon 进行了大量优化，上手即用
• Applets 和 Desklets：丰富的桌面小程序扩展生态
• 稳定的 GTK 主题兼容性：主题和图标主题的支持非常完善
• Spices 在线商店：可通过图形界面直接安装扩展、主题和 applet

劣势

• 生态相对独立：主要围绕 Linux Mint 生态发展，其他发行版上的体验可能不如 Mint 完善
• 资源占用中等：相比 Xfce 和 LXQt，对内存的要求更高
• Wayland 支持进展缓慢：Cinnamon 目前仍以 X11 为主要显示服务器

安装方法

1
2
3
4
5
6
7
8

# Ubuntu
sudo apt install cinnamon cinnamon-desktop-environment

# Fedora
sudo dnf install @cinnamon-desktop-environment

# Arch Linux
sudo pacman -S cinnamon cinnamon-translations

5. MATE

MATE 是 GNOME 2 的延续，保留了经典的桌面交互范式。它既轻量又功能完整，是追求传统桌面体验用户的绝佳选择。

优势

• 与 GNOME 2 一脉相承：保留了经典的底部面板、应用菜单和桌面图标
• 轻量高效：资源占用低于 Cinnamon，接近 Xfce 水平
• 功能完善：提供完整的配套应用（Caja 文件管理器、Pluma 文本编辑器等）
• 良好的兼容性：与大多数 GTK 应用完美配合

劣势

• 设计语言略显老旧：界面现代感不足，缺少动画和视觉特效
• 开发资源有限：维护团队规模较小，新功能开发速度较慢
• Wayland 支持有限：目前仍主要运行在 X11 上

安装方法

1
2
3
4
5
6
7
8

# Ubuntu/Ubuntu MATE
sudo apt install ubuntu-mate-desktop mate-desktop-environment

# Fedora
sudo dnf groupinstall "MATE Desktop"

# Arch Linux
sudo pacman -S mate mate-extra

6. LXQt

LXQt 是 LXDE 的下一代产品，将 LXDE 的轻量理念与 Qt 工具包的现代特性相结合。它是资源受限设备或追求极简体验用户的最佳选择。

优势

• 极致的轻量级：最低只需 512MB 内存即可运行，CPU 占用极低
• 现代化的 Qt 技术栈：相比基于 GTK 2 的旧版 LXDE，LXQt 拥有更现代的代码基础
• 模块化设计：每个组件都可以独立替换
• Wayland 支持积极：自 2.3.0 版本起，Wayland 会话已不再是实验性功能

劣势

• 功能较为基础：内置应用和功能远不如 KDE 或 GNOME 丰富
• 视觉效果简约：默认外观较为朴素
• 应用生态有限：专门为 LXQt 开发的应用较少

安装方法

1
2
3
4
5
6
7
8

# Ubuntu/Lubuntu
sudo apt install lxqt lxqt-core sddm

# Fedora
sudo dnf groupinstall "LXQt Desktop"

# Arch Linux
sudo pacman -S lxqt xdg-utils

7. Budgie

Budgie 是一款强调简洁、现代和优雅的独立桌面环境，最初为 Solus 发行版开发，现在已可在多款主流发行版中使用。其设计核心理念是"让桌面不打扰用户"。

优势

• 简洁优雅的设计：界面干净清爽，没有多余元素
• Raven 侧边栏：集成了通知中心、日历、媒体控制和系统设置
• 多布局支持：可轻松切换为类 macOS、Windows 或 Unity 布局
• 基于成熟的 GNOME 技术栈：稳定性有保障

劣势

• 开发团队规模较小：更新频率低于 GNOME 和 KDE
• 扩展生态有限：相比 GNOME 和 KDE，可用的 applet 较少
• 独立发行版支持差异大：不同发行版上的体验和默认配置差异明显

安装方法

1
2
3
4
5
6
7
8

# Ubuntu/Ubuntu Budgie
sudo apt install ubuntu-budgie-desktop budgie-desktop

# Fedora
sudo dnf install @budgie-desktop-environment

# Arch Linux
sudo pacman -S budgie-desktop budgie-desktop-view

8. Deepin DDE

Deepin DDE（Deepin Desktop Environment）是由武汉深之度科技有限公司开发的桌面环境，以其精致美观的 UI 设计闻名。它在视觉体验上可与 macOS 和 Windows 11 媲美，是追求美观用户的理想选择。

优势

• 极致的视觉设计：统一的圆角设计语言、毛玻璃效果和流畅动画
• 深度自研的 DTK 开发框架：提供了统一的应用开发接口
• 内置丰富的自研应用：深度影院、深度音乐、深度截图等超过 40 款应用
• 友好的中文支持：对中文用户和中文输入法有极佳的原生支持

劣势

• 资源占用较高：精美的视觉效果需要较强的硬件支持
• 安全风险关注：openSUSE 安全团队曾指出 DDE 存在安全文化缺失的问题
• 主流发行版支持有限：除 Deepin OS 外，其他发行版上的体验可能不够完美
• 国际化程度较低：除中文外，其他语言的本地化质量参差不齐

安装方法

1
2
3
4
5
6
7
8
9
10

# Ubuntu/UbuntuDDE
sudo add-apt-repository ppa:ubuntudde-dev/stable
sudo apt update
sudo apt install ubuntudde-dde

# Arch Linux
sudo pacman -S deepin deepin-extra deepin-kwin

# Fedora（需要添加第三方仓库）
sudo dnf install dde-control-center dde-dock dde-launcher deepin-desktop

如何选择适合你的桌面环境？

注意事项

1. 虚拟机先行：如果想尝鲜新的桌面环境，建议先在虚拟机中测试，避免影响主力系统
2. 多桌面环境共存问题：在同一系统上安装多个桌面环境可能导致主题和设置冲突，建议使用不同的显示管理器来隔离
3. 卸载不彻底的风险：移除一个桌面环境时，依赖关系可能导致系统组件被意外删除，建议使用专门的元包管理工具来处理
4. Wayland 与 X11 的选择：较新的桌面环境（GNOME、KDE Plasma 6）已全面支持 Wayland，但 X11 在某些场景下（如屏幕共享）仍有兼容性优势

总结

Linux 桌面环境的丰富多样性是其独特魅力的重要组成部分。无论你是追求极致性能、钟情于精美视觉、还是热衷于深度定制，总有一款桌面环境适合你。这种选择的自由正是 Linux 生态无可替代的核心优势之一。

最重要的是，你不必从一而终——随时可以切换和尝试不同的桌面环境，找到最适合你工作流程和个人偏好的方案。

参考资料：

• GNOME 官方网站
• KDE Plasma 官方网站
• Xfce 官方网站
• Linux Mint / Cinnamon
• MATE 桌面环境
• LXQt 项目
• Buddies of Budgie
• Deepin 社区

What Is a Desktop Environment?

A Desktop Environment (DE) is a complete set of components that provide the graphical user interface experience, including the window manager, panels, menus, system settings, file manager, and bundled applications. Different desktop environments emphasize performance, aesthetics, and customizability to varying degrees.

Quick Comparison

1. GNOME

GNOME is one of the most popular Linux desktop environments today, used by mainstream distributions such as Ubuntu, Fedora, and Debian. It is known for its clean, modern design and keyboard-driven workflow.

Pros

• Modern interaction design: the Activities overview and multiple workspaces provide a smooth task-switching experience
• Powerful extension ecosystem: GNOME Shell Extensions (extensions.gnome.org) can greatly expand functionality
• Excellent accessibility support: built-in screen reader, high-contrast themes, and more
• Stability and consistency: strict UI/UX design guidelines ensure a unified experience

Cons

• Higher resource usage: needs at least 4GB of RAM to run smoothly by default
• Limited native customization: many customizations rely on third-party extensions that may break with version updates
• Learning curve: differs significantly from traditional desktop layouts, so new users need time to adapt

Installation

1
2
3
4
5
6
7
8

# Ubuntu/Debian
sudo apt install gnome gnome-shell ubuntu-gnome-desktop

# Fedora (installed by default)
sudo dnf groupinstall "GNOME Desktop Environment"

# Arch Linux
sudo pacman -S gnome gnome-extra

2. KDE Plasma

KDE Plasma is an extremely feature-rich and highly customizable desktop environment built on the Qt toolkit. It offers stunning visuals while achieving surprisingly lightweight performance in Plasma 6.

Pros

• Unmatched customization: from panels and widgets to window decorations, almost every pixel can be customized
• Feature-rich: bundled with a large suite of useful KDE applications (Dolphin file manager, Konsole terminal, etc.)
• Lightweight performance: Plasma 6 is well optimized, with resource usage far lower than expected
• KDE Connect: seamless phone integration for notification sync, file transfer, remote input, and more
• Multi-platform support: beyond Linux, it also supports BSD and even Windows/macOS

Cons

• Too many options: the sheer number of settings can overwhelm new users
• Default configuration isn’t minimal: the out-of-the-box experience needs some tweaking to feel ideal
• Wayland transition: although Plasma 6 has fully moved to Wayland, some apps still have compatibility issues

Installation

1
2
3
4
5
6
7
8

# Ubuntu/Kubuntu
sudo apt install kde-plasma-desktop plasma-workspace

# Fedora
sudo dnf groupinstall "KDE Plasma Workspaces"

# Arch Linux
sudo pacman -S plasma plasma-desktop plasma-wayland-session kde-applications

3. Xfce

Xfce is a classic lightweight desktop environment that strikes an excellent balance between performance and features. It is especially suited to older hardware or users who want maximum efficiency.

Pros

• Very low resource usage: runs smoothly with just 512MB of RAM
• Stable and reliable: a steady development pace with each release thoroughly tested
• Highly configurable: not as rich as KDE, but enough for most needs
• Great remote experience: its lightweight nature shines in remote desktops and virtual machines
• Good modular design: components can be upgraded and replaced independently

Cons

• Traditional visual style: the default look is plain and lacks modern effects
• Lagging Wayland support: experimental Wayland support only started in version 4.20
• Fewer bundled apps: compared to GNOME and KDE, Xfce’s bundled applications are more basic

Installation

1
2
3
4
5
6
7
8

# Ubuntu/Xubuntu
sudo apt install xfce4 xfce4-goodies

# Fedora
sudo dnf groupinstall "Xfce Desktop"

# Arch Linux
sudo pacman -S xfce4 xfce4-goodies

4. Cinnamon

Cinnamon is a desktop environment developed by the Linux Mint team as a fork of GNOME 3, aiming to provide a traditional, familiar desktop with modern features. It is the default desktop environment of the Linux Mint flagship edition.

Pros

• Familiar traditional layout: the bottom panel + application menu layout is very friendly to Windows users
• Out-of-the-box experience: Linux Mint has heavily optimized Cinnamon for immediate use
• Applets and Desklets: a rich ecosystem of desktop mini-programs
• Stable GTK theme compatibility: excellent support for themes and icon themes
• Spices online store: install extensions, themes, and applets directly through a GUI

Cons

• Relatively isolated ecosystem: developed mainly around the Linux Mint ecosystem, so the experience on other distributions may not be as polished
• Medium resource usage: requires more memory than Xfce and LXQt
• Slow Wayland progress: Cinnamon still uses X11 as its primary display server

Installation

1
2
3
4
5
6
7
8

# Ubuntu
sudo apt install cinnamon cinnamon-desktop-environment

# Fedora
sudo dnf install @cinnamon-desktop-environment

# Arch Linux
sudo pacman -S cinnamon cinnamon-translations

5. MATE

MATE is the continuation of GNOME 2, preserving the classic desktop interaction paradigm. It is both lightweight and fully featured — an excellent choice for users who want a traditional desktop experience.

Pros

• A direct descendant of GNOME 2: keeps the classic bottom panel, application menu, and desktop icons
• Lightweight and efficient: lower resource usage than Cinnamon, close to Xfce levels
• Full-featured: provides a complete set of bundled apps (Caja file manager, Pluma text editor, etc.)
• Good compatibility: works perfectly with most GTK applications

Cons

• Slightly dated design language: the interface lacks a modern feel, animations, and visual effects
• Limited development resources: a small maintenance team means slower new-feature development
• Limited Wayland support: still runs mainly on X11

Installation

1
2
3
4
5
6
7
8

# Ubuntu/Ubuntu MATE
sudo apt install ubuntu-mate-desktop mate-desktop-environment

# Fedora
sudo dnf groupinstall "MATE Desktop"

# Arch Linux
sudo pacman -S mate mate-extra

6. LXQt

LXQt is the next generation of LXDE, combining LXDE’s lightweight philosophy with the modern features of the Qt toolkit. It is the best choice for resource-constrained devices or users who want a minimal experience.

Pros

• Extremely lightweight: runs with as little as 512MB of RAM and very low CPU usage
• Modern Qt stack: a more modern codebase than the GTK 2-based older LXDE
• Modular design: every component can be replaced independently
• Active Wayland support: since version 2.3.0, the Wayland session is no longer experimental

Cons

• Fairly basic features: bundled apps and features are far less rich than KDE or GNOME
• Minimal visuals: the default look is plain
• Limited app ecosystem: few applications are developed specifically for LXQt

Installation

1
2
3
4
5
6
7
8

# Ubuntu/Lubuntu
sudo apt install lxqt lxqt-core sddm

# Fedora
sudo dnf groupinstall "LXQt Desktop"

# Arch Linux
sudo pacman -S lxqt xdg-utils

7. Budgie

Budgie is a standalone desktop environment emphasizing simplicity, modernity, and elegance. Originally developed for the Solus distribution, it is now available on several mainstream distributions. Its core design philosophy is to “let the desktop stay out of the user’s way.”

Pros

• Clean, elegant design: a tidy interface with no clutter
• Raven sidebar: integrates the notification center, calendar, media controls, and system settings
• Multiple layout support: easily switch to macOS-, Windows-, or Unity-like layouts
• Built on the mature GNOME stack: stability is assured

Cons

• Small development team: updates are less frequent than GNOME and KDE
• Limited extension ecosystem: fewer applets available than GNOME and KDE
• Varied support across distributions: the experience and default configuration differ noticeably between distributions

Installation

1
2
3
4
5
6
7
8

# Ubuntu/Ubuntu Budgie
sudo apt install ubuntu-budgie-desktop budgie-desktop

# Fedora
sudo dnf install @budgie-desktop-environment

# Arch Linux
sudo pacman -S budgie-desktop budgie-desktop-view

8. Deepin DDE

Deepin DDE (Deepin Desktop Environment) is developed by Wuhan Deepin Technology, known for its refined and beautiful UI design. Its visual experience rivals macOS and Windows 11, making it an ideal choice for users who value aesthetics.

Pros

• Exquisite visual design: a unified rounded-corner design language, frosted-glass effects, and smooth animations
• In-house DTK development framework: provides a unified application development interface
• Rich bundled in-house apps: over 40 apps including Deepin Movie, Deepin Music, and Deepin Screenshot
• Friendly Chinese support: excellent native support for Chinese users and input methods

Cons

• Higher resource usage: the beautiful visuals require stronger hardware
• Security concerns: the openSUSE security team has pointed out a lack of security culture in DDE
• Limited support on mainstream distributions: outside Deepin OS, the experience may not be perfect
• Lower level of internationalization: outside Chinese, localization quality varies

Installation

1
2
3
4
5
6
7
8
9
10

# Ubuntu/UbuntuDDE
sudo add-apt-repository ppa:ubuntudde-dev/stable
sudo apt update
sudo apt install ubuntudde-dde

# Arch Linux
sudo pacman -S deepin deepin-extra deepin-kwin

# Fedora (requires a third-party repository)
sudo dnf install dde-control-center dde-dock dde-launcher deepin-desktop

How to Choose the Right Desktop Environment

Things to Keep in Mind

1. Try it in a VM first: to test a new desktop environment, use a virtual machine first to avoid affecting your main system
2. Coexistence issues: installing multiple desktop environments on one system can cause theme and setting conflicts; use different display managers to isolate them
3. Incomplete uninstall risk: removing a desktop environment may accidentally delete system components due to dependencies; use dedicated meta-package management tools
4. Wayland vs. X11: newer desktop environments (GNOME, KDE Plasma 6) fully support Wayland, but X11 still has compatibility advantages in some scenarios (such as screen sharing)

Conclusion

The rich diversity of Linux desktop environments is a big part of its unique appeal. Whether you chase peak performance, love beautiful visuals, or are passionate about deep customization, there is a desktop environment for you. This freedom of choice is one of the irreplaceable core strengths of the Linux ecosystem.

Most importantly, you don’t have to commit to one forever — you can switch and experiment at any time to find what best fits your workflow and personal preferences.

References:

• GNOME Official Site
• KDE Plasma Official Site
• Xfce Official Site
• Linux Mint / Cinnamon
• MATE Desktop
• LXQt Project
• Buddies of Budgie
• Deepin Community

在日常开发和运维工作中，网络诊断工具几乎是每个人的必备品。但手机上能用的网络工具类 App 往往功能单一——有的只能 Ping，有的只能查 IP，很难找到一个能覆盖大部分网络诊断场景的集成工具。

IPtools（网络工具箱） 正是为解决这个痛点而生的开源 Android 应用。

项目地址：https://github.com/xin-521/IPtools

一、项目概览

IPtools 是一个纯 Kotlin 开发的 Android 网络工具集合应用，代码包名为 org.zeroxin.iptools，应用名称为"网络工具箱"。它把开发者/运维人员日常使用频率最高的网络诊断功能整合到一个 App 中，覆盖从基础连通性测试到高级端口扫描的完整链路。

当前版本 v1.1，目标 SDK 34（Android 14），最低支持 Android 7.0（API 24）。

为什么值得关注？

如果你是 Android 开发者，这个项目的代码质量、架构选型和技术栈都是一份很好的 MVVM + Hilt + Room + DataStore 参考实现。如果你只是用户，它可以替代手机上多个单一功能的网络工具。

二、完整功能清单

IPtools 内置了 13 项网络工具，分为基础工具和高级工具两大类。

基础网络工具（日常诊断）

高级网络工具（深度诊断）

辅助功能

• IP 地图：在 Leaflet WebView 地图上可视化显示 IP 位置
• 设置面板：自定义 Ping 参数、扫描并发数、测速 URL、主题模式（亮色/暗色）
• 历史记录和收藏：使用 Room 数据库保存查询历史和收藏，方便重复使用

三、技术栈与架构分析

从 Android 开发角度看，IPtools 的技术选型是现代 Android 开发的典型范本。

整体架构：MVVM

1

View (Fragment) → ViewModel → Repository → DataSource (Room/OkHttp/DataStore)

• View 层：基于 Android View System（XML 布局 + ViewBinding），使用 BottomNavigationView 构建底部导航
• 导航：Navigation Component + nav_graph.xml 集中管理 Fragment 路由
• ViewModel：每个工具对应一个 ViewModel，持有协程作用域，通过 LiveData 向 UI 层暴露状态
• Data 层：Room 数据库（query_history + favorites 两张表）、Jetpack DataStore（用户设置持久化）、OkHttp/Retrofit（网络 API）

关键技术组件

值得关注的代码细节

1. 依赖注入设计的 ToolModule：所有工具类（PingTool、PortScanner、TracerouteTool 等）均注册为 @Singleton，由 Hilt 统一管理生命周期。

2. PortScanner 的分批并行扫描：全端口扫描时按 100 端口一批分组，每组内通过 async/awaitAll 并发扫描，兼顾速度与资源控制。

3. PingTool 的双层策略：优先使用 Java InetAddress.isReachable() 实现跨平台兼容，同时保留 pingWithSystem() 回退到系统原生 ping -c 命令获取更准确的 ICMP 结果。

4. LanScanner 的 OUI 识别：内置了 Apple、小米、华为、三星、Raspberry Pi、Espressif（乐鑫）、TP-Link 等主流厂商的 MAC OUI 数据库，无需联网即可识别设备厂商。

5. IP 后端 API：使用 https://my.ippure.com/v1/info 作为 IP 查询接口（非 ip-api.com），说明开发者拥有独立的后端能力。

项目结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

app/src/main/
├── java/org/zeroxin/iptools/
│   ├── data/               # Room 数据库（DAO、Entity）
│   ├── di/                 # Hilt 依赖注入模块
│   ├── model/              # 数据模型（IpInfo, PingResult, PortScanResult 等）
│   ├── network/            # 网络 API 服务（IpApiService）
│   ├── ui/
│   │   └── fragment/       # 所有 Fragment 界面
│   ├── util/               # 工具类（PingTool, PortScanner 等 14 个）
│   ├── viewmodel/          # 各页面的 ViewModel
│   ├── IpToolsApplication.kt
│   └── MainActivity.kt
├── res/
│   ├── layout/             # XML 布局文件
│   ├── drawable/           # 图标资源
│   ├── values/             # 字符串、颜色、主题
│   └── navigation/         # Navigation 导航图
└── AndroidManifest.xml

四、安装与构建

直接安装

这是 Android 原生应用，需要下载 APK 文件安装到 Android 设备上。请在项目的 GitHub Releases 页面 查看是否有已构建的 APK。

自行构建

如果你有 Android 开发环境，可以自行编译：

环境要求：

• Android Studio Arctic Fox 或更高版本
• JDK 11+
• Android SDK 34

构建步骤：

1
2
3
4
5

git clone https://github.com/xin-521/IPtools.git
# 使用 Android Studio 打开项目
# 同步 Gradle 依赖
# 点击 Run 或运行：
./gradlew assembleDebug

构建产物为 app/build/outputs/apk/ 目录下的 NetworkTools-1.1-debug.apk。

所需权限

App 仅申请网络相关的最基本权限：

• INTERNET — 网络访问
• ACCESS_NETWORK_STATE — 查看网络状态
• ACCESS_WIFI_STATE — 查看 WiFi 信息
• CHANGE_WIFI_STATE — 修改 WiFi 状态（WOL 功能需要）
• CHANGE_NETWORK_STATE — 修改网络状态

未申请任何敏感权限（如位置、相机、存储），隐私保护做得比较干净。

五、适用场景

IPtools 的核心用户群体很明确——开发者、运维人员、网工和 IT 爱好者。

典型使用场景包括：

• 日常网络排查：检查本机 IP、Ping 目标、路由追踪定位丢包节点
• 内网运维：局域网扫描发现设备、端口扫描检查服务暴露情况、SSH 直连服务器
• 域名管理：DNS 查询验证解析记录、Whois 查询域名注册信息、DNS 基准测试选最快的 DNS
• 网络规划：子网计算器快速计算 CIDR 范围、广播地址
• 远程管理：Wake-on-LAN 开机、SSH 远程维护

六、总结

IPtools 的价值在于"集成"二字。当手机上一个 App 就能完成 Ping、端口扫描、路由追踪、Whois、SSH 等一系列操作时，工作效率的提升是很明显的。从工程角度看，它的代码质量在线——MVVM 架构清晰，Hilt + Room + DataStore 的选型符合当前 Android 开发主流标准，工具类的设计和并发控制也有值得参考的地方。

如果你需要一款全功能的网络诊断 App，或者正在学习 Android 开发中的 MVVM + Hilt 实践，这个项目都值得看一看。

如果你最近在关注“AI + 开发”的新形态，Arkain 是一个值得试试的平台：它把 CDE（Cloud Development Environment，云开发环境） 与 AI 能力结合起来，目标是让你更快把想法变成可运行的应用。

本文简单介绍 Arkain 平台，并把它的邀请奖励（Referral）机制用更清晰的方式整理出来，方便你在注册前快速了解“能拿到多少 credits、什么时候发放、需要满足什么条件”。

Arkain 是什么？

容器平台：填写邀请码获得300Credit，想体验容器服务可以一试

官方介绍是：

Try Arkain, an AI-powered CDE where apps come to life effortlessly.

你可以把它理解为一个偏“产品化”的云端开发环境：无需在本地折腾环境，也更容易把“写代码—运行—迭代—部署”的链路串起来，适合做原型、做小工具、做快速验证，或者在多设备之间无缝切换开发状态。

邀请奖励怎么拿？核心结论

Arkain 的邀请奖励会同时发放给 邀请人（Referrer） 和 被邀请人（Referred Friend），并且分为两步：

Step 1：好友通过邀请链接注册

• 好友：+300 credits（即时发放）
• 你：+300 credits（即时发放）

要点：

• 通过邀请链接注册时，推荐码通常会自动填入。
• 如果是手动输入推荐码，需要在注册时填写；注册后无法补填（不能追溯）。

Step 2：好友首次购买 credits（首购奖励）

• 好友：+600 credits
• 你：+600 credits

要点（来自官方规则）：

• 首购门槛：好友首次购买 credits 需 至少 $10。
• 发放时间：首购完成后会进入 7 天确认期，奖励在 00:00 UTC 统一结算并发放。

“最高 9,900 credits” 是怎么来的？

在 Arkain 的邀请页面中，会展示一个进度范围，标注为：

• Referral start：5,000
• earned：9,900

这通常表示邀请奖励存在一定的累计上限/阶段目标（页面显示最高到 9,900 credits）。不过页面里同时还有 “Expiration & Limits / Refunds & Exceptions / Fair play & Terms” 等条款入口，具体细则可能会调整。

我的专属注册链接（推荐码已自动填好）

如果你想直接体验并领取奖励，可以用我的链接注册（推荐码会自动带上）：

• https://account.arkain.io/signup?ref=FRD-04OTNC

也可以在注册时手动填写推荐码（如果页面提供该入口）：FRD-04OTNC

常见问题（按官方提示整理）

1）可以注册后再填推荐码吗？

不行。官方说明 推荐码必须在注册时填写，无法补填、无法追溯。

2）好友买了 credits，为什么 600 credits 还没到账？

首购奖励有 7 天确认期，并且在 00:00 UTC 发放。

本文内容基于 Arkain 官方邀请页面信息整理（以官方页面条款为准）。

项目概述

PageAgent 是阿里巴巴开源的一个创新项目，它被称为"生活在你的网页中的 GUI 智能体"。这个项目允许开发者通过自然语言来控制 Web 界面，无需浏览器扩展、Python 环境或无头浏览器，一切都发生在网页内部的 JavaScript 环境中。

核心特性

• 🎯 易于集成：无需浏览器扩展/Python/无头浏览器，仅需页内 JavaScript
• 📖 基于文本的 DOM 操作：不需要截图、多模态 LLM 或特殊权限
• 🧠 自带 LLM：支持自定义大语言模型配置
• 🎨 精美 UI：带有人类在环路的交互式界面
• 🐙 可选 Chrome 扩展：支持多页面任务处理

技术架构

设计理念

PageAgent 的设计哲学是客户端 Web 增强，而非服务器端自动化。它基于优秀的 browser-use 项目进行构建，继承了其在 Web 自动化和 DOM 交互模式方面的最佳实践。

技术特点

1. 纯前端实现：所有逻辑都在浏览器中运行，不需要后端服务
2. 文本化 DOM 操作：通过分析 DOM 结构而非屏幕截图来理解页面
3. LLM 驱动：利用大语言模型理解自然语言指令并转化为 DOM 操作
4. 零权限要求：不需要特殊的浏览器权限或扩展

快速开始

一行代码集成

最快的体验方式是使用官方提供的演示 CDN（使用免费的测试 LLM API）：

1

<script src="https://cdn.jsdelivr.net/npm/page-agent@1.5.7/dist/iife/page-agent.demo.js" crossorigin="true"></script>

⚠️ 注意：此演示 CDN 仅用于技术评估，使用时需同意其条款。

国内镜像

为了获得更好的访问速度，可以使用国内镜像：

1

<script src="https://registry.npmmirror.com/page-agent/1.5.7/files/dist/iife/page-agent.demo.js" crossorigin="true"></script>

NPM 安装

对于生产环境，建议通过 NPM 安装：

1

npm install page-agent

编程式使用

1
2
3
4
5
6
7
8
9
10

import { PageAgent } from 'page-agent'

const agent = new PageAgent({
    model: 'qwen3.5-plus',
    baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
    apiKey: 'YOUR_API_KEY',
    language: 'en-US',
})

await agent.execute('点击登录按钮')

应用场景

1. SaaS AI 助手

在你的产品中快速集成 AI 助手功能，无需重写后端架构。只需几行代码，就能让用户通过自然语言与你的 SaaS 应用交互。

示例场景：

• 用户说"帮我创建一个新的项目"，自动填写表单并提交
• 用户说"显示上周的数据报告"，自动导航到报表页面并筛选时间范围

2. 智能表单填充

将需要多次点击的复杂工作流程简化为一句话。特别适合 ERP、CRM 和管理系统。

示例场景：

• 自动填写复杂的采购申请表单
• 批量更新客户信息
• 自动化数据录入任务

3. 无障碍访问

通过自然语言让任何 Web 应用对残障人士更加友好。支持语音命令、屏幕阅读器，实现零障碍交互。

示例场景：

• 视障用户通过语音命令操作网页
• 行动不便用户通过简单指令完成复杂操作

4. 跨页面智能体

通过可选的 Chrome 扩展，让你的智能体能够跨浏览器标签页工作，实现更复杂的自动化任务。

示例场景：

• 从一个页面抓取数据并填充到另一个页面
• 跨多个系统协调工作流程
• 自动化需要多步骤的业务流程

技术深度解析

DOM 操作机制

PageAgent 不需要截图或使用多模态模型，它通过以下方式理解页面：

1. DOM 树分析：解析页面的 DOM 结构，提取可交互元素
2. 元素索引：为每个可操作元素分配唯一标识
3. 文本化描述：将页面结构转化为 LLM 可理解的文本格式
4. 指令映射：将自然语言指令映射到具体的 DOM 操作

LLM 集成

PageAgent 支持自定义 LLM 配置，这意味着：

• 可以使用阿里云通义千问（DashScope）
• 可以部署自己的 LLM 服务
• 可以根据需求选择不同的模型
• 完全控制 API 调用和成本

安全考虑

由于所有操作都在客户端进行，PageAgent 具有以下安全特性：

• 无服务器依赖：不依赖外部服务器处理敏感数据
• 用户可控：所有操作都在用户浏览器中执行
• 透明化：用户可以清楚看到每一步操作

与其他方案的对比

实际案例

案例 1：电商后台管理系统

场景：客服需要处理大量订单，每个订单需要在系统中进行多次点击和表单填写。

解决方案：

1
2
3
4
5
6
7
8
9

// 集成 PageAgent 后，客服只需说：
"把订单#12345 的状态改为已发货，并发送通知邮件"

// PageAgent 自动执行：
// 1. 搜索订单#12345
// 2. 点击进入详情页
// 3. 点击"发货"按钮
// 4. 填写物流信息
// 5. 点击"发送通知"

效果：原本需要 5-6 次点击的操作，现在一句话完成。

案例 2：数据分析平台

场景：业务人员需要定期从多个维度查看数据报表。

解决方案：

1
2
3
4
5
6
7
8

// 业务人员说：
"显示上个月华东地区的销售数据，按产品类别排序"

// PageAgent 自动：
// 1. 导航到报表页面
// 2. 选择时间范围为"上个月"
// 3. 筛选地区为"华东"
// 4. 设置排序为"按产品类别"

贡献与社区

PageAgent 是一个开源项目，欢迎社区贡献。项目遵循以下原则：

• 接受人类贡献，不接受完全由机器人/AI 生成的 PR
• 遵循 CONTRIBUTING.md 中的指南
• 遵守行为准则

许可证

• 开源协议：MIT License
• 版权信息：Copyright © Alibaba
• 衍生项目：基于 browser-use 项目构建（MIT License）

总结

PageAgent 代表了一种新的 Web 交互范式：将 AI 智能体直接嵌入到网页中，让用户能够用最自然的方式——语言——来操作界面。对于开发者来说，这意味着：

1. 极低的集成成本：一行代码即可启用 AI 交互能力
2. 灵活的应用场景：从简单的表单填充到复杂的跨页面工作流
3. 完全的控制权：可以选择自己的 LLM，控制成本和性能
4. 更好的用户体验：为用户提供更智能、更便捷的交互方式

随着大语言模型的普及和成熟，像 PageAgent 这样的工具将会成为 Web 应用的标准配置，让人机交互变得更加自然和高效。

相关链接

• 项目仓库：https://github.com/alibaba/page-agent
• 在线演示：🚀 Demo
• 官方文档：📖 Documentation
• browser-use 项目：https://github.com/browser-use/browser-use

本文基于 PageAgent 项目官方文档编写，项目信息截至 2026 年 3 月 14 日。

在日常的网络管理和运维工作中，了解网络流量的使用情况是一项基础但重要的需求。无论是家庭网络还是小型企业环境，能够清晰地看到流量走向、识别异常访问、审计网络使用情况，都是保障网络安全和优化网络性能的关键。Neko Master 作为一款现代化的网络流量可视化与分析工具，为这一问题提供了优雅的解决方案。

Neko Master 是一个专注于网络流量分析与可视化的开源项目，如同其名字中的 “Neko”（日语中意为"猫"）一样，它安静而敏锐，能够轻量、精确地对网络流量进行分析与可视化展示。

项目支持实时监控、流量审计、多网关管理，所有数据均来源于用户自有网络环境，不提供任何网络接入服务或代理订阅功能。

项目地址：https://github.com/foru17/neko-master

在线演示：https://neko-master.is26.com（访问密码：neko2026）

一、功能特性介绍

核心亮点

Neko Master 提供了完整的网络流量监控解决方案：

• 实时监控：通过 WebSocket 实现数据的实时推送，让流量变化一目了然
• 流量审计：详细记录和分析网络流量数据，支持历史查询和统计
• 多网关管理：支持同时管理多个网关的流量数据，适合复杂网络环境
• IP 地理位置查询：支持本地 MMDB 数据库或在线查询，了解流量来源
• 数据可视化：现代化的仪表盘界面，图表清晰直观

技术架构

项目采用现代化的技术栈构建：

• 前端：Next.js + React，提供流畅的用户体验
• 后端：Node.js，轻量高效
• 数据库：SQLite，无需额外数据库服务，数据存储简单可靠
• 容器化：完整的 Docker 支持，一键部署

安全与隐私

Neko Master 非常注重用户隐私和数据安全：

• 所有数据均来源于用户自有网络环境
• 不提供任何网络接入服务、代理订阅或跨网络连接功能
• 支持本地部署，数据完全由用户掌控
• 提供访问认证机制，保护面板安全

二、快速上手

方式一：Docker Compose（推荐）

最简部署方式，仅暴露 Web UI 端口：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

services:
  neko-master:
    image: foru17/neko-master:latest
    container_name: neko-master
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
      - ./geoip:/app/data/geoip:ro
    environment:
      - NODE_ENV=production
      - DB_PATH=/app/data/stats.db
      - COOKIE_SECRET=${COOKIE_SECRET}

建议在 docker-compose.yml 同目录创建 .env 文件配置 Cookie 密钥：

1

COOKIE_SECRET=<至少32字节随机字符串>

使用 openssl rand -hex 32 生成安全的随机字符串。

启动服务：

1

docker compose up -d

访问 http://localhost:3000 即可看到管理面板。

方式二：实时 WebSocket 部署

如果需要实时数据推送功能，可以额外暴露 WebSocket 端口：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

services:
  neko-master:
    image: foru17/neko-master:latest
    container_name: neko-master
    restart: unless-stopped
    ports:
      - "3000:3000"
      - "3002:3002"
    volumes:
      - ./data:/app/data
      - ./geoip:/app/data/geoip:ro
    environment:
      - NODE_ENV=production
      - DB_PATH=/app/data/stats.db
      - COOKIE_SECRET=${COOKIE_SECRET}

方式三：一键脚本

对于不熟悉 Docker 的用户，项目提供了自动检测端口冲突并配置的一键脚本：

1

curl -fsSL https://raw.githubusercontent.com/foru17/neko-master/main/setup.sh | bash

脚本会自动完成以下工作：

• 下载 docker-compose.yml 配置文件
• 检测默认端口（3000/3001/3002）是否被占用
• 提供可用的替代端口选项
• 创建配置文件并启动服务

方式四：源码运行

开发者可以选择源码方式运行：

1
2
3
4
5

git clone https://github.com/foru17/neko-master.git
cd neko-master
pnpm install
cp apps/collector/.env.example apps/collector/.env
pnpm dev

访问 http://localhost:3000 即可使用。

三、接入网关数据

Neko Master 支持接入多种网关的流量数据，以 Clash 为例：

1. 在 Clash 配置文件中添加 RESTful API 支持：

1
2

external-controller: 0.0.0.0:9090
secret: "your-secret"

2. 在 Neko Master 面板的设置页面添加网关配置：
   • 名称：自定义网关名称
   • 地址：Clash API 地址（如 http://192.168.1.1:9090）
   • 密钥：Clash 配置的 secret

添加完成后，面板会自动开始收集和展示该网关的流量数据。

四、总结

Neko Master 是一款设计优雅、功能实用的网络流量分析工具。从安装到使用，整个过程非常轻量化，通过 Docker 即可快速部署。

对于有网络流量监控需求的用户，无论是家庭网络管理还是小型企业运维，都可以尝试这个工具。它的实时监控和流量审计功能，能够帮助你更好地了解和管控网络使用情况。

项目遵循 MIT 协议开源，欢迎有开发能力的用户参与贡献。

在数字化时代，信息的保存往往面临着被删除、篡改或丢失的风险。然而，区块链技术的出现为信息的永恒存储提供了可能。EverMsg 正是这样一个致力于挖掘和展示这些永恒印记的平台。

什么是 EverMsg？

EverMsg 是一个现代化的比特币 OP_RETURN 数据浏览器。它的核心理念是：“每一条印记都被永久记录在区块链上，不可篡改，永不消失。”

通过 EverMsg，用户可以浏览那些被刻入比特币区块链的各种信息。这些信息与比特币共存亡，只要比特币网络还在运行，这些数据就永远存在。

核心特性

1. 永久存储

EverMsg 展示的消息并非存储在普通的中心化服务器上，而是直接刻入比特币区块链。这意味着这些消息与区块链共存亡，实现了真正意义上的永久存储。

2. 不可篡改

基于区块链的特性，一旦消息通过 OP_RETURN 写入区块并被确认，就成为不可变历史的一部分。任何人都无法修改、删除或审查这些内容，甚至连原始发送者也不行。

3. 全球可见

区块链是公开透明的账本，世界上任何人都可以查阅这些永恒的印记。EverMsg 提供了一个用户友好的界面，将这些技术性的链上数据转化为易读的格式，供全球用户浏览。

技术原理：OP_RETURN

EverMsg 的技术基础是比特币脚本中的 OP_RETURN 操作码。

• 功能：允许用户在比特币交易中嵌入最多 80 字节 的任意数据。
• 应用：非常适合存储简短的消息、誓言、时间戳、存证或任何希望永久保存的简短文本。
• 即时性：新的 OP_RETURN 消息通常在比特币网络确认后几分钟内即可在 EverMsg 上检索到。

常见问题解答

Q: 使用 EverMsg 浏览消息需要付费吗？
A: 不需要。在 EverMsg 上浏览和阅读 OP_RETURN 消息是完全免费的。

Q: 如何发布自己的永恒印记？
A: EverMsg 本身是一个浏览器。要创建 OP_RETURN 交易（即发布消息），您需要使用支持此功能的比特币钱包或通过专门的服务。发布消息时，您需要向矿工支付比特币交易费用。

Q: 它可以支持哪些语言？
A: EverMsg 支持任何语言的消息。其界面本身也支持英语、中文、日语、韩语和西班牙语，并提供自动语言检测和筛选功能。

结语

EverMsg 不仅仅是一个工具，它更像是一个数字时代的"铭文墙"。在这里，你可以看到人们留下的各种讯息——可能是对爱人的誓言，可能是对某个时刻的纪念，也可能是某种思想的表达。

探索比特币区块链上的永恒消息，见证人类在数字时代留下的不可磨灭的印记。

访问 EverMsg 官网

项目概述

RaTeX 是一款专为LaTeX用户设计的实时渲染工具，它将传统的"编写-编译-预览"工作流程转变为流畅的实时编辑体验。通过即时渲染技术，RaTeX让用户能够在输入LaTeX代码的同时看到最终效果，极大提升了文档编写效率。

核心特性

• ⚡ 实时渲染：输入即所见，无需等待编译
• 🎯 智能补全：LaTeX命令和环境的智能提示
• 📱 现代化界面：简洁直观的用户体验
• 🔧 轻量高效：快速启动，低资源占用
• 🌐 跨平台支持：支持主流操作系统

为什么选择RaTeX？

传统LaTeX编辑器的痛点

传统的LaTeX编辑流程存在诸多不便：

1. 编译等待：每次修改都需要重新编译，打断思路
2. 错误定位困难：编译错误信息不够直观
3. 预览不便：需要在编辑器和PDF查看器间切换
4. 学习曲线陡峭：新手难以快速上手

RaTeX的解决方案

RaTeX通过创新的实时渲染技术，完美解决了这些问题：

• 即时反馈：输入代码立即看到效果，所见即所得
• 错误提示：实时显示语法错误，快速定位问题
• 统一界面：编辑和预览在同一窗口，无需切换
• 降低门槛：直观的操作方式，新手友好

核心功能详解

1. 实时渲染引擎

RaTeX的核心是其高性能的实时渲染引擎：

技术特点：

• 增量渲染：只更新修改部分，提升性能
• 异步处理：不阻塞编辑操作
• 智能缓存：减少重复计算

渲染速度：

• 简单公式：< 10ms
• 复杂文档：< 100ms
• 大型项目：< 500ms

2. 智能编辑辅助

命令补全：

• 自动提示LaTeX命令
• 参数提示和说明
• 常用模板快速插入

语法高亮：

• 多层次语法着色
• 括号匹配提示
• 错误标记显示

代码片段：

• 内置常用模板
• 自定义代码片段
• 快捷键快速插入

3. 数学公式支持

RaTeX对数学公式提供了完善的支持：

行内公式：

1

$E = mc^2$

独立公式：

1
2
3

$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$

复杂环境：

• align环境
• matrix环境
• cases环境
• 自定义环境

4. 文档结构管理

大纲视图：

• 章节结构一目了然
• 快速跳转定位
• 拖拽调整顺序

引用管理：

• 自动识别标签
• 智能引用补全
• 交叉引用检查

图表管理：

• 图片预览
• 表格可视化编辑
• 浮动体位置调整

使用场景

学术论文写作

适用场景：

• 期刊论文撰写
• 学位论文编写
• 会议论文投稿
• 技术报告制作

优势：

• 实时预览公式效果
• 快速调整格式
• 高效管理参考文献
• 符合学术规范

数学教学

教师应用：

• 制作课件
• 编写习题
• 准备讲义
• 设计试卷

学生应用：

• 完成作业
• 记录笔记
• 准备报告
• 学习LaTeX

技术文档

文档类型：

• API文档
• 技术手册
• 用户指南
• 开发文档

特点：

• 代码高亮
• 图表丰富
• 格式统一
• 易于维护

快速开始

安装方法

从源码安装：

1
2
3

git clone https://github.com/erweixin/RaTeX.git
cd RaTeX
# 按照README中的说明进行安装

系统要求：

• 操作系统：Windows/macOS/Linux
• 内存：建议4GB以上
• 存储：200MB可用空间

基本使用

创建新文档：

1. 启动RaTeX
2. 选择"新建文档"
3. 选择文档模板
4. 开始编写

编辑文档：

1. 在左侧编辑器输入LaTeX代码
2. 右侧实时显示渲染效果
3. 使用工具栏快速插入元素
4. 保存或导出文档

常用快捷键：

• Ctrl+S：保存文档
• Ctrl+B：加粗文本
• Ctrl+I：斜体文本
• Ctrl+M：插入数学公式
• Ctrl+L：插入列表

技术架构

前端技术

渲染引擎：

• 基于MathJax/KaTeX
• 自定义渲染优化
• WebGL加速（可选）

编辑器：

• Monaco Editor集成
• 自定义语法解析
• 智能补全引擎

界面框架：

• 现代化UI设计
• 响应式布局
• 主题定制支持

后端技术

文档处理：

• LaTeX解析器
• 语法树生成
• 错误检测

性能优化：

• 增量编译
• 并行处理
• 内存管理

与其他工具对比

实际应用案例

案例1：学术论文写作

场景：博士生撰写学位论文

使用体验：

• 实时预览公式，快速调整格式
• 大纲视图管理章节结构
• 引用管理简化文献引用
• 提高写作效率50%以上

案例2：数学课件制作

场景：大学教师制作微积分课件

使用体验：

• 快速插入数学公式
• 实时调整排版效果
• 图表编辑直观便捷
• 课件制作时间减半

案例3：技术文档编写

场景：开发团队编写API文档

使用体验：

• 代码高亮清晰
• 格式统一规范
• 易于版本控制
• 团队协作高效

社区与支持

开源社区

项目信息：

• GitHub仓库：erweixin/RaTeX
• 开源协议：MIT License
• 活跃开发：持续更新

参与方式：

• 提交Issue反馈问题
• 贡献代码改进功能
• 完善文档和教程
• 分享使用经验

获取帮助

文档资源：

• 官方文档
• 使用教程
• 常见问题
• 视频演示

社区支持：

• GitHub Discussions
• 用户交流群
• 技术博客
• 在线论坛

未来发展

短期计划

功能增强：

• 协作编辑功能
• 云端同步支持
• 更多模板库
• 插件系统

性能优化：

• 渲染速度提升
• 内存占用优化
• 启动速度改进
• 大文档支持

长期愿景

生态建设：

• 插件市场
• 模板社区
• 在线服务
• 移动端支持

技术创新：

• AI辅助写作
• 智能排版
• 自动校对
• 多人协作

最佳实践

编写建议

1. 合理组织结构

   • 使用章节命令
   • 保持层次清晰
   • 适当添加注释

2. 优化渲染性能

   • 避免过度嵌套
   • 合理使用宏定义
   • 控制文档大小

3. 提高可维护性

   • 模块化编写
   • 统一命名规范
   • 版本控制管理

常见问题

Q1: RaTeX支持中文吗？

A: 完全支持中文，包括中文字体和CJK环境。

Q2: 如何导出PDF？

A: 使用导出功能，选择PDF格式即可。

Q3: 支持自定义模板吗？

A: 支持，可以创建和导入自定义模板。

Q4: 渲染速度慢怎么办？

A: 检查文档复杂度，优化代码结构，关闭不必要的功能。

Q5: 如何报告Bug？

A: 在GitHub仓库提交Issue，详细描述问题和复现步骤。

总结

RaTeX作为一款创新的LaTeX实时渲染工具，通过即时预览、智能补全和现代化界面，极大地改善了LaTeX文档的编写体验。无论是学术写作、教学应用还是技术文档编写，RaTeX都能提供高效、便捷的解决方案。

核心优势：

• ✅ 实时渲染，即时反馈
• ✅ 智能辅助，提升效率
• ✅ 现代界面，易于使用
• ✅ 开源免费，持续更新
• ✅ 跨平台，适用广泛

对于LaTeX用户来说，RaTeX是一个值得尝试的优秀工具。它不仅保留了LaTeX的强大功能，还通过创新的实时渲染技术，让文档编写变得更加流畅和高效。

相关链接：

• GitHub仓库：https://github.com/erweixin/RaTeX
• 项目文档：查看仓库README
• 问题反馈：GitHub Issues

标签：#LaTeX #实时渲染 #开源项目 #文档编辑 #学术写作 #数学公式

概述

本文档详细介绍了 Xget 与各种开发工具、平台和服务的集成方式。通过深度集成，Xget 能够无缝融入开发者的日常工作流程，提供统一的加速体验。

IDE 集成

Visual Studio Code

配置 Git 加速

在 VS Code 中配置 Git 使用 Xget：

1
2
3
4
5
6
7
8
9
10

{
  "git.enabled": true,
  "git.path": "git",
  "git.autofetch": true,
  "git.enableSmartCommit": true,
  "git.postCommitCommand": "none",
  "git.confirmSync": false,
  "git.suggestSmartCommit": true,
  "git.useEditorAsCommitInput": true
}

配置 Git 配置文件

在项目根目录创建 .gitconfig：

1
2

[url "https://xget.xi-xu.me/gh/"]
    insteadOf = https://github.com/

使用 GitLens 扩展

安装 GitLens 扩展后，在设置中配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
  "gitlens.advanced.messages": {
    "suppressCommitHasNoPreviousCommitWarning": false,
    "suppressCommitNotFoundWarning": false,
    "suppressFileNotUnderSourceControlWarning": false,
    "suppressGitDisabledWarning": false,
    "suppressLineUncommittedWarning": false,
    "suppressNoRepositoryWarning": false,
    "suppressResultsExplorerNotice": false,
    "suppressShowKeyBindingsNotice": false,
    "suppressUpdateNotice": false,
    "suppressWelcomeNotice": false
  }
}

配置 npm 加速

在 VS Code 中配置 npm 使用 Xget：

1
2
3
4
5
6
7

{
  "npm.packageManager": "npm",
  "npm.enableScriptExplorer": true,
  "npm.enableRunFromFolder": true,
  "npm.exclude": "**/node_modules/**",
  "npm.include": "**/package.json"
}

创建 .npmrc 文件

在项目根目录创建 .npmrc：

1

registry=https://xget.xi-xu.me/npm

配置 Python 加速

在 VS Code 中配置 Python 使用 Xget：

1
2
3
4
5
6
7

{
  "python.defaultInterpreterPath": "python",
  "python.terminal.activateEnvironment": true,
  "python.linting.enabled": true,
  "python.linting.pylintEnabled": true,
  "python.formatting.provider": "black"
}

创建 pip.conf 文件

在项目根目录创建 pip.conf：

1
2

[global]
index-url = https://xget.xi-xu.me/pypi

IntelliJ IDEA

配置 Git 加速

在 IDEA 中配置 Git 使用 Xget：

1. 打开 Settings → Version Control → Git
2. 在 SSH executable 中选择 Built-in
3. 在 Environment variables 中添加：

1

GIT_SSH_COMMAND=ssh -o ProxyCommand="ssh -W %h:%p git@xget.xi-xu.me"

配置 Maven 加速

在 IDEA 中配置 Maven 使用 Xget：

1. 打开 Settings → Build, Execution, Deployment → Build Tools → Maven
2. 在 User settings file 中配置：

1
2
3
4
5
6
7
8
9
10

<settings>
  <mirrors>
    <mirror>
      <id>xget-maven</id>
      <mirrorOf>central</mirrorOf>
      <name>Xget Maven Mirror</name>
      <url>https://xget.xi-xu.me/maven2</url>
    </mirror>
  </mirrors>
</settings>

配置 Gradle 加速

在 IDEA 中配置 Gradle 使用 Xget：

1. 打开 Settings → Build, Execution, Deployment → Build Tools → Gradle
2. 在 Gradle JVM 中选择合适的 JDK
3. 在 build.gradle 中配置：

1
2
3
4

repositories {
    maven { url 'https://xget.xi-xu.me/maven2' }
    mavenCentral()
}

PyCharm

配置 Git 加速

在 PyCharm 中配置 Git 使用 Xget：

1. 打开 Settings → Version Control → Git
2. 在 SSH executable 中选择 Built-in
3. 在 Environment variables 中添加：

1

GIT_SSH_COMMAND=ssh -o ProxyCommand="ssh -W %h:%p git@xget.xi-xu.me"

配置 pip 加速

在 PyCharm 中配置 pip 使用 Xget：

1. 打开 Settings → Project → Python Interpreter
2. 点击齿轮图标 → Show All
3. 在 Package Manager 中配置：

1
2

[global]
index-url = https://xget.xi-xu.me/pypi

WebStorm

配置 Git 加速

在 WebStorm 中配置 Git 使用 Xget：

1. 打开 Settings → Version Control → Git
2. 在 SSH executable 中选择 Built-in
3. 在 Environment variables 中添加：

1

GIT_SSH_COMMAND=ssh -o ProxyCommand="ssh -W %h:%p git@xget.xi-xu.me"

配置 npm 加速

在 WebStorm 中配置 npm 使用 Xget：

1. 打开 Settings → Languages & Frameworks → Node.js and NPM
2. 在 Package manager 中选择 npm
3. 在项目中创建 .npmrc：

1

registry=https://xget.xi-xu.me/npm

CI/CD 集成

GitHub Actions

基本配置

在 GitHub Actions 中配置 Xget：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

name: Build and Test

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          registry-url: 'https://xget.xi-xu.me/npm'

      - name: Install dependencies
        run: npm ci

      - name: Build
        run: npm run build

      - name: Test
        run: npm test

Git 配置

在 GitHub Actions 中配置 Git 使用 Xget：

1
2
3
4

- name: Configure Git
  run: |
    git config --global url."https://xget.xi-xu.me/gh/".insteadOf "https://github.com/"
    git config --global url."https://xget.xi-xu.me/gl/".insteadOf "https://gitlab.com/"

Docker 配置

在 GitHub Actions 中配置 Docker 使用 Xget：

1
2
3
4

- name: Configure Docker
  run: |
    echo '{"registry-mirrors": ["https://xget.xi-xu.me/cr/registry-1.docker.io"]}' | sudo tee /etc/docker/daemon.json
    sudo systemctl restart docker

Python 配置

在 GitHub Actions 中配置 Python 使用 Xget：

1
2
3
4
5
6
7
8

- name: Setup Python
  uses: actions/setup-python@v5
  with:
    python-version: '3.11'

- name: Configure pip
  run: |
    pip config set global.index-url https://xget.xi-xu.me/pypi

GitLab CI

基本配置

在 GitLab CI 中配置 Xget：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

image: node:20

variables:
  NPM_CONFIG_REGISTRY: "https://xget.xi-xu.me/npm"
  PIP_INDEX_URL: "https://xget.xi-xu.me/pypi"

before_script:
  - npm ci

stages:
  - build
  - test

build:
  stage: build
  script:
    - npm run build

test:
  stage: test
  script:
    - npm test

Git 配置

在 GitLab CI 中配置 Git 使用 Xget：

1
2
3

before_script:
  - git config --global url."https://xget.xi-xu.me/gh/".insteadOf "https://github.com/"
  - git config --global url."https://xget.xi-xu.me/gl/".insteadOf "https://gitlab.com/"

Docker 配置

在 GitLab CI 中配置 Docker 使用 Xget：

1
2
3
4
5
6
7
8
9
10
11

services:
  - docker:dind

variables:
  DOCKER_HOST: tcp://docker:2375
  DOCKER_TLS_CERTDIR: ""

before_script:
  - echo '{"registry-mirrors": ["https://xget.xi-xu.me/cr/registry-1.docker.io"]}' | tee /etc/docker/daemon.json
  - dockerd &
  - sleep 5

Jenkins

基本配置

在 Jenkins 中配置 Xget：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

pipeline {
    agent any

    environment {
        NPM_CONFIG_REGISTRY = 'https://xget.xi-xu.me/npm'
        PIP_INDEX_URL = 'https://xget.xi-xu.me/pypi'
    }

    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }

        stage('Install') {
            steps {
                sh 'npm ci'
            }
        }

        stage('Build') {
            steps {
                sh 'npm run build'
            }
        }

        stage('Test') {
            steps {
                sh 'npm test'
            }
        }
    }
}

Git 配置

在 Jenkins 中配置 Git 使用 Xget：

1
2
3
4
5
6
7
8

stage('Configure Git') {
    steps {
        sh '''
            git config --global url."https://xget.xi-xu.me/gh/".insteadOf "https://github.com/"
            git config --global url."https://xget.xi-xu.me/gl/".insteadOf "https://gitlab.com/"
        '''
    }
}

Azure DevOps

基本配置

在 Azure DevOps 中配置 Xget：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

trigger:
- main

pool:
  vmImage: 'ubuntu-latest'

variables:
  NPM_CONFIG_REGISTRY: 'https://xget.xi-xu.me/npm'
  PIP_INDEX_URL: 'https://xget.xi-xu.me/pypi'

steps:
- task: NodeTool@0
  inputs:
    versionSpec: '20.x'
  displayName: 'Install Node.js'

- script: |
    npm ci
  displayName: 'Install dependencies'

- script: |
    npm run build
  displayName: 'Build'

- script: |
    npm test
  displayName: 'Test'

Git 配置

在 Azure DevOps 中配置 Git 使用 Xget：

1
2
3
4

- script: |
    git config --global url."https://xget.xi-xu.me/gh/".insteadOf "https://github.com/"
    git config --global url."https://xget.xi-xu.me/gl/".insteadOf "https://gitlab.com/"
  displayName: 'Configure Git'

包管理器集成

npm

全局配置

1
2
3
4
5

# 设置 npm 注册表
npm config set registry https://xget.xi-xu.me/npm

# 验证配置
npm config get registry

项目配置

在项目根目录创建 .npmrc：

1

registry=https://xget.xi-xu.me/npm

使用示例

1
2
3
4
5
6
7
8

# 安装包
npm install react

# 安装特定版本
npm install react@18.2.0

# 全局安装
npm install -g typescript

yarn

全局配置

1
2
3
4
5

# 设置 yarn 注册表
yarn config set registry https://xget.xi-xu.me/npm

# 验证配置
yarn config get registry

项目配置

在项目根目录创建 .yarnrc：

1

registry "https://xget.xi-xu.me/npm"

使用示例

1
2
3
4
5
6
7
8

# 安装包
yarn add react

# 安装特定版本
yarn add react@18.2.0

# 全局安装
yarn global add typescript

pnpm

全局配置

1
2
3
4
5

# 设置 pnpm 注册表
pnpm config set registry https://xget.xi-xu.me/npm

# 验证配置
pnpm config get registry

项目配置

在项目根目录创建 .npmrc：

1

registry=https://xget.xi-xu.me/npm

使用示例

1
2
3
4
5
6
7
8

# 安装包
pnpm add react

# 安装特定版本
pnpm add react@18.2.0

# 全局安装
pnpm add -g typescript

pip

全局配置

1
2
3
4
5
6
7
8
9
10
11

# 创建 pip 配置目录
mkdir -p ~/.pip

# 创建配置文件
cat > ~/.pip/pip.conf << EOF
[global]
index-url = https://xget.xi-xu.me/pypi
EOF

# 验证配置
pip config get global.index-url

项目配置

在项目根目录创建 pip.conf：

1
2

[global]
index-url = https://xget.xi-xu.me/pypi

使用示例

1
2
3
4
5
6
7
8

# 安装包
pip install requests

# 安装特定版本
pip install requests==2.31.0

# 从 requirements.txt 安装
pip install -r requirements.txt

Poetry

全局配置

1
2
3
4
5

# 设置 Poetry 源
poetry source add --priority=primary xget https://xget.xi-xu.me/pypi

# 验证配置
poetry source show

项目配置

在 pyproject.toml 中配置：

1
2
3
4

[tool.poetry.source]
name = "xget"
url = "https://xget.xi-xu.me/pypi"
priority = "primary"

使用示例

1
2
3
4
5
6
7
8

# 安装依赖
poetry install

# 添加包
poetry add requests

# 更新依赖
poetry update

conda

全局配置

1
2
3
4
5

# 添加 Xget 作为频道
conda config --add channels https://xget.xi-xu.me/conda/pkgs/main

# 验证配置
conda config --show channels

项目配置

在项目根目录创建 .condarc：

1
2
3

channels:
  - https://xget.xi-xu.me/conda/pkgs/main
  - defaults

使用示例

1
2
3
4
5

# 安装包
conda install python=3.11

# 从特定频道安装
conda install -c https://xget.xi-xu.me/conda/community/conda-forge pytorch

Maven

全局配置

编辑 ~/.m2/settings.xml：

1
2
3
4
5
6
7
8
9
10

<settings>
  <mirrors>
    <mirror>
      <id>xget-maven</id>
      <mirrorOf>central</mirrorOf>
      <name>Xget Maven Mirror</name>
      <url>https://xget.xi-xu.me/maven2</url>
    </mirror>
  </mirrors>
</settings>

项目配置

在 pom.xml 中配置：

1
2
3
4
5
6

<repositories>
  <repository>
    <id>xget</id>
    <url>https://xget.xi-xu.me/maven2</url>
  </repository>
</repositories>

使用示例

1
2
3
4
5

# 下载依赖
mvn dependency:resolve

# 构建项目
mvn clean install

Gradle

全局配置

编辑 ~/.gradle/init.gradle：

1
2
3
4
5
6

allprojects {
    repositories {
        maven { url 'https://xget.xi-xu.me/maven2' }
        mavenCentral()
    }
}

项目配置

在 build.gradle 中配置：

1
2
3
4

repositories {
    maven { url 'https://xget.xi-xu.me/maven2' }
    mavenCentral()
}

使用示例

1
2
3
4
5

# 下载依赖
./gradlew dependencies

# 构建项目
./gradlew build

容器集成

Docker

配置 Docker 镜像

编辑 /etc/docker/daemon.json：

1
2
3
4
5

{
  "registry-mirrors": [
    "https://xget.xi-xu.me/cr/registry-1.docker.io"
  ]
}

重启 Docker：

1

sudo systemctl restart docker

使用示例

1
2
3
4
5
6
7
8

# 拉取镜像
docker pull nginx:latest

# 拉取特定标签
docker pull nginx:1.25

# 构建镜像
docker build -t myapp .

Dockerfile 配置

在 Dockerfile 中配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

FROM node:20

# 配置 npm 使用 Xget
RUN npm config set registry https://xget.xi-xu.me/npm

# 安装依赖
COPY package*.json ./
RUN npm ci

# 复制源码
COPY . .

# 构建应用
RUN npm run build

# 启动应用
CMD ["npm", "start"]

Kubernetes

配置镜像拉取

在 Kubernetes 中配置 Docker 镜像加速：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

apiVersion: v1
kind: ConfigMap
metadata:
  name: docker-config
data:
  daemon.json: |
    {
      "registry-mirrors": [
        "https://xget.xi-xu.me/cr/registry-1.docker.io"
      ]
    }
---
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: docker-config
spec:
  selector:
    matchLabels:
      app: docker-config
  template:
    metadata:
      labels:
        app: docker-config
    spec:
      containers:
      - name: docker-config
        image: alpine
        command: ["/bin/sh", "-c"]
        args:
          - |
            mkdir -p /etc/docker
            echo '{"registry-mirrors": ["https://xget.xi-xu.me/cr/registry-1.docker.io"]}' > /etc/docker/daemon.json
            sleep infinity
        volumeMounts:
        - name: docker-config
          mountPath: /etc/docker
      volumes:
      - name: docker-config
        configMap:
          name: docker-config

使用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
spec:
  replicas: 3
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
      - name: myapp
        image: nginx:latest
        ports:
        - containerPort: 80

Podman

配置 Podman 镜像

编辑 /etc/containers/registries.conf：

1
2
3
4
5
6
7
8

unqualified-search-registries = ["docker.io", "registry.fedoraproject.org", "quay.io"]

[[registry]]
prefix = "docker.io"
location = "xget.xi-xu.me/cr/registry-1.docker.io"
insecure = false
blocked = false
mirror-by-digest-only = false

使用示例

1
2
3
4
5
6
7
8

# 拉取镜像
podman pull nginx:latest

# 拉取特定标签
podman pull nginx:1.25

# 运行容器
podman run -d -p 80:80 nginx:latest

云平台集成

AWS

配置 AWS CodeBuild

在 AWS CodeBuild 中配置 Xget：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

version: 0.2

phases:
  install:
    runtime-versions:
      nodejs: 20
    commands:
      - npm config set registry https://xget.xi-xu.me/npm
      - npm ci

  build:
    commands:
      - npm run build

  post_build:
    commands:
      - npm test

配置 AWS Lambda

在 AWS Lambda 中配置 Xget：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

const { execSync } = require('child_process');

// 配置 npm 使用 Xget
execSync('npm config set registry https://xget.xi-xu.me/npm');

// 安装依赖
execSync('npm ci');

// 导出处理函数
exports.handler = async (event) => {
  // 处理逻辑
  return {
    statusCode: 200,
    body: JSON.stringify({ message: 'Hello from Lambda!' })
  };
};

Google Cloud

配置 Google Cloud Build

在 Google Cloud Build 中配置 Xget：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

steps:
  - name: 'node:20'
    entrypoint: 'npm'
    args: ['config', 'set', 'registry', 'https://xget.xi-xu.me/npm']
  
  - name: 'node:20'
    entrypoint: 'npm'
    args: ['ci']
  
  - name: 'node:20'
    entrypoint: 'npm'
    args: ['run', 'build']
  
  - name: 'node:20'
    entrypoint: 'npm'
    args: ['test']

配置 Google Cloud Functions

在 Google Cloud Functions 中配置 Xget：

1
2
3
4
5
6
7
8
9
10
11
12

const { execSync } = require('child_process');

// 配置 npm 使用 Xget
execSync('npm config set registry https://xget.xi-xu.me/npm');

// 安装依赖
execSync('npm ci');

// 导出处理函数
exports.helloWorld = (req, res) => {
  res.status(200).send({ message: 'Hello from Cloud Functions!' });
};

Azure

配置 Azure Functions

在 Azure Functions 中配置 Xget：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

const { execSync } = require('child_process');

// 配置 npm 使用 Xget
execSync('npm config set registry https://xget.xi-xu.me/npm');

// 安装依赖
execSync('npm ci');

// 导出处理函数
module.exports = async function (context, req) {
  context.res = {
    status: 200,
    body: { message: 'Hello from Azure Functions!' }
  };
};

监控和日志集成

Prometheus

配置 Prometheus 监控

在 Prometheus 中配置 Xget 监控：

1
2
3
4
5
6

scrape_configs:
  - job_name: 'xget'
    static_configs:
      - targets: ['xget.xi-xu.me:9090']
    metrics_path: '/metrics'
    scrape_interval: 15s

使用示例

1
2
3
4
5

# 启动 Prometheus
prometheus --config.file=prometheus.yml

# 查询指标
curl http://localhost:9090/api/v1/query?query=xget_request_count

Grafana

配置 Grafana 仪表板

在 Grafana 中配置 Xget 仪表板：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

{
  "dashboard": {
    "title": "Xget Metrics",
    "panels": [
      {
        "title": "Request Count",
        "targets": [
          {
            "expr": "xget_request_count",
            "refId": "A"
          }
        ]
      },
      {
        "title": "Response Time",
        "targets": [
          {
            "expr": "xget_response_time",
            "refId": "A"
          }
        ]
      }
    ]
  }
}