我的 AI 采纳之旅【译】

本文原文地址 ,使用claude进行了翻译,作者是HashiCorp的创始人Mitchell Hashimoto。 作者:Mitchell Hashimoto | 原文日期:2026年2月5日 我在采纳任何一款有价值的工具时,通常都会经历三个阶段:(1)低效期、(2)适应期,最终才到达(3)彻底改变工作流程乃至生活方式的顿悟期。 大多数情况下,我必须强迫自己熬过第一阶段和第二阶段——因为我通常已经有一套令自己满意且顺手的工作流程。引入新工具意味着额外的付出,我实在不想花这份力气,但出于对所在领域的全面性追求,我通常还是会去尝试。 这篇文章记录了我如何在 AI 工具链中找到真正价值的历程,以及我正在探索的下一步方向。在一片夸大其词、充斥炒作的声浪中,我希望这篇文章能呈现一种更细腻、更审慎的视角,如实反映我对 AI 的看法是如何随着时间推移而演变的。 本文完全由我亲手写就,字字出自本人之口。这句话放在这里本不必要,但鉴于文章的主题特殊,我想明确声明。 第一步:放弃聊天机器人 立即停止通过聊天机器人(如 ChatGPT、Gemini 网页版等)完成有实质意义的工作。聊天机器人确实有其价值,也是我日常 AI 工作流程的一部分,但在编程场景下,其效用极为有限——因为你基本上是寄希望于模型凭借预训练知识碰巧给出正确答案,而纠错则需要人工(即你本人)反复告知它哪里错了,效率极低。 我认为,几乎所有人与 AI 的第一次接触都是聊天界面。同样,几乎所有人第一次尝试用 AI 辅助编程,也都是向聊天界面输入需求、让它生成代码。 在我还是个坚定的 AI 怀疑论者时,我第一次发出"哇哦"的感叹,是将 Zed 命令面板的截图粘贴给 Gemini,让它用 SwiftUI 复现出来——它的表现之出色令我真正震惊。如今 Ghostty macOS 版中内置的命令面板,正是在 Gemini 几秒内为我生成的代码基础上,仅做了极少量改动后发布的。 但当我试图将这种成功经验复制到其他任务时,却屡屡失望。在存量代码库(brownfield project)的上下文中,聊天界面产出的结果往往很差,我发现自己在代码和命令输出的复制粘贴上来回折腾,效率明显低于亲自动手。 要真正发掘价值,你必须使用智能体(Agent)。智能体是业界公认的术语,指能够在对话循环中调用外部能力的大型语言模型(LLM)1。至少,该智能体必须具备以下能力:读取文件、执行程序,以及发起 HTTP 请求。 第二步:用智能体重现自己的工作 在探索历程的下一阶段,我尝试了 Claude Code 。直说吧:最初我并不买账。每次会话产出的结果都不尽如人意,几乎每次都需要大量的后期修改,这比自己动手还要耗时。我读了不少博客文章、看了不少视频,但依然兴趣寥寥。 没有放弃,我强迫自己用智能体重做所有原本手动完成的提交(commit)。我字面意义上把每件事做了两遍:先手动完成,再与智能体较量,迫使它在质量与功能上达到相同水准(当然,不让它看到我的手动方案)。 这个过程极其痛苦,因为它妨碍了"把事情做完"这一最直接的目标。但我与非 AI 工具打交道的经验足够丰富,深知摩擦阻力是一种自然现象,不把精力耗尽就无法得出坚实可靠的结论。 然而,专业认知在磨砺中逐渐成形。我从第一性原理出发,很快就亲身验证了别人已有的发现——而正因为是自己发现的,底层理解也更为深刻: 将会话拆分为若干清晰、可执行的独立任务,切勿试图在一次超长会话中"一步画完猫头鹰"。 对于模糊的需求,应将工作分拆为独立的规划会话与执行会话,分步推进。 若为智能体提供校验其工作成果的手段,它在大多数情况下能够自主纠错,并有效防止功能退化(regression)。 更宏观地看,我也摸清了当时智能体的能力边界——它们擅长什么、不擅长什么,以及对于它们擅长的任务,如何获得满意的输出。 这一切带来了显著的效率提升——我开始自然而然地使用智能体,感觉不比自己亲手做更慢(尽管也没感觉更快,因为我大部分时间仍在充当"监工")。 这里有一个值得反复强调的"负空间":效率提升的一部分,恰恰来自于清楚地知道何时不该使用智能体。让智能体去尝试它很可能失败的任务,显然是巨大的时间浪费;而掌握这种判断力、主动规避,本身就是一种节省2。 第三步:下班前的智能体任务 为了进一步挖掘效率空间,我开始尝试一种新的工作模式:每天预留最后 30 分钟,用于启动一个或多个智能体任务。我的假设是:如果智能体能够在我无法工作的时间里取得实质进展,或许就能在时间之外创造时间。也就是说:与其在现有的工作时间内多做事,不如在原本"空置"的时间里多做事。 和之前一样,起初我觉得这既无效又令人烦躁。但我很快又梳理出了几类真正奏效的工作: 深度研究型会话:让智能体梳理某个领域,例如找出某种语言中采用特定许可证的所有库,并为每个库生成多页摘要,涵盖优缺点、开发活跃度、社区口碑等维度。 并行探索模糊构想:同时启动多个智能体,分别尝试我还没时间着手的不同想法。我并不指望它们产出可上线的成果,但希望它们能帮我在第二天真正着手时,提前发现一些"未知的未知"。 Issue 与 PR 的分类梳理:智能体善用 gh(GitHub CLI),我编写了一个简单脚本来并行启动多个智能体做 Issue 分类。我不允许智能体直接回复,只需要隔天早上看到报告,帮助我识别高价值或低难度的任务。 需要说明的是,我没有像某些人那样,让智能体整夜不停地循环运行。大多数情况下,任务在半小时内就会完成。但工作日下午的后半段,我通常已经精力耗尽、离开心流状态,个人效率大打折扣——将这段精力转移到启动智能体任务上,让我第二天早上能够"热启动",比以往更快进入工作状态。 ...

