mineru-tianshu: Instructions file for Codex

AGENTS.md

mineru-tianshu AGENTS.md is an instructions file for Codex, OpenCode from magicyuan876/mineru-tianshu. It costs 4,665 tokens per session, scanned A, original, Apache-2.0.

Project instructions for an AI coding agent working on MinerU Tianshu, a platform that turns documents and other media into structured data. They describe the project, its technologies, layout, commands, and language conventions.

In plain words
What is it for?
Use them when modifying this project, especially when working on its Vue frontend, Python backend, media processing, storage, or deployment setup.
Why use it?
They give the agent repository-specific context so its changes follow the existing structure and documentation style.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions CLAUDE.md; mentions Claude Code; mentions AGENTS.md.

This is magicyuan876/mineru-tianshu's own configuration. It tells Codex and OpenCode how to work on mineru-tianshu itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything mineru-tianshu configures →

Reuse

Borrowing it

Nothing to install: this file belongs to magicyuan876/mineru-tianshu. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/magicyuan876/mineru-tianshu/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/magicyuan876/mineru-tianshu

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mineru-tianshu AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/magicyuan876/mineru-tianshu/agents-md/github.svg)](https://agentmods.dev/instructions/magicyuan876/mineru-tianshu/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/magicyuan876/mineru-tianshu/agents-md"><img src="https://agentmods.dev/badge/instructions/magicyuan876/mineru-tianshu/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for mineru-tianshu AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/magicyuan876/mineru-tianshu/agents-md"><img src="https://agentmods.dev/badge/instructions/magicyuan876/mineru-tianshu/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4,665 This file is loaded in full into every session.
When invoked 4,665 The same file — it is already loaded in full.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.04665 $0.04665
Opus 5 $0.02332 $0.02332
Sonnet 5 $0.00933 $0.00933
Haiku 4.5 $0.00466 $0.00466

Measured today against content hash e1512fe78d01, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

mineru-tianshu AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

功能验证方式:`make test-gpu`(容器内验证 CUDA)、`make test-api`(curl 健康检查),以及通过前端页面/API 手动跑通端到端流程。
AGENTS.md · 253 lines

How it starts

The opening of the file, as written. The whole thing — 253 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md — MinerU Tianshu(天枢)

本文件面向 AI 编码代理,介绍本项目的架构、命令与开发约定。 项目文档、代码注释、日志输出以简体中文为主,修改现有文件时请保持中文注释风格。

项目概述

MinerU Tianshu(天枢)是一个企业级 AI 数据预处理平台,将非结构化数据转换为 AI 可用的结构化格式(Markdown + JSON):

  • 📄 文档:PDF、Word、Excel、PPT(MinerU 原生解析 DOCX/XLSX/PPTX;旧版 .doc/.xls/.ppt 经 LibreOffice 转换)、HTML/TXT/CSV(MarkItDown)
  • 🖼️ 图片:JPG、PNG、BMP、TIFF(多 OCR 引擎 + 水印去除🧪)
  • 🎙️ 音频:MP3、WAV、M4A、FLAC(SenseVoice 多语言、说话人识别、情感识别)
  • 🎬 视频:MP4、AVI、MKV、MOV、WebM(FFmpeg 音频提取转写 + 关键帧 OCR🧪)
  • 🧬 生物格式:FASTA、GenBank(插件化格式引擎)
  • 🏗️ 企业特性:GPU 负载均衡、任务队列、JWT 认证、API Key、MCP 协议、RustFS 对象存储

技术栈

技术
前端 Vue 3、TypeScript、Vite、TailwindCSS、Pinia、Vue Router、vue-i18n(中英文)
后端 Python 3.12+、FastAPI、LitServe(GPU 负载均衡)、SQLite(任务队列/认证)、可选 Redis 队列
AI 引擎 MinerU 3.4+(pipeline/vlm/hybrid,含 vllm-mineru 远程模式)、SenseVoice/FunASR、MarkItDown
基础设施 Docker Compose、Nginx(前端)、RustFS(S3 兼容对象存储,minio-py 客户端)、MCP 协议
许可证 Apache License 2.0

项目结构

mineru-tianshu/
├── frontend/                  # Vue 3 前端
│   ├── src/
│   │   ├── api/               # Axios API 客户端(authApi/taskApi/queueApi/systemApi)
│   │   ├── components/        # 组件(MarkdownViewer、JsonViewer、VirtualPdfViewer 等)
│   │   ├── views/             # 页面(Dashboard、TaskSubmit、TaskDetail、Login 等)
│   │   ├── stores/            # Pinia 状态(authStore、taskStore、queueStore 等)
│   │   ├── locales/           # i18n(zh-CN.ts、en-US.ts)
│   │   ├── router/            # Vue Router(含权限路由守卫)
│   │   └── types/ utils/      # TypeScript 类型与工具
│   ├── package.json  vite.config.ts  Dockerfile
│
├── backend/                   # Python 后端(所有服务共用此目录代码)
│   ├── start_all.py           # 统一启动脚本(本地开发入口)
│   ├── api_server.py          # FastAPI API 服务器(端口 8000)
│   ├── litserve_worker.py     # LitServe GPU Worker Pool(端口 8001)
│   ├── task_scheduler.py      # 任务调度器(超时重置、文件清理)
│   ├── mcp_server.py          # MCP 协议服务器(端口 8002,供 Claude Desktop 等调用)
│   ├── task_db.py             # SQLite 任务数据库(启动时原地迁移)
│   ├── redis_queue.py         # Redis 优先级队列(可选,SQLite 自动回退)
│   ├── download_models.py     # 模型预下载脚本
│   ├── auth/                  # JWT 认证、API Key、角色权限、OIDC/SAML SSO
│   ├── mineru_pipeline/       # MinerU 引擎封装
│   ├── audio_engines/         # SenseVoice 音频引擎
│   ├── video_engines/         # 视频引擎(FFmpeg + 关键帧提取,OCR 走 MinerU)
│   ├── format_engines/        # 插件化格式引擎(FASTA、GenBank 为参考实现)
│   ├── remove_watermark/      # 水印去除(YOLO11x + LaMa)
│   ├── output_normalizer/     # 输出标准化(统一 result.md/result.json/images/)
│   ├── storage/               # RustFS S3 客户端(图片上传、URL 替换)
│   ├── utils/                 # 工具函数
│   ├── requirements.txt       # Python 依赖(版本锁定,含 mineru[all]>=3.4.5)
│   └── Dockerfile  Dockerfile.cpu  Dockerfile.offline  install.sh
│
├── dify_plugin/tianshu/       # Dify 插件(manifest.yaml + provider/ + tools/)
├── setup.sh                   # 一键部署入口(交互式引导 + 非交互参数 --mode/--yes/--dry-run)
├── scripts/                   # 辅助脚本(docker-entrypoint.sh、init-models.sh)
├── docker-compose.yml         # 生产编排(GPU 版,含 vllm-mineru/rustfs 等)
├── docker-compose.dev.yml     # 开发编排(热重载 + debugpy 端口 5678)
├── docker-compose.cpu.yml     # CPU 本地开发(Mac Apple Silicon,需 Rosetta 2)
├── docker-compose.offline.yml # 离线部署编排
├── docker-compose.pipeline.yml# 纯 pipeline 模式部署
├── Makefile                   # Docker 快捷命令
├── pyproject.toml             # Ruff 配置(无 Python 打包用途)
├── .pre-commit-config.yaml    # pre-commit 钩子(唯一 CI 质量门禁)
└── .env.example               # 根环境变量模板(docker-compose 与 Makefile 消费)

Read the full file on GitHub · 253 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 253 lines · 4,665 tokens per session scan A e1512fe78d01

Subscribe to this mod's changes

mineru-tianshu AGENTS.md is an instructions file published in the GitHub repository magicyuan876/mineru-tianshu (797 stars, last pushed yesterday), licensed Apache-2.0. It adds 4,665 tokens to every session, about $0.0233 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-12.

Related

Other instructions, from other repositories

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,126 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens