GaGa's Blog

Gemma 4 12B 开源多模态模型。这款模型最重大的突破在于：彻底砍掉了多模态编码器，实现了极精简的原生多模态架构，目标是直接在 16GB 显存的轻薄笔记本电脑上实现强大的本地智能体（Agent）工作流。

• https://huggingface.co/google/gemma-4-12B-it/

1.核心技术突破：无编码器（Encoder-free）原生多模态

命令

mvn clean package -Pnative -DskipTests -Dspring-boot.aot.jvmArguments="-Dfile.encoding=UTF-8"

这行命令的作用是编译并打包你的 Spring Boot 项目为原生镜像（Native Image），在执行过程中：

• -DskipTests：明确指定了跳过测试用例的运行。
• **package**：是 Maven 的生命周期阶段，意味着命令执行到打包结束（生成二进制文件）

在 Shell 脚本（特别是在 Bash 中）中，**set +e 的作用就是关闭“遇到错误立即退出”的机制**。

set -e 与 set +e 的区别

• set -e（开启错误检查）：
  告诉 Shell，如果脚本中任何一个命令执行失败（即返回了一个非零的退出状态码 exit status【非0】），脚本应该立即停止执行并退出。这就像开启了“严格模式”，常用于确保脚本的安全性，防止前面的步骤报错了，后面的步骤还在盲目执行。

• set +e（关闭错误检查）：
  告诉 Shell，即使某个命令执行失败，也不要理会它，继续执行接下来的每一行代码。

Mastra 是一个面向现代 TypeScript 技术栈的全栈 AI 应用与智能体（Agent）开发框架。它旨在帮助开发者快速构建、部署和优化由大语言模型（LLM）驱动的生产级应用。

• https://github.com/mastra-ai/mastra

1. 核心核心特性 (Core Features)

ZooKeeper 是一个分布式协调服务，由 Apache Hadoop 项目开发，核心基于 PAXOS 变种Zab 协议。

核心功能

1. 分布式配置管理

在 Ubuntu 26.04（以及自 16.04 以来的版本）中，系统默认使用可预测网络接口名称（如 enp3s0）。如果你希望将其改回传统的 eth0，需要修改启动参数并配合 Netplan 进行网络配置。

1.修改网卡名称为 eth0

要禁用“可预测名称”规则，最直接的方法是修改 Grub 引导参数。

问题

在 docker-compose 中，-it（互动模式和伪终端）是属于 exec 子命令的参数，而不是 docker-compose 全局命令的参数。把它放在 exec 前面，Docker 会误以为这是 docker-compose 自身的参数，从而报错 unknown shorthand flag。

实际上，**docker-compose exec 默认就已经开启了 -it 效果**，你完全可以把 -it 直接删掉。

解决

在 Docker 容器中运行 非无头模式（Headed Mode, headless=False） 的 Chrome，最大的挑战在于：容器默认是没有显示器（X-Server）的。如果你直接把 headless 改为 False，Chrome 会因为找不到显示设备而直接报错崩溃。

要在容器里完美欺骗 Chrome，让它以为自己有一个显示器并正常渲染页面，最标准、最稳定的做法是使用 Xvfb（X Virtual Framebuffer，虚拟帧缓冲区）。它能在内存中虚拟出一个显示屏幕。

1.在 Dockerfile 中安装 Xvfb

当你运行 playwright install --with-deps chromium 时，Playwright 会将浏览器下载并安装到当前系统用户的全局缓存目录中，而不是安装在你的项目文件夹内。

1. 默认安装路径

方案一：使用 Playwright 官方镜像（推荐）

Playwright 官方团队维护了包含完整环境的 Docker 镜像，里面已经内置了 Node.js/Python 环境以及所有浏览器运行所需的依赖，是最不容易踩坑的方案。

1. 选择镜像

根据你使用的编程语言，拉取对应的官方镜像：

方法一：传统葱油鸡（蒸/煮）

食材

• 嫩鸡约 2.5 斤（土鸡或鸡腿），葱 3-4 根，姜 3-4 片，蒜 2-3 瓣
• 油 1 杯，盐、胡椒粉、料酒、蚝油/生抽（可选）

步骤

HTTP 204 No Content 是一个成功状态码，表示服务器已成功处理请求，但不需要返回任何实体内容。

它的核心语义是：“操作成功，但页面/视图无需刷新或跳转，你继续待在当前页面就行。”

1. 关键规则（必须遵守）