2026-03-05 · 1 分钟 · czyt

掌控 LLM 输出:API 层的干预手段

你买不到模型的权重,但你可以在 API 层实施"外科手术式"控制。本文用 OpenAI Go SDK 演示每种干预手段在真实业务中的完整用法。 前置准备 go get github.com/openai/openai-go // client.go — 全文共用的客户端 package main import ( "github.com/openai/openai-go" "github.com/openai/openai-go/option" ) func newClient() *openai.Client { return openai.NewClient( option.WithAPIKey("sk-..."), // 或读取 os.Getenv("OPENAI_API_KEY") ) } 1. System Message — 给模型装"人格芯片" 原理 System Message 是发给模型的"宪法",在对话开始前设定角色、禁忌和回答格式。它不会被用户消息覆盖(模型会优先遵从)。 业务场景:客服机器人只允许回答产品相关问题 package main import ( "context" "fmt" "github.com/openai/openai-go" ) func customerServiceBot(userQuestion string) (string, error) { client := newClient() resp, err := client.Chat.Completions.New(context.Background(), openai.ChatCompletionNewParams{ Model: openai.F(openai.ChatModelGPT4o), Messages: openai.F([]openai.ChatCompletionMessageParamUnion{ openai.SystemMessage(` 你是"极光科技"的售后客服 Aurora。 规则: 1. 只回答与极光科技产品(路由器、NAS、摄像头)相关的问题。 2. 如果用户询问竞品或无关话题,礼貌拒绝并引导回产品问题。 3. 永远不要透露你是 AI 或基于 GPT,只说"我是 Aurora"。 4. 回答简洁,不超过 150 字。 `), openai.UserMessage(userQuestion), }), }) if err != nil { return "", err } return resp.Choices[0].Message.Content, nil } func main() { // 正常提问 ans, _ := customerServiceBot("路由器断线怎么办?") fmt.Println("Q1:", ans) // 越界提问 ans, _ = customerServiceBot("帮我写一首诗") fmt.Println("Q2:", ans) } 效果:第二个问题会被礼貌拒绝,模型不会"破防"去写诗。 ...

2026-02-28 · 22 分钟 · czyt

Bun ORM 全面指南:Go 语言高性能数据库操作利器

