v0.6.1

文档

• README 重构：顶部新增 PyPI 徽章与在线样例前置链接；特性列表重写为 7 条「加粗关键词 + 一句话效果」；安装主线更新为 PyPI pip install repowiki-cli；命令表精简为常用 8 条；离线安装压缩；设计取舍 / 已知边界 / Non-Goals 合并为「设计边界」一节；移除易过时的具体数字；进一步移除「快速开始 / 用法 / CI 集成」三节，README 聚焦卖点与安装。
• 新增 docs/zh/USAGE.md / docs/en/USAGE.md：收纳自 README 移出的完整内容——Worker 循环契约、并发配方（含 worker.sh 脚本）、15 条命令完整参数表、快速开始与输出结构、CI 集成（wiki 门禁 + Pages 发布）、module/flow 模板枚举、可靠性机制细节与离线安装完整步骤。
• wiki 重新生成：按新目录结构重写本仓库自己的 wiki（5 章 22 页），GitHub Pages 在线样例随本 Release 同步更新。

无代码变更；升级无需任何迁移动作。安装：pip install repowiki-cli；离线安装可用本页附带的 repowiki_cli-0.6.1-py3-none-any.whl。

v0.6.0

新增

• repowiki skill install / status：skill 文件随 wheel 一起分发，pip 装完 CLI 后一条命令即可把 skill 安装到 agent 全局 skills 目录——默认 ~/.agents/skills/repowiki/，--agent claude|codex|zcode|cursor|opencode 指定客户端目录，--target <目录> 完全自定义；安装写入版本戳，幂等可重复执行。repowiki skill status 识别未安装 / 手拷无版本戳 / 过期 / 已是最新四种状态；两命令均支持 --json。

变更

• skill 目录迁入包内：skills/repowiki/ → src/repowiki/skills/repowiki/（单一事实源，wheel 与 git/插件安装读同一份文件）。

文档

• README（zh/en）安装节改为推荐 pip install repowiki-cli + repowiki skill install。

测试

• 新增 tests/test_skill_install.py（7 项）。

安装：pip install repowiki-cli（PyPI 由 Trusted Publisher 自动发布）；离线安装可直接使用本页附带的 repowiki_cli-0.6.0-py3-none-any.whl，装好后执行 repowiki skill install。

v0.5.1

修复 / Fixed

• 版本号检测适配新分发名：分发名改为 repowiki-cli 后，干净安装的 repowiki --version 显示
  0.0.0（metadata 查询仍用旧名）——现优先查 repowiki-cli，兼容旧名回退。
  Version detection now queries the new distribution name (repowiki-cli); clean installs
  no longer report 0.0.0.

变更 / Changed

• PyPI 分发名定为 repowiki-cli（repowiki 已被
  同用途项目占用）：命令名与 import 包名保持 repowiki 不变，pip install repowiki-cli 即可。
  Distribution renamed to repowiki-cli (the repowiki name on PyPI is taken); the command
  and import package remain repowiki.

187 tests · Python 3.10–3.13 · macOS / Linux / Windows 原生

v0.5.0

亮点 / Highlights

• 站点 UI 三项重构：H1/H2 层级区分增强（H1 加大保留下划线，H2 主题色文字 + 左竖条）；章节标题即索引页链接（主题色显示，下拉不再重复同名索引项）；「本页内容」目录框可折叠并在折叠时停靠侧栏底部
• 页面原型（module / flow）：流程/机制主题页可选用流程型模板（流程总览/关键步骤/参与组件/数据与状态变化），校验器按原型分规则
• coverage 子命令：确定性覆盖率报告——wiki 从未引用的仓库文件、逐页引用密度、零引用页面
• update/stale 新增 --dirty：纳入工作区未提交与未跟踪变更；overview 总览页纳入增量更新
• 知识卡片类别可配置：knowledge --categories <file> 整表替换内置六类
• llms.txt / llms-full.txt 导出：site 同时产出 agent 消费索引（llmstxt.org 约定），无需 MCP
• 只读 stale 子命令 + 官方 GitHub Action（wiki.yml）：PR wiki 过期门禁（过期自动评论并拦截）；push main 自动重建并发布 GitHub Pages
• PyPI 发布就绪：元数据齐全，待配置账号后 pip install repowiki 即可用

