更新日志

ZensInk 开源包与 Pro 的版本历史及发布说明。

v1.4.11 2026-10-14

独立审计加固——3 轮审计修复 39 处缺陷

  • — 首次完整独立代码审计(DeepSeek Harness):逐模块通读、每项发现先本地复现再修复——共 40 项发现(12 高 / 15 中 / 13 低),本版修复 39 项,1 项待真实 API 响应确认后处理
  • — 审计暴露的核心模式:工具「自信地沉默」。已修:MCP 上 competitor_gap 完全不可用(每次调用都带不支持的 --json)、autocomplete 空响应导致所有调用方崩溃、格式化排版的 JSON-LD 检测不到、首页永远被报成孤儿页、robots.txt 连续 User-agent 行互相覆盖(Disallow: / 被读成未列出)、rank_tracker 用 lstrip("www.") 啃坏域名、999 哨兵值捏造 ±996 位趋势
  • — 意图分类纠正:"how to get more traffic" 是 informational 不是 transactional;/blog/product-led-growth 是博客不是产品页;SERP 百分比不再硬除以 10
  • — 中文内容终于可度量:content_qc 统计 CJK 字符(中文稿的发布门禁原来是空转);keyword_cluster 正确解析带引号 CSV;GSC search_performance 分页拉行,top-50 小计不再冒充总量;domain_rating 缓存在 site-packages 只读时回落 ~/.zens_ink
  • — CLI 派发器补上 content_qc + llms_gen(此前有文档但报 Unknown tool);TOOLS_COUNT 20 → 22;MCP 协议协商诚实化;18 条回归测试钉死全部修复;完整审计报告归档仓库 docs/
v1.4.10 2026-10-01

品牌卡片更新

  • — 新 hero banner(中英双语):现行 Z 标 + 工具管线 + pip install 命令行——替换退役的墨水滴旧设计
  • — README 头图改绝对 URL,PyPI 页面也能正常显示
v1.4.9 2026-09-30

Repo agent 层——让仓库本身可被 AI 阅读

  • — Gitingest / GitDiagram 这类工具(合计 15k+ stars)已是 AI agent 认识一个项目的第一入口——本次为 zens-ink 自身补上这层:仓库根目录新增 llms.txt + llms-full.txt(20 个工具清单、MCP / skill 入口、安装命令、链接)
  • — ARCHITECTURE.md——一页讲清模块分层与数据流,让 AI 摘要工具照着讲结构,而不是靠猜
  • — 冒烟测试 tests/test_smoke.py 守住 import 与 CLI 面;新增 FUNDING.yml
  • — 用 Pro v2.6.0 的 repo_readiness 验收:76/C → 91/A——对照组 gitdiagram 只有 63/D、psf/requests 59/F
v1.4.8 2026-09-08

ai_crawler_audit — 查清谁真的能读你的内容

  • — 新工具:对 robots.txt 里的 17 个 AI 爬虫(训练类 vs AI 搜索类,按厂商)逐个判定可达性,读 Content Signals,验证 llms.txt / llms-full.txt 层,输出 0-100 AI 可读性评分和人话建议
  • — 全站封禁与子路径封禁严格区分——Disallow: /admin 不等于 Disallow: /
  • — 提示 robots.txt 与边缘爬虫管理互不相知的坑(robots 放行仍可能在边缘被 403)
  • — 零依赖免 API key,markdown + JSON 输出;与 llms_gen 配对(先审计,缺什么生成什么)
  • — 工具 19 → 20。首批真实数据:ahrefs.com 88 分(无 llms.txt)、backlinko.com 88、searchenginejournal.com 96
v1.4.7 2026-08-29

content_qc + llms_gen — 发布侧 GEO 闭环补齐

  • — 新工具 content_qc:AI 可引用内容发布前质检,14 项加权检查(BLUF、事实密度、套话上限、来源、FAQ 区块、标题结构、meta、alt、日期信号),--min-score 可作 CI 门禁
  • — 新工具 llms_gen:从构建目录或线上 sitemap 生成 llms.txt(精选)+ llms-full.txt(全量目录),自动跳过 admin/api/noindex 路由
  • — 把事后评分(site_audit、geo)挪到发布之前
  • — 工具 16 → 19
v1.4.6 2026-08-23

PyPI 基础设施发版

  • — 发版自动化:push v* 标签即由 GitHub Actions 构建 + 发布 PyPI(v1.4.7 验证通过)
  • — 回补缺失的 v1.4.6 changelog 条目
v1.4.5 2026-08-23

domain_rating —— 免费 Ahrefs 真实 DR

  • — 新工具 domain_rating:查询 Ahrefs 免费公共 Domain Rating 端点,任意域名或 URL 返回真实 DR(0-100)
  • — Off-page 权重曾是已知空白,kd.py 只能用人工权威域名表近似,现在零成本补上
  • — 批量友好:命令行传参 / --file / stdin 管道;本地 dr-cache.json 缓存,重复查询不打接口;CSV/JSON 导出;URL 自动归一化
  • — 已注册进 CLI 调度和 MCP server 工具列表(工具 18 → 19)
  • — 需免费 AHREFS_API_KEY(app.ahrefs.com → Account settings → API keys);按 DR License 要求所有输出保留 "Domain Rating by Ahrefs" 署名
