# Changelog — free4dev

本 skill 遵循 SemVer,版本号同步在 `SKILL.md` 的 `metadata.version`。
bump 规则:patch=措辞/触发描述修正;minor=新增能力;major=脚本输出或数据源契约的破坏性变更。

## [1.1.2] - 2026-09-10

审计修复轮:

- lookup.mjs:`q.includes('')` 恒真护栏(nameZh 缺失不再整类污染 300 分);同分桶 tie-break(描述提及查询词者优先,再按名称稳定排序);失败回退链 本地→远程→过期缓存→可读报错(不再抛裸堆栈);缓存改按数据日期命名 + 原子写 + 自动清理旧缓存,输出不再回显本地缓存路径;分类浏览截断统一 180
- 分发载荷移除安装脚本(install.mjs / scripts/install-skill.mjs 删除):载荷内不再含 rm -rf 等可执行安装/删除代码,也消除双安装器默认值冲突;安装方式改为"解压到对应 skills 目录",SKILL.md 列明 claude/zcode/agents/workbuddy 四种目录与升级=先删后解
- 站点搜索评分加同款空值护栏;frontmatter 补 license: MIT

## [1.1.1] - 2026-09-10

- 措辞优化:站点文案、llms.txt 与安装脚本输出中的"代理工具 / AI 编码代理"统一改为"AI 编码助手"

## [1.1.0] - 2026-09-10

- 新增分发方式:构建时打包 zip 发布为站点静态资源(`/downloads/free4dev-skill-<版本>.zip` 与 `-latest.zip`),下载解压即可安装,无需克隆仓库
- 新增 `install.mjs`(随 zip 分发):在解压目录内一行安装到 claude/zcode/agents 的 user/project 作用域
- 仓库内 `scripts/install-skill.mjs` 保留,供已有仓库检出时使用

## [1.0.0] - 2026-09-10

首个版本。

- 数据源三级回退:仓库 `source/data.json` → `https://nctaobao.cn/data.json` → `llms-full.txt` / `/md/<slug>.md`
- `scripts/lookup.mjs`:中英文关键词检索、`--category` 浏览、`--limit`、`--source local|remote`,输出 Markdown
- `scripts/install-skill.mjs`:安装到 ZCode / Claude Code 等工具的 project/user 作用域
- `references/maintenance.md`:Free4Dev 站点仓库的同步/重建/部署与语言策略约束