两件事:
1. doc/design/link-style-call-evaluation.md(Proposed · 待决策)
评估用户提议的 Markdown 链接式调用 [函数名](参数…)。
结论:语法优雅,但与既有特性「链接索引 [key](map)」形状完全相同,无法可靠消歧。
实测证据:
- [a](m) → 链接索引,取成员,返回 1(既有特性,v0.3 明确推广)
- [greet](alice) → 被当链接索引处理,报 undefined variable alice
两者区别只在「greet 是函数还是键名」,需要符号表信息,而语法判定发生在
解析期(跨模块时未知)。若靠「已知函数表」消歧,会把清晰的
missing map key 变成误导性的 unknown function。
给出四个受限方案并对比,推荐 L3:用「] 与 ( 之间是否有空格」消歧
- [key](coll) 紧贴 → 链接索引,语义一字不动(零回归)
- [callee] (args) 有空格 → 调用,参数显式成组,顺带解决 D8 空格函数名
并附 8 条验证计划。未改任何代码。
2. scripts/dev-env.sh(新增,可 source 复用)
本机测试环境缺失导致基线本来就有失败,本次装好并固化:
- 约束1:$HOME 不可写 → zig/rust 缓存显式重定向
- 约束2:/tmp 是 noexec tmpfs → TMPDIR 必须指向可写且可执行目录
(这是 Go 链接报 "signal: aborted"、zig 报 AccessDenied 的真正原因)
- 提供 rust 1.81 / go 1.25 / python 3.12 / gcc shim(zig, glibc 2.36)
环境修复前后:
- 无 python3:231 passed / 2 failed
- 加 python3:233 / 0(lib)
- 加 go + libweb:gold 284 / 0
- 全量:554 passed / 0 failed
libweb.so 构建要点:Go cgo 需要 gcc,用 zig cc 充当
(/workspace/qdagent/.tools/zigcc/bin/gcc,过滤 Go 传入的
-Qunused-arguments,该参数会让 zig 驱动 abort)。
变更文档同步追加 §8 记录环境安装过程与前后对比。
Marqdo plugins/web — Go (C ABI v2)
施工图:doc/design/ext-web-go-rewrite.md · ADR:0004
Default native web plugin (W-G13). plugin.native_path name=web resolves plugins/web/build/libweb.so (and copies under target/{debug,release}/).
Build
./scripts/build-web-plugin.sh
# → plugins/web/build/libweb.so
# → also copied to target/debug|release/libweb.so
Requires Go 1.22+ with cgo (CGO_ENABLED=1) and a C toolchain.
Override path: export MARQDO_WEB_PLUGIN=$PWD/plugins/web/build/libweb.so
Layout
| Path | Role |
|---|---|
plugin.go / abi_*.go |
//export ABI entry + registration |
abi/marqdo_abi_cgo.h |
C contract for cgo |
internal/* |
page / db / http / ws / … |
Rust reference (not built by default): plugins/web-rust-archive/.