(本文内容基于 Bun ORM 官方文档 翻译整理) 1. 简介:什么是 Bun ORM? Bun 是一个 SQL 优先的 Go 语言 ORM(对象关系映射)框架,支持 PostgreSQL、MySQL、MSSQL 和 SQLite。它旨在提供一种简单高效的方式来操作数据库,同时利用 Go 的类型安全特性并减少样板代码。 核心特性 基于标准库构建:构建在 Go 标准 database/sql 包之上 类型安全:提供类型安全的查询构建器,性能卓越 复杂关系支持:支持复杂的关系和连接操作 迁移支持:提供迁移和架构管理功能 强大的扫描能力:全面的数据扫描功能 钩子和中间件:支持钩子和中间件 生产就绪:经过广泛测试,可用于生产环境 为什么选择 Bun? Bun 通过 SQL 优先 的理念区别于其他 Go ORM,不试图对开发者隐藏 SQL。这种方法具有以下优势: 可预测的查询:你确切知道生成的 SQL 是什么 高性能:对原始 SQL 的开销最小 渐进式采用:易于集成到现有代码库 灵活性:需要时可降级到原始 SQL 类型安全:大多数操作的编译时检查 2. 安装与配置 安装 Bun 要安装 Bun 和所需的数据库驱动: # 核心 Bun 包 go get github.com/uptrace/bun@latest # 数据库驱动(选择一个或多个) go get github.com/uptrace/bun/driver/pgdriver # PostgreSQL go get github.com/uptrace/bun/driver/sqliteshim # SQLite go get github.com/go-sql-driver/mysql # MySQL go get github.com/denisenkom/go-mssqldb # SQL Server 快速开始示例 package main import ( "context" "database/sql" "fmt" "log" "github.com/uptrace/bun" "github.com/uptrace/bun/dialect/sqlitedialect" "github.com/uptrace/bun/driver/sqliteshim" "github.com/uptrace/bun/extra/bundebug" ) // User 模型 type User struct { bun.BaseModel `bun:"table:users,alias:u"` ID int64 `bun:",pk,autoincrement"` Name string `bun:",notnull"` Email string `bun:",unique"` } func main() { ctx := context.Background() // 打开数据库连接 sqldb, err := sql.Open(sqliteshim.ShimName, "file::memory:?cache=shared") if err != nil { panic(err) } defer sqldb.Close() // 创建 Bun 数据库实例 db := bun.NewDB(sqldb, sqlitedialect.New()) // 添加查询调试(可选) db.AddQueryHook(bundebug.NewQueryHook( bundebug.WithVerbose(true), )) // 创建表 _, err = db.NewCreateTable().Model((*User)(nil)).IfNotExists().Exec(ctx) if err != nil { panic(err) } // 插入用户 user := &User{Name: "张三", Email: "zhangsan@example.com"} _, err = db.NewInsert().Model(user).Exec(ctx) if err != nil { panic(err) } // 查询用户 var selectedUser User err = db.NewSelect().Model(&selectedUser).Where("email = ?", "zhangsan@example.com").Scan(ctx) if err != nil { panic(err) } fmt.Printf("用户: %+v\n", selectedUser) } 3. 数据库连接配置 PostgreSQL 连接 import ( "database/sql" "github.com/uptrace/bun" "github.com/uptrace/bun/dialect/pgdialect" "github.com/uptrace/bun/driver/pgdriver" ) // 使用 pgdriver(推荐) sqldb := sql.OpenDB(pgdriver.NewConnector( pgdriver.WithDSN("postgres://user:password@localhost:5432/dbname?sslmode=disable"), )) db := bun.NewDB(sqldb, pgdialect.New()) // 或者使用 lib/pq import _ "github.com/lib/pq" sqldb, err := sql.Open("postgres", "postgres://user:password@localhost/dbname?sslmode=disable") if err != nil { log.Fatal(err) } db := bun.NewDB(sqldb, pgdialect.New()) MySQL 连接 import ( "database/sql" "github.com/uptrace/bun/dialect/mysqldialect" _ "github.com/go-sql-driver/mysql" ) sqldb, err := sql.Open("mysql", "user:password@tcp(localhost:3306)/dbname?parseTime=true") if err != nil { panic(err) } db := bun.NewDB(sqldb, mysqldialect.New()) SQLite 连接 import ( "database/sql" "github.com/uptrace/bun/dialect/sqlitedialect" "github.com/uptrace/bun/driver/sqliteshim" ) sqldb, err := sql.Open(sqliteshim.ShimName, "file:test.db?cache=shared&mode=rwc") if err != nil { panic(err) } db := bun.NewDB(sqldb, sqlitedialect.New()) 连接池配置 为了获得最佳性能,配置数据库连接池: ...