187 tests · Python 3.10–3.13 · macOS / Linux / Windows 原生

安装 / Install

pip install git+https://github.com/luomsis/repowiki.git
# 或离线安装：下载附件 repowiki-0.5.0-py3-none-any.whl（见 README「离线安装」一节）

v0.4.0

What's Changed

Added

• Knowledge cards fully wired into the incremental update flow: update maps changed files against the knowledge plan — cards whose source_files changed and modules whose scope was touched each get a refresh task (card updates carry an "Update Summary" section, enforced by check) (1031ce7)
• site renders knowledge module docs and cards under a dedicated "Knowledge Base" nav chapter — searchable, with source popups and mermaid; card front matter is stripped for display (1031ce7)
• update re-arms done update tasks across finalize epochs with freshly regenerated specs — previously the second update round silently did nothing (1031ce7)
• Knowledge YAML exports fill source_files in _index.yaml / _module.yaml (union of card source files under each module's scope) (1031ce7)

Fixed

• Removed unreachable dead code in knowledge.py (1031ce7)

Full Changelog: v0.3.3...v0.4.0

v0.3.3

What's Changed

Fixed

• Site drawer menu button: the topbar #menu-btn is a dead control on desktop, where the sidebar is always visible; it now only shows on narrow screens (≤900px) (e63798e)

Documentation

• Bilingual architecture diagrams: the ASCII diagram on both README landing pages is replaced with drawn diagrams — Chinese diagram for README.md, English for README.en.md — plus interactive archify HTML + specs under docs/ (light/dark themes, path highlighting, node search) (596bab1)
• Softened the "no LLM" self-description: README lead/features now say "deterministic build"; package description, CLI --help, and module docstring follow suit (596bab1)

Full Changelog: v0.3.2...v0.3.3

v0.3.2

新增

• 文档集中双语化：docs/ 改为 zh/ + en/ 镜像结构（CONTEXT.md、DECISIONS.md、ADR 迁入 docs/zh/），新增全量英文版 CHANGELOG.en.md 与 docs/en/**；README、CHANGELOG 留在仓库根部。
• README 英文版与 launch 打磨：新增 README.en.md；badges、「为什么是 repowiki」对比表、Features、用法（Usage）、Roadmap、Contributing、社区入口、目录。
• 新增 skills/repowiki/SKILL.en.md（SKILL.md 的英文姊妹版）；每对双语文档顶部互加切换链接。

修复

• 语言自动检测优先 README.md：detect_locale 原取 sorted(glob("README*")) 的第一个——README.en.md 排序在 README.md 之前，双语仓库的 plan --replan 会把产出语言误判为 en；现在 README.md 存在时以其为准，缺失才回退其余 README*。

Added (English)

• Centralized bilingual docs: docs/ restructured into zh/ + en/ mirrors, full English CHANGELOG.en.md and docs/en/**; English README with launch polish (badges, why/features/usage, roadmap, contributing, community).
• Fixed locale auto-detection to prefer README.md over translated siblings, so bilingual repos no longer misdetect en on replan.

Full Changelog: v0.3.1...v0.3.2

v0.3.1

修复

• catalog 校验拒绝占位符标题：节点 title 含 {{...}} 模板占位符形态时 validate_catalog
  报错。此前这类标题会一路穿透进任务规格与页面 H1（templates.render 按 key 替换、未知占位符
  原样保留，{{TITLE}} 被填回字面量），而产物校验又把 H1 里的该字面量判为「未替换占位符」
  ——任务从规格生成那一刻起就注定无解（实战中一个页面任务因此耗尽重试）。
  同步在 zh/en 两份 catalog 任务模板的规划规则第 3 条写明禁令。
• 占位符扫描只针对非代码文本：页面/卡片/总览三处「仍含未替换的模板占位符」检查改为剔除
  fenced 代码块与行内代码后扫描——文档页 legitimately 讨论占位符机制时，代码里的字面
  {{...}} 是内容而不是缺陷；散文中的残留占位符照旧失败。正则更名为公开的
  repowiki.validate.PLACEHOLDER_RE 供 catalog.py 复用。

变更

• 站点查看器（wiki.html）视觉全面改版：引入设计令牌体系（中文字形字体栈、h1-h6 字阶、
  圆角/阴影令牌）、代码块头栏（语言标签 + 复制按钮）、侧栏页内目录 + scroll-spy 跟随高亮 +
  章节折叠、暗色主题层次分离、表格斑马纹、mermaid 卡片容器、prev/next 翻页、阅读进度条、
  顶栏 SVG 图标与面包屑、搜索命中词高亮、prefers-reduced-motion 与 :focus-visible
  可访问性细节。payload 结构与单文件契约不变（仍恰好 4 个内联 script、零外部资源）。

测试

• 新增 2 个用例：catalog title 含占位符 → 报错；占位符出现在代码块/行内代码中 → 通过。
  149 个测试全绿。

---

注：以上「Windows CI 兼容」与「watch 停滞误报」两项修复在打 v0.3.1 tag 后补入 main
（5d22877），属于预存问题的修复，不影响本版本功能；将随下个版本正式进入 tag。

v0.3.0

What's Changed

Features

• Windows 原生支持（零新增依赖）：并发状态控制改为 stdlib 双锁后端（POSIX fcntl / Windows msvcrt.locking），移除"请用 WSL"的运行时门控；修复 tasks.py 反斜杠路径下取错仓库名的问题；CI 矩阵加入 windows-latest；SKILL.md 补充 PowerShell 等价命令。运行时依赖仍只有 pyyaml。
• repowiki site <repo> [--open]：单文件离线查看站点。finalize 后把全部 wiki 页面渲染为一个自包含 HTML（.repowiki/<locale>/wiki.html，约 4-5 MB）：markdown + mermaid 全渲染、file:// 源码引用点击弹层展示内嵌的行号源码、侧边栏导航、客户端全文搜索、暗/亮主题。双击即看、零网络，单文件即可分享；幂等可重跑。

Bug Fixes

• 插件清单 .claude-plugin/plugin.json 版本号滞后（0.1.0），对齐为 0.3.0。

Documentation

• 新增根级 CONTEXT.md 术语表与 docs/adr/0001（Windows 双锁后端取舍）、docs/adr/0002（单文件离线站点，回撤 Non-Goal「HTML 预览服务」）。
• README：三平台声明、新增「查看 Wiki（单文件离线站点）」章节、命令表补 site。

Notes

• 140 个测试全绿；CI 覆盖 ubuntu / macos / windows × Python 3.10-3.13。
• 附带的 repowiki-0.3.0-py3-none-any.whl 可直接离线安装（唯一依赖 pyyaml 需按目标平台准备，见 README 离线安装）。

Full Changelog: v0.2.0...v0.3.0

v0.2.0

What's Changed

Breaking Changes

• BREAKING: 移除 next --batch —— worker 契约本就禁止一次持有多个认领，该参数是无消费者的投机接口。现在 next 每次只发放一个任务（ready_tasks(limit=1)）；旧脚本里的 --batch N 直接删掉即可。

Other Changes

• refactor: ponytail 全仓审计瘦身，净删约 76 行 —— 新增共享 git 子进程助手 gitutil.run_git（scanner / metadata / knowledge / updater 四处收敛）；删除仅声明未消费的死代码（templates.placeholders、Inventory.to_dict、FileEntry.size、WikiPaths.repo_rel、i18n.module_optional_files、FlatNode.dir、validate.check_catalog 转发包装等）；CLI 分发改为子 parser set_defaults(func=cmd_*)；state.stats() 直接输出 busy，next / watch / status 繁忙口径单源化；finalize 的 catalog.json 从最多解析 3 次减为 1 次。126 个测试全绿。

Documentation

• docs: README 新增「离线安装」一节 —— 运行时仅依赖 pyyaml，给出 pip download 备料 + pip install --no-index 的完整离线路径，以及 skill 目录的手动拷贝方式。

Full Changelog: v0.1.0...v0.2.0