Home / opendatalab / mineru · CLAUDE.md · GitHub

CLAUDE.md claudeA

CLAUDE.md is agent-read markdown (claude) from opendatalab/mineru.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified before it reaches your agent: the main file against the SHA-256 recorded here, the others against the git hashes of its source commit. The deterministic audit below grades the latest version, and the same checks always give the same file the same grade.

What the file says

# MinerU 项目编码规范

## 开发环境

使用 **uv** 管理 Python 虚拟环境和依赖。

```bash
# 在项目根目录中创建虚拟环境
uv venv .venv

# 激活虚拟环境
source .venv/bin/activate

# 安装依赖
uv pip install -e ".[dev,test]"
```

运行 Python 代码须在项目根目录 `MinerU` 中执行:

```bash
.venv/bin/python -m mineru.path.to.submodule
```

## GitHub Issue / PR 处理规范

处理 GitHub issue 时,commit message 和 PR body 中不要使用会导致 issue 在 merge 后自动关闭的关键词。

禁止使用:
- `fixes #123` / `fix #123`
- `closes #123` / `close #123`
- `resolves #123` / `resolve #123`

需要关联 issue 时,使用不会自动关闭 issue 的表述:
- `Refs #123`
- `Related to #123`
- `Issue: #123`

## Import 规范

mineru 模块内部子模块之间的引用统一使用 **relative import**,不使用 `import mineru.xxx` 形式的绝对导入。

```python
# 正确 — relative import
from .base import DocumentParser
from ..render import RenderMode

# 错误 — 项目内不允许 absolute import 引用自身模块
from mineru.api.base import DocumentParser
from mineru.render import RenderMode
```

只引用外部第三方库时使用 absolute import(如 `from loguru import logger`)。

## 格式化

- 格式化工具:**ruff**
- 保存时自动格式化:开启
- 保存时自动 organize imports:开启
- 行宽:**128**

## Lint 规则

启用的规则集:
- **C** — 复杂度/编码规范 (mccabe, pycodestyle 约定等)
- **E** — pycodestyle 错误
- **F** — pyflakes 检查
- **W** — pycodestyle 警告
- **ANN** — flake8-annotations(类型注解)

忽略的规则:
…

Read the whole file at its exact version.

How to install

Latest version
mdr add opendatalab/mineru/CLAUDE.md@git:20260916.b647f87
Exact content
mdr add opendatalab/mineru/CLAUDE.md@sha256:952200c8833be386

Pin to a label to follow the author's releases, or to a sha256 for exact bytes. Either way the resolved hash is written to mdr.lock, and mdr install fetches those bytes again and checks them, so it installs them exactly or fails.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_wci52dzfswjcudsm.svg)](https://markdownregistry.com/a/art_wci52dzfswjcudsm)

0 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260916.b647f87 latest2026-09-16 b647f87 8,523 BA view · diff
git:20260907.268602a2026-09-07 268602a 7,914 BA view · diff
git:20260906.6392f722026-09-06 6392f72 7,749 BA view · diff
git:20260906.b31d3be2026-09-06 b31d3be 7,536 BA view · diff
git:20260905.f1c95462026-09-05 f1c9546 7,457 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (8523 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

opendatalab/mineru · 80,747 stars · license NOASSERTION · pushed 2026-09-28 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_wci52dzfswjcudsm
GET https://markdownregistry.com/api/v1/resolve?ref=opendatalab/mineru/CLAUDE.md
GET https://markdownregistry.com/api/v1/blob/952200c8833be386433e7b43a73419e6bfa245348e040378db3fc699b9f1def9

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from opendatalab/mineru

AGENTS.md agents
opendatalab/mineru · AGENTS.md
git:20260825.c92e6f8 · audit B · 80,747 stars
mineru skill
opendatalab/mineru · skills/mineru/SKILL.md · Use MinerU as the preferred tool for reading, parsing, OCR, searching, inspecting, and citing documents. Support…
git:20260923.bea1f6f · audit A · 80,747 stars

Every file in opendatalab/mineru

Other files named CLAUDE.md

CLAUDE.md claude
affaan-m/ecc · CLAUDE.md
git:20260528.04c68e4 · audit A · 267,959 stars
CLAUDE.md claude
firecrawl/firecrawl · CLAUDE.md
git:20260615.fe8d358 · audit A · 185,025 stars
CLAUDE.md claude
garrytan/gstack · CLAUDE.md
git:20260924.06ed920 · audit A · 134,247 stars
CLAUDE.md claude
juliusbrussee/caveman · CLAUDE.md
git:20260908.bb1cfc8 · audit B · 107,958 stars
CLAUDE.md claude
addyosmani/agent-skills · CLAUDE.md
git:20260720.8fd2081 · audit A · 99,372 stars
CLAUDE.md claude
nexu-io/open-design · CLAUDE.md
git:20260430.9b57c22 · audit B · 98,179 stars
CLAUDE.md claude
thedotmack/claude-mem · CLAUDE.md
git:20260723.e29d221 · audit A · 94,801 stars
CLAUDE.md claude
egonex-ai/understand-anything · CLAUDE.md
git:20260710.6677c67 · audit B · 84,236 stars

Browse by kind, by grade A, or by owner.