2026-02-02 · 9 分钟 · czyt

懒猫微服 Go-SDK 使用指南

本文基于 apps-scheduler 和 cat-led 两个实际项目,介绍懒猫微服 Go-SDK 的使用方法。 SDK 简介 懒猫微服 Go-SDK(gitee.com/linakesi/lzc-sdk)是懒猫微服平台提供的 Go 语言 SDK,允许应用通过 gRPC 与懒猫微服系统交互。SDK 封装了以下核心能力: 应用管理(PkgManager):查询、启动、暂停应用 用户管理(Users):查询用户信息 设备管理(Box):查询设备信息、控制 LED、关机/重启 项目结构 使用 Go-SDK 开发的懒猫应用推荐采用如下项目结构: your-app/ ├── cmd/ │ └── your-app/ │ └── main.go # 应用入口 ├── internal/ │ ├── web/ │ │ └── server.go # Web 服务器配置与路由 │ ├── handlers/ │ │ ├── app.go # SDK 调用相关 handler │ │ └── userinfo.go # 用户信息 handler │ ├── biz/ │ │ └── usecase.go # 业务逻辑与数据库操作 │ ├── auth/ │ │ └── oidc.go # OIDC 认证 │ └── ent/ │ └── schema/ # ent ORM schema 定义 ├── go.mod ├── manifest.yml # 懒猫应用清单 ├── lzc-deploy-params.yml # 部署参数配置(可选) ├── lzc-build.yml # 构建配置 └── icon.png # 应用图标 依赖配置 在 go.mod 中添加 SDK 依赖: ...

2026-02-01 · 9 分钟 · czyt

在Dokploy中通过Cloudflare Tunnel发布应用

通过 Cloudflare Tunnel,你可以不需要公网 IP、不需要在路由器/防火墙开启 80 或 443 端口,就能安全地将 Dokploy 上的应用发布到互联网。 核心流程图 用户 -> Cloudflare 域名 (HTTPS) -> Cloudflare 隧道 -> Docker 内部网络 (HTTP) -> 你的应用容器 第一步:在 Cloudflare 创建隧道 (Tunnel) 登录 Cloudflare Zero Trust 。 进入 Networks -> Tunnels -> Create a Tunnel。 选择 Cloudflared,起个名字(如 my-server)。 在安装页面,找到 Connector Token(那一长串字符串),复制备用。 第二步:在 Dokploy 中部署隧道服务 在 Dokploy 中新建一个 Compose 服务(建议命名为 cloudflare-tunnel),使用以下配置: services: cloudflared: image: 'docker.1ms.run/cloudflare/cloudflared:latest' environment: - 'TUNNEL_TOKEN=你的TOKEN' # 建议在 Environment 变量中设置 networks: - dokploy-network # 必须加入此网络 restart: unless-stopped command: ["tunnel", "--no-autoupdate", "run"] networks: dokploy-network: external: true 第三步:部署应用 (以 Excalidraw 为例) 部署应用时,务必确保它与隧道在同一个 Docker 网络中,以便隧道能通过“服务名”找到它。 ...

2026-01-23 · 1 分钟 · czyt

Git Filer Repo快速指南

