Files
marqdo/doc/adr/0004-web-plugin-go.md
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

1.8 KiB
Executable File
Raw Permalink Blame History

ADR 0004:网络拓展库原生实现改为 Go

历史说明(2026-11-10):下文业务站点仅记录当时决策背景,相关工程已移出本仓库;当前验收使用维护中的完整站点、网络站点及隔离测试,见 当前工作流。

Status Accepted
Date 2026-09-10
Related ext-web-go-rewrite.md · ext-abi.md · 0001-implementation-language.md

Context

  • Marqdo 宿主/解释器仍为 Rust(ADR 0001 不变)。
  • 官方插件契约是稳定 C ABI(include/marqdo_abi.h),不绑定 Rust ABI。
  • plugins/web(Rust/axum)已具备 W0–W8 等能力,但迭代成本高;且需验证多语言插件生态。
  • 产品目标:网络拓展库支撑完整网页制备,并以暗恋见君(外接 PostgreSQL + Redis)验收;应用层前后端均为 Marqdo 脚本。

Decision

  1. 重写 plugins/web 为 Go 共享库(-buildmode=c-shared),产物名仍为 libweb.so / web.dll / libweb.dylib。
  2. ABI 全量兼容(函数名、参数、语义);ext/web 作者面默认不动。
  3. 施工图:ext-web-go-rewrite.md。禁止在旧 Rust 插件上继续打补丁演进(ext-web C5)。
  4. 其它官方插件(agent / quantum / linalg)暂不强制改语言;Go web 作为多语言样板。

Consequences

  • 构建与发版需安装 Go;CI/marqdo ext add web 增加 go build 回退。
  • 根 Cargo workspace 不再包含 plugins/web Rust crate(切换完成后)。
  • cgo/共享库生命周期与 shutdown 需严格测试。
  • 金样例 tests/ext/web-* 为门禁。