v1.4.4 2026-08-23

site_audit 新增 agent-readiness 检查

  • — 新检查:llms.txt 必须有 When-to-use 段落——没有它 agent 判断不出你的站适合什么任务
  • — 新检查:llms.txt 需要一行 how-to-call(安装命令 / 端点 / MCP 入口)
  • — 确定性规则、零依赖,跑在现有 site_audit 流程里
  • — 与 Pro v2.4.0 Agent Readiness 评分同步发布;同一套清单让 zens.ink 在 is-agentic.com 从 64 分升到 98 分
v1.4.3 2026-08-15

kd 品牌词指纹

  • — kd:品牌三重指纹(官方域名进 top3 / 域名家族占位 / 平台生态密度)——品牌词不再污染通用 KD
  • — kd_entry:剔除官方页与平台固定位后的截流难度
  • — KD→引用域外链预算曲线(编辑型/目录型双轨)
  • — --markdown 自包含报告;competitor_gap 更深的 sitemap 解析
  • — 注:版本号从 1.4.x 跳到 1.6.0(与 kd 版本对齐),不存在 v1.5.x
v1.4.3 2026-08-15

Rank Tracker —— SQLite 排名历史

  • — 新增:rank_tracker——跟踪你的域名在关键词集上的 Google 排名,每次检查快照存入 SQLite(~/.zens_ink/ranks.db),长期看趋势
  • — 动作:add / check / status / trend / history / remove;SERP 深度可配(--num),每个关键词每次检查消耗一次 Serper 调用
  • — 注册为 MCP 工具 rank_tracker
  • — 工具 16 → 17
v1.4.2 2026-08-14

MCP Server —— DSH / Claude / Codex 原生工具接入

  • — 新增:python3 -m zens_ink.mcp 把整个工具包跑成 MCP stdio server——所有工具变成模型原生工具(mcp__zensink__keyword_research、mcp__zensink__kd 等)
  • — 兼容 DeepSeek Harness(DSH)、Claude Desktop、Codex 及任何 MCP 客户端——用自然语言指挥 agent,它自动调工具
  • — 新增:serp_intent——从真实 Google SERP 构成反推搜索意图(页面类型加权 + SERP 特征),与关键词版 search_intent 交叉验证
  • — 纯标准库,零新增依赖;API key 照常从 .env 读取
  • — Pro 自动发现:同机装有 zens_ink_pro 时,其 7 个工具(winability、content_radar、competitor_radar、geo_score、geo_visibility、gap_deep、full_audit)自动加入同一个 MCP server——纯开源安装只有开源工具
  • — 工具 15 → 16
v1.4.1 2026-08-06

GEO 选题 + Reddit 蓝海

  • — 新增:geo_fanout——逆向 AI 搜索的 Query Fan-out,生成 7 个意图维度的子查询,含金矿评分和 Pillar+Cluster 内容规划
  • — 新增:reddit_blueocean——双层发现高流量低竞争的 Reddit 蓝海帖,自动分类商业意图
  • — site_audit 新增 3 项检查:staging 泄露、Sitemap 目录概览、Schema 字段深度校验
  • — 版本 1.3.0 → 1.4.1,工具 13 → 15
v1.3.0 2026-07-20

site_audit:GEO + i18n + 30 项检查

  • — site_audit 从 ~20 项扩展到 30 项:llms.txt 存在性、FAQ schema、BLUF 检测、hreflang 国际化、商业 schema(Product/Offer/Service)、内容结构分析、爬虫阻断 JS、页面大小
  • — GEO 就绪度:llms.txt 检查、FAQ/BLUF 内容信号检测
  • — i18n:hreflang 标签验证
  • — 性能:页面大小 + 爬虫阻断 CSS/JS 检测
v1.2.0 2026-07-17

8 → 13 个工具

  • — 新增 5 个免费工具:keyword_cluster、search_intent、kgr_auto、content_matrix、onpage_audit
  • — keyword_cluster:关键词按语义相似度自动聚类
  • — search_intent:搜索意图四分类(信息/商业/交易/导航)+ question/buyer 标记
  • — kgr_auto:KGR 机会评分(竞争度 vs 搜索量)
  • — content_matrix:聚类 + 意图 + KGR 合成优先级内容矩阵
  • — onpage_audit:页面质量 7 维度评分(0-100 分 + 修复建议)
  • — 所有新工具纯 Python stdlib——零依赖、零 API key
v1.0.0 2026-06-25

初始版本

  • — 8 个免费 CLI 工具:keyword_research、keyword_volume、kd、brave_volume、search_performance、competitor_gap、site_audit、setup_gsc
  • — 零 Python 依赖——仅标准库
  • — 双语站点(中/英),基于路径的 i18n