本文使用claude code编写,旨在提供一个详尽的 git-filter-repo 使用指南,涵盖安装、基础概念、路径和内容过滤、实用场景、高级功能、安全机制、完整工作流示例、故障排除、性能优化、常见错误与陷阱、与其他工具配合以及最佳实践总结等方面的内容。 什么是 git-filter-repo? git-filter-repo 是一个快速、功能强大的 Git 历史重写工具,是 git filter-branch 的官方推荐替代品。它由 Git 项目贡献者 Elijah Newren 开发,速度比 filter-branch 快 10-100 倍以上。 核心原理: git fast-export <options> | filter | git fast-import <options> git-filter-repo 同时扮演管道编排者和中间过滤器的角色,基于 fast-export 和 fast-import 实现高效的历史重写。 为什么选择 git-filter-repo? vs git filter-branch 特性 git filter-branch git-filter-repo 速度 极慢(大型仓库几乎不可用) 快 10-100 倍 安全性 易出错,可能静默损坏数据 内置多重安全检查 易用性 复杂的 shell 语法 简洁的命令行参数 跨平台 依赖 shell,跨平台问题多 纯 Python,跨平台一致 官方态度 已废弃,不推荐使用 Git 官方推荐 Git 官方警告: filter-branch 的问题无法向后兼容地修复,强烈建议停止使用。 ...

2026-01-13 · 15 分钟 · czyt

Calude Code编写的Ent ORM 完整指南

本文由claude code生成。作为备忘录和分享,欢迎指正和补充。 一、Ent简介 Ent是一个简单但功能强大的实体框架,用于Go语言,使构建和维护具有大型数据模型的应用程序变得容易。 Ent是由Meta(Facebook)开源团队构建的ORM框架,提供了一个API,用于将任何数据库模式建模为Go对象。 核心特性 Ent的主要特性包括: Schema As Code:将任何数据库模式建模为Go对象 轻松遍历任何图结构:运行查询、聚合并轻松遍历任何图结构 静态类型和显式API:100%静态类型和显式API,通过代码生成实现 多存储驱动支持:支持MySQL、PostgreSQL、SQLite和Gremlin 易于扩展:使用Go模板简单扩展和自定义 Ent是一个相当新的ORM,使用代码优先的方法,在Go代码中定义模式。Ent之所以流行,是因为它能够优雅地处理复杂的数据模型和关系。 二、快速开始 2.1 安装Ent # 初始化Go模块 go mod init myapp # 安装ent CLI工具 go install entgo.io/ent/cmd/ent@latest # 或者使用go get go get entgo.io/ent/cmd/ent 2.2 创建第一个Schema # 创建User实体 ent new User 这会在 ent/schema/ 目录下生成一个基础的schema文件: package schema import ( "entgo.io/ent" "entgo.io/ent/schema/field" ) // User holds the schema definition for the User entity. type User struct { ent.Schema } // Fields of the User. func (User) Fields() []ent.Field { return []ent.Field{ field.String("name"). NotEmpty(), field.Int("age"). Positive(), field.String("email"). Unique(), field.Time("created_at"). Default(time.Now), } } // Edges of the User. func (User) Edges() []ent.Edge { return nil } 2.3 生成代码 go generate ./ent 2.4 连接数据库并使用 package main import ( "context" "log" "myapp/ent" _ "github.com/lib/pq" // PostgreSQL // _ "github.com/go-sql-driver/mysql" // MySQL // _ "github.com/mattn/go-sqlite3" // SQLite ) func main() { // 连接PostgreSQL client, err := ent.Open("postgres", "host=localhost port=5432 user=postgres dbname=myapp password=password sslmode=disable") if err != nil { log.Fatalf("failed opening connection to postgres: %v", err) } defer client.Close() // 运行自动迁移 if err := client.Schema.Create(context.Background()); err != nil { log.Fatalf("failed creating schema resources: %v", err) } ctx := context.Background() // 创建用户 user, err := client.User. Create(). SetName("张三"). SetAge(30). SetEmail("zhangsan@example.com"). Save(ctx) if err != nil { log.Fatalf("failed creating user: %v", err) } log.Println("user was created: ", user) } 2.5 使用SQLite3(非CGO驱动) 📋 使用场景 为什么使用非CGO的SQLite驱动? ...

2025-12-12 · 51 分钟 · czyt

在Go里面实现Google和Apple OAuth登录

