wiki-bot: Skill for Claude Code

wiki 读写配方（pywikibot 库方式 + 裸 API）

读写 rezero.fandom.com（re0 family，12 个语言子站）的实测用法与坑。 安全红线、环境要求和最小用法见 AGENTS.md「读写 wiki」一节；本文档是完整配方。

读

import pywikibot

site = pywikibot.Site("zh", "re0")   # 其他语言站: Site("en", "re0") 等

p = pywikibot.Page(site, "角色:菜月·昴")
p.exists()            # bool
p.text                # wikitext 全文
p.isRedirectPage()    # bool
p.getRedirectTarget() # 重定向目标 Page（注意: 本 wiki 重定向写作 #REDIRECT 而非 #重定向）
p.namespace()         # 命名空间对象，str() 得到名字（主命名空间是空串）

# 历史版本
for rev in p.revisions(total=2):
    rev.timestamp, rev.user, rev.comment, rev.text  # rev.text 是该版本全文

pywikibot.Page(site, title) 构造本身不发请求，访问 .text 才发。

写

site.login()  # 写入前必须；纯读取可以不登录
assert site.user() == "IchiSanNi"

p = pywikibot.Page(site, "User:IchiSanNi/沙盒")
p.text = p.text + "\n追加内容\n"
p.save(summary="编辑摘要", bot=False, minor=False)  # 手动编辑：bot/minor 都必须显式关
p.save(summary="编辑摘要", bot=True)                # 批量脚本：加 bot=True（或 p.put(...)）

• bot flag 的取舍：bot flag 会阻止常规通知机制（避免批量编辑刷屏）。跑批量脚本时用 bot=True 没问题；但手动编辑特定页面时，操作更接近需人工审查的常规编辑，不要加 bot flag。
• pywikibot ≥9.4 起 save() 默认 bot=True, minor=True（None 选项已移除）——手动编辑不显式传 bot=False, minor=False 就会被标成 bot 小编辑，且 bot/minor 标记事后无法摘除（只能等滚出 recentchanges）。
• 验证 bot flag 要查 list=recentchanges（rcprop=flags）；usercontribs 的 ucprop=flags 不返回 bot 键（即使编辑带 bot flag），会漏报。
• botflag= 参数已废弃，用 bot=；传了 botflag 只会触发 FutureWarning，不影响保存。
• save 有内置异常保护；批量写建议 try pywikibot.exceptions.PageSaveError。
• baserevid 冲突验证必须用不同账号的修订：MediaWiki 会抑制同一账号的自我编辑冲突（2026-10-26 沙盒实证：同账号持旧 baserevid 仍可保存；改用最近编辑者为另一账号的 Sandbox 后，旧 baserevid + basetimestamp 正确返回 EditConflictError）。构造反例时先核对 latest_revision.user，不能用 bot 自己连续两次编辑充当并发用户。

生成器（pagegenerators）

from itertools import islice
from pywikibot import pagegenerators

# 全文搜索 —— 注意 Fandom 不支持 intitle: 前缀语法（实测返回空），用普通关键词
pagegenerators.SearchPageGenerator("菜月昴", site=site, total=5)

# 分类成员（含子分类用 cat.subcategories()）
cat = pywikibot.Category(site, "Category:新搬运待整理")
cat.articles(total=10)            # total= 在这里生效
cat.categoryinfo["size"]          # 成员数

# 最近更改（注意大小写: RecentChangesPageGenerator）
pagegenerators.RecentChangesPageGenerator(site=site, total=10)

# 链入页面 —— 坑: backlinks(total=N) 的 total 不生效（实测 total=3 返回 31 条），用 islice
list(islice(pywikibot.Page(site, "角色:菜月·昴").backlinks(), 10))

# 模板引用页（embeddedin 的 total= 生效）
list(pywikibot.Page(site, "Template:Init").embeddedin(total=10))

# 按前缀枚举 —— 用 PrefixingPageGenerator（内部走 apprefix，严格限定前缀）
pagegenerators.PrefixingPageGenerator(prefix="小说:", namespace=0, site=site, filterredir=False)