Files
marqdo/scripts/dev-env.sh
T
cflmy 42a1a46383 docs: 链接式调用 [函数名](参数) 评估 + 开发环境脚本 dev-env.sh
两件事:

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 记录环境安装过程与前后对比。
2026-10-22 11:59:14 +08:00

39 lines
1.6 KiB
Bash
Executable File

#!/usr/bin/env bash
# Marqdo dev environment for this sandbox (glibc 2.36 host, no system gcc/python3/go).
#
# Usage: source scripts/dev-env.sh
#
# Everything lives under target/toolchain/ (bundled): rust 1.81, zig 0.13 (as cc),
# go 1.25, python 3.12. Zig also solves the "release binary needs GLIBC_2.39"
# problem by targeting x86_64-linux-gnu.2.36.
#
# Two non-obvious constraints this script encodes:
# 1. $HOME is not writable -> zig/rust caches must be redirected explicitly.
# 2. /tmp is a noexec tmpfs -> anything a build *executes* from a temp dir
# fails with "AccessDenied" (zig link step) or "signal: aborted" (go link
# step via gcc). TMPDIR must point at a writable+executable dir.
_marqdo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
_tc="$_marqdo_root/target/toolchain"
_zshim="/workspace/qdagent/.tools/zigcc"
export RUSTUP_HOME="$_tc/rustup"
export CARGO_HOME="$_tc/cargo"
export GOCACHE="$_tc/gocache"
export GOPATH="$_tc/gopath"
export TMPDIR="$_tc/gotmp"
export ZIG_GLOBAL_CACHE_DIR="/workspace/qdagent/.tools/zigcache"
export ZIG_LOCAL_CACHE_DIR="/workspace/qdagent/.tools/zigcache"
export PATH="$_zshim/bin:$_tc/python/bin:$_tc/go/bin:$_tc/cargo/bin:$PATH"
# Rust: link through zig cc pinned to glibc 2.36 so the binary runs on this host.
export CC="$_zshim/cc"
export CXX="$_zshim/cc"
export AR="$_zshim/ar"
export CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_LINKER="$_zshim/cc"
mkdir -p "$TMPDIR" "$GOCACHE" "$GOPATH" "$ZIG_GLOBAL_CACHE_DIR"
echo "marqdo dev-env: rust=$(rustc --version 2>/dev/null | cut -d' ' -f2) go=$(go version 2>/dev/null | awk '{print $3}') python=$(python3 --version 2>&1 | awk '{print $2}') cc=zig-glibc2.36"