本文由claude code编写,仅供参考。 在现代应用开发中,提供第三方登录已经成为标配功能。本文将详细介绍如何在Go语言中实现Google和Apple的OAuth登录,以及如何处理iOS和Android的原生登录。 一、OAuth 2.0 基础概念 OAuth 2.0是一个授权框架,允许应用在用户授权的情况下访问用户在第三方服务上的资源,而无需获取用户的密码。主要流程包括: 授权请求:引导用户到OAuth提供商的授权页面 授权确认:用户同意授权 获取授权码:重定向回应用并携带授权码 交换令牌:使用授权码换取访问令牌 访问资源:使用访问令牌获取用户信息 二、Google OAuth登录实现 2.1 前期准备 首先需要在Google Cloud Console创建项目并配置OAuth 2.0凭据: 访问 Google Cloud Console 创建新项目或选择现有项目 启用Google+ API或Google Identity服务 创建OAuth 2.0客户端ID(Web应用、iOS、Android分别创建) 配置授权重定向URI 2.2 安装依赖 go get golang.org/x/oauth2 go get golang.org/x/oauth2/google go get google.golang.org/api/oauth2/v2 2.3 Web端Google登录实现 package main import ( "context" "encoding/json" "fmt" "log" "net/http" "os" "golang.org/x/oauth2" "golang.org/x/oauth2/google" oauth2api "google.golang.org/api/oauth2/v2" "google.golang.org/api/option" ) var googleOauthConfig *oauth2.Config func init() { googleOauthConfig = &oauth2.Config{ ClientID: os.Getenv("GOOGLE_CLIENT_ID"), ClientSecret: os.Getenv("GOOGLE_CLIENT_SECRET"), RedirectURL: "http://localhost:8080/auth/google/callback", Scopes: []string{ "https://www.googleapis.com/auth/userinfo.email", "https://www.googleapis.com/auth/userinfo.profile", }, Endpoint: google.Endpoint, } } // 处理Google登录请求 func handleGoogleLogin(w http.ResponseWriter, r *http.Request) { // 生成随机state参数,防止CSRF攻击 state := generateRandomState() // 将state存储到session中 saveStateToSession(r, w, state) // 生成授权URL url := googleOauthConfig.AuthCodeURL(state, oauth2.AccessTypeOffline) http.Redirect(w, r, url, http.StatusTemporaryRedirect) } // 处理Google回调 func handleGoogleCallback(w http.ResponseWriter, r *http.Request) { // 验证state参数 state := r.FormValue("state") savedState := getStateFromSession(r) if state != savedState { http.Error(w, "Invalid state parameter", http.StatusBadRequest) return } // 获取授权码 code := r.FormValue("code") if code == "" { http.Error(w, "Code not found", http.StatusBadRequest) return } // 交换令牌 token, err := googleOauthConfig.Exchange(context.Background(), code) if err != nil { http.Error(w, "Failed to exchange token: "+err.Error(), http.StatusInternalServerError) return } // 获取用户信息 userInfo, err := getGoogleUserInfo(token) if err != nil { http.Error(w, "Failed to get user info: "+err.Error(), http.StatusInternalServerError) return } // 处理用户信息(创建或更新用户) handleUserLogin(w, r, userInfo) } // 获取Google用户信息 func getGoogleUserInfo(token *oauth2.Token) (*GoogleUserInfo, error) { ctx := context.Background() // 创建OAuth2服务 oauth2Service, err := oauth2api.NewService(ctx, option.WithTokenSource(googleOauthConfig.TokenSource(ctx, token))) if err != nil { return nil, err } // 获取用户信息 userInfo, err := oauth2Service.Userinfo.Get().Do() if err != nil { return nil, err } return &GoogleUserInfo{ ID: userInfo.Id, Email: userInfo.Email, VerifiedEmail: userInfo.VerifiedEmail, Name: userInfo.Name, GivenName: userInfo.GivenName, FamilyName: userInfo.FamilyName, Picture: userInfo.Picture, }, nil } type GoogleUserInfo struct { ID string `json:"id"` Email string `json:"email"` VerifiedEmail bool `json:"verified_email"` Name string `json:"name"` GivenName string `json:"given_name"` FamilyName string `json:"family_name"` Picture string `json:"picture"` } 2.4 Android/iOS原生Google登录处理 对于移动端原生登录,客户端会使用Google SDK获取ID Token,然后发送给后端验证: ...

2025-12-12 · 15 分钟 · czyt

Homebrew Tap 仓库简明指南

本文为Claude整理编写。 什么是 Homebrew Tap Homebrew Tap 是第三方的 Homebrew 软件包仓库。通过创建自己的 Tap,你可以发布和分发自己的软件包,而不需要将它们提交到官方的 Homebrew 仓库。 Tap 的命名规则: homebrew-<tapname> 用户使用时的格式:username/tapname/软件名 Formula vs Casks:核心概念 这是 Homebrew 中最重要的区别,理解这一点对于正确组织你的 Tap 至关重要。 Formula(公式) 用途: 安装命令行工具、从源代码编译的软件、开发库和服务 特点: 可以从源代码编译或安装预编译二进制 安装到 /usr/local/bin(Intel)或 /opt/homebrew/bin(Apple Silicon) 在终端中运行 文件放在 Formula/ 目录 安装命令: brew install git brew install python brew install myapp 适用场景: ✅ 命令行工具(git, wget, curl) ✅ 编程语言(python, node, ruby) ✅ 开发库(openssl, libpq) ✅ 后台服务(redis, nginx, postgresql) ✅ 系统工具和实用程序 Casks(桶) 用途: 安装 macOS 原生应用程序、字体、驱动等 ...

2025-11-21 · 9 分钟 · czyt

Hertz使用笔记

Hertz的优缺点 优点 中文社区维护 稳定,字节产品,有相关的开源项目参考,比如coze和coze studio hz的模板支持,使得代码生成更加灵活 缺点 工程体验上,不如go-kratos等项目。比如不能很好得支持buf等第三方生态。代码生成的使用场景,如多service模式下体验不好。 Template 模板 之所以将模板放在第一,是因为Hertz里面模板是过不去的坎。😄官方的一个mvc的template 或者 cwgo内置的模板 自动生成路由注册 新建一个template/package.yaml layouts: # 覆盖默认 router.go 模板 # 关键:将 Register 函数名改为包含服务名的唯一名称 - path: router.go delims: ['{{', '}}'] body: |- // Code generated by hertz generator. DO NOT EDIT. package {{$.PackageName}} import ( "github.com/cloudwego/hertz/pkg/app/server" {{- range $k, $v := .HandlerPackages}} {{$k}} "{{$v}}" {{- end}} ) /* This file will register all the routes of the services in the master idl. And it will update automatically when you use the "update" command for the idl. So don't modify the contents of the file, or your code will be deleted when it is updated. */ {{define "g"}} {{- if eq .Path "/"}}r {{- else}}{{.GroupName}}{{end}} {{- end}} {{define "G"}} {{- if ne .Handler ""}} {{- .GroupName}}.{{.HttpMethod}}("{{.Path}}", append({{.HandlerMiddleware}}Mw(), {{.Handler}})...) {{- end}} {{- if ne (len .Children) 0}} {{.MiddleWare}} := {{template "g" .}}.Group("{{.Path}}", {{.GroupMiddleware}}Mw()...) {{- end}} {{- range $_, $router := .Children}} {{- if ne .Handler ""}} {{template "G" $router}} {{- else}} { {{template "G" $router}} } {{- end}} {{- end}} {{- end}} // Register register routes based on the IDL 'api.${HTTP Method}' annotation. func Register(r *server.Hertz) { {{template "G" .Router}} } # 覆盖 register.go 模板 # 在这个文件中聚合所有服务的 Register 调用 - path: register.go delims: ['{{', '}}'] update_behavior: type: "append" append_key: "service" insert_key: "{{.ServiceName}}" append_tpl: | {{$.DepPkgAlias}}.Register(r) body: |- // Code generated by hertz generator. DO NOT EDIT. package {{.PackageName}} import ( "github.com/cloudwego/hertz/pkg/app/server" {{$.DepPkgAlias}} "{{$.DepPkg}}" ) // GeneratedRegister registers routers generated by IDL. func GeneratedRegister(r *server.Hertz){ //INSERT_POINT: DO NOT DELETE THIS LINE! {{$.DepPkgAlias}}.Register(r) } 然后service proto都定义为不同的go package包, admin.proto ...

2025-10-30 · 3 分钟 · czyt