pluv/ligent
1
0 Fork 0
Code Actions Releases 1 Activity

init

Browse Source
This commit is contained in:
pluv committed 2026-10-03 14:13:21 +08:00
commit e54390a9f8
85 files changed
+29923
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

Makefile
+583
View File
@@ -0,0 +1,583 @@
CC ?= cc
# 警告就是纪律：这一串是"改完就回不去"的那类问题（影子变量、丢 const、
# 没有原型的函数）。加进来之后新代码写错会当场报出来，而不是等哪天静态分析
# 才捞到。项目在这套 flags 下是零警告的 —— 注意这句话是**连 make test 一起算的**：
# 测试程序用的是同一套 CFLAGS，以前它们里面藏着 5 条 const 丢弃警告，只有跑
# test-unit 才会看到，光看 make 的输出是看不见的。
CFLAGS ?= -std=c99 -D_GNU_SOURCE -O2 -g -Wall -Wextra -Wno-unused-parameter \
-Wshadow -Wwrite-strings -Wstrict-prototypes -Wmissing-prototypes \
-Wold-style-definition -Wpointer-arith \
-Wformat=2 -Wno-format-nonliteral
# -Wformat=2 里值钱的是 -Wformat-security：抓"把变量当格式串"。已经抓到一个 ——
# doctor 里把 HTTPS_PROXY 的值直接喂给 field()，而代理 URL 里带 % 是常事。
# -Wno-format-nonliteral 关掉的是它的噪声面：我们自己那套包装内部转发 fmt 的
# 地方（xvasprintf / err_result / …）天然就是非字面量。可查的部分已经由
# LIGENT_PRINTF 属性在**调用点**查完了。
CPPFLAGS += -Isrc -pthread
# 版本号的 -D 也挂在 CPPFLAGS 上：这样主程序、静态目标、以及二十来条测试规则
# 全都自动带上，不用逐个改。测试程序确实需要它 —— 它们会链 version.c。
CPPFLAGS += $(VERSION_DEFS)
# -lm 是必须的：代码里调了 fabs，而 gcc 会把它折成内建函数，于是"不写 -lm
# 也能链接"是个假象 —— 换个编译器（tcc）或加 -fno-builtin 就会露出来。
# 显式写上，不要靠编译器的好意。
LDLIBS += -lcurl -lm -pthread
# make SAN=1 —— 打开 AddressSanitizer / UndefinedBehaviorSanitizer。
# 链接行也要带，否则只有目标文件被插桩、链接期运行时库没进来。
ifeq ($(SAN),1)
# 注意 override：命令行上传的变量会屏蔽 makefile 里对它的一切赋值（连 += 也算），
# 所以 `make SAN=1 CFLAGS="-O1"` 不加 override 的话会**静默地不带 sanitizer** ——
# 结果是一份没插桩却看起来「干净」的构建。这个坑踩过一次，别再踩。
# -fno-sanitize-recover=all 让报错直接中止，而不是报告完继续跑。
override CFLAGS += -fsanitize=address,undefined -fno-omit-frame-pointer -fno-sanitize-recover=all
override LDLIBS += -fsanitize=address,undefined
endif
BIN := ligent
SRCDIR := src
BUILDDIR := build
# 对象目录带"编译器 + 是否插桩"的标签，见文件末尾"为什么对象目录要带标签"。
BUILD_TAG := $(basename $(notdir $(CC)))$(if $(filter 1,$(SAN)),-san,)
OBJDIR := $(BUILDDIR)/$(BUILD_TAG)
# 头文件也是依赖。以前没有这一条，改了 .h 之后 make 会说"无需做任何事"，
# 目标文件仍然是旧布局 —— 这正是"子代理读到的字段全是垃圾值"那次事故的成因。
# 全量重编只要几秒，不值得为它引入 .d 文件那一套。
HEADERS := $(wildcard $(SRCDIR)/*.h)
# ------------------------------------------------------------------ */
# 版本号：CalVer + git 哈希，构建期算出来注入 */
# ------------------------------------------------------------------ */
#
# 源码里**不写死**版本号，只留一个回退默认值（见 src/version.h 的说明）。
# 这里取真值，用 -D 注入。算法和理由都在 tools/get-version.sh 里。
#
# 用 := 而不是 = ：这段要跑三次 git，展开式变量会在每次引用时重跑一遍。
VERSION_SCRIPT := $(SRCDIR)/../tools/get-version.sh
LIGENT_VERSION := $(shell sh $(VERSION_SCRIPT) 2>/dev/null | sed -n 1p)
LIGENT_GIT_HASH := $(shell sh $(VERSION_SCRIPT) 2>/dev/null | sed -n 2p)
LIGENT_GIT_BRANCH := $(shell sh $(VERSION_SCRIPT) 2>/dev/null | sed -n 3p)
LIGENT_BUILD_DATE := $(shell sh $(VERSION_SCRIPT) 2>/dev/null | sed -n 4p)
LIGENT_BUILD_TIME := $(shell sh $(VERSION_SCRIPT) 2>/dev/null | sed -n 5p)
# 脚本跑不起来（比如没有 sh）时给个明确的默认值，别让 -D 后面空着 ——
# 空的 LIGENT_VERSION 会让预处理器把它当成"没定义"，于是回退到 version.h
# 里的值。那样其实也对，但显式写出来更不容易被误读。
LIGENT_VERSION := $(if $(LIGENT_VERSION),$(LIGENT_VERSION),0.0.0-unknown)
LIGENT_GIT_HASH := $(if $(LIGENT_GIT_HASH),$(LIGENT_GIT_HASH),unknown)
LIGENT_GIT_BRANCH := $(if $(LIGENT_GIT_BRANCH),$(LIGENT_GIT_BRANCH),unknown)
LIGENT_BUILD_DATE := $(if $(LIGENT_BUILD_DATE),$(LIGENT_BUILD_DATE),unknown)
LIGENT_BUILD_TIME := $(if $(LIGENT_BUILD_TIME),$(LIGENT_BUILD_TIME),unknown)
VERSION_DEFS = -DLIGENT_VERSION='"$(LIGENT_VERSION)"' \
-DLIGENT_GIT_HASH='"$(LIGENT_GIT_HASH)"' \
-DLIGENT_GIT_BRANCH='"$(LIGENT_GIT_BRANCH)"' \
-DLIGENT_BUILD_DATE='"$(LIGENT_BUILD_DATE)"' \
-DLIGENT_BUILD_TIME='"$(LIGENT_BUILD_TIME)"'
# ------------------------------------------------------------------ */
# 版本号变了就自动清掉对象，免得 make 拿旧版本号蒙混过关 */
# ------------------------------------------------------------------ */
#
# 这是"make 看不见命令行变量变了"这个坑的第三个入口（前两个：混用编译器
# 导致链接错误、make SAN=1 不重新插桩 —— 那两个是用 build/<tag>/ 分目录解决的）。
#
# 版本号只走 -D，不进任何依赖关系，于是：
# $ make && ./ligent --version # 2027.01.01+...
# $ git tag -d v2027.01.01 # 把 tag 删了
# $ make # "无需做任何事"
# $ ./ligent --version # 还是 2027.01.01 —— **在说谎**
# 二进制看着完全正常，只是版本号是旧的。而这恰恰是 .dirty 标记想避免的那类误导。
#
# 用一个戳文件记下上次构建用的版本串，对不上就把**我们自己的**对象目录清掉。
#
# 为什么不用 `make clean`：那个会连 build/static-prefix 和 build/static-src 一起删
# （用户明确要的语义），而重建静态依赖要联网下载 + 编译好几分钟。为了一个版本号
# 字符串付那个代价不合理。所以这里只删自己的产物，精确地清。
VERSION_STAMP := $(BUILDDIR)/.version-stamp
# 戳文件的内容：版本号 + 哈希 + 构建日期。任意一项变了都要重编 ——
# 比如只切了 tag（版本号变）或只改了工作区（.dirty 出现）。
# 戳文件的内容：把**每一个**注入进二进制的字符串都算进去。任意一项变了都要
# 重编 —— 比如只切了 tag（版本号变）、只改了工作区（.dirty 出现）、只换了
# 分支（branch 变）。少算一项，那一项就会在二进制里过期而 make 毫无察觉，
# 正是这个机制要防的事。
#
# 注意 BUILD_TIME 不在这里：它每秒都在变，算进去等于每次 make 都全量重编。
# 代价是同一分钟内改了源码、二进制里的时间戳可能停在上一分钟 —— 那无所谓，
# 时间戳是"什么时候编的"，不是"源码什么时候改的"，而日期（BUILD_DATE）在，
# 粒度够用了。
VERSION_FINGERPRINT := $(LIGENT_VERSION)|$(LIGENT_GIT_HASH)|$(LIGENT_GIT_BRANCH)|$(LIGENT_BUILD_DATE)
# 用 $(shell) 在每个 make 里比对一次。
# 注意 $(if $(filter-out X,Y),...) 在 Y 为空时**恒为假** —— filter-out 一个
# 空列表得到空列表，什么都过滤不掉。所以这里必须显式处理"戳文件不存在"这一
# 情况（第一次构建就是它），否则戳文件永远写不出来，机制整个失效。
CURRENT_STAMP := $(shell cat $(VERSION_STAMP) 2>/dev/null)
ifeq ($(CURRENT_STAMP),)
NEED_VERSION_CLEAN := 1
else ifneq ($(CURRENT_STAMP),$(VERSION_FINGERPRINT))
NEED_VERSION_CLEAN := 1
else
NEED_VERSION_CLEAN :=
endif
ifeq ($(NEED_VERSION_CLEAN),1)
# 清掉再让 make 正常评估依赖 —— 这一步发生在**读 Makefile 的时候**，
# 所以后面的 $(OBJS) 会看到"对象不存在"，自然全量重编。
# 在 $(shell) 里写文件是安全的：它只在真的需要清的时候跑一次。
$(shell rm -rf $(OBJDIR) $(BIN) && mkdir -p $(BUILDDIR) && printf '%s' '$(VERSION_FINGERPRINT)' > $(VERSION_STAMP))
endif
# $^ 里既有 .c 也有 .h（后者是为了依赖关系才加上的），真正要编译的只有 .c
SRCFILES = $(filter-out %.h,$^)
SRCS := $(wildcard $(SRCDIR)/*.c)
OBJS := $(patsubst $(SRCDIR)/%.c,$(OBJDIR)/%.o,$(SRCS))
.PHONY: all clean test test-unit test-e2e test-fuzz demo md_demo static static-check static-test check-docs analyze docker-build docker-extract docker-test docker-clean
all: $(BIN)
$(BIN): $(OBJS)
$(CC) $(CFLAGS) -o $@ $(OBJS) $(LDLIBS)
$(OBJDIR)/%.o: $(SRCDIR)/%.c $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -c -o $@ $<
$(OBJDIR):
mkdir -p $(OBJDIR)
# 清掉**一切**构建产物：
# build/ 各 <编译器>[-san] 对象目录、build/static、测试可执行文件、
# e2e 的临时文件，以及 tools/build-static-deps.sh 编出来的
# static-prefix（静态库）和 static-src（源码 + 压缩包缓存）
# ligent / ligent-static
# tests/__pycache__ 跑测试时 python 生成的字节码
#
# 特意**不动** ligent.history：那不是构建产物，是你的输入历史，删了找不回来。
# （e2e 自己写的是 build/e2e.history，在 build/ 里，跟着一起清。）
clean:
rm -rf $(BUILDDIR) $(BIN) $(BIN)-static tests/__pycache__
# ------------------------------------------------------------------ */
# 静态构建：musl libc + 静态 libcurl */
# ------------------------------------------------------------------ */
#
# 目标是一个**完全静态**的可执行文件：不依赖宿主机的 libc、libcurl、
# OpenSSL。拷到任何同架构的 Linux 上就能跑。
#
# 为什么不能直接拿发行版的 libcurl.a 链接：那是针对 glibc 编的，和 musl 混在
# 一起会得到一堆 "undefined reference to __libc_start_main" 之类。必须有一份
# **用 musl 工具链编出来的**静态 libcurl。造它的办法见 tools/build-static-deps.sh。
#
# 用法：
# ./tools/build-static-deps.sh # 先把依赖编到 build/static-prefix
# make static # 然后链接
#
# 变量（都可覆盖）：
# STATIC_CC 默认依次找 musl-gcc / x86_64-linux-musl-gcc
# STATIC_PREFIX 依赖所在的前缀（默认 build/static-prefix）
STATIC_CC ?= $(shell command -v musl-gcc 2>/dev/null || \
command -v x86_64-linux-musl-gcc 2>/dev/null)
STATIC_PREFIX ?= $(BUILDDIR)/static-prefix
STATIC_BIN := $(BIN)-static
# 静态目标用**独立的对象目录**：那边的 .o 是 musl 编的，和这边的 glibc 目标
# 文件混在一起会互相覆盖，症状是莫名其妙的重链接或不重链接。
STATIC_OBJDIR := $(BUILDDIR)/static
STATIC_OBJS := $(patsubst $(SRCDIR)/%.c,$(STATIC_OBJDIR)/%.o,$(SRCS))
static-check:
@test -n "$(STATIC_CC)" || { \
echo "找不到 musl 工具链。装一个，或者指定 STATIC_CC："; \
echo " Artix/Arch : sudo pacman -S musl # 提供 musl-gcc"; \
echo " 或者用交叉工具链: make static STATIC_CC=x86_64-linux-musl-gcc"; \
exit 1; }
@test -d "$(STATIC_PREFIX)" || { \
echo "找不到静态依赖前缀 $(STATIC_PREFIX)。先跑："; \
echo " ./tools/build-static-deps.sh"; \
exit 1; }
@test -x "$(STATIC_PREFIX)/bin/curl-config" || { \
echo "$(STATIC_PREFIX) 里没有 curl-config —— 那份 libcurl 不是在这个"; \
echo "前缀下编的，或者没编完。重跑 ./tools/build-static-deps.sh"; \
exit 1; }
$(STATIC_OBJDIR):
mkdir -p $(STATIC_OBJDIR)
# -I$(STATIC_PREFIX)/include：musl-gcc **不搜 /usr/include**，系统那份 curl 头
# 也不是给 musl 用的 —— 必须用我们这份 prefix 里的头。
STATIC_CPPFLAGS = -I$(STATIC_PREFIX)/include $(CPPFLAGS)
$(STATIC_OBJDIR)/%.o: $(SRCDIR)/%.c $(HEADERS) | $(STATIC_OBJDIR)
$(STATIC_CC) $(STATIC_CFLAGS) $(STATIC_CPPFLAGS) -c -o $@ $<
# 依赖列表交给 curl 自己报：它最清楚自己链了哪些库、什么顺序。
# 手写一串 -lssl -lcrypto -lz 是会过期的，而且顺序错了链接就失败。
static: static-check $(STATIC_OBJS)
@CURL_CONFIG="$(STATIC_PREFIX)/bin/curl-config"; \
LIBS="$$($$CURL_CONFIG --static-libs)" || exit 1; \
echo " 依赖: $$LIBS"; \
$(STATIC_CC) $(STATIC_CFLAGS) $(STATIC_CPPFLAGS) $(STATIC_LDFLAGS) \
-o $(STATIC_BIN) $(STATIC_OBJS) $$LIBS -pthread; \
echo " 产物: $(STATIC_BIN)"; \
file $(STATIC_BIN) 2>/dev/null || true; \
ldd $(STATIC_BIN) 2>&1 | head -2 || true
# -fno-pie / -no-pie：现代 gcc 默认编 PIE，而静态链接一份非 PIC 的 .a
# （我们那份 libcurl.a 就是 -fno-pie 编的）会报
# "relocation R_X86_64_32 against ... can not be used when making a PIE object"。
# 两头都关掉，省得踩。
STATIC_CFLAGS ?= $(CFLAGS) -fno-pie
STATIC_LDFLAGS ?= -static -no-pie
# ------------------------------------------------------------------ */
# 静态产物优先体积（make static STATIC_RELEASE=0 关掉） */
# ------------------------------------------------------------------ */
#
# 普通构建的取舍是"能调试"，静态产物的取舍是"拷过去就能跑、越小越好"，
# 所以这里单独一套开关。实测 6.23 MB → 4.85 MB（-22%），逐项收益：
#
# -s 4.92 MB 链接期 strip。**单项最大**：-g 带进来的调试信息
# (551 KB) 加上符号表，一共 1.31 MB —— 占了原产物的
# 五分之一，而静态发布件根本用不上。
# -ffunction-sections 4.91 MB 只对我们自己的 .o 生效，所以几乎没用
# -fdata-sections （收益来自后面 --gc-sections 能按函数/数据丢段；
# 依赖库的 .a 不是这么编的，见下面的"还能再小"）
# -fno-*-unwind-tables 4.90 MB .eh_frame 本来 514 KB。C 代码不需要
# C++ 异常和栈回溯。
# -Os 4.86 MB 我们自己的代码优先体积
# -z noseparate-code 4.85 MB 不再为代码/数据段留页对齐空洞
# --build-id=none 少一个 note 段
# -g0 不生成调试信息（否则每个 .o 都白白大一截，
# 编译也慢，反正最后要 strip）
#
# 还能再小的地方（不在本文件范围）：3.49 MB 的 .text 几乎全是 libcurl +
# OpenSSL。要动它得在 tools/build-static-deps.sh 里给依赖也加 -Os 和
# -ffunction-sections，让 --gc-sections 能真正丢进没被引用的 OpenSSL 代码。
STATIC_RELEASE ?= 1
ifeq ($(STATIC_RELEASE),1)
STATIC_CFLAGS += -Os -g0 -ffunction-sections -fdata-sections \
-fno-asynchronous-unwind-tables -fno-unwind-tables
STATIC_LDFLAGS += -Wl,--gc-sections -Wl,-z,noseparate-code \
-Wl,--build-id=none -s
endif
# ------------------------------------------------------------------
# 渲染效果演示
# ------------------------------------------------------------------
$(OBJDIR)/md_demo: tools/md_demo.c $(SRCDIR)/markdown.c $(SRCDIR)/util.c $(SRCDIR)/i18n.c | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
# 编译并直接跑起来看效果
demo: $(OBJDIR)/md_demo
@./$(OBJDIR)/md_demo
# 只编译，不运行
md_demo: $(OBJDIR)/md_demo
# ------------------------------------------------------------------
# 测试
# ------------------------------------------------------------------
#
# 测试与演示程序**复用主构建编出来的 .o**（只链它真正需要的那几个模块），而不是
# 每个测试各自把源文件重新编译一遍。
#
# 以前每条规则的依赖写的是源文件（$(SRCDIR)/json.c 之类），recipe 是
# `$(CC) … -o $@ $(SRCFILES)` —— 于是同一个源文件会被编很多遍：只改 util.c 一行，
# 它会按依赖被重编 16 次，实测 `make test-unit` 要 25 秒，而真正的工作量只有
# "编一个 util.o + 重链 17 个二进制"。现在依赖写成 .o：编译一次、链接多次，
# 同样的场景降到几秒。而这些 .o 主构建本来就要用，等于没有额外成本。
#
# 代价：测试的依赖里多了一层（.o 是否存在/是否过期由主构建的规则负责），排查
# "为什么这个测试用的还是旧代码"要看 .o 的时间戳而不是源文件。$(SRCFILES) 仍然
# 有意义 —— $^ 里混着 $(HEADERS)，而头文件不能上链接行。
$(OBJDIR)/test_json: tests/test_json.c $(OBJDIR)/json.o $(OBJDIR)/util.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_tools: tests/test_tools.c $(OBJDIR)/tools.o $(OBJDIR)/json.o \
$(OBJDIR)/util.o $(OBJDIR)/http.o $(OBJDIR)/spinner.o \
$(OBJDIR)/image.o $(OBJDIR)/priv.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_agent: tests/test_agent.c $(OBJDIR)/agent.o $(OBJDIR)/llm.o \
$(OBJDIR)/json.o $(OBJDIR)/util.o $(OBJDIR)/http.o \
$(OBJDIR)/tools.o $(OBJDIR)/markdown.o \
$(OBJDIR)/spinner.o $(OBJDIR)/confirm.o \
$(OBJDIR)/image.o $(OBJDIR)/capability.o \
$(OBJDIR)/archive.o \
$(OBJDIR)/priv.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_config: tests/test_config.c $(OBJDIR)/config.o $(OBJDIR)/json.o \
$(OBJDIR)/util.o $(OBJDIR)/http.o \
$(OBJDIR)/spinner.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_meta: tests/test_meta.c $(OBJDIR)/meta.o $(OBJDIR)/agent.o \
$(OBJDIR)/json.o $(OBJDIR)/util.o $(OBJDIR)/http.o \
$(OBJDIR)/llm.o $(OBJDIR)/lineedit.o \
$(OBJDIR)/tools.o $(OBJDIR)/markdown.o \
$(OBJDIR)/spinner.o $(OBJDIR)/confirm.o \
$(OBJDIR)/image.o $(OBJDIR)/capability.o \
$(OBJDIR)/archive.o \
$(OBJDIR)/priv.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_priv: tests/test_priv.c $(OBJDIR)/priv.o $(OBJDIR)/util.o \
$(OBJDIR)/http.o $(OBJDIR)/spinner.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_attach: tests/test_attach.c $(OBJDIR)/attach.o \
$(OBJDIR)/image.o $(OBJDIR)/json.o $(OBJDIR)/util.o \
$(OBJDIR)/lineedit.o $(OBJDIR)/http.o \
$(OBJDIR)/spinner.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_models: tests/test_models.c $(OBJDIR)/models.o \
$(OBJDIR)/json.o $(OBJDIR)/util.o \
$(OBJDIR)/http.o $(OBJDIR)/spinner.o $(OBJDIR)/config.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_capability: tests/test_capability.c $(OBJDIR)/capability.o \
$(OBJDIR)/json.o $(OBJDIR)/util.o \
$(OBJDIR)/http.o $(OBJDIR)/spinner.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_image: tests/test_image.c $(OBJDIR)/image.o $(OBJDIR)/json.o \
$(OBJDIR)/util.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_i18n: tests/test_i18n.c $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_spinner: tests/test_spinner.c $(OBJDIR)/spinner.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_markdown: tests/test_markdown.c $(OBJDIR)/markdown.o \
$(OBJDIR)/util.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_http: tests/test_http.c $(OBJDIR)/http.o $(OBJDIR)/util.o \
$(OBJDIR)/spinner.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_archive: tests/test_archive.c $(OBJDIR)/archive.o $(OBJDIR)/json.o \
$(OBJDIR)/util.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/test_lineedit: tests/test_lineedit.c $(OBJDIR)/lineedit.o \
$(OBJDIR)/util.o $(OBJDIR)/http.o \
$(OBJDIR)/spinner.o $(OBJDIR)/i18n.o $(HEADERS) | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
$(OBJDIR)/fuzz: tests/fuzz.c $(OBJDIR)/json.o $(OBJDIR)/markdown.o \
$(OBJDIR)/util.o $(OBJDIR)/i18n.o | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
# 单元测试清单：加一个测试只要改这里 + 它自己那条依赖规则
UNIT_TESTS := test_json test_tools test_agent test_config test_markdown \
test_http test_lineedit test_archive test_meta test_image \
test_capability test_priv test_attach test_models test_spinner \
test_i18n
test-unit: $(addprefix $(OBJDIR)/,$(UNIT_TESTS)) $(OBJDIR)/md_demo $(OBJDIR)/fuzz
@export LIGENT_LANG=zh; for t in $(UNIT_TESTS); do \
case $$t in \
test_json) label="JSON" ;; \
test_tools) label="工具" ;; \
test_agent) label="agent 上下文" ;; \
test_config) label="配置" ;; \
test_markdown) label="Markdown 渲染" ;; \
test_http) label="HTTP 层" ;; \
test_lineedit) label="行编辑器" ;; \
test_archive) label="存档" ;; \
test_meta) label="meta 历史编辑" ;; \
test_image) label="图片" ;; \
test_capability) label="能力探测" ;; \
test_priv) label="提权" ;; \
test_attach) label="/include 暂存与展开" ;; \
test_models) label="模型列表解析" ;; \
test_spinner) label="等待动画" ;; \
test_i18n) label="界面文案" ;; \
*) label="$$t" ;; \
esac; \
echo "==== $$label 测试（$$t）===="; \
./$(OBJDIR)/$$t || exit 1; \
echo; \
done
@echo "==== 演示程序分片自检 ===="
@./$(OBJDIR)/md_demo --compare < /dev/null
@echo
@echo "==== 颜色审计（只用 16 色内的 SGR） ===="
@./tools/check-colors.sh
@echo
@echo "==== 模糊测试（每轮固定种子，可复现） ===="
@./$(OBJDIR)/fuzz 4000
test-e2e: $(BIN)
@bash tests/run_e2e.sh
# ------------------------------------------------------------------ */
# make check-docs —— README 里写的测试数量必须和现实一致 */
# ------------------------------------------------------------------ */
#
# README 里引用了"831 单元 + 314 e2e"这样的数字。数字会随着加测试而过期，
# 而过期的数字比不写更糟 —— 它是**错的信息**，读的人没有理由怀疑它。
# （这件事就发生过：加完 JSON 的 UTF-8 测试后，README 还写着 797。）
#
# 所以把"文档说的"和"实际跑出来的"对一遍。不做成 make test 的一部分：
# 它要跑一遍单元测试来数数，比 test-unit 本身还慢。
check-docs: $(addprefix $(OBJDIR)/,$(UNIT_TESTS)) $(BIN)
@unit=0; \
for t in $(UNIT_TESTS); do \
n=$$(./$(OBJDIR)/$$t 2>/dev/null | grep -oE '^[0-9]+ 项检查' | grep -oE '^[0-9]+'); \
unit=$$((unit + $${n:-0})); \
done; \
e2e=$$(bash tests/run_e2e.sh 2>/dev/null | grep -oE '通过 [0-9]+ 项' | grep -oE '[0-9]+' | tail -1); \
unit_doc=$$(grep -oE '（[0-9]+ 单元' README.md | grep -oE '[0-9]+' | head -1); \
unit_docs=$$(grep -oE '[0-9]+ 个可执行、[0-9]+ 项' README.md | grep -oE '[0-9]+ 项' | grep -oE '[0-9]+' | head -1); \
e2e_doc=$$(grep -oE '[0-9]+ e2e' README.md | grep -oE '[0-9]+' | head -1); \
bad=0; \
if [ "$$unit" != "$$unit_doc" ]; then \
echo " ✗ 单元测试：README 说 $$unit_doc，实际 $$unit"; bad=1; \
else echo " ✓ 单元测试 $$unit 项，与 README 一致"; fi; \
if [ "$$unit" != "$$unit_docs" ]; then \
echo " ✗ SAN 那节：README 说 $$unit_docs，实际 $$unit"; bad=1; \
else echo " ✓ SAN 那节的数量一致"; fi; \
if [ "$$e2e" != "$$e2e_doc" ]; then \
echo " ✗ e2e：README 说 $$e2e_doc，实际 $$e2e"; bad=1; \
else echo " ✓ e2e $$e2e 项，与 README 一致"; fi; \
if [ $$bad -eq 0 ]; then echo "文档里的数量与现实一致。"; \
else echo "README 里的数字已过期，请更新（数字对不上就是错的信息）。"; exit 1; fi
# 拿同一套 e2e 打静态产物。以前"静态构建可用"实际上只等于"它能启动" ——
# 依赖脚本的自检只做 curl_easy_init + setopt，连一个请求都不发；现在这 300
# 多项跑一遍，才真的说明它是可用的。
# 单独一个目标、不进 make test：要先编依赖，慢。
static-test: static
@BIN="$(abspath $(STATIC_BIN))" bash tests/run_e2e.sh
# ------------------------------------------------------------------ */
# 容器里构建静态产物（CI/CD 用） */
# ------------------------------------------------------------------ */
#
# podman 和 docker 命令行兼容，默认用 podman（这个项目在 rootless 环境下开发）。
# 用 CONTAINER=... 换。
CONTAINER ?= podman
CONTAINER_IMAGE ?= ligent-static
# 版本号显式传给容器：容器里没有 .git，get-version.sh 只能回退到源码 mtime，
# 那得到的是"文件日期"而不是"tag 日期"。这里在本机算好传进去。
# GIT_HASH / GIT_BRANCH 同理 —— 二进制里的分支名应当反映**源码来自哪个分支**，
# 而不是"在容器里看不到分支所以是 unknown"。$(VERSION_SCRIPT) 见上面。
CONTAINER_VERSION := $(LIGENT_VERSION)
CONTAINER_GIT_HASH := $(LIGENT_GIT_HASH)
CONTAINER_GIT_BRANCH := $(LIGENT_GIT_BRANCH)
# 传**完整时间戳**而不是只有日期：Dockerfile 里拿它当 SOURCE_DATE_EPOCH，
# 而 "2026-09-22" 被 date(1) 解析出来是那天的 00:00:00 UTC —— 于是容器产物
# 的 --version 里时间永远显示午夜。传秒数就没有这个歧义，而且仍然可复现。
# 设了 SOURCE_DATE_EPOCH 的话就沿用它（那正是"可复现构建"要求的：同一份
# 源码无论何时构建都得到同样的时间戳）。
CONTAINER_BUILD_EPOCH := $(if $(SOURCE_DATE_EPOCH),$(SOURCE_DATE_EPOCH),$(shell date -u +%s))
docker-build:
$(CONTAINER) build \
--build-arg VERSION='$(CONTAINER_VERSION)' \
--build-arg GIT_HASH='$(CONTAINER_GIT_HASH)' \
--build-arg GIT_BRANCH='$(CONTAINER_GIT_BRANCH)' \
--build-arg BUILD_EPOCH='$(CONTAINER_BUILD_EPOCH)' \
-t $(CONTAINER_IMAGE) .
# 把产物从镜像里拷出来。用 create+cp+rm 而不是 build 到本地：
# 镜像是分发单位，本地文件是给人直接用的，两者都要，但不必让 Dockerfile
# 同时干这两件事（那需要挂载点或者 --output，podman/docker 的支持还不齐）。
docker-extract: docker-build
@$(CONTAINER) rm -f $(CONTAINER_IMAGE)-tmp >/dev/null 2>&1 || true
@$(CONTAINER) create --name $(CONTAINER_IMAGE)-tmp $(CONTAINER_IMAGE) >/dev/null
@$(CONTAINER) cp $(CONTAINER_IMAGE)-tmp:/ligent $(STATIC_BIN)
@$(CONTAINER) rm -f $(CONTAINER_IMAGE)-tmp >/dev/null
@echo " 产物: $(STATIC_BIN) ($$(stat -c%s $(STATIC_BIN) 2>/dev/null || echo '?') 字节)"
@file $(STATIC_BIN) 2>/dev/null || true
# 容器产物也要过一遍 e2e —— 和 static-test 一个道理：能跑起来不等于能用。
docker-test: docker-extract
@BIN="$(abspath $(STATIC_BIN))" bash tests/run_e2e.sh
docker-clean:
-@$(CONTAINER) rmi -f $(CONTAINER_IMAGE) >/dev/null 2>&1 || true
# 对抗性模糊测试：单独一个目标，跑得久一些
# 对抗性模糊测试：单独一个目标，轮数比 test-unit 里那个底线大得多
test-fuzz: $(OBJDIR)/fuzz
@echo "==== 模糊测试（20 万轮）===="
@./$(OBJDIR)/fuzz 200000
# `make -j test` 会让单元测试与 e2e 并行，输出互相穿插、也互相抢资源 ——
# 这两个目标内部本来就是逐条跑的，没有并行的必要。
.NOTPARALLEL: test test-unit test-e2e
test: test-unit test-e2e
@echo
@echo "全部测试通过。"
# 依赖统一由 $(HEADERS) 管：每个 .o 和每个测试都以全部头文件为依赖。
# 不精确，但一共只有十几个文件、全量重编几秒钟，换来的是「永远不会漏」。
# 原先这里还有一段手写依赖表，既冗余又不完整（上次 agent.h 漏更新就是它
# 没跟上），已删。
$(OBJDIR)/reduce: tests/reduce.c $(OBJDIR)/markdown.o $(OBJDIR)/util.o \
$(OBJDIR)/i18n.o | $(OBJDIR)
$(CC) $(CFLAGS) $(CPPFLAGS) -o $@ $(SRCFILES) $(LDLIBS)
# ------------------------------------------------------------------ */
# make analyze —— gcc 静态分析器（-fanalyzer） */
# ------------------------------------------------------------------ */
#
# 它抓的是单靠警告看不出来的那类问题：读未初始化的值、空指针、资源泄漏。
# 第一次跑就捞出两个真 bug（attempt() 里 curl_easy_init 失败那条提前返回
# 会把未初始化的 cerr 当字符串读；POST 分支对 body==NULL 不设防）。
#
# 用 -O0 而不是平时的 -O2：开了优化之后 gcc 会内联，而 -fanalyzer 的跨函数
# 状态在遇到内联时并不可靠 —— image.c 里的 rand_suffix 在 -O1/-O2/-Os 下会
# 报一条 "leak of FILE 'f'"，而 -O0 下干净，fclose 也确实就写在 fread 下一行。
# 分析器自己的分析是跨函数的，不依赖 -O 级别，所以 -O0 不会少查什么。
# gcc 文档同样建议 -fanalyzer 配 -O0。
#
# 单独一个目标、不进 make test：它比整个测试套件加起来还慢。
analyze:
@fail=0; \
for f in $(SRCS); do \
$(CC) $(CFLAGS) -O0 -fanalyzer -Werror $(CPPFLAGS) -c "$$f" -o /dev/null || fail=1; \
done; \
if [ $$fail -eq 0 ]; then \
echo "静态分析通过：无告警。"; \
else \
echo "静态分析发现问题（上面的 warning: 就是原因）。"; exit 1; \
fi
# ------------------------------------------------------------------ */
# 为什么对象目录要带标签（build/gcc、build/clang、build/gcc-san …） */
# ------------------------------------------------------------------ */
#
# make 只按"源文件比目标文件新"决定要不要重编，它**看不见命令行变量变了**。
# 于是有两类事故：
#
# 1) make CC=tcc 之后再 make CC=clang —— 只有被 touch 过的那几个 .o 是 clang
# 编的，其余还是 tcc 编的。tcc 的目标文件要 tcc 自己的运行时辅助例程
# （__floatundidf 之类），拿 clang 去链接就是一堆 undefined reference。
# 我自己的构建就是这么炸的，而且第一次还因为只用 ls 看文件大小而误判成
# "clang 编译通过"。
#
# 2) 更要命的一类：make 之后再 make SAN=1 —— 一个 .o 都不会重编。
# 链接行带着 -fsanitize=...，ASan 运行时也进了二进制，于是它**看起来**
# 是插桩过的；实际 nm 里一个 __asan/__ubsan 符号都没有，什么都不会检测。
# 这意味着"没先 make clean 的 ASan 结论全是假绿灯"。
#
# 把标签写进路径之后这两种混用都不可能发生了：配置一变，对应的目录就是空的，
# 该编的自然会全编。全量重编只要几秒，值得。
#
# 注意 STATIC_PREFIX / STATIC_OBJDIR 挂在 $(BUILDDIR) 上而不是 $(OBJDIR) 上：
# build/static-prefix 是 tools/build-static-deps.sh 写死的位置，不能被标签带跑。