Skip to content

README: 添加使用 npx skills 安装的说明 #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
yegle wants to merge 3 commits into
base: main
Choose a base branch
from
Open

README: 添加使用 npx skills 安装的说明 #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4a4ebc5
README: 添加使用 npx skills 安装的说明
yegle Aug 27, 2026
b00a1cd
SKILL.md: 为 description 字段加引号以避免 YAML 解析错误
yegle Aug 27, 2026
d144826
README: 强调必须勾选「创建、编辑和移动页面」权限及常见报错说明
yegle Aug 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 19 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,17 @@

## 安装

**Claude Code** —— 放进 skills 目录即可，重启后自动发现：
**使用 `npx skills`（推荐）**：

```bash
# 全局安装（所有项目及支持的 agent 可用）
npx skills add daizhige-org/wikisource-ocr-writeback-skill -g

# 或安装到当前项目
npx skills add daizhige-org/wikisource-ocr-writeback-skill
```

**手动安装（Claude Code）** —— 放进 skills 目录即可，重启后自动发现：

```bash
# 只给自己用
Expand Down Expand Up @@ -68,17 +78,19 @@ OCR 用的是 [ocr.wmcloud.org](https://ocr.wmcloud.org)（Wikimedia 官方服

### 二、勾哪些权限

按 Special:BotPasswords 上的中文标签：
按 Special:BotPasswords 上的标签（中英文对照）：

| 权限 | 要不要 | 为什么 |
|---|---|---|
| 基本权限 | 自动包含 | 读页面、拿 token |
| **编辑存在的页面** | **必须** | 改已有的 `Page:` 页 |
| **创建、编辑和移动页面** | **必须** | `Page:` 页绝大多数是新建的，少这条会在建页时失败 |
| 大量操作（机器人）访问权限 | 不用 | 只有帐号真有 bot 标记时才有意义 |
| 基本权限 (*Basic rights*) | 自动包含 | 读页面、拿 token |
| **编辑存在的页面** (*Edit existing pages*) | **必须** | 修改已有的 `Page:` 或 `Index:` 页 |
| **创建、编辑和移动页面** (*Create, edit, and move pages*) | **必须** | 新建 `Index:` 目录页与绝大多数初次录入的 `Page:` 页面 |
| 大量操作（机器人）访问权限 (*High-volume editing*) | 不用 | 只有帐号真有 bot 标记时才有意义 |
| 编辑受保护的页面 / 上传新文件 / 删除 | **别勾** | 这份 skill 完全用不到 |

**只勾中间那两条**就够。权限给少了顶多某一步报错，给多了是白白扩大泄露后的破坏面。
**必须同时勾选「编辑存在的页面」和「创建、编辑和移动页面」两条权限**。权限给少了某一步会报错，给多了则是白白扩大泄露后的破坏面。

> ⚠️ **常见报错**：如果漏勾「创建、编辑和移动页面」，在新建 `Index:` 目录页或初次写回 `Page:` 页面时会报 `cantcreate: You do not have permission to create new pages`（或 `User not authorized to create new pages`）错误。若遇到此报错，直接回到 `Special:BotPasswords` 页面编辑该 BotPassword 补充勾选即可，无需重置或更换密码。

### 三、两个配置文件

Expand Down
2 changes: 1 addition & 1 deletion SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: wikisource-ocr-writeback
description: 给 Wikisource 上一部已有扫描件的书逐页做 OCR 并写回。用 ocr.wmcloud.org（Wikimedia 官方 OCR，可选 Google／Tesseract／Transkribus 引擎）识别 Commons 上的 PDF/DjVu，结果存盘，再用 pywikibot 以用户帐号写进 Page: 名字空间。也包括 OCR 读不动时（点线目录、表格、竖排、模糊数字）改成本地高清渲图＋自己看图录入的办法，以及录入时的用字规矩和 ProofreadPage 排版约定。触发词：OCR 写回、ocr.wmcloud.org、wmcloud OCR、Wikisource 逐页识别、Page 名字空间批量建页、目录/索引格式化。
description: "给 Wikisource 上一部已有扫描件的书逐页做 OCR 并写回。用 ocr.wmcloud.org（Wikimedia 官方 OCR，可选 Google／Tesseract／Transkribus 引擎）识别 Commons 上的 PDF/DjVu，结果存盘，再用 pywikibot 以用户帐号写进 Page: 名字空间。也包括 OCR 读不动时（点线目录、表格、竖排、模糊数字）改成本地高清渲图＋自己看图录入的办法，以及录入时的用字规矩和 ProofreadPage 排版约定。触发词：OCR 写回、ocr.wmcloud.org、wmcloud OCR、Wikisource 逐页识别、Page 名字空间批量建页、目录/索引格式化。"
---

# Wikisource 扫描书的 OCR 与写回
Expand Down