v1.8.0
稳定版 · 2026-07-12 · 上一个稳定版 v1.7.0
这个版本的几件大事
v1.7.0 是一次生产化加固——让长任务看得见、审批收得拢、知识库能力开放成 API。这个版本把员工转向对外交付:它带来了 内容工作室——第一个完全用 MateClaw 自身原子能力端到端搭起来的招牌场景;并让浏览器 Agent 学会按引用去看、去操作,不再对着截图坐标猜。
一句话:v1.8.0 是 MateClaw 从"一箱工具"变成"能干完整活的人"的版本——一句话简报,就能产出一篇躺进草稿箱的公众号图文,或一组可直接发布的小红书竖版图文卡片。
几件大事:
- 内容工作室——一句话到可发布成品。 预置的「内容工作室」员工跑通全流程:选题 → 搜集 → 成文 → 配图 → 去 AI 化 → 排版 → 交付。首批两个平台一等公民:微信公众号(公众号) 图文文章、小红书 以图为主的图文笔记。
- 可度量的去 AI 化。 一个启发式 AI 痕迹评分(纯脚本、无 LLM、确定性可回归)揪出机器味——句长齐整、模板连接词、套话短语、列表滥用、空泛无细节——员工据此在检测 → 改写 → 复检闭环里定向改写,硬上限 3 轮,绝不空转。
- 为长期投产而加固的发布链。 正文图自动上传进微信,不再外链发布即裂;密钥 AES-GCM 加密落库;微信服务实例与 access token 复用并持久化(不再撞 token 限额);发布链对瞬时失败自动重试,并把已知微信错误码翻译成可操作的中文提示;兜底封面保证草稿永远有封面。
- 会去重、会记账的内容日历。 每次交付都自动合规扫描 + 自动落台账——不靠模型记得调。选题指纹让每日定时任务不再重复选到同一个题;只读的内容日历页展示哪些在草稿 / 已打包 / 已发布 / 失败。
- 浏览器 Agent 按引用去看。 新的无障碍树 ref 快照让 Agent 把页面读成稳定的
ref句柄并按 ref 交互——点/填的是那个元素,不是截图坐标。真实浏览器使用加上隐私护栏,并保留一个受控的 CDP 逃生舱应对特殊场景。 - 注意力更聚焦、循环更收得住。 员工获得注意力锚定与环境感知——MCP 工具溯源、skill 约束固定、事件通知——外加工具调用循环护栏和改动后校验提醒,卡住的 Agent 被抓住、改完的东西被复核。
外加:一次首字与包体的快加载优化(初始加载 ↓约 78%)、带按来源拆分的聊天上下文占用面板、Wiki 的跨知识库 wikilink 与素材批量操作、长跑 MCP 工具的进度通知、新增火山方舟 Agent Plan 供应商、技能 Python 脚本可配置 pip 源,以及公开 Docker 栈切到 PostgreSQL 16。
就这些。
1. 内容工作室——一句话到可发布成品
内容创作的每一个原子能力,MateClaw 早就有:联网搜索、抓网页、文生图、HTML 渲染成图、结构化记忆、定时任务、技能运行时。缺的从来不是"再加一个工具",而是把"给我写篇关于 XX 的"变成平台可发布成品的那条被编排的流水线。这条流水线就是内容工作室。
预置的内容工作室员工出厂就绑好了对应技能与工具,system prompt 固化了七段工作流:
① 选题 → ② 搜集 → ③ 成文 → ④ 配图 → ⑤ 去 AI 化 → ⑥ 排版 → ⑦ 交付- ① 选题 来自结构化记忆里你的长期选题方向 + 联网搜索,或来自每日「选题雷达」定时任务。
- ② 搜集 抓取参考文章并汇总角度,让你做差异化而非洗稿。公众号文章 URL 走专用的
wechat_article_extract工具,把mp.weixin.qq.com页面清洗成结构化的{标题, 作者, 时间, 正文, 图片}。 - ③ 成文 按平台原生结构成稿,并遵循你的人设与文风记忆——第二篇起,不必再交代口吻。
- ④ 配图 生成封面与小节配图。
- ⑤ 去 AI 化 跑可度量的改写闭环(见 §2)。
- ⑥ 排版 产出平台成品。
- ⑦ 交付 在外向、不可逆的那一步停下来等你确认,任何东西离开机器前都先过审。
首批两个平台一等公民:
| 平台 | 技能 | 你拿到什么 |
|---|---|---|
| 微信公众号(公众号) | gzh_article | 内联样式 HTML 文章(公众号编辑器不吃 <style>,一切样式内联)、按头图尺寸的封面、小节配图、合规自查——可粘贴交付,或经 gzh_publish 直接推进你的草稿箱。 |
| 小红书 | xhs_note | 以图为主的成品包:标题四件套、碎句正文配话题标签,以及至少 3 张竖版 3:4 卡片(封面 + 内容 + 结尾),由 HTML 模板渲染并在线预览。xhs_package 会硬校验「≥3 图」规则。 |
因为排版本质就是 HTML,模板可由 AI 对话创建与打磨——先渲染出预览图、看着 PNG 改、满意再定稿,并把可复用的自定义模板沉淀进你自己的可编辑技能(内置技能保持不可变)。
内容工作室由一条简报产出一条小红书笔记——可度量的去 AI 化评分、自动记入内容日历的台账,以及右侧「运行总览」里生成的竖版卡片。公众号链路与内容日历见 内容工作室。
2. 可度量的去 AI 化
整个场景的差异化灵魂,在于"去 AI 化"不是玄学,而是一条可度量的闭环。
一个启发式脚本(ai_trace_score,纯 Python、无 LLM、确定性可回归)给文本打 0–100 分,并返回具体信号与位置:
| 信号 | 抓什么 |
|---|---|
| 句长突发度 | 句长方差过低 → 整齐划一 = 机器 |
| 连接词密度 | "首先/其次/然后/综上所述/值得注意的是……"模板腔 |
| 套话短语 | "在……的今天/让我们/随着……的发展/赋能……"套话 |
| 列表 / 破折号滥用 | 过度结构化、一眼生成 |
| 段落均匀度 | 各段字数机械等长 |
| 具体性缺失 | 数字、专名、第一人称、时间地点太少 = 空泛 |
员工据此针对信号改写——口语化、第一人称、上具体细节、句长参差、删套话、按平台调口吻(公众号沉稳、小红书活泼)——再复评,循环到达标或触及 max_rounds = 3(此时取当前最好版本并告知分数,而不是无限烧 token)。
这是启发式质量增强,不保证绕过任何 AI 检测器——技能与产出都会明确标注这一点。
详见 内容工作室。
3. 为长期投产而加固的发布链
发一次草稿很容易;连续三个月每天发,才是真问题所在。这个版本对发布链逐行审计,把坑一条条堵上。
- 正文图不再裂。 微信不抓正文里的外链图,所以一篇满是
/api/v1/files/generated/…的草稿发出去正文图全裂。现在发布链解析 HTML,把每张正文图上传进微信作为图文内图片并改写src——上传失败的图保留原src并回报,而不阻断整篇。 - 密钥加密落库。
weixinoa.app_secret等敏感设置以 AES-GCM 加密存储(密钥取自MATECLAW_SETTING_KEY,未配置回退到机器派生密钥),密文带enc:v1:前缀,旧明文读时透明兼容、下次写入自动升级。 - 一个微信服务、一个 token。 微信同 appId 只有一个有效 token 且取 token 有限额。现在服务实例按 appId 缓存、token 持久化,重复调用与多实例部署不再互踩;密钥变更即失效缓存。
- 瞬时失败重试,已知错误说人话。 发布链对可重试的微信错误码指数退避重试,并把已知错误码翻译成可操作的中文提示——比如 IP 白名单错误提示*"把服务器公网 IP 加进公众号后台白名单"*。
- 草稿永远有封面。 封面解析不到时渲染一张内置占位封面,保证草稿仍能落地,并在返回里提示用了占位封面。
发布保持草稿箱优先:群发/发表是外向、不可逆且受频次限制的动作,由 MateClaw 出草稿、你在公众号后台点"发表"。可选的 publish 动作走 approval 审批流。
4. 会去重、会记账的内容日历
凡是"这条也让模型顺手记一下"的设计,薄弱点就在模型会忘。这个版本把合规与台账焊进交付工具本身。
- 交付 = 扫 + 记。
gzh_package与xhs_package交付时会跑服务端合规扫描(极限词 / 诱导词 / 承诺收益词)并在交付成功后自动落台账——不再有一个模型可能漏掉的独立调用。高危命中在返回里显式标出,高危发布默认拦截。 - 选题指纹防重复。 每条台账带一个归一化的选题指纹;
content_item check_recent回看近 N 天的packaged/published记录(忽略draft/failed,并排除刚落表的那条以免自撞),让每日定时任务不再选到你已经做过的题。 - 个人违禁词并入。 合规扫描把你结构化记忆里的
banned_words作为额外类目,叠加在内置词库之上。 - 只读的内容日历页。 新页列出每条台账——平台、标题、状态、选题、预览链接、创建/发布时间——顶部带状态计数卡。ID 全程按字符串处理(雪花精度约定)。
详见 内容工作室。
5. 浏览器 Agent 按引用去看
用截图坐标驱动真实浏览器很脆:页面一重排,点击就落空。这个版本给浏览器 Agent 一种结构化的看与做的方式。
- 无障碍树 ref 快照。 Agent 把页面读成一棵紧凑的无障碍树,每个可交互元素拿到一个稳定的
ref句柄。 - 按 ref 交互。 点击、输入、选择都针对
ref指向的元素,而不是像素——一次操作能挺过重排,比坐标寻找可靠得多。 - 真实浏览器的隐私护栏。 用用户真实浏览器会话有实打实的风险,所以真实浏览器使用被隐私护栏围起来,并保留一个受控的 CDP(Chrome DevTools Protocol)逃生舱应对安全路径够不着的场景——显式启用,而非默认。
详见 工具系统。
6. 注意力更聚焦、循环更收得住
一批 Agent 运行时的加固,让长的、工具密集的运行不脱轨:
- 注意力锚定与环境感知——每个工具带上溯源(来自哪个 MCP 服务或技能),skill 约束被固定在模型注意力里不随长跑漂走,员工还会收到关于自身环境的事件通知。Agent 不再忘记一个能力从哪来、自己答应过什么规矩。
- 工具调用循环护栏——同一工具用同样参数在紧循环里反复调会被识别并打断,而不是静默烧掉迭代预算。
- 改动后校验提醒——在一次会改变状态的操作(写文件、改代码)之后,Agent 被提醒去校验而不是盲目宣布成功,UI 用警示片提示这一动作。
详见 Agent 引擎。
7. 更快、更轻、更稳
- 快加载优化——按需引入 Element Plus 并对未用组件 tree-shake,加上懒加载的 3D 模型查看器与修掉的 preload 泄漏,把初始加载包体砍掉约 78%,首字更快。聊天历史也不再在回复流式时被拽回底部,回看不被打断。
- 聊天上下文占用面板——按来源拆分谁在占用上下文窗口(记忆 / Wiki / 身份 / 工具 / 历史),让你看清窗口为什么满了。
- Wiki 跨知识库 wikilink + 素材批量操作——
[[wikilink]]现在能跨知识库解析,原始素材支持批量操作。 - MCP 进度通知——长跑 MCP 工具流式回报进度,不再一黑到底跑完才有动静。
- 新增模型供应商——火山方舟 Agent Plan 加入供应商序列;OpenAI 兼容端点修掉了陈旧连接被重置的问题。
- 技能可配置 pip 源——技能 Python 脚本可指向镜像或私有局域网包源,适配离线与内网安装。
- PostgreSQL 16 与 Spring Boot 3.5.16——公开 Docker 栈切到 PostgreSQL 16,后端升级到 Spring Boot 3.5.16。
- 修复——
conversationId按文件系统路径段做净化;工具护栏边界校验加固(工作区相对路径解析、sed 空替换与聊天上传兜底、文件系统根跳过);修掉菜单/工作区切换时可能跨用户泄漏数据的问题。
升级须知
配置完全兼容。 你的 员工 / 技能 / Wiki / 渠道 / 定时任务 / 工作流 / 触发器 / 目标 全部原样保留。Flyway 新增一张表(mate_content_item),三方言(H2 / MySQL / KingbaseES-PostgreSQL)各一份,已有库自动 baseline。
如果你已在生产跑 v1.7.0:
- 内容工作室按需启用。 升级后会出现预置「内容工作室」员工及其技能(
gzh_article、xhs_note、deai_humanize);不主动跟它说话就什么都不跑。 - 要发公众号,在设置里配公众号
app_id/app_secret——密钥现在加密落库。请把MATECLAW_SETTING_KEY设成一个稳定密钥并做好备份:它用来解密已有密文,丢了就得重填密钥。把服务器公网 IP 加进公众号白名单;缺了发布链会提示你。 - 发布默认草稿箱优先——MateClaw 写进你的草稿箱,你在后台点"发表";可选的
publish动作走审批。 - 小红书无官方发布 API——内容工作室产出可直接发布的卡片素材包(默认),浏览器辅助上传作为可选、需审批的增强,不绕过任何风控或人机验证。
- 去 AI 化是启发式质量增强,不保证过任何 AI 检测器。
- 浏览器 ref 交互与真实浏览器护栏是浏览器工具的新默认;CDP 逃生舱按需显式启用。
这个版本对你意味着什么
如果你运营内容账号——一句话就换来一篇躺进草稿箱的公众号图文,或一组可直接发布的小红书卡片包,用你自己的口吻、按可度量分数去过 AI 味、扫过合规、并记进台账让你永不重复选题。
如果你自动化发布——发布链扛得住真实投产:正文图不裂、密钥加密、token 复用、瞬时失败重试、草稿永远有封面。
如果你驱动浏览器——Agent 按引用操作元素而非像素,自动化挺过重排,真实浏览器使用有隐私护栏围着。
如果你跑长的、工具密集的任务——注意力锚定让能力与约束不脱离视野、循环护栏打断卡死的循环、校验提醒抓住没复核的改动。
如果你只想它更快——初始加载 ↓约 78%,聊天不再流式时把你拽到底部,还能看清到底什么在占用上下文窗口。
最后一件事。
一箱工具,等着被拿起来。一个能干活的人,把活干完。
这个版本是 MateClaw 第一次用自身原子能力端到端干完一整件活——从选题到草稿箱——外向那一步为你的确认而停下,每次交付都被扫描、被记录。也是浏览器 Agent 不再对着像素猜、开始对着真实存在的东西下手的版本。
从"它有工具"到"它把事办了"。