diff --git a/README.md b/README.md
index eb2939b..4536bc6 100644
--- a/README.md
+++ b/README.md
@@ -1,13 +1,53 @@
+
@@ -15,207 +55,219 @@
## 🎯 What is BPM?
-**Better Plugins Manager** is a powerful Obsidian plugin manager that provides a richer management experience than the native one.
+**Better Plugins Manager (BPM)** is a control center for Obsidian community plugins, designed for vaults that rely on many plugins and need more than simple enable/disable toggles.
-> Delay Start • Batch Operations • Groups & Tags • GitHub Install • Conflict Troubleshooter • Mobile Friendly
+It helps you keep startup responsive, organize plugins by workflow, install plugins from GitHub releases, and isolate conflicts when something breaks.
+
+| 🚀 Startup | 📦 Management | 🏷️ Organization | 📥 Installation | 🔍 Diagnosis |
+|------------|---------------|------------------|-----------------|--------------|
+| Delayed plugin startup and startup self-checks | Batch enable/disable, quick search, and status filters | Groups, tags, notes, descriptions, and custom names | Install from GitHub repositories and release versions | Guided conflict troubleshooting with report generation |
---
## ✨ Core Features
-### 🚀 Performance Optimization
-| Feature | Description |
-|---------|-------------|
-| **Delay Start** | Start plugins with preset delays to reduce startup lag |
-| **Startup Self-Check** | 🆕 Detect plugin management conflicts, prevent Obsidian and BPM from controlling plugins simultaneously |
+BPM is organized around five focused tabs. Each tab owns one workflow, so related controls stay together and the manager remains easy to scan across desktop and mobile.
-This feature needs to be enabled in settings, disabled by default.
-
+| Tab | Workflow |
+|-----|----------|
+| 🧩 Plugin View | Manage installed plugins, metadata, filters, startup behavior, and per-plugin actions |
+| 📥 Install Hub | Install plugins or themes from GitHub and manage tracked sources |
+| 📦 Transfer Pack | Export, import, and restore plugin/theme packs across vaults |
+| 🎛️ Ribbon Order | Control Obsidian ribbon icon order and visibility |
+| 🔍 Conflict Diagnosis | Locate plugin problems and generate troubleshooting reports |
-### 📦 Batch Management
-| Feature | Description |
-|---------|-------------|
-| **Toggle All** | Quickly enable/disable all plugins |
-| **Group Operations** | Batch enable/disable by group |
-| **Quick Search** | Filter by status, group, tag, delay, and keywords |
+### 🧩 Plugin View
-### 🏷️ Organization & Annotation
-| Feature | Description |
-|---------|-------------|
-| **Custom Names** | Give plugins memorable names |
-| **Notes & Descriptions** | Record plugin usage and configuration notes |
-| **Groups & Tags** | Flexible categorization, BPM installs auto-tagged `bpm-install` |
+The main tab for day-to-day plugin management.
-### 📥 GitHub Installation
+
-1. 
-2. 
+| Area | What it does |
+|------|--------------|
+| **Plugin list** | Browse installed community plugins in a compact, searchable management view |
+| **Batch actions** | Enable or disable plugins in bulk, including grouped workflows |
+| **Filters** | Filter by enabled state, group, tag, delay setting, and keyword |
+| **Organization** | Add custom names, descriptions, notes, groups, and tags |
+| **Startup control** | Assign delayed startup presets and keep startup behavior visible from the list |
+| **Plugin actions** | Check updates, download updates, restart a plugin, temporarily start a plugin, open settings, open folders, copy IDs, open repositories, clear config, hide, or delete |
+| **BPM tags** | Automatically marks BPM-installed plugins with `bpm-install` and supports ignored plugins with `bpm-ignore` |
-| Feature | Description |
-|---------|-------------|
-| **Repo Install** | Supports `user/repo` or full URL |
-| **Version Selection** | Pick releases like BRAT |
-| **Jump to Repo** | One-click jump to GitHub from plugin card |
+### 📥 Install Hub
-### 🔍 Conflict Troubleshooter 🆕
+The Install Hub handles GitHub-based installation and the sources BPM can track after installation.
-
+
-| Feature | Description |
-|---------|-------------|
-| **Binary Search** | Quickly locate problematic plugins or conflict pairs |
-| **Wizard-style UI** | Draggable floating window, test while troubleshooting |
-| **Generate Report** | Export Markdown troubleshooting report |
+| Area | What it does |
+|------|--------------|
+| **Install type** | Switch between plugin and theme installation |
+| **Repository input** | Accepts `user/repo` or full GitHub repository URLs |
+| **Release selection** | Fetch available GitHub releases and install latest or a selected version |
+| **Release notes** | Shows release information before installation when available |
+| **Recent installs** | Keeps recently used repositories for faster repeated installs |
+| **Source tracking** | Optionally tracks installed repositories for later checks, updates, and reinstalls |
+| **Source management** | Review tracked plugin/theme sources, update targets, reinstall items, and keep source metadata current |
+### 📦 Transfer Pack
+The Transfer Pack tab moves plugin setups between vaults without turning the README into a manual checklist.
-### ↕ Customize Ribbon Bar 🆕
+
-If you are annoyed by the ribbon icons changing order every time you start Obsidian due to BPM's delayed startup, please use this feature.
+| Area | What it does |
+|------|--------------|
+| **Export list** | Select local plugins and themes to include in a JSON transfer pack |
+| **Plugin configs** | Export selected plugin configuration files when needed |
+| **Taxonomy** | Export BPM groups, tags, and delay presets |
+| **Layout data** | Export manager order, hidden items, and ribbon layout |
+| **Sources** | Export GitHub repository maps, source subscriptions, and install history |
+| **Workspace preferences** | Export style, delay mode, tag display, and startup-check preferences |
+| **Import preview** | Load a pack, review bundled plugins, themes, sources, configs, and layout data before applying |
+| **Restore options** | Install missing plugins/themes, merge plugin config, restore enabled state, apply layout, merge sources, and import themes |
-1. 
-2. 
+### 🎛️ Ribbon Order
-| Feature | Description |
-|---------|-------------|
-| **Show/Hide Ribbon Icons** | Customize the visibility of each icon on the ribbon bar |
-| **Customize Ribbon Order** | Customize the order of each icon on the ribbon bar by dragging |
+The Ribbon Order tab keeps Obsidian's left ribbon predictable, especially when delayed plugins register icons after startup.
-### 📱 Mobile Adaptation
-| Feature | Description |
-|---------|-------------|
-| **Responsive Layout** | Auto-switch between mobile/desktop layouts |
-| **Collapsible Action Bar** | Save screen space |
-| **Long-press Tooltips** | Touch-friendly interaction |
+
+
+| Area | What it does |
+|------|--------------|
+| **Icon ordering** | Drag ribbon items into a stable order |
+| **Visibility control** | Show or hide individual ribbon icons |
+| **Native sync mode** | Manages ribbon layout in BPM data without relying on Obsidian workspace config |
+| **Reset action** | Show all ribbon items and sort them by name |
+| **Reload guidance** | Prompts for reload when hidden startup icons need Obsidian to refresh |
+
+### 🔍 Conflict Diagnosis
+
+The Conflict Diagnosis tab guides plugin conflict testing step by step, keeping the tested state and result in one place.
+
+
+
+| Area | What it does |
+|------|--------------|
+| **Pre-check** | Confirms whether the issue still appears when other plugins are disabled |
+| **Binary narrowing** | Uses guided split testing to reduce the suspect plugin set |
+| **Conflict pair search** | Helps locate two-plugin conflicts, including cross-group cases |
+| **Manual feedback loop** | Asks you to test each step and mark whether the problem still exists |
+| **State controls** | Undo the previous step, restart Obsidian, exit troubleshooting, restore the original state, or keep the current state |
+| **Result report** | Generates a Markdown conflict report with the detected plugins and suggested next actions |
---
## 📦 Installation
-### Method 1: Official Marketplace (Recommended)
-1. Open Obsidian Settings → Community Plugins
-2. Search for "Better Plugins Manager"
-3. Click Install and Enable
+### Community Plugins
-### Method 2: Manual Installation
-1. Download the [latest Release](https://github.com/zenozero-dev/obsidian-manager/releases)
-2. Extract to `.obsidian/plugins/better-plugins-manager/`
-3. Restart Obsidian and enable
+Recommended for most users.
+
+1. Open **Obsidian Settings → Community Plugins**.
+2. Search for **Better Plugins Manager**.
+3. Install and enable the plugin.
+
+### Manual Install
+
+Use this when you want to install a GitHub release directly.
+
+1. Download the [latest release](https://github.com/zenozero-dev/obsidian-manager/releases).
+2. Copy `main.js`, `manifest.json`, and `styles.css` into `.obsidian/plugins/better-plugins-manager/`.
+3. Restart Obsidian.
+4. Enable **Better Plugins Manager** from **Settings → Community Plugins**.
---
## 🚦 Quick Start
-### Open the Manager
+### Open BPM
-- Click the 📁 icon in the sidebar
-- Or use Command Palette: `Ctrl/Cmd + P` → "Open Plugin Manager"
+After enabling the plugin, open BPM in either way:
-The panel is divided into three areas, from top to bottom:
+- Click the BPM icon in the left ribbon.
+- Run **Open the plugin manager** from the command palette.
-1. Action Button Area
-2. Filter & Search Area
-3. Plugin List Area
+### First Steps
-### Usage Tips
-- **Left-click** to interact with elements, hover over buttons to see tooltips
-- **Right-click** to open context menu
+1. Start in **Plugin View** to review installed plugins, filters, groups, tags, and delay settings.
+2. Use **Install Hub** when installing plugins or themes from GitHub.
+3. Use **Transfer Pack** when moving a plugin setup between vaults.
+4. Use **Conflict Diagnosis** when a plugin issue needs guided isolation.
+
+### Interaction Tips
+
+- **Left-click** primary controls to toggle, edit, install, import, or run an action.
+- **Right-click** a plugin item to open its context menu.
+- **Hover** toolbar buttons to see tooltips; on touch devices, use long press where supported.
---
-## 🔍 Plugin Conflict Troubleshooter
+## 🔍 Conflict Diagnosis Tutorial
-When encountering issues caused by plugin conflicts, use the Conflict Troubleshooter wizard:
+Use **Conflict Diagnosis** when a problem appears after enabling community plugins and you need a structured way to narrow down the cause.
-### How to Use
-1. Click the 🔍 button on the toolbar or use command "Troubleshoot plugin conflicts"
-2. Follow the wizard prompts
-3. Test if the problem exists at each step, click the corresponding button
-4. Automatically locate the problematic plugin or conflict pair
+### Workflow
-### Supported Scenarios
-- **Single Plugin Issue**: A plugin itself has a bug
-- **Two-Plugin Conflict**: Two plugins work fine separately but conflict when used together
+1. Open the **Conflict Diagnosis** tab, or run **Troubleshoot plugin conflicts** from the command palette.
+2. Start a diagnosis session. BPM records the current plugin state before changing anything.
+3. Test your vault after each step, then choose **Problem Still Exists** or **Problem Gone**.
+4. Continue through the guided split tests until BPM narrows the result to a plugin or plugin pair.
+5. Review the result, restore the original plugin state or keep the current state, then generate a Markdown report if needed.
-### Tips
-- The floating window is draggable for convenient testing
-- Supports undo last step
-- Troubleshooting state is saved, can continue after restart
+### Notes
+
+- Diagnosis depends on your feedback at each step; use the same test action every time.
+- Intermittent bugs, load-order issues, configuration-specific bugs, or conflicts involving three or more plugins may still need manual verification.
+- You can undo the previous step, restart Obsidian during testing, exit the session, restore the original state, or keep the current state.
---
-## ⚙️ Startup Self-Check
+## 🛡️ Startup Takeover
-BPM checks `community-plugins.json` on startup:
+When **Delayed Startup** is enabled, BPM checks `.obsidian/community-plugins.json` to make sure Obsidian and BPM are not trying to control the same plugins at startup.
-| Situation | Action |
-|-----------|--------|
-| Only BPM | Normal startup |
-| Other plugins present | Prompt to take over |
+| Case | BPM behavior |
+|------|--------------|
+| No unmanaged plugins | Starts normally |
+| Unmanaged plugins detected | Shows a takeover prompt |
+| Auto Takeover enabled | Moves detected plugins under BPM management automatically |
+| Plugin marked `bpm-ignore` | Leaves it in Obsidian's native startup list |
-### Why Takeover?
-- Avoid Obsidian and BPM controlling plugins simultaneously
-- Ensure delay-start and other features work properly
-- Maintain plugin state consistency
+Taking over keeps delayed startup, enabled state, and BPM's plugin records consistent. After a successful takeover, restart Obsidian so the startup list is applied cleanly.
---
-## 📤 Export to Obsidian Base
+## 📦 Transfer & Legacy Export
-### Configuration
-Set **Plugin info export directory** in settings (folder inside your vault)
+For current versions, use the **Transfer Pack** tab to move setups between vaults. It exports and imports plugin lists, themes, selected plugin configs, groups, tags, delay presets, layout data, ribbon order, source subscriptions, install history, and workspace preferences.
-### Rules
-| Prefix | Permission |
-|--------|------------|
-| `bpm_rw_*` | Read-write |
-| `bpm_ro_*` | Read-only |
-| `bpm_rwc_repo` | Conditionally writable |
-
-### Frontmatter Example
-
-```yaml
----
-bpm_ro_id: some-plugin
-bpm_rw_name: Custom Name
-bpm_rw_desc: Custom Description
-bpm_rw_note: Note
-bpm_rw_enabled: true
-bpm_rwc_repo: user/repo
-bpm_ro_group: group-id
-bpm_ro_tags:
- - tag-a
- - bpm-install
-bpm_ro_delay: delay-id
-bpm_ro_installed_via_bpm: true
----
-
-Body section: You can edit or replace this content.
-```
+The older Markdown/frontmatter export for Obsidian Base is kept only for legacy data compatibility. New setups should use **Transfer Pack** instead of configuring a Base export folder.
---
## ⚙️ Settings
-| Setting | Description |
-|---------|-------------|
-| Delay Profiles | Create delay configurations and assign to plugins |
-| Hide BPM Tag | Keep auto-tag but hide from UI |
-| GitHub API Token | Increase rate limits for release fetching |
-| Fade Disabled Plugins | Visually dim disabled plugin cards |
-| Export Notice Text | Customize the body text of exported files |
-| Self-Check Reminder | Control whether startup self-check popup shows |
+BPM settings are split into focused pages:
+
+| Page | What you can configure |
+|------|------------------------|
+| **Basic** | Language, persistent filters, delayed startup, auto takeover, startup update checks, source update checks, source auto-update, BPM tag visibility, ribbon order, commands, debug mode, and GitHub token |
+| **Main Page Actions** | Choose which plugin actions appear directly on plugin cards and which stay in the right-click menu |
+| **Style** | Plugin list layout, item display style, group/tag styles, and disabled-plugin fading |
+| **Groups** | Create, rename, recolor, and delete plugin groups |
+| **Tags** | Create, rename, recolor, and delete plugin tags |
+| **Delay** | Create and maintain delayed-start profiles; shown only when delayed startup is enabled |
---
## ⌨️ Commands
-| Command | Description |
-|---------|-------------|
-| Open Plugin Manager | Open BPM main interface |
-| Troubleshoot plugin conflicts | 🆕 Start conflict troubleshooter wizard |
-| Enable/Disable [Plugin Name] | Per-plugin toggle (enable in settings) |
-| Enable/Disable [Group Name] | Group batch operations (enable in settings) |
+| Command | Availability | Description |
+|---------|--------------|-------------|
+| **Open the plugin manager** | Always available | Opens the BPM main interface |
+| **Troubleshoot plugin conflicts** | Always available | Starts the conflict diagnosis workflow |
+| **Enable/Disable [Plugin Name]** | Optional setting | Registers one command per plugin for direct toggling |
+| **One-click Enable/Disable [Group Name]** | Optional setting | Registers group-level commands for batch toggling |
---
diff --git a/docs/README_CN.md b/docs/README_CN.md
index 18c7e18..b9b1960 100644
--- a/docs/README_CN.md
+++ b/docs/README_CN.md
@@ -1,219 +1,273 @@
+
+
+
---
## 🎯 BPM 是什么？
-**Better Plugins Manager** 是一款功能强大的 Obsidian 插件管理器，提供比原生更丰富的管理体验。
+**Better Plugins Manager (BPM)** 是 Obsidian 社区插件的控制中心，适合依赖大量插件、需要比简单启用/禁用更完整管理能力的库。
-> 延迟启动 • 批量操作 • 分组标签 • GitHub 安装 • 冲突排查 • 移动友好
+它可以帮助你保持启动响应速度，按工作流整理插件，从 GitHub Release 安装插件，并在出现问题时定位冲突来源。
+
+| 🚀 启动 | 📦 管理 | 🏷️ 整理 | 📥 安装 | 🔍 诊断 |
+|--------|--------|----------|---------|---------|
+| 插件延迟启动和启动自检 | 批量启用/禁用、快速搜索和状态筛选 | 分组、标签、备注、描述和自定义名称 | 从 GitHub 仓库和 Release 安装 | 引导式冲突排查和报告生成 |
---
## ✨ 核心功能
-### 🚀 延迟其他插件启动以优化Obsidian启动速度
+BPM 围绕五个清晰的 tab 组织。每个 tab 负责一个工作流，让相关控制集中在一起，桌面端和移动端都更容易浏览。
-此功能需要在设置中打开，默认关闭
-
+| Tab | 工作流 |
+|-----|--------|
+| 🧩 Plugin View | 管理已安装插件、插件信息、筛选、启动行为和单插件操作 |
+| 📥 Install Hub | 从 GitHub 安装插件或主题，并管理已跟踪来源 |
+| 📦 Transfer Pack | 在不同库之间导出、导入和恢复插件/主题包 |
+| 🎛️ Ribbon Order | 控制 Obsidian 左侧 Ribbon 图标的顺序和显隐 |
+| 🔍 Conflict Diagnosis | 定位插件问题并生成排查报告 |
-| 功能 | 说明 |
+### 🧩 Plugin View
+
+日常插件管理的主页面。
+
+
+
+| 区域 | 功能 |
|------|------|
-| **延迟启动** | 按预设延迟启动插件，缓解启动卡顿 |
+| **插件列表** | 以紧凑、可搜索的管理视图浏览已安装社区插件 |
+| **批量操作** | 批量启用或禁用插件，包括按分组处理 |
+| **筛选** | 按启用状态、分组、标签、延迟设置和关键词筛选 |
+| **整理信息** | 添加自定义名称、描述、备注、分组和标签 |
+| **启动控制** | 分配延迟启动预设，并在列表中查看启动状态 |
+| **插件操作** | 检查更新、下载更新、重启插件、单次启动、打开设置、打开目录、复制 ID、打开仓库、清空配置、隐藏或删除 |
+| **BPM 标签** | BPM 安装的插件会自动标记 `bpm-install`，也支持通过 `bpm-ignore` 忽略管理 |
+### 📥 Install Hub
-### 📦 批量管理
-| 功能 | 说明 |
+Install Hub 负责从 GitHub 安装插件/主题，并管理安装后可跟踪的来源。
+
+
+
+| 区域 | 功能 |
|------|------|
-| **一键全开/全关** | 快速切换所有插件状态 |
-| **分组操作** | 按分组批量启用/禁用 |
-| **快速搜索** | 按状态、分组、标签、延迟、关键字筛选 |
+| **安装类型** | 在插件和主题安装之间切换 |
+| **仓库输入** | 支持 `user/repo` 或完整 GitHub 仓库 URL |
+| **版本选择** | 获取 GitHub Release，可安装最新版或指定版本 |
+| **更新说明** | 可用时在安装前显示 Release 信息 |
+| **最近安装** | 保存最近使用的仓库，便于重复安装 |
+| **来源跟踪** | 可选择跟踪已安装仓库，用于后续检查更新、更新和重装 |
+| **来源管理** | 查看已跟踪的插件/主题来源、更新目标、重装项目，并保持来源元数据最新 |
-### 🏷️ 整理与标注
-| 功能 | 说明 |
+### 📦 Transfer Pack
+
+Transfer Pack 用于在不同 Obsidian 库之间迁移插件配置，不需要手动整理清单。
+
+
+
+| 区域 | 功能 |
|------|------|
-| **自定义名称** | 给插件起个好记的名字 |
-| **备注描述** | 记录插件用途和配置说明 |
-| **分组标签** | 灵活分类，BPM 安装自动打 `bpm-install` 标签 |
+| **导出列表** | 选择本地插件和主题，生成 JSON 迁移包 |
+| **插件配置** | 按需导出选中的插件配置文件 |
+| **分类数据** | 导出 BPM 分组、标签和延迟预设 |
+| **布局数据** | 导出管理器排序、隐藏项目和 Ribbon 布局 |
+| **来源数据** | 导出 GitHub 仓库映射、来源订阅和安装历史 |
+| **工作区偏好** | 导出样式、延迟模式、标签显示和启动检查偏好 |
+| **导入预览** | 导入前预览包内插件、主题、来源、配置和布局数据 |
+| **恢复选项** | 安装缺失插件/主题、合并插件配置、恢复启用状态、应用布局、合并来源和导入主题 |
-### 📥 从 GitHub 安装未上架插件
+### 🎛️ Ribbon Order
-1. 
-2. 
+Ribbon Order 保持 Obsidian 左侧 Ribbon 顺序稳定，尤其适合延迟启动插件在启动后才注册图标的情况。
-| 功能 | 说明 |
+
+
+| 区域 | 功能 |
|------|------|
-| **仓库安装** | 支持 `user/repo` 或完整 URL |
-| **版本选择** | 像 BRAT 一样选择发行版 |
-| **仓库跳转** | 插件卡片一键跳转 GitHub |
+| **图标排序** | 拖动 Ribbon 项目并固定顺序 |
+| **显隐控制** | 显示或隐藏单个 Ribbon 图标 |
+| **原生同步模式** | 将 Ribbon 布局保存在 BPM 数据中，不依赖 Obsidian workspace 配置 |
+| **重置操作** | 显示所有 Ribbon 项目并按名称排序 |
+| **重载提示** | 当启动时隐藏的图标需要 Obsidian 刷新时给出提示 |
-### 🔍 冲突排查 🆕
+### 🔍 Conflict Diagnosis
-
+Conflict Diagnosis 通过步骤引导插件冲突测试，并把测试状态和结果保存在一个页面中。
-| 功能 | 说明 |
+
+
+| 区域 | 功能 |
|------|------|
-| **二分法定位** | 快速定位问题插件或冲突对 |
-| **向导式操作** | 可拖动悬浮窗，边操作边测试 |
-| **生成报告** | 输出 Markdown 格式排查报告 |
-
-### ↕ 自定义ribbon栏 🆕
-
-如果你曾经因为bpm延迟启动插件而烦恼ribbon图标每次启动后顺序都会变化，请使用这个功能
-
-1. 
-2. 
-
-| 功能 | 说明 |
-|------|------|
-| **显示隐藏ribbon** | 自定义 ribbon 栏每个图标的显示/隐藏 |
-| **自定义ribbon排序** | 通过拖动自定义 ribbon 栏每个图标的排序 |
-
-### 📱 移动端适配
-| 功能 | 说明 |
-|------|------|
-| **响应式布局** | 自动切换移动/桌面布局 |
-| **可折叠操作栏** | 节省屏幕空间 |
-| **长按提示** | 触摸友好的交互体验 |
+| **预检查** | 确认禁用其他插件后问题是否仍然存在 |
+| **二分缩小范围** | 通过分组测试缩小嫌疑插件范围 |
+| **冲突对查找** | 帮助定位两个插件之间的冲突，包括跨分组情况 |
+| **人工反馈循环** | 每一步测试后由你确认问题是否仍然存在 |
+| **状态控制** | 撤销上一步、重启 Obsidian、退出排查、恢复原始状态或保留当前状态 |
+| **结果报告** | 生成包含检测结果和建议操作的 Markdown 冲突报告 |
---
-## 📦 安装方式
+## 📦 安装
-### 方式一：官方市场（推荐）
-1. 打开 Obsidian 设置 → 第三方插件
-2. 搜索 "Better Plugins Manager"
-3. 点击安装并启用
+### 社区插件市场
-### 方式二：手动安装
-1. 下载 [最新 Release](https://github.com/zenozero-dev/obsidian-manager/releases)
-2. 解压到 `.obsidian/plugins/better-plugins-manager/`
-3. 重启 Obsidian 并启用
+推荐大多数用户使用。
+
+1. 打开 **Obsidian 设置 → 第三方插件**。
+2. 搜索 **Better Plugins Manager**。
+3. 安装并启用插件。
+
+### 手动安装
+
+适合直接安装 GitHub Release。
+
+1. 下载 [latest release](https://github.com/zenozero-dev/obsidian-manager/releases)。
+2. 将 `main.js`、`manifest.json` 和 `styles.css` 复制到 `.obsidian/plugins/better-plugins-manager/`。
+3. 重启 Obsidian。
+4. 在 **设置 → 第三方插件** 中启用 **Better Plugins Manager**。
---
## 🚦 快速开始
-### 打开管理器
+### 打开 BPM
-- 点击侧边栏 📁 图标
-- 或使用命令面板：`Ctrl/Cmd + P` → "打开插件管理面板"
+启用插件后，可以通过以下方式打开 BPM：
-面板分为三个区域，从上到下依次为：
+- 点击左侧 Ribbon 中的 BPM 图标。
+- 在命令面板中运行 **Open the plugin manager**。
-1. 操作按钮区
-2. 筛选搜索区
-3. 插件列表区
+### 首次使用建议
-### 操作说明
-- **左键** 与元素互动，光标悬停在按钮上时会显示提示
-- **右键** 打开二级菜单
+1. 从 **Plugin View** 开始，查看已安装插件、筛选、分组、标签和延迟设置。
+2. 安装 GitHub 插件或主题时使用 **Install Hub**。
+3. 在不同库之间迁移插件配置时使用 **Transfer Pack**。
+4. 需要定位插件问题时使用 **Conflict Diagnosis**。
+
+### 交互提示
+
+- **左键** 点击主要控件进行切换、编辑、安装、导入或执行操作。
+- **右键** 插件项目打开上下文菜单。
+- **悬停** 工具栏按钮查看提示；触屏设备可使用长按提示。
---
-## 🔍 插件冲突排查
+## 🔍 冲突诊断教程
-当遇到插件冲突导致的问题时，使用冲突排查向导：
+当启用社区插件后出现问题，并且需要结构化缩小原因范围时，使用 **Conflict Diagnosis**。
-### 使用方法
-1. 点击工具栏 🔍 按钮或使用命令 "排查插件冲突"
-2. 按照向导提示操作
-3. 每步测试问题是否存在，点击对应按钮
-4. 自动定位到问题插件或冲突对
+### 流程
-### 支持的场景
-- **单插件问题**：某个插件自身有 bug
-- **双插件冲突**：两个插件单独没问题，一起用才冲突
+1. 打开 **Conflict Diagnosis** tab，或从命令面板运行 **Troubleshoot plugin conflicts**。
+2. 开始诊断会话。BPM 会先记录当前插件状态。
+3. 每一步测试你的库，然后选择 **Problem Still Exists** 或 **Problem Gone**。
+4. 继续引导式分组测试，直到 BPM 将结果缩小到某个插件或插件组合。
+5. 查看结果，恢复原始插件状态或保留当前状态，必要时生成 Markdown 报告。
-### 操作提示
-- 悬浮窗可拖动，方便边测试边操作
-- 支持撤销上一步
-- 排查状态会保存，重启后可继续
+### 注意
+
+- 诊断依赖你在每一步的反馈；每次请使用同样的测试动作。
+- 间歇性问题、加载顺序问题、配置相关问题或三插件以上链式冲突仍可能需要人工确认。
+- 排查过程中可以撤销上一步、重启 Obsidian、退出会话、恢复原始状态或保留当前状态。
---
-## ⚙️ 启动自检
+## 🛡️ 启动接管
-BPM 启动时会检测 `community-plugins.json`：
+启用 **Delayed Startup** 后，BPM 会检查 `.obsidian/community-plugins.json`，确保 Obsidian 和 BPM 不会同时控制同一批插件的启动状态。
-| 情况 | 处理 |
-|------|------|
-| 只有 BPM | 正常启动 |
-| 有其他插件 | 弹窗提示接管 |
+| 情况 | BPM 行为 |
+|------|----------|
+| 没有未接管插件 | 正常启动 |
+| 检测到未接管插件 | 显示接管提示 |
+| 启用 Auto Takeover | 自动将检测到的插件纳入 BPM 管理 |
+| 插件标记为 `bpm-ignore` | 保留在 Obsidian 原生启动列表中 |
-### 为什么需要接管？
-- 避免 Obsidian 和 BPM 同时控制插件
-- 确保延迟启动等功能正常工作
-- 保持插件状态一致性
+接管可以保持延迟启动、启用状态和 BPM 插件记录一致。接管成功后，请重启 Obsidian 让启动列表干净生效。
---
-## 📤 导出到 Obsidian Base
+## 📦 迁移与旧版导出
-### 配置
-在设置中填写 **插件信息导出目录**（库内文件夹）
+当前版本建议使用 **Transfer Pack** 在不同库之间迁移配置。它可以导出和导入插件列表、主题、选中的插件配置、分组、标签、延迟预设、布局数据、Ribbon 顺序、来源订阅、安装历史和工作区偏好。
-### 规则
-| 前缀 | 权限 |
-|------|------|
-| `bpm_rw_*` | 可读写 |
-| `bpm_ro_*` | 只读 |
-| `bpm_rwc_repo` | 条件可写 |
-
-### Frontmatter 示例
-
-```yaml
----
-bpm_ro_id: some-plugin
-bpm_rw_name: 自定义名
-bpm_rw_desc: 自定义描述
-bpm_rw_note: 备注
-bpm_rw_enabled: true
-bpm_rwc_repo: user/repo
-bpm_ro_group: group-id
-bpm_ro_tags:
- - tag-a
- - bpm-install
-bpm_ro_delay: delay-id
-bpm_ro_installed_via_bpm: true
----
-
-正文区：这里的内容可自行编辑或替换。
-```
+旧版 Markdown/frontmatter 的 Obsidian Base 导出仅保留用于兼容旧数据。新配置建议使用 **Transfer Pack**，不要再配置 Base 导出目录。
---
-## ⚙️ 设置说明
+## ⚙️ 设置
-| 设置项 | 说明 |
-|--------|------|
-| 延迟预设 | 创建延迟配置并分配给插件 |
-| 隐藏 BPM 标签 | 保留自动标签但在界面中隐藏 |
-| GitHub API Token | 提升发行版拉取的速率上限 |
-| 淡化未启用插件 | 未启用的卡片视觉弱化 |
-| 导出提示文案 | 自定义导出文件的正文提示 |
-| 自检提醒 | 控制启动自检弹窗是否显示 |
+BPM 设置按功能拆分为多个页面：
+
+| 页面 | 可配置内容 |
+|------|------------|
+| **Basic** | 语言、筛选持久化、延迟启动、自动接管、启动检查更新、来源检查更新、来源自动更新、BPM 标签显示、Ribbon 编排、命令、调试模式和 GitHub Token |
+| **Main Page Actions** | 选择哪些插件操作直接显示在插件卡片上，哪些收纳到右键菜单 |
+| **Style** | 插件列表布局、项目显示样式、分组/标签样式和禁用插件淡化 |
+| **Groups** | 创建、重命名、重新着色和删除插件分组 |
+| **Tags** | 创建、重命名、重新着色和删除插件标签 |
+| **Delay** | 创建和维护延迟启动配置；仅在启用延迟启动时显示 |
---
-## ⌨️ 命令列表
+## ⌨️ 命令
-| 命令 | 说明 |
-|------|------|
-| 打开插件管理面板 | 打开 BPM 主界面 |
-| 排查插件冲突 | 🆕 启动冲突排查向导 |
-| 启用/禁用 [插件名] | 单插件开关（需在设置中启用） |
-| 启用/禁用 [分组名] | 分组批量操作（需在设置中启用） |
+| 命令 | 可用性 | 说明 |
+|------|--------|------|
+| **Open the plugin manager** | 始终可用 | 打开 BPM 主界面 |
+| **Troubleshoot plugin conflicts** | 始终可用 | 启动冲突诊断流程 |
+| **Enable/Disable [Plugin Name]** | 可选设置 | 为每个插件注册独立启用/禁用命令 |
+| **One-click Enable/Disable [Group Name]** | 可选设置 | 为分组注册批量切换命令 |
---
@@ -225,23 +279,23 @@ bpm_ro_installed_via_bpm: true
| Android | ✅ |
| iOS / iPadOS | ✅ |
-插件会自动按平台切换桌面/移动布局。
+插件会根据平台自动切换桌面/移动端布局。
---
-## 🤝 参与贡献
+## 🤝 贡献
-欢迎提交 Issue 和 PR！
+欢迎提交 Issue 和 PR。
-- **Bug 反馈**：请附日志和复现步骤
-- **功能建议**：可先开讨论或 Issue
+- **Bug 报告**：请包含日志和复现步骤。
+- **功能建议**：建议先创建 discussion 或 issue。
## 🙏 致谢
-- ribbon排序功能参考了 [Obsidian-ribbon-sort](https://github.com/zenozero-dev/obsidian-ribbon-sort)
+- Ribbon 排序功能受到 [Obsidian-ribbon-sort](https://github.com/yunrr/Obsidian-app-ribbon-sorting) 启发。
---
-## 📄 许可
+## 📄 License
[MIT](../LICENSE)
diff --git a/docs/README_ES.md b/docs/README_ES.md
new file mode 100644
index 0000000..086f8b9
--- /dev/null
+++ b/docs/README_ES.md
@@ -0,0 +1,301 @@
+
+
+
+
+---
+
+## 🎯 ¿Qué es BPM?
+
+**Better Plugins Manager (BPM)** es un centro de control para los plugins comunitarios de Obsidian, diseñado para vaults que dependen de muchos plugins y necesitan más que simples interruptores de activar/desactivar.
+
+Ayuda a mantener el inicio ágil, organizar plugins por flujo de trabajo, instalar desde GitHub Releases y aislar conflictos cuando algo falla.
+
+| 🚀 Inicio | 📦 Gestión | 🏷️ Organización | 📥 Instalación | 🔍 Diagnóstico |
+|----------|------------|------------------|----------------|----------------|
+| Inicio diferido y autocomprobaciones | Activación/desactivación por lotes, búsqueda rápida y filtros de estado | Grupos, etiquetas, notas, descripciones y nombres personalizados | Instalación desde repositorios y versiones de GitHub | Diagnóstico guiado de conflictos con informes |
+
+---
+
+## ✨ Funciones principales
+
+BPM se organiza en cinco pestañas enfocadas. Cada pestaña cubre un flujo de trabajo para que los controles relacionados permanezcan juntos y el gestor sea fácil de revisar en escritorio y móvil.
+
+| Pestaña | Flujo de trabajo |
+|---------|------------------|
+| 🧩 Plugin View | Gestionar plugins instalados, metadatos, filtros, comportamiento de inicio y acciones por plugin |
+| 📥 Install Hub | Instalar plugins o temas desde GitHub y gestionar fuentes rastreadas |
+| 📦 Transfer Pack | Exportar, importar y restaurar paquetes de plugins/temas entre vaults |
+| 🎛️ Ribbon Order | Controlar el orden y la visibilidad de iconos del ribbon de Obsidian |
+| 🔍 Conflict Diagnosis | Localizar problemas de plugins y generar informes de diagnóstico |
+
+### 🧩 Plugin View
+
+La pestaña principal para la gestión diaria de plugins.
+
+
+
+| Área | Qué hace |
+|------|----------|
+| **Lista de plugins** | Muestra los plugins comunitarios instalados en una vista compacta y buscable |
+| **Acciones por lotes** | Activa o desactiva plugins en masa, incluidos flujos por grupos |
+| **Filtros** | Filtra por estado, grupo, etiqueta, configuración de retraso o palabra clave |
+| **Organización** | Añade nombres personalizados, descripciones, notas, grupos y etiquetas |
+| **Control de inicio** | Asigna perfiles de inicio diferido y muestra su estado en la lista |
+| **Acciones de plugin** | Buscar actualizaciones, descargar actualizaciones, reiniciar, iniciar temporalmente, abrir ajustes, abrir carpetas, copiar IDs, abrir repositorios, limpiar configuración, ocultar o eliminar |
+| **Etiquetas BPM** | Marca automáticamente los plugins instalados con BPM como `bpm-install` y admite exclusión con `bpm-ignore` |
+
+### 📥 Install Hub
+
+Install Hub gestiona la instalación desde GitHub y las fuentes que BPM puede rastrear después.
+
+
+
+| Área | Qué hace |
+|------|----------|
+| **Tipo de instalación** | Cambia entre instalación de plugin y tema |
+| **Entrada de repositorio** | Acepta `user/repo` o URLs completas de GitHub |
+| **Selección de release** | Obtiene releases de GitHub e instala la última versión o una versión elegida |
+| **Notas de release** | Muestra información de la release antes de instalar cuando está disponible |
+| **Instalaciones recientes** | Guarda repositorios usados recientemente para repetir instalaciones con rapidez |
+| **Seguimiento de fuentes** | Puede rastrear repositorios instalados para comprobaciones, actualizaciones y reinstalaciones posteriores |
+| **Gestión de fuentes** | Revisa fuentes rastreadas de plugins/temas, objetivos de actualización, reinstalaciones y metadatos |
+
+### 📦 Transfer Pack
+
+Transfer Pack mueve configuraciones de plugins entre vaults sin convertirlo en una lista manual de pasos.
+
+
+
+| Área | Qué hace |
+|------|----------|
+| **Lista de exportación** | Selecciona plugins y temas locales para incluirlos en un paquete JSON |
+| **Configs de plugins** | Exporta archivos de configuración seleccionados cuando sea necesario |
+| **Taxonomía** | Exporta grupos, etiquetas y perfiles de retraso de BPM |
+| **Datos de diseño** | Exporta orden del gestor, elementos ocultos y layout del ribbon |
+| **Fuentes** | Exporta mapas de repositorios GitHub, suscripciones de fuentes e historial de instalación |
+| **Preferencias** | Exporta estilo, modo de retraso, visualización de etiquetas y preferencias de comprobación al inicio |
+| **Vista previa** | Carga un paquete y revisa plugins, temas, fuentes, configs y layout antes de aplicar |
+| **Opciones de restauración** | Instala plugins/temas faltantes, fusiona configs, restaura estado activado, aplica layout, fusiona fuentes e importa temas |
+
+### 🎛️ Ribbon Order
+
+Ribbon Order mantiene predecible el ribbon izquierdo de Obsidian, especialmente cuando plugins con inicio diferido registran iconos después del arranque.
+
+
+
+| Área | Qué hace |
+|------|----------|
+| **Orden de iconos** | Arrastra elementos del ribbon a un orden estable |
+| **Visibilidad** | Muestra u oculta iconos individuales |
+| **Native sync mode** | Guarda el layout del ribbon en datos de BPM, sin depender de la configuración workspace de Obsidian |
+| **Restablecer** | Muestra todos los elementos y los ordena por nombre |
+| **Aviso de recarga** | Indica cuándo Obsidian debe recargarse para mostrar iconos ocultos al inicio |
+
+### 🔍 Conflict Diagnosis
+
+Conflict Diagnosis guía pruebas de conflicto paso a paso y mantiene el estado y el resultado en un solo lugar.
+
+
+
+| Área | Qué hace |
+|------|----------|
+| **Precomprobación** | Confirma si el problema persiste al desactivar otros plugins |
+| **Reducción binaria** | Usa pruebas divididas para reducir el conjunto sospechoso |
+| **Búsqueda de pares** | Ayuda a encontrar conflictos entre dos plugins, incluso entre grupos |
+| **Retroalimentación manual** | Te pide comprobar cada paso e indicar si el problema continúa |
+| **Controles de estado** | Deshacer el paso anterior, reiniciar Obsidian, salir, restaurar estado original o conservar el actual |
+| **Informe** | Genera un informe Markdown con los plugins detectados y acciones sugeridas |
+
+---
+
+## 📦 Instalación
+
+### Community Plugins
+
+Recomendado para la mayoría de usuarios.
+
+1. Abre **Obsidian Settings → Community Plugins**.
+2. Busca **Better Plugins Manager**.
+3. Instala y activa el plugin.
+
+### Instalación manual
+
+Úsala para instalar directamente una release de GitHub.
+
+1. Descarga la [latest release](https://github.com/zenozero-dev/obsidian-manager/releases).
+2. Copia `main.js`, `manifest.json` y `styles.css` en `.obsidian/plugins/better-plugins-manager/`.
+3. Reinicia Obsidian.
+4. Activa **Better Plugins Manager** desde **Settings → Community Plugins**.
+
+---
+
+## 🚦 Inicio rápido
+
+### Abrir BPM
+
+Después de activar el plugin, abre BPM de una de estas formas:
+
+- Haz clic en el icono de BPM en el ribbon izquierdo.
+- Ejecuta **Open the plugin manager** desde la paleta de comandos.
+
+### Primeros pasos
+
+1. Empieza en **Plugin View** para revisar plugins instalados, filtros, grupos, etiquetas y retrasos.
+2. Usa **Install Hub** para instalar plugins o temas desde GitHub.
+3. Usa **Transfer Pack** para mover una configuración entre vaults.
+4. Usa **Conflict Diagnosis** cuando necesites aislar un problema de plugins.
+
+### Consejos de interacción
+
+- **Clic izquierdo** en controles principales para alternar, editar, instalar, importar o ejecutar acciones.
+- **Clic derecho** en un plugin para abrir su menú contextual.
+- **Pasa el cursor** sobre botones de la barra para ver tooltips; en dispositivos táctiles usa pulsación larga cuando esté disponible.
+
+---
+
+## 🔍 Tutorial de Conflict Diagnosis
+
+Usa **Conflict Diagnosis** cuando aparece un problema tras activar plugins comunitarios y necesitas reducir la causa de forma estructurada.
+
+### Flujo
+
+1. Abre la pestaña **Conflict Diagnosis** o ejecuta **Troubleshoot plugin conflicts** desde la paleta de comandos.
+2. Inicia una sesión. BPM registra el estado actual de los plugins antes de cambiar nada.
+3. Prueba tu vault después de cada paso y elige **Problem Still Exists** o **Problem Gone**.
+4. Continúa las pruebas guiadas hasta que BPM reduzca el resultado a un plugin o par de plugins.
+5. Revisa el resultado, restaura el estado original o conserva el actual, y genera un informe Markdown si lo necesitas.
+
+### Notas
+
+- El diagnóstico depende de tu respuesta en cada paso; usa siempre la misma acción de prueba.
+- Errores intermitentes, problemas de orden de carga, bugs dependientes de configuración o conflictos de tres o más plugins pueden requerir verificación manual.
+- Puedes deshacer el paso anterior, reiniciar Obsidian durante la prueba, salir, restaurar el estado original o conservar el estado actual.
+
+---
+
+## 🛡️ Toma de control al inicio
+
+Cuando **Delayed Startup** está activado, BPM revisa `.obsidian/community-plugins.json` para evitar que Obsidian y BPM controlen los mismos plugins al inicio.
+
+| Caso | Comportamiento de BPM |
+|------|-----------------------|
+| Sin plugins no gestionados | Inicio normal |
+| Plugins no gestionados detectados | Muestra un aviso de toma de control |
+| Auto Takeover activado | Mueve automáticamente los plugins detectados a la gestión de BPM |
+| Plugin marcado `bpm-ignore` | Lo deja en la lista de inicio nativa de Obsidian |
+
+La toma de control mantiene coherentes el inicio diferido, el estado activado y los registros de BPM. Tras una toma exitosa, reinicia Obsidian para aplicar limpiamente la lista de inicio.
+
+---
+
+## 📦 Transfer y exportación legacy
+
+En versiones actuales, usa **Transfer Pack** para mover configuraciones entre vaults. Exporta e importa listas de plugins, temas, configs seleccionadas, grupos, etiquetas, perfiles de retraso, layout, orden del ribbon, fuentes, historial de instalación y preferencias del workspace.
+
+La exportación antigua Markdown/frontmatter para Obsidian Base se conserva solo por compatibilidad con datos legacy. Las configuraciones nuevas deberían usar **Transfer Pack** en lugar de una carpeta de exportación Base.
+
+---
+
+## ⚙️ Ajustes
+
+Los ajustes de BPM se dividen en páginas enfocadas:
+
+| Página | Qué puedes configurar |
+|--------|-----------------------|
+| **Basic** | Idioma, persistencia de filtros, inicio diferido, auto takeover, comprobaciones al inicio, comprobaciones de fuentes, auto-update de fuentes, visibilidad de etiquetas BPM, orden del ribbon, comandos, modo debug y token de GitHub |
+| **Main Page Actions** | Qué acciones aparecen directamente en las tarjetas y cuáles quedan en el menú contextual |
+| **Style** | Layout de la lista, estilo de elementos, estilos de grupos/etiquetas y atenuación de plugins desactivados |
+| **Groups** | Crear, renombrar, recolorear y eliminar grupos |
+| **Tags** | Crear, renombrar, recolorear y eliminar etiquetas |
+| **Delay** | Crear y mantener perfiles de inicio diferido; solo aparece cuando está activado |
+
+---
+
+## ⌨️ Comandos
+
+| Comando | Disponibilidad | Descripción |
+|---------|----------------|-------------|
+| **Open the plugin manager** | Siempre disponible | Abre la interfaz principal de BPM |
+| **Troubleshoot plugin conflicts** | Siempre disponible | Inicia el flujo de diagnóstico de conflictos |
+| **Enable/Disable [Plugin Name]** | Ajuste opcional | Registra un comando por plugin para alternarlo directamente |
+| **One-click Enable/Disable [Group Name]** | Ajuste opcional | Registra comandos por grupo para alternar en lote |
+
+---
+
+## 📱 Compatibilidad
+
+| Plataforma | Soporte |
+|------------|---------|
+| Windows / macOS / Linux | ✅ |
+| Android | ✅ |
+| iOS / iPadOS | ✅ |
+
+El plugin cambia automáticamente entre layouts de escritorio y móvil según la plataforma.
+
+---
+
+## 🤝 Contribuir
+
+Los issues y PRs son bienvenidos.
+
+- **Reportes de bugs**: incluye logs y pasos de reproducción.
+- **Solicitudes de funciones**: considera abrir primero una discussion o issue.
+
+## 🙏 Agradecimientos
+
+- La función de orden del ribbon está inspirada en [Obsidian-ribbon-sort](https://github.com/yunrr/Obsidian-app-ribbon-sorting).
+
+---
+
+## 📄 License
+
+[MIT](../LICENSE)
diff --git a/docs/README_FR.md b/docs/README_FR.md
new file mode 100644
index 0000000..8a1460f
--- /dev/null
+++ b/docs/README_FR.md
@@ -0,0 +1,301 @@
+
+
+
+
+---
+
+## 🎯 Qu'est-ce que BPM ?
+
+**Better Plugins Manager (BPM)** est un centre de contrôle pour les plugins communautaires Obsidian, conçu pour les vaults qui reposent sur de nombreux plugins et demandent plus que de simples boutons activer/désactiver.
+
+Il aide à garder un démarrage réactif, organiser les plugins par flux de travail, installer depuis les GitHub Releases et isoler les conflits quand quelque chose casse.
+
+| 🚀 Démarrage | 📦 Gestion | 🏷️ Organisation | 📥 Installation | 🔍 Diagnostic |
+|-------------|------------|------------------|----------------|---------------|
+| Démarrage différé et auto-vérifications | Activation/désactivation en lot, recherche rapide et filtres d'état | Groupes, tags, notes, descriptions et noms personnalisés | Installation depuis dépôts et versions GitHub | Diagnostic guidé des conflits avec rapport |
+
+---
+
+## ✨ Fonctionnalités principales
+
+BPM est organisé autour de cinq onglets ciblés. Chaque onglet couvre un flux de travail, ce qui garde les contrôles liés au même endroit et rend le gestionnaire facile à parcourir sur bureau comme sur mobile.
+
+| Onglet | Flux de travail |
+|--------|-----------------|
+| 🧩 Plugin View | Gérer les plugins installés, métadonnées, filtres, comportement au démarrage et actions par plugin |
+| 📥 Install Hub | Installer des plugins ou thèmes depuis GitHub et gérer les sources suivies |
+| 📦 Transfer Pack | Exporter, importer et restaurer des packs de plugins/thèmes entre vaults |
+| 🎛️ Ribbon Order | Contrôler l'ordre et la visibilité des icônes du ribbon Obsidian |
+| 🔍 Conflict Diagnosis | Localiser les problèmes de plugins et générer des rapports |
+
+### 🧩 Plugin View
+
+L'onglet principal pour la gestion quotidienne des plugins.
+
+
+
+| Zone | Rôle |
+|------|------|
+| **Liste des plugins** | Parcourir les plugins communautaires installés dans une vue compacte et recherchable |
+| **Actions groupées** | Activer ou désactiver des plugins en masse, y compris par groupes |
+| **Filtres** | Filtrer par état, groupe, tag, réglage de délai ou mot-clé |
+| **Organisation** | Ajouter noms personnalisés, descriptions, notes, groupes et tags |
+| **Contrôle du démarrage** | Assigner des profils de démarrage différé et afficher leur état dans la liste |
+| **Actions plugin** | Vérifier les mises à jour, télécharger les mises à jour, redémarrer, démarrer temporairement, ouvrir les réglages, ouvrir les dossiers, copier les IDs, ouvrir les dépôts, vider la config, masquer ou supprimer |
+| **Tags BPM** | Marque automatiquement les plugins installés via BPM avec `bpm-install` et prend en charge l'exclusion via `bpm-ignore` |
+
+### 📥 Install Hub
+
+Install Hub gère l'installation depuis GitHub et les sources que BPM peut suivre après installation.
+
+
+
+| Zone | Rôle |
+|------|------|
+| **Type d'installation** | Basculer entre installation de plugin et de thème |
+| **Saisie du dépôt** | Accepte `user/repo` ou une URL GitHub complète |
+| **Choix de release** | Récupère les releases GitHub et installe la dernière ou une version choisie |
+| **Notes de release** | Affiche les informations de release avant installation quand elles existent |
+| **Installations récentes** | Garde les dépôts récents pour réinstaller plus vite |
+| **Suivi des sources** | Suit les dépôts installés pour les vérifications, mises à jour et réinstallations futures |
+| **Gestion des sources** | Examiner les sources plugin/thème suivies, cibles de mise à jour, réinstallations et métadonnées |
+
+### 📦 Transfer Pack
+
+Transfer Pack déplace des configurations de plugins entre vaults sans transformer le processus en checklist manuelle.
+
+
+
+| Zone | Rôle |
+|------|------|
+| **Liste d'export** | Sélectionner plugins et thèmes locaux à inclure dans un pack JSON |
+| **Configs plugin** | Exporter les fichiers de configuration sélectionnés si nécessaire |
+| **Taxonomie** | Exporter groupes, tags et profils de délai BPM |
+| **Données de layout** | Exporter ordre du gestionnaire, éléments masqués et layout du ribbon |
+| **Sources** | Exporter mappings de dépôts GitHub, abonnements source et historique d'installation |
+| **Préférences** | Exporter style, mode de délai, affichage des tags et vérifications au démarrage |
+| **Aperçu d'import** | Charger un pack et vérifier plugins, thèmes, sources, configs et layout avant application |
+| **Options de restauration** | Installer les plugins/thèmes manquants, fusionner les configs, restaurer l'état activé, appliquer le layout, fusionner les sources et importer les thèmes |
+
+### 🎛️ Ribbon Order
+
+Ribbon Order garde le ribbon gauche d'Obsidian prévisible, surtout quand les plugins à démarrage différé enregistrent leurs icônes après le démarrage.
+
+
+
+| Zone | Rôle |
+|------|------|
+| **Ordre des icônes** | Glisser les éléments du ribbon dans un ordre stable |
+| **Visibilité** | Afficher ou masquer chaque icône du ribbon |
+| **Native sync mode** | Gérer le layout du ribbon dans les données BPM sans dépendre de la config workspace Obsidian |
+| **Réinitialisation** | Afficher tous les éléments et les trier par nom |
+| **Indication de rechargement** | Signale quand Obsidian doit être rechargé pour afficher des icônes cachées au démarrage |
+
+### 🔍 Conflict Diagnosis
+
+Conflict Diagnosis guide les tests de conflit étape par étape et garde l'état testé et le résultat au même endroit.
+
+
+
+| Zone | Rôle |
+|------|------|
+| **Pré-vérification** | Confirme si le problème existe encore lorsque d'autres plugins sont désactivés |
+| **Réduction binaire** | Utilise des tests par division pour réduire l'ensemble suspect |
+| **Recherche de paire** | Aide à trouver les conflits entre deux plugins, y compris entre groupes |
+| **Retour manuel** | Vous demande de tester chaque étape et d'indiquer si le problème persiste |
+| **Contrôles d'état** | Annuler l'étape précédente, redémarrer Obsidian, quitter, restaurer l'état initial ou garder l'état actuel |
+| **Rapport** | Génère un rapport Markdown avec les plugins détectés et les actions suggérées |
+
+---
+
+## 📦 Installation
+
+### Community Plugins
+
+Recommandé pour la plupart des utilisateurs.
+
+1. Ouvrez **Obsidian Settings → Community Plugins**.
+2. Recherchez **Better Plugins Manager**.
+3. Installez et activez le plugin.
+
+### Installation manuelle
+
+À utiliser pour installer directement une release GitHub.
+
+1. Téléchargez la [latest release](https://github.com/zenozero-dev/obsidian-manager/releases).
+2. Copiez `main.js`, `manifest.json` et `styles.css` dans `.obsidian/plugins/better-plugins-manager/`.
+3. Redémarrez Obsidian.
+4. Activez **Better Plugins Manager** depuis **Settings → Community Plugins**.
+
+---
+
+## 🚦 Démarrage rapide
+
+### Ouvrir BPM
+
+Après activation du plugin, ouvrez BPM de l'une des deux façons :
+
+- Cliquez sur l'icône BPM dans le ribbon gauche.
+- Lancez **Open the plugin manager** depuis la palette de commandes.
+
+### Premiers pas
+
+1. Commencez dans **Plugin View** pour vérifier les plugins installés, filtres, groupes, tags et délais.
+2. Utilisez **Install Hub** pour installer des plugins ou thèmes depuis GitHub.
+3. Utilisez **Transfer Pack** pour déplacer une configuration entre vaults.
+4. Utilisez **Conflict Diagnosis** lorsqu'un problème de plugin doit être isolé.
+
+### Conseils d'interaction
+
+- **Clic gauche** sur les contrôles principaux pour basculer, modifier, installer, importer ou lancer une action.
+- **Clic droit** sur un plugin pour ouvrir son menu contextuel.
+- **Survolez** les boutons de la barre d'outils pour voir les tooltips ; sur tactile, utilisez l'appui long quand disponible.
+
+---
+
+## 🔍 Tutoriel Conflict Diagnosis
+
+Utilisez **Conflict Diagnosis** quand un problème apparaît après activation de plugins communautaires et que vous devez réduire la cause de façon structurée.
+
+### Flux
+
+1. Ouvrez l'onglet **Conflict Diagnosis**, ou lancez **Troubleshoot plugin conflicts** depuis la palette de commandes.
+2. Démarrez une session. BPM enregistre l'état actuel des plugins avant toute modification.
+3. Testez votre vault après chaque étape, puis choisissez **Problem Still Exists** ou **Problem Gone**.
+4. Continuez les tests guidés jusqu'à ce que BPM réduise le résultat à un plugin ou une paire de plugins.
+5. Examinez le résultat, restaurez l'état initial ou gardez l'état actuel, puis générez un rapport Markdown si nécessaire.
+
+### Notes
+
+- Le diagnostic dépend de votre retour à chaque étape ; utilisez toujours la même action de test.
+- Les bugs intermittents, problèmes d'ordre de chargement, bugs liés à la configuration ou conflits impliquant trois plugins ou plus peuvent nécessiter une vérification manuelle.
+- Vous pouvez annuler l'étape précédente, redémarrer Obsidian pendant le test, quitter, restaurer l'état initial ou garder l'état actuel.
+
+---
+
+## 🛡️ Prise de contrôle au démarrage
+
+Quand **Delayed Startup** est activé, BPM vérifie `.obsidian/community-plugins.json` pour éviter qu'Obsidian et BPM contrôlent les mêmes plugins au démarrage.
+
+| Cas | Comportement de BPM |
+|-----|---------------------|
+| Aucun plugin non géré | Démarrage normal |
+| Plugins non gérés détectés | Affiche une invite de prise de contrôle |
+| Auto Takeover activé | Déplace automatiquement les plugins détectés sous gestion BPM |
+| Plugin marqué `bpm-ignore` | Le laisse dans la liste de démarrage native d'Obsidian |
+
+La prise de contrôle garde cohérents le démarrage différé, l'état activé et les enregistrements BPM. Après succès, redémarrez Obsidian pour appliquer proprement la liste de démarrage.
+
+---
+
+## 📦 Transfer et export legacy
+
+Dans les versions actuelles, utilisez **Transfer Pack** pour déplacer des configurations entre vaults. Il exporte et importe listes de plugins, thèmes, configs sélectionnées, groupes, tags, profils de délai, layout, ordre du ribbon, abonnements source, historique d'installation et préférences workspace.
+
+L'ancien export Markdown/frontmatter pour Obsidian Base est conservé uniquement pour la compatibilité avec les données legacy. Les nouvelles configurations devraient utiliser **Transfer Pack** plutôt qu'un dossier d'export Base.
+
+---
+
+## ⚙️ Réglages
+
+Les réglages BPM sont divisés en pages ciblées :
+
+| Page | Ce que vous pouvez configurer |
+|------|-------------------------------|
+| **Basic** | Langue, persistance des filtres, démarrage différé, auto takeover, vérifications au démarrage, vérifications de sources, auto-update des sources, visibilité des tags BPM, ordre du ribbon, commandes, mode debug et token GitHub |
+| **Main Page Actions** | Choisir quelles actions apparaissent sur les cartes plugin et lesquelles restent dans le menu clic droit |
+| **Style** | Layout de liste, style des éléments, styles groupe/tag et atténuation des plugins désactivés |
+| **Groups** | Créer, renommer, recolorer et supprimer des groupes |
+| **Tags** | Créer, renommer, recolorer et supprimer des tags |
+| **Delay** | Créer et gérer les profils de démarrage différé ; visible seulement si le démarrage différé est activé |
+
+---
+
+## ⌨️ Commandes
+
+| Commande | Disponibilité | Description |
+|----------|---------------|-------------|
+| **Open the plugin manager** | Toujours disponible | Ouvre l'interface principale de BPM |
+| **Troubleshoot plugin conflicts** | Toujours disponible | Démarre le flux de diagnostic des conflits |
+| **Enable/Disable [Plugin Name]** | Réglage optionnel | Enregistre une commande par plugin pour le basculer directement |
+| **One-click Enable/Disable [Group Name]** | Réglage optionnel | Enregistre des commandes de groupe pour basculer en lot |
+
+---
+
+## 📱 Compatibilité
+
+| Plateforme | Support |
+|------------|---------|
+| Windows / macOS / Linux | ✅ |
+| Android | ✅ |
+| iOS / iPadOS | ✅ |
+
+Le plugin bascule automatiquement entre layouts bureau et mobile selon la plateforme.
+
+---
+
+## 🤝 Contribuer
+
+Les issues et PR sont les bienvenus.
+
+- **Rapports de bugs** : incluez les logs et les étapes de reproduction.
+- **Demandes de fonctionnalités** : ouvrez de préférence une discussion ou issue d'abord.
+
+## 🙏 Remerciements
+
+- La fonction de tri du ribbon est inspirée de [Obsidian-ribbon-sort](https://github.com/yunrr/Obsidian-app-ribbon-sorting).
+
+---
+
+## 📄 License
+
+[MIT](../LICENSE)
diff --git a/docs/README_JA.md b/docs/README_JA.md
new file mode 100644
index 0000000..0813297
--- /dev/null
+++ b/docs/README_JA.md
@@ -0,0 +1,301 @@
+
+
+
+
+---
+
+## 🎯 BPM とは？
+
+**Better Plugins Manager (BPM)** は Obsidian コミュニティプラグインのコントロールセンターです。多くのプラグインに依存し、単純な有効/無効切り替え以上の管理が必要な vault 向けに設計されています。
+
+起動の応答性を保ち、ワークフローごとにプラグインを整理し、GitHub Release からインストールし、問題が起きたときに競合を切り分けられます。
+
+| 🚀 起動 | 📦 管理 | 🏷️ 整理 | 📥 インストール | 🔍 診断 |
+|--------|--------|----------|-----------------|---------|
+| プラグインの遅延起動と起動時セルフチェック | 一括有効/無効、クイック検索、状態フィルター | グループ、タグ、メモ、説明、カスタム名 | GitHub リポジトリと Release からインストール | ガイド付き競合診断とレポート生成 |
+
+---
+
+## ✨ 主な機能
+
+BPM は 5 つのタブを中心に構成されています。各タブが 1 つのワークフローを担当するため、関連する操作がまとまり、デスクトップでもモバイルでも見通しよく使えます。
+
+| Tab | ワークフロー |
+|-----|--------------|
+| 🧩 Plugin View | インストール済みプラグイン、メタデータ、フィルター、起動動作、個別操作を管理 |
+| 📥 Install Hub | GitHub からプラグインやテーマをインストールし、追跡ソースを管理 |
+| 📦 Transfer Pack | vault 間でプラグイン/テーマパックをエクスポート、インポート、復元 |
+| 🎛️ Ribbon Order | Obsidian の Ribbon アイコンの順序と表示を制御 |
+| 🔍 Conflict Diagnosis | プラグイン問題を切り分け、診断レポートを生成 |
+
+### 🧩 Plugin View
+
+日常的なプラグイン管理のメインタブです。
+
+
+
+| 項目 | 内容 |
+|------|------|
+| **プラグイン一覧** | インストール済みコミュニティプラグインをコンパクトで検索可能なビューで確認 |
+| **一括操作** | プラグインをまとめて有効/無効化。グループ単位の操作にも対応 |
+| **フィルター** | 有効状態、グループ、タグ、遅延設定、キーワードで絞り込み |
+| **整理** | カスタム名、説明、メモ、グループ、タグを追加 |
+| **起動制御** | 遅延起動プリセットを割り当て、一覧から起動状態を確認 |
+| **プラグイン操作** | 更新確認、更新ダウンロード、再起動、一時起動、設定を開く、フォルダーを開く、ID コピー、リポジトリを開く、設定クリア、非表示、削除 |
+| **BPM タグ** | BPM でインストールしたプラグインに `bpm-install` を自動付与し、`bpm-ignore` による除外にも対応 |
+
+### 📥 Install Hub
+
+Install Hub は GitHub からのインストールと、インストール後に BPM が追跡できるソースを扱います。
+
+
+
+| 項目 | 内容 |
+|------|------|
+| **種類の切り替え** | プラグインとテーマのインストールを切り替え |
+| **リポジトリ入力** | `user/repo` または完全な GitHub リポジトリ URL に対応 |
+| **Release 選択** | GitHub Release を取得し、最新版または指定バージョンをインストール |
+| **Release notes** | 利用可能な場合、インストール前に Release 情報を表示 |
+| **最近使った項目** | 最近使用したリポジトリを保存し、再インストールを高速化 |
+| **ソース追跡** | インストール済みリポジトリを追跡し、後の確認、更新、再インストールに利用 |
+| **ソース管理** | 追跡中のプラグイン/テーマソース、更新対象、再インストール項目、ソースメタデータを管理 |
+
+### 📦 Transfer Pack
+
+Transfer Pack は vault 間でプラグイン構成を移動するための機能です。手動のチェックリストを作る必要はありません。
+
+
+
+| 項目 | 内容 |
+|------|------|
+| **エクスポート一覧** | ローカルのプラグインとテーマを選択して JSON 転送パックを作成 |
+| **プラグイン設定** | 必要なプラグイン設定ファイルを選択してエクスポート |
+| **分類情報** | BPM のグループ、タグ、遅延プリセットをエクスポート |
+| **レイアウト情報** | マネージャーの順序、非表示項目、Ribbon レイアウトをエクスポート |
+| **ソース情報** | GitHub リポジトリマップ、ソース購読、インストール履歴をエクスポート |
+| **ワークスペース設定** | スタイル、遅延モード、タグ表示、起動時チェック設定をエクスポート |
+| **インポートプレビュー** | 適用前にプラグイン、テーマ、ソース、設定、レイアウトを確認 |
+| **復元オプション** | 不足プラグイン/テーマのインストール、設定のマージ、有効状態の復元、レイアウト適用、ソースのマージ、テーマのインポート |
+
+### 🎛️ Ribbon Order
+
+Ribbon Order は Obsidian 左側 Ribbon の順序を安定させます。特に遅延起動プラグインが起動後にアイコンを登録する場合に役立ちます。
+
+
+
+| 項目 | 内容 |
+|------|------|
+| **アイコン順序** | Ribbon 項目をドラッグして安定した順序に並べ替え |
+| **表示制御** | 個別の Ribbon アイコンを表示または非表示 |
+| **Native Sync Mode** | Obsidian workspace 設定ではなく BPM データに Ribbon レイアウトを保存 |
+| **リセット** | すべての Ribbon 項目を表示し、名前順に並べ替え |
+| **リロード案内** | 起動時に非表示だったアイコンの表示に Obsidian のリロードが必要な場合に通知 |
+
+### 🔍 Conflict Diagnosis
+
+Conflict Diagnosis はプラグイン競合のテストを段階的に案内し、テスト状態と結果を 1 か所に保持します。
+
+
+
+| 項目 | 内容 |
+|------|------|
+| **事前確認** | 他のプラグインを無効化しても問題が残るか確認 |
+| **二分絞り込み** | 分割テストで疑わしいプラグイン群を縮小 |
+| **競合ペア探索** | 2 プラグイン間の競合を特定。グループをまたぐケースにも対応 |
+| **手動フィードバック** | 各ステップで問題が残るかどうかをユーザーが確認 |
+| **状態操作** | 前の手順に戻る、Obsidian を再起動、診断終了、元の状態に復元、現在の状態を維持 |
+| **結果レポート** | 検出されたプラグインと推奨対応を含む Markdown レポートを生成 |
+
+---
+
+## 📦 インストール
+
+### Community Plugins
+
+ほとんどのユーザーに推奨します。
+
+1. **Obsidian Settings → Community Plugins** を開きます。
+2. **Better Plugins Manager** を検索します。
+3. インストールして有効化します。
+
+### 手動インストール
+
+GitHub Release を直接インストールしたい場合に使います。
+
+1. [latest release](https://github.com/zenozero-dev/obsidian-manager/releases) をダウンロードします。
+2. `main.js`、`manifest.json`、`styles.css` を `.obsidian/plugins/better-plugins-manager/` にコピーします。
+3. Obsidian を再起動します。
+4. **Settings → Community Plugins** から **Better Plugins Manager** を有効化します。
+
+---
+
+## 🚦 クイックスタート
+
+### BPM を開く
+
+プラグインを有効化した後、次のどちらかで BPM を開けます。
+
+- 左側 Ribbon の BPM アイコンをクリックします。
+- コマンドパレットから **Open the plugin manager** を実行します。
+
+### 最初の手順
+
+1. **Plugin View** でインストール済みプラグイン、フィルター、グループ、タグ、遅延設定を確認します。
+2. GitHub からプラグインやテーマをインストールするときは **Install Hub** を使います。
+3. vault 間で構成を移動するときは **Transfer Pack** を使います。
+4. プラグイン問題を切り分けるときは **Conflict Diagnosis** を使います。
+
+### 操作のヒント
+
+- **左クリック** で切り替え、編集、インストール、インポート、操作実行を行います。
+- **右クリック** でプラグイン項目のコンテキストメニューを開きます。
+- ツールバーのボタンに **ホバー** すると説明が表示されます。タッチ端末では対応箇所で長押しを使えます。
+
+---
+
+## 🔍 Conflict Diagnosis チュートリアル
+
+コミュニティプラグインを有効化した後に問題が発生し、原因を段階的に絞り込みたい場合に **Conflict Diagnosis** を使います。
+
+### ワークフロー
+
+1. **Conflict Diagnosis** タブを開くか、コマンドパレットから **Troubleshoot plugin conflicts** を実行します。
+2. 診断セッションを開始します。BPM は変更前のプラグイン状態を記録します。
+3. 各ステップ後に vault をテストし、**Problem Still Exists** または **Problem Gone** を選びます。
+4. ガイド付き分割テストを続け、結果をプラグインまたはプラグインペアまで絞ります。
+5. 結果を確認し、元の状態に戻すか現在の状態を維持し、必要に応じて Markdown レポートを生成します。
+
+### 注意
+
+- 診断は各ステップでのフィードバックに依存します。毎回同じ操作でテストしてください。
+- 断続的な不具合、読み込み順の問題、設定依存の問題、3 つ以上のプラグインが関わる競合は手動確認が必要な場合があります。
+- 前の手順に戻る、テスト中に Obsidian を再起動する、診断を終了する、元の状態に復元する、現在の状態を維持することができます。
+
+---
+
+## 🛡️ Startup Takeover
+
+**Delayed Startup** が有効な場合、BPM は `.obsidian/community-plugins.json` を確認し、Obsidian と BPM が同じプラグインを同時に制御しないようにします。
+
+| 状況 | BPM の動作 |
+|------|------------|
+| 未管理プラグインなし | 通常どおり起動 |
+| 未管理プラグインを検出 | takeover プロンプトを表示 |
+| Auto Takeover 有効 | 検出したプラグインを自動的に BPM 管理へ移行 |
+| `bpm-ignore` が付いたプラグイン | Obsidian のネイティブ起動リストに残す |
+
+Takeover により、遅延起動、有効状態、BPM のプラグイン記録を一貫させます。成功後は Obsidian を再起動し、起動リストをきれいに適用してください。
+
+---
+
+## 📦 Transfer と Legacy Export
+
+現在のバージョンでは、vault 間で構成を移動する場合は **Transfer Pack** を使ってください。プラグイン一覧、テーマ、選択したプラグイン設定、グループ、タグ、遅延プリセット、レイアウト情報、Ribbon 順序、ソース購読、インストール履歴、ワークスペース設定をエクスポート/インポートできます。
+
+古い Markdown/frontmatter の Obsidian Base export は、レガシーデータ互換のためだけに残されています。新しい構成では Base export フォルダーを設定せず、**Transfer Pack** を使ってください。
+
+---
+
+## ⚙️ 設定
+
+BPM の設定は機能ごとに分かれています。
+
+| ページ | 設定できる内容 |
+|--------|----------------|
+| **Basic** | 言語、フィルター保持、遅延起動、Auto Takeover、起動時更新チェック、ソース更新チェック、ソース自動更新、BPM タグ表示、Ribbon order、コマンド、デバッグモード、GitHub token |
+| **Main Page Actions** | どのプラグイン操作をカード上に直接表示し、どれを右クリックメニューに入れるか |
+| **Style** | プラグイン一覧レイアウト、項目表示スタイル、グループ/タグスタイル、無効プラグインのフェード表示 |
+| **Groups** | プラグイングループの作成、名前変更、色変更、削除 |
+| **Tags** | プラグインタグの作成、名前変更、色変更、削除 |
+| **Delay** | 遅延起動プロファイルの作成と管理。遅延起動が有効な場合のみ表示 |
+
+---
+
+## ⌨️ コマンド
+
+| コマンド | 利用条件 | 説明 |
+|----------|----------|------|
+| **Open the plugin manager** | 常に利用可能 | BPM メイン画面を開く |
+| **Troubleshoot plugin conflicts** | 常に利用可能 | 競合診断ワークフローを開始 |
+| **Enable/Disable [Plugin Name]** | 任意設定 | プラグインごとの直接切り替えコマンドを登録 |
+| **One-click Enable/Disable [Group Name]** | 任意設定 | グループ単位の一括切り替えコマンドを登録 |
+
+---
+
+## 📱 互換性
+
+| プラットフォーム | 対応 |
+|------------------|------|
+| Windows / macOS / Linux | ✅ |
+| Android | ✅ |
+| iOS / iPadOS | ✅ |
+
+プラグインはプラットフォームに応じてデスクトップ/モバイルレイアウトを自動的に切り替えます。
+
+---
+
+## 🤝 コントリビューション
+
+Issue と PR を歓迎します。
+
+- **バグ報告**: ログと再現手順を含めてください。
+- **機能要望**: まず discussion または issue を開くことをおすすめします。
+
+## 🙏 謝辞
+
+- Ribbon sorting 機能は [Obsidian-ribbon-sort](https://github.com/yunrr/Obsidian-app-ribbon-sorting) に着想を得ています。
+
+---
+
+## 📄 License
+
+[MIT](../LICENSE)
diff --git a/docs/README_KO.md b/docs/README_KO.md
new file mode 100644
index 0000000..fe113e0
--- /dev/null
+++ b/docs/README_KO.md
@@ -0,0 +1,301 @@
+
+
+
+
+---
+
+## 🎯 BPM이란?
+
+**Better Plugins Manager (BPM)** 는 Obsidian 커뮤니티 플러그인을 위한 컨트롤 센터입니다. 많은 플러그인을 사용하는 vault에서 단순한 켜기/끄기 이상의 관리가 필요할 때 유용합니다.
+
+BPM은 시작 속도를 유지하고, 워크플로별로 플러그인을 정리하며, GitHub Release에서 설치하고, 문제가 생겼을 때 충돌 원인을 좁히는 데 도움을 줍니다.
+
+| 🚀 시작 | 📦 관리 | 🏷️ 정리 | 📥 설치 | 🔍 진단 |
+|--------|--------|----------|---------|---------|
+| 플러그인 지연 시작과 시작 시 자체 검사 | 일괄 활성화/비활성화, 빠른 검색, 상태 필터 | 그룹, 태그, 메모, 설명, 사용자 지정 이름 | GitHub 저장소와 Release에서 설치 | 안내식 충돌 진단과 보고서 생성 |
+
+---
+
+## ✨ 핵심 기능
+
+BPM은 다섯 개의 탭을 중심으로 구성됩니다. 각 탭은 하나의 워크플로를 담당하므로 관련 컨트롤이 한곳에 모이고, 데스크톱과 모바일 모두에서 쉽게 훑어볼 수 있습니다.
+
+| Tab | Workflow |
+|-----|----------|
+| 🧩 Plugin View | 설치된 플러그인, 메타데이터, 필터, 시작 동작, 개별 플러그인 작업 관리 |
+| 📥 Install Hub | GitHub에서 플러그인 또는 테마 설치, 추적 소스 관리 |
+| 📦 Transfer Pack | vault 간 플러그인/테마 팩 내보내기, 가져오기, 복원 |
+| 🎛️ Ribbon Order | Obsidian 리본 아이콘 순서와 표시 여부 제어 |
+| 🔍 Conflict Diagnosis | 플러그인 문제를 좁히고 진단 보고서 생성 |
+
+### 🧩 Plugin View
+
+일상적인 플러그인 관리를 위한 기본 탭입니다.
+
+
+
+| 영역 | 기능 |
+|------|------|
+| **플러그인 목록** | 설치된 커뮤니티 플러그인을 간결하고 검색 가능한 관리 화면에서 확인 |
+| **일괄 작업** | 플러그인을 한꺼번에 활성화/비활성화하고 그룹 단위 작업 수행 |
+| **필터** | 활성 상태, 그룹, 태그, 지연 설정, 키워드로 필터링 |
+| **정리** | 사용자 지정 이름, 설명, 메모, 그룹, 태그 추가 |
+| **시작 제어** | 지연 시작 프리셋을 지정하고 목록에서 시작 동작 확인 |
+| **플러그인 작업** | 업데이트 확인, 업데이트 다운로드, 플러그인 재시작, 임시 시작, 설정 열기, 폴더 열기, ID 복사, 저장소 열기, 설정 초기화, 숨기기, 삭제 |
+| **BPM 태그** | BPM으로 설치한 플러그인에 `bpm-install`을 자동 표시하고 `bpm-ignore`로 관리 제외 가능 |
+
+### 📥 Install Hub
+
+Install Hub는 GitHub 기반 설치와 설치 후 BPM이 추적할 수 있는 소스를 관리합니다.
+
+
+
+| 영역 | 기능 |
+|------|------|
+| **설치 유형** | 플러그인 설치와 테마 설치 전환 |
+| **저장소 입력** | `user/repo` 또는 전체 GitHub 저장소 URL 지원 |
+| **Release 선택** | GitHub Release를 가져와 최신 버전 또는 선택한 버전을 설치 |
+| **Release notes** | 사용 가능한 경우 설치 전 Release 정보 표시 |
+| **최근 설치** | 반복 설치를 빠르게 하기 위해 최근 사용한 저장소 저장 |
+| **소스 추적** | 설치된 저장소를 추적하여 이후 확인, 업데이트, 재설치에 활용 |
+| **소스 관리** | 추적 중인 플러그인/테마 소스, 업데이트 대상, 재설치 항목, 소스 메타데이터 관리 |
+
+### 📦 Transfer Pack
+
+Transfer Pack은 vault 간 플러그인 구성을 이동하기 위한 기능입니다. 수동 체크리스트를 만들 필요가 없습니다.
+
+
+
+| 영역 | 기능 |
+|------|------|
+| **내보내기 목록** | 로컬 플러그인과 테마를 선택해 JSON 전송 팩 생성 |
+| **플러그인 설정** | 필요한 플러그인 설정 파일을 선택해 내보내기 |
+| **분류 데이터** | BPM 그룹, 태그, 지연 프리셋 내보내기 |
+| **레이아웃 데이터** | 관리자 순서, 숨김 항목, Ribbon 레이아웃 내보내기 |
+| **소스 데이터** | GitHub 저장소 매핑, 소스 구독, 설치 기록 내보내기 |
+| **작업 공간 설정** | 스타일, 지연 모드, 태그 표시, 시작 시 확인 설정 내보내기 |
+| **가져오기 미리보기** | 적용 전에 포함된 플러그인, 테마, 소스, 설정, 레이아웃 데이터 확인 |
+| **복원 옵션** | 누락된 플러그인/테마 설치, 플러그인 설정 병합, 활성 상태 복원, 레이아웃 적용, 소스 병합, 테마 가져오기 |
+
+### 🎛️ Ribbon Order
+
+Ribbon Order는 Obsidian 왼쪽 리본 순서를 안정적으로 유지합니다. 지연 시작 플러그인이 시작 후 아이콘을 등록하는 경우 특히 유용합니다.
+
+
+
+| 영역 | 기능 |
+|------|------|
+| **아이콘 순서** | 리본 항목을 드래그해 안정적인 순서로 정렬 |
+| **표시 제어** | 개별 리본 아이콘 표시/숨김 |
+| **Native Sync Mode** | Obsidian workspace 설정 대신 BPM 데이터에 리본 레이아웃 저장 |
+| **초기화** | 모든 리본 항목을 표시하고 이름순으로 정렬 |
+| **다시 로드 안내** | 시작 시 숨겨진 아이콘을 표시하려면 Obsidian 새로고침이 필요한 경우 안내 |
+
+### 🔍 Conflict Diagnosis
+
+Conflict Diagnosis는 플러그인 충돌 테스트를 단계별로 안내하고 테스트 상태와 결과를 한곳에 보관합니다.
+
+
+
+| 영역 | 기능 |
+|------|------|
+| **사전 확인** | 다른 플러그인을 비활성화해도 문제가 남는지 확인 |
+| **이분 탐색** | 분할 테스트로 의심 플러그인 범위를 줄임 |
+| **충돌 쌍 탐색** | 두 플러그인 간 충돌을 찾고 그룹을 넘는 경우도 지원 |
+| **수동 피드백** | 각 단계에서 문제가 남는지 사용자가 확인 |
+| **상태 제어** | 이전 단계 되돌리기, Obsidian 재시작, 진단 종료, 원래 상태 복원, 현재 상태 유지 |
+| **결과 보고서** | 감지된 플러그인과 제안 작업을 포함한 Markdown 보고서 생성 |
+
+---
+
+## 📦 설치
+
+### Community Plugins
+
+대부분의 사용자에게 권장됩니다.
+
+1. **Obsidian Settings → Community Plugins** 를 엽니다.
+2. **Better Plugins Manager** 를 검색합니다.
+3. 설치하고 활성화합니다.
+
+### 수동 설치
+
+GitHub Release를 직접 설치하고 싶을 때 사용합니다.
+
+1. [latest release](https://github.com/zenozero-dev/obsidian-manager/releases)를 다운로드합니다.
+2. `main.js`, `manifest.json`, `styles.css`를 `.obsidian/plugins/better-plugins-manager/`에 복사합니다.
+3. Obsidian을 다시 시작합니다.
+4. **Settings → Community Plugins** 에서 **Better Plugins Manager** 를 활성화합니다.
+
+---
+
+## 🚦 빠른 시작
+
+### BPM 열기
+
+플러그인을 활성화한 후 다음 방법 중 하나로 BPM을 엽니다.
+
+- 왼쪽 리본의 BPM 아이콘을 클릭합니다.
+- 명령 팔레트에서 **Open the plugin manager** 를 실행합니다.
+
+### 첫 단계
+
+1. **Plugin View** 에서 설치된 플러그인, 필터, 그룹, 태그, 지연 설정을 확인합니다.
+2. GitHub에서 플러그인이나 테마를 설치할 때는 **Install Hub** 를 사용합니다.
+3. vault 간 구성을 이동할 때는 **Transfer Pack** 을 사용합니다.
+4. 플러그인 문제를 좁혀야 할 때는 **Conflict Diagnosis** 를 사용합니다.
+
+### 상호작용 팁
+
+- **왼쪽 클릭** 으로 토글, 편집, 설치, 가져오기, 작업 실행을 수행합니다.
+- **오른쪽 클릭** 으로 플러그인 항목의 컨텍스트 메뉴를 엽니다.
+- 툴바 버튼에 **마우스를 올리면** 설명이 표시됩니다. 터치 기기에서는 지원되는 곳에서 길게 누르기를 사용할 수 있습니다.
+
+---
+
+## 🔍 Conflict Diagnosis 튜토리얼
+
+커뮤니티 플러그인을 활성화한 뒤 문제가 생겼고 원인을 구조적으로 좁히고 싶다면 **Conflict Diagnosis** 를 사용하세요.
+
+### 워크플로
+
+1. **Conflict Diagnosis** 탭을 열거나 명령 팔레트에서 **Troubleshoot plugin conflicts** 를 실행합니다.
+2. 진단 세션을 시작합니다. BPM은 변경 전에 현재 플러그인 상태를 기록합니다.
+3. 각 단계 후 vault를 테스트한 다음 **Problem Still Exists** 또는 **Problem Gone** 을 선택합니다.
+4. 안내식 분할 테스트를 계속해 결과를 플러그인 또는 플러그인 쌍으로 좁힙니다.
+5. 결과를 확인하고 원래 상태를 복원하거나 현재 상태를 유지한 뒤 필요하면 Markdown 보고서를 생성합니다.
+
+### 참고
+
+- 진단은 각 단계의 피드백에 의존합니다. 매번 같은 테스트 동작을 사용하세요.
+- 간헐적 버그, 로드 순서 문제, 설정 의존 버그, 세 개 이상의 플러그인이 얽힌 충돌은 수동 확인이 필요할 수 있습니다.
+- 이전 단계 되돌리기, 테스트 중 Obsidian 재시작, 세션 종료, 원래 상태 복원, 현재 상태 유지가 가능합니다.
+
+---
+
+## 🛡️ 시작 인계
+
+**Delayed Startup** 이 켜져 있으면 BPM은 `.obsidian/community-plugins.json`을 확인해 Obsidian과 BPM이 같은 플러그인을 동시에 제어하지 않도록 합니다.
+
+| 상황 | BPM 동작 |
+|------|----------|
+| 관리되지 않는 플러그인 없음 | 정상 시작 |
+| 관리되지 않는 플러그인 감지 | 인계 프롬프트 표시 |
+| Auto Takeover 켜짐 | 감지된 플러그인을 BPM 관리로 자동 이동 |
+| `bpm-ignore` 표시 플러그인 | Obsidian 기본 시작 목록에 유지 |
+
+인계는 지연 시작, 활성 상태, BPM 플러그인 기록을 일관되게 유지합니다. 성공 후에는 Obsidian을 다시 시작해 시작 목록이 깔끔하게 적용되도록 하세요.
+
+---
+
+## 📦 Transfer 및 Legacy Export
+
+현재 버전에서는 vault 간 구성을 이동할 때 **Transfer Pack** 을 사용하세요. 플러그인 목록, 테마, 선택한 플러그인 설정, 그룹, 태그, 지연 프리셋, 레이아웃 데이터, 리본 순서, 소스 구독, 설치 기록, 작업 공간 설정을 내보내고 가져올 수 있습니다.
+
+이전 Markdown/frontmatter Obsidian Base export는 레거시 데이터 호환을 위해서만 유지됩니다. 새 설정에서는 Base export 폴더를 구성하지 말고 **Transfer Pack** 을 사용하세요.
+
+---
+
+## ⚙️ 설정
+
+BPM 설정은 기능별 페이지로 나뉩니다.
+
+| 페이지 | 설정 내용 |
+|--------|----------|
+| **Basic** | 언어, 필터 유지, 지연 시작, 자동 인계, 시작 시 업데이트 확인, 소스 업데이트 확인, 소스 자동 업데이트, BPM 태그 표시, Ribbon order, 명령, 디버그 모드, GitHub token |
+| **Main Page Actions** | 어떤 플러그인 작업을 카드에 직접 표시하고 어떤 작업을 오른쪽 클릭 메뉴에 둘지 선택 |
+| **Style** | 플러그인 목록 레이아웃, 항목 표시 스타일, 그룹/태그 스타일, 비활성 플러그인 흐리게 표시 |
+| **Groups** | 플러그인 그룹 생성, 이름 변경, 색상 변경, 삭제 |
+| **Tags** | 플러그인 태그 생성, 이름 변경, 색상 변경, 삭제 |
+| **Delay** | 지연 시작 프로필 생성 및 관리. 지연 시작이 켜져 있을 때만 표시 |
+
+---
+
+## ⌨️ 명령
+
+| 명령 | 사용 가능 조건 | 설명 |
+|------|----------------|------|
+| **Open the plugin manager** | 항상 사용 가능 | BPM 메인 화면 열기 |
+| **Troubleshoot plugin conflicts** | 항상 사용 가능 | 충돌 진단 워크플로 시작 |
+| **Enable/Disable [Plugin Name]** | 선택 설정 | 플러그인별 직접 전환 명령 등록 |
+| **One-click Enable/Disable [Group Name]** | 선택 설정 | 그룹 단위 일괄 전환 명령 등록 |
+
+---
+
+## 📱 호환성
+
+| 플랫폼 | 지원 |
+|--------|------|
+| Windows / macOS / Linux | ✅ |
+| Android | ✅ |
+| iOS / iPadOS | ✅ |
+
+플러그인은 플랫폼에 따라 데스크톱/모바일 레이아웃을 자동으로 전환합니다.
+
+---
+
+## 🤝 기여
+
+Issue와 PR을 환영합니다.
+
+- **버그 보고**: 로그와 재현 단계를 포함해 주세요.
+- **기능 요청**: 먼저 discussion 또는 issue를 여는 것을 권장합니다.
+
+## 🙏 감사
+
+- Ribbon sorting 기능은 [Obsidian-ribbon-sort](https://github.com/yunrr/Obsidian-app-ribbon-sorting)에서 영감을 받았습니다.
+
+---
+
+## 📄 License
+
+[MIT](../LICENSE)
diff --git a/docs/README_RU.md b/docs/README_RU.md
new file mode 100644
index 0000000..34e2951
--- /dev/null
+++ b/docs/README_RU.md
@@ -0,0 +1,301 @@
+
+
+
+
+---
+
+## 🎯 Что такое BPM?
+
+**Better Plugins Manager (BPM)** — это центр управления community-плагинами Obsidian, созданный для vault, где используется много плагинов и обычных переключателей включить/выключить уже недостаточно.
+
+BPM помогает сохранить быстрый запуск, организовать плагины по рабочим процессам, устанавливать их из GitHub Releases и изолировать конфликты, когда что-то ломается.
+
+| 🚀 Запуск | 📦 Управление | 🏷️ Организация | 📥 Установка | 🔍 Диагностика |
+|----------|---------------|----------------|--------------|----------------|
+| Отложенный запуск и самопроверка | Массовое включение/выключение, быстрый поиск и фильтры состояния | Группы, теги, заметки, описания и пользовательские имена | Установка из репозиториев и релизов GitHub | Пошаговая диагностика конфликтов с отчетами |
+
+---
+
+## ✨ Основные функции
+
+BPM организован вокруг пяти вкладок. Каждая вкладка отвечает за один рабочий процесс, поэтому связанные элементы управления находятся вместе, а интерфейс легко просматривать на десктопе и мобильных устройствах.
+
+| Вкладка | Рабочий процесс |
+|---------|-----------------|
+| 🧩 Plugin View | Управление установленными плагинами, метаданными, фильтрами, запуском и действиями плагина |
+| 📥 Install Hub | Установка плагинов или тем из GitHub и управление отслеживаемыми источниками |
+| 📦 Transfer Pack | Экспорт, импорт и восстановление пакетов плагинов/тем между vault |
+| 🎛️ Ribbon Order | Управление порядком и видимостью иконок Ribbon в Obsidian |
+| 🔍 Conflict Diagnosis | Поиск проблем плагинов и создание диагностических отчетов |
+
+### 🧩 Plugin View
+
+Главная вкладка для повседневного управления плагинами.
+
+
+
+| Область | Что делает |
+|---------|------------|
+| **Список плагинов** | Показывает установленные community-плагины в компактном, доступном для поиска виде |
+| **Массовые действия** | Включает или отключает плагины массово, включая групповые сценарии |
+| **Фильтры** | Фильтрация по состоянию, группе, тегу, задержке запуска или ключевому слову |
+| **Организация** | Пользовательские имена, описания, заметки, группы и теги |
+| **Управление запуском** | Назначение профилей отложенного запуска и отображение поведения запуска в списке |
+| **Действия плагина** | Проверка обновлений, загрузка обновлений, перезапуск, временный запуск, открыть настройки, открыть папки, копировать ID, открыть репозиторий, очистить конфиг, скрыть или удалить |
+| **Теги BPM** | Плагины, установленные через BPM, автоматически получают `bpm-install`; `bpm-ignore` исключает плагин из управления |
+
+### 📥 Install Hub
+
+Install Hub отвечает за установку из GitHub и источники, которые BPM может отслеживать после установки.
+
+
+
+| Область | Что делает |
+|---------|------------|
+| **Тип установки** | Переключение между установкой плагина и темы |
+| **Ввод репозитория** | Принимает `user/repo` или полный URL GitHub |
+| **Выбор release** | Получает GitHub Releases и устанавливает последнюю или выбранную версию |
+| **Release notes** | Показывает информацию о релизе перед установкой, если она доступна |
+| **Недавние установки** | Сохраняет недавно использованные репозитории для повторной установки |
+| **Отслеживание источника** | Может отслеживать установленный репозиторий для проверки, обновления и переустановки |
+| **Управление источниками** | Просмотр отслеживаемых источников плагинов/тем, целей обновления, переустановок и метаданных |
+
+### 📦 Transfer Pack
+
+Transfer Pack переносит конфигурации плагинов между vault без ручных списков и чеклистов.
+
+
+
+| Область | Что делает |
+|---------|------------|
+| **Список экспорта** | Выбор локальных плагинов и тем для JSON-пакета переноса |
+| **Конфиги плагинов** | Экспорт выбранных файлов конфигурации плагинов при необходимости |
+| **Таксономия** | Экспорт групп, тегов и профилей задержки BPM |
+| **Данные layout** | Экспорт порядка менеджера, скрытых элементов и layout Ribbon |
+| **Источники** | Экспорт карт GitHub-репозиториев, подписок источников и истории установки |
+| **Настройки workspace** | Экспорт стиля, режима задержки, отображения тегов и настроек проверок при запуске |
+| **Предпросмотр импорта** | Загрузка пакета и проверка плагинов, тем, источников, конфигов и layout перед применением |
+| **Опции восстановления** | Установка отсутствующих плагинов/тем, слияние конфигов, восстановление включенного состояния, применение layout, слияние источников и импорт тем |
+
+### 🎛️ Ribbon Order
+
+Ribbon Order сохраняет предсказуемый порядок левого Ribbon в Obsidian, особенно когда плагины с отложенным запуском регистрируют иконки после старта.
+
+
+
+| Область | Что делает |
+|---------|------------|
+| **Порядок иконок** | Перетаскивание элементов Ribbon в стабильный порядок |
+| **Видимость** | Показ или скрытие отдельных иконок Ribbon |
+| **Native sync mode** | Хранит layout Ribbon в данных BPM, не полагаясь на workspace-конфиг Obsidian |
+| **Сброс** | Показывает все элементы Ribbon и сортирует их по имени |
+| **Подсказка перезагрузки** | Сообщает, когда Obsidian нужно перезагрузить, чтобы показать скрытые при запуске иконки |
+
+### 🔍 Conflict Diagnosis
+
+Conflict Diagnosis пошагово ведет через проверку конфликтов плагинов и хранит проверяемое состояние и результат в одном месте.
+
+
+
+| Область | Что делает |
+|---------|------------|
+| **Предварительная проверка** | Проверяет, сохраняется ли проблема при отключении других плагинов |
+| **Бинарное сужение** | Делит набор плагинов и уменьшает список подозреваемых |
+| **Поиск пары конфликта** | Помогает найти конфликт двух плагинов, включая случаи между группами |
+| **Ручная обратная связь** | Просит проверить каждый шаг и указать, сохраняется ли проблема |
+| **Управление состоянием** | Отменить предыдущий шаг, перезапустить Obsidian, выйти, восстановить исходное состояние или оставить текущее |
+| **Отчет** | Создает Markdown-отчет с найденными плагинами и рекомендуемыми действиями |
+
+---
+
+## 📦 Установка
+
+### Community Plugins
+
+Рекомендуется большинству пользователей.
+
+1. Откройте **Obsidian Settings → Community Plugins**.
+2. Найдите **Better Plugins Manager**.
+3. Установите и включите плагин.
+
+### Ручная установка
+
+Используйте, если хотите установить GitHub release напрямую.
+
+1. Скачайте [latest release](https://github.com/zenozero-dev/obsidian-manager/releases).
+2. Скопируйте `main.js`, `manifest.json` и `styles.css` в `.obsidian/plugins/better-plugins-manager/`.
+3. Перезапустите Obsidian.
+4. Включите **Better Plugins Manager** в **Settings → Community Plugins**.
+
+---
+
+## 🚦 Быстрый старт
+
+### Открыть BPM
+
+После включения плагина откройте BPM одним из способов:
+
+- Нажмите иконку BPM в левом Ribbon.
+- Запустите **Open the plugin manager** из палитры команд.
+
+### Первые шаги
+
+1. Начните с **Plugin View**, чтобы проверить установленные плагины, фильтры, группы, теги и задержки.
+2. Используйте **Install Hub** для установки плагинов или тем из GitHub.
+3. Используйте **Transfer Pack** для переноса конфигурации между vault.
+4. Используйте **Conflict Diagnosis**, когда нужно изолировать проблему плагинов.
+
+### Подсказки по взаимодействию
+
+- **Левый клик** по основным элементам управления переключает, редактирует, устанавливает, импортирует или запускает действие.
+- **Правый клик** по плагину открывает контекстное меню.
+- **Наведение** на кнопки панели показывает подсказки; на сенсорных устройствах используйте долгое нажатие, где оно поддерживается.
+
+---
+
+## 🔍 Руководство по Conflict Diagnosis
+
+Используйте **Conflict Diagnosis**, когда проблема появляется после включения community-плагинов и нужно структурированно сузить причину.
+
+### Процесс
+
+1. Откройте вкладку **Conflict Diagnosis** или запустите **Troubleshoot plugin conflicts** из палитры команд.
+2. Запустите сессию диагностики. BPM записывает текущее состояние плагинов перед изменениями.
+3. Проверяйте vault после каждого шага и выбирайте **Problem Still Exists** или **Problem Gone**.
+4. Продолжайте управляемые разделенные тесты, пока BPM не сузит результат до плагина или пары плагинов.
+5. Проверьте результат, восстановите исходное состояние или оставьте текущее, затем при необходимости создайте Markdown-отчет.
+
+### Примечания
+
+- Диагностика зависит от вашего ответа на каждом шаге; каждый раз используйте одно и то же тестовое действие.
+- Плавающие ошибки, проблемы порядка загрузки, ошибки, зависящие от конфигурации, или конфликты трех и более плагинов могут требовать ручной проверки.
+- Можно отменить предыдущий шаг, перезапустить Obsidian во время теста, выйти, восстановить исходное состояние или оставить текущее.
+
+---
+
+## 🛡️ Startup Takeover
+
+Когда включен **Delayed Startup**, BPM проверяет `.obsidian/community-plugins.json`, чтобы Obsidian и BPM не управляли одними и теми же плагинами при запуске.
+
+| Случай | Поведение BPM |
+|--------|---------------|
+| Нет неуправляемых плагинов | Обычный запуск |
+| Обнаружены неуправляемые плагины | Показывает запрос takeover |
+| Auto Takeover включен | Автоматически переводит найденные плагины под управление BPM |
+| Плагин отмечен `bpm-ignore` | Оставляет его в нативном списке запуска Obsidian |
+
+Takeover сохраняет согласованность отложенного запуска, включенного состояния и записей BPM. После успешного takeover перезапустите Obsidian, чтобы список запуска применился чисто.
+
+---
+
+## 📦 Transfer и legacy export
+
+В текущих версиях используйте **Transfer Pack** для переноса настроек между vault. Он экспортирует и импортирует списки плагинов, темы, выбранные конфиги плагинов, группы, теги, профили задержки, layout, порядок Ribbon, подписки источников, историю установки и настройки workspace.
+
+Старый Markdown/frontmatter export для Obsidian Base сохранен только для совместимости с legacy-данными. Для новых настроек используйте **Transfer Pack**, а не папку Base export.
+
+---
+
+## ⚙️ Настройки
+
+Настройки BPM разделены на отдельные страницы:
+
+| Страница | Что можно настроить |
+|----------|---------------------|
+| **Basic** | Язык, сохранение фильтров, отложенный запуск, auto takeover, проверки обновлений при запуске, проверки источников, автообновление источников, видимость тегов BPM, порядок Ribbon, команды, debug mode и GitHub token |
+| **Main Page Actions** | Какие действия плагина показывать прямо на карточках, а какие оставить в меню правого клика |
+| **Style** | Layout списка, стиль элементов, стили групп/тегов и затемнение отключенных плагинов |
+| **Groups** | Создание, переименование, изменение цвета и удаление групп |
+| **Tags** | Создание, переименование, изменение цвета и удаление тегов |
+| **Delay** | Создание и управление профилями отложенного запуска; отображается только при включенном delayed startup |
+
+---
+
+## ⌨️ Команды
+
+| Команда | Доступность | Описание |
+|---------|-------------|----------|
+| **Open the plugin manager** | Всегда доступна | Открывает основной интерфейс BPM |
+| **Troubleshoot plugin conflicts** | Всегда доступна | Запускает workflow диагностики конфликтов |
+| **Enable/Disable [Plugin Name]** | Опциональная настройка | Регистрирует команду для прямого переключения каждого плагина |
+| **One-click Enable/Disable [Group Name]** | Опциональная настройка | Регистрирует групповые команды для массового переключения |
+
+---
+
+## 📱 Совместимость
+
+| Платформа | Поддержка |
+|-----------|-----------|
+| Windows / macOS / Linux | ✅ |
+| Android | ✅ |
+| iOS / iPadOS | ✅ |
+
+Плагин автоматически переключается между desktop/mobile layout в зависимости от платформы.
+
+---
+
+## 🤝 Участие
+
+Issues и PR приветствуются.
+
+- **Bug reports**: приложите логи и шаги воспроизведения.
+- **Feature requests**: лучше сначала открыть discussion или issue.
+
+## 🙏 Благодарности
+
+- Функция сортировки Ribbon вдохновлена [Obsidian-ribbon-sort](https://github.com/yunrr/Obsidian-app-ribbon-sorting).
+
+---
+
+## 📄 License
+
+[MIT](../LICENSE)
diff --git a/docs/img/1.png b/docs/img/1.png
deleted file mode 100644
index 2dd3523..0000000
Binary files a/docs/img/1.png and /dev/null differ
diff --git a/docs/img/2.png b/docs/img/2.png
deleted file mode 100644
index 096065a..0000000
Binary files a/docs/img/2.png and /dev/null differ
diff --git a/docs/img/3.png b/docs/img/3.png
deleted file mode 100644
index d5192da..0000000
Binary files a/docs/img/3.png and /dev/null differ
diff --git a/docs/img/PixPin_2026-01-14_23-50-04.png b/docs/img/PixPin_2026-01-14_23-50-04.png
deleted file mode 100644
index 9efadb8..0000000
Binary files a/docs/img/PixPin_2026-01-14_23-50-04.png and /dev/null differ
diff --git a/docs/img/PixPin_2026-01-14_23-51-05.png b/docs/img/PixPin_2026-01-14_23-51-05.png
deleted file mode 100644
index 1c4def7..0000000
Binary files a/docs/img/PixPin_2026-01-14_23-51-05.png and /dev/null differ
diff --git a/docs/img/PixPin_2026-01-14_23-52-00.png b/docs/img/PixPin_2026-01-14_23-52-00.png
deleted file mode 100644
index b39d62e..0000000
Binary files a/docs/img/PixPin_2026-01-14_23-52-00.png and /dev/null differ
diff --git a/docs/img/PixPin_2026-01-14_23-52-35.png b/docs/img/PixPin_2026-01-14_23-52-35.png
deleted file mode 100644
index c57fe99..0000000
Binary files a/docs/img/PixPin_2026-01-14_23-52-35.png and /dev/null differ
diff --git a/docs/img/PixPin_2026-01-14_23-54-40.png b/docs/img/PixPin_2026-01-14_23-54-40.png
deleted file mode 100644
index 7bbe419..0000000
Binary files a/docs/img/PixPin_2026-01-14_23-54-40.png and /dev/null differ
diff --git a/docs/img/PixPin_2026-01-14_23-55-10.png b/docs/img/PixPin_2026-01-14_23-55-10.png
deleted file mode 100644
index 1c878e8..0000000
Binary files a/docs/img/PixPin_2026-01-14_23-55-10.png and /dev/null differ
diff --git a/docs/img/PixPin_2026-01-14_23-56-04.png b/docs/img/PixPin_2026-01-14_23-56-04.png
deleted file mode 100644
index 97b23ca..0000000
Binary files a/docs/img/PixPin_2026-01-14_23-56-04.png and /dev/null differ
diff --git a/docs/img/PluginView.png b/docs/img/PluginView.png
new file mode 100644
index 0000000..7f34bf8
Binary files /dev/null and b/docs/img/PluginView.png differ
diff --git a/docs/img/conflictScan.png b/docs/img/conflictScan.png
new file mode 100644
index 0000000..64152fe
Binary files /dev/null and b/docs/img/conflictScan.png differ
diff --git a/docs/img/index.png b/docs/img/index.png
index 8b9e436..a83e51a 100644
Binary files a/docs/img/index.png and b/docs/img/index.png differ
diff --git a/docs/img/installHub.png b/docs/img/installHub.png
new file mode 100644
index 0000000..2bc1237
Binary files /dev/null and b/docs/img/installHub.png differ
diff --git a/docs/img/ribbonOrder.png b/docs/img/ribbonOrder.png
new file mode 100644
index 0000000..5cad5e4
Binary files /dev/null and b/docs/img/ribbonOrder.png differ
diff --git a/docs/img/transferPack.png b/docs/img/transferPack.png
new file mode 100644
index 0000000..3db95e2
Binary files /dev/null and b/docs/img/transferPack.png differ
