v0.7.3

What's Changed

• feat(sanitize): 净化管线接入写入/注入路径——版本化规则引擎三层接线 (Issue #278) by @Allenllii in #380
• feat(promote): 接线 + 双措辞共识门 + 失败教训双记忆 (Issue #280) by @Allenllii in #381
• feat(slice): 来源/完整性标签——Origin 枚举 + 注入/L3 限权 + trust/import + 审计 (Issue #279) by @Allenllii in #382
• test(security): AgentDojo 风格投毒测例进 CI——五条攻击链全链路回归集 (Issue #281) by @Allenllii in #383
• fix(inject): L2 注入预算单遍构造——预算判定与实际落盘字节同口径 (Issue #283) by @Allenllii in #384
• test(harness): close lookup subprocess timeout coverage gap by @Allenllii in #385
• fix(evolve): isolate speculative probe feedback by @Allenllii in #386
• fix(harness/tool): semantix_lookup 子进程测例密封化——去掉时钟/代码页/PATH 三条环境耦合 (Issue #296) by @Allenllii in #387
• fix(harness/tool): 修复 main 编译失败——超时测例改用密封 fake kernel by @Allenllii in #390
• docs(readme): 突出跨会话记忆与缓存经济性，并区分两种产品形态 by @Allenllii in #388
• feat(control): carry plan revision feedback through approval gates by @Allenllii in #389
• fix(cli): 计划审批卡接三态 API 并就地收集修改说明 (Issue #329) by @Allenllii in #391
• feat(control): SetEffort——会话级推理深度就地切换，并定下单槽位优先级 (Issue #330) by @Allenllii in #392
• docs(readme): split bilingual README into per-language files by @Gnosil in #393
• feat(swebench): 统一四 harness 的 SWE-bench Verified 对比管线（DeepSeek） by @Gnosil in #394
• docs+fix: 一行安装体验打磨（README 快速开始前置 · install.sh 自动写 PATH · 项目规则） by @Gnosil in #395
• fix(install): 消除 macOS sed 报错 + 收尾消息讲清"需重载 shell" by @Gnosil in #401
• fix(swebench): 真实 DeepSeek 端点联调修复（semantix .env / dsh 代理 / codex Responses / swebench 5.x） by @Gnosil in #396
• feat(provider): honour Request.EffortOverride in the anthropic and responses adapters by @Allenllii in #397
• feat(cli): apply /effort in place instead of rebuilding the controller by @Allenllii in #399
• feat(ui): add coding workspace shell and Semantix design tokens (GUI-1) by @radianceded in #416
• feat(ui): workspace/branch/model/effort selectors (GUI-2) by @radianceded in #418
• feat(ui): project & task sidebar over live sessions (GUI-3) by @radianceded in #419
• feat(cli/setup): 向导支持「从推荐预设添加」，GLM 等可直接选 by @Gnosil in #417
• feat(config): 适配 GLM-5.3-Flash（智谱原生多模态） by @Gnosil in #420
• feat(gui): unify workspace event protocol and SSE replay by @radianceded in #421
• feat(config): 将 glm-5.3-flash 设为默认 GLM 模型（pay-as-you-go API） by @Gnosil in #422
• feat(gui): render conversation and tool workflow cards by @radianceded in #423
• feat(gui): add right workbench context panels by @radianceded in #424
• feat(gui): add composer controls and permission confirmation by @radianceded in #429
• swebench: 真实 DeepSeek 端点四 harness 对比实测完成（50 题正式轮 + 官方评测结果） by @Gnosil in #398
• feat(gui): expose truthful Semantix cache status (#412) by @radianceded in #430
• feat(gui): add searchable session history (#413) by @radianceded in #432
• feat(desktop): add Windows workspace launcher (#414) by @radianceded in #433
• fix(memory): 记忆内核四连修落地 main + kernel 消融模块 (#425-428) by @Gnosil in #431
• docs: 社区就绪——去滞后文档 + 英文 ROADMAP + 社区入口 by @Gnosil in #434
• release: v0.7.3 发版记录 + 版本徽章 by @Gnosil in #436

Full Changelog: v0.7.2...v0.7.3

v0.7.2

What's Changed

• chore(license): relicense to MIT + align all references by @Gnosil in #352
• chore(license): sweep remaining FSL refs (llms-full.txt) → MIT by @Gnosil in #353
• feat(docs): build task-based documentation hub by @radianceded in #354
• feat(zone): L3 命中阈值三阶段演进——可配化/按类型分化/逐条目自适应 (Issue #259) by @Allenllii in #361
• chore(patrol): brand cleanup + bug-hunt fixes (2026-08-22) by @Gnosil in #355
• fix: resolve 11 patrol-found bugs (high → low) by @Gnosil in #373
• feat(cli): 一行安装 + 全局 semantix 裸命令启动 agent（cwd 为工作区） by @Gnosil in #374
• fix(release): 发布链收口，install.sh / release.yml 对齐 build-full.sh 契约 by @Gnosil in #376
• docs(readme): slim bilingual README, move deep dive to docs/TECHNICAL-OVERVIEW by @Gnosil in #375
• docs(readme): add Star History chart by @Allenllii in #377
• docs(readme): remove Star History chart by @Allenllii in #378
• docs(release): v0.7.2 发版记录 + README 版本徽章 by @Allenllii in #379

Full Changelog: v0.7.1...v0.7.2

v0.7.1 — system prompt 更新 GLM适配完成

重点：系统提示词收口

系统提示词是 agent 每次会话读到的第一段文字，定义它是谁、怎么干活、什么时候该停下来问用户。此前它的开场白与产品名对不上：用户敲的是一个名字，agent 自述是另一个。这是整个产品里最靠前、也最容易被忽略的一处不一致。

现在它是：

You are Semantix, a coding agent running in a terminal on the user's machine.
Use tools to inspect, change, and verify the workspace directly.

为什么这一行不能随手改。 系统提示词是缓存前缀的开头。这个产品的核心价值就是跨会话复用与前缀缓存命中——提示词一旦变动，整段前缀缓存失效。所以仓库里有两道守卫盯着它：一道校验提示词组装的字节稳定性，一道比对完整快照防止无意漂移。本次改动是走完守卫、重新生成快照后落地的。

同时成型的行为契约。 提示词由四块拼成，后三块会追加到每一个系统提示词上——包括用户自定义人格，这样自定义角色无法意外删掉产品的交互约定。

组成块	约束的是什么	字符
身份与交付基线	身份、场域、工具优先；交付要覆盖每一项被点名的产出；接口变更必须让每个语义上的调用方跟上，而不只是类型能编过	992
用户决策归属	没有安全默认值的决定必须调 ask 交回用户，不能在正文里问；非交互场景则明说假设、走最可逆的路	301
工作规范	点名了做法就照做，想换做法要显式讲权衡而非默默替换；临时脚本不许留在仓库；交付前必看最终 diff；验证强度随改动大小走	591
语言跟随	跟随用户当前语言并随之切换，但代码、标识符、路径、命令一律保持原文不译	371

其中几条是直接冲着 agent 的常见失败模式写的：不许编造结果、不许放松测试、没有测试输出和最终 diff 就不许声称完成；证据与思路矛盾时改思路，而不是把同一件事再试一遍；只在三种情况下停——做完、卡在该由用户拍板的决定上、或者真的走不动了。语言跟随那块特意写成静态英文，就是为了留在缓存前缀里，避免每轮注入把前缀顶掉。

内置指南 skill 同期改名，用户敲的斜杠命令与产品名对齐。

---

⚠️ 升级需要手工迁移一次

本版统一了落盘契约。版本号是 patch，但直接覆盖升级会丢配置。

项	现在的位置/名字	升级动作
用户目录	~/.semantix/	旧目录需改名（会话数据有兜底迁移机制）
项目配置	semantix-agent.toml	旧配置文件需改名
环境变量	SEMANTIX_*	114 个前缀需替换
keyring 服务名	semantix	provider 密钥需重新输入一次
项目记忆文件	SEMANTIX.md	需改名

逐条命令见 docs/releases/v0.7.1.md。

存量兼容都保留了：插件清单读不到新名时回退旧名，插件 apiVersion 的旧值继续接受，主题扩展名保留兼容，旧版会话与配置仍作为 legacy 源被迁移机制读取。已安装的插件不会因为改名而失效。

---

发布链：从「发完就走」到「发前自证」

这是本版第二项实质进步。上一版的产物核对暴露了一个结构性问题——打包脚本从不验证自己的产出，于是四项缺失全部漏到了线上，没有任何一道关卡拦下来。

	此前	现在
自更新通道	只上传了完整包，而 upgrade 按约定去取扁平单二进制包和 SHA256SUMS——两个资产都不存在，直接 404	四平台扁平包与双份校验文件齐备，已按更新器的真实取数路径拉取校验
curl 安装器	需要独立的内核二进制资产，发布里没有；校验文件也无对应条目，脚本取到空值后校验失败	四平台裸内核二进制随版上传，线上实测下载并通过 sha256 比对
产物洁净度	在 macOS 上打包时扩展属性被写成归档成员，每个真实文件旁都躺着一份影子文件	显式关闭元数据归档并排除桌面索引文件，8 个压缩包残留计数实测均为 0
发布前检查	没有。上述三项都不难发现，只是从来没有人、也没有脚本去看一眼	打包完成即就地自检，任何一项不过直接 exit 1，产物不会流到上传环节

门禁校验四件事：每平台三件产物的存在性、校验文件里按名索引的条目是否对齐、每个压缩包的元数据残留、双名校验文件是否齐全。

自检本身也经过了实战：首次运行就报了 8 条失败。追查后确认是检查写得过严而非产物有问题——校验工具在不同平台的输出格式带有二进制标记差异，而两端消费方本来就都容忍这个标记。改为按字段取名比对后全绿。一道会误报的门禁等于没有门禁。

---

内核能力增强

领域	改进	PR
检索融合	hybrid 融合收敛到单一真源，支持 RRF 与可配权重——此前多路召回的合并逻辑分散在调用侧	#344
上下文管理	类型化片段的确定性淘汰，并与 Compact 事件联动——淘汰结果可复现，不再依赖调用顺序	#343
预取	probation 探针释放被降级的候选，修复预取进入吸收态后无法自愈的问题	#301
计费网关	钱包探测失败改走短退避而非整个 TTL——单次探测失败不再让计费停摆一个周期	#345
提示词栈	精简版提示词与条件式语义 review	#350
终端体验	TUI 退出时重置鼠标追踪，终端不再残留鼠标模式	#349
测试稳定性	修复全量并行下的偶发超时——把 flake 当 bug 修，而不是重跑一次算了	#314

本版共 50 个提交、10 个 PR、770 个文件改动，151 个 Go 包全部纳入回归。

---

交付验证

发布后没有停在「资产列表看起来齐了」。验证是按两个下游消费方在代码里写死的真实取数路径，从线上拉取并逐项比对校验和。

消费方	取数路径	上一版	本版
自更新命令	扁平单二进制包 + SHA256SUMS	404	✅ 校验通过
curl 安装脚本	裸内核二进制 + SHA256SUMS.txt	404	✅ 校验通过
更新器包结构	包内应仅含裸二进制	—	✅ 符合预期
产物洁净度	8 个压缩包元数据残留计数	每包均有	✅ 0
版本标记	二进制内嵌版本号与 commit	未核	✅ 已确认注入

版本标记这一项额外做了源头核对：注入用的变量名与两个入口文件中的声明逐个对齐。名字写错时链接器会静默不生效，产物看起来正常但版本号是空的。

---

资产

每平台三件，共四平台（darwin-arm64 / darwin-amd64 / linux-amd64 / linux-arm64）：

• semantix-agent-v0.7.1-<platform>.tar.gz — 完整包（semantix-agent + semantix + semantix-gateway + 两个配置模板 + 独立安装器 + README）
• semantix-agent-<platform>.tar.gz — 扁平单二进制，semantix-agent upgrade 用
• semantix-v0.7.1-<platform> — 裸内核二进制，curl 安装器用

外加 SHA256SUMS 与 SHA256SUMS.txt（同一份校验、两个名字：自更新器读前者，安装器读后者）。

快速开始

tar -xzf semantix-agent-v0.7.1-<platform>.tar.gz
cd semantix-agent-v0.7.1-<platform>
cp semantix-agent.example.toml ~/.semantix/semantix-agent.toml
export GLM_API_KEY=<你的 GLM key>      # 或按需 DEEPSEEK_API_KEY
./semantix-agent                        # CLI TUI；或 ./semantix-agent web 开 GUI

完整发版记录与逐条升级命令：docs/releases/v0.7.1.md

v0.7.0 — GLM 适配版(BYO)

GLM 适配版(自带 token / BYO)。 全新安装默认GLM,可切 DeepSeek,任意 OpenAI/Anthropic 兼容端点开箱可用。

亮点

• 默认 GLM,可切 DeepSeek:全新安装 default_model = "glm"(bigmodel.cn / GLM_API_KEY);改成 deepseek 即切换。
• env-key 探测:无配置首启时按 GLM_API_KEY → ZAI_API_KEY → DEEPSEEK_API_KEY 自动选默认,DeepSeek-only 用户不被坑。
• BYOK:任何 OpenAI/Anthropic 兼容端点填 base_url + api_key_env 即可用基础功能——即使模型没做专门适配。
• 跨会话语义复用层(L2/L3)对 GLM 生效:实测前缀缓存二次命中 ≈99%。
• 说明:本版金为"自带 token"形态。

资产

四平台:darwin-arm64 / darwin-amd64 / linux-amd64 / linux-arm64,附 SHA256SUMS.txt。

快速开始

tar -xzf semantix-agent-v0.7.0-<platform>.tar.gz
cd semantix-agent-v0.7.0-<platform>
cp reasonix.example.toml ~/.reasonix/reasonix.toml
export GLM_API_KEY=<你的 GLM key>     # 或按需 DEEPSEEK_API_KEY
./semantix-agent                       # CLI TUI;或 ./semantix-agent web 开 GUI

semantix-agent v0.6.0 — Agile 2 完整落地

Agile 2 完整落地——自进化闭环（kernel 观测 → 决策 → 执行 → 进化）随本版收口，并带来 L1 命中率的第一次真实计量。

亮点

• 自进化曲线因果对照（U43 DoD）：evolve ON/OFF 同负载、同反馈对照实验——制度性变更（既学候选全部过期）下，evolve ON 浪费预取 10 次 vs OFF 15 次，25 会话总成本 $0.510 vs $0.540；证据与复现脚本入库（docs/reports/agile2-evolution-curve.md，逐位可复现）
• 预算硬停补洞（#250）：kernel 调度器经 RoundPlan 下发的 hard_stop 现在在任何工具执行前拦截整轮并以可见错误终止——此前 100% 档形同虚设
• evolve/prefetch 吸收态逃逸（#254/#255）：conf 关停预取后 ε-探针保留信号流，参数不再永久冻结；有命中历史的过期候选可被降级
• L1 命中真实计量（GLM-P0-3）：gateway 解析上游 usage 并归一五种 wire 形态（OpenAI 全量 / Anthropic 增量对账 / DeepSeek 顶层计数等），per-provider 命中率首次可测；Anthropic 流式客户端现在也能收到真实 usage chunk
• L3 双轴判据（#241）：Prompt 孪生不再压低 Result 置信度
• 工具结果归因修复（#252）：同 turn 多工具结果不再串扰
• GLM 云厂商适配线开工：Spike 周双网关实测（TTL/命中粒度/usage 形态三维度互异的第一手数据，docs/reports/glm-spike-week.md）、优化 spec 转正（端点战略：只走云厂商托管）、P0 批次 #289-#293 进行中

包内容（每平台 tar.gz）

semantix-agent（主程序）· semantix（kernel CLI）· semantix-gateway · 配置模板 ×2 · README

快速开始

tar -xzf semantix-agent-v0.6.0-<platform>.tar.gz && cd semantix-agent-v0.6.0-<platform>
mkdir -p ~/.reasonix && cp reasonix.example.toml ~/.reasonix/config.toml   # 填 provider key，[semantix] enabled=true
./semantix-agent

勘误（2026-08-21）：此前 quickstart 教的 ~/.reasonix/reasonix.toml 不在配置加载序列里（用户全局配置实际读 ~/.reasonix/config.toml，项目级读 ./reasonix.toml），已更正。
品牌预告：配置路径与模板将随下一版本全面更名为 semantix（~/.semantix/、semantix-agent.toml、SEMANTIX_* 环境变量），旧路径保留兼容读取——见 PR #315。

已知边界

• judge 统计口径（#245）与命中率实测门禁（#58）继续追踪
• linux 产物为交叉编译，未在真机冒烟
• 桌面端未随本版发布

致谢

semantix-agent 站在优秀开源项目的肩膀上，特别感谢：

• DeepSeek-Reasonix（MIT）——agent 系统的基础，其缓存优先的工程纪律贯穿本项目
• Charm（bubbletea / lipgloss）——终端 UI 框架
• modernc.org/sqlite——纯 Go SQLite，让单二进制分发成为可能
• BurntSushi/toml——配置解析

semantix-agent v0.5.0 — 合体首发

semantix-agent 首个正式发布——coding agent 与自进化 memory kernel 的单进程合体：每一次会话，都让下一次会话更快、更便宜。

亮点

• 合体架构：agent 主循环与 semantix kernel 同进程直连——L2 语义注入、调度决策、复用统计零子进程开销
• 每 turn 复用面板：📦 命中切片数 / 💰 节省成本 / 🗂 来源会话，跨会话复用的价值直接可见
• 资源编排：kernel 决定并行分组 / 模型 tier / 工具挂起；预算三阈值阶梯降级（70% 停预取 → 90% 降 tier → 100% 硬停）
• Semantix Design：品牌绿 #009c6d 默认主题（暗色 semantix / 亮色 semantix-light）
• Semantix Gateway：OpenAI 兼容语义缓存网关——任何 OpenAI 兼容客户端把 base_url 指过来即可享受 L2/L3 缓存
• 质量基线：全仓 go test ./... -race 134 包绿（52 万行代码 + 976 个测试文件）

包内容（每平台 tar.gz）

semantix-agent（主程序）· semantix（kernel CLI）· semantix-gateway · 配置模板 ×2 · README

快速开始

tar -xzf semantix-agent-v0.5.0-<platform>.tar.gz && cd semantix-agent-v0.5.0-<platform>
cp reasonix.example.toml ~/.reasonix/reasonix.toml   # 填 provider key，[semantix] enabled=true
./semantix-agent

已知边界

• 桌面端未随本版发布（#158 进行中）
• 命中率实测门禁（#58）继续追踪中；linux 产物为交叉编译，未在真机冒烟

致谢

semantix-agent 站在优秀开源项目的肩膀上，特别感谢：

• DeepSeek-Reasonix（MIT）——agent 系统的基础，其缓存优先的工程纪律贯穿本项目（完整声明见包内 ATTRIBUTION 与 LICENSE.reasonix.md）
• Charm（bubbletea / lipgloss）——终端 UI 框架
• modernc.org/sqlite——纯 Go SQLite，让单二进制分发成为可能
• BurntSushi/toml——配置解析

v0.4.0 — CLI v2 完整版

v0.4.0 — CLI v2 完整版（M2-U19~U27）

亮点

• CLI v2 命令树（#113）：四组命令（kernel 运维 / 产品管理 / 维护 / 服务模式）+ 统一 help 分组 + 退出码契约（0 成功 · 1 运行错误 · 2 用法错误 · 3 门禁未达标）
• config 接线（#114）：semantix.toml 生效，优先级 CLI flag > env > 文件 > 内置默认（kernel/config）
• --json 信封（#116）：lookup / search / usage / verify / config / version 等全部支持 {ok, command, data, error, version} 结构化输出，H1 子进程协议入口稳定
• 产品命令（#115）：semantix init（生成配置 + 骨架）、semantix config（来源标注）、semantix version
• completion（#117）：bash / zsh / fish 补全
• doctor（#118）：db / config / embedder / judge 一键健康检查（FAIL → 退出码 3）
• install（#119）：agent-skill 安装器（reasonix / claude-code / custom，幂等 + 卸载）
• gc / export / import（#120）：切片库维护（retention + 权重清理 / JSONL 备份 / 恢复）

修复

• 单平台资产问题：build-full.sh 默认构建全部支持平台 → 本次发布 4 平台资产（darwin/linux × amd64/arm64）

资产

• semantix-agent-v0.4.0-darwin-arm64.tar.gz
• semantix-agent-v0.4.0-darwin-amd64.tar.gz
• semantix-agent-v0.4.0-linux-amd64.tar.gz
• semantix-agent-v0.4.0-linux-arm64.tar.gz
• SHA256SUMS.txt

文档

• 架构方案：docs/reports/cli-v2-architecture.md
• 路线图：docs/Agile路线图.md（Agile 1 后期，遗留门禁 #58 真实数据命中率 ≥70%）

v0.3.1 — [semantix] config wiring in example template

修复：reasonix.example.toml 增加 [semantix] kernel 接线段（U8 配置已支持但示例模板缺失）。安装包同 v0.3.0 + 配置模板修复。

v0.3.0 — first downloadable complete agent

reasonix harness + semantix memory kernel bundle. See docs/reports/customer-delivery.md.

Semantix v0.2.0 — 首个可下载 Agent Kernel

Semantix v0.2.0

首个可下载的 Agent Kernel（M0 全部完成 + U12 embedding 语义检索）。

能力

• 语义切片：会话 JSONL → P/T/R 切片（extract）
• 三模式检索：BM25 / vector / hybrid-RRF（search）
• L2 注入：跨会话复用块（inject）+ lookup 工具
• 离线回放验证：命中率评估（verify）
• 安全基线：0600 存储/原子写/全输出消毒/注入标记转义

安装

见 docs/QUICKSTART.md。校验：shasum -a 256 -c SHA256SUMS.txt

路线

Harness 重构（H1-H5）：kernel 调配 harness 全部资源 —— docs/reports/harness-refactor-blueprint.md