Портативный набор навыков агента и локальных инструментов для рабочего процесса:

Репозиторий является каноническим источником для полного рабочего процесса и для навыка поиска литературы. Новый контент Vault использует одну структуру: 01knowledge/, 02vault/, 03fulltext/ и 模板/. Ни один инструмент не требует авторских букв или приватных скриптов.

Требования

• Python 3.11 или новее. Комплектные инструменты используют только стандартную библиотеку Python.
• Рабочий стол Zotero при чтении локальной базы данных Zotero или вложений.
• MinerU является опциональным; установите его отдельно, если требуется конвертация PDF. Convert runner принимает исполняемый путь в конфигурации.
• Obsidian необязателен для редактирования и навигации по Markdown. Dataview необязателен для пользователей, чьи собственные индексные страницы используют Dataview.
• rg (ripgrep) необязательно. Навыки могут использовать доступные инструменты поиска проектов агента, когда он отсутствует.

Нет базы данных Zotero, PDF, приватного контента Vault, пакета API или учетных данных не включены.

Установка

На macOS/Linux используйте следующее:

init_vault.py создаёт только отсутствующие каталоги, копирует только отсутствующие шаблоны в комплектах, и создаёт локальный [config.toml только если его не существует.

Zotero Analytical Workflow Skills

A portable set of agent Skills and local tools for the workflow:

Zotero → MinerU Fulltext → Analytical Notes → Knowledge → Literature Retrieval

The repository is the canonical source for the complete workflow and for the Literature Retrieval Skill. New Vault content uses one layout: 01knowledge/, 02vault/, 03fulltext/, and 模板/. No tool requires the author’s drive letters or private scripts.

Requirements

• Python 3.11 or newer. The bundled tools use only the Python standard library.
• Zotero Desktop if reading the local Zotero database or attachments.
• MinerU is optional; install it separately if PDF conversion is required. The conversion runner accepts the executable path in configuration.
• Obsidian is optional for editing and navigating Markdown. Dataview is optional for users whose own index pages use Dataview.
• rg (ripgrep) is optional. The Skills can use the agent’s available project search tools when it is absent.

No Zotero database, PDF, private Vault content, API package, or credential is included.

Installation

git clone https://github.com/cheneternity/Zotero-Analytical-Workflow-Skills.git
cd Zotero-Analytical-Workflow-Skills
py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python tools/init_vault.py --vault-root "E:\ResearchVault"

On macOS/Linux, use:

python3.11 -m venv .venv
source .venv/bin/activate
python tools/init_vault.py --vault-root "$HOME/ResearchVault"

init_vault.py creates only missing directories, copies only missing bundled templates, and creates a local config.toml only if it does not exist. It does not modify existing research files or Zotero data.

Set the Zotero and MinerU locations in the generated, git-ignored config.toml (format shown below), then check the setup:

python tools/check_environment.py

The checker is read-only. Zotero, MinerU and rg are optional capabilities and show WARN when not configured; missing Python, Vault folders or bundled tools show FAIL.

Configuration

Copy config.example.toml or let the initializer create config.toml. Paths are local filesystem paths; use TOML strings and forward slashes for portable examples:

[paths]
vault_root = "E:/ResearchVault"
zotero_data_dir = "C:/Users/alex/Zotero"
mineru_executable = "C:/Tools/MinerU/mineru.exe"
archive_root = "E:/ResearchVault/_staging/mineru"

Any value can be overridden per process with RESEARCHVAULT_ROOT, ZOTERO_DATA_DIR, MINERU_EXECUTABLE, or RESEARCHVAULT_ARCHIVE_ROOT. RESEARCHVAULT_CONFIG selects another TOML config file. CLI flags override configuration where offered. Do not commit your local config.toml.

Canonical Vault layout

/
├── 01knowledge/
│   ├── index.md
│   ├── log.md
│   ├── _index/
│   └── .meta/                 # claims and gaps; machine metadata only
├── 02vault/