From ddbfb526bd7fb0b165d701cdcf13a8f29583d5b2 Mon Sep 17 00:00:00 2001 From: leemour Date: Wed, 18 Nov 2026 14:33:58 +0100 Subject: [PATCH 1/4] docs(ydisk): Yandex Disk pages in EN/RU/ES (ydisk 0.2.0) ydisk was missing from tools.json, so sync never pulled the repository's docs. Only the site-written overview existed, and /docs/ydisk/compare returned 404 although its sources existed. - tools.json: ydisk, docsRef v0.2.0, lang en (the repo docs are English). - Pages from the repo at v0.2.0 (start page, installation, usage, search, MCP, recipes, commands, configuration, troubleshooting, security, changelog) with RU and ES in translations/ydisk/ and fingerprints. - The site-written ydisk.mdx overview is removed: the repo start page replaces it at the same URL. Links to it now point into the section. - Site-owned compare (already present) and a new roadmap page. - SEO descriptions, task maps, global roadmap links, sidebar folder handling, docs README, cspell words. Co-Authored-By: Claude Opus 5.5 --- content/docs/configuration.es.mdx | 2 +- content/docs/configuration.mdx | 2 +- content/docs/configuration.ru.mdx | 2 +- content/docs/features.es.mdx | 2 +- content/docs/features.mdx | 2 +- content/docs/features.ru.mdx | 2 +- content/docs/index.es.mdx | 2 +- content/docs/index.mdx | 2 +- content/docs/index.ru.mdx | 2 +- content/docs/installation.es.mdx | 2 +- content/docs/installation.mdx | 2 +- content/docs/installation.ru.mdx | 2 +- content/docs/roadmap.es.md | 3 +- content/docs/roadmap.md | 3 +- content/docs/roadmap.ru.md | 3 +- content/docs/ydisk.es.mdx | 193 -- content/docs/ydisk.mdx | 169 -- content/docs/ydisk.ru.mdx | 186 -- cspell.json | 15 +- docs/README.md | 3 +- docs/tasks.json | 36 + lib/docs-sidebar-tree.tsx | 2 +- lib/seo-copy.json | 18 +- lib/seo.ts | 2 + lib/ydisk-descriptions.ts | 53 + scripts/docs-navigation.test.ts | 3 +- scripts/localize.ts | 1 + scripts/seo.test.ts | 19 + tools.json | 13 + translations/pages/ydisk/roadmap.en.md | 20 + translations/pages/ydisk/roadmap.es.md | 20 + translations/pages/ydisk/roadmap.ru.md | 20 + translations/sources.json | 24 +- translations/ydisk/changelog.es.md | 58 + translations/ydisk/changelog.ru.md | 56 + translations/ydisk/commands.es.md | 2038 ++++++++++++++++++++++ translations/ydisk/commands.ru.md | 2038 ++++++++++++++++++++++ translations/ydisk/configuration.es.md | 83 + translations/ydisk/configuration.ru.md | 83 + translations/ydisk/index.es.md | 87 + translations/ydisk/index.ru.md | 86 + translations/ydisk/installation.es.md | 129 ++ translations/ydisk/installation.ru.md | 130 ++ translations/ydisk/mcp.es.md | 105 ++ translations/ydisk/mcp.ru.md | 104 ++ translations/ydisk/recipes.es.md | 113 ++ translations/ydisk/recipes.ru.md | 113 ++ translations/ydisk/search.es.md | 104 ++ translations/ydisk/search.ru.md | 102 ++ translations/ydisk/security.es.md | 79 + translations/ydisk/security.ru.md | 78 + translations/ydisk/troubleshooting.es.md | 68 + translations/ydisk/troubleshooting.ru.md | 68 + translations/ydisk/usage.es.md | 130 ++ translations/ydisk/usage.ru.md | 132 ++ 55 files changed, 6238 insertions(+), 576 deletions(-) delete mode 100644 content/docs/ydisk.es.mdx delete mode 100644 content/docs/ydisk.mdx delete mode 100644 content/docs/ydisk.ru.mdx create mode 100644 lib/ydisk-descriptions.ts create mode 100644 translations/pages/ydisk/roadmap.en.md create mode 100644 translations/pages/ydisk/roadmap.es.md create mode 100644 translations/pages/ydisk/roadmap.ru.md create mode 100644 translations/ydisk/changelog.es.md create mode 100644 translations/ydisk/changelog.ru.md create mode 100644 translations/ydisk/commands.es.md create mode 100644 translations/ydisk/commands.ru.md create mode 100644 translations/ydisk/configuration.es.md create mode 100644 translations/ydisk/configuration.ru.md create mode 100644 translations/ydisk/index.es.md create mode 100644 translations/ydisk/index.ru.md create mode 100644 translations/ydisk/installation.es.md create mode 100644 translations/ydisk/installation.ru.md create mode 100644 translations/ydisk/mcp.es.md create mode 100644 translations/ydisk/mcp.ru.md create mode 100644 translations/ydisk/recipes.es.md create mode 100644 translations/ydisk/recipes.ru.md create mode 100644 translations/ydisk/search.es.md create mode 100644 translations/ydisk/search.ru.md create mode 100644 translations/ydisk/security.es.md create mode 100644 translations/ydisk/security.ru.md create mode 100644 translations/ydisk/troubleshooting.es.md create mode 100644 translations/ydisk/troubleshooting.ru.md create mode 100644 translations/ydisk/usage.es.md create mode 100644 translations/ydisk/usage.ru.md diff --git a/content/docs/configuration.es.mdx b/content/docs/configuration.es.mdx index 01f7852e..f04a6f10 100644 --- a/content/docs/configuration.es.mdx +++ b/content/docs/configuration.es.mdx @@ -85,7 +85,7 @@ Las dos herramientas comparten la mayoría de los ajustes, como `limit`, `sends_ - **Telegram:** [guía de configuración de Telegram](./tg/configuration.md) · [todos los ajustes de Telegram, sus valores predeterminados y variables de entorno](./tg/configuration-reference.md). - **MAX:** [guía de configuración de MAX](./max/configuration.md) · [todos los ajustes de MAX, sus valores predeterminados y variables de entorno](./max/configuration-reference.md). -Las demás herramientas tienen sus propios archivos de ajustes: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Yandex Disk](./ydisk.mdx#reference), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Bitrix24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) y [Memo](./memo/configuration.md). +Las demás herramientas tienen sus propios archivos de ajustes: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Yandex Disk](./ydisk/configuration.md), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Bitrix24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) y [Memo](./memo/configuration.md). ## Perfiles y bots diff --git a/content/docs/configuration.mdx b/content/docs/configuration.mdx index 3da8156b..9cf9be30 100644 --- a/content/docs/configuration.mdx +++ b/content/docs/configuration.mdx @@ -85,7 +85,7 @@ The two tools share most settings, such as `limit`, `sends_per_hour`, `record` a - **Telegram:** [Telegram configuration guide](./tg/configuration.md) · [every Telegram setting, default and environment variable](./tg/configuration-reference.md). - **MAX:** [MAX configuration guide](./max/configuration.md) · [every MAX setting, default and environment variable](./max/configuration-reference.md). -The other tools have their own settings files: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Yandex Disk](./ydisk.mdx#reference), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Bitrix24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) and [Memo](./memo/configuration.md). +The other tools have their own settings files: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Yandex Disk](./ydisk/configuration.md), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Bitrix24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) and [Memo](./memo/configuration.md). ## Profiles and bots diff --git a/content/docs/configuration.ru.mdx b/content/docs/configuration.ru.mdx index c083d688..347912ed 100644 --- a/content/docs/configuration.ru.mdx +++ b/content/docs/configuration.ru.mdx @@ -85,7 +85,7 @@ tg personal config unset limit - **Telegram:** [руководство по настройкам Telegram](./tg/configuration.md) · [все настройки Telegram, значения по умолчанию и переменные окружения](./tg/configuration-reference.md). - **MAX:** [руководство по настройкам MAX](./max/configuration.md) · [все настройки MAX, значения по умолчанию и переменные окружения](./max/configuration-reference.md). -У остальных инструментов свои файлы настроек: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Яндекс Диск](./ydisk.mdx#reference), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Битрикс24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) и [Memo](./memo/configuration.md). +У остальных инструментов свои файлы настроек: [Zoom](./zm/configuration.md), [Google Drive](./drive/configuration.md), [Notion](./notion/configuration.md), [Яндекс Диск](./ydisk/configuration.md), [Google Calendar](./gcal/configuration.md), [Mail](./mail/configuration.md), [Битрикс24](./b24/configuration.md), [amoCRM](./amo/configuration.md), [Asterisk](./pbx/configuration.md) и [Memo](./memo/configuration.md). ## Профили и боты diff --git a/content/docs/features.es.mdx b/content/docs/features.es.mdx index 3916f50b..0d89694e 100644 --- a/content/docs/features.es.mdx +++ b/content/docs/features.es.mdx @@ -115,7 +115,7 @@ Las operaciones de cada servicio, diferencias de compatibilidad y sintaxis exact - **Zoom:** [reuniones](./zm/meetings.md), [uso diario](./zm/usage.md), [búsqueda](./zm/search.md) y [comandos](./zm/commands.md). - **Google Drive:** [uso diario](./drive/usage.md), [búsqueda](./drive/search.md) y [comandos](./drive/commands.md). - **Notion:** [empieza aquí](./notion/index.md), [uso diario](./notion/usage.md), [ajustes y permisos](./notion/configuration.md) y [comandos](./notion/commands.md). -- **Yandex Disk:** [empieza aquí](./ydisk.mdx), [conecta tu agente](./ydisk.mdx#connect-your-agent), [trabaja con archivos en el Disk](./ydisk.mdx#work-with-files-on-the-disk) y [referencia](./ydisk.mdx#reference). +- **Yandex Disk:** [empieza aquí](./ydisk/index.md), [conecta tu agente](./ydisk/mcp.md), [trabaja con archivos en el Disk](./ydisk/usage.md) y [referencia](./ydisk/commands.md). - **Google Calendar:** [uso diario](./gcal/usage.md), [Google Meet](./google-meet.mdx), [escenarios](./gcal/scenarios.md) y [comandos](./gcal/commands.md). - **Mail:** [uso diario](./mail/usage.md), [preparar el buzón](./mail/providers.md) y [comandos](./mail/commands.md). - **Bitrix24:** [uso diario](./b24/usage.md), [ajustes y permisos](./b24/configuration.md) y [comandos](./b24/commands.md). diff --git a/content/docs/features.mdx b/content/docs/features.mdx index 7c2b6216..0cfb1de2 100644 --- a/content/docs/features.mdx +++ b/content/docs/features.mdx @@ -115,7 +115,7 @@ Exact messenger operations, supported differences and command syntax belong in t - **Zoom:** [meetings](./zm/meetings.md), [daily use](./zm/usage.md), [search](./zm/search.md) and [commands](./zm/commands.md). - **Google Drive:** [daily use](./drive/usage.md), [search](./drive/search.md) and [commands](./drive/commands.md). - **Notion:** [start here](./notion/index.md), [daily use](./notion/usage.md), [settings and permissions](./notion/configuration.md) and [commands](./notion/commands.md). -- **Yandex Disk:** [start here](./ydisk.mdx), [connect your agent](./ydisk.mdx#connect-your-agent), [work with files on the Disk](./ydisk.mdx#work-with-files-on-the-disk) and [reference](./ydisk.mdx#reference). +- **Yandex Disk:** [start here](./ydisk/index.md), [connect your agent](./ydisk/mcp.md), [work with files on the Disk](./ydisk/usage.md) and [reference](./ydisk/commands.md). - **Google Calendar:** [daily use](./gcal/usage.md), [Google Meet](./google-meet.mdx), [scenarios](./gcal/scenarios.md) and [commands](./gcal/commands.md). - **Mail:** [daily use](./mail/usage.md), [preparing the mailbox](./mail/providers.md) and [commands](./mail/commands.md). - **Bitrix24:** [daily use](./b24/usage.md), [settings and permissions](./b24/configuration.md) and [commands](./b24/commands.md). diff --git a/content/docs/features.ru.mdx b/content/docs/features.ru.mdx index 895287d4..dcdfb100 100644 --- a/content/docs/features.ru.mdx +++ b/content/docs/features.ru.mdx @@ -115,7 +115,7 @@ Memo также импортирует почту из настроенных а - **Zoom:** [встречи](./zm/meetings.md), [повседневные задачи](./zm/usage.md), [поиск](./zm/search.md) и [команды](./zm/commands.md). - **Google Drive:** [повседневные задачи](./drive/usage.md), [поиск](./drive/search.md) и [команды](./drive/commands.md). - **Notion:** [начните здесь](./notion/index.md), [повседневные задачи](./notion/usage.md), [настройки и разрешения](./notion/configuration.md) и [команды](./notion/commands.md). -- **Яндекс Диск:** [начните здесь](./ydisk.mdx), [подключите агента](./ydisk.mdx#connect-your-agent), [работа с файлами на Диске](./ydisk.mdx#work-with-files-on-the-disk) и [справочник](./ydisk.mdx#reference). +- **Яндекс Диск:** [начните здесь](./ydisk/index.md), [подключите агента](./ydisk/mcp.md), [работа с файлами на Диске](./ydisk/usage.md) и [справочник](./ydisk/commands.md). - **Google Calendar:** [повседневные задачи](./gcal/usage.md), [Google Meet](./google-meet.mdx), [сценарии](./gcal/scenarios.md) и [команды](./gcal/commands.md). - **Mail:** [повседневные задачи](./mail/usage.md), [подготовка ящика](./mail/providers.md) и [команды](./mail/commands.md). - **Битрикс24:** [повседневные задачи](./b24/usage.md), [настройки и права](./b24/configuration.md) и [команды](./b24/commands.md). diff --git a/content/docs/index.es.mdx b/content/docs/index.es.mdx index 7dd4b687..79b3f012 100644 --- a/content/docs/index.es.mdx +++ b/content/docs/index.es.mdx @@ -40,7 +40,7 @@ Elige la fila que coincide con tu objetivo. Puedes combinar herramientas más ad | Responder una pregunta con Google Docs, Sheets o PDF | `drive` | [Conectar Google Drive](./drive/installation.md) | | Responder una pregunta con tus páginas y bases de datos de Notion | `notion` | [Conectar Notion](./notion/index.md) | | Buscar en tus notas Markdown o tu bóveda de Obsidian | `memo` | [Markdown y Obsidian](./markdown.mdx) | -| Responder una pregunta con archivos de Yandex Disk, o subirlos, moverlos y compartirlos | `ydisk` | [Conectar Yandex Disk](./ydisk.mdx) | +| Responder una pregunta con archivos de Yandex Disk, o subirlos, moverlos y compartirlos | `ydisk` | [Conectar Yandex Disk](./ydisk/index.md) | | Preparar las reuniones de mañana | `gcal` | [Conectar Google Calendar](./gcal/installation.md) | | Leer lo que se dijo en una llamada de Zoom, trabajar con su transcripción y grabación | `zm` | [Conectar Zoom](./zm/installation.md) | | Guardar tus llamadas de Google Meet con quién se unió y la transcripción | `gcal` | [Google Meet](./google-meet.mdx) | diff --git a/content/docs/index.mdx b/content/docs/index.mdx index 1c1f5092..e5227b4d 100644 --- a/content/docs/index.mdx +++ b/content/docs/index.mdx @@ -37,7 +37,7 @@ Pick the row that matches your goal. Tools can be combined later; start with one | Answer a question from Google Docs, Sheets or PDF files | `drive` | [Connect Google Drive](./drive/installation.md) | | Answer a question from your Notion pages and databases | `notion` | [Connect Notion](./notion/index.md) | | Search your Markdown notes or Obsidian vault | `memo` | [Markdown and Obsidian](./markdown.mdx) | -| Answer a question from files on Yandex Disk, or upload, move and share them | `ydisk` | [Connect Yandex Disk](./ydisk.mdx) | +| Answer a question from files on Yandex Disk, or upload, move and share them | `ydisk` | [Connect Yandex Disk](./ydisk/index.md) | | Prepare for tomorrow's meetings | `gcal` | [Connect Google Calendar](./gcal/installation.md) | | Read what was said on a Zoom call, or work with its transcript and recording | `zm` | [Connect Zoom](./zm/installation.md) | | Keep your Google Meet calls with who joined and the transcript | `gcal` | [Google Meet](./google-meet.mdx) | diff --git a/content/docs/index.ru.mdx b/content/docs/index.ru.mdx index e33aec1f..7b83d5e6 100644 --- a/content/docs/index.ru.mdx +++ b/content/docs/index.ru.mdx @@ -40,7 +40,7 @@ description: "Документация WireCat: дайте Claude Code, Codex и | Ответить на вопрос по Google Docs, Sheets или PDF | `drive` | [Подключить Google Drive](./drive/installation.md) | | Ответить на вопрос по страницам и базам данных Notion | `notion` | [Подключить Notion](./notion/index.md) | | Искать по заметкам Markdown или хранилищу Obsidian | `memo` | [Markdown и Obsidian](./markdown.mdx) | -| Ответить на вопрос по файлам на Яндекс Диске, загрузить, переместить файлы или поделиться ими | `ydisk` | [Подключить Яндекс Диск](./ydisk.mdx) | +| Ответить на вопрос по файлам на Яндекс Диске, загрузить, переместить файлы или поделиться ими | `ydisk` | [Подключить Яндекс Диск](./ydisk/index.md) | | Подготовиться к завтрашним встречам | `gcal` | [Подключить Google Calendar](./gcal/installation.md) | | Узнать, что говорили на звонке в Zoom, работать с расшифровкой и записью | `zm` | [Подключить Zoom](./zm/installation.md) | | Хранить звонки Google Meet: кто подключился и расшифровку | `gcal` | [Google Meet](./google-meet.mdx) | diff --git a/content/docs/installation.es.mdx b/content/docs/installation.es.mdx index ce228e41..fbe17312 100644 --- a/content/docs/installation.es.mdx +++ b/content/docs/installation.es.mdx @@ -55,7 +55,7 @@ las herramientas y abre el inicio de sesión de cada una. [Qué hace la aplicaci | Chats de MAX | [Instalar MAX](./max/installation.md); para un bot, usa [su configuración](./max/bot.md) | | Documentos de Google Drive | [Instalar Drive](./drive/installation.md) desde npm, conectar Google y elegir una carpeta | | Páginas y bases de datos de Notion | [Instalar Notion](./notion/installation.md) desde npm, luego [iniciar sesión con un token de Notion y copiar tus páginas](./notion/index.md#conecta-y-copia-tus-páginas) | -| Archivos de Yandex Disk | [Instalar Yandex Disk](./ydisk.mdx#install-and-sign-in) desde npm, luego iniciar sesión con un token de Yandex y [copiar una carpeta](./ydisk.mdx#copy-a-folder-and-search-it) | +| Archivos de Yandex Disk | [Instalar Yandex Disk](./ydisk/installation.md) desde npm, luego iniciar sesión con un token de Yandex y [copiar una carpeta](./ydisk/usage.md#sync) | | Reuniones de Google Calendar | [Instalar Google Calendar](./gcal/installation.md) desde npm e iniciar sesión en Google con la aplicación de Google de WireCat, o con la tuya | | Correo por IMAP | [Instalar Mail](./mail/installation.md) desde npm y crear antes una contraseña de aplicación para tu buzón | | Reuniones o transcripciones de Zoom | [Instalar Zoom](./zm/installation.md); conectar una aplicación existente/nueva o importar VTT sin ella | diff --git a/content/docs/installation.mdx b/content/docs/installation.mdx index a733e9e8..16baccab 100644 --- a/content/docs/installation.mdx +++ b/content/docs/installation.mdx @@ -54,7 +54,7 @@ skills and opens each tool's sign-in. [What the app does](./desktop/index.mdx). | MAX chats | [Install MAX](./max/installation.md); for a bot, use [bot setup](./max/bot.md) | | Google Drive documents | [Install Drive](./drive/installation.md) from npm, connect Google and choose a folder | | Notion pages and databases | [Install Notion](./notion/installation.md) from npm, then [sign in with a Notion token and copy your pages](./notion/index.md#connect-and-copy-your-pages) | -| Yandex Disk files | [Install Yandex Disk](./ydisk.mdx#install-and-sign-in) from npm, then sign in with a Yandex token and [copy a folder](./ydisk.mdx#copy-a-folder-and-search-it) | +| Yandex Disk files | [Install Yandex Disk](./ydisk/installation.md) from npm, then sign in with a Yandex token and [copy a folder](./ydisk/usage.md#sync) | | Google Calendar meetings | [Install Google Calendar](./gcal/installation.md) from npm and sign in to Google through WireCat's Google app, or your own | | Email over IMAP | [Install Mail](./mail/installation.md) from npm, then make an app password for your mailbox | | Zoom meetings or transcripts | [Install Zoom](./zm/installation.md); connect an existing/new app or import VTT files without one | diff --git a/content/docs/installation.ru.mdx b/content/docs/installation.ru.mdx index c8af2904..e6228f8d 100644 --- a/content/docs/installation.ru.mdx +++ b/content/docs/installation.ru.mdx @@ -55,7 +55,7 @@ Linux. Оно устанавливает и обновляет эти инстр | Чаты MAX | [Установить MAX](./max/installation.md); для бота — [настройка бота](./max/bot.md) | | Документы Google Диска | [Установить Drive](./drive/installation.md) из npm, подключить Google и выбрать папку | | Страницы и базы данных Notion | [Установить Notion](./notion/installation.md) из npm, затем [войти с токеном Notion и скопировать страницы](./notion/index.md#подключите-и-скопируйте-страницы) | -| Файлы на Яндекс Диске | [Установить Яндекс Диск](./ydisk.mdx#install-and-sign-in) из npm, затем войти с токеном Яндекса и [скопировать папку](./ydisk.mdx#copy-a-folder-and-search-it) | +| Файлы на Яндекс Диске | [Установить Яндекс Диск](./ydisk/installation.md) из npm, затем войти с токеном Яндекса и [скопировать папку](./ydisk/usage.md#sync) | | Встречи Google Календаря | [Установить Google Calendar](./gcal/installation.md) из npm и войти в Google через приложение Google от WireCat или своё | | Почта по IMAP | [Установить Mail](./mail/installation.md) из npm, затем создать пароль приложения для ящика | | Встречи или расшифровки Zoom | [Установить Zoom](./zm/installation.md); подключить существующее/новое приложение или импортировать VTT без него | diff --git a/content/docs/roadmap.es.md b/content/docs/roadmap.es.md index 7c5cda3b..cb94a2c6 100644 --- a/content/docs/roadmap.es.md +++ b/content/docs/roadmap.es.md @@ -28,7 +28,7 @@ decidimos qué viene después. en la búsqueda junto a tus mensajes. - **[Notion](./notion/index.md)**: tus páginas y bases de datos de Notion en tu ordenador, en la búsqueda sin conexión junto a tus mensajes. -- **[Yandex Disk](./ydisk.mdx)**: el texto de las carpetas del Disk que elijas en tu ordenador, en la búsqueda sin +- **[Yandex Disk](./ydisk/index.md)**: el texto de las carpetas del Disk que elijas en tu ordenador, en la búsqueda sin conexión, y los archivos del Disk subidos, movidos y compartidos cuando lo permitas. - **[amoCRM y Kommo](./amo/index.md)**: tus negociaciones y sus clientes en tu ordenador, con lo que cambió desde ayer, en la búsqueda junto a tus mensajes. @@ -104,6 +104,7 @@ la búsqueda por palabras. Consulta [cómo funciona la búsqueda](./search-archi - [Hoja de ruta de Mail](./mail/roadmap.md) - [Hoja de ruta de Bitrix24](./b24/roadmap.md) - [Hoja de ruta de amoCRM](./amo/roadmap.md) +- [Hoja de ruta de Yandex Disk](./ydisk/roadmap.md) - [Hoja de ruta de Asterisk](./pbx/roadmap.md) - [Hoja de ruta de Memo](./memo/roadmap.md) - [Hoja de ruta de WhatsApp](./wa/roadmap.md) diff --git a/content/docs/roadmap.md b/content/docs/roadmap.md index bf0407b2..e4cf9a9f 100644 --- a/content/docs/roadmap.md +++ b/content/docs/roadmap.md @@ -27,7 +27,7 @@ what comes next. and searchable next to your messages. - **[Notion](./notion/index.md)**: your Notion pages and databases on your computer, searchable offline next to your messages. -- **[Yandex Disk](./ydisk.mdx)**: the text of the Disk folders you choose on your computer, searchable offline, +- **[Yandex Disk](./ydisk/index.md)**: the text of the Disk folders you choose on your computer, searchable offline, and the files on the Disk listed, uploaded, moved and shared when you allow it. - **[amoCRM and Kommo](./amo/index.md)**: your own deals and their clients on your computer, with what changed since yesterday, searchable next to your messages. @@ -97,6 +97,7 @@ search. See [how search works](./search-architecture.mdx). Next it gets better a - [Mail roadmap](./mail/roadmap.md) - [Bitrix24 roadmap](./b24/roadmap.md) - [amoCRM roadmap](./amo/roadmap.md) +- [Yandex Disk roadmap](./ydisk/roadmap.md) - [Asterisk roadmap](./pbx/roadmap.md) - [Memo roadmap](./memo/roadmap.md) - [WhatsApp roadmap](./wa/roadmap.md) diff --git a/content/docs/roadmap.ru.md b/content/docs/roadmap.ru.md index b63939df..698a52b0 100644 --- a/content/docs/roadmap.ru.md +++ b/content/docs/roadmap.ru.md @@ -26,7 +26,7 @@ WireCat собирает ваш контекст в одном месте. Со доступные в поиске рядом с сообщениями. - **[Notion](./notion/index.md)**: ваши страницы и базы данных Notion на компьютере, в поиске без интернета рядом с сообщениями. -- **[Яндекс Диск](./ydisk.mdx)**: текст выбранных папок Диска на компьютере, в поиске без интернета, а файлы на +- **[Яндекс Диск](./ydisk/index.md)**: текст выбранных папок Диска на компьютере, в поиске без интернета, а файлы на Диске можно загружать, перемещать и публиковать по ссылке, когда вы это разрешите. - **[amoCRM и Kommo](./amo/index.md)**: ваши сделки и их клиенты на компьютере, с тем, что поменялось со вчера, в поиске рядом с сообщениями. @@ -99,6 +99,7 @@ WireCat собирает ваш контекст в одном месте. Со - [Планы Mail](./mail/roadmap.md) - [Планы Битрикс24](./b24/roadmap.md) - [Планы amoCRM](./amo/roadmap.md) +- [Планы Яндекс Диска](./ydisk/roadmap.md) - [Планы Asterisk](./pbx/roadmap.md) - [Планы Memo](./memo/roadmap.md) - [Планы WhatsApp](./wa/roadmap.md) diff --git a/content/docs/ydisk.es.mdx b/content/docs/ydisk.es.mdx deleted file mode 100644 index ccf50a8a..00000000 --- a/content/docs/ydisk.es.mdx +++ /dev/null @@ -1,193 +0,0 @@ ---- -title: "Yandex Disk" -description: "Busca en el texto de tus carpetas de Yandex Disk en tu ordenador y deja que tu agente de IA lea, archive y comparta documentos allí con la línea de comandos o MCP." ---- - -Encuentra cualquier documento de tu Yandex Disk por lo que dice y deja que tu agente de IA lo lea, lo archive y lo -comparta por ti. La herramienta de línea de comandos `ydisk` copia a tu ordenador el texto de las carpetas del Disk -que elijas, así que una búsqueda de «contrato de alquiler» encuentra el PDF aunque se llame `scan_0042.pdf`, e incluso -sin internet. - -Pregunta a tu agente dónde está el contrato con un cliente y qué condiciones de pago tiene. Te responde con la cita y -la ruta del archivo en el Disk. Pídele que mueva las facturas del año pasado a un archivo o que cree un enlace para un -colega, y lo hace en el Disk, preguntándote antes de borrar o de crear un enlace público. - -`ydisk` funciona con Claude Code, Codex y otros agentes que ejecutan comandos, con Claude Desktop y Cursor por MCP, y -con ChatGPT y Claude en el navegador a través de tu propio túnel. Necesita Node.js y un token OAuth de Yandex: una -clave de tu propia cuenta de Yandex con la que la herramienta usa tu Disk. - -**En esta página:** - -1. [Cómo funciona](#how-it-works) -2. [Instalar e iniciar sesión](#install-and-sign-in) -3. [Copia una carpeta y busca en ella](#copy-a-folder-and-search-it) -4. [Conecta tu agente](#connect-your-agent) -5. [Trabaja con archivos en el Disk](#work-with-files-on-the-disk) -6. [Límites](#limits) -7. [Si algo no funciona](#if-something-goes-wrong) -8. [Referencia](#reference) - - - -## Cómo funciona - -- **Una copia del texto en tu ordenador.** `ydisk` lee las carpetas que eliges y guarda el texto de sus archivos en el - almacén local, un archivo de base de datos en tu ordenador que comparten todas las herramientas de WireCat. La - búsqueda lee esta copia, no el Disk, y encuentra otras formas de una palabra en ruso y en inglés. -- **Solo las carpetas que eliges.** Yandex Disk no dice a la herramienta qué cambió, así que cada sincronización vuelve - a listar todas las carpetas elegidas con sus subcarpetas y descarga solo los archivos cuyo contenido cambió. Elige - carpetas con documentos, no todo el Disk. -- **Texto, no copias de archivos.** La herramienta lee Markdown, texto plano, PDF con capa de texto, Word `.docx`, - Excel `.xlsx`, CSV y TSV. Las fotos y los demás archivos se guardan solo por su nombre. Los archivos se quedan en el - Disk. -- **Un perfil por cuenta.** Un perfil es el nombre que eliges para una cuenta de Yandex, como `personal` o `work`. - Cada comando que usa una cuenta empieza por él: `ydisk personal search budget`. -- **Los comandos `files` cambian el Disk.** Trabajan directamente con Yandex. Borrar mueve el archivo a la papelera del - Disk. En una terminal la herramienta pregunta antes de borrar, sobrescribir o crear un enlace público. - - - -## Instalar e iniciar sesión - -1. Instala la herramienta desde npm y compruébala. Necesitas Node.js 22.16 o un 22.x posterior, o 24 o posterior. - -```sh -npm install -g @wirecat/yandex-disk-cli -ydisk --version -ydisk doctor -``` - -2. Registra una aplicación en Yandex para obtener un token. La aplicación es solo un nombre y una lista de permisos en - tu cuenta, y no se publica nada. Las páginas de Yandex están en ruso, así que sus textos se dan también en ruso - ([guía de Yandex](https://yandex.ru/dev/disk-api/doc/ru/concepts/quickstart)): - - Abre [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new/) e inicia sesión con la cuenta cuyo Disk - quieres usar. Si Yandex pregunta el tipo de aplicación, elige «Для доступа к API или отладки» (para acceso a la - API o depuración). - - Escribe cualquier nombre y tu correo. En «Доступ к данным» (acceso a los datos) añade los permisos de Yandex Disk - `cloud_api:disk.read`, `cloud_api:disk.info` y, para cambiar archivos, `cloud_api:disk.write`. - - Crea la aplicación y copia su **ClientID** de la página de la aplicación. - -3. Abre `https://oauth.yandex.ru/authorize?response_type=token&client_id=` añadiendo tu ClientID al final, permite el - acceso y copia el token de la página. Guárdalo como una contraseña. - -4. Inicia sesión con el nombre de perfil que elijas. La herramienta pide el token con entrada oculta, lo comprueba - con Yandex y lo guarda en el llavero del sistema, o en un archivo privado donde no hay llavero. - -```sh -ydisk personal session start -ydisk personal session status --check -``` - -Yandex mantiene válido el token durante meses mientras se usa. Cuando Yandex deje de aceptarlo, consigue uno nuevo -igual y vuelve a ejecutar `session start`. - -`ydisk personal session end` quita el token de este ordenador. - - - -## Copia una carpeta y busca en ella - -`folders browse` muestra el Disk un nivel cada vez, para elegir una carpeta por su ruta: - -```sh -ydisk personal folders browse -ydisk personal folders add /Documents -ydisk personal sync -ydisk personal search "presupuesto trimestral" -``` - -Una sincronización lee hasta 200 archivos (`--limit`), recorre hasta unas 10 000 entradas y recuerda dónde se detuvo. -Ejecútala otra vez para seguir y, más adelante, para traer lo que cambió. Nada se sincroniza en segundo plano. -`ydisk personal status` muestra la última sincronización, el trabajo pendiente y los archivos guardados solo por su -nombre. `documents show` imprime el texto completo de un archivo encontrado por la búsqueda. - -La búsqueda por significado encuentra un documento que responde a una pregunta con otras palabras. Necesita un modelo de -texto que se descarga una vez con [Memo](./memo/installation.md), `memo models download embeddinggemma`, y después -`ydisk personal sync --embed`. - - - -## Conecta tu agente - -Un agente de terminal como Claude Code o Codex recibe la guía de la herramienta: - -```sh -ydisk skill install -``` - -Después pídele las cosas con palabras normales: - -```text prompt -Usa ydisk CLI con el perfil personal. Busca en mis carpetas del Disk el contrato con Harbour Ltd. -Cita las condiciones de pago y dame la ruta del archivo en el Disk. No cambies ningún archivo. -``` - -El agente busca primero en la copia local. Un archivo fuera de las carpetas elegidas lo lee en directo del Disk. - -Para añadir la herramienta como servidor MCP, `ydisk personal mcp add claude-code --allow-writes` (o `codex`) lo hace -con un solo comando. Para Claude Desktop, Cursor y otras aplicaciones MCP, `ydisk personal mcp config` imprime la -entrada que debes pegar en los ajustes de la aplicación. Para ChatGPT y Claude en el navegador, mira las -[aplicaciones del navegador](./browser-apps.mdx). - - - -## Trabaja con archivos en el Disk - -```sh -ydisk personal files list --folder /Documents -ydisk personal files download /Documents/plan.pdf --output ./plan.pdf -ydisk personal files upload ./notes.md --folder /Documents -ydisk personal files move /Documents/old.pdf --folder /Archive -ydisk personal files delete /Documents/old.pdf -ydisk personal files publish /Documents/plan.pdf -``` - -`files delete` mueve el archivo a la papelera del Disk, y `files restore` lo devuelve. `files publish` crea un enlace -que puede abrir cualquiera que lo tenga. En una terminal la herramienta pregunta antes de borrar, de sobrescribir con -`--replace` o de crear un enlace público. Por MCP no hay a quién preguntar, así que para un agente que no debe hacerlo, -cierra esos permisos: - -```sh -ydisk personal config set permissions.files.delete deny -ydisk personal config set permissions.files.share deny -``` - -`YDISK_READ_ONLY=1` rechaza cualquier cambio. `--dry-run` en cualquier cambio muestra lo que haría sin hacerlo. - - - -## Límites - -- Los PDF escaneados y las imágenes no tienen texto que buscar. Los archivos de más de 50 MB se guardan solo por su - nombre. -- Una carpeta elegida que renombras o mueves en el Disk deja de sincronizarse y sus copias salen del almacén. Vuelve a - añadirla con su nueva ruta. -- El inicio de sesión es con un token pegado de una aplicación que registras tú. Todavía no hay inicio de sesión en el - navegador. - - - -## Si algo no funciona - -- **«refused the token», código de salida 4.** El token es incorrecto, está revocado o caducó. Consigue uno nuevo y - vuelve a ejecutar `session start`. -- **Un cambio falla con el código de salida 5.** El token se creó sin `cloud_api:disk.write`, o los permisos del perfil - rechazan el cambio. -- **La búsqueda no encuentra un archivo que sabes que está.** Comprueba que su carpeta aparece en `folders list`, - ejecuta `sync` hasta que `status` no muestre trabajo pendiente y mira si `status` lo lista como guardado solo por su - nombre. -- **«the OS keyring did not answer» en Linux.** Cierra la sesión y vuelve a entrar, o inicia sesión con - `ydisk personal session start --credential-storage file`. - -`ydisk doctor` muestra lo que está configurado sin conectarse, y `ydisk personal doctor --online` comprueba el token. -Hay más casos en la [página de problemas](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/troubleshooting.md). - - - -## Referencia - -Todos los comandos y opciones: [comandos](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/commands.md). Ajustes y -permisos: [ajustes](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/configuration.md). Qué llega al disco y a la -red: [seguridad](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/security.md). La referencia está en inglés. - -Siguiente: [dale también a tu agente una carpeta de notas en Markdown](./markdown.mdx). diff --git a/content/docs/ydisk.mdx b/content/docs/ydisk.mdx deleted file mode 100644 index 584625e4..00000000 --- a/content/docs/ydisk.mdx +++ /dev/null @@ -1,169 +0,0 @@ ---- -title: "Yandex Disk" -description: "Search the text of your Yandex Disk folders on your computer, and let your AI agent read, file and share documents there through a command line or MCP." ---- - -Find any document on your Yandex Disk by what it says, and let your AI agent read it, file it and share it for you. -The `ydisk` command-line tool copies the text of the Disk folders you choose to your computer, so a search for -"lease" finds the PDF even when its file name is `scan_0042.pdf`, and even without the internet. - -Ask your agent where the contract with a client is and what its payment terms are. It answers with the quote and the -file's path on the Disk. Ask it to move last year's invoices to an archive or to make a link for a colleague, and it -does that on the Disk, asking first before a delete or a public link. - -`ydisk` works with Claude Code, Codex and other agents that run commands, with Claude Desktop and Cursor through MCP, -and with ChatGPT and Claude in the browser through your own tunnel. It needs Node.js and a Yandex OAuth token, a key -from your own Yandex account that lets the tool use your Disk. - -**On this page:** - -1. [How it works](#how-it-works) -2. [Install and sign in](#install-and-sign-in) -3. [Copy a folder and search it](#copy-a-folder-and-search-it) -4. [Connect your agent](#connect-your-agent) -5. [Work with files on the Disk](#work-with-files-on-the-disk) -6. [Limits](#limits) -7. [If something goes wrong](#if-something-goes-wrong) -8. [Reference](#reference) - -## How it works - -- **A copy of the text on your computer.** `ydisk` reads the folders you choose and saves the text of their files in - the local store, one database file on your computer that every WireCat tool shares. Search reads this copy, not the - Disk, and finds other forms of a word in Russian and English. -- **Only the folders you choose.** Yandex Disk does not tell a tool what changed, so each sync lists every chosen - folder and its subfolders again and downloads only the files whose content changed. Choose the folders with - documents, not the whole Disk. -- **Text, not copies of files.** The tool reads Markdown, plain text, PDF with a text layer, Word `.docx`, Excel - `.xlsx`, CSV and TSV. Photos and other files are kept by name. The files themselves stay on the Disk. -- **A profile for each account.** A profile is a name you choose for one Yandex account, such as `personal` or `work`. - Every command that uses an account names it first: `ydisk personal search budget`. -- **Live commands change the Disk.** `files` commands go to Yandex directly. Deleting moves a file to the Disk's trash. - At a terminal the tool asks before it deletes, overwrites or makes a public link. - -## Install and sign in - -1. Install the tool from npm and check it. You need Node.js 22.16 or a later 22.x, or 24 or later. - -```sh -npm install -g @wirecat/yandex-disk-cli -ydisk --version -ydisk doctor -``` - -2. Register an app in Yandex to get a token. The app is only a name and a list of rights in your account, and nothing - is published. Yandex's pages are in Russian, so their labels are given in Russian too - ([Yandex's guide](https://yandex.ru/dev/disk-api/doc/en/concepts/quickstart)): - - Open [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new/) and sign in with the account whose Disk - you want to use. If Yandex asks for the app type, choose «Для доступа к API или отладки» (for API access or - debugging). - - Enter any name and your email. Under «Доступ к данным» (data access) add the Yandex Disk rights - `cloud_api:disk.read`, `cloud_api:disk.info` and, to change files, `cloud_api:disk.write`. - - Create the app and copy its **ClientID** from the app's page. - -3. Open `https://oauth.yandex.ru/authorize?response_type=token&client_id=` with your ClientID added at the very end, - allow access and copy the token from the page. Keep it like a password. - -4. Sign in under a profile name you choose. The tool asks for the token with hidden input, checks it with Yandex and - keeps it in the system keyring, or in a private file where there is no keyring. - -```sh -ydisk personal session start -ydisk personal session status --check -``` - -Yandex keeps a token valid for months while it is used. When Yandex stops accepting it, get a new one the same way -and run `session start` again. - -`ydisk personal session end` removes the token from this computer. - -## Copy a folder and search it - -`folders browse` shows the Disk one level at a time, so you can pick a folder by its path: - -```sh -ydisk personal folders browse -ydisk personal folders add /Documents -ydisk personal sync -ydisk personal search "quarterly budget" -``` - -One sync reads up to 200 files (`--limit`), walks up to about 10,000 entries and saves where it stopped. Run it -again to go on, and later to bring in what changed. Nothing syncs in the background. `ydisk personal status` shows the -last sync, the pending work and the files kept by name only. `documents show` prints the whole text of one file found -by search. - -Search by meaning finds a document that answers a question in other words. It needs a text model downloaded once -with [Memo](./memo/installation.md), `memo models download embeddinggemma`, and then `ydisk personal sync --embed`. - -## Connect your agent - -A terminal agent such as Claude Code or Codex gets the tool's skill: - -```sh -ydisk skill install -``` - -Then ask in plain words: - -```text prompt -Use ydisk CLI with profile personal. Find the contract with Harbour Ltd in my Disk folders. -Quote the payment terms and give me the file's path on the Disk. Do not change any files. -``` - -The agent searches the local copy first. A file outside the chosen folders it reads live from the Disk. - -To add the tool as an MCP server, `ydisk personal mcp add claude-code --allow-writes` (or `codex`) does it in one -command. For Claude Desktop, Cursor and other MCP apps, `ydisk personal mcp config` prints the entry to paste into -the app's settings. For ChatGPT and Claude in the browser, see [browser apps](./browser-apps.mdx). - -## Work with files on the Disk - -```sh -ydisk personal files list --folder /Documents -ydisk personal files download /Documents/plan.pdf --output ./plan.pdf -ydisk personal files upload ./notes.md --folder /Documents -ydisk personal files move /Documents/old.pdf --folder /Archive -ydisk personal files delete /Documents/old.pdf -ydisk personal files publish /Documents/plan.pdf -``` - -`files delete` moves the file to the Disk's trash, and `files restore` brings it back. `files publish` makes a link -that anyone who has it can open. At a terminal the tool asks before a delete, an overwrite with `--replace` or a public -link. Over MCP there is no one to ask, so for an agent that must not do these, set the permissions: - -```sh -ydisk personal config set permissions.files.delete deny -ydisk personal config set permissions.files.share deny -``` - -`YDISK_READ_ONLY=1` refuses every change. `--dry-run` on any change shows what it would do without doing it. - -## Limits - -- Scanned PDFs and pictures have no text to search. Files over 50 MB are kept by name only. -- A chosen folder that you rename or move on the Disk stops syncing and its copies leave the store. Add it again under - its new path. -- Sign-in is by a pasted token from an app you register. There is no sign-in in the browser yet. - -## If something goes wrong - -- **"refused the token", exit code 4**: the token is wrong, revoked or expired. Get a new one and run `session start` - again. -- **A change fails with exit code 5**: the token was made without `cloud_api:disk.write`, or the profile's permissions - refuse the change. -- **Search does not find a file you know is there**: check that its folder is in `folders list`, run `sync` again - until `status` shows no pending work, and check whether `status` lists the file as kept by name only. -- **"the OS keyring did not answer" on Linux**: log out and back in, or sign in with - `ydisk personal session start --credential-storage file`. - -`ydisk doctor` shows what is set up without connecting, and `ydisk personal doctor --online` checks the token. More -cases are on the [troubleshooting page](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/troubleshooting.md). - -## Reference - -Every command and option: [commands](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/commands.md). Settings and -permissions: [settings](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/configuration.md). What reaches the disk and -the network: [security](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/security.md). - -Next: [give your agent a folder of Markdown notes too](./markdown.mdx). diff --git a/content/docs/ydisk.ru.mdx b/content/docs/ydisk.ru.mdx deleted file mode 100644 index d2719d14..00000000 --- a/content/docs/ydisk.ru.mdx +++ /dev/null @@ -1,186 +0,0 @@ ---- -title: "Яндекс Диск" -description: "Ищите по тексту папок Яндекс Диска на своем компьютере и поручите ИИ-агенту читать, раскладывать и отправлять документы через командную строку или MCP." ---- - -Находите любой документ на Яндекс Диске по тому, что в нем написано, и поручите ИИ-агенту читать, раскладывать и -отправлять файлы за вас. Инструмент командной строки `ydisk` копирует на ваш компьютер текст выбранных папок Диска. -Поиск по словам «договор аренды» найдет PDF, даже если файл называется `scan_0042.pdf`, и даже без интернета. - -Спросите агента, где договор с клиентом и какие в нем условия оплаты. Он ответит цитатой и путем к файлу на Диске. -Попросите перенести прошлогодние счета в архив или сделать ссылку для коллеги, и он сделает это на Диске, а перед -удалением или публичной ссылкой сначала спросит. - -`ydisk` работает с Claude Code, Codex и другими агентами, которые запускают команды, с Claude Desktop и Cursor через -MCP, а с ChatGPT и Claude в браузере через ваш собственный туннель. Нужны Node.js и OAuth-токен Яндекса: ключ из -вашего аккаунта Яндекса, который дает инструменту доступ к вашему Диску. - -**На этой странице:** - -1. [Как это устроено](#how-it-works) -2. [Установка и вход](#install-and-sign-in) -3. [Скопируйте папку и ищите по ней](#copy-a-folder-and-search-it) -4. [Подключите агента](#connect-your-agent) -5. [Работа с файлами на Диске](#work-with-files-on-the-disk) -6. [Ограничения](#limits) -7. [Если что-то не работает](#if-something-goes-wrong) -8. [Справочник](#reference) - - - -## Как это устроено - -- **Копия текста на вашем компьютере.** `ydisk` читает выбранные папки и сохраняет текст их файлов в локальном - хранилище. Это один файл базы данных на вашем компьютере, общий для всех инструментов WireCat. Поиск читает эту - копию, а не Диск, и находит слово в любой форме: по запросу «договор» найдутся и «договора», и «договоре». -- **Только выбранные папки.** Яндекс Диск не сообщает, что изменилось, поэтому каждая синхронизация заново - перечисляет все выбранные папки с вложенными и скачивает только файлы, содержимое которых изменилось. Выбирайте - папки с документами, а не весь Диск. -- **Текст, а не копии файлов.** Инструмент читает Markdown, обычный текст, PDF с текстовым слоем, Word `.docx`, Excel - `.xlsx`, CSV и TSV. Фото и остальные файлы сохраняются только по имени. Сами файлы остаются на Диске. -- **Профиль для каждого аккаунта.** Профиль означает имя, которое вы даете одному аккаунту Яндекса, например - `personal` или `work`. Каждая команда для аккаунта начинается с него: `ydisk personal search budget`. -- **Команды `files` меняют Диск.** Они работают с Яндексом напрямую. Удаление переносит файл в корзину Диска. В - терминале инструмент спрашивает перед удалением, перезаписью или публичной ссылкой. - - - -## Установка и вход - -1. Установите инструмент из npm и проверьте его. Нужен Node.js 22.16 или новее в ветке 22.x либо 24 и новее. - -```sh -npm install -g @wirecat/yandex-disk-cli -ydisk --version -ydisk doctor -``` - -2. Зарегистрируйте приложение в Яндексе, чтобы получить токен. Приложение здесь означает только название и список - прав в вашем аккаунте, ничего не публикуется ([инструкция Яндекса](https://yandex.ru/dev/disk-api/doc/ru/concepts/quickstart)): - - Откройте [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new/) и войдите в аккаунт, с Диском - которого хотите работать. Если Яндекс спросит тип приложения, выберите «Для доступа к API или отладки». - - Укажите любое название и свою почту. В разделе «Доступ к данным» добавьте права Яндекс Диска: «Чтение всего - Диска» (`cloud_api:disk.read`), «Доступ к информации о Диске» (`cloud_api:disk.info`) и, чтобы менять файлы, - «Запись в любом месте на Диске» (`cloud_api:disk.write`). - - Создайте приложение и скопируйте его **ClientID** со страницы приложения. - -3. Откройте адрес `https://oauth.yandex.ru/authorize?response_type=token&client_id=`, добавив ClientID в самый - конец, разрешите доступ и скопируйте токен со страницы. Храните его как пароль. - -4. Войдите под именем профиля, которое выберете сами. Инструмент спросит токен скрытым вводом, проверит его у Яндекса - и сохранит в системной связке ключей, а там, где ее нет, в закрытом файле. - -```sh -ydisk personal session start -ydisk personal session status --check -``` - -Яндекс продлевает токен на месяцы, пока им пользуются. Когда Яндекс перестанет его принимать, получите новый так же -и снова выполните `session start`. - -`ydisk personal session end` удаляет токен с этого компьютера. - - - -## Скопируйте папку и ищите по ней - -`folders browse` показывает Диск по одному уровню, чтобы выбрать папку по ее пути: - -```sh -ydisk personal folders browse -ydisk personal folders add /Documents -ydisk personal sync -ydisk personal search "договор аренды" -``` - -Одна синхронизация читает до 200 файлов (`--limit`), проходит примерно до 10 000 элементов и запоминает, где -остановилась. Запустите ее снова, чтобы продолжить, а позже, чтобы получить изменения. В фоне ничего не -синхронизируется. `ydisk personal status` показывает последнюю синхронизацию, оставшуюся работу и файлы, которые -сохранены только по имени. `documents show` выводит весь текст одного найденного файла. - -Поиск по смыслу находит документ, который отвечает на вопрос другими словами. Для него один раз скачайте текстовую -модель через [Memo](./memo/installation.md) командой `memo models download embeddinggemma`, а затем выполните -`ydisk personal sync --embed`. - - - -## Подключите агента - -Терминальный агент, например Claude Code или Codex, получает навык инструмента: - -```sh -ydisk skill install -``` - -Дальше просите обычными словами: - -```text prompt -Используй ydisk CLI с профилем personal. Найди в моих папках на Диске договор с Harbour Ltd. -Процитируй условия оплаты и назови путь к файлу на Диске. Ничего не меняй в файлах. -``` - -Сначала агент ищет в локальной копии. Файл вне выбранных папок он читает прямо с Диска. - -Чтобы подключить инструмент как MCP-сервер, выполните `ydisk personal mcp add claude-code --allow-writes` (или -`codex`). Для Claude Desktop, Cursor и других MCP-приложений `ydisk personal mcp config` выводит запись, которую нужно -вставить в настройки приложения. Для ChatGPT и Claude в браузере смотрите [браузерные приложения](./browser-apps.mdx). - - - -## Работа с файлами на Диске - -```sh -ydisk personal files list --folder /Documents -ydisk personal files download /Documents/plan.pdf --output ./plan.pdf -ydisk personal files upload ./notes.md --folder /Documents -ydisk personal files move /Documents/old.pdf --folder /Archive -ydisk personal files delete /Documents/old.pdf -ydisk personal files publish /Documents/plan.pdf -``` - -`files delete` переносит файл в корзину Диска, а `files restore` возвращает его. `files publish` создает ссылку, -которую может открыть любой, у кого она есть. В терминале инструмент спрашивает перед удалением, перезаписью с -`--replace` и публичной ссылкой. По MCP спросить некого, поэтому для агента, которому это нельзя, закройте эти права: - -```sh -ydisk personal config set permissions.files.delete deny -ydisk personal config set permissions.files.share deny -``` - -`YDISK_READ_ONLY=1` запрещает любые изменения. `--dry-run` у любого изменения показывает, что оно сделает, и ничего -не меняет. - - - -## Ограничения - -- В сканированных PDF и картинках нет текста для поиска. Файлы больше 50 МБ сохраняются только по имени. -- Выбранная папка, которую вы переименовали или перенесли на Диске, перестает синхронизироваться, и ее копии уходят из - хранилища. Добавьте ее снова по новому пути. -- Вход только по вставленному токену от приложения, которое вы регистрируете. Входа через браузер пока нет. - - - -## Если что-то не работает - -- **«refused the token», код выхода 4.** Токен неверный, отозван или истек. Получите новый и снова выполните - `session start`. -- **Изменение не проходит, код выхода 5.** Токен выдан без права `cloud_api:disk.write`, или изменение запрещают права - профиля. -- **Поиск не находит файл, который точно есть.** Проверьте, что его папка есть в `folders list`, запускайте `sync`, - пока `status` не покажет, что работы не осталось, и посмотрите, не сохранен ли файл в `status` только по имени. -- **«the OS keyring did not answer» в Linux.** Выйдите из системы и войдите снова или войдите в инструмент командой - `ydisk personal session start --credential-storage file`. - -`ydisk doctor` показывает, что настроено, без подключения к сети, а `ydisk personal doctor --online` проверяет токен. -Другие случаи описаны на [странице о неполадках](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/troubleshooting.md). - - - -## Справочник - -Все команды и параметры: [команды](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/commands.md). Настройки и -права: [настройки](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/configuration.md). Что попадает на диск и в -сеть: [безопасность](https://github.com/WireCatLabs/ydisk-cli/blob/main/docs/security.md). Справочник на английском. - -Дальше: [дайте агенту и папку заметок в Markdown](./markdown.mdx). diff --git a/cspell.json b/cspell.json index 4442e747..e6070303 100644 --- a/cspell.json +++ b/cspell.json @@ -219,6 +219,19 @@ "Salesbots", "sostav", "revísala", - "redirección" + "redirección", + "фотосрез", + "фотосреза", + "cyrillic", + "Omítelo", + "Cópialo", + "Pégalo", + "Bórralos", + "sincronízalas", + "Pégala", + "отсканированном", + "arréglalo", + "hermes", + "latin" ] } diff --git a/docs/README.md b/docs/README.md index 68aeb1c6..0a58e1e6 100644 --- a/docs/README.md +++ b/docs/README.md @@ -40,7 +40,6 @@ These pages and shared interface/Markdown behavior belong to this repository. | How do I make Yandex Telemost's emailed meeting notes searchable as meetings? | `telemost.mdx` | Task guide | Keep in step with mail-cli's `meeting-notes` rule and Yandex's notes conditions | | How do I keep my Google Meet calls and transcripts so my agent can search them? | `google-meet.mdx` | Task guide | Keep in step with gcal's `meetings` commands and Google's 30-day and transcript limits | | How do I make my Markdown notes or Obsidian vault searchable by my agent? | `markdown.mdx` | Task guide | Keep in step with memo's `folders` and `notes` commands and its readable file types | -| How do I make my Yandex Disk files searchable and work with them? | `ydisk.mdx` (Documents & files) | Start page | Written from ydisk 0.1.0 while `tools.json` does not list it; move it into a `ydisk` tool section once `tools.json` lists it, keeping the URL | | How do I connect a browser AI app? | `agents.mdx` (Use from web or mobile) | Connection guide | Preserve current web setup instructions | | How do I ask for a useful result? | `prompting.mdx` | Task guidance | Cross-link to worked examples instead of duplicating dialogues | | How do I review a reply in my messaging app or use an auto-reply template? | `drafts-and-templates.mdx` | Task guide and explanation | Keep template facts in step with the tools' auto-reply guides | @@ -75,7 +74,7 @@ release. The portal owns its overview (`translations/overviews/drive.*.md`), as is overview → installation → usage/search/recipes; configuration, security, troubleshooting and generated commands remain discoverable references. -Google Drive, Notion, the site-owned `ydisk.mdx` (Yandex Disk, until `tools.json` lists it) and `markdown.mdx` (Markdown +Google Drive, Notion, Yandex Disk (`ydisk`, from its repository) and the site-owned `markdown.mdx` (Markdown folders and Obsidian vaults, read by `memo`) sit in the Documents & files group of the sidebar (`toolGroups` in `lib/docs-sidebar-tree.tsx`). Their URLs do not change. diff --git a/docs/tasks.json b/docs/tasks.json index a5a40a6b..b4d4a908 100644 --- a/docs/tasks.json +++ b/docs/tasks.json @@ -269,6 +269,42 @@ "pages": ["amo/configuration.md", "amo/troubleshooting.md"], "families": { "amo": ["config", "doctor", "runs", "upgrade"] } }, + { + "id": "files-ydisk-connect", + "pages": ["ydisk/installation.md", "ydisk/mcp.md", "ydisk/security.md"], + "families": { "ydisk": ["session", "account", "skill", "mcp"] } + }, + { + "id": "files-ydisk-find", + "pages": ["ydisk/usage.md", "ydisk/search.md", "ydisk/recipes.md"], + "families": { + "ydisk": [ + "folders", + "sync", + "status", + "documents", + "search", + "catalog", + "tags", + "relationships", + "notes", + "memories", + "facts", + "identities", + "store" + ] + } + }, + { + "id": "files-ydisk-work", + "pages": ["ydisk/usage.md", "ydisk/commands.md"], + "families": { "ydisk": ["files", "api", "commands"] } + }, + { + "id": "files-ydisk-upkeep", + "pages": ["ydisk/configuration.md", "ydisk/troubleshooting.md"], + "families": { "ydisk": ["config", "doctor", "runs", "upgrade"] } + }, { "id": "calls-connect", "pages": ["pbx/installation.md", "pbx/usage.md", "pbx/security.md"], diff --git a/lib/docs-sidebar-tree.tsx b/lib/docs-sidebar-tree.tsx index 972b3f1d..1c94c27d 100644 --- a/lib/docs-sidebar-tree.tsx +++ b/lib/docs-sidebar-tree.tsx @@ -365,7 +365,7 @@ export function unifiedDocsTree(tree: Root, lang = "en"): Root { } } if (node.type !== "page") return node - const slug = /\/docs\/(tg|max|wa|drive|notion|gcal|mail|memo|zm|b24|amo|pbx)\/?$/.test(node.url) + const slug = /\/docs\/(tg|max|wa|drive|notion|gcal|mail|memo|zm|ydisk|b24|amo|pbx)\/?$/.test(node.url) ? "index" : (node.url.split("/").filter(Boolean).at(-1) ?? "") const Icon = sidebarIcons[slug as keyof typeof sidebarIcons] ?? FileText diff --git a/lib/seo-copy.json b/lib/seo-copy.json index e8ebb738..0d13c8c0 100644 --- a/lib/seo-copy.json +++ b/lib/seo-copy.json @@ -52,7 +52,8 @@ "mail": "IMAP mail MCP server and CLI with offline search", "b24": "Bitrix24 MCP server and CLI for your CRM", "notion": "Notion MCP server and CLI with offline search", - "amo": "amoCRM and Kommo MCP server and CLI for your CRM" + "amo": "amoCRM and Kommo MCP server and CLI for your CRM", + "ydisk": "Yandex Disk MCP server and CLI with offline search" }, "products": { "tg": "Telegram", @@ -66,7 +67,8 @@ "max": "MAX messenger", "mail": "email", "b24": "Bitrix24", - "amo": "amoCRM" + "amo": "amoCRM", + "ydisk": "Yandex Disk" }, "labels": { "max": "MAX", @@ -185,7 +187,8 @@ "mail": "MCP-сервер почты по IMAP с поиском без интернета", "b24": "Битрикс24 MCP-сервер и CLI для CRM", "notion": "Notion MCP-сервер и CLI с поиском без интернета", - "amo": "amoCRM и Kommo: MCP-сервер и CLI для CRM" + "amo": "amoCRM и Kommo: MCP-сервер и CLI для CRM", + "ydisk": "Яндекс Диск: MCP-сервер и CLI с поиском без интернета" }, "products": { "tg": "Telegram", @@ -199,7 +202,8 @@ "max": "MAX", "mail": "почты", "b24": "Битрикс24", - "amo": "amoCRM" + "amo": "amoCRM", + "ydisk": "Яндекс Диск" }, "labels": { "mail": "Почта" @@ -316,7 +320,8 @@ "mail": "Servidor MCP de correo IMAP con búsqueda sin conexión", "b24": "Servidor MCP y CLI para el CRM de Bitrix24", "notion": "Servidor MCP y CLI de Notion con búsqueda sin conexión", - "amo": "Servidor MCP y CLI para el CRM de amoCRM y Kommo" + "amo": "Servidor MCP y CLI para el CRM de amoCRM y Kommo", + "ydisk": "Servidor MCP y CLI de Yandex Disk con búsqueda sin conexión" }, "products": { "tg": "Telegram", @@ -330,7 +335,8 @@ "max": "MAX", "mail": "correo", "b24": "Bitrix24", - "amo": "amoCRM" + "amo": "amoCRM", + "ydisk": "Yandex Disk" }, "labels": { "mail": "Correo" diff --git a/lib/seo.ts b/lib/seo.ts index 44770d26..21d0b8bb 100644 --- a/lib/seo.ts +++ b/lib/seo.ts @@ -13,6 +13,7 @@ import seoCopy from "./seo-copy.json" import { appName, siteUrl, tools } from "./shared" import { homePath } from "./site-routes" import { whatsappDescriptions } from "./whatsapp-descriptions" +import { ydiskDescriptions } from "./ydisk-descriptions" import { zoomDescriptions } from "./zoom-descriptions" export type SiteLocale = keyof typeof seoCopy @@ -126,6 +127,7 @@ export function documentationDescription(lang: string, slugs: string[], authored notion: notionDescriptions, pbx: pbxDescriptions, wa: whatsappDescriptions, + ydisk: ydiskDescriptions, }[selectedTool?.name ?? ""] if (reviewed) { const description = reviewed[localeOf(lang)][slugs[1] ?? "index"] diff --git a/lib/ydisk-descriptions.ts b/lib/ydisk-descriptions.ts new file mode 100644 index 00000000..57011ccc --- /dev/null +++ b/lib/ydisk-descriptions.ts @@ -0,0 +1,53 @@ +export const ydiskDescriptions: Record> = { + en: { + index: "Search the text of your Yandex Disk folders offline, and let your AI agent read, file and share documents.", + installation: "Install the Yandex Disk CLI with npm, get a Yandex token and sign in with a profile.", + usage: "Choose Disk folders, sync their text to your computer, read documents and work with files on the Disk.", + search: "Find Disk documents by words, by meaning or by file name, and keep tags and notes on them.", + recipes: "Whole Yandex Disk tasks for an agent: find a contract, file invoices, share a link.", + mcp: "Connect an agent to the Yandex Disk CLI over MCP, see what it is offered and keep its writes yours.", + commands: "Find every Yandex Disk CLI command, option and exit code in the generated reference.", + configuration: "See and change the Yandex Disk CLI settings: profiles, folders, variables and their order.", + troubleshooting: "Fix a refused Yandex token, a folder that does not sync or a search that finds nothing.", + security: "What the Yandex Disk CLI keeps, where the token lives, what it reaches and what a run record hides.", + changelog: "Read Yandex Disk CLI release notes, including new capabilities, changes and fixes.", + roadmap: "See what the Yandex Disk CLI does today and what is planned next, such as setup in WireCat Desktop.", + compare: + "Compare ydisk with the Yandex Disk MCP server, rclone, Yandex Disk for Linux and yandex-disk-mcp by the job.", + }, + ru: { + index: "Ищите по тексту папок Яндекс Диска без интернета, а ИИ-агент читает, раскладывает и отправляет документы.", + installation: "Установите CLI для Яндекс Диска из npm, получите токен Яндекса и войдите с профилем.", + usage: "Выберите папки Диска, скопируйте их текст на компьютер, читайте документы и работайте с файлами на Диске.", + search: "Находите документы Диска по словам, по смыслу и по имени файла, добавляйте теги и заметки.", + recipes: "Задачи для агента на Яндекс Диске целиком: найти договор, разложить счета, сделать ссылку.", + mcp: "Подключите агента к CLI для Яндекс Диска через MCP, посмотрите, что ему доступно, и оставьте запись за собой.", + commands: "Все команды, параметры и коды выхода CLI для Яндекс Диска в сгенерированном справочнике.", + configuration: "Настройки CLI для Яндекс Диска: профили, папки, переменные и порядок, в котором они действуют.", + troubleshooting: "Исправьте отклонённый токен Яндекса, папку, которая не копируется, или поиск без результатов.", + security: "Что хранит CLI для Яндекс Диска, где лежит токен, куда он обращается и что скрывает запись запуска.", + changelog: "История изменений CLI для Яндекс Диска: новые возможности, изменения и исправления.", + roadmap: "Что CLI для Яндекс Диска уже умеет и что запланировано дальше, например подключение в WireCat Desktop.", + compare: + "Сравнение ydisk с MCP-сервером Яндекс Диска, rclone, Яндекс Диском для Linux и yandex-disk-mcp по задачам.", + }, + es: { + index: "Busca en el texto de tus carpetas de Yandex Disk sin conexión, y tu agente de IA lee, archiva y comparte.", + installation: "Instala la CLI de Yandex Disk con npm, consigue un token de Yandex e inicia sesión con un perfil.", + usage: "Elige carpetas del Disk, copia su texto a tu ordenador, lee documentos y trabaja con archivos del Disk.", + search: + "Encuentra documentos del Disk por palabras, por significado o por nombre de archivo, con etiquetas y notas.", + recipes: + "Tareas completas de Yandex Disk para un agente: encontrar un contrato, archivar facturas, compartir un enlace.", + mcp: "Conecta un agente a la CLI de Yandex Disk por MCP, mira qué se le ofrece y mantén tuyas sus escrituras.", + commands: "Consulta todos los comandos, opciones y códigos de salida de la CLI de Yandex Disk.", + configuration: "Mira y cambia los ajustes de la CLI de Yandex Disk: perfiles, carpetas, variables y su orden.", + troubleshooting: "Arregla un token de Yandex rechazado, una carpeta que no se copia o una búsqueda sin resultados.", + security: + "Qué guarda la CLI de Yandex Disk, dónde vive el token, a qué se conecta y qué oculta un registro de ejecución.", + changelog: "Lee las notas de versión de la CLI de Yandex Disk: novedades, cambios y correcciones.", + roadmap: "Mira qué hace ya la CLI de Yandex Disk y qué está previsto, como conectarla en WireCat Desktop.", + compare: + "Compara ydisk con el servidor MCP de Yandex Disk, rclone, Yandex Disk para Linux y yandex-disk-mcp por tarea.", + }, +} diff --git a/scripts/docs-navigation.test.ts b/scripts/docs-navigation.test.ts index fcb7c705..44ebe305 100644 --- a/scripts/docs-navigation.test.ts +++ b/scripts/docs-navigation.test.ts @@ -233,9 +233,8 @@ describe("tool folders in the sidebar", () => { children: [], }) const markdown: Node = { type: "page", name: "Markdown y Obsidian", url: "/es/docs/markdown" } - const ydisk: Node = { type: "page", name: "Yandex Disk", url: "/es/docs/ydisk" } const tree = unifiedDocsTree( - { name: "Docs", children: [folder("drive"), folder("gcal"), folder("notion"), ydisk, markdown] }, + { name: "Docs", children: [folder("drive"), folder("gcal"), folder("notion"), folder("ydisk"), markdown] }, "es", ) const [group, gcal] = tree.children diff --git a/scripts/localize.ts b/scripts/localize.ts index dd142ea0..3a4408fa 100644 --- a/scripts/localize.ts +++ b/scripts/localize.ts @@ -37,6 +37,7 @@ export const siteOwnedPages: { tool?: string; slug: string; after?: string }[] = { tool: "zm", slug: "meetings", after: "usage" }, { tool: "notion", slug: "roadmap", after: "changelog" }, { tool: "amo", slug: "roadmap", after: "changelog" }, + { tool: "ydisk", slug: "roadmap", after: "changelog" }, ] export const siteOwnedFor = (tool: string) => siteOwnedPages.filter((page) => !page.tool || page.tool === tool) diff --git a/scripts/seo.test.ts b/scripts/seo.test.ts index dc8ce8b3..299e3cf6 100644 --- a/scripts/seo.test.ts +++ b/scripts/seo.test.ts @@ -164,6 +164,25 @@ describe("localized SEO", () => { for (const slug of [...slugs, "changelog", "compare", "roadmap", "mcp", "permissions"]) expect(() => documentationDescription(lang, ["amo", slug]), `${lang} amo/${slug}`).not.toThrow() }) + it("describes every page the Yandex Disk CLI publishes in every locale", () => { + for (const lang of seoLocales) + for (const slug of [ + "index", + "installation", + "usage", + "search", + "recipes", + "mcp", + "commands", + "configuration", + "troubleshooting", + "security", + "changelog", + "compare", + "roadmap", + ]) + expect(() => documentationDescription(lang, ["ydisk", slug]), `${lang} ydisk/${slug}`).not.toThrow() + }) it("describes every page the Notion CLI publishes in every locale", () => { const slugs = ["index", "installation", "usage", "commands", "configuration", "troubleshooting", "security"] for (const lang of seoLocales) diff --git a/tools.json b/tools.json index 513e4ff1..7a6e83b0 100644 --- a/tools.json +++ b/tools.json @@ -49,6 +49,19 @@ "es": "Importa carpetas de Google, busca documentos localmente y conserva etiquetas, notas y recuerdos con fuentes." } }, + { + "name": "ydisk", + "displayName": "Yandex Disk", + "repo": "WireCatLabs/ydisk-cli", + "package": "@wirecat/yandex-disk-cli", + "lang": "en", + "docsRef": "v0.2.0", + "summary": { + "en": "Search the text of your Yandex Disk folders on your computer, and let your AI agent read, file and share documents there.", + "ru": "Ищите по тексту папок Яндекс Диска на своём компьютере и поручайте ИИ-агенту читать, раскладывать и отправлять документы.", + "es": "Busca en el texto de tus carpetas de Yandex Disk en tu ordenador y deja que tu agente de IA lea, archive y comparta documentos." + } + }, { "name": "notion", "displayName": "Notion", diff --git a/translations/pages/ydisk/roadmap.en.md b/translations/pages/ydisk/roadmap.en.md new file mode 100644 index 00000000..3ac99657 --- /dev/null +++ b/translations/pages/ydisk/roadmap.en.md @@ -0,0 +1,20 @@ +--- +title: "Roadmap" +--- + +This page lists what is planned for `ydisk` and not done yet. Read it before you build a workaround for a missing +feature: it may already be on the way. The order can change, and there are no dates. To suggest something, open an +[issue on GitHub](https://github.com/WireCatLabs/ydisk-cli/issues). + +## What works today + +`ydisk` signs in to your Yandex Disk with a Yandex token you make once. It copies the text of the folders you choose to +your computer, so you and your agent search it by words, by meaning and by file name, even without the internet. The +same tool lists, downloads, uploads, moves and shares files on the Disk within the permissions you set, over the +command line or MCP. See [start here](./index.md). + +## Next + +- Connect Yandex Disk in WireCat Desktop, so you sign in and choose folders without the terminal. + +What changed in each released version is in the [changelog](./changelog.md). diff --git a/translations/pages/ydisk/roadmap.es.md b/translations/pages/ydisk/roadmap.es.md new file mode 100644 index 00000000..00355350 --- /dev/null +++ b/translations/pages/ydisk/roadmap.es.md @@ -0,0 +1,20 @@ +--- +title: "Hoja de ruta" +--- + +Esta página enumera lo que está previsto para `ydisk` y aún no está hecho. Léela antes de montar un apaño para una +función que falta: puede que ya esté en camino. El orden puede cambiar y no hay fechas. Para sugerir algo, abre un +[issue en GitHub](https://github.com/WireCatLabs/ydisk-cli/issues). + +## Qué funciona hoy + +`ydisk` inicia sesión en tu Yandex Disk con un token de Yandex que creas una sola vez. Copia a tu ordenador el texto de +las carpetas que elijas, y tú y tu agente lo buscáis por palabras, por significado y por nombre de archivo, incluso sin +internet. La misma herramienta lista, descarga, sube, mueve y comparte archivos del Disk dentro de los permisos que +fijes, por la línea de comandos o por MCP. Mira [empieza aquí](./index.md). + +## Siguiente + +- Conectar Yandex Disk en WireCat Desktop, para iniciar sesión y elegir carpetas sin la terminal. + +Lo que cambió en cada versión está en el [registro de cambios](./changelog.md). diff --git a/translations/pages/ydisk/roadmap.ru.md b/translations/pages/ydisk/roadmap.ru.md new file mode 100644 index 00000000..0d36ada7 --- /dev/null +++ b/translations/pages/ydisk/roadmap.ru.md @@ -0,0 +1,20 @@ +--- +title: "Планы развития" +--- + +Здесь перечислено, что запланировано для `ydisk` и еще не сделано. Загляните сюда, прежде чем обходить нехватку +функции: возможно, она уже в работе. Порядок может меняться, сроков нет. Предложить что-то можно в +[issue на GitHub](https://github.com/WireCatLabs/ydisk-cli/issues). + +## Что работает сейчас + +`ydisk` входит в ваш Яндекс Диск по токену Яндекса, который вы создаете один раз. Он копирует на компьютер текст +выбранных папок, и вы с агентом ищете по нему по словам, по смыслу и по имени файла, даже без интернета. Тот же +инструмент показывает, скачивает, загружает, переносит и раздает файлы на Диске в пределах выбранных вами разрешений, из +командной строки или через MCP. См. [начало работы](./index.md). + +## Дальше + +- Подключение Яндекс Диска в WireCat Desktop: вход и выбор папок без терминала. + +Что изменилось в каждой версии, смотрите в [истории изменений](./changelog.md). diff --git a/translations/sources.json b/translations/sources.json index b7eec1c0..a918ceaf 100644 --- a/translations/sources.json +++ b/translations/sources.json @@ -409,5 +409,27 @@ "amo/permissions.ru": "dbf0b02efa79c4b7dc8f86a3b78c8973e88a22240d409c00a3a0bd76406031c3", "amo/index.es": "4d22150757fd48febb1fd4fe5e270e6f7984257964dd7d82542b5947ea0c5b78", "amo/mcp.es": "f64cc4f782b0e6a87b64a7b5db4f5b95e8b03896c2b45d6b1d1c77ed49e1af60", - "amo/permissions.es": "dbf0b02efa79c4b7dc8f86a3b78c8973e88a22240d409c00a3a0bd76406031c3" + "amo/permissions.es": "dbf0b02efa79c4b7dc8f86a3b78c8973e88a22240d409c00a3a0bd76406031c3", + "ydisk/changelog.es": "ff7254cb08d61a01536d3c791788b9878d4ba01a72e2f728e7cb5aca2c159f75", + "ydisk/changelog.ru": "ff7254cb08d61a01536d3c791788b9878d4ba01a72e2f728e7cb5aca2c159f75", + "ydisk/commands.es": "50f108d727a76515f18662f41b9969953f8e73aa9468dd9414db1073242fcd9a", + "ydisk/commands.ru": "50f108d727a76515f18662f41b9969953f8e73aa9468dd9414db1073242fcd9a", + "ydisk/configuration.es": "70ac759165e28b2032f2b036761e81e58adb2427e046d740893c485c90a84796", + "ydisk/configuration.ru": "70ac759165e28b2032f2b036761e81e58adb2427e046d740893c485c90a84796", + "ydisk/index.es": "35028c21952cbd97341fbb20cb7c13501bedf9f83bb78a7142b9f48a0baf04c0", + "ydisk/index.ru": "35028c21952cbd97341fbb20cb7c13501bedf9f83bb78a7142b9f48a0baf04c0", + "ydisk/installation.es": "aae0075fe1704cc9979f7a310d48709c86b432a108ec5e98c13b56bc257219e3", + "ydisk/installation.ru": "aae0075fe1704cc9979f7a310d48709c86b432a108ec5e98c13b56bc257219e3", + "ydisk/mcp.es": "5949aadee20312c916b23d159dd54334a4d9e6d83060c4e621b0ac93ab86fecf", + "ydisk/mcp.ru": "5949aadee20312c916b23d159dd54334a4d9e6d83060c4e621b0ac93ab86fecf", + "ydisk/recipes.es": "09f88b5ee6d0d06e41a328bf6c7ca229ef20ae75305e89aa63a774e9d307b066", + "ydisk/recipes.ru": "09f88b5ee6d0d06e41a328bf6c7ca229ef20ae75305e89aa63a774e9d307b066", + "ydisk/search.es": "4d9fb50644044580dbda9734041209b57cf6a15c95e4815ea5c2fb861a396942", + "ydisk/search.ru": "4d9fb50644044580dbda9734041209b57cf6a15c95e4815ea5c2fb861a396942", + "ydisk/security.es": "b77fe966224afe7122b9c4a06210b109dbf77975bec03ef9e41207cda14ad1c7", + "ydisk/security.ru": "b77fe966224afe7122b9c4a06210b109dbf77975bec03ef9e41207cda14ad1c7", + "ydisk/troubleshooting.es": "dc89e1d11615e66482bfe900b7998913a75a769bd0978745dd767d7c05ef0a8f", + "ydisk/troubleshooting.ru": "dc89e1d11615e66482bfe900b7998913a75a769bd0978745dd767d7c05ef0a8f", + "ydisk/usage.es": "a0e4bc19e253e39d64ebbe6ea0731b16959baf242fae5adba459298f978f3810", + "ydisk/usage.ru": "a0e4bc19e253e39d64ebbe6ea0731b16959baf242fae5adba459298f978f3810" } diff --git a/translations/ydisk/changelog.es.md b/translations/ydisk/changelog.es.md new file mode 100644 index 00000000..09c60b41 --- /dev/null +++ b/translations/ydisk/changelog.es.md @@ -0,0 +1,58 @@ +--- +title: "Historial de cambios" +--- + +Cambios notables en `@wirecat/yandex-disk-cli`. Una sección por versión, las más nuevas arriba. + +## 0.2.0 — 18.11.2026 + +### Añadido + +- `ydisk store info` muestra el archivo del almacén compartido, su tamaño, su formato y el número de filas, así que + WireCat Desktop puede decir si Yandex Disk lo lee. +- `ydisk account remove --keep-data|--delete-data` cierra la sesión del perfil y lo olvida en este + ordenador. Conserva o borra las carpetas elegidas y los archivos sincronizados, según lo que elijas. +- `folders browse` da a cada carpeta un `kind` y un `has_children`. Yandex no da el número de elementos hijos, así que + se mira dentro de cada carpeta, con una petición cada una, cuando el nivel tiene 20 carpetas o menos. Con más, + `has_children` es `null`. + +### Corregido + +- Publicado desde GitHub Actions con la procedencia de npm (provenance), así que WireCat Desktop lo instala: Desktop se + niega a instalar una versión de una herramienta integrada que no compiló el workflow de su propio repositorio, y la + 0.1.0 se publicó desde un ordenador. +- **Las guías cubren lo que hace la herramienta, paso a paso.** Páginas nuevas: [encuentra un documento](./search.md) + (palabras, formas de las palabras, significado, nombres de archivo), [conecta a tu agente](./mcp.md) (el skill, + `mcp add`, `mcp config`, aplicaciones del navegador y qué puede cambiar un agente), [recetas](./recipes.md) y + [comparación con otras herramientas](./compare.md). [Instala e inicia sesión](./installation.md) explica cómo + conseguir el token de Yandex con los nombres que usa el propio Yandex, [la solución de problemas](./troubleshooting.md) + va por síntomas e incluye los códigos de salida, y [la seguridad](./security.md) dice qué se queda en tu ordenador y + cómo quitarlo. Los pasos del token ahora nombran el tipo de aplicación "For API access or debugging", como las + páginas de Yandex. +- La ayuda y el error de `--cursor` en `folders browse` y `files list` nombran `page.next_cursor`, la clave que tiene la + respuesta, y no `page.next`. + +## 0.1.0 — 17.11.2026 + +### Añadido + +- Se empezó desde `@wirecat/cli-template` 0.25.0. +- **Inicio de sesión con un token OAuth de Yandex** pegado una sola vez: `session start` lo lee oculto o desde stdin, + lo comprueba con `GET /v1/disk` y lo guarda en el llavero del sistema. `session status --check` y `doctor --online` + dicen de quién es. +- **Carpetas elegidas del Disco como texto en el que buscar**: `folders add `, `sync`, `status`, + `documents list|show|export`, `search`, `catalog`, etiquetas, notas y recuerdos, los comandos compartidos de + documentos de cli-core. Cada sincronización recorre de nuevo las carpetas elegidas (la API del Disco no tiene un + registro de cambios) y lee solo los archivos cuyo MD5 cambió. Un archivo movido conserva su id, sus etiquetas y sus + notas. El texto sale de PDF, docx, xlsx, CSV, TSV, texto y Markdown. Las horas se guardan y se responden en UTC. +- **Los archivos en vivo**: `files list|show|download|upload|copy|move|create|delete|restore|publish|unpublish`, por + ruta del Disco. `files delete` envía a la papelera. `--replace` y `files delete` preguntan como lo hace + `files.delete`, `files publish` como lo hace `files.share`, y `--dry-run` muestra cada clave que comprueba la + escritura. `files publish` responde con el enlace público, o deja fuera `public_url` cuando no puede leerlo de + vuelta. Las descargas y las subidas van a la dirección que da Yandex, sin el token. +- **`api`**: un comando por cada operación de la descripción Swagger 1.2 de Yandex, 20 en total. Se dejan fuera las + tres que responden con un enlace de descarga o de subida, y los enlaces `file`, `preview` y `sizes` de un recurso se + quitan de cada respuesta. `--all` pasa las páginas donde la API las pagina. Un borrado permanente, `overwrite=true` y + un enlace público preguntan según `files.delete` y `files.share`. Una operación que hace lo que hace un comando de + `files` comprueba también la clave de ese comando: `files.move: deny` detiene también `api resources-move`, en la + ejecución y en `--dry-run`. diff --git a/translations/ydisk/changelog.ru.md b/translations/ydisk/changelog.ru.md new file mode 100644 index 00000000..6b136c2e --- /dev/null +++ b/translations/ydisk/changelog.ru.md @@ -0,0 +1,56 @@ +--- +title: "История изменений" +--- + +Заметные изменения в `@wirecat/yandex-disk-cli`. По одному разделу на версию, новые сверху. + +## 0.2.0 — 18.11.2026 + +### Добавлено + +- `ydisk store info` показывает файл общего хранилища, его размер, формат и число строк, так что WireCat Desktop может + сказать, читает ли его Яндекс Диск. +- `ydisk account remove --keep-data|--delete-data` выводит профиль из системы и забывает его на этом + компьютере. Выбранные папки и синхронизированные файлы остаются или удаляются, как вы выберете. +- `folders browse` дает каждой папке `kind` и `has_children`. Яндекс не сообщает число вложенных элементов, поэтому + инструмент заглядывает в каждую папку отдельным запросом, если на уровне не больше 20 папок. Если их больше, + `has_children` равен `null`. + +### Исправлено + +- Опубликован из GitHub Actions с подписью npm (provenance), поэтому WireCat Desktop его устанавливает: Desktop + отказывается ставить выпуск встроенного инструмента, который собрал не workflow его репозитория, а 0.1.0 был + опубликован с компьютера. +- **Руководства рассказывают шаг за шагом, что делает инструмент.** Новые страницы: [найдите документ](./search.md) + (слова, формы слов, смысл, имена файлов), [подключение агента](./mcp.md) (навык, `mcp add`, `mcp config`, + приложения в браузере и что агент может менять), [сценарии](./recipes.md) и [сравнение с другими + инструментами](./compare.md). [Установка и вход](./installation.md) проводит через получение токена Яндекса с + названиями из самого Яндекса, [решение проблем](./troubleshooting.md) устроено по симптомам и с кодами выхода, а + [безопасность](./security.md) говорит, что остается на вашем компьютере и как это удалить. В шагах с токеном теперь + назван тип приложения "For API access or debugging", как на страницах Яндекса. +- Справка и ошибка `--cursor` в `folders browse` и `files list` называют `page.next_cursor`, ключ, который есть в + ответе, а не `page.next`. + +## 0.1.0 — 17.11.2026 + +### Добавлено + +- Начало от `@wirecat/cli-template` 0.25.0. +- **Вход с токеном OAuth Яндекса**, который вставляется один раз: `session start` читает его скрыто или из stdin, + проверяет через `GET /v1/disk` и хранит в связке ключей системы. `session status --check` и `doctor --online` + говорят, чей это токен. +- **Выбранные папки Диска как текст для поиска**: `folders add `, `sync`, `status`, + `documents list|show|export`, `search`, `catalog`, теги, заметки и записи памяти, общие команды документов из + cli-core. Каждая синхронизация заново обходит выбранные папки (в API Диска нет ленты изменений) и читает только + файлы, у которых изменился MD5. Перемещенный файл сохраняет id, теги и заметки. Текст берется из PDF, docx, xlsx, + CSV, TSV, текста и Markdown. Время хранится и отдается в UTC. +- **Файлы вживую**: `files list|show|download|upload|copy|move|create|delete|restore|publish|unpublish` по путям на + Диске. `files delete` отправляет в корзину. `--replace` и `files delete` спрашивают так же, как `files.delete`, + `files publish` так же, как `files.share`, а `--dry-run` показывает каждый ключ, который проверяет запись. + `files publish` отвечает публичной ссылкой или опускает `public_url`, если не может ее прочитать. Скачивание и + загрузка идут по адресу, который дает Яндекс, без токена. +- **`api`**: по одной команде на каждую операцию описания Swagger 1.2 от Яндекса, всего 20. Три, которые отвечают + ссылкой на скачивание или загрузку, пропущены, а ссылки `file`, `preview` и `sizes` ресурса убираются из каждого + ответа. `--all` листает страницы там, где их листает API. Окончательное удаление, `overwrite=true` и публичная ссылка + спрашивают по `files.delete` и `files.share`. Операция, которая делает то же, что команда `files`, проверяет и ключ + этой команды: `files.move: deny` останавливает и `api resources-move`, в запуске и в `--dry-run`. diff --git a/translations/ydisk/commands.es.md b/translations/ydisk/commands.es.md new file mode 100644 index 00000000..d70e34d0 --- /dev/null +++ b/translations/ydisk/commands.es.md @@ -0,0 +1,2038 @@ +--- +title: "Comandos de ydisk" +--- + + + + +Busca cualquier comando de ydisk, sus opciones y lo que responde, con la seguridad de que coincide con tu versión: +esta página se genera a partir del propio programa. + +Tu agente de IA lee la misma lista en JSON con `ydisk commands --json` y elige allí un comando y sus opciones. Cada +código de salida indica un tipo de fallo, así que un script o un agente sabe qué salió mal. Las descripciones de los +comandos y de las opciones se quedan en el idioma de la ayuda integrada. + +**La primera palabra es el perfil**, un nombre que eliges tú: `ydisk personal config show`. `YDISK_PROFILE` fija el +perfil para toda una sesión de la shell. Nunca se supone un perfil: un comando que usa una cuenta se detiene sin él y +muestra los perfiles de este ordenador. + +## Opciones de todos los comandos + +| Option | What it does | +|---|---| +| `-V, --version` | output the version number. | +| `-v, --verbose` | more detail in what is shown: -v ids, -vv everything we know. Default: `0`. | +| `--json` | machine-readable output: one JSON value on stdout; --json=id,text keeps only those fields. | +| `--jsonl` | machine-readable output: one JSON object per line, for streaming and jq. | +| `--quiet` | diagnostics off; a failure is still said. | +| `--trace` | the connection's own log lines on stderr — never content. | +| `--debug` | on a failure, its whole record — cause and stack — in place of the short line. | +| `--timeout ` | give up on the whole command after this — 30s, 2m, 500ms. | +| `--offline` | answer from what was recorded and never connect; fails if nothing was. | +| `--no-input` | never prompt or open interactive login; piped input remains available. | +| `--max-input-bytes ` | maximum buffered input bytes (default: 16777216). | +| `--max-output-bytes ` | maximum machine output bytes (default: 4194304; 0 disables). | +| `--brief` | found items as reference, title, time, author and excerpt only. | +| `--full` | found items with their whole text and every provider field. | +| `--compact` | one line per item for an agent: reference first, text last, paging and next steps as # lines. | +| `--dry-run` | preview parsed arguments and permissions before running the action. | +| `--yes` | go ahead without the question an ask level puts before a write. | +| `--record` | keep this run even where the config says record false; record_input false leaves the typed words out. | +| `--no-record` | do not keep this run, even if it fails. | + +## `ydisk commands` + +every command by section; --json prints its contract, one path per call + +### `ydisk commands info` + +one command contract, or all schemas, error reasons and explicit overrides + +```sh +ydisk commands info [path] +``` + +| Argument | | What it is | +|---|---|---| +| `path` | optional | one command path; without one, export schemas, error reasons and explicit overrides. | + +**Example:** `ydisk commands info commands` + +## `ydisk session` + +keep this profile's Yandex Disk token in the OS keyring + +### `ydisk session start` + +sign this profile in: the Yandex Disk API token is asked hidden or read from stdin, never taken as an argument, checked against the service, and only then kept in the keyring, or in a private file + +**Changes something on this computer only.** + +```sh +ydisk session start [options] +``` + +| Option | What it does | +|---|---| +| `--credential-storage ` | where the token is kept: keyring, which falls back to a private file by itself when no keyring works; file skips the keyring, so keep it for a computer that has none. Default: `keyring`. | + +**Example:** `ydisk personal session start` + +### `ydisk session status` + +show where this profile's token comes from: YDISK_TOKEN, the keyring or a file, never the token; --check asks Yandex Disk whose token it is + +```sh +ydisk session status [options] +``` + +| Option | What it does | +|---|---| +| `--check` | ask Yandex Disk whether the token still works, and whose it is. | + +**Example:** `ydisk personal session status`, `ydisk personal session status --check --json` + +### `ydisk session end` + +forget this profile's token on this computer; the token itself stays valid in Yandex Disk + +**Changes something on this computer only.** + +```sh +ydisk session end +``` + +**Example:** `ydisk personal session end` + +### `ydisk session list` + +list the profiles on this computer and whether each has a token; picks none + +```sh +ydisk session list +``` + +**Example:** `ydisk session list`, `ydisk session list --json` + +## `ydisk account` + +this profile on this computer + +### `ydisk account remove` + +sign the profile out, then forget it on this computer: its settings, its saved sign-in and its files; --keep-data leaves its messages in the store, where search still finds them, --delete-data deletes them; asks first, or --yes + +**Changes something on this computer only.** + +```sh +ydisk account remove [options] +``` + +| Option | What it does | +|---|---| +| `--keep-data` | leave what the store holds of this account, still searchable. | +| `--delete-data` | delete what the store and the tool's own files hold of this account. | +| `--dry-run` | list what it would remove and keep, and change nothing. | + +**Returns:** account removal — profile, data, dry_run, account, revoked, config_file, removed, kept; every field: ydisk commands info account remove + +**Example:** `ydisk personal account remove --keep-data --dry-run`, `ydisk personal account remove --delete-data --yes` + +## `ydisk folders` + +choose the Disk folders sync copies + +### `ydisk folders add` + +import a folder and everything under it on the next sync + +**Changes something on this computer only.** + +```sh +ydisk folders add +``` + +| Argument | | What it is | +|---|---|---| +| `folder` | required | Disk path to add, like /Documents; its id to remove. | + +**Example:** `ydisk personal folders add /Documents` + +### `ydisk folders list` + +list the folder ids sync imports + +```sh +ydisk folders list [query] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Returns:** selected folder — id; every field: ydisk commands info folders list + +**Example:** `ydisk personal folders list` + +### `ydisk folders browse` + +list Disk folders one level at a time, live, to choose one for folders add; has_children says whether a folder holds a folder, or is null when the level has more than 20 folders and it is not looked up + +```sh +ydisk folders browse [options] +``` + +| Option | What it does | +|---|---| +| `--folder ` | the Disk folder to list inside, by its path; the top of the Disk without it. | +| `--cursor ` | go on from where the last page stopped; page.next_cursor gives it, with the same --folder. | + +**Next usually:** `ydisk folders add ` + +**Example:** `ydisk personal folders browse`, `ydisk personal folders browse --folder /Work --json` + +### `ydisk folders remove` + +stop importing a folder; the next sync drops its documents + +**Changes something on this computer only.** + +```sh +ydisk folders remove +``` + +| Argument | | What it is | +|---|---|---| +| `folder` | required | Disk path to add, like /Documents; its id to remove. | + +**Example:** `ydisk personal folders remove FOLDER_ID` + +## `ydisk sync` + +import what changed in the chosen folders, and finish an unfinished sync; one sync walks about 10000 entries under the chosen folders, saves where it stopped, and the next sync goes on from there + +**Changes something on this computer only.** + +```sh +ydisk sync [options] +``` + +| Option | What it does | +|---|---| +| `--limit ` | how many files to read from Yandex Disk in this run. Default: `200`. | +| `--rescan` | read every chosen folder again instead of only what changed; each --rescan starts the walk over, so run it once and continue with a plain sync. | +| `--embed` | also index pending text for meaning search, with a model already downloaded. | + +**Example:** `ydisk personal sync`, `ydisk personal sync --rescan --limit 500` + +## `ydisk status` + +show the last sync, imported documents and pending work + +```sh +ydisk status +``` + +**Example:** `ydisk personal status` + +## `ydisk documents` + +read the Yandex Disk files synced to this computer + +### `ydisk documents list` + +list the synced files with their Disk paths + +```sh +ydisk documents list [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +| Option | What it does | +|---|---| +| `--limit ` | how many documents to return. Default: `50`. | +| `--page ` | which page to return. Default: `1`. | + +**Next usually:** `ydisk documents show `, `ydisk documents context `, `ydisk tags list [query]` + +**Example:** `ydisk personal documents list`, `ydisk personal documents list tag:budget`, `ydisk personal documents list person:PERSON_UID --limit 10` + +### `ydisk documents show` + +show an imported document's text, tabs and metadata + +```sh +ydisk documents show +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | file id (resource_id) or a search hit's document: ref. | + +**Example:** `ydisk personal documents show DOC_ID`, `ydisk personal documents show document:42 --offline` + +### `ydisk documents export` + +write an imported document to a new Markdown file + +**Changes something on this computer only.** + +```sh +ydisk documents export [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | file id (resource_id) or a search hit's document: ref. | + +| Option | What it does | +|---|---| +| `--output ` | path of the Markdown file to write; an existing file is refused. | + +**Example:** `ydisk personal documents export DOC_ID --output notes.md` + +### `ydisk documents context` + +show a document with its tags, relationships, notes, memories and editors + +```sh +ydisk documents context +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. | + +**Example:** `ydisk personal documents context DOC_ID` + +## `ydisk search` + +search imported documents by words, and by meaning when indexed + +```sh +ydisk search [options] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | required | words to look for, and fields such as tag: and date: that every hit must match. | + +| Option | What it does | +|---|---| +| `--limit ` | how many results to return. Default: `20`. | +| `--page ` | which page to return. Default: `1`. | +| `--exact` | match the words exactly: no word forms, no meaning. | + +**Example:** `ydisk personal search budget`, `ydisk personal search "quarterly plan" --exact --limit 5` + +## `ydisk catalog` + +browse stored Yandex Disk files and folders offline + +### `ydisk catalog import` + +put cached file and folder metadata into the shared database + +**Changes something on this computer only.** + +```sh +ydisk catalog import +``` + +**Example:** `ydisk personal catalog import --offline` + +### `ydisk catalog show` + +show stored metadata and the stable file or folder reference + +```sh +ydisk catalog show +``` + +| Argument | | What it is | +|---|---|---| +| `file` | required | Yandex Disk file or folder id, or its URL. | + +**Next usually:** `ydisk documents show `, `ydisk documents context `, `ydisk tags list [query]` + +**Example:** `ydisk personal catalog show FILE_ID --offline` + +### `ydisk catalog list` + +list cached files and folders using metadata queries + +```sh +ydisk catalog list [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | optional | metadata query: kind, mime, name, parent, person, tag; AND, OR, NOT. | + +| Option | What it does | +|---|---| +| `--limit ` | how many entries to return (at most 1000). Default: `50`. | +| `--page ` | which page to return. Default: `1`. | + +**Next usually:** `ydisk documents show `, `ydisk documents context `, `ydisk tags list [query]` + +**Example:** `ydisk personal catalog list "parent:FOLDER_ID AND kind:file" --offline` + +### `ydisk catalog search` + +search cached names, descriptions, types and observed people + +```sh +ydisk catalog search [options] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | required | metadata query: kind, mime, name, parent, person, tag; AND, OR, NOT. | + +| Option | What it does | +|---|---| +| `--limit ` | how many entries to return (at most 1000). Default: `50`. | +| `--page ` | which page to return. Default: `1`. | + +**Next usually:** `ydisk documents show `, `ydisk documents context `, `ydisk tags list [query]` + +**Example:** `ydisk personal catalog search "budget AND person:Rin*" --offline` + +### `ydisk catalog tree` + +show the cached hierarchy below a folder or all selected roots + +```sh +ydisk catalog tree [folder] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `folder` | optional | Yandex Disk folder id or URL; defaults to the explicitly selected profile's roots. | + +| Option | What it does | +|---|---| +| `--depth ` | maximum descendant depth, from 0 to 50. Default: `5`. | + +**Example:** `ydisk personal catalog tree --offline`, `ydisk personal catalog tree FOLDER_ID --depth 3 --offline` + +### `ydisk catalog tags` + +add owner tags to cached files or folders + +#### `ydisk catalog tags list` + +list local tags on a cached file or folder + +```sh +ydisk catalog tags list [query] +``` + +| Argument | | What it is | +|---|---|---| +| `file` | required | Yandex Disk file or folder id, or its URL. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Returns:** document tag — tag; every field: ydisk commands info catalog tags list + +**Example:** `ydisk personal catalog tags list FOLDER_ID --offline` + +#### `ydisk catalog tags add` + +add local tags on a cached file or folder + +**Changes something on this computer only.** + +```sh +ydisk catalog tags add +``` + +| Argument | | What it is | +|---|---|---| +| `file` | required | Yandex Disk file or folder id, or its URL. | +| `tags` | required | local tag names. | + +**Example:** `ydisk personal catalog tags add FOLDER_ID project --offline` + +#### `ydisk catalog tags remove` + +remove local tags on a cached file or folder + +**Changes something on this computer only.** + +```sh +ydisk catalog tags remove +``` + +| Argument | | What it is | +|---|---|---| +| `file` | required | Yandex Disk file or folder id, or its URL. | +| `tags` | required | local tag names. | + +**Example:** `ydisk personal catalog tags remove FOLDER_ID project --offline` + +## `ydisk tags` + +label imported documents; labels survive a sync + +### `ydisk tags list` + +list a document's tags + +```sh +ydisk tags list [query] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Returns:** document tag — tag; every field: ydisk commands info tags list + +**Example:** `ydisk personal tags list DOC_ID` + +### `ydisk tags add` + +tag a document + +**Changes something on this computer only.** + +```sh +ydisk tags add +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. | +| `tags` | required | one or more tags. | + +**Example:** `ydisk personal tags add DOC_ID budget q3` + +### `ydisk tags remove` + +untag a document + +**Changes something on this computer only.** + +```sh +ydisk tags remove +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. | +| `tags` | required | one or more tags. | + +**Example:** `ydisk personal tags remove DOC_ID budget q3` + +## `ydisk relationships` + +connect a document to people, projects, notes and other references + +### `ydisk relationships list` + +list a document's relationships + +```sh +ydisk relationships list [query] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Returns:** document relationship — id, from, to, kind, role, confirmed, origin; every field: ydisk commands info relationships list + +**Example:** `ydisk personal relationships list DOC_ID` + +### `ydisk relationships add` + +connect a document to another reference + +**Changes something on this computer only.** + +```sh +ydisk relationships add [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. | +| `reference` | required | what it connects to, such as person:, project: or note:. | + +| Option | What it does | +|---|---| +| `--kind ` | how the two relate. One of: `links-to`, `about`, `evidence`, `created-from`, `related-to`, `assigned-to`. Default: `related-to`. | +| `--role ` | the part the reference plays, in a word or two. | +| `--reason ` | why the two are connected. | + +**Example:** `ydisk personal relationships add DOC_ID project:PROJECT_ID --kind about`, `ydisk personal relationships add DOC_ID person:PERSON_UID --kind assigned-to --role reviewer` + +### `ydisk relationships remove` + +remove one of a document's relationships + +**Changes something on this computer only.** + +```sh +ydisk relationships remove +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. | +| `relationship-id` | required | id, as relationships list prints it. | + +**Example:** `ydisk personal relationships remove DOC_ID LINK_ID` + +## `ydisk notes` + +write notes about an imported document + +### `ydisk notes add` + +write a note about a document + +**Changes something on this computer only.** + +```sh +ydisk notes add [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document: ref. | +| `text` | required | the note's text. | + +| Option | What it does | +|---|---| +| `--title ` | a title for the note. | + +**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes add + +**Next usually:** `ydisk notes show <document> <note>`, `ydisk notes edit <document> <note> <text>`, `ydisk notes remove <document> <note>` + +**Example:** `ydisk personal notes add DOC_ID "Check the numbers" --title Review` + +### `ydisk notes list` + +list a document's notes + +```sh +ydisk notes list <document> [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many notes to return. Default: `50`. | +| `--page <n>` | which page to return. Default: `1`. | + +**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes list + +**Next usually:** `ydisk notes show <document> <note>`, `ydisk notes edit <document> <note> <text>`, `ydisk notes remove <document> <note>` + +**Example:** `ydisk personal notes list DOC_ID`, `ydisk personal notes list DOC_ID text:review --limit 10` + +### `ydisk notes show` + +show one note + +```sh +ydisk notes show <document> <note> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `note` | required | note:<id> reference, as notes list prints it. | + +**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes show + +**Next usually:** `ydisk notes edit <document> <note> <text>`, `ydisk notes remove <document> <note>` + +**Example:** `ydisk personal notes show DOC_ID note:NOTE_ID` + +### `ydisk notes edit` + +replace a note's text + +**Changes something on this computer only.** + +```sh +ydisk notes edit <document> <note> <text> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `note` | required | note:<id> reference, as notes list prints it. | +| `text` | required | the note's new text. | + +| Option | What it does | +|---|---| +| `--revision <n>` | revision from notes show; a newer note is not overwritten. | + +**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes edit + +**Next usually:** `ydisk notes show <document> <note>`, `ydisk notes remove <document> <note>` + +**Example:** `ydisk personal notes edit DOC_ID note:NOTE_ID "Numbers checked" --revision 2` + +### `ydisk notes remove` + +delete one note + +**Changes something on this computer only.** + +```sh +ydisk notes remove <document> <note> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `note` | required | note:<id> reference, as notes list prints it. | + +**Example:** `ydisk personal notes remove DOC_ID note:NOTE_ID` + +## `ydisk memories` + +keep what was learned from a document, with evidence; an agent's stay proposed + +### `ydisk memories add` + +record a memory about a document + +**Changes something on this computer only.** + +```sh +ydisk memories add <document> <text> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `text` | required | what to remember. | + +| Option | What it does | +|---|---| +| `--scope <scope>` | whose memory it is: personal or work. One of: `personal`, `work`. | +| `--kind <kind>` | what kind of memory it is. One of: `summary`, `digest`, `preference`. Default: `summary`. | +| `--supersedes <ref>` | a memory:<id> about the same document that this one replaces. | + +**Example:** `ydisk personal memories add DOC_ID "The team prefers async reviews" --scope work --kind preference` + +### `ydisk memories list` + +list a document's memories + +```sh +ydisk memories list <document> [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many memories to return. Default: `50`. | + +**Returns:** memory — ref, id, kind, text, subject, author, model, confidence, and 13 more; every field: ydisk commands info memories list + +**Example:** `ydisk personal memories list DOC_ID scope:work`, `ydisk personal memories list DOC_ID kind:preference status:confirmed` + +### `ydisk memories show` + +show one memory + +```sh +ydisk memories show <document> <memory> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `memory` | required | memory:<id> reference, as memories list prints it. | + +**Example:** `ydisk personal memories show DOC_ID memory:MEMORY_ID` + +### `ydisk memories confirm` + +confirm a proposed memory as true + +**Changes something on this computer only.** + +```sh +ydisk memories confirm <document> <memory> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `memory` | required | memory:<id> reference, as memories list prints it. | + +**Example:** `ydisk personal memories confirm DOC_ID memory:MEMORY_ID` + +### `ydisk memories stale` + +mark a memory as out of date + +**Changes something on this computer only.** + +```sh +ydisk memories stale <document> <memory> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `memory` | required | memory:<id> reference, as memories list prints it. | + +**Example:** `ydisk personal memories stale DOC_ID memory:MEMORY_ID` + +### `ydisk memories search` + +search a document's memories by words + +```sh +ydisk memories search <document> <query> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | required | words to look for, and scope:personal or scope:work — the fields are below. | + +**Returns:** memory — ref, id, kind, text, subject, author, model, confidence, and 13 more; every field: ydisk commands info memories search + +**Example:** `ydisk personal memories search DOC_ID reviews scope:work`, `ydisk personal memories search DOC_ID "async reviews"` + +### `ydisk memories extract` + +send a document's text to the model and show the memories it proposes + +**Changes something in the service.** + +```sh +ydisk memories extract <document> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | + +| Option | What it does | +|---|---| +| `--scope <scope>` | whose memories they become: personal or work. One of: `personal`, `work`. | +| `--tab <id>` | send only this tab of the document. | +| `--yes` | save the proposals, each with its quote and the document's version. | + +**Example:** `ydisk personal memories extract DOC_ID --scope work`, `ydisk personal memories extract DOC_ID --scope work --yes` + +## `ydisk facts` + +what happened, as a document shows it; an agent's stay proposed until confirmed + +### `ydisk facts add` + +record a fact a document shows + +**Changes something on this computer only.** + +```sh +ydisk facts add <document> <statement> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `statement` | required | the fact, in one sentence. | + +| Option | What it does | +|---|---| +| `--type <type>` | what kind of fact it is. One of: `fact`, `statement`, `question`, `decision`, `promise`. Default: `fact`. | +| `--scope <scope>` | whose fact it is: personal or work. One of: `personal`, `work`. | +| `--supersedes <ref>` | a decision only: the decision this one replaces. | +| `--occurred-time <time>` | when it happened, as the evidence shows, ISO 8601; a time without a zone is read in this computer's zone, a date alone as its midnight. | + +**Example:** `ydisk personal facts add DOC_ID "Budget approved" --type decision --scope work` + +### `ydisk facts list` + +list a document's facts + +```sh +ydisk facts list <document> [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many facts to return. Default: `50`. | + +**Returns:** fact — ref, id, kind, text, status, project, subject, occurred_at, and 14 more; every field: ydisk commands info facts list + +**Example:** `ydisk personal facts list DOC_ID status:proposed`, `ydisk personal facts list DOC_ID kind:decision` + +### `ydisk facts show` + +show one fact + +```sh +ydisk facts show <document> <fact> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `fact` | required | fact:<id> reference, as facts list prints it. | + +**Example:** `ydisk personal facts show DOC_ID fact:FACT_ID` + +### `ydisk facts confirm` + +confirm a proposed fact; a decision it supersedes stops holding + +**Changes something on this computer only.** + +```sh +ydisk facts confirm <document> <fact> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `fact` | required | fact:<id> reference, as facts list prints it. | + +**Example:** `ydisk personal facts confirm DOC_ID fact:FACT_ID` + +### `ydisk facts reverse` + +an accepted decision no longer holds, and nothing replaced it + +**Changes something on this computer only.** + +```sh +ydisk facts reverse <document> <fact> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `fact` | required | fact:<id> reference, as facts list prints it. | + +**Example:** `ydisk personal facts reverse DOC_ID fact:FACT_ID` + +## `ydisk identities` + +the Yandex Disk accounts seen on a document, and the people they belong to + +### `ydisk identities list` + +list the people Yandex Disk shows for a document + +```sh +ydisk identities list <document> [query] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Returns:** document identity — remote_id, provider, role, person; every field: ydisk commands info identities list + +**Example:** `ydisk personal identities list DOC_ID` + +### `ydisk identities link` + +record that a Yandex Disk account belongs to a known person + +**Changes something on this computer only.** + +```sh +ydisk identities link <document> <disk-id> <person> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `disk-id` | required | Yandex Disk account id, as identities list prints it. | +| `person` | required | person:<uid> reference of someone already known. | + +**Example:** `ydisk personal identities link DOC_ID DISK_ID person:PERSON_UID` + +## `ydisk files` + +the files on Yandex Disk, live: list, read, download, upload and change them + +### `ydisk files list` + +list what a Disk folder holds, live, a page at a time + +```sh +ydisk files list [options] +``` + +| Option | What it does | +|---|---| +| `--folder <folder>` | the Disk folder to list, by its path; the top of the Disk without it. | +| `--cursor <cursor>` | go on from where the last page stopped; page.next_cursor gives it, with the same --folder. | + +**Next usually:** `ydisk files show <path>`, `ydisk files download <path>` + +**Example:** `ydisk personal files list`, `ydisk personal files list --folder /Documents --json` + +### `ydisk files show` + +show one file or folder on the Disk, live + +```sh +ydisk files show <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +**Next usually:** `ydisk files download <path>` + +**Example:** `ydisk personal files show /plan.pdf` + +### `ydisk files download` + +read a Disk file's text (PDF, docx, xlsx, CSV, TSV, text, Markdown), or with --output save the file itself; the token never goes to the download host + +**Changes something on this computer only.** + +```sh +ydisk files download <path> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +| Option | What it does | +|---|---| +| `--output <file>` | save the file here instead of answering its text. | +| `--replace` | replace an existing output file. | + +**Example:** `ydisk personal files download /notes.md --json`, `ydisk personal files download /plan.pdf --output ./plan.pdf` + +### `ydisk files upload` + +put a local file on the Disk; --replace replaces one already there and asks as files.delete does. Credential files, browser profiles and the WireCat folders are refused + +**Changes something in the service.** + +```sh +ydisk files upload <file> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `file` | required | local file to upload. | + +| Option | What it does | +|---|---| +| `--folder <folder>` | the Disk folder to put it in, by its path; the top of the Disk without it. | +| `--name <name>` | its name on the Disk; the local name without it. | +| `--replace` | replace a file already at that path. | +| `--allow-any-file` | send a file from a place that is otherwise refused. | + +**Example:** `ydisk personal files upload ./plan.pdf --folder /Documents` + +### `ydisk files copy` + +copy a file or folder on the Disk into --folder, under --name or its own; --replace replaces what is there and asks as files.delete does + +**Changes something in the service.** + +```sh +ydisk files copy <path> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +| Option | What it does | +|---|---| +| `--folder <folder>` | the Disk folder it goes into, by its path. | +| `--name <name>` | its name there; its own without it. | +| `--replace` | replace what is already there. | + +**Example:** `ydisk personal files copy /plan.pdf --folder /Archive` + +### `ydisk files move` + +move a file or folder on the Disk into --folder, under --name or its own; --replace replaces what is there and asks as files.delete does + +**Changes something in the service.** + +```sh +ydisk files move <path> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +| Option | What it does | +|---|---| +| `--folder <folder>` | the Disk folder it goes into, by its path. | +| `--name <name>` | its name there; its own without it. | +| `--replace` | replace what is already there. | + +**Example:** `ydisk personal files move /plan.pdf --folder /Archive` + +### `ydisk files create` + +create a folder on the Disk at this path + +**Changes something in the service.** + +```sh +ydisk files create <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +**Example:** `ydisk personal files create /Documents/Reports` + +### `ydisk files delete` + +move a file or folder to the Disk's trash; files restore brings it back + +**Changes something in the service.** + +```sh +ydisk files delete <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +**Example:** `ydisk personal files delete /Documents/old.pdf` + +### `ydisk files restore` + +bring a file or folder back from the Disk's trash + +**Changes something in the service.** + +```sh +ydisk files restore <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | its path in the trash, like trash:/old.pdf. | + +**Example:** `ydisk personal files restore trash:/old.pdf` + +### `ydisk files publish` + +open a file or folder to anyone with its public link; asks as files.share does + +**Changes something in the service.** + +```sh +ydisk files publish <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +**Example:** `ydisk personal files publish /Documents/plan.pdf` + +### `ydisk files unpublish` + +close a file's or folder's public link; asks as files.share does + +**Changes something in the service.** + +```sh +ydisk files unpublish <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +**Example:** `ydisk personal files unpublish /Documents/plan.pdf` + +## `ydisk store` + +the shared local store every WireCat tool reads + +### `ydisk store info` + +the store file: where it is, its size, its schema against the one this tool speaks, which tools used it and how many rows it holds, by provider, chat kind, account, year (UTC) and attachment kind, over every account; changes nothing + +```sh +ydisk store info +``` + +**Returns:** store info — path, exists, schema, opens, error, bytes, journal_mode, pages, and 12 more; every field: ydisk commands info store info + +**Example:** `ydisk personal store info --json` + +## `ydisk api` + +the raw Yandex Disk API, one command per operation of its OpenAPI document + +### `ydisk api list` + +list every Yandex Disk API operation this CLI offers, without calling Yandex Disk + +```sh +ydisk api list [query] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Example:** `ydisk personal api list`, `ydisk personal api list effect:destructive --json=command,path` + +### `ydisk api show` + +show one operation's parameters and request schema, without calling Yandex Disk + +```sh +ydisk api show <operation> +``` + +| Argument | | What it is | +|---|---|---| +| `operation` | required | the operation, as api list prints it. | + +**Example:** `ydisk personal api show disk-get --json` + +### `ydisk api disk-get` + +Получить метаинформацию о диске пользователя — read (GET /v1/disk) + +```sh +ydisk api disk-get [options] +``` + +| Option | What it does | +|---|---| +| `--extra-fields <value>` | Дополнительные поля, которые нужно вернуть. | +| `--fields <value>` | Список возвращаемых атрибутов. | + +**Example:** `ydisk personal api disk-get` + +### `ydisk api resources-list` + +Получить метаинформацию о файле или каталоге — read (GET /v1/disk/resources) + +```sh +ydisk api resources-list [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество выводимых вложенных ресурсов. | +| `--offset <value>` | Смещение от начала списка вложенных ресурсов. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | +| `--sort <value>` | Поле для сортировки вложенных ресурсов. | +| `--all` | read every page, as the API pages it. | + +**Example:** `ydisk personal api resources-list --path <value>` + +### `ydisk api resources-create` + +Создать каталог — write (PUT /v1/disk/resources) + +**Changes something in the service.** + +```sh +ydisk api resources-create [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к создаваемой папке. | +| `--fields <value>` | Список возвращаемых атрибутов. | + +**Example:** `ydisk personal api resources-create --path <value>` + +### `ydisk api resources-update` + +Обновить пользовательские данные ресурса — write (PATCH /v1/disk/resources) + +**Changes something in the service.** + +```sh +ydisk api resources-update [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к обновляемому ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--body <json>` | the request body as JSON; - reads it from stdin. | +| `--body-file <path>` | the request body from a JSON file; - is stdin. | + +**Example:** `ydisk personal api resources-update --path <value>` + +### `ydisk api resources-delete` + +Удалить файл или папку — destructive (DELETE /v1/disk/resources) + +**Changes something in the service.** + +```sh +ydisk api resources-delete [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к файлу или папке. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--md5 <value>` | md5 удаляемого файла. | +| `--permanently <value>` | Удалить ресурс не помещая в Корзину. | + +**Example:** `ydisk personal api resources-delete --path <value>` + +### `ydisk api resources-copy` + +Создать копию файла или папки — write (POST /v1/disk/resources/copy) + +**Changes something in the service.** + +```sh +ydisk api resources-copy [options] +``` + +| Option | What it does | +|---|---| +| `--from <value>` | Путь к копируемому ресурсу. | +| `--path <value>` | Путь к создаваемому ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--overwrite <value>` | Перезаписать существующий ресурс. | + +**Example:** `ydisk personal api resources-copy --from <value> --path <value>` + +### `ydisk api resources-files-list` + +Получить список файлов упорядоченный по имени — read (GET /v1/disk/resources/files) + +```sh +ydisk api resources-files-list [options] +``` + +| Option | What it does | +|---|---| +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество последних загруженных файлов в ответе. | +| `--media-type <value>` | Фильтр по медиа типу. Несколько типов перечисляются через запятую. | +| `--offset <value>` | Смещение от начала списка вложенных ресурсов. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | +| `--sort <value>` | Поле для сортировки ресурсов. | +| `--all` | read every page, as the API pages it. | + +**Example:** `ydisk personal api resources-files-list` + +### `ydisk api resources-last-uploaded-list` + +Получить список файлов упорядоченный по дате загрузки — read (GET /v1/disk/resources/last-uploaded) + +```sh +ydisk api resources-last-uploaded-list [options] +``` + +| Option | What it does | +|---|---| +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество последних загруженных файлов в ответе. | +| `--media-type <value>` | Фильтр по медиа типу. Несколько типов перечисляются через запятую. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | + +**Example:** `ydisk personal api resources-last-uploaded-list` + +### `ydisk api resources-move` + +Переместить файл или папку — write (POST /v1/disk/resources/move) + +**Changes something in the service.** + +```sh +ydisk api resources-move [options] +``` + +| Option | What it does | +|---|---| +| `--from <value>` | Путь к перемещаемому ресурсу. | +| `--path <value>` | Путь к создаваемому ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--overwrite <value>` | Перезаписать существующий ресурс. | + +**Example:** `ydisk personal api resources-move --from <value> --path <value>` + +### `ydisk api resources-public-list` + +Получить список опубликованных ресурсов — read (GET /v1/disk/resources/public) + +```sh +ydisk api resources-public-list [options] +``` + +| Option | What it does | +|---|---| +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество выводимых ресурсов. | +| `--offset <value>` | Смещение от начала списка ресурсов. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | +| `--type <value>` | Фильтр по типам ресурсов. | +| `--all` | read every page, as the API pages it. | + +**Example:** `ydisk personal api resources-public-list` + +### `ydisk api resources-publish` + +Опубликовать ресурс — write (PUT /v1/disk/resources/publish) + +**Changes something in the service.** + +```sh +ydisk api resources-publish [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к публикуемому ресурсу. | +| `--allow-address-access <value>` | Возможность клиента обрабатывать ответы от адресного доступа. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--body <json>` | the request body as JSON; - reads it from stdin. | +| `--body-file <path>` | the request body from a JSON file; - is stdin. | + +**Example:** `ydisk personal api resources-publish --path <value>` + +### `ydisk api resources-unpublish` + +Отменить публикацию ресурса — write (PUT /v1/disk/resources/unpublish) + +**Changes something in the service.** + +```sh +ydisk api resources-unpublish [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | + +**Example:** `ydisk personal api resources-unpublish --path <value>` + +### `ydisk api resources-upload-url` + +Загрузить файл в Диск по URL — write (POST /v1/disk/resources/upload) + +**Changes something in the service.** + +```sh +ydisk api resources-upload-url [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь, куда будет помещён ресурс. | +| `--url <value>` | URL внешнего ресурса, который следует загрузить. | +| `--disable-redirects <value>` | Запретить делать редиректы. | +| `--fields <value>` | Список возвращаемых атрибутов. | + +**Example:** `ydisk personal api resources-upload-url --path <value> --url <value>` + +### `ydisk api public-resources-get` + +Получить метаинформацию о публичном файле или каталоге — read (GET /v1/disk/public/resources) + +```sh +ydisk api public-resources-get [options] +``` + +| Option | What it does | +|---|---| +| `--public-key <value>` | Ключ или публичный URL ресурса. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество выводимых вложенных ресурсов. | +| `--offset <value>` | Смещение от начала списка вложенных ресурсов. | +| `--path <value>` | Путь к ресурсу в публичной папке. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | +| `--sort <value>` | Поле для сортировки вложенных ресурсов. | +| `--all` | read every page, as the API pages it. | + +**Example:** `ydisk personal api public-resources-get --public-key <value>` + +### `ydisk api public-settings-update` + +Обновить настройки публичных ссылок — write (PATCH /v1/disk/public/resources/public-settings) + +**Changes something in the service.** + +```sh +ydisk api public-settings-update [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--body <json>` | the request body as JSON; - reads it from stdin. | +| `--body-file <path>` | the request body from a JSON file; - is stdin. | + +**Example:** `ydisk personal api public-settings-update --path <value>` + +### `ydisk api public-resources-save-to-disk` + +Сохранить публичный ресурс в папку Загрузки — write (POST /v1/disk/public/resources/save-to-disk) + +**Changes something in the service.** + +```sh +ydisk api public-resources-save-to-disk [options] +``` + +| Option | What it does | +|---|---| +| `--public-key <value>` | Ключ или публичный URL ресурса. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--name <value>` | Имя, под которым ресурс будет сохранён в папке. | +| `--path <value>` | Путь к копируемому ресурсу в публичной папке. | +| `--save-path <value>` | Путь к папке, в которую будет сохранен ресурс. По умолчанию «Загрузки». | + +**Example:** `ydisk personal api public-resources-save-to-disk --public-key <value>` + +### `ydisk api trash-resources-list` + +Получить содержимое Корзины — read (GET /v1/disk/trash/resources) + +```sh +ydisk api trash-resources-list [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к ресурсу в Корзине. | +| `--apply-photoslice-filter <value>` | Требуется ли отдавать только фотосрез. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество выводимых вложенных ресурсов. | +| `--offset <value>` | Смещение от начала списка вложенных ресурсов. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | +| `--sort <value>` | Поле для сортировки вложенных ресурсов. | +| `--all` | read every page, as the API pages it. | + +**Example:** `ydisk personal api trash-resources-list --path <value>` + +### `ydisk api trash-resources-delete` + +Очистить Корзину — destructive (DELETE /v1/disk/trash/resources) + +**Changes something in the service.** + +```sh +ydisk api trash-resources-delete [options] +``` + +| Option | What it does | +|---|---| +| `--apply-photoslice-filter <value>` | Требуется ли удалять только файлы фотосреза. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--path <value>` | Путь к ресурсу в Корзине. | + +**Example:** `ydisk personal api trash-resources-delete` + +### `ydisk api trash-resources-restore` + +Восстановить ресурс из Корзины — write (PUT /v1/disk/trash/resources/restore) + +**Changes something in the service.** + +```sh +ydisk api trash-resources-restore [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к ресурсу в Корзине. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--name <value>` | Имя, под которым будет восстановлен ресурс. | +| `--overwrite <value>` | Перезаписать существующий ресурс восстанавливаемым. | + +**Example:** `ydisk personal api trash-resources-restore --path <value>` + +### `ydisk api operations-get` + +Получить статус асинхронной операции — read (GET /v1/disk/operations/{operation_id}) + +```sh +ydisk api operations-get [options] +``` + +| Option | What it does | +|---|---| +| `--operation-id <value>` | Идентификатор операции. | +| `--fields <value>` | Список возвращаемых атрибутов. | + +**Example:** `ydisk personal api operations-get --operation-id <value>` + +## `ydisk doctor` + +the state this installation is in, without connecting unless --online + +```sh +ydisk doctor [options] +``` + +| Option | What it does | +|---|---| +| `--online` | also connect once and read the account; sends nothing. | + +**Example:** `ydisk doctor`, `ydisk doctor --json` + +### `ydisk doctor reports` + +problem reports + +#### `ydisk doctor reports show` + +what a problem report holds; writes nothing + +```sh +ydisk doctor reports show +``` + +**Example:** `ydisk doctor reports show` + +#### `ydisk doctor reports create` + +write a problem report to a file, and say where to send it + +**Changes something on this computer only.** + +```sh +ydisk doctor reports create [options] +``` + +| Option | What it does | +|---|---| +| `--run <id>` | the run the report is about; the newest failed one if not given. | +| `--output <file>` | where to write it; a new file in this directory if not given. | + +**Example:** `ydisk doctor reports create --output ./problem-report.json` + +## `ydisk skill` + +the instructions an agent is given for this tool + +### `ydisk skill show` + +print SKILL.md — `ydisk skill install` puts it where Claude Code, Codex, Gemini CLI and OpenClaw look for it, and where Hermes does on request; --for prints the copy already there + +```sh +ydisk skill show [name] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `name` | optional | a part of this skill, or a skill shipped for a task: api-disk, api-disk-trash-resources, api-disk-resources, api-disk-public-resources, api-disk-operations-operation-id, api. | + +| Option | What it does | +|---|---| +| `--for <agents>` | print the copy installed for these agents instead of this version's. One of: `claude`, `agents`. | + +**Example:** `ydisk skill show` + +### `ydisk skill install` + +write SKILL.md to \~/.claude/skills/yandex-disk-cli/ (Claude Code) and \~/.agents/skills/yandex-disk-cli/ (Codex, Gemini CLI, OpenClaw); --for hermes also has Hermes read \~/.agents/skills, which changes Hermes's own settings, so all leaves it out + +**Changes something on this computer only.** + +```sh +ydisk skill install [options] +``` + +| Option | What it does | +|---|---| +| `--for <agents>` | which agents to install for. One of: `claude`, `agents`, `hermes`, `all`. Default: `all`. | + +**Example:** `ydisk skill install --for agents` + +### `ydisk skill status` + +for each place `ydisk skill install` writes to, and for the copy Hermes reads: the path, the version installed there, and whether it is current, stale, missing or unversioned + +```sh +ydisk skill status +``` + +**Example:** `ydisk skill status`, `ydisk skill status --json` + +## `ydisk mcp` + +serve this profile to an agent over MCP and set it up — `claude mcp add ydisk -- ydisk <profile> mcp serve` + +### `ydisk mcp serve` + +serve this profile to an agent over MCP, on stdin and stdout — `claude mcp add ydisk -- ydisk <profile> mcp serve`; `ydisk mcp serve --profiles a,b` or `--profiles all` serves those profiles from one server and each tool asks which + +**Changes something in the service.** + +```sh +ydisk mcp serve [options] +``` + +| Option | What it does | +|---|---| +| `--permission <key=level>` | make a permission stricter for this server only, like files.delete=deny; it never loosens the profile; repeat for more keys. | +| `--profiles <names\|all>` | serve several profiles from one server instead of one: names, comma-separated, or all for every profile. | +| `--http` | serve over HTTP on 127.0.0.1 for ChatGPT and Claude in the browser, behind your tunnel; the profile's permissions decide. | +| `--port <port>` | the local port for --http (default 8765). | +| `--public-url <url>` | the tunnel's https address the browser apps use, e.g. https://<name>.ts.net or https://<name>.ts.net/tg. | + +**Example:** `ydisk personal mcp serve`, `ydisk mcp serve --profiles work,personal`, `ydisk personal mcp serve --http --public-url https://laptop.example.ts.net` + +### `ydisk mcp revoke` + +forget every login `mcp serve --http` gave a browser app, of this profile or of the server `--profiles` names; each app must log in again + +**Changes something on this computer only.** + +```sh +ydisk mcp revoke [options] +``` + +| Option | What it does | +|---|---| +| `--profiles <names\|all>` | serve several profiles from one server instead of one: names, comma-separated, or all for every profile. | + +**Example:** `ydisk personal mcp revoke`, `ydisk mcp revoke --profiles all` + +### `ydisk mcp server` + +start, stop and check `mcp serve --http` in the background; status shows the login code for a browser app + +#### `ydisk mcp server start` + +start `mcp serve --http` apart from this shell and answer once it listens, with its login code + +**Changes something on this computer only.** + +```sh +ydisk mcp server start [options] +``` + +| Option | What it does | +|---|---| +| `--port <port>` | the local port (default 8765). | +| `--public-url <url>` | the tunnel's https address the browser apps use, e.g. https://<name>.ts.net or https://<name>.ts.net/tg. | +| `--permission <key=level>` | make a permission stricter for this server only; repeat for more keys. | +| `--profiles <names\|all>` | the server of several profiles that `mcp serve --profiles` serves: names, comma-separated, or all. | + +**Example:** `ydisk personal mcp server start --public-url https://laptop.example.ts.net` + +#### `ydisk mcp server stop` + +stop `mcp serve --http` — only one that `mcp server start` started + +**Changes something on this computer only.** + +```sh +ydisk mcp server stop [options] +``` + +| Option | What it does | +|---|---| +| `--profiles <names\|all>` | the server of several profiles that `mcp serve --profiles` serves: names, comma-separated, or all. | + +**Example:** `ydisk personal mcp server stop` + +#### `ydisk mcp server status` + +whether `mcp serve --http` runs, on which port and address, the login code for a new browser app, and the apps logged in + +```sh +ydisk mcp server status [options] +``` + +| Option | What it does | +|---|---| +| `--profiles <names\|all>` | the server of several profiles that `mcp serve --profiles` serves: names, comma-separated, or all. | + +**Example:** `ydisk personal mcp server status --json` + +### `ydisk mcp config` + +print the mcpServers entry for Claude Desktop, Cursor and others, with full paths; writes nothing + +```sh +ydisk mcp config [options] +``` + +| Option | What it does | +|---|---| +| `--permission <key=level>` | make a permission stricter for this server only, like files.delete=deny; it never loosens the profile; repeat for more keys. | +| `--profiles <names\|all>` | serve several profiles from one server instead of one: names, comma-separated, or all for every profile. | + +**Example:** `ydisk personal mcp config`, `ydisk mcp config --profiles all` + +### `ydisk mcp add` + +add this profile's local MCP server to Codex or Claude Code + +**Changes something on this computer only.** + +```sh +ydisk mcp add <client> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `client` | required | codex or claude-code. | + +| Option | What it does | +|---|---| +| `--allow-writes` | acknowledge that this profile offers writing tools. | +| `--permission <key=level>` | make a permission stricter for this server only, like files.delete=deny; it never loosens the profile; repeat for more keys. | + +**Example:** `ydisk personal mcp add codex --allow-writes` + +### `ydisk mcp check` + +check this profile's local MCP handshake and tool list + +```sh +ydisk mcp check [options] +``` + +| Option | What it does | +|---|---| +| `--permission <key=level>` | make a permission stricter for this server only, like files.delete=deny; it never loosens the profile; repeat for more keys. | + +**Example:** `ydisk personal mcp check` + +## `ydisk upgrade` + +upgrade ydisk with the package manager that installed it; --check only looks + +**Changes something on this computer only.** + +```sh +ydisk upgrade [options] +``` + +| Option | What it does | +|---|---| +| `--check` | say whether a newer version exists, and install nothing. | + +**Example:** `ydisk upgrade --check` + +## `ydisk config` + +the settings in force, and where each one came from + +### `ydisk config show` + +the profile, the profiles that exist, and each setting with where it came from + +```sh +ydisk config show +``` + +**Example:** `ydisk personal config show` + +### `ydisk config set` + +save a setting to the configuration file + +**Changes something on this computer only.** + +```sh +ydisk config set <setting> <value> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `setting` | required | one of: limit, timeout_ms, color, record, record_input, keep_runs_for_days, keep_successful_runs_for_days, keep_store_runs_for_days, runs_size_limit_mb, permissions, requests_per_minute, search_reranker, embedding_provider, embedding_model, embedding_base_url, embedding_dims, models, update_check, skill_hint, search_stemmers.cyrillic, search_stemmers.latin, owner_languages, crm.<provider>:<account>.links, crm.<provider>:<account>.company-types, crm.<provider>:<account>.scope, crm.<provider>:<account>.unassigned, crm.<provider>:<account>.self, crm.<provider>:<account>.stage-tasks, crm.<provider>:<account>.activities, crm.<provider>:<account>.files.max_files, crm.<provider>:<account>.files.max_file_mb, crm.<provider>:<account>.files.max_run_mb, crm.<provider>:<account>.files.run_minutes, crm.<provider>:<account>.files.days, crm.<provider>:<account>.files.max_total_mb. | +| `value` | required | a number, true or false; for a group tg:work,max:Alice,email:me@x. | + +| Option | What it does | +|---|---| +| `--defaults` | change what every profile gets, rather than this profile. | + +**Example:** `ydisk personal config set limit 20` + +### `ydisk config unset` + +remove a setting from the configuration file + +**Changes something on this computer only.** + +```sh +ydisk config unset <setting> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `setting` | required | one of: limit, timeout_ms, color, record, record_input, keep_runs_for_days, keep_successful_runs_for_days, keep_store_runs_for_days, runs_size_limit_mb, permissions, requests_per_minute, search_reranker, embedding_provider, embedding_model, embedding_base_url, embedding_dims, models, update_check, skill_hint, search_stemmers.cyrillic, search_stemmers.latin, owner_languages, crm.<provider>:<account>.links, crm.<provider>:<account>.company-types, crm.<provider>:<account>.scope, crm.<provider>:<account>.unassigned, crm.<provider>:<account>.self, crm.<provider>:<account>.stage-tasks, crm.<provider>:<account>.activities, crm.<provider>:<account>.files.max_files, crm.<provider>:<account>.files.max_file_mb, crm.<provider>:<account>.files.max_run_mb, crm.<provider>:<account>.files.run_minutes, crm.<provider>:<account>.files.days, crm.<provider>:<account>.files.max_total_mb. | + +| Option | What it does | +|---|---| +| `--defaults` | change what every profile gets, rather than this profile. | + +**Example:** `ydisk personal config unset limit` + +### `ydisk config migrate` + +write each setting the file lacks at its default, keeping yours + +**Changes something on this computer only.** + +```sh +ydisk config migrate +``` + +**Example:** `ydisk config migrate` + +### `ydisk config repair` + +fix broken JSON syntax in the settings file — comments, a missing or extra comma, unquoted keys, single quotes, missing closing brackets at the end — keeping every value, with a backup beside it; refuses anything with more than one reading and changes nothing then + +**Changes something on this computer only.** + +```sh +ydisk config repair [options] +``` + +| Option | What it does | +|---|---| +| `--dry-run` | say what it would fix, and change nothing. | + +**Example:** `ydisk config repair`, `ydisk config repair --dry-run` + +## `ydisk runs` + +recorded runs — what this tool did, and when + +### `ydisk runs list` + +recorded runs, newest first + +```sh +ydisk runs list [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many to show. | +| `--page <n>` | which page, starting at 1. | + +**Returns:** run — run_id, command, started_at, status, cli_version, profile, completed_at, requests, and 23 more; every field: ydisk commands info runs list + +**Example:** `ydisk personal runs list --limit 10` + +### `ydisk runs show` + +one run: what it was, how it ended, and every event it logged + +```sh +ydisk runs show <run-id> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `run-id` | required | an id from `ydisk runs list`. | + +| Option | What it does | +|---|---| +| `--problems` | only failed responses, warnings and crashes. | + +**Returns:** run details — run_id, command, started_at, status, cli_version, directory, event_count, events, and 22 more; every field: ydisk commands info runs show + +**Example:** `ydisk personal runs show run-101` + +### `ydisk runs path` + +the directory holding one run + +```sh +ydisk runs path <run-id> +``` + +| Argument | | What it is | +|---|---|---| +| `run-id` | required | an id from `ydisk runs list`. | + +**Returns:** run location — path; every field: ydisk commands info runs path + +**Example:** `ydisk personal runs path run-101` + +## Códigos de salida + +Decide según el código, no según el texto: el texto puede cambiar, el código no. + +| Code | When | +|---|---| +| `0` | it worked | +| `2` | `validation_error` | +| `3` | `configuration_error` | +| `4` | `authentication_error` | +| `5` | `permission_error` | +| `6` | `not_found` | +| `7` | `confirmation_required` | +| `8` | `rate_limited` | +| `9` | `timeout` | +| `10` | `network_error` | +| `11` | `provider_error` | +| `12` | `provider_unavailable` | +| `13` | `invalid_response` | +| `14` | `outcome_unknown` | +| `15` | `conflict` | +| `130` | `cancelled` | +| `1` | anything else | diff --git a/translations/ydisk/commands.ru.md b/translations/ydisk/commands.ru.md new file mode 100644 index 00000000..a5fe9d41 --- /dev/null +++ b/translations/ydisk/commands.ru.md @@ -0,0 +1,2038 @@ +--- +title: "Команды ydisk" +--- + +<!-- Generated from the command tree by pnpm generate. Do not edit. --> + + +Найдите любую команду ydisk, ее параметры и ответ и будьте уверены, что они совпадают с вашей версией: эта +страница создается из самой программы. + +ИИ-агент читает тот же список в JSON через `ydisk commands --json` и выбирает там команду и ее параметры. Каждый код +выхода означает один вид сбоя, так что скрипт или агент понимает, что пошло не так. Описания команд и параметров +остаются на языке встроенной справки. + +**Первым словом идет профиль**, имя, которое вы выбираете сами: `ydisk personal config show`. `YDISK_PROFILE` +задает профиль для всего сеанса оболочки. Профиль никогда не подставляется сам: команда, которой нужен аккаунт, без +профиля останавливается и показывает профили на этом компьютере. + +## Параметры всех команд + +| Option | What it does | +|---|---| +| `-V, --version` | output the version number. | +| `-v, --verbose` | more detail in what is shown: -v ids, -vv everything we know. Default: `0`. | +| `--json` | machine-readable output: one JSON value on stdout; --json=id,text keeps only those fields. | +| `--jsonl` | machine-readable output: one JSON object per line, for streaming and jq. | +| `--quiet` | diagnostics off; a failure is still said. | +| `--trace` | the connection's own log lines on stderr — never content. | +| `--debug` | on a failure, its whole record — cause and stack — in place of the short line. | +| `--timeout <duration>` | give up on the whole command after this — 30s, 2m, 500ms. | +| `--offline` | answer from what was recorded and never connect; fails if nothing was. | +| `--no-input` | never prompt or open interactive login; piped input remains available. | +| `--max-input-bytes <bytes>` | maximum buffered input bytes (default: 16777216). | +| `--max-output-bytes <bytes>` | maximum machine output bytes (default: 4194304; 0 disables). | +| `--brief` | found items as reference, title, time, author and excerpt only. | +| `--full` | found items with their whole text and every provider field. | +| `--compact` | one line per item for an agent: reference first, text last, paging and next steps as # lines. | +| `--dry-run` | preview parsed arguments and permissions before running the action. | +| `--yes` | go ahead without the question an ask level puts before a write. | +| `--record` | keep this run even where the config says record false; record_input false leaves the typed words out. | +| `--no-record` | do not keep this run, even if it fails. | + +## `ydisk commands` + +every command by section; --json prints its contract, one path per call + +### `ydisk commands info` + +one command contract, or all schemas, error reasons and explicit overrides + +```sh +ydisk commands info [path] +``` + +| Argument | | What it is | +|---|---|---| +| `path` | optional | one command path; without one, export schemas, error reasons and explicit overrides. | + +**Example:** `ydisk commands info commands` + +## `ydisk session` + +keep this profile's Yandex Disk token in the OS keyring + +### `ydisk session start` + +sign this profile in: the Yandex Disk API token is asked hidden or read from stdin, never taken as an argument, checked against the service, and only then kept in the keyring, or in a private file + +**Changes something on this computer only.** + +```sh +ydisk session start [options] +``` + +| Option | What it does | +|---|---| +| `--credential-storage <storage>` | where the token is kept: keyring, which falls back to a private file by itself when no keyring works; file skips the keyring, so keep it for a computer that has none. Default: `keyring`. | + +**Example:** `ydisk personal session start` + +### `ydisk session status` + +show where this profile's token comes from: YDISK_TOKEN, the keyring or a file, never the token; --check asks Yandex Disk whose token it is + +```sh +ydisk session status [options] +``` + +| Option | What it does | +|---|---| +| `--check` | ask Yandex Disk whether the token still works, and whose it is. | + +**Example:** `ydisk personal session status`, `ydisk personal session status --check --json` + +### `ydisk session end` + +forget this profile's token on this computer; the token itself stays valid in Yandex Disk + +**Changes something on this computer only.** + +```sh +ydisk session end +``` + +**Example:** `ydisk personal session end` + +### `ydisk session list` + +list the profiles on this computer and whether each has a token; picks none + +```sh +ydisk session list +``` + +**Example:** `ydisk session list`, `ydisk session list --json` + +## `ydisk account` + +this profile on this computer + +### `ydisk account remove` + +sign the profile out, then forget it on this computer: its settings, its saved sign-in and its files; --keep-data leaves its messages in the store, where search still finds them, --delete-data deletes them; asks first, or --yes + +**Changes something on this computer only.** + +```sh +ydisk account remove [options] +``` + +| Option | What it does | +|---|---| +| `--keep-data` | leave what the store holds of this account, still searchable. | +| `--delete-data` | delete what the store and the tool's own files hold of this account. | +| `--dry-run` | list what it would remove and keep, and change nothing. | + +**Returns:** account removal — profile, data, dry_run, account, revoked, config_file, removed, kept; every field: ydisk commands info account remove + +**Example:** `ydisk personal account remove --keep-data --dry-run`, `ydisk personal account remove --delete-data --yes` + +## `ydisk folders` + +choose the Disk folders sync copies + +### `ydisk folders add` + +import a folder and everything under it on the next sync + +**Changes something on this computer only.** + +```sh +ydisk folders add <folder> +``` + +| Argument | | What it is | +|---|---|---| +| `folder` | required | Disk path to add, like /Documents; its id to remove. | + +**Example:** `ydisk personal folders add /Documents` + +### `ydisk folders list` + +list the folder ids sync imports + +```sh +ydisk folders list [query] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Returns:** selected folder — id; every field: ydisk commands info folders list + +**Example:** `ydisk personal folders list` + +### `ydisk folders browse` + +list Disk folders one level at a time, live, to choose one for folders add; has_children says whether a folder holds a folder, or is null when the level has more than 20 folders and it is not looked up + +```sh +ydisk folders browse [options] +``` + +| Option | What it does | +|---|---| +| `--folder <folder>` | the Disk folder to list inside, by its path; the top of the Disk without it. | +| `--cursor <cursor>` | go on from where the last page stopped; page.next_cursor gives it, with the same --folder. | + +**Next usually:** `ydisk folders add <folder>` + +**Example:** `ydisk personal folders browse`, `ydisk personal folders browse --folder /Work --json` + +### `ydisk folders remove` + +stop importing a folder; the next sync drops its documents + +**Changes something on this computer only.** + +```sh +ydisk folders remove <folder> +``` + +| Argument | | What it is | +|---|---|---| +| `folder` | required | Disk path to add, like /Documents; its id to remove. | + +**Example:** `ydisk personal folders remove FOLDER_ID` + +## `ydisk sync` + +import what changed in the chosen folders, and finish an unfinished sync; one sync walks about 10000 entries under the chosen folders, saves where it stopped, and the next sync goes on from there + +**Changes something on this computer only.** + +```sh +ydisk sync [options] +``` + +| Option | What it does | +|---|---| +| `--limit <n>` | how many files to read from Yandex Disk in this run. Default: `200`. | +| `--rescan` | read every chosen folder again instead of only what changed; each --rescan starts the walk over, so run it once and continue with a plain sync. | +| `--embed` | also index pending text for meaning search, with a model already downloaded. | + +**Example:** `ydisk personal sync`, `ydisk personal sync --rescan --limit 500` + +## `ydisk status` + +show the last sync, imported documents and pending work + +```sh +ydisk status +``` + +**Example:** `ydisk personal status` + +## `ydisk documents` + +read the Yandex Disk files synced to this computer + +### `ydisk documents list` + +list the synced files with their Disk paths + +```sh +ydisk documents list [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many documents to return. Default: `50`. | +| `--page <n>` | which page to return. Default: `1`. | + +**Next usually:** `ydisk documents show <document>`, `ydisk documents context <document>`, `ydisk tags list <document> [query]` + +**Example:** `ydisk personal documents list`, `ydisk personal documents list tag:budget`, `ydisk personal documents list person:PERSON_UID --limit 10` + +### `ydisk documents show` + +show an imported document's text, tabs and metadata + +```sh +ydisk documents show <document> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | file id (resource_id) or a search hit's document: ref. | + +**Example:** `ydisk personal documents show DOC_ID`, `ydisk personal documents show document:42 --offline` + +### `ydisk documents export` + +write an imported document to a new Markdown file + +**Changes something on this computer only.** + +```sh +ydisk documents export <document> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | file id (resource_id) or a search hit's document: ref. | + +| Option | What it does | +|---|---| +| `--output <file>` | path of the Markdown file to write; an existing file is refused. | + +**Example:** `ydisk personal documents export DOC_ID --output notes.md` + +### `ydisk documents context` + +show a document with its tags, relationships, notes, memories and editors + +```sh +ydisk documents context <document> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | + +**Example:** `ydisk personal documents context DOC_ID` + +## `ydisk search` + +search imported documents by words, and by meaning when indexed + +```sh +ydisk search <query> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | required | words to look for, and fields such as tag: and date: that every hit must match. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many results to return. Default: `20`. | +| `--page <n>` | which page to return. Default: `1`. | +| `--exact` | match the words exactly: no word forms, no meaning. | + +**Example:** `ydisk personal search budget`, `ydisk personal search "quarterly plan" --exact --limit 5` + +## `ydisk catalog` + +browse stored Yandex Disk files and folders offline + +### `ydisk catalog import` + +put cached file and folder metadata into the shared database + +**Changes something on this computer only.** + +```sh +ydisk catalog import +``` + +**Example:** `ydisk personal catalog import --offline` + +### `ydisk catalog show` + +show stored metadata and the stable file or folder reference + +```sh +ydisk catalog show <file> +``` + +| Argument | | What it is | +|---|---|---| +| `file` | required | Yandex Disk file or folder id, or its URL. | + +**Next usually:** `ydisk documents show <document>`, `ydisk documents context <document>`, `ydisk tags list <document> [query]` + +**Example:** `ydisk personal catalog show FILE_ID --offline` + +### `ydisk catalog list` + +list cached files and folders using metadata queries + +```sh +ydisk catalog list [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | optional | metadata query: kind, mime, name, parent, person, tag; AND, OR, NOT. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many entries to return (at most 1000). Default: `50`. | +| `--page <n>` | which page to return. Default: `1`. | + +**Next usually:** `ydisk documents show <document>`, `ydisk documents context <document>`, `ydisk tags list <document> [query]` + +**Example:** `ydisk personal catalog list "parent:FOLDER_ID AND kind:file" --offline` + +### `ydisk catalog search` + +search cached names, descriptions, types and observed people + +```sh +ydisk catalog search <query> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | required | metadata query: kind, mime, name, parent, person, tag; AND, OR, NOT. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many entries to return (at most 1000). Default: `50`. | +| `--page <n>` | which page to return. Default: `1`. | + +**Next usually:** `ydisk documents show <document>`, `ydisk documents context <document>`, `ydisk tags list <document> [query]` + +**Example:** `ydisk personal catalog search "budget AND person:Rin*" --offline` + +### `ydisk catalog tree` + +show the cached hierarchy below a folder or all selected roots + +```sh +ydisk catalog tree [folder] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `folder` | optional | Yandex Disk folder id or URL; defaults to the explicitly selected profile's roots. | + +| Option | What it does | +|---|---| +| `--depth <n>` | maximum descendant depth, from 0 to 50. Default: `5`. | + +**Example:** `ydisk personal catalog tree --offline`, `ydisk personal catalog tree FOLDER_ID --depth 3 --offline` + +### `ydisk catalog tags` + +add owner tags to cached files or folders + +#### `ydisk catalog tags list` + +list local tags on a cached file or folder + +```sh +ydisk catalog tags list <file> [query] +``` + +| Argument | | What it is | +|---|---|---| +| `file` | required | Yandex Disk file or folder id, or its URL. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Returns:** document tag — tag; every field: ydisk commands info catalog tags list + +**Example:** `ydisk personal catalog tags list FOLDER_ID --offline` + +#### `ydisk catalog tags add` + +add local tags on a cached file or folder + +**Changes something on this computer only.** + +```sh +ydisk catalog tags add <file> <tags> +``` + +| Argument | | What it is | +|---|---|---| +| `file` | required | Yandex Disk file or folder id, or its URL. | +| `tags` | required | local tag names. | + +**Example:** `ydisk personal catalog tags add FOLDER_ID project --offline` + +#### `ydisk catalog tags remove` + +remove local tags on a cached file or folder + +**Changes something on this computer only.** + +```sh +ydisk catalog tags remove <file> <tags> +``` + +| Argument | | What it is | +|---|---|---| +| `file` | required | Yandex Disk file or folder id, or its URL. | +| `tags` | required | local tag names. | + +**Example:** `ydisk personal catalog tags remove FOLDER_ID project --offline` + +## `ydisk tags` + +label imported documents; labels survive a sync + +### `ydisk tags list` + +list a document's tags + +```sh +ydisk tags list <document> [query] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Returns:** document tag — tag; every field: ydisk commands info tags list + +**Example:** `ydisk personal tags list DOC_ID` + +### `ydisk tags add` + +tag a document + +**Changes something on this computer only.** + +```sh +ydisk tags add <document> <tags> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `tags` | required | one or more tags. | + +**Example:** `ydisk personal tags add DOC_ID budget q3` + +### `ydisk tags remove` + +untag a document + +**Changes something on this computer only.** + +```sh +ydisk tags remove <document> <tags> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `tags` | required | one or more tags. | + +**Example:** `ydisk personal tags remove DOC_ID budget q3` + +## `ydisk relationships` + +connect a document to people, projects, notes and other references + +### `ydisk relationships list` + +list a document's relationships + +```sh +ydisk relationships list <document> [query] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Returns:** document relationship — id, from, to, kind, role, confirmed, origin; every field: ydisk commands info relationships list + +**Example:** `ydisk personal relationships list DOC_ID` + +### `ydisk relationships add` + +connect a document to another reference + +**Changes something on this computer only.** + +```sh +ydisk relationships add <document> <reference> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `reference` | required | what it connects to, such as person:<uid>, project:<id> or note:<id>. | + +| Option | What it does | +|---|---| +| `--kind <kind>` | how the two relate. One of: `links-to`, `about`, `evidence`, `created-from`, `related-to`, `assigned-to`. Default: `related-to`. | +| `--role <role>` | the part the reference plays, in a word or two. | +| `--reason <text>` | why the two are connected. | + +**Example:** `ydisk personal relationships add DOC_ID project:PROJECT_ID --kind about`, `ydisk personal relationships add DOC_ID person:PERSON_UID --kind assigned-to --role reviewer` + +### `ydisk relationships remove` + +remove one of a document's relationships + +**Changes something on this computer only.** + +```sh +ydisk relationships remove <document> <relationship-id> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `relationship-id` | required | id, as relationships list prints it. | + +**Example:** `ydisk personal relationships remove DOC_ID LINK_ID` + +## `ydisk notes` + +write notes about an imported document + +### `ydisk notes add` + +write a note about a document + +**Changes something on this computer only.** + +```sh +ydisk notes add <document> <text> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `text` | required | the note's text. | + +| Option | What it does | +|---|---| +| `--title <title>` | a title for the note. | + +**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes add + +**Next usually:** `ydisk notes show <document> <note>`, `ydisk notes edit <document> <note> <text>`, `ydisk notes remove <document> <note>` + +**Example:** `ydisk personal notes add DOC_ID "Check the numbers" --title Review` + +### `ydisk notes list` + +list a document's notes + +```sh +ydisk notes list <document> [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many notes to return. Default: `50`. | +| `--page <n>` | which page to return. Default: `1`. | + +**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes list + +**Next usually:** `ydisk notes show <document> <note>`, `ydisk notes edit <document> <note> <text>`, `ydisk notes remove <document> <note>` + +**Example:** `ydisk personal notes list DOC_ID`, `ydisk personal notes list DOC_ID text:review --limit 10` + +### `ydisk notes show` + +show one note + +```sh +ydisk notes show <document> <note> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `note` | required | note:<id> reference, as notes list prints it. | + +**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes show + +**Next usually:** `ydisk notes edit <document> <note> <text>`, `ydisk notes remove <document> <note>` + +**Example:** `ydisk personal notes show DOC_ID note:NOTE_ID` + +### `ydisk notes edit` + +replace a note's text + +**Changes something on this computer only.** + +```sh +ydisk notes edit <document> <note> <text> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `note` | required | note:<id> reference, as notes list prints it. | +| `text` | required | the note's new text. | + +| Option | What it does | +|---|---| +| `--revision <n>` | revision from notes show; a newer note is not overwritten. | + +**Returns:** note — ref, id, source, folder_id, path, title, text, revision, and 15 more; every field: ydisk commands info notes edit + +**Next usually:** `ydisk notes show <document> <note>`, `ydisk notes remove <document> <note>` + +**Example:** `ydisk personal notes edit DOC_ID note:NOTE_ID "Numbers checked" --revision 2` + +### `ydisk notes remove` + +delete one note + +**Changes something on this computer only.** + +```sh +ydisk notes remove <document> <note> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `note` | required | note:<id> reference, as notes list prints it. | + +**Example:** `ydisk personal notes remove DOC_ID note:NOTE_ID` + +## `ydisk memories` + +keep what was learned from a document, with evidence; an agent's stay proposed + +### `ydisk memories add` + +record a memory about a document + +**Changes something on this computer only.** + +```sh +ydisk memories add <document> <text> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `text` | required | what to remember. | + +| Option | What it does | +|---|---| +| `--scope <scope>` | whose memory it is: personal or work. One of: `personal`, `work`. | +| `--kind <kind>` | what kind of memory it is. One of: `summary`, `digest`, `preference`. Default: `summary`. | +| `--supersedes <ref>` | a memory:<id> about the same document that this one replaces. | + +**Example:** `ydisk personal memories add DOC_ID "The team prefers async reviews" --scope work --kind preference` + +### `ydisk memories list` + +list a document's memories + +```sh +ydisk memories list <document> [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many memories to return. Default: `50`. | + +**Returns:** memory — ref, id, kind, text, subject, author, model, confidence, and 13 more; every field: ydisk commands info memories list + +**Example:** `ydisk personal memories list DOC_ID scope:work`, `ydisk personal memories list DOC_ID kind:preference status:confirmed` + +### `ydisk memories show` + +show one memory + +```sh +ydisk memories show <document> <memory> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `memory` | required | memory:<id> reference, as memories list prints it. | + +**Example:** `ydisk personal memories show DOC_ID memory:MEMORY_ID` + +### `ydisk memories confirm` + +confirm a proposed memory as true + +**Changes something on this computer only.** + +```sh +ydisk memories confirm <document> <memory> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `memory` | required | memory:<id> reference, as memories list prints it. | + +**Example:** `ydisk personal memories confirm DOC_ID memory:MEMORY_ID` + +### `ydisk memories stale` + +mark a memory as out of date + +**Changes something on this computer only.** + +```sh +ydisk memories stale <document> <memory> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `memory` | required | memory:<id> reference, as memories list prints it. | + +**Example:** `ydisk personal memories stale DOC_ID memory:MEMORY_ID` + +### `ydisk memories search` + +search a document's memories by words + +```sh +ydisk memories search <document> <query> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | required | words to look for, and scope:personal or scope:work — the fields are below. | + +**Returns:** memory — ref, id, kind, text, subject, author, model, confidence, and 13 more; every field: ydisk commands info memories search + +**Example:** `ydisk personal memories search DOC_ID reviews scope:work`, `ydisk personal memories search DOC_ID "async reviews"` + +### `ydisk memories extract` + +send a document's text to the model and show the memories it proposes + +**Changes something in the service.** + +```sh +ydisk memories extract <document> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | + +| Option | What it does | +|---|---| +| `--scope <scope>` | whose memories they become: personal or work. One of: `personal`, `work`. | +| `--tab <id>` | send only this tab of the document. | +| `--yes` | save the proposals, each with its quote and the document's version. | + +**Example:** `ydisk personal memories extract DOC_ID --scope work`, `ydisk personal memories extract DOC_ID --scope work --yes` + +## `ydisk facts` + +what happened, as a document shows it; an agent's stay proposed until confirmed + +### `ydisk facts add` + +record a fact a document shows + +**Changes something on this computer only.** + +```sh +ydisk facts add <document> <statement> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `statement` | required | the fact, in one sentence. | + +| Option | What it does | +|---|---| +| `--type <type>` | what kind of fact it is. One of: `fact`, `statement`, `question`, `decision`, `promise`. Default: `fact`. | +| `--scope <scope>` | whose fact it is: personal or work. One of: `personal`, `work`. | +| `--supersedes <ref>` | a decision only: the decision this one replaces. | +| `--occurred-time <time>` | when it happened, as the evidence shows, ISO 8601; a time without a zone is read in this computer's zone, a date alone as its midnight. | + +**Example:** `ydisk personal facts add DOC_ID "Budget approved" --type decision --scope work` + +### `ydisk facts list` + +list a document's facts + +```sh +ydisk facts list <document> [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many facts to return. Default: `50`. | + +**Returns:** fact — ref, id, kind, text, status, project, subject, occurred_at, and 14 more; every field: ydisk commands info facts list + +**Example:** `ydisk personal facts list DOC_ID status:proposed`, `ydisk personal facts list DOC_ID kind:decision` + +### `ydisk facts show` + +show one fact + +```sh +ydisk facts show <document> <fact> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `fact` | required | fact:<id> reference, as facts list prints it. | + +**Example:** `ydisk personal facts show DOC_ID fact:FACT_ID` + +### `ydisk facts confirm` + +confirm a proposed fact; a decision it supersedes stops holding + +**Changes something on this computer only.** + +```sh +ydisk facts confirm <document> <fact> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `fact` | required | fact:<id> reference, as facts list prints it. | + +**Example:** `ydisk personal facts confirm DOC_ID fact:FACT_ID` + +### `ydisk facts reverse` + +an accepted decision no longer holds, and nothing replaced it + +**Changes something on this computer only.** + +```sh +ydisk facts reverse <document> <fact> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `fact` | required | fact:<id> reference, as facts list prints it. | + +**Example:** `ydisk personal facts reverse DOC_ID fact:FACT_ID` + +## `ydisk identities` + +the Yandex Disk accounts seen on a document, and the people they belong to + +### `ydisk identities list` + +list the people Yandex Disk shows for a document + +```sh +ydisk identities list <document> [query] +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Returns:** document identity — remote_id, provider, role, person; every field: ydisk commands info identities list + +**Example:** `ydisk personal identities list DOC_ID` + +### `ydisk identities link` + +record that a Yandex Disk account belongs to a known person + +**Changes something on this computer only.** + +```sh +ydisk identities link <document> <disk-id> <person> +``` + +| Argument | | What it is | +|---|---|---| +| `document` | required | Yandex Disk file or folder id or URL in the local catalog, or a document:<n> ref. | +| `disk-id` | required | Yandex Disk account id, as identities list prints it. | +| `person` | required | person:<uid> reference of someone already known. | + +**Example:** `ydisk personal identities link DOC_ID DISK_ID person:PERSON_UID` + +## `ydisk files` + +the files on Yandex Disk, live: list, read, download, upload and change them + +### `ydisk files list` + +list what a Disk folder holds, live, a page at a time + +```sh +ydisk files list [options] +``` + +| Option | What it does | +|---|---| +| `--folder <folder>` | the Disk folder to list, by its path; the top of the Disk without it. | +| `--cursor <cursor>` | go on from where the last page stopped; page.next_cursor gives it, with the same --folder. | + +**Next usually:** `ydisk files show <path>`, `ydisk files download <path>` + +**Example:** `ydisk personal files list`, `ydisk personal files list --folder /Documents --json` + +### `ydisk files show` + +show one file or folder on the Disk, live + +```sh +ydisk files show <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +**Next usually:** `ydisk files download <path>` + +**Example:** `ydisk personal files show /plan.pdf` + +### `ydisk files download` + +read a Disk file's text (PDF, docx, xlsx, CSV, TSV, text, Markdown), or with --output save the file itself; the token never goes to the download host + +**Changes something on this computer only.** + +```sh +ydisk files download <path> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +| Option | What it does | +|---|---| +| `--output <file>` | save the file here instead of answering its text. | +| `--replace` | replace an existing output file. | + +**Example:** `ydisk personal files download /notes.md --json`, `ydisk personal files download /plan.pdf --output ./plan.pdf` + +### `ydisk files upload` + +put a local file on the Disk; --replace replaces one already there and asks as files.delete does. Credential files, browser profiles and the WireCat folders are refused + +**Changes something in the service.** + +```sh +ydisk files upload <file> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `file` | required | local file to upload. | + +| Option | What it does | +|---|---| +| `--folder <folder>` | the Disk folder to put it in, by its path; the top of the Disk without it. | +| `--name <name>` | its name on the Disk; the local name without it. | +| `--replace` | replace a file already at that path. | +| `--allow-any-file` | send a file from a place that is otherwise refused. | + +**Example:** `ydisk personal files upload ./plan.pdf --folder /Documents` + +### `ydisk files copy` + +copy a file or folder on the Disk into --folder, under --name or its own; --replace replaces what is there and asks as files.delete does + +**Changes something in the service.** + +```sh +ydisk files copy <path> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +| Option | What it does | +|---|---| +| `--folder <folder>` | the Disk folder it goes into, by its path. | +| `--name <name>` | its name there; its own without it. | +| `--replace` | replace what is already there. | + +**Example:** `ydisk personal files copy /plan.pdf --folder /Archive` + +### `ydisk files move` + +move a file or folder on the Disk into --folder, under --name or its own; --replace replaces what is there and asks as files.delete does + +**Changes something in the service.** + +```sh +ydisk files move <path> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +| Option | What it does | +|---|---| +| `--folder <folder>` | the Disk folder it goes into, by its path. | +| `--name <name>` | its name there; its own without it. | +| `--replace` | replace what is already there. | + +**Example:** `ydisk personal files move /plan.pdf --folder /Archive` + +### `ydisk files create` + +create a folder on the Disk at this path + +**Changes something in the service.** + +```sh +ydisk files create <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +**Example:** `ydisk personal files create /Documents/Reports` + +### `ydisk files delete` + +move a file or folder to the Disk's trash; files restore brings it back + +**Changes something in the service.** + +```sh +ydisk files delete <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +**Example:** `ydisk personal files delete /Documents/old.pdf` + +### `ydisk files restore` + +bring a file or folder back from the Disk's trash + +**Changes something in the service.** + +```sh +ydisk files restore <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | its path in the trash, like trash:/old.pdf. | + +**Example:** `ydisk personal files restore trash:/old.pdf` + +### `ydisk files publish` + +open a file or folder to anyone with its public link; asks as files.share does + +**Changes something in the service.** + +```sh +ydisk files publish <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +**Example:** `ydisk personal files publish /Documents/plan.pdf` + +### `ydisk files unpublish` + +close a file's or folder's public link; asks as files.share does + +**Changes something in the service.** + +```sh +ydisk files unpublish <path> +``` + +| Argument | | What it is | +|---|---|---| +| `path` | required | Disk path, like /Documents/plan.pdf or disk:/Documents/plan.pdf. | + +**Example:** `ydisk personal files unpublish /Documents/plan.pdf` + +## `ydisk store` + +the shared local store every WireCat tool reads + +### `ydisk store info` + +the store file: where it is, its size, its schema against the one this tool speaks, which tools used it and how many rows it holds, by provider, chat kind, account, year (UTC) and attachment kind, over every account; changes nothing + +```sh +ydisk store info +``` + +**Returns:** store info — path, exists, schema, opens, error, bytes, journal_mode, pages, and 12 more; every field: ydisk commands info store info + +**Example:** `ydisk personal store info --json` + +## `ydisk api` + +the raw Yandex Disk API, one command per operation of its OpenAPI document + +### `ydisk api list` + +list every Yandex Disk API operation this CLI offers, without calling Yandex Disk + +```sh +ydisk api list [query] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +**Example:** `ydisk personal api list`, `ydisk personal api list effect:destructive --json=command,path` + +### `ydisk api show` + +show one operation's parameters and request schema, without calling Yandex Disk + +```sh +ydisk api show <operation> +``` + +| Argument | | What it is | +|---|---|---| +| `operation` | required | the operation, as api list prints it. | + +**Example:** `ydisk personal api show disk-get --json` + +### `ydisk api disk-get` + +Получить метаинформацию о диске пользователя — read (GET /v1/disk) + +```sh +ydisk api disk-get [options] +``` + +| Option | What it does | +|---|---| +| `--extra-fields <value>` | Дополнительные поля, которые нужно вернуть. | +| `--fields <value>` | Список возвращаемых атрибутов. | + +**Example:** `ydisk personal api disk-get` + +### `ydisk api resources-list` + +Получить метаинформацию о файле или каталоге — read (GET /v1/disk/resources) + +```sh +ydisk api resources-list [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество выводимых вложенных ресурсов. | +| `--offset <value>` | Смещение от начала списка вложенных ресурсов. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | +| `--sort <value>` | Поле для сортировки вложенных ресурсов. | +| `--all` | read every page, as the API pages it. | + +**Example:** `ydisk personal api resources-list --path <value>` + +### `ydisk api resources-create` + +Создать каталог — write (PUT /v1/disk/resources) + +**Changes something in the service.** + +```sh +ydisk api resources-create [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к создаваемой папке. | +| `--fields <value>` | Список возвращаемых атрибутов. | + +**Example:** `ydisk personal api resources-create --path <value>` + +### `ydisk api resources-update` + +Обновить пользовательские данные ресурса — write (PATCH /v1/disk/resources) + +**Changes something in the service.** + +```sh +ydisk api resources-update [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к обновляемому ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--body <json>` | the request body as JSON; - reads it from stdin. | +| `--body-file <path>` | the request body from a JSON file; - is stdin. | + +**Example:** `ydisk personal api resources-update --path <value>` + +### `ydisk api resources-delete` + +Удалить файл или папку — destructive (DELETE /v1/disk/resources) + +**Changes something in the service.** + +```sh +ydisk api resources-delete [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к файлу или папке. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--md5 <value>` | md5 удаляемого файла. | +| `--permanently <value>` | Удалить ресурс не помещая в Корзину. | + +**Example:** `ydisk personal api resources-delete --path <value>` + +### `ydisk api resources-copy` + +Создать копию файла или папки — write (POST /v1/disk/resources/copy) + +**Changes something in the service.** + +```sh +ydisk api resources-copy [options] +``` + +| Option | What it does | +|---|---| +| `--from <value>` | Путь к копируемому ресурсу. | +| `--path <value>` | Путь к создаваемому ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--overwrite <value>` | Перезаписать существующий ресурс. | + +**Example:** `ydisk personal api resources-copy --from <value> --path <value>` + +### `ydisk api resources-files-list` + +Получить список файлов упорядоченный по имени — read (GET /v1/disk/resources/files) + +```sh +ydisk api resources-files-list [options] +``` + +| Option | What it does | +|---|---| +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество последних загруженных файлов в ответе. | +| `--media-type <value>` | Фильтр по медиа типу. Несколько типов перечисляются через запятую. | +| `--offset <value>` | Смещение от начала списка вложенных ресурсов. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | +| `--sort <value>` | Поле для сортировки ресурсов. | +| `--all` | read every page, as the API pages it. | + +**Example:** `ydisk personal api resources-files-list` + +### `ydisk api resources-last-uploaded-list` + +Получить список файлов упорядоченный по дате загрузки — read (GET /v1/disk/resources/last-uploaded) + +```sh +ydisk api resources-last-uploaded-list [options] +``` + +| Option | What it does | +|---|---| +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество последних загруженных файлов в ответе. | +| `--media-type <value>` | Фильтр по медиа типу. Несколько типов перечисляются через запятую. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | + +**Example:** `ydisk personal api resources-last-uploaded-list` + +### `ydisk api resources-move` + +Переместить файл или папку — write (POST /v1/disk/resources/move) + +**Changes something in the service.** + +```sh +ydisk api resources-move [options] +``` + +| Option | What it does | +|---|---| +| `--from <value>` | Путь к перемещаемому ресурсу. | +| `--path <value>` | Путь к создаваемому ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--overwrite <value>` | Перезаписать существующий ресурс. | + +**Example:** `ydisk personal api resources-move --from <value> --path <value>` + +### `ydisk api resources-public-list` + +Получить список опубликованных ресурсов — read (GET /v1/disk/resources/public) + +```sh +ydisk api resources-public-list [options] +``` + +| Option | What it does | +|---|---| +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество выводимых ресурсов. | +| `--offset <value>` | Смещение от начала списка ресурсов. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | +| `--type <value>` | Фильтр по типам ресурсов. | +| `--all` | read every page, as the API pages it. | + +**Example:** `ydisk personal api resources-public-list` + +### `ydisk api resources-publish` + +Опубликовать ресурс — write (PUT /v1/disk/resources/publish) + +**Changes something in the service.** + +```sh +ydisk api resources-publish [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к публикуемому ресурсу. | +| `--allow-address-access <value>` | Возможность клиента обрабатывать ответы от адресного доступа. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--body <json>` | the request body as JSON; - reads it from stdin. | +| `--body-file <path>` | the request body from a JSON file; - is stdin. | + +**Example:** `ydisk personal api resources-publish --path <value>` + +### `ydisk api resources-unpublish` + +Отменить публикацию ресурса — write (PUT /v1/disk/resources/unpublish) + +**Changes something in the service.** + +```sh +ydisk api resources-unpublish [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | + +**Example:** `ydisk personal api resources-unpublish --path <value>` + +### `ydisk api resources-upload-url` + +Загрузить файл в Диск по URL — write (POST /v1/disk/resources/upload) + +**Changes something in the service.** + +```sh +ydisk api resources-upload-url [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь, куда будет помещён ресурс. | +| `--url <value>` | URL внешнего ресурса, который следует загрузить. | +| `--disable-redirects <value>` | Запретить делать редиректы. | +| `--fields <value>` | Список возвращаемых атрибутов. | + +**Example:** `ydisk personal api resources-upload-url --path <value> --url <value>` + +### `ydisk api public-resources-get` + +Получить метаинформацию о публичном файле или каталоге — read (GET /v1/disk/public/resources) + +```sh +ydisk api public-resources-get [options] +``` + +| Option | What it does | +|---|---| +| `--public-key <value>` | Ключ или публичный URL ресурса. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество выводимых вложенных ресурсов. | +| `--offset <value>` | Смещение от начала списка вложенных ресурсов. | +| `--path <value>` | Путь к ресурсу в публичной папке. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | +| `--sort <value>` | Поле для сортировки вложенных ресурсов. | +| `--all` | read every page, as the API pages it. | + +**Example:** `ydisk personal api public-resources-get --public-key <value>` + +### `ydisk api public-settings-update` + +Обновить настройки публичных ссылок — write (PATCH /v1/disk/public/resources/public-settings) + +**Changes something in the service.** + +```sh +ydisk api public-settings-update [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к ресурсу. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--body <json>` | the request body as JSON; - reads it from stdin. | +| `--body-file <path>` | the request body from a JSON file; - is stdin. | + +**Example:** `ydisk personal api public-settings-update --path <value>` + +### `ydisk api public-resources-save-to-disk` + +Сохранить публичный ресурс в папку Загрузки — write (POST /v1/disk/public/resources/save-to-disk) + +**Changes something in the service.** + +```sh +ydisk api public-resources-save-to-disk [options] +``` + +| Option | What it does | +|---|---| +| `--public-key <value>` | Ключ или публичный URL ресурса. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--name <value>` | Имя, под которым ресурс будет сохранён в папке. | +| `--path <value>` | Путь к копируемому ресурсу в публичной папке. | +| `--save-path <value>` | Путь к папке, в которую будет сохранен ресурс. По умолчанию «Загрузки». | + +**Example:** `ydisk personal api public-resources-save-to-disk --public-key <value>` + +### `ydisk api trash-resources-list` + +Получить содержимое Корзины — read (GET /v1/disk/trash/resources) + +```sh +ydisk api trash-resources-list [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к ресурсу в Корзине. | +| `--apply-photoslice-filter <value>` | Требуется ли отдавать только фотосрез. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--limit <value>` | Количество выводимых вложенных ресурсов. | +| `--offset <value>` | Смещение от начала списка вложенных ресурсов. | +| `--preview-crop <value>` | Разрешить обрезку превью. | +| `--preview-size <value>` | Размер превью. | +| `--sort <value>` | Поле для сортировки вложенных ресурсов. | +| `--all` | read every page, as the API pages it. | + +**Example:** `ydisk personal api trash-resources-list --path <value>` + +### `ydisk api trash-resources-delete` + +Очистить Корзину — destructive (DELETE /v1/disk/trash/resources) + +**Changes something in the service.** + +```sh +ydisk api trash-resources-delete [options] +``` + +| Option | What it does | +|---|---| +| `--apply-photoslice-filter <value>` | Требуется ли удалять только файлы фотосреза. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--path <value>` | Путь к ресурсу в Корзине. | + +**Example:** `ydisk personal api trash-resources-delete` + +### `ydisk api trash-resources-restore` + +Восстановить ресурс из Корзины — write (PUT /v1/disk/trash/resources/restore) + +**Changes something in the service.** + +```sh +ydisk api trash-resources-restore [options] +``` + +| Option | What it does | +|---|---| +| `--path <value>` | Путь к ресурсу в Корзине. | +| `--fields <value>` | Список возвращаемых атрибутов. | +| `--force-async <value>` | Выполнить асинхронно. | +| `--name <value>` | Имя, под которым будет восстановлен ресурс. | +| `--overwrite <value>` | Перезаписать существующий ресурс восстанавливаемым. | + +**Example:** `ydisk personal api trash-resources-restore --path <value>` + +### `ydisk api operations-get` + +Получить статус асинхронной операции — read (GET /v1/disk/operations/{operation_id}) + +```sh +ydisk api operations-get [options] +``` + +| Option | What it does | +|---|---| +| `--operation-id <value>` | Идентификатор операции. | +| `--fields <value>` | Список возвращаемых атрибутов. | + +**Example:** `ydisk personal api operations-get --operation-id <value>` + +## `ydisk doctor` + +the state this installation is in, without connecting unless --online + +```sh +ydisk doctor [options] +``` + +| Option | What it does | +|---|---| +| `--online` | also connect once and read the account; sends nothing. | + +**Example:** `ydisk doctor`, `ydisk doctor --json` + +### `ydisk doctor reports` + +problem reports + +#### `ydisk doctor reports show` + +what a problem report holds; writes nothing + +```sh +ydisk doctor reports show +``` + +**Example:** `ydisk doctor reports show` + +#### `ydisk doctor reports create` + +write a problem report to a file, and say where to send it + +**Changes something on this computer only.** + +```sh +ydisk doctor reports create [options] +``` + +| Option | What it does | +|---|---| +| `--run <id>` | the run the report is about; the newest failed one if not given. | +| `--output <file>` | where to write it; a new file in this directory if not given. | + +**Example:** `ydisk doctor reports create --output ./problem-report.json` + +## `ydisk skill` + +the instructions an agent is given for this tool + +### `ydisk skill show` + +print SKILL.md — `ydisk skill install` puts it where Claude Code, Codex, Gemini CLI and OpenClaw look for it, and where Hermes does on request; --for prints the copy already there + +```sh +ydisk skill show [name] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `name` | optional | a part of this skill, or a skill shipped for a task: api-disk, api-disk-trash-resources, api-disk-resources, api-disk-public-resources, api-disk-operations-operation-id, api. | + +| Option | What it does | +|---|---| +| `--for <agents>` | print the copy installed for these agents instead of this version's. One of: `claude`, `agents`. | + +**Example:** `ydisk skill show` + +### `ydisk skill install` + +write SKILL.md to \~/.claude/skills/yandex-disk-cli/ (Claude Code) and \~/.agents/skills/yandex-disk-cli/ (Codex, Gemini CLI, OpenClaw); --for hermes also has Hermes read \~/.agents/skills, which changes Hermes's own settings, so all leaves it out + +**Changes something on this computer only.** + +```sh +ydisk skill install [options] +``` + +| Option | What it does | +|---|---| +| `--for <agents>` | which agents to install for. One of: `claude`, `agents`, `hermes`, `all`. Default: `all`. | + +**Example:** `ydisk skill install --for agents` + +### `ydisk skill status` + +for each place `ydisk skill install` writes to, and for the copy Hermes reads: the path, the version installed there, and whether it is current, stale, missing or unversioned + +```sh +ydisk skill status +``` + +**Example:** `ydisk skill status`, `ydisk skill status --json` + +## `ydisk mcp` + +serve this profile to an agent over MCP and set it up — `claude mcp add ydisk -- ydisk <profile> mcp serve` + +### `ydisk mcp serve` + +serve this profile to an agent over MCP, on stdin and stdout — `claude mcp add ydisk -- ydisk <profile> mcp serve`; `ydisk mcp serve --profiles a,b` or `--profiles all` serves those profiles from one server and each tool asks which + +**Changes something in the service.** + +```sh +ydisk mcp serve [options] +``` + +| Option | What it does | +|---|---| +| `--permission <key=level>` | make a permission stricter for this server only, like files.delete=deny; it never loosens the profile; repeat for more keys. | +| `--profiles <names\|all>` | serve several profiles from one server instead of one: names, comma-separated, or all for every profile. | +| `--http` | serve over HTTP on 127.0.0.1 for ChatGPT and Claude in the browser, behind your tunnel; the profile's permissions decide. | +| `--port <port>` | the local port for --http (default 8765). | +| `--public-url <url>` | the tunnel's https address the browser apps use, e.g. https://<name>.ts.net or https://<name>.ts.net/tg. | + +**Example:** `ydisk personal mcp serve`, `ydisk mcp serve --profiles work,personal`, `ydisk personal mcp serve --http --public-url https://laptop.example.ts.net` + +### `ydisk mcp revoke` + +forget every login `mcp serve --http` gave a browser app, of this profile or of the server `--profiles` names; each app must log in again + +**Changes something on this computer only.** + +```sh +ydisk mcp revoke [options] +``` + +| Option | What it does | +|---|---| +| `--profiles <names\|all>` | serve several profiles from one server instead of one: names, comma-separated, or all for every profile. | + +**Example:** `ydisk personal mcp revoke`, `ydisk mcp revoke --profiles all` + +### `ydisk mcp server` + +start, stop and check `mcp serve --http` in the background; status shows the login code for a browser app + +#### `ydisk mcp server start` + +start `mcp serve --http` apart from this shell and answer once it listens, with its login code + +**Changes something on this computer only.** + +```sh +ydisk mcp server start [options] +``` + +| Option | What it does | +|---|---| +| `--port <port>` | the local port (default 8765). | +| `--public-url <url>` | the tunnel's https address the browser apps use, e.g. https://<name>.ts.net or https://<name>.ts.net/tg. | +| `--permission <key=level>` | make a permission stricter for this server only; repeat for more keys. | +| `--profiles <names\|all>` | the server of several profiles that `mcp serve --profiles` serves: names, comma-separated, or all. | + +**Example:** `ydisk personal mcp server start --public-url https://laptop.example.ts.net` + +#### `ydisk mcp server stop` + +stop `mcp serve --http` — only one that `mcp server start` started + +**Changes something on this computer only.** + +```sh +ydisk mcp server stop [options] +``` + +| Option | What it does | +|---|---| +| `--profiles <names\|all>` | the server of several profiles that `mcp serve --profiles` serves: names, comma-separated, or all. | + +**Example:** `ydisk personal mcp server stop` + +#### `ydisk mcp server status` + +whether `mcp serve --http` runs, on which port and address, the login code for a new browser app, and the apps logged in + +```sh +ydisk mcp server status [options] +``` + +| Option | What it does | +|---|---| +| `--profiles <names\|all>` | the server of several profiles that `mcp serve --profiles` serves: names, comma-separated, or all. | + +**Example:** `ydisk personal mcp server status --json` + +### `ydisk mcp config` + +print the mcpServers entry for Claude Desktop, Cursor and others, with full paths; writes nothing + +```sh +ydisk mcp config [options] +``` + +| Option | What it does | +|---|---| +| `--permission <key=level>` | make a permission stricter for this server only, like files.delete=deny; it never loosens the profile; repeat for more keys. | +| `--profiles <names\|all>` | serve several profiles from one server instead of one: names, comma-separated, or all for every profile. | + +**Example:** `ydisk personal mcp config`, `ydisk mcp config --profiles all` + +### `ydisk mcp add` + +add this profile's local MCP server to Codex or Claude Code + +**Changes something on this computer only.** + +```sh +ydisk mcp add <client> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `client` | required | codex or claude-code. | + +| Option | What it does | +|---|---| +| `--allow-writes` | acknowledge that this profile offers writing tools. | +| `--permission <key=level>` | make a permission stricter for this server only, like files.delete=deny; it never loosens the profile; repeat for more keys. | + +**Example:** `ydisk personal mcp add codex --allow-writes` + +### `ydisk mcp check` + +check this profile's local MCP handshake and tool list + +```sh +ydisk mcp check [options] +``` + +| Option | What it does | +|---|---| +| `--permission <key=level>` | make a permission stricter for this server only, like files.delete=deny; it never loosens the profile; repeat for more keys. | + +**Example:** `ydisk personal mcp check` + +## `ydisk upgrade` + +upgrade ydisk with the package manager that installed it; --check only looks + +**Changes something on this computer only.** + +```sh +ydisk upgrade [options] +``` + +| Option | What it does | +|---|---| +| `--check` | say whether a newer version exists, and install nothing. | + +**Example:** `ydisk upgrade --check` + +## `ydisk config` + +the settings in force, and where each one came from + +### `ydisk config show` + +the profile, the profiles that exist, and each setting with where it came from + +```sh +ydisk config show +``` + +**Example:** `ydisk personal config show` + +### `ydisk config set` + +save a setting to the configuration file + +**Changes something on this computer only.** + +```sh +ydisk config set <setting> <value> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `setting` | required | one of: limit, timeout_ms, color, record, record_input, keep_runs_for_days, keep_successful_runs_for_days, keep_store_runs_for_days, runs_size_limit_mb, permissions, requests_per_minute, search_reranker, embedding_provider, embedding_model, embedding_base_url, embedding_dims, models, update_check, skill_hint, search_stemmers.cyrillic, search_stemmers.latin, owner_languages, crm.<provider>:<account>.links, crm.<provider>:<account>.company-types, crm.<provider>:<account>.scope, crm.<provider>:<account>.unassigned, crm.<provider>:<account>.self, crm.<provider>:<account>.stage-tasks, crm.<provider>:<account>.activities, crm.<provider>:<account>.files.max_files, crm.<provider>:<account>.files.max_file_mb, crm.<provider>:<account>.files.max_run_mb, crm.<provider>:<account>.files.run_minutes, crm.<provider>:<account>.files.days, crm.<provider>:<account>.files.max_total_mb. | +| `value` | required | a number, true or false; for a group tg:work,max:Alice,email:me@x. | + +| Option | What it does | +|---|---| +| `--defaults` | change what every profile gets, rather than this profile. | + +**Example:** `ydisk personal config set limit 20` + +### `ydisk config unset` + +remove a setting from the configuration file + +**Changes something on this computer only.** + +```sh +ydisk config unset <setting> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `setting` | required | one of: limit, timeout_ms, color, record, record_input, keep_runs_for_days, keep_successful_runs_for_days, keep_store_runs_for_days, runs_size_limit_mb, permissions, requests_per_minute, search_reranker, embedding_provider, embedding_model, embedding_base_url, embedding_dims, models, update_check, skill_hint, search_stemmers.cyrillic, search_stemmers.latin, owner_languages, crm.<provider>:<account>.links, crm.<provider>:<account>.company-types, crm.<provider>:<account>.scope, crm.<provider>:<account>.unassigned, crm.<provider>:<account>.self, crm.<provider>:<account>.stage-tasks, crm.<provider>:<account>.activities, crm.<provider>:<account>.files.max_files, crm.<provider>:<account>.files.max_file_mb, crm.<provider>:<account>.files.max_run_mb, crm.<provider>:<account>.files.run_minutes, crm.<provider>:<account>.files.days, crm.<provider>:<account>.files.max_total_mb. | + +| Option | What it does | +|---|---| +| `--defaults` | change what every profile gets, rather than this profile. | + +**Example:** `ydisk personal config unset limit` + +### `ydisk config migrate` + +write each setting the file lacks at its default, keeping yours + +**Changes something on this computer only.** + +```sh +ydisk config migrate +``` + +**Example:** `ydisk config migrate` + +### `ydisk config repair` + +fix broken JSON syntax in the settings file — comments, a missing or extra comma, unquoted keys, single quotes, missing closing brackets at the end — keeping every value, with a backup beside it; refuses anything with more than one reading and changes nothing then + +**Changes something on this computer only.** + +```sh +ydisk config repair [options] +``` + +| Option | What it does | +|---|---| +| `--dry-run` | say what it would fix, and change nothing. | + +**Example:** `ydisk config repair`, `ydisk config repair --dry-run` + +## `ydisk runs` + +recorded runs — what this tool did, and when + +### `ydisk runs list` + +recorded runs, newest first + +```sh +ydisk runs list [query] [options] +``` + +| Argument | | What it is | +|---|---|---| +| `query` | optional | field:value terms that narrow the list — the fields are below. | + +| Option | What it does | +|---|---| +| `--limit <n>` | how many to show. | +| `--page <n>` | which page, starting at 1. | + +**Returns:** run — run_id, command, started_at, status, cli_version, profile, completed_at, requests, and 23 more; every field: ydisk commands info runs list + +**Example:** `ydisk personal runs list --limit 10` + +### `ydisk runs show` + +one run: what it was, how it ended, and every event it logged + +```sh +ydisk runs show <run-id> [options] +``` + +| Argument | | What it is | +|---|---|---| +| `run-id` | required | an id from `ydisk runs list`. | + +| Option | What it does | +|---|---| +| `--problems` | only failed responses, warnings and crashes. | + +**Returns:** run details — run_id, command, started_at, status, cli_version, directory, event_count, events, and 22 more; every field: ydisk commands info runs show + +**Example:** `ydisk personal runs show run-101` + +### `ydisk runs path` + +the directory holding one run + +```sh +ydisk runs path <run-id> +``` + +| Argument | | What it is | +|---|---|---| +| `run-id` | required | an id from `ydisk runs list`. | + +**Returns:** run location — path; every field: ydisk commands info runs path + +**Example:** `ydisk personal runs path run-101` + +## Коды выхода + +Ориентируйтесь на код, а не на текст: текст может измениться, код нет. + +| Code | When | +|---|---| +| `0` | it worked | +| `2` | `validation_error` | +| `3` | `configuration_error` | +| `4` | `authentication_error` | +| `5` | `permission_error` | +| `6` | `not_found` | +| `7` | `confirmation_required` | +| `8` | `rate_limited` | +| `9` | `timeout` | +| `10` | `network_error` | +| `11` | `provider_error` | +| `12` | `provider_unavailable` | +| `13` | `invalid_response` | +| `14` | `outcome_unknown` | +| `15` | `conflict` | +| `130` | `cancelled` | +| `1` | anything else | diff --git a/translations/ydisk/configuration.es.md b/translations/ydisk/configuration.es.md new file mode 100644 index 00000000..28f88909 --- /dev/null +++ b/translations/ydisk/configuration.es.md @@ -0,0 +1,83 @@ +--- +title: "Ajustes" +--- + +Cambia cómo se comporta `ydisk` para un perfil o para todos: qué puede cambiar un agente en tu Disco, cuánto tiempo se +guardan los registros de ejecución y cómo ordena la búsqueda sus resultados. Los ajustes están en un solo archivo, +`config.json`, en la carpeta que muestra `ydisk doctor`. Cada perfil tiene su propia parte, y `defaults` valen para +todos los perfiles. + +```sh +ydisk personal config show +ydisk personal config set limit 50 +ydisk personal config unset limit +``` + +`config show` lista cada ajuste y de dónde viene: del archivo, de una variable o del valor por defecto. + +## Permisos + +`permissions` decide qué puede hacer un comando para este perfil. Cada comando tiene su propia clave, con su nombre, +como `files.move` o `files.upload`, y cada clave tiene uno de cuatro niveles: + +| Nivel | Qué pasa | +| --- | --- | +| `allow` | El comando se ejecuta. | +| `ask` | En un terminal la herramienta pregunta antes. Por MCP no hay nadie a quien preguntar, así que el comando se ejecuta. | +| `readonly` | Una lectura se ejecuta. Un cambio se rechaza. | +| `deny` | El comando se rechaza, con código de salida 5. | + +Dos claves protegen los cambios que cuesta deshacer. Están en `ask` hasta que las cambies. Las demás claves de `files` +están en `allow`: + +| Clave | Qué protege | +| --- | --- | +| `files.delete` | `files delete`, y una subida, una copia o un movimiento con `--replace`, que sobrescribe un archivo. En el grupo `api`: un borrado, vaciar la papelera y cualquier sobrescritura. | +| `files.share` | `files publish` y `files unpublish`: un enlace que abre cualquiera que lo tenga. En el grupo `api`: las operaciones de enlace público. | + +```sh +ydisk personal config set permissions.files.delete deny +ydisk personal config set permissions.files.share deny +ydisk personal config set permissions.files.upload deny +``` + +Un comando de `api` que hace lo que hace un comando de `files` comprueba también la clave de ese comando: con +`files.move` en `deny` se detiene también `api resources-move`. `--dry-run` en cualquier cambio muestra cada clave que +comprueba y su nivel, sin hacer el cambio. + +`YDISK_READ_ONLY=1` rechaza cualquier cambio, digan lo que digan los permisos. Solo para un servidor MCP, +`--permission +files.delete=deny` hace una clave más estricta. Mira [conecta tu agente](./mcp.md#decide-what-the-agent-may-change). + +## Registros de ejecución + +Un comando que falla se guarda como una ejecución, para `ydisk runs list` y `runs show`. Un comando que llega a Yandex +Disk, como `files list`, `sync` o `session status --check`, se guarda también cuando tiene éxito, salvo que `record` +sea `false` (entonces solo los fallos) o que se ejecutara con `--no-record`. `record_input` decide si una ejecución +guarda las palabras que escribiste. Es `true` salvo que lo pongas en `false`. Los secretos se ocultan en ambos casos. +Mira [Seguridad](./security.md). + +| Ajuste | Por defecto | Qué hace | +| --- | --- | --- | +| `record` | `true` | Guarda cada ejecución. `false` guarda solo las que fallan. | +| `record_input` | `true` | Guarda las palabras escritas en la línea de comandos: `true`, `false` o `failed`. | +| `keep_runs_for_days` | `30` | Días que se guarda una ejecución. | +| `keep_successful_runs_for_days` | `7` | Días que se guarda una ejecución correcta. | +| `runs_size_limit_mb` | `200` | Los megabytes máximos que pueden ocupar todas las ejecuciones. | + +## Otros ajustes + +| Ajuste | Por defecto | Qué hace | +| --- | --- | --- | +| `limit` | `20` | Cuántos elementos muestra una lista a la vez. | +| `search_reranker` | `mmarco` | El modelo que ordena los primeros resultados de la búsqueda, o `off`. | +| `embedding_provider` | `local` | `local` u `openai`: lo que convierte el texto en vectores para la búsqueda por significado. `openai` envía el texto a OpenAI. | +| `update_check` | `true` | Comprueba una vez al día si hay una versión nueva. | +| `skill_hint` | `true` | Avisa a un agente una vez al día de que `skill install` le daría el skill de esta herramienta. | + +## Variables de entorno + +| Variable | Qué hace | +| --- | --- | +| `YDISK_PROFILE` | El perfil para los comandos que no nombran ninguno. | +| `YDISK_READ_ONLY` | `1` rechaza cualquier cambio. | diff --git a/translations/ydisk/configuration.ru.md b/translations/ydisk/configuration.ru.md new file mode 100644 index 00000000..86d1d43f --- /dev/null +++ b/translations/ydisk/configuration.ru.md @@ -0,0 +1,83 @@ +--- +title: "Настройки" +--- + +Меняйте поведение `ydisk` для одного профиля или для всех сразу: что агент может менять на вашем Диске, как долго +хранятся записи запусков и как поиск упорядочивает результаты. Настройки лежат в одном файле, `config.json`, в папке, +которую показывает `ydisk doctor`. У каждого профиля своя часть, а `defaults` действуют для всех профилей. + +```sh +ydisk personal config show +ydisk personal config set limit 50 +ydisk personal config unset limit +``` + +`config show` перечисляет каждую настройку и откуда она взялась: из файла, из переменной или из значения по +умолчанию. + +## Разрешения + +`permissions` решает, что команда может делать для этого профиля. У каждой команды свой ключ с ее именем, например +`files.move` или `files.upload`, и у каждого ключа один из четырех уровней: + +| Уровень | Что происходит | +| --- | --- | +| `allow` | Команда выполняется. | +| `ask` | В терминале инструмент сначала спрашивает. Через MCP спросить некого, поэтому команда выполняется. | +| `readonly` | Чтение выполняется. Изменение отклоняется. | +| `deny` | Команда отклоняется с кодом выхода 5. | + +Два ключа охраняют изменения, которые трудно отменить. Пока вы их не измените, у них уровень `ask`. Остальные ключи +`files` стоят на `allow`: + +| Ключ | Что охраняет | +| --- | --- | +| `files.delete` | `files delete`, а также загрузку, копирование и перенос с `--replace`, которые перезаписывают файл. В группе `api`: удаление, очистку корзины и любую перезапись. | +| `files.share` | `files publish` и `files unpublish`: ссылку, которую откроет любой, у кого она есть. В группе `api`: операции с публичными ссылками. | + +```sh +ydisk personal config set permissions.files.delete deny +ydisk personal config set permissions.files.share deny +ydisk personal config set permissions.files.upload deny +``` + +Команда `api`, которая делает то же, что команда `files`, проверяет и ключ той команды: `files.move` со значением +`deny` останавливает и `api resources-move`. `--dry-run` у любого изменения показывает каждый проверяемый ключ и его +уровень, но само изменение не делает. + +`YDISK_READ_ONLY=1` отклоняет любое изменение, что бы ни говорили разрешения. Только для одного MCP-сервера +`--permission +files.delete=deny` делает ключ строже. См. [подключите агента](./mcp.md#decide-what-the-agent-may-change). + +## Записи запусков + +Команда, которая завершилась ошибкой, сохраняется как запуск, его показывают `ydisk runs list` и `runs show`. Команда, +которая обращается к Яндекс Диску, например `files list`, `sync` или `session status --check`, сохраняется и при +успехе, если только `record` не `false` (тогда сохраняются одни ошибки) или она не запущена с `--no-record`. +`record_input` решает, хранит ли запуск слова, которые вы набрали. По умолчанию `true`, пока вы не поставите `false`. +Секреты скрываются в любом случае. См. [безопасность](./security.md). + +| Настройка | По умолчанию | Что делает | +| --- | --- | --- | +| `record` | `true` | Сохранять каждый запуск. `false` сохраняет только неудачные. | +| `record_input` | `true` | Хранить слова, набранные в командной строке: `true`, `false` или `failed`. | +| `keep_runs_for_days` | `30` | Сколько дней хранится запуск. | +| `keep_successful_runs_for_days` | `7` | Сколько дней хранится успешный запуск. | +| `runs_size_limit_mb` | `200` | Сколько мегабайт могут занимать все запуски вместе. | + +## Другие настройки + +| Настройка | По умолчанию | Что делает | +| --- | --- | --- | +| `limit` | `20` | Сколько элементов список показывает за раз. | +| `search_reranker` | `mmarco` | Модель, которая упорядочивает первые результаты поиска, или `off`. | +| `embedding_provider` | `local` | `local` или `openai`: чем текст превращается в векторы для поиска по смыслу. `openai` отправляет текст в OpenAI. | +| `update_check` | `true` | Раз в день проверять, нет ли новой версии. | +| `skill_hint` | `true` | Раз в день сообщать агенту, что `skill install` даст ему навык этого инструмента. | + +## Переменные окружения + +| Переменная | Что делает | +| --- | --- | +| `YDISK_PROFILE` | Профиль для команд, в которых он не назван. | +| `YDISK_READ_ONLY` | `1` отклоняет любое изменение. | diff --git a/translations/ydisk/index.es.md b/translations/ydisk/index.es.md new file mode 100644 index 00000000..e3bb67b5 --- /dev/null +++ b/translations/ydisk/index.es.md @@ -0,0 +1,87 @@ +--- +title: "ydisk" +--- + +Encuentra cualquier documento de tu Yandex Disk por lo que dice y deja que tu agente de IA lo lea, lo archive y lo +comparta por ti. `ydisk` copia a tu ordenador el texto de las carpetas del Disk que elijas, así que una búsqueda de «lease» o «договор +аренды» encuentra el PDF aunque se llame `scan_0042.pdf`, e incluso sin internet. Cuando necesitas el Disk mismo, la +misma herramienta lista, descarga, sube, mueve y comparte archivos allí. + +Un agente con `ydisk` responde a «¿dónde está el contrato con la imprenta y qué condiciones de pago tiene?» con la +cita y la ruta del archivo en el Disk. Funciona con Claude Code, Codex, Gemini CLI y otros agentes que ejecutan +comandos, con Claude Desktop y Cursor por MCP, y con ChatGPT y Claude en el navegador a través de tu propio túnel. + +Necesitas Node.js y un token OAuth de Yandex, una clave que permite a la herramienta usar tu Disk. Conseguir el token +lleva unos cinco minutos, una sola vez. + +**En esta página:** + +1. [Qué obtienes](#what-you-get) +2. [Cómo funciona](#how-it-works) +3. [Pruébalo en cinco comandos](#try-it-in-five-commands) +4. [Pregunta a tu agente](#ask-your-agent) +5. [Adónde ir después](#where-to-go-next) + +## Qué obtienes + +- **Busca dentro de tus archivos, no solo en sus nombres.** Se puede buscar en el texto de PDF, Word (`.docx`), Excel + (`.xlsx`), CSV, TSV, texto plano y Markdown. La búsqueda encuentra otras formas de una palabra en ruso y en inglés, y + encuentra un documento por su significado cuando su texto ya está indexado. +- **Busca sin internet.** La búsqueda lee la copia de tu ordenador, así que es rápida y no hace ninguna petición a + Yandex. +- **Todo el Disk, en vivo.** Lista, lee, descarga, sube, copia, mueve, envía a la papelera, restaura y comparte + archivos sin abrir un navegador. +- **Seguro para dárselo a un agente.** En un terminal, la herramienta pregunta antes de borrar, sobrescribir o crear + un enlace público. Para un agente puedes desactivar cada una de esas preguntas o permitir solo la lectura. +- **Una búsqueda en todas tus fuentes.** La copia está en el mismo almacén local que tu Telegram, WhatsApp, correo, + notas y reuniones de las otras herramientas de WireCat, así que una búsqueda lo cubre todo. +- **Gratis y de código abierto.** Apache 2.0, en macOS, Linux y Windows. Sin cuenta de WireCat y sin servidor de + WireCat: la herramienta habla con la API oficial de Yandex desde tu ordenador. + +## Cómo funciona + +- **Un perfil por cuenta.** Un perfil es el nombre que eliges para una cuenta de Yandex, como `personal` o `work`. + Todo comando que usa una cuenta empieza con él: `ydisk personal search budget`. +- **Una copia del texto, no de los archivos.** `sync` lee las carpetas que elegiste y guarda su texto en el almacén + local, un único archivo de base de datos en tu ordenador. Los archivos siguen en el Disk. Las fotos y otros + archivos sin texto se guardan solo por su nombre. +- **Solo las carpetas que eliges.** Yandex Disk no avisa a la herramienta de lo que cambió, así que cada sincronización + vuelve a listar las carpetas elegidas y descarga solo los archivos cuyo contenido cambió. Elige las carpetas que + importan, no todo el Disk. +- **Los comandos en vivo van al Disk.** Los comandos `files` trabajan directamente en el Disk y no necesitan + sincronización. + +## Pruébalo en cinco comandos + +Después de [instalar la herramienta e iniciar sesión](./installation.md): + +```sh +ydisk personal folders browse +ydisk personal folders add /Documents +ydisk personal sync +ydisk personal search "quarterly budget" +ydisk personal files list --folder /Documents +``` + +El primer comando lista las carpetas de la raíz de tu Disk. Los dos siguientes copian el texto de `/Documents`. La +búsqueda responde desde esa copia, y el último comando lee la carpeta en vivo desde el Disk. + +## Pregunta a tu agente + +Instala una vez el skill de la herramienta con `ydisk skill install` y pide lo que necesitas con palabras normales: + +```text prompt +Use ydisk CLI with profile personal. Find the lease for the flat in my Disk folders. +Quote the notice period and give me the file's path on the Disk. Do not change any files. +``` + +El agente busca primero en la copia y lee en vivo desde el Disk un archivo que esté fuera de las carpetas elegidas. +Encontrarás más peticiones en las [recetas](./recipes.md). + +## Adónde ir después + +- [Instala e inicia sesión](./installation.md): Node.js, el token de Yandex paso a paso y la primera comprobación. +- [Carpetas y sincronización](./usage.md): elige carpetas, mantén la copia al día y trabaja con archivos en vivo. +- [Encuentra un documento](./search.md): palabras, formas de palabras, significado, nombres de archivo. +- [Conecta tu agente](./mcp.md): el skill, Claude Code, Codex, Claude Desktop, Cursor y aplicaciones del navegador. +- [Comparación con otras herramientas](./compare.md): rclone, el cliente propio de Yandex y los servidores MCP de Yandex Disk. diff --git a/translations/ydisk/index.ru.md b/translations/ydisk/index.ru.md new file mode 100644 index 00000000..57800c0d --- /dev/null +++ b/translations/ydisk/index.ru.md @@ -0,0 +1,86 @@ +--- +title: "ydisk" +--- + +Находите любой документ на Яндекс Диске по тому, что в нём написано, и поручите ИИ-агенту читать, раскладывать и +отправлять файлы за вас. `ydisk` копирует на ваш компьютер текст выбранных папок Диска, поэтому поиск по словам «lease» или «договор аренды» +найдёт PDF, даже если файл называется `scan_0042.pdf`, и даже без интернета. Когда нужен сам Диск, тот же инструмент +показывает, скачивает, загружает, переносит и раздаёт файлы там. + +ИИ-агент с `ydisk` отвечает на вопрос «где договор с типографией и какие в нём условия оплаты?» цитатой и путём к +файлу на Диске. Он работает с Claude Code, Codex, Gemini CLI и другими агентами, которые запускают команды, с Claude +Desktop и Cursor через MCP, а с ChatGPT и Claude в браузере через ваш собственный туннель. + +Нужны Node.js и токен OAuth Яндекса: ключ, который даёт инструменту доступ к вашему Диску. Получить токен можно минут +за пять, один раз. + +**На этой странице:** + +1. [Что вы получите](#what-you-get) +2. [Как это устроено](#how-it-works) +3. [Попробуйте за пять команд](#try-it-in-five-commands) +4. [Спросите агента](#ask-your-agent) +5. [Что читать дальше](#where-to-go-next) + +## Что вы получите + +- **Поиск внутри файлов, а не только по их именам.** Ищется текст в PDF, Word (`.docx`), Excel (`.xlsx`), CSV, TSV, + обычном тексте и Markdown. Поиск находит другие формы слова на русском и английском, а когда текст проиндексирован, + находит документ и по смыслу. +- **Поиск без интернета.** Поиск читает копию на вашем компьютере, поэтому работает быстро и не делает запросов к + Яндексу. +- **Весь Диск вживую.** Смотрите, читайте, скачивайте, загружайте, копируйте, переносите, удаляйте в корзину, + восстанавливайте файлы и делитесь ими, не открывая браузер. +- **Агенту можно доверить.** В терминале инструмент спрашивает перед удалением, перезаписью и созданием публичной + ссылки. Для агента каждый такой вопрос можно отключить или разрешить только чтение. +- **Один поиск по всем источникам.** Копия лежит в том же локальном хранилище, что и ваши Telegram, WhatsApp, почта, + заметки и встречи из других инструментов WireCat, поэтому один поиск покрывает всё. +- **Бесплатно и с открытым кодом.** Apache 2.0, macOS, Linux и Windows. Аккаунт WireCat и сервер WireCat не нужны: + инструмент обращается к официальному API Яндекса прямо с вашего компьютера. + +## Как это устроено + +- **Профиль для каждого аккаунта.** Профиль это имя, которое вы выбираете для одного аккаунта Яндекса, например + `personal` или `work`. Каждая команда, которой нужен аккаунт, начинается с него: `ydisk personal search budget`. +- **Копия текста, а не файлов.** `sync` читает выбранные вами папки и хранит их текст в локальном хранилище, это один + файл базы данных на вашем компьютере. Сами файлы остаются на Диске. Фото и другие файлы без текста сохраняются + только по имени. +- **Только выбранные папки.** Яндекс Диск не сообщает инструменту, что изменилось, поэтому каждая синхронизация + заново перечисляет выбранные папки и скачивает только файлы с изменившимся содержимым. Выбирайте важные папки, а не + весь Диск. +- **Команды для живой работы идут на Диск.** Команды `files` работают с Диском напрямую, синхронизация им не нужна. + +## Попробуйте за пять команд + +Сначала [установите инструмент и войдите](./installation.md): + +```sh +ydisk personal folders browse +ydisk personal folders add /Documents +ydisk personal sync +ydisk personal search "quarterly budget" +ydisk personal files list --folder /Documents +``` + +Первая команда показывает папки верхнего уровня вашего Диска. Следующие две копируют текст из `/Documents`. Поиск +отвечает по этой копии, а последняя команда читает папку прямо с Диска. + +## Спросите агента + +Один раз установите навык инструмента командой `ydisk skill install` и просите обычными словами: + +```text prompt +Use ydisk CLI with profile personal. Find the lease for the flat in my Disk folders. +Quote the notice period and give me the file's path on the Disk. Do not change any files. +``` + +Агент сначала ищет по копии, а файл вне выбранных папок читает прямо с Диска. Больше примеров запросов в +[рецептах](./recipes.md). + +## Что читать дальше + +- [Установка и вход](./installation.md): Node.js, токен Яндекса по шагам и первая проверка. +- [Папки и синхронизация](./usage.md): выберите папки, обновляйте копию, работайте с файлами вживую. +- [Найдите документ](./search.md): слова, формы слов, смысл, имена файлов. +- [Подключите агента](./mcp.md): навык, Claude Code, Codex, Claude Desktop, Cursor и браузерные приложения. +- [Сравнение с другими инструментами](./compare.md): rclone, собственный клиент Яндекса и MCP-серверы для Яндекс Диска. diff --git a/translations/ydisk/installation.es.md b/translations/ydisk/installation.es.md new file mode 100644 index 00000000..f9d14f0f --- /dev/null +++ b/translations/ydisk/installation.es.md @@ -0,0 +1,129 @@ +--- +title: "Instala e inicia sesión" +--- + +Configura `ydisk` una vez en cada ordenador donde lo uses tú o un agente. Tras estos pasos tu Disk queda conectado con +el nombre de perfil que elijas y la primera búsqueda funciona. Iniciar sesión significa pegar un token OAuth de +Yandex: una clave que Yandex te da para tu propia cuenta y con la que la herramienta usa tu Disk. Conseguirlo lleva +unos cinco minutos, una sola vez. + +**En esta página:** + +1. [Instala la herramienta](#install-the-tool) +2. [Consigue un token de Yandex](#get-a-yandex-token) +3. [Inicia sesión](#sign-in) +4. [Comprueba que funciona](#check-that-it-works) +5. [Un ordenador sin llavero](#a-computer-with-no-keyring) +6. [Actualiza](#update) +7. [Desinstala](#remove) + +## Instala la herramienta + +Necesitas Node.js 22.16 o una versión 22.x posterior, o 24 o superior. Node 23 no es compatible. Comprueba tu versión +con `node --version` y descarga Node.js de [nodejs.org](https://nodejs.org/) si falta o es más antiguo. + +```sh +npm install -g @wirecat/yandex-disk-cli +ydisk --version +ydisk doctor +``` + +`doctor` no necesita red y no abre el llavero. Muestra la versión, dónde están los ajustes y el almacén local, los +perfiles que existen y si otros usuarios del ordenador pueden leer los ajustes. Para probar la herramienta sin +instalarla, ejecuta `npx @wirecat/yandex-disk-cli --help`. + +## Consigue un token de Yandex + +Yandex da un token a una aplicación que registras tú mismo. La aplicación es solo un nombre y una lista de permisos de +acceso en tu cuenta de Yandex. No se publica nada. Estos pasos siguen las guías de Yandex: +[registrar una aplicación para acceder a la API](https://yandex.ru/dev/id/doc/en/register-api) y +[el inicio rápido de la API de Disk](https://yandex.ru/dev/disk-api/doc/en/concepts/quickstart). Las páginas de +Yandex están en ruso, así que abajo las etiquetas van también en ruso. + +1. Abre [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new/) e inicia sesión en Yandex con la cuenta cuyo + Disk quieres usar. Si Yandex te ofrece elegir un tipo de aplicación, elige **Para acceder a la API o depurar** + («Для доступа к API или отладки»). +2. Escribe cualquier nombre para la aplicación («Название вашего сервиса»), como `ydisk on my laptop`, y tu correo + («Контактная почта»). +3. En el acceso a datos («Доступ к данным»), añade los permisos de Yandex Disk que necesita la herramienta: + - `cloud_api:disk.read`, leer todo el Disk («Чтение всего Диска»). + - `cloud_api:disk.info`, leer información del Disk («Доступ к информации о Диске»). La herramienta lo usa para + comprobar de quién es el token. + - `cloud_api:disk.write`, escribir en cualquier lugar del Disk («Запись в любом месте на Диске»), para subir, + mover, borrar y crear enlaces públicos. Omítelo si quieres un token que solo lea. Entonces todo cambio falla. +4. Crea la aplicación («Создать приложение»). Su página muestra un **ClientID**, una cadena de letras y cifras. + Cópialo. +5. Abre esta dirección en el navegador, con tu ClientID añadido justo al final, después de `client_id=`: + `https://oauth.yandex.ru/authorize?response_type=token&client_id=` +6. Yandex pregunta si permites que la aplicación acceda a tu Disk. Permítelo y Yandex muestra el token en su página. + Cópialo. + +Yandex puede pedirte que confirmes tu identidad antes de dejarte crear aplicaciones. Sin la confirmación muestra un +aviso y limita cuántas aplicaciones puedes crear, lo que no te impide seguir aquí. Consulta +[la página de Yandex sobre ello](https://yandex.ru/dev/id/doc/en/confirm-account). + +Guarda el token como una contraseña. Quien lo tenga puede usar tu Disk con los permisos que elegiste. + +## Inicia sesión + +Elige un nombre de perfil para esta cuenta, como `personal`, e inicia sesión con él. La herramienta pide el token con +entrada oculta. Pégalo y pulsa Enter. + +```sh +ydisk personal session start +``` + +Primero la herramienta comprueba el token con Yandex y solo lo guarda si Yandex lo acepta. Se guarda en el llavero +del sistema (Keychain en macOS, Credential Manager en Windows, Secret Service en Linux). El token nunca es un +argumento de comando y nunca aparece en la salida ni en un registro. + +`session start` también lee el token desde stdin, así que un script puede pasarlo desde un gestor de contraseñas. Una +segunda cuenta tiene su propio perfil: `ydisk work session start`. + +## Comprueba que funciona + +```sh +ydisk personal session status --check +ydisk personal folders browse +``` + +`session status --check` pregunta a Yandex de quién es el token y muestra la cuenta. `folders browse` lista las +carpetas de la raíz de tu Disk. Ambos responden desde Yandex, así que una respuesta correcta significa que el inicio +de sesión está hecho. + +Yandex mantiene válido un token durante meses y lo prolonga mientras se usa +([Yandex ID](https://yandex.ru/dev/id/doc/en/concepts/ya-oauth-intro)). Cuando Yandex deja de aceptarlo, los comandos +fallan con el código de salida 4: consigue un token nuevo del mismo modo y ejecuta `session start` otra vez. + +`ydisk personal session end` borra el token de este ordenador. + +## Un ordenador sin llavero + +En un servidor o un contenedor sin llavero, la herramienta guarda el token en un archivo privado que solo tú puedes +leer, y te lo dice. Para saltarte el llavero a propósito: + +```sh +ydisk personal session start --credential-storage file +``` + +## Actualiza + +```sh +ydisk upgrade +``` + +`ydisk upgrade --check` solo dice si existe una versión más nueva. Tras actualizar, ejecuta `ydisk skill install` otra +vez para que las instrucciones de tu agente coincidan con la versión nueva. + +## Desinstala + +`ydisk personal session end` olvida el token del perfil en este ordenador. Después quita la herramienta: + +```sh +npm uninstall -g @wirecat/yandex-disk-cli +``` + +Los ajustes y el almacén local se quedan en las carpetas que mostró `ydisk doctor`, para las otras herramientas de +WireCat que comparten el almacén. Bórralos a mano si ya no los necesitas. + +Siguiente: [elige carpetas y sincronízalas](./usage.md). diff --git a/translations/ydisk/installation.ru.md b/translations/ydisk/installation.ru.md new file mode 100644 index 00000000..8cd1d48c --- /dev/null +++ b/translations/ydisk/installation.ru.md @@ -0,0 +1,130 @@ +--- +title: "Установка и вход" +--- + +Настройте `ydisk` один раз на каждом компьютере, где работаете вы или ваш агент. После этих шагов ваш Диск подключён +под именем профиля, которое вы выбрали, и первый поиск работает. Вход это вставка токена OAuth Яндекса: ключа, который +Яндекс выдаёт для вашего собственного аккаунта и который даёт инструменту доступ к Диску. Получить его можно минут за +пять, один раз. + +**На этой странице:** + +1. [Установите инструмент](#install-the-tool) +2. [Получите токен Яндекса](#get-a-yandex-token) +3. [Войдите](#sign-in) +4. [Проверьте, что всё работает](#check-that-it-works) +5. [Компьютер без связки ключей](#a-computer-with-no-keyring) +6. [Обновление](#update) +7. [Удаление](#remove) + +## Установите инструмент + +Нужен Node.js 22.16 или новее в ветке 22.x либо версия 24 и новее. Node 23 не поддерживается. Версию покажет команда +`node --version`. Если Node.js нет или он старее, скачайте его на [nodejs.org](https://nodejs.org/). + +```sh +npm install -g @wirecat/yandex-disk-cli +ydisk --version +ydisk doctor +``` + +`doctor` не использует сеть и не открывает связку ключей. Он показывает версию, где лежат настройки и локальное +хранилище, какие профили есть и могут ли другие пользователи компьютера читать настройки. Чтобы попробовать инструмент +без установки, выполните `npx @wirecat/yandex-disk-cli --help`. + +## Получите токен Яндекса + +Токен Яндекс выдаёт приложению, которое вы регистрируете для себя. Приложение здесь только название и список прав в +вашем аккаунте Яндекса. Ничего не публикуется. Шаги повторяют собственные инструкции Яндекса: +[регистрация приложения для доступа к API](https://yandex.ru/dev/id/doc/en/register-api) и +[быстрый старт API Диска](https://yandex.ru/dev/disk-api/doc/en/concepts/quickstart). Страницы Яндекса на русском, +поэтому названия из интерфейса даны в шагах как есть. + +1. Откройте [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new/) и войдите в Яндекс с аккаунтом, Диск + которого хотите использовать. Если Яндекс предложит выбрать тип приложения, выберите **Для доступа к API или + отладки** («Для доступа к API или отладки»). +2. Введите любое название приложения («Название вашего сервиса»), например `ydisk on my laptop`, и свою почту + («Контактная почта»). +3. В разделе «Доступ к данным» добавьте права Яндекс Диска, которые нужны инструменту: + - `cloud_api:disk.read`: чтение всего Диска («Чтение всего Диска»). + - `cloud_api:disk.info`: информация о Диске («Доступ к информации о Диске»). По ней инструмент проверяет, чей это + токен. + - `cloud_api:disk.write`: запись в любом месте Диска («Запись в любом месте на Диске») для загрузки, переноса, + удаления и публичных ссылок. Для токена только на чтение не добавляйте его. Тогда любое изменение завершится + ошибкой. +4. Создайте приложение («Создать приложение»). На его странице будет **ClientID**, строка из букв и цифр. Скопируйте + её. +5. Откройте в браузере этот адрес, дописав ClientID в самый конец, после `client_id=`: + `https://oauth.yandex.ru/authorize?response_type=token&client_id=` +6. Яндекс спросит, разрешить ли приложению доступ к вашему Диску. Разрешите, и Яндекс покажет токен на странице. + Скопируйте его. + +Прежде чем разрешить создание приложений, Яндекс может попросить подтвердить личность. Без подтверждения он показывает +предупреждение и ограничивает число приложений, но для этих шагов это не помеха. Подробности на +[странице Яндекса](https://yandex.ru/dev/id/doc/en/confirm-account). + +Храните токен как пароль. Тот, у кого он есть, может работать с вашим Диском с теми правами, которые вы выбрали. + +## Войдите + +Выберите имя профиля для этого аккаунта, например `personal`, и войдите под ним. Инструмент спросит токен скрытым +вводом. Вставьте его и нажмите Enter. + +```sh +ydisk personal session start +``` + +Сначала инструмент проверяет токен у Яндекса и сохраняет его, только если Яндекс его принял. Токен лежит в системной +связке ключей (Keychain в macOS, Credential Manager в Windows, Secret Service в Linux). Токен никогда не передаётся +аргументом команды и не попадает ни в вывод, ни в журнал. + +`session start` читает токен и из stdin, так что скрипт может передать его из менеджера паролей. У второго аккаунта +будет свой профиль: `ydisk work session start`. + +## Проверьте, что всё работает + +```sh +ydisk personal session status --check +ydisk personal folders browse +``` + +`session status --check` спрашивает Яндекс, чей это токен, и показывает аккаунт. `folders browse` показывает папки +верхнего уровня вашего Диска. Обе команды отвечают по данным Яндекса, так что рабочий ответ значит, что вход +выполнен. + +Яндекс держит токен действующим месяцами и продлевает его, пока им пользуются +([Яндекс ID](https://yandex.ru/dev/id/doc/en/concepts/ya-oauth-intro)). Когда Яндекс перестанет его принимать, +команды завершатся с кодом выхода 4: получите новый токен так же и снова выполните `session start`. + +`ydisk personal session end` удаляет токен с этого компьютера. + +## Компьютер без связки ключей + +На сервере или в контейнере без связки ключей инструмент хранит токен в закрытом файле, который читаете только вы, и +говорит об этом. Чтобы обойтись без связки ключей намеренно: + +```sh +ydisk personal session start --credential-storage file +``` + +## Обновление + +```sh +ydisk upgrade +``` + +`ydisk upgrade --check` только сообщает, есть ли новая версия. После обновления снова выполните `ydisk skill install`, +чтобы инструкции вашего агента соответствовали новой версии. + +## Удаление + +`ydisk personal session end` забывает токен профиля на этом компьютере. Затем удалите сам инструмент: + +```sh +npm uninstall -g @wirecat/yandex-disk-cli +``` + +Настройки и локальное хранилище остаются в папках, которые показал `ydisk doctor`, для других инструментов WireCat, +которые делят это хранилище. Если они вам больше не нужны, удалите их вручную. + +Дальше: [выберите папки и синхронизируйте их](./usage.md). diff --git a/translations/ydisk/mcp.es.md b/translations/ydisk/mcp.es.md new file mode 100644 index 00000000..fa108140 --- /dev/null +++ b/translations/ydisk/mcp.es.md @@ -0,0 +1,105 @@ +--- +title: "Conecta tu agente" +--- + +Dale a tu agente de IA tu Yandex Disk, para que encuentre un documento, lo cite y archive tus ficheros cuando se lo +pidas. Un agente con terminal ejecuta `ydisk` por sí mismo después de que instales el skill de la herramienta. Una +aplicación sin terminal, como Claude Desktop o Cursor, llega a los mismos comandos por MCP, el Model Context Protocol +que usan las aplicaciones de IA para llamar a herramientas. Tú decides qué puede cambiar el agente. + +**En esta página:** + +1. [Agentes con terminal](#agents-with-a-terminal) +2. [Claude Code y Codex por MCP](#claude-code-and-codex-over-mcp) +3. [Claude Desktop, Cursor y otras aplicaciones MCP](#claude-desktop-cursor-and-other-mcp-apps) +4. [ChatGPT y Claude en el navegador](#chatgpt-and-claude-in-the-browser) +5. [Decide qué puede cambiar el agente](#decide-what-the-agent-may-change) + +## Agentes con terminal + +Claude Code, Codex, Gemini CLI, OpenClaw y otros agentes que ejecutan comandos solo necesitan el skill: un archivo +corto que enseña al agente los comandos y las reglas de la herramienta. + +```sh +ydisk skill install +``` + +Lo deja donde lo buscan Claude Code (`~/.claude/skills/`) y Codex, Gemini CLI y OpenClaw (`~/.agents/skills/`). +`ydisk skill install --for hermes` añade además esa carpeta a los ajustes propios de Hermes Agent, algo que un +`skill install` normal no hace. Vuelve a ejecutarlo después de una actualización. `ydisk skill status` te dice si el +skill instalado coincide con esta versión. + +Luego pide lo que quieras con palabras normales y nombra el perfil: + +```text prompt +Use ydisk CLI with profile personal. What did I upload to /Documents/Invoices this month? +List the files with their dates. Do not change anything. +``` + +## Claude Code y Codex por MCP + +Para darle la herramienta a Claude Code o a Codex como servidor MCP, añádela con un solo comando: + +```sh +ydisk personal mcp add claude-code --allow-writes +ydisk personal mcp add codex --allow-writes +``` + +`--allow-writes` confirma que sabes que el servidor ofrece los comandos que cambian el Disco. Los permisos del perfil +siguen decidiendo qué se ejecuta. Mira [Decide qué puede cambiar el agente](#decide-what-the-agent-may-change). + +## Claude Desktop, Cursor y otras aplicaciones MCP + +```sh +ydisk personal mcp config +``` + +Imprime la entrada `mcpServers` con rutas completas. Pégala en los ajustes MCP de la aplicación y reinicia la +aplicación. Dónde guarda cada aplicación sus ajustes está en la [página de agentes](https://wirecat.dev/en/docs/agents). +Vuelve a imprimir la entrada después de cambiar o actualizar Node.js, porque nombra una sola ruta de Node.js. + +`ydisk personal mcp check` arranca el servidor como lo haría una aplicación y lista las herramientas que ofrece. +Ejecútalo cuando una aplicación no muestre herramientas de `ydisk`. + +Un servidor puede atender varios perfiles: `ydisk mcp config --profiles personal,work`. Entonces cada herramienta +pregunta qué perfil usar. + +## ChatGPT y Claude en el navegador + +Una aplicación del navegador no puede arrancar un programa en tu ordenador, así que `ydisk` sirve MCP por HTTP en tu +ordenador, y tu propio túnel, como Tailscale Funnel o Cloudflare Tunnel, le da una dirección `https`: + +```sh +ydisk personal mcp server start --public-url https://laptop.example.ts.net +ydisk personal mcp server status +``` + +La dirección de arriba es un ejemplo. Usa la de tu túnel. El servidor escucha en `127.0.0.1`, puerto 8765 (`--port` +lo cambia), y se ejecuta en segundo plano hasta que ejecutes `ydisk personal mcp server stop`. Una aplicación del +navegador inicia sesión con un código de un solo uso que imprimen `server start` y `server status`. +`ydisk personal mcp revoke` termina todas las sesiones. Cómo configurar el túnel y la aplicación está en la +[página de aplicaciones del navegador](https://wirecat.dev/en/docs/browser-apps). + +## Decide qué puede cambiar el agente + +El servidor MCP ofrece todos los comandos, también los que cambian el Disco. En un terminal la herramienta pregunta +antes de borrar, sobrescribir o crear un enlace público, pero por MCP no hay nadie a quien preguntar, así que se +ejecutan. Elige una de estas opciones para un agente: + +- **Solo lectura.** `YDISK_READ_ONLY=1` en el entorno del servidor rechaza cualquier cambio. +- **Sin borrar y sin enlaces públicos.** Fija los dos permisos del perfil: + + ```sh + ydisk personal config set permissions.files.delete deny + ydisk personal config set permissions.files.share deny + ``` + +- **Más estricto solo para un servidor.** `--permission` en `mcp serve`, `mcp add`, `mcp config` o + `mcp server start` hace un permiso más estricto para ese servidor, nunca más laxo: + `ydisk personal mcp add claude-code --allow-writes --permission files.delete=deny`. + +Por MCP un agente lee el texto de un archivo con `files download`, pero no puede guardar un archivo en una ruta de tu +ordenador. Todas las claves de permisos están en los [ajustes](./configuration.md#permissions), y lo que llega a tu +disco y a la red está en [seguridad](./security.md). + +Siguiente: [peticiones para probar](./recipes.md). diff --git a/translations/ydisk/mcp.ru.md b/translations/ydisk/mcp.ru.md new file mode 100644 index 00000000..e7f88a1f --- /dev/null +++ b/translations/ydisk/mcp.ru.md @@ -0,0 +1,104 @@ +--- +title: "Подключите агента" +--- + +Дайте ИИ-агенту доступ к своему Яндекс Диску, чтобы он по вашей просьбе находил документ, цитировал его и раскладывал +файлы. Агент с терминалом сам запускает `ydisk`, когда вы установите навык инструмента. Приложение без терминала, +например Claude Desktop или Cursor, вызывает те же команды через MCP, Model Context Protocol, на котором ИИ-приложения +вызывают инструменты. Что агент может менять, решаете вы. + +**На этой странице:** + +1. [Агенты с терминалом](#agents-with-a-terminal) +2. [Claude Code и Codex через MCP](#claude-code-and-codex-over-mcp) +3. [Claude Desktop, Cursor и другие приложения с MCP](#claude-desktop-cursor-and-other-mcp-apps) +4. [ChatGPT и Claude в браузере](#chatgpt-and-claude-in-the-browser) +5. [Решите, что агент может менять](#decide-what-the-agent-may-change) + +## Агенты с терминалом + +Claude Code, Codex, Gemini CLI, OpenClaw и другим агентам, которые запускают команды, нужен только навык: короткий +файл, который учит агента командам и правилам инструмента. + +```sh +ydisk skill install +``` + +Он кладет навык туда, где его ищут Claude Code (`~/.claude/skills/`) и Codex, Gemini CLI и OpenClaw +(`~/.agents/skills/`). `ydisk skill install --for hermes` дополнительно добавляет эту папку в собственные настройки +Hermes Agent, чего простой `skill install` не делает. Запускайте команду снова после обновления. `ydisk skill status` +говорит, совпадает ли установленный навык с этой версией. + +Дальше просите обычными словами и называйте профиль: + +```text prompt +Use ydisk CLI with profile personal. What did I upload to /Documents/Invoices this month? +List the files with their dates. Do not change anything. +``` + +## Claude Code и Codex через MCP + +Чтобы подключить инструмент к Claude Code или Codex как MCP-сервер, добавьте его одной командой: + +```sh +ydisk personal mcp add claude-code --allow-writes +ydisk personal mcp add codex --allow-writes +``` + +`--allow-writes` подтверждает, что вы знаете: сервер предлагает команды, которые меняют Диск. Что выполнится, все равно +решают разрешения профиля. Подробнее в разделе [Решите, что агент может менять](#decide-what-the-agent-may-change). + +## Claude Desktop, Cursor и другие приложения с MCP + +```sh +ydisk personal mcp config +``` + +Команда печатает запись `mcpServers` с полными путями. Вставьте ее в настройки MCP приложения и перезапустите +приложение. Где какое приложение хранит настройки, написано на [странице об агентах](https://wirecat.dev/en/docs/agents). +Печатайте запись заново после смены или обновления Node.js, потому что в ней указан один путь к Node.js. + +`ydisk personal mcp check` запускает сервер так, как это сделало бы приложение, и перечисляет инструменты, которые он +предлагает. Запустите ее, если приложение не показывает инструментов `ydisk`. + +Один сервер может обслуживать несколько профилей: `ydisk mcp config --profiles personal,work`. Тогда каждый +инструмент спрашивает, какой профиль использовать. + +## ChatGPT и Claude в браузере + +Приложение в браузере не может запустить программу на вашем компьютере. Поэтому `ydisk` отдает MCP по HTTP на вашем +компьютере, а ваш собственный туннель, например Tailscale Funnel или Cloudflare Tunnel, дает ему адрес `https`: + +```sh +ydisk personal mcp server start --public-url https://laptop.example.ts.net +ydisk personal mcp server status +``` + +Адрес в примере выдуманный. Используйте адрес своего туннеля. Сервер слушает `127.0.0.1`, порт 8765 (`--port` меняет +его) и работает в фоне, пока вы не выполните `ydisk personal mcp server stop`. Приложение в браузере входит по +одноразовому коду, который печатают `server start` и `server status`. `ydisk personal mcp revoke` завершает все +входы. Настройка туннеля и приложения описана на [странице о приложениях в браузере](https://wirecat.dev/en/docs/browser-apps). + +## Решите, что агент может менять + +MCP-сервер предлагает все команды, в том числе те, что меняют Диск. В терминале инструмент спрашивает перед +удалением, перезаписью и публичной ссылкой, а через MCP спросить некого, поэтому они выполняются. Выберите для +агента один из вариантов: + +- **Только чтение.** `YDISK_READ_ONLY=1` в окружении сервера отклоняет любое изменение. +- **Без удаления и без публичных ссылок.** Задайте два разрешения для профиля: + + ```sh + ydisk personal config set permissions.files.delete deny + ydisk personal config set permissions.files.share deny + ``` + +- **Строже только для одного сервера.** `--permission` у `mcp serve`, `mcp add`, `mcp config` или + `mcp server start` делает разрешение строже для этого сервера, но никогда не мягче: + `ydisk personal mcp add claude-code --allow-writes --permission files.delete=deny`. + +Через MCP агент читает текст файла командой `files download`, но не может сохранить файл по пути на вашем компьютере. +Все ключи разрешений перечислены в [настройках](./configuration.md#permissions), а что доходит до вашего диска и сети, +описано в разделе [безопасность](./security.md). + +Дальше: [запросы, которые стоит попробовать](./recipes.md). diff --git a/translations/ydisk/recipes.es.md b/translations/ydisk/recipes.es.md new file mode 100644 index 00000000..32c50505 --- /dev/null +++ b/translations/ydisk/recipes.es.md @@ -0,0 +1,113 @@ +--- +title: "Recetas" +--- + +Tareas completas que puedes encargar a tu agente, cada una con una petición para copiar y los comandos que el agente +ejecuta. Dan por hecho que ya has [iniciado sesión](./installation.md), elegido carpetas y +[conectado tu agente](./mcp.md). Cambia el perfil, las rutas y los nombres por los tuyos. Los de aquí son ejemplos. + +**En esta página:** + +1. [Encuentra un contrato y cita sus condiciones](#find-a-contract-and-quote-its-terms) +2. [Responde a partir de un archivo fuera de las carpetas elegidas](#answer-from-a-file-outside-the-chosen-folders) +3. [Ordena las facturas del año pasado en un archivo](#tidy-last-years-invoices-into-an-archive) +4. [Comparte un archivo y cierra el enlace después](#share-a-file-and-close-the-link-later) +5. [Pon en el Disco un informe que escribió el agente](#put-a-report-the-agent-wrote-on-the-disk) +6. [Deshaz un borrado](#undo-a-delete) +7. [Mantén la copia al día cada mañana](#keep-the-copy-current-every-morning) + +## Encuentra un contrato y cita sus condiciones + +```text prompt +Use ydisk CLI with profile personal. Find the contract with Harbour Ltd in my Disk folders. +Quote the payment terms and the notice period, and give me the file's path on the Disk. Do not change any files. +``` + +```sh +ydisk personal search "Harbour Ltd contract" --json +ydisk personal documents show 1a2b3c --json +``` + +El agente busca en la copia y luego lee el texto completo del mejor resultado. Si la copia está desactualizada, +ejecuta antes `ydisk personal sync`. + +## Responde a partir de un archivo fuera de las carpetas elegidas + +```text prompt +Use ydisk CLI with profile personal. Open /Work/Q3/report.xlsx on my Disk and tell me the total for September. +``` + +```sh +ydisk personal files download /Work/Q3/report.xlsx --json +``` + +`files download` sin `--output` responde con el texto del archivo, así que no se guarda nada en tu ordenador. + +## Ordena las facturas del año pasado en un archivo + +```text prompt +Use ydisk CLI with profile personal. Move every invoice from 2025 in /Documents/Invoices to /Archive/Invoices-2025. +Show me the list before you move anything. +``` + +```sh +ydisk personal files list --folder /Documents/Invoices --json +ydisk personal files create /Archive/Invoices-2025 +ydisk personal files move /Documents/Invoices/2025-03.pdf --folder /Archive/Invoices-2025 --dry-run +ydisk personal files move /Documents/Invoices/2025-03.pdf --folder /Archive/Invoices-2025 +``` + +`--dry-run` muestra lo que haría un movimiento sin hacerlo. Un movimiento conserva las etiquetas y las notas del +archivo en la copia. + +## Comparte un archivo y cierra el enlace después + +```text prompt +Use ydisk CLI with profile personal. Make a public link to /Documents/Flat/lease-2026.pdf so I can send it to Bob. +``` + +```sh +ydisk personal files publish /Documents/Flat/lease-2026.pdf +ydisk personal files unpublish /Documents/Flat/lease-2026.pdf +``` + +Cualquiera que tenga un enlace público puede abrir el archivo. En un terminal la herramienta pregunta antes. Por MCP +sigue el permiso `files.share`, mira [conecta tu agente](./mcp.md#decide-what-the-agent-may-change). + +## Pon en el Disco un informe que escribió el agente + +```text prompt +Use ydisk CLI with profile personal. Save the summary you just wrote as summary.md in /Reports on my Disk. +``` + +```sh +ydisk personal files upload ./summary.md --folder /Reports +``` + +Una subida rechaza los archivos de credenciales, los perfiles de navegador y las carpetas de WireCat, así que un +agente no puede enviarlos al Disco por error. + +## Deshaz un borrado + +```text prompt +Use ydisk CLI with profile personal. I deleted old.pdf from my Disk by mistake. Bring it back. +``` + +```sh +ydisk personal api trash-resources-list --json +ydisk personal files restore trash:/old.pdf +``` + +`files delete` mueve un archivo a la papelera del Disco, así que puede volver hasta que se vacíe la papelera. + +## Mantén la copia al día cada mañana + +Nada se sincroniza en segundo plano. Para tener una copia fresca cada mañana, ejecuta `sync` desde el programador de +tu sistema, como cron en Linux y macOS: + +```text +0 8 * * * ydisk personal sync --quiet +``` + +La línea ejecuta la sincronización a las 8:00 todos los días. Si cron no encuentra `ydisk`, usa la ruta completa que +imprime `which ydisk`. Ejecuta `ydisk personal status` para ver cuándo terminó la última sincronización. diff --git a/translations/ydisk/recipes.ru.md b/translations/ydisk/recipes.ru.md new file mode 100644 index 00000000..20a7b6ac --- /dev/null +++ b/translations/ydisk/recipes.ru.md @@ -0,0 +1,113 @@ +--- +title: "Готовые сценарии" +--- + +Целые задачи, которые можно поручить агенту. У каждой есть запрос, который можно скопировать, и команды, которые +агент выполнит. Предполагается, что вы уже [вошли в аккаунт](./installation.md), выбрали папки и +[подключили агента](./mcp.md). Замените профиль, пути и имена на свои. Те, что в примерах, выдуманные. + +**На этой странице:** + +1. [Найдите договор и процитируйте условия](#find-a-contract-and-quote-its-terms) +2. [Ответ по файлу вне выбранных папок](#answer-from-a-file-outside-the-chosen-folders) +3. [Уберите счета прошлого года в архив](#tidy-last-years-invoices-into-an-archive) +4. [Поделитесь файлом и закройте ссылку потом](#share-a-file-and-close-the-link-later) +5. [Положите на Диск отчет, который написал агент](#put-a-report-the-agent-wrote-on-the-disk) +6. [Отмените удаление](#undo-a-delete) +7. [Обновляйте копию каждое утро](#keep-the-copy-current-every-morning) + +## Найдите договор и процитируйте условия + +```text prompt +Use ydisk CLI with profile personal. Find the contract with Harbour Ltd in my Disk folders. +Quote the payment terms and the notice period, and give me the file's path on the Disk. Do not change any files. +``` + +```sh +ydisk personal search "Harbour Ltd contract" --json +ydisk personal documents show 1a2b3c --json +``` + +Агент ищет по копии, а потом читает весь текст лучшего результата. Если копия устарела, он сначала запускает +`ydisk personal sync`. + +## Ответ по файлу вне выбранных папок + +```text prompt +Use ydisk CLI with profile personal. Open /Work/Q3/report.xlsx on my Disk and tell me the total for September. +``` + +```sh +ydisk personal files download /Work/Q3/report.xlsx --json +``` + +`files download` без `--output` отвечает текстом файла, поэтому на вашем компьютере ничего не сохраняется. + +## Уберите счета прошлого года в архив + +```text prompt +Use ydisk CLI with profile personal. Move every invoice from 2025 in /Documents/Invoices to /Archive/Invoices-2025. +Show me the list before you move anything. +``` + +```sh +ydisk personal files list --folder /Documents/Invoices --json +ydisk personal files create /Archive/Invoices-2025 +ydisk personal files move /Documents/Invoices/2025-03.pdf --folder /Archive/Invoices-2025 --dry-run +ydisk personal files move /Documents/Invoices/2025-03.pdf --folder /Archive/Invoices-2025 +``` + +`--dry-run` показывает, что сделал бы перенос, но ничего не делает. При переносе теги и заметки файла в копии +сохраняются. + +## Поделитесь файлом и закройте ссылку потом + +```text prompt +Use ydisk CLI with profile personal. Make a public link to /Documents/Flat/lease-2026.pdf so I can send it to Bob. +``` + +```sh +ydisk personal files publish /Documents/Flat/lease-2026.pdf +ydisk personal files unpublish /Documents/Flat/lease-2026.pdf +``` + +Файл откроет любой, у кого есть публичная ссылка. В терминале инструмент сначала спрашивает. Через MCP он учитывает +разрешение `files.share`, см. [подключите агента](./mcp.md#decide-what-the-agent-may-change). + +## Положите на Диск отчет, который написал агент + +```text prompt +Use ydisk CLI with profile personal. Save the summary you just wrote as summary.md in /Reports on my Disk. +``` + +```sh +ydisk personal files upload ./summary.md --folder /Reports +``` + +Загрузка отклоняет файлы с учетными данными, профили браузеров и папки WireCat, поэтому агент не отправит их на Диск +по ошибке. + +## Отмените удаление + +```text prompt +Use ydisk CLI with profile personal. I deleted old.pdf from my Disk by mistake. Bring it back. +``` + +```sh +ydisk personal api trash-resources-list --json +ydisk personal files restore trash:/old.pdf +``` + +`files delete` переносит файл в корзину Диска, поэтому его можно вернуть, пока корзина не очищена. + +## Обновляйте копию каждое утро + +В фоне ничего не синхронизируется. Чтобы копия обновлялась каждое утро, запускайте `sync` из планировщика системы, +например cron в Linux и macOS: + +```text +0 8 * * * ydisk personal sync --quiet +``` + +Эта строка запускает синхронизацию каждый день в 8:00. Если cron не находит `ydisk`, укажите полный путь, который +печатает `which ydisk`. Когда закончилась последняя синхронизация, покажет `ydisk personal status`. diff --git a/translations/ydisk/search.es.md b/translations/ydisk/search.es.md new file mode 100644 index 00000000..5a4b1c42 --- /dev/null +++ b/translations/ydisk/search.es.md @@ -0,0 +1,104 @@ +--- +title: "Encuentra un documento" +--- + +Encuentra un contrato, una cifra o una decisión en tus carpetas del Disco por lo que dice el documento, aunque no +recuerdes su nombre. La búsqueda lee la copia de tu ordenador, así que responde sin internet y no cuesta ninguna +petición a Yandex. Cubre las carpetas que elegiste y sincronizaste. Mira [carpetas y sincronización](./usage.md). + +```text prompt +Use ydisk CLI with profile personal. Find the document where we agreed the budget for the spring campaign. +Quote the passage and give me the file's path on the Disk. +``` + +**En esta página:** + +1. [Búsqueda por palabras](#search-by-words) +2. [Búsqueda por significado](#search-by-meaning) +3. [Encuentra un archivo por su nombre](#find-a-file-by-its-name) +4. [Etiquetas y notas](#tags-and-notes) +5. [En tus otras fuentes](#across-your-other-sources) +6. [Cuando la búsqueda no encuentra nada](#when-search-finds-nothing) + +## Búsqueda por palabras + +```sh +ydisk personal search "quarterly budget" +ydisk personal search "договор аренды" --limit 5 +ydisk personal search "invoice 2026" --exact +``` + +La búsqueda encuentra otras formas de una palabra: "договор" también encuentra "договора" y "договоре", y "budgets" +encuentra "budget". `--exact` busca las palabras tal como están escritas. Cada resultado trae el id del documento, +su ruta en el Disco y un fragmento. Pasa el id a `documents show` para ver el texto completo. + +Un campo acota los resultados: `tag:` encuentra los documentos con una etiqueta tuya, y `date:` busca por la fecha +del último cambio en el Disco. + +```sh +ydisk personal search "budget tag:follow-up" +ydisk personal search "budget date>=30d" +``` + +## Búsqueda por significado + +La búsqueda por significado encuentra un documento que responde a una pregunta con otras palabras, como "¿qué +acordamos gastar?" para un texto que dice "el presupuesto se aprueba en 2 millones". Usa un modelo de texto de tu +ordenador, compartido por todas las herramientas de WireCat. Descarga el modelo una vez con una herramienta de WireCat +que tenga el comando `models`, como [Memo](https://wirecat.dev/en/docs/memo), y luego indexa la copia: + +```sh +memo models download embeddinggemma +ydisk personal sync --embed +ydisk personal search "what did we agree to spend?" +``` + +La descarga usa la red. La indexación y la búsqueda se ejecutan en tu ordenador. Sin el modelo, la búsqueda por +palabras funciona como siempre. + +## Encuentra un archivo por su nombre + +`catalog` busca en los nombres y tipos de los archivos y carpetas que listó la sincronización, incluidas las fotos y +otros archivos sin texto. `catalog import` pasa lo que listó la sincronización al almacén local. Ejecútalo después de +sincronizar: + +```sh +ydisk personal catalog import +ydisk personal catalog search "passport" +ydisk personal catalog tree +``` + +Un archivo fuera de las carpetas elegidas se encuentra en directo: `files list --folder /Documents` lista una carpeta +del Disco. + +## Etiquetas y notas + +Las etiquetas y las notas son tuyas y se quedan en tu ordenador. El Disco nunca las ve. Se quedan con el documento +cuando el archivo se mueve. + +```sh +ydisk personal tags add 1a2b3c follow-up +ydisk personal notes add 1a2b3c "Signed copy is with Anna" +ydisk personal documents context 1a2b3c +``` + +El id de arriba es un ejemplo. Toma uno real de `search` o de `documents list`. `documents context` muestra un +documento con sus etiquetas, notas y recuerdos. + +## En tus otras fuentes + +La copia vive en el almacén local que comparten las otras herramientas de WireCat. Con +[Memo](https://wirecat.dev/en/docs/memo), una sola búsqueda encuentra un documento del Disco junto al chat de +Telegram o al correo donde se habló de él. + +## Cuando la búsqueda no encuentra nada + +Un resultado vacío significa que nada coincidió en la copia, no que el Disco no tenga ese archivo. Comprueba, por +este orden: + +1. `ydisk personal folders list`: ¿está elegida la carpeta del archivo? +2. `ydisk personal status`: ¿terminó la sincronización y el archivo figura como guardado solo por el nombre? +3. Ejecuta `ydisk personal sync` si el archivo es nuevo. +4. Busca el nombre con `catalog search`, o lista la carpeta en directo con `files list`. + +Un PDF escaneado no tiene capa de texto, así que solo se puede buscar por su nombre. diff --git a/translations/ydisk/search.ru.md b/translations/ydisk/search.ru.md new file mode 100644 index 00000000..1b5e559a --- /dev/null +++ b/translations/ydisk/search.ru.md @@ -0,0 +1,102 @@ +--- +title: "Найдите документ" +--- + +Найдите договор, цифру или решение в папках Диска по тому, что написано в документе, даже если вы не помните его имя. +Поиск читает копию на вашем компьютере, поэтому отвечает без интернета и не тратит запросы к Яндексу. Он охватывает +папки, которые вы выбрали и синхронизировали. См. [папки и синхронизация](./usage.md). + +```text prompt +Use ydisk CLI with profile personal. Find the document where we agreed the budget for the spring campaign. +Quote the passage and give me the file's path on the Disk. +``` + +**На этой странице:** + +1. [Поиск по словам](#search-by-words) +2. [Поиск по смыслу](#search-by-meaning) +3. [Найдите файл по имени](#find-a-file-by-its-name) +4. [Теги и заметки](#tags-and-notes) +5. [По другим вашим источникам](#across-your-other-sources) +6. [Если поиск ничего не нашел](#when-search-finds-nothing) + +## Поиск по словам + +```sh +ydisk personal search "quarterly budget" +ydisk personal search "договор аренды" --limit 5 +ydisk personal search "invoice 2026" --exact +``` + +Поиск находит другие формы слова: «договор» найдет и «договора», и «договоре», а «budgets» найдет «budget». +`--exact` ищет слова ровно так, как они написаны. У каждого результата есть id документа, его путь на Диске и +отрывок. Передайте id в `documents show`, чтобы увидеть весь текст. + +Поле сужает результаты: `tag:` находит документы с вашим тегом, а `date:` ищет по дате последнего изменения на +Диске. + +```sh +ydisk personal search "budget tag:follow-up" +ydisk personal search "budget date>=30d" +``` + +## Поиск по смыслу + +Поиск по смыслу находит документ, который отвечает на вопрос другими словами. Например, на вопрос «о чем мы +договорились по расходам?» он найдет текст «бюджет утвержден на 2 миллиона». Для этого он использует текстовую модель +на вашем компьютере, общую для всех инструментов WireCat. Скачайте модель один раз через инструмент WireCat с +командой `models`, например [Memo](https://wirecat.dev/en/docs/memo), а затем проиндексируйте копию: + +```sh +memo models download embeddinggemma +ydisk personal sync --embed +ydisk personal search "what did we agree to spend?" +``` + +Скачивание идет по сети. Индексация и поиск выполняются на вашем компьютере. Без модели поиск по словам работает как +раньше. + +## Найдите файл по имени + +`catalog` ищет по именам и типам файлов и папок, которые перечислила синхронизация, в том числе фото и другие файлы +без текста. `catalog import` кладет то, что перечислила синхронизация, в локальное хранилище. Запускайте его после +синхронизации: + +```sh +ydisk personal catalog import +ydisk personal catalog search "passport" +ydisk personal catalog tree +``` + +Файл вне выбранных папок находится напрямую на Диске: `files list --folder /Documents` показывает содержимое папки +на Диске. + +## Теги и заметки + +Теги и заметки принадлежат вам и остаются на вашем компьютере. Диск их не видит. Они остаются с документом, когда +файл переносят. + +```sh +ydisk personal tags add 1a2b3c follow-up +ydisk personal notes add 1a2b3c "Signed copy is with Anna" +ydisk personal documents context 1a2b3c +``` + +Id в примере выдуманный. Возьмите настоящий из `search` или `documents list`. `documents context` показывает +документ вместе с его тегами, заметками и записями памяти. + +## По другим вашим источникам + +Копия лежит в локальном хранилище, общем для других инструментов WireCat. С [Memo](https://wirecat.dev/en/docs/memo) +один поиск находит документ с Диска рядом с чатом Telegram или письмом, где его обсуждали. + +## Если поиск ничего не нашел + +Пустой результат значит, что в копии ничего не подошло, а не что такого файла нет на Диске. Проверьте по порядку: + +1. `ydisk personal folders list`: выбрана ли папка с файлом? +2. `ydisk personal status`: закончилась ли синхронизация и не сохранен ли файл только по имени? +3. Если файл новый, запустите `ydisk personal sync`. +4. Поищите имя через `catalog search` или покажите папку напрямую через `files list`. + +В отсканированном PDF нет текстового слоя, поэтому искать можно только по его имени. diff --git a/translations/ydisk/security.es.md b/translations/ydisk/security.es.md new file mode 100644 index 00000000..4a79cc6f --- /dev/null +++ b/translations/ydisk/security.es.md @@ -0,0 +1,79 @@ +--- +title: "Seguridad" +--- + +Descubre qué guarda `ydisk` en tu ordenador, qué envía y a quién, y cómo quitarlo. Lo que comparten todas las CLI de +WireCat, como el llavero, los permisos, MCP y lo que nunca llega a un registro, está en la +[página de seguridad común](https://wirecat.dev/en/docs/security). Esta página recoge solo lo propio de `ydisk`. + +**En esta página:** + +1. [Qué se queda en tu ordenador](#what-stays-on-your-computer) +2. [Qué sale por la red](#what-goes-over-the-network) +3. [Agentes y MCP](#agents-and-mcp) +4. [Registros de ejecución](#run-records) +5. [Permisos de archivos](#file-permissions) + +## Qué se queda en tu ordenador + +| Qué | Dónde | Cómo quitarlo | +| --- | --- | --- | +| El token de Yandex | El llavero del sistema, o un archivo privado donde no lo hay | `ydisk personal session end` | +| El texto de los archivos de las carpetas elegidas, con sus nombres, rutas, tamaños, fechas y sumas MD5 | El almacén local, `wirecat.db`, compartido con las demás herramientas de WireCat | `folders remove` con el id de la carpeta de `folders list`, y luego `sync` | +| Tus etiquetas, notas y recuerdos sobre documentos | El almacén local | `tags remove`, `notes remove` | +| Ajustes y registros de ejecución | Las carpetas que muestra `ydisk doctor` | `ydisk runs list` los muestra. Caducan tras los días indicados en los [ajustes](./configuration.md#run-records) | + +Los archivos en sí se quedan en el Disco. Solo se guarda una copia de un archivo cuando ejecutas +`files download --output`. La sincronización no guarda los enlaces públicos (`public_url`). Nada va a WireCat: no hay +servidor de WireCat ni una cuenta con nosotros. + +## Qué sale por la red + +`ydisk` guarda sus ajustes en `config.json` y su estado en las carpetas que muestra `ydisk doctor`. Habla con un solo +servicio, la API de Yandex Disk en `cloud-api.yandex.net`. `session start` guarda el token OAuth de Yandex en el +llavero del sistema, o en un archivo privado donde no funciona ningún llavero. El token va solo en la cabecera +Authorization de una petición a `cloud-api.yandex.net`, nunca en una dirección, una respuesta, un registro de ejecución +ni el diario de envíos. Las descargas y las subidas van al enlace que da Yandex (`downloader.disk.yandex.ru`, +`*.disk.yandex.net`, `*.storage.yandex.net`) sin el token, y esos enlaces nunca se imprimen. + +Además de a Yandex, `ydisk` pregunta una vez al día al registro de npm si hay una versión más nueva, salvo que +`update_check` sea `false`. El texto va a un proveedor de IA solo cuando tú configuras uno, como `embedding_provider` +con el valor `openai` o `memories extract`. Por defecto la búsqueda por significado se ejecuta en tu ordenador. + +## Agentes y MCP + +Por MCP un agente lee el texto de un archivo con `files download`, pero no puede guardarlo en una ruta: `--output` es +solo del propietario. `files upload` rechaza los archivos de credenciales, los perfiles de navegador y las carpetas de +WireCat salvo que el propietario añada `--allow-any-file`. `files delete`, `--replace` y los comandos de enlaces +públicos preguntan primero en una terminal. Por MCP solo los detiene `deny`, así que define `files.delete=deny` y +`files.share=deny` para un agente que no deba hacerlo, y `files.upload=deny` para uno que no deba poner ningún archivo +local en el Disco. + +`ydisk personal mcp serve --http` escucha solo en `127.0.0.1`, para aplicaciones del navegador que llegan a él por tu +propio túnel. Cada aplicación inicia sesión con un código de un solo uso, y el servidor guarda un hash de cada inicio +de sesión que da, en la carpeta de estado, legible solo por ti. `ydisk personal mcp revoke` los olvida todos. + +## Registros de ejecución + +Un registro de ejecución guarda la línea de comandos tal como la escribiste, así que `ydisk runs show` te dice qué se +ejecutó. Aun así, un secreto se guarda como `[redacted]`: una opción con nombre de token o contraseña, una contraseña +en un enlace, una cadena larga y opaca. Un número de teléfono se sustituye por `[redacted]` dentro de la palabra que +escribiste, texto de mensajes incluido: uno escrito con su "+" y el prefijo del país, o de 11 a 15 dígitos seguidos, +así que un id largo de esa longitud también se oculta. Para no guardar ninguna de las palabras que escribes, ejecuta +`ydisk personal config set record_input false`. + +Un secreto también se detecta por su aspecto, en un registro de ejecución y en un mensaje de error guardado: un token +en un formato conocido (GitHub, OpenAI, Slack, AWS, Stripe, npm y similares), una credencial `Bearer`, una cadena de +aspecto aleatorio de 20 o más caracteres y una serie de aspecto aleatorio de 20 o más caracteres hexadecimales en +minúscula, como una clave hexadecimal o un hash completo de commit. El valor que sigue al nombre de un secreto también +se oculta, ya vaya tras `=`, `:` o un espacio: `password=`, `API_TOKEN=`, `password hunter2`, `pin 1234`. Algunos +secretos parecen palabras normales y se quedan: un valor solo de letras tras un nombre de secreto y un espacio (`pin this message` se queda), una clave hexadecimal en mayúsculas, un hash corto de commit o un UUID, una contraseña corta +escrita sin un nombre de secreto delante, y un secreto dentro de un enlace o una ruta de archivo salvo que tenga un +formato conocido o vaya tras un nombre de secreto. + +## Permisos de archivos + +`config.json` se guarda legible solo por ti (`0600`), y su carpeta se crea solo para ti (`0700`). Un archivo o una +carpeta creados por una versión anterior pueden estar abiertos a otros usuarios del ordenador: `ydisk doctor` lista +cada uno en `files.problems` e imprime el `chmod` que lo arregla. Windows no se comprueba. Informa de una +vulnerabilidad como indica [SECURITY.md](https://github.com/WireCatLabs/ydisk-cli/blob/main/SECURITY.md). diff --git a/translations/ydisk/security.ru.md b/translations/ydisk/security.ru.md new file mode 100644 index 00000000..e0b84fbb --- /dev/null +++ b/translations/ydisk/security.ru.md @@ -0,0 +1,78 @@ +--- +title: "Безопасность" +--- + +Узнайте, что `ydisk` хранит на вашем компьютере, что отправляет и кому, и как это удалить. Что общего у всех CLI +WireCat, то есть связка ключей, разрешения, MCP и то, что никогда не попадает в лог, описано на +[общей странице о безопасности](https://wirecat.dev/en/docs/security). Здесь только то, что свойственно `ydisk`. + +**На этой странице:** + +1. [Что остается на вашем компьютере](#what-stays-on-your-computer) +2. [Что уходит по сети](#what-goes-over-the-network) +3. [Агенты и MCP](#agents-and-mcp) +4. [Записи запусков](#run-records) +5. [Права на файлы](#file-permissions) + +## Что остается на вашем компьютере + +| Что | Где | Как удалить | +| --- | --- | --- | +| Токен Яндекса | Связка ключей системы, а где ее нет, закрытый файл | `ydisk personal session end` | +| Текст файлов в выбранных папках, с их именами, путями, размерами, датами и контрольными суммами MD5 | Локальное хранилище `wirecat.db`, общее с другими инструментами WireCat | `folders remove` с id папки из `folders list`, затем `sync` | +| Ваши теги, заметки и записи памяти о документах | Локальное хранилище | `tags remove`, `notes remove` | +| Настройки и записи запусков | Папки, которые показывает `ydisk doctor` | `ydisk runs list` показывает их. Они удаляются через столько дней, сколько указано в [настройках](./configuration.md#run-records) | + +Сами файлы остаются на Диске. Копия файла сохраняется, только когда вы запускаете `files download --output`. +Публичные ссылки (`public_url`) синхронизация не хранит. В WireCat ничего не уходит: сервера WireCat нет, и аккаунта +у нас тоже. + +## Что уходит по сети + +`ydisk` хранит настройки в `config.json`, а состояние в папках, которые показывает `ydisk doctor`. Он обращается к +одному сервису, API Яндекс Диска по адресу `cloud-api.yandex.net`. `session start` сохраняет токен OAuth Яндекса в +связке ключей системы, а где она не работает, в закрытом файле. Токен уходит только в заголовок Authorization запроса к +`cloud-api.yandex.net` и никогда не попадает в адрес, ответ, запись запуска или журнал отправок. Скачивание и загрузка +идут по ссылке, которую выдает Яндекс (`downloader.disk.yandex.ru`, `*.disk.yandex.net`, `*.storage.yandex.net`), без +токена, и эти ссылки никогда не печатаются. + +Кроме Яндекса, `ydisk` раз в день спрашивает у реестра npm, есть ли новая версия, если только `update_check` не равен +`false`. Текст уходит к провайдеру ИИ, только если вы его настроили: например, `embedding_provider` со значением +`openai` или `memories extract`. По умолчанию поиск по смыслу работает на вашем компьютере. + +## Агенты и MCP + +По MCP агент читает текст файла через `files download`, но не может сохранить его по пути: `--output` есть только у +владельца. `files upload` отказывается загружать файлы с учетными данными, профили браузеров и папки WireCat, пока +владелец не добавит `--allow-any-file`. `files delete`, `--replace` и команды публичных ссылок в терминале сначала +спрашивают. По MCP их останавливает только `deny`, поэтому задайте `files.delete=deny` и `files.share=deny` для +агента, которому это не нужно, и `files.upload=deny` для того, кто не должен класть на Диск ни одного локального +файла. + +`ydisk personal mcp serve --http` слушает только `127.0.0.1`, для приложений в браузере, которые подключаются через +ваш собственный туннель. Каждое приложение входит по одноразовому коду, а сервер хранит хеш каждого выданного входа в +папке состояния, читаемой только вами. `ydisk personal mcp revoke` забывает их все. + +## Записи запусков + +Запись запуска хранит командную строку так, как вы ее набрали, поэтому `ydisk runs show` показывает, что запускалось. +Секрет при этом сохраняется как `[redacted]`: параметр с именем вроде token или password, пароль в ссылке, длинная +непрозрачная строка. Номер телефона заменяется на `[redacted]` внутри набранного вами слова, в том числе в тексте +сообщения: записанный с «+» и кодом страны или 11–15 цифр подряд, так что длинный id такой длины тоже скрывается. Чтобы +не хранить ни одного набранного слова, выполните `ydisk personal config set record_input false`. + +Секрет находится и по внешнему виду, в записи запуска и в сохраненном тексте ошибки: токен в известном формате +(GitHub, OpenAI, Slack, AWS, Stripe, npm и подобные), учетные данные `Bearer`, случайная на вид строка из 20 и более +символов и случайная на вид последовательность из 20 и более строчных шестнадцатеричных символов, например +шестнадцатеричный ключ или полный хеш коммита. Значение после имени секрета тоже скрывается, идет ли оно после `=`, +`:` или пробела: `password=`, `API_TOKEN=`, `password hunter2`, `pin 1234`. Некоторые секреты выглядят как обычные +слова и остаются: значение из одних букв после имени секрета и пробела (`pin this message` остается), шестнадцатеричный +ключ в верхнем регистре, короткий хеш коммита или UUID, короткий пароль без имени секрета перед ним и секрет внутри +ссылки или пути к файлу, если он не в известном формате и не после имени секрета. + +## Права на файлы + +`config.json` сохраняется читаемым только вами (`0600`), а его папка создается только для вас (`0700`). Файл или +папка, созданные старой версией, могут быть открыты другим пользователям компьютера: `ydisk doctor` перечисляет +каждый такой в `files.problems` и печатает `chmod`, который это исправляет. Windows не проверяется. О уязвимости +сообщите так, как описано в [SECURITY.md](https://github.com/WireCatLabs/ydisk-cli/blob/main/SECURITY.md). diff --git a/translations/ydisk/troubleshooting.es.md b/translations/ydisk/troubleshooting.es.md new file mode 100644 index 00000000..e6748760 --- /dev/null +++ b/translations/ydisk/troubleshooting.es.md @@ -0,0 +1,68 @@ +--- +title: "Cuando algo falla" +--- + +Un inicio de sesión que falla, una sincronización que se detiene, una búsqueda que no encuentra nada: busca aquí tu +síntoma y arréglalo en uno o dos minutos. Cada error dice en su mensaje qué hacer, y su código de salida le indica a un +script qué tipo de fallo fue. + +**En esta página:** + +1. [Primera comprobación](#first-check) +2. [Por síntoma](#by-symptom) +3. [Códigos de salida](#exit-codes) +4. [Si sigue fallando](#if-it-still-fails) + +## Primera comprobación + +```sh +ydisk doctor +ydisk personal doctor --online +``` + +`doctor` no lee el llavero ni usa la red. Muestra qué está configurado y cualquier problema del archivo de ajustes. +`doctor --online` además pregunta a Yandex si el token del perfil funciona. + +## Por síntoma + +| Síntoma | Qué hacer | +| --- | --- | +| No se encuentra `ydisk` | Abre una terminal nueva y comprueba que la carpeta global de npm está en `PATH`. | +| "name a profile" | Pon el perfil primero, como en `ydisk personal status`, o define `YDISK_PROFILE`. | +| "refused the token", código de salida 4 | El token es incorrecto, se revocó o caducó. [Consigue un token nuevo](./installation.md#get-a-yandex-token) y vuelve a ejecutar `ydisk personal session start`. | +| Un cambio falla con el código de salida 5 | El token no tiene el permiso `cloud_api:disk.write`, o lo rechazan los permisos del perfil o `YDISK_READ_ONLY`. Revisa los [ajustes](./configuration.md#permissions). Para el permiso, registra la aplicación de nuevo con él y consigue un token nuevo. | +| "the OS keyring did not answer" en Linux | El bus de sesión se reinició. Cierra la sesión y vuelve a entrar, o inicia sesión con `session start --credential-storage file`. | +| "no such item, or this token cannot see it", código de salida 6 | Comprueba la ruta con `files list --folder` en su carpeta superior. Una ruta del Disco empieza por `/`, como en `/Documents/plan.pdf`. | +| "asked to slow down", código de salida 8 | Yandex recibió demasiadas peticiones de esta cuenta. Espera un minuto y vuelve a ejecutar el comando. | +| Una sincronización se detiene antes del final | Una sincronización lee hasta 200 archivos. Ejecuta `sync` otra vez hasta que `status` no muestre trabajo pendiente. | +| Faltan los documentos de una carpeta elegida | La carpeta se renombró o se movió en el Disco. Añádela de nuevo con su ruta nueva con `folders add`. | +| La búsqueda no encuentra un archivo que sabes que está | Mira [cuando la búsqueda no encuentra nada](./search.md#when-search-finds-nothing). | +| Un PDF se encuentra por el nombre pero no por su texto | Es un escaneo sin capa de texto, o pesa más de 50 MB. `status` lista esos archivos con el motivo. | +| Una subida falla porque el Disco está lleno | Libera espacio en el Disco o vacía su papelera. Reintentar no sirve hasta que haya sitio. | +| Se rechaza una subida grande | Yandex limita el tamaño de un archivo según el plan: 1 GB sin un plan de Yandex 360, más con uno ([límites de Yandex](https://yandex.ru/support/yandex-360/customers/disk/web/ru/uploading)). | +| Un cambio terminó con "outcome_unknown", código de salida 14 | Yandex falló durante el cambio, así que puede que se hiciera o puede que no. Comprueba con `files show` antes de volver a ejecutarlo. | +| Un agente cambió un archivo que no querías que cambiara | Por MCP el nivel ask deja que un comando se ejecute. Deniega `files.delete` y `files.share`, o define `YDISK_READ_ONLY=1`. Mira [conecta a tu agente](./mcp.md#decide-what-the-agent-may-change). Un archivo borrado está en la papelera del Disco: `files restore`. | +| El archivo de ajustes no se lee | `doctor` lista cada problema del archivo en `config.issues`. Ejecuta el `config unset` que da cada uno, `config repair`, o corrige el archivo a mano. | +| `doctor` lista `files.problems` | Otros usuarios del ordenador pueden leer `config.json` o entrar en su carpeta. Ejecuta cada `chmod` que `doctor` imprime después de "to make it private:". | + +## Códigos de salida + +| Código | Significado | +| --- | --- | +| 2 | El comando se escribió mal: falta un perfil, un argumento o una opción. | +| 3 | Los ajustes o el llavero no se pueden usar. | +| 4 | Yandex rechazó el token. | +| 5 | No permitido: los permisos del token o los del perfil. | +| 6 | No existe ese archivo o carpeta, o el token no lo ve. | +| 7 | Un cambio necesita tu confirmación y no había terminal para preguntarla. | +| 8 | Yandex pidió ir más despacio. | +| 14 | Puede que un cambio se hiciera o puede que no. | + +Todos los códigos están en la [referencia de comandos](./commands.md). + +## Si sigue fallando + +`ydisk runs list` muestra las ejecuciones recientes, y `ydisk runs show` una de ellas con cada paso que dio. Los +secretos están ocultos. `ydisk doctor reports create` escribe un archivo de informe para un reporte de error y dice qué +contiene. Abre una incidencia en [github.com/WireCatLabs/ydisk-cli/issues](https://github.com/WireCatLabs/ydisk-cli/issues) +con el código de error y el comando. No pegues nunca un token ni contenido privado en una incidencia. diff --git a/translations/ydisk/troubleshooting.ru.md b/translations/ydisk/troubleshooting.ru.md new file mode 100644 index 00000000..0e7f4c35 --- /dev/null +++ b/translations/ydisk/troubleshooting.ru.md @@ -0,0 +1,68 @@ +--- +title: "Когда что-то пошло не так" +--- + +Вход не удался, синхронизация остановилась, поиск ничего не находит: найдите свой случай здесь и исправьте его за +минуту-две. Каждая ошибка в своем сообщении говорит, что делать, а код выхода подсказывает скрипту, какой это был +сбой. + +**На этой странице:** + +1. [Первая проверка](#first-check) +2. [По симптомам](#by-symptom) +3. [Коды выхода](#exit-codes) +4. [Если не помогло](#if-it-still-fails) + +## Первая проверка + +```sh +ydisk doctor +ydisk personal doctor --online +``` + +`doctor` не читает связку ключей и не ходит в сеть. Он показывает, что настроено и какие есть проблемы с файлом +настроек. `doctor --online` еще спрашивает Яндекс, работает ли токен профиля. + +## По симптомам + +| Симптом | Что делать | +| --- | --- | +| `ydisk` не найден | Откройте новый терминал и проверьте, что глобальная папка npm есть в `PATH`. | +| "name a profile" | Поставьте профиль первым словом, как в `ydisk personal status`, или задайте `YDISK_PROFILE`. | +| "refused the token", код выхода 4 | Токен неверный, отозван или истек. [Получите новый токен](./installation.md#get-a-yandex-token) и снова выполните `ydisk personal session start`. | +| Изменение завершается с кодом выхода 5 | У токена нет права `cloud_api:disk.write`, или его запрещают разрешения профиля или `YDISK_READ_ONLY`. Проверьте [настройки](./configuration.md#permissions). Чтобы получить право, зарегистрируйте приложение заново с ним и получите новый токен. | +| "the OS keyring did not answer" в Linux | Шина сеанса перезапустилась. Выйдите из системы и войдите снова или войдите через `session start --credential-storage file`. | +| "no such item, or this token cannot see it", код выхода 6 | Проверьте путь через `files list --folder` для его родительской папки. Путь на Диске начинается с `/`, как в `/Documents/plan.pdf`. | +| "asked to slow down", код выхода 8 | Яндекс получил слишком много запросов с этого аккаунта. Подождите минуту и повторите команду. | +| Синхронизация останавливается до конца | Одна синхронизация читает до 200 файлов. Запускайте `sync` снова, пока `status` не покажет, что работы не осталось. | +| Документы выбранной папки пропали | Папку переименовали или переместили на Диске. Добавьте ее снова по новому пути через `folders add`. | +| Поиск не находит файл, который точно есть | См. [когда поиск ничего не находит](./search.md#when-search-finds-nothing). | +| PDF находится по имени, но не по тексту | Это скан без текстового слоя или файл больше 50 МБ. `status` перечисляет такие файлы с причиной. | +| Загрузка не удалась, потому что Диск заполнен | Освободите место на Диске или очистите корзину. Повтор не поможет, пока нет места. | +| Большую загрузку отклоняют | Яндекс ограничивает размер одного файла по тарифу: 1 ГБ без тарифа Яндекс 360 и больше с ним ([ограничения Яндекса](https://yandex.ru/support/yandex-360/customers/disk/web/ru/uploading)). | +| Изменение завершилось с "outcome_unknown", код выхода 14 | Яндекс дал сбой во время изменения, поэтому оно могло пройти, а могло нет. Проверьте через `files show`, прежде чем запускать снова. | +| Агент изменил файл, который вы не хотели менять | По MCP уровень ask дает команде выполниться. Запретите `files.delete` и `files.share` или задайте `YDISK_READ_ONLY=1`. См. [подключение агента](./mcp.md#decide-what-the-agent-may-change). Удаленный файл лежит в корзине Диска: `files restore`. | +| Файл настроек не читается | `doctor` перечисляет каждую проблему файла в `config.issues`. Выполните `config unset`, который дан для каждой, или `config repair`, или поправьте файл вручную. | +| `doctor` перечисляет `files.problems` | Другие пользователи компьютера могут читать `config.json` или заходить в его папку. Выполните каждый `chmod`, который `doctor` печатает после "to make it private:". | + +## Коды выхода + +| Код | Что значит | +| --- | --- | +| 2 | Команда задана неверно: нет профиля, аргумента или параметра. | +| 3 | Настройки или связка ключей непригодны. | +| 4 | Яндекс отклонил токен. | +| 5 | Нельзя: права токена или разрешения профиля. | +| 6 | Нет такого файла или папки, или токен их не видит. | +| 7 | Изменение требует вашего подтверждения, а терминала для вопроса не было. | +| 8 | Яндекс просит снизить темп. | +| 14 | Изменение могло пройти, а могло нет. | + +Все коды есть в [справочнике команд](./commands.md). + +## Если не помогло + +`ydisk runs list` показывает последние запуски, а `ydisk runs show` один из них со всеми шагами. Секреты скрыты. +`ydisk doctor reports create` записывает файл отчета для сообщения об ошибке и говорит, что в нем лежит. Создайте +обращение на [github.com/WireCatLabs/ydisk-cli/issues](https://github.com/WireCatLabs/ydisk-cli/issues) с кодом ошибки +и командой. Никогда не вставляйте в обращение токен или личное содержимое. diff --git a/translations/ydisk/usage.es.md b/translations/ydisk/usage.es.md new file mode 100644 index 00000000..183f1087 --- /dev/null +++ b/translations/ydisk/usage.es.md @@ -0,0 +1,130 @@ +--- +title: "Carpetas y sincronización" +--- + +Elige las carpetas del Disk cuyo texto quieres buscar, mantén su copia al día y trabaja en vivo con cualquier archivo +del Disk. Después de esta página tu agente responde desde las carpetas que elegiste y cambia archivos solo donde tú lo +permites. Da por hecho que ya [iniciaste sesión](./installation.md). + +**En esta página:** + +1. [Primero el perfil](#the-profile-comes-first) +2. [Elige carpetas](#choose-folders) +3. [Sincroniza](#sync) +4. [Qué guarda la copia](#what-the-copy-holds) +5. [Lee un documento sincronizado](#read-a-synced-document) +6. [Trabaja con archivos en vivo](#work-with-files-live) +7. [Salida para scripts](#output-for-scripts) + +## Primero el perfil + +Un perfil es el nombre que eliges para una cuenta. Es la primera palabra de todo comando que usa una cuenta: + +```sh +ydisk personal status +``` + +`YDISK_PROFILE=personal` hace lo mismo durante una sesión de la shell. Nunca se supone un perfil, ni siquiera el único: +un comando sin perfil se detiene con el código de salida 2 y lista los perfiles de este ordenador. + +## Elige carpetas + +`folders browse` lista el Disk un nivel cada vez, en vivo, para que encuentres una carpeta por su ruta: + +```sh +ydisk personal folders browse +ydisk personal folders browse --folder /Documents +ydisk personal folders add /Documents/Contracts +``` + +Una carpeta elegida incluye todo lo que hay debajo, subcarpetas incluidas. `folders list` muestra las carpetas que +elegiste y `folders remove` quita una. La siguiente sincronización retira sus documentos de la copia. + +Elige unas pocas carpetas con documentos, no todo el Disk. Yandex Disk no avisa a la herramienta de lo que cambió, así +que cada sincronización vuelve a listar todas las carpetas elegidas y sus subcarpetas. Una carpeta de fotos añade +tiempo de listado y ningún texto en el que buscar. + +## Sincroniza + +```sh +ydisk personal sync +ydisk personal status +``` + +`sync` descarga los archivos nuevos o cuyo contenido cambió desde la última sincronización y lee su texto. Un archivo +borrado en el Disk sale de la copia. Un archivo movido dentro de las carpetas elegidas conserva sus etiquetas y notas. + +Una sincronización lee hasta 200 archivos (`--limit`) y lista hasta unas 10 000 entradas, y luego guarda dónde se +detuvo. Una carpeta grande necesita varias ejecuciones: ejecuta `sync` otra vez hasta que `status` no muestre trabajo +pendiente. Una parada no pierde nada y la siguiente sincronización sigue desde donde terminó la anterior. + +Ejecuta `sync` cuando quieras que la copia se ponga al día, por ejemplo antes de preguntar a tu agente por archivos +recientes. Nada se ejecuta en segundo plano. `sync --rescan` lee todas las carpetas elegidas desde el principio. +Ejecútalo una vez y sigue después con un `sync` normal. + +Una carpeta elegida que renombras o mueves en el Disk ya no se encuentra, y sus documentos salen de la copia. Añádela +de nuevo con su ruta nueva. + +## Qué guarda la copia + +| En el Disk | En la copia | +| --- | --- | +| PDF con capa de texto, Word `.docx`, Excel `.xlsx`, CSV, TSV, texto plano, Markdown | El texto, el nombre, la ruta, el tamaño y las fechas | +| Un PDF escaneado o una imagen | El nombre, la ruta y las fechas. No hay texto que leer | +| Cualquier otro archivo, y cualquier archivo de más de 50 MB | El nombre, la ruta y las fechas | + +`status` lista cada archivo guardado solo por su nombre, con el motivo. Los archivos siguen en el Disk. La copia guarda +su texto. Las horas se guardan y se muestran en UTC. + +## Lee un documento sincronizado + +```sh +ydisk personal documents list +ydisk personal documents show 1a2b3c --json +ydisk personal documents export 1a2b3c --output ./contract.md +``` + +`documents show` imprime el texto completo de un documento, que encuentras por su id en `search` o `documents list`. El +id de arriba es un ejemplo. `documents export` lo escribe en un archivo Markdown nuevo. Las etiquetas, las notas y los +recuerdos se quedan con el documento y nunca llegan al Disk. Consulta [encuentra un documento](./search.md). + +## Trabaja con archivos en vivo + +Los comandos `files` van directamente al Disk y no necesitan sincronización. Las rutas son rutas del Disk, como +`/Documents/plan.pdf`. + +```sh +ydisk personal files list --folder /Documents +ydisk personal files show /Documents/plan.pdf +ydisk personal files download /Documents/plan.pdf --json +ydisk personal files download /Documents/plan.pdf --output ./plan.pdf +ydisk personal files upload ./notes.md --folder /Documents +ydisk personal files copy /Documents/plan.pdf --folder /Archive +ydisk personal files move /Documents/old.pdf --folder /Archive +ydisk personal files create /Projects/2026 +ydisk personal files delete /Documents/old.pdf +ydisk personal files restore trash:/old.pdf +ydisk personal files publish /Documents/plan.pdf +ydisk personal files unpublish /Documents/plan.pdf +``` + +- `files download` sin `--output` responde con el texto del archivo, hasta 200 000 caracteres, para que un agente lea + un archivo fuera de las carpetas elegidas sin guardarlo. +- `files delete` mueve un archivo a la papelera del Disk y `files restore` lo devuelve por su ruta en la papelera. +- `files publish` crea un enlace público que puede abrir cualquiera que lo tenga. `files unpublish` lo cierra. +- `--replace` en una subida, una copia o un movimiento sobrescribe un archivo que ya está en esa ruta. + +En un terminal, la herramienta pregunta antes de borrar, sobrescribir o crear un enlace público. Por MCP no hay nadie +a quien preguntar, así que define esos permisos para un agente. Consulta los [ajustes](./configuration.md#permissions). +Añade `--dry-run` a cualquier cambio para ver qué haría sin hacerlo. + +Cada operación de la API de Disk de Yandex es también un comando: `ydisk personal api list` las lista y +`ydisk personal api show resources-list` muestra los parámetros de una operación sin llamar a Yandex. + +## Salida para scripts + +Todos los comandos salvo `mcp serve` aceptan `--json` e imprimen un único valor JSON en stdout. Los errores salen en +JSON por stderr, con un `code` para ramificar, y cada tipo de fallo tiene su propio código de salida. La +[referencia de comandos](./commands.md) los lista. + +Siguiente: [encuentra un documento](./search.md) o [conecta tu agente](./mcp.md). diff --git a/translations/ydisk/usage.ru.md b/translations/ydisk/usage.ru.md new file mode 100644 index 00000000..2f680f32 --- /dev/null +++ b/translations/ydisk/usage.ru.md @@ -0,0 +1,132 @@ +--- +title: "Папки и синхронизация" +--- + +Выберите папки Диска, текст которых хотите искать, обновляйте их копию и работайте с любым файлом на Диске вживую. +После этой страницы ваш агент отвечает по выбранным папкам и меняет файлы только там, где вы разрешили. Страница +считает, что вы уже [вошли](./installation.md). + +**На этой странице:** + +1. [Сначала профиль](#the-profile-comes-first) +2. [Выберите папки](#choose-folders) +3. [Синхронизация](#sync) +4. [Что хранит копия](#what-the-copy-holds) +5. [Читайте синхронизированный документ](#read-a-synced-document) +6. [Работа с файлами вживую](#work-with-files-live) +7. [Вывод для скриптов](#output-for-scripts) + +## Сначала профиль + +Профиль это имя, которое вы выбираете для одного аккаунта. Это первое слово каждой команды, которой нужен аккаунт: + +```sh +ydisk personal status +``` + +`YDISK_PROFILE=personal` делает то же самое для одного сеанса оболочки. Профиль никогда не подставляется сам, даже +единственный. Команда без него останавливается с кодом выхода 2 и показывает профили на этом компьютере. + +## Выберите папки + +`folders browse` показывает Диск по одному уровню, вживую, так что папку можно найти по её пути: + +```sh +ydisk personal folders browse +ydisk personal folders browse --folder /Documents +ydisk personal folders add /Documents/Contracts +``` + +Выбранная папка забирает всё, что в ней лежит, вместе с вложенными папками. `folders list` показывает выбранные +папки, а `folders remove` убирает одну из них. Следующая синхронизация удалит её документы из копии. + +Выбирайте несколько папок с документами, а не весь Диск. Яндекс Диск не сообщает инструменту, что изменилось, поэтому +каждая синхронизация заново перечисляет все выбранные папки и их подпапки. Папка с фотографиями добавляет время на +перечисление и не добавляет текста для поиска. + +## Синхронизация + +```sh +ydisk personal sync +ydisk personal status +``` + +`sync` скачивает файлы, которые появились или изменили содержимое с прошлой синхронизации, и читает их текст. Файл, +удалённый с Диска, пропадает из копии. Файл, перенесённый внутри выбранных папок, сохраняет свои теги и заметки. + +Одна синхронизация читает до 200 файлов (`--limit`) и перечисляет до 10 000 элементов, а потом запоминает, где +остановилась. Большая папка обрабатывается за несколько запусков: запускайте `sync` снова, пока `status` не покажет, +что работы не осталось. Остановка ничего не теряет, следующая синхронизация продолжит с того места, где закончила +предыдущая. + +Запускайте `sync`, когда хотите обновить копию, например перед вопросом агенту о свежих файлах. В фоне ничего не +работает. `sync --rescan` читает все выбранные папки с начала. Выполните его один раз и дальше возвращайтесь к обычной +команде `sync`. + +Выбранную папку, которую вы переименовали или перенесли на Диске, инструмент больше не находит, и её документы +уходят из копии. Добавьте её снова под новым путём. + +## Что хранит копия + +| На Диске | В копии | +| --- | --- | +| PDF с текстовым слоем, Word `.docx`, Excel `.xlsx`, CSV, TSV, обычный текст, Markdown | Текст, имя, путь, размер и даты | +| Отсканированный PDF или картинка | Имя, путь и даты. Текста для чтения нет | +| Любой другой файл и любой файл больше 50 МБ | Имя, путь и даты | + +`status` перечисляет каждый файл, сохранённый только по имени, с причиной. Сами файлы остаются на Диске, а копия +хранит их текст. Время хранится и показывается в UTC. + +## Читайте синхронизированный документ + +```sh +ydisk personal documents list +ydisk personal documents show 1a2b3c --json +ydisk personal documents export 1a2b3c --output ./contract.md +``` + +`documents show` выводит весь текст одного документа, который вы находите по id из `search` или `documents list`. Id +выше только пример. `documents export` записывает документ в новый файл Markdown. Теги, заметки и воспоминания +остаются при документе и никогда не попадают на Диск. Смотрите [поиск документа](./search.md). + +## Работа с файлами вживую + +Команды `files` работают с Диском напрямую, синхронизация им не нужна. Пути это пути на Диске, например +`/Documents/plan.pdf`. + +```sh +ydisk personal files list --folder /Documents +ydisk personal files show /Documents/plan.pdf +ydisk personal files download /Documents/plan.pdf --json +ydisk personal files download /Documents/plan.pdf --output ./plan.pdf +ydisk personal files upload ./notes.md --folder /Documents +ydisk personal files copy /Documents/plan.pdf --folder /Archive +ydisk personal files move /Documents/old.pdf --folder /Archive +ydisk personal files create /Projects/2026 +ydisk personal files delete /Documents/old.pdf +ydisk personal files restore trash:/old.pdf +ydisk personal files publish /Documents/plan.pdf +ydisk personal files unpublish /Documents/plan.pdf +``` + +- `files download` без `--output` отвечает текстом файла, до 200 000 символов, так что агент читает файл вне + выбранных папок, не сохраняя его. +- `files delete` переносит файл в корзину Диска, а `files restore` возвращает его по пути в корзине. +- `files publish` создаёт публичную ссылку, которую может открыть любой, у кого она есть. `files unpublish` закрывает + её. +- `--replace` при загрузке, копировании или переносе перезаписывает файл, который уже лежит по этому пути. + +В терминале инструмент спрашивает перед удалением, перезаписью и публичной ссылкой. Через MCP спросить некого, поэтому +задайте эти разрешения для агента. Смотрите [настройки](./configuration.md#permissions). Добавьте `--dry-run` к любому +изменению, чтобы увидеть, что оно сделает, и ничего не менять. + +Каждая операция API Диска Яндекса тоже есть как команда: `ydisk personal api list` перечисляет их, а +`ydisk personal api show resources-list` показывает параметры одной операции, не обращаясь к Яндексу. + +## Вывод для скриптов + +Каждая команда, кроме `mcp serve`, принимает `--json` и печатает одно значение JSON в stdout. Ошибки идут в stderr +тоже как JSON, с полем `code`, по которому можно ветвиться, а у каждого вида сбоя свой код выхода. Их перечисляет +[справочник команд](./commands.md). + +Дальше: [найдите документ](./search.md) или [подключите агента](./mcp.md). From 8abfb941749e47784dfb52fa942d8a348f741b26 Mon Sep 17 00:00:00 2001 From: leemour <leemour@gmail.com> Date: Wed, 18 Nov 2026 14:59:05 +0100 Subject: [PATCH 2/4] docs(ydisk): roadmap lists two-way folder sync and document editing Desktop support for ydisk is already shipped, so it is no longer next. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- lib/ydisk-descriptions.ts | 8 +++++--- translations/pages/ydisk/roadmap.en.md | 4 +++- translations/pages/ydisk/roadmap.es.md | 4 +++- translations/pages/ydisk/roadmap.ru.md | 4 +++- 4 files changed, 14 insertions(+), 6 deletions(-) diff --git a/lib/ydisk-descriptions.ts b/lib/ydisk-descriptions.ts index 57011ccc..7e173b06 100644 --- a/lib/ydisk-descriptions.ts +++ b/lib/ydisk-descriptions.ts @@ -11,7 +11,7 @@ export const ydiskDescriptions: Record<string, Record<string, string>> = { troubleshooting: "Fix a refused Yandex token, a folder that does not sync or a search that finds nothing.", security: "What the Yandex Disk CLI keeps, where the token lives, what it reaches and what a run record hides.", changelog: "Read Yandex Disk CLI release notes, including new capabilities, changes and fixes.", - roadmap: "See what the Yandex Disk CLI does today and what is planned next, such as setup in WireCat Desktop.", + roadmap: "See what the Yandex Disk CLI does today and what is planned next, such as two-way folder sync.", compare: "Compare ydisk with the Yandex Disk MCP server, rclone, Yandex Disk for Linux and yandex-disk-mcp by the job.", }, @@ -27,7 +27,8 @@ export const ydiskDescriptions: Record<string, Record<string, string>> = { troubleshooting: "Исправьте отклонённый токен Яндекса, папку, которая не копируется, или поиск без результатов.", security: "Что хранит CLI для Яндекс Диска, где лежит токен, куда он обращается и что скрывает запись запуска.", changelog: "История изменений CLI для Яндекс Диска: новые возможности, изменения и исправления.", - roadmap: "Что CLI для Яндекс Диска уже умеет и что запланировано дальше, например подключение в WireCat Desktop.", + roadmap: + "Что CLI для Яндекс Диска уже умеет и что запланировано дальше, например двусторонняя синхронизация папок.", compare: "Сравнение ydisk с MCP-сервером Яндекс Диска, rclone, Яндекс Диском для Linux и yandex-disk-mcp по задачам.", }, @@ -46,7 +47,8 @@ export const ydiskDescriptions: Record<string, Record<string, string>> = { security: "Qué guarda la CLI de Yandex Disk, dónde vive el token, a qué se conecta y qué oculta un registro de ejecución.", changelog: "Lee las notas de versión de la CLI de Yandex Disk: novedades, cambios y correcciones.", - roadmap: "Mira qué hace ya la CLI de Yandex Disk y qué está previsto, como conectarla en WireCat Desktop.", + roadmap: + "Mira qué hace ya la CLI de Yandex Disk y qué está previsto, como la sincronización de carpetas en ambos sentidos.", compare: "Compara ydisk con el servidor MCP de Yandex Disk, rclone, Yandex Disk para Linux y yandex-disk-mcp por tarea.", }, diff --git a/translations/pages/ydisk/roadmap.en.md b/translations/pages/ydisk/roadmap.en.md index 3ac99657..4a4022f8 100644 --- a/translations/pages/ydisk/roadmap.en.md +++ b/translations/pages/ydisk/roadmap.en.md @@ -15,6 +15,8 @@ command line or MCP. See [start here](./index.md). ## Next -- Connect Yandex Disk in WireCat Desktop, so you sign in and choose folders without the terminal. +- Two-way sync of a local folder with a Disk folder. Changes you make in either place reach the other. +- Editing and creating documents (`.md`, `.txt`, `.docx` and `.xlsx`). A file goes back to the Disk only if nobody + changed it there in the meantime. What changed in each released version is in the [changelog](./changelog.md). diff --git a/translations/pages/ydisk/roadmap.es.md b/translations/pages/ydisk/roadmap.es.md index 00355350..daddd149 100644 --- a/translations/pages/ydisk/roadmap.es.md +++ b/translations/pages/ydisk/roadmap.es.md @@ -15,6 +15,8 @@ fijes, por la línea de comandos o por MCP. Mira [empieza aquí](./index.md). ## Siguiente -- Conectar Yandex Disk en WireCat Desktop, para iniciar sesión y elegir carpetas sin la terminal. +- Sincronización en ambos sentidos de una carpeta local con una carpeta del Disk: los cambios de un lado llegan al otro. +- Edición y creación de documentos (`.md`, `.txt`, `.docx` y `.xlsx`). Un archivo vuelve al Disk solo si nadie lo + cambió allí mientras tanto. Lo que cambió en cada versión está en el [registro de cambios](./changelog.md). diff --git a/translations/pages/ydisk/roadmap.ru.md b/translations/pages/ydisk/roadmap.ru.md index 0d36ada7..c7d90339 100644 --- a/translations/pages/ydisk/roadmap.ru.md +++ b/translations/pages/ydisk/roadmap.ru.md @@ -15,6 +15,8 @@ title: "Планы развития" ## Дальше -- Подключение Яндекс Диска в WireCat Desktop: вход и выбор папок без терминала. +- Двусторонняя синхронизация локальной папки с папкой на Диске: изменения в любом из двух мест попадают в другое. +- Правка и создание документов (`.md`, `.txt`, `.docx` и `.xlsx`). Файл возвращается на Диск, только если за это время + его там никто не менял. Что изменилось в каждой версии, смотрите в [истории изменений](./changelog.md). From 49fe51a0379e049b9d1ee9fe0d81e1500a69c6ff Mon Sep 17 00:00:00 2001 From: leemour <leemour@gmail.com> Date: Wed, 18 Nov 2026 15:07:12 +0100 Subject: [PATCH 3/4] docs(ydisk): fix titles, Russian grammar and wording, Spanish terms MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - seo-copy: ydisk search and recipes titles, Russian product in the genitive so titles read «CLI Яндекс Диска». - RU: grammar and wording fixes, no ё, colons in definitions. - ES: Disk, not Disco; link texts as noun phrases. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- lib/seo-copy.json | 9 +++++++-- lib/ydisk-descriptions.ts | 2 +- translations/pages/ydisk/roadmap.es.md | 2 +- translations/ydisk/changelog.es.md | 10 +++++----- translations/ydisk/changelog.ru.md | 4 ++-- translations/ydisk/commands.ru.md | 4 ++-- translations/ydisk/configuration.es.md | 4 ++-- translations/ydisk/configuration.ru.md | 5 ++--- translations/ydisk/index.ru.md | 14 +++++++------- translations/ydisk/installation.ru.md | 16 ++++++++-------- translations/ydisk/mcp.es.md | 8 ++++---- translations/ydisk/mcp.ru.md | 2 +- translations/ydisk/recipes.es.md | 10 +++++----- translations/ydisk/recipes.ru.md | 2 +- translations/ydisk/search.es.md | 14 +++++++------- translations/ydisk/search.ru.md | 8 ++++---- translations/ydisk/security.es.md | 4 ++-- translations/ydisk/security.ru.md | 2 +- translations/ydisk/troubleshooting.es.md | 8 ++++---- translations/ydisk/usage.es.md | 4 ++-- translations/ydisk/usage.ru.md | 20 ++++++++++---------- 21 files changed, 78 insertions(+), 74 deletions(-) diff --git a/lib/seo-copy.json b/lib/seo-copy.json index 0d13c8c0..9e8a0b69 100644 --- a/lib/seo-copy.json +++ b/lib/seo-copy.json @@ -100,6 +100,7 @@ "attachments": "Send and download {product} file attachments", "topic-search": "Search {product} conversations by topic", "drive/search": "Search Google Drive documents with your AI agent", + "ydisk/search": "Search Yandex Disk documents with your AI agent", "drive/usage": "Import and organize Google Drive documents", "memo/search": "Search notes, mail and messages with Memo", "memo/archive": "", @@ -203,10 +204,11 @@ "mail": "почты", "b24": "Битрикс24", "amo": "amoCRM", - "ydisk": "Яндекс Диск" + "ydisk": "Яндекс Диска" }, "labels": { - "mail": "Почта" + "mail": "Почта", + "ydisk": "Яндекс Диск" }, "pageTitles": { "installation": "Установка CLI и MCP-сервера {product}", @@ -234,6 +236,8 @@ "attachments": "Отправка и загрузка вложений в {product}", "topic-search": "Поиск по темам переписки в {product}", "drive/search": "Поиск документов Google Drive через ИИ-агента", + "ydisk/search": "Поиск документов Яндекс Диска через ИИ-агента", + "ydisk/recipes": "Рецепты для ИИ-агента с Яндекс Диском", "drive/usage": "Импорт и упорядочивание документов Google Drive", "memo/search": "Поиск по заметкам, почте и сообщениям в Memo", "memo/archive": "", @@ -367,6 +371,7 @@ "attachments": "Envía y descarga archivos adjuntos de {product}", "topic-search": "Busca conversaciones de {product} por tema", "drive/search": "Busca documentos de Google Drive con tu agente de IA", + "ydisk/search": "Busca documentos de Yandex Disk con tu agente de IA", "drive/usage": "Importa y organiza documentos de Google Drive", "memo/search": "Busca en notas, correo y mensajes con Memo", "memo/archive": "", diff --git a/lib/ydisk-descriptions.ts b/lib/ydisk-descriptions.ts index 7e173b06..3635fa79 100644 --- a/lib/ydisk-descriptions.ts +++ b/lib/ydisk-descriptions.ts @@ -24,7 +24,7 @@ export const ydiskDescriptions: Record<string, Record<string, string>> = { mcp: "Подключите агента к CLI для Яндекс Диска через MCP, посмотрите, что ему доступно, и оставьте запись за собой.", commands: "Все команды, параметры и коды выхода CLI для Яндекс Диска в сгенерированном справочнике.", configuration: "Настройки CLI для Яндекс Диска: профили, папки, переменные и порядок, в котором они действуют.", - troubleshooting: "Исправьте отклонённый токен Яндекса, папку, которая не копируется, или поиск без результатов.", + troubleshooting: "Исправьте отклоненный токен Яндекса, папку, которая не копируется, или поиск без результатов.", security: "Что хранит CLI для Яндекс Диска, где лежит токен, куда он обращается и что скрывает запись запуска.", changelog: "История изменений CLI для Яндекс Диска: новые возможности, изменения и исправления.", roadmap: diff --git a/translations/pages/ydisk/roadmap.es.md b/translations/pages/ydisk/roadmap.es.md index daddd149..0a165ba6 100644 --- a/translations/pages/ydisk/roadmap.es.md +++ b/translations/pages/ydisk/roadmap.es.md @@ -11,7 +11,7 @@ función que falta: puede que ya esté en camino. El orden puede cambiar y no ha `ydisk` inicia sesión en tu Yandex Disk con un token de Yandex que creas una sola vez. Copia a tu ordenador el texto de las carpetas que elijas, y tú y tu agente lo buscáis por palabras, por significado y por nombre de archivo, incluso sin internet. La misma herramienta lista, descarga, sube, mueve y comparte archivos del Disk dentro de los permisos que -fijes, por la línea de comandos o por MCP. Mira [empieza aquí](./index.md). +fijes, por la línea de comandos o por MCP. Mira la [introducción](./index.md). ## Siguiente diff --git a/translations/ydisk/changelog.es.md b/translations/ydisk/changelog.es.md index 09c60b41..ba4fd7b5 100644 --- a/translations/ydisk/changelog.es.md +++ b/translations/ydisk/changelog.es.md @@ -21,8 +21,8 @@ Cambios notables en `@wirecat/yandex-disk-cli`. Una sección por versión, las m - Publicado desde GitHub Actions con la procedencia de npm (provenance), así que WireCat Desktop lo instala: Desktop se niega a instalar una versión de una herramienta integrada que no compiló el workflow de su propio repositorio, y la 0.1.0 se publicó desde un ordenador. -- **Las guías cubren lo que hace la herramienta, paso a paso.** Páginas nuevas: [encuentra un documento](./search.md) - (palabras, formas de las palabras, significado, nombres de archivo), [conecta a tu agente](./mcp.md) (el skill, +- **Las guías cubren lo que hace la herramienta, paso a paso.** Páginas nuevas: [búsqueda de documentos](./search.md) + (palabras, formas de las palabras, significado, nombres de archivo), [conexión del agente](./mcp.md) (el skill, `mcp add`, `mcp config`, aplicaciones del navegador y qué puede cambiar un agente), [recetas](./recipes.md) y [comparación con otras herramientas](./compare.md). [Instala e inicia sesión](./installation.md) explica cómo conseguir el token de Yandex con los nombres que usa el propio Yandex, [la solución de problemas](./troubleshooting.md) @@ -40,13 +40,13 @@ Cambios notables en `@wirecat/yandex-disk-cli`. Una sección por versión, las m - **Inicio de sesión con un token OAuth de Yandex** pegado una sola vez: `session start` lo lee oculto o desde stdin, lo comprueba con `GET /v1/disk` y lo guarda en el llavero del sistema. `session status --check` y `doctor --online` dicen de quién es. -- **Carpetas elegidas del Disco como texto en el que buscar**: `folders add <path>`, `sync`, `status`, +- **Carpetas elegidas del Disk como texto en el que buscar**: `folders add <path>`, `sync`, `status`, `documents list|show|export`, `search`, `catalog`, etiquetas, notas y recuerdos, los comandos compartidos de - documentos de cli-core. Cada sincronización recorre de nuevo las carpetas elegidas (la API del Disco no tiene un + documentos de cli-core. Cada sincronización recorre de nuevo las carpetas elegidas (la API del Disk no tiene un registro de cambios) y lee solo los archivos cuyo MD5 cambió. Un archivo movido conserva su id, sus etiquetas y sus notas. El texto sale de PDF, docx, xlsx, CSV, TSV, texto y Markdown. Las horas se guardan y se responden en UTC. - **Los archivos en vivo**: `files list|show|download|upload|copy|move|create|delete|restore|publish|unpublish`, por - ruta del Disco. `files delete` envía a la papelera. `--replace` y `files delete` preguntan como lo hace + ruta del Disk. `files delete` envía a la papelera. `--replace` y `files delete` preguntan como lo hace `files.delete`, `files publish` como lo hace `files.share`, y `--dry-run` muestra cada clave que comprueba la escritura. `files publish` responde con el enlace público, o deja fuera `public_url` cuando no puede leerlo de vuelta. Las descargas y las subidas van a la dirección que da Yandex, sin el token. diff --git a/translations/ydisk/changelog.ru.md b/translations/ydisk/changelog.ru.md index 6b136c2e..6b6e7e08 100644 --- a/translations/ydisk/changelog.ru.md +++ b/translations/ydisk/changelog.ru.md @@ -27,7 +27,7 @@ title: "История изменений" инструментами](./compare.md). [Установка и вход](./installation.md) проводит через получение токена Яндекса с названиями из самого Яндекса, [решение проблем](./troubleshooting.md) устроено по симптомам и с кодами выхода, а [безопасность](./security.md) говорит, что остается на вашем компьютере и как это удалить. В шагах с токеном теперь - назван тип приложения "For API access or debugging", как на страницах Яндекса. + назван тип приложения «Для доступа к API или отладки», как на страницах Яндекса. - Справка и ошибка `--cursor` в `folders browse` и `files list` называют `page.next_cursor`, ключ, который есть в ответе, а не `page.next`. @@ -35,7 +35,7 @@ title: "История изменений" ### Добавлено -- Начало от `@wirecat/cli-template` 0.25.0. +- За основу взят `@wirecat/cli-template` 0.25.0. - **Вход с токеном OAuth Яндекса**, который вставляется один раз: `session start` читает его скрыто или из stdin, проверяет через `GET /v1/disk` и хранит в связке ключей системы. `session status --check` и `doctor --online` говорят, чей это токен. diff --git a/translations/ydisk/commands.ru.md b/translations/ydisk/commands.ru.md index a5fe9d41..111e42e7 100644 --- a/translations/ydisk/commands.ru.md +++ b/translations/ydisk/commands.ru.md @@ -1472,7 +1472,7 @@ ydisk api resources-upload-url [options] | Option | What it does | |---|---| -| `--path <value>` | Путь, куда будет помещён ресурс. | +| `--path <value>` | Путь, куда будет помещен ресурс. | | `--url <value>` | URL внешнего ресурса, который следует загрузить. | | `--disable-redirects <value>` | Запретить делать редиректы. | | `--fields <value>` | Список возвращаемых атрибутов. | @@ -1535,7 +1535,7 @@ ydisk api public-resources-save-to-disk [options] | `--public-key <value>` | Ключ или публичный URL ресурса. | | `--fields <value>` | Список возвращаемых атрибутов. | | `--force-async <value>` | Выполнить асинхронно. | -| `--name <value>` | Имя, под которым ресурс будет сохранён в папке. | +| `--name <value>` | Имя, под которым ресурс будет сохранен в папке. | | `--path <value>` | Путь к копируемому ресурсу в публичной папке. | | `--save-path <value>` | Путь к папке, в которую будет сохранен ресурс. По умолчанию «Загрузки». | diff --git a/translations/ydisk/configuration.es.md b/translations/ydisk/configuration.es.md index 28f88909..7821e515 100644 --- a/translations/ydisk/configuration.es.md +++ b/translations/ydisk/configuration.es.md @@ -2,7 +2,7 @@ title: "Ajustes" --- -Cambia cómo se comporta `ydisk` para un perfil o para todos: qué puede cambiar un agente en tu Disco, cuánto tiempo se +Cambia cómo se comporta `ydisk` para un perfil o para todos: qué puede cambiar un agente en tu Disk, cuánto tiempo se guardan los registros de ejecución y cómo ordena la búsqueda sus resultados. Los ajustes están en un solo archivo, `config.json`, en la carpeta que muestra `ydisk doctor`. Cada perfil tiene su propia parte, y `defaults` valen para todos los perfiles. @@ -47,7 +47,7 @@ comprueba y su nivel, sin hacer el cambio. `YDISK_READ_ONLY=1` rechaza cualquier cambio, digan lo que digan los permisos. Solo para un servidor MCP, `--permission -files.delete=deny` hace una clave más estricta. Mira [conecta tu agente](./mcp.md#decide-what-the-agent-may-change). +files.delete=deny` hace una clave más estricta. Mira [la conexión del agente](./mcp.md#decide-what-the-agent-may-change). ## Registros de ejecución diff --git a/translations/ydisk/configuration.ru.md b/translations/ydisk/configuration.ru.md index 86d1d43f..9b49f9fb 100644 --- a/translations/ydisk/configuration.ru.md +++ b/translations/ydisk/configuration.ru.md @@ -45,9 +45,8 @@ ydisk personal config set permissions.files.upload deny `deny` останавливает и `api resources-move`. `--dry-run` у любого изменения показывает каждый проверяемый ключ и его уровень, но само изменение не делает. -`YDISK_READ_ONLY=1` отклоняет любое изменение, что бы ни говорили разрешения. Только для одного MCP-сервера -`--permission -files.delete=deny` делает ключ строже. См. [подключите агента](./mcp.md#decide-what-the-agent-may-change). +`YDISK_READ_ONLY=1` отклоняет любое изменение, что бы ни говорили разрешения. Для одного MCP-сервера `--permission +files.delete=deny` делает ключ строже, но не мягче. См. [подключение агента](./mcp.md#decide-what-the-agent-may-change). ## Записи запусков diff --git a/translations/ydisk/index.ru.md b/translations/ydisk/index.ru.md index 57800c0d..c357e1ab 100644 --- a/translations/ydisk/index.ru.md +++ b/translations/ydisk/index.ru.md @@ -2,16 +2,16 @@ title: "ydisk" --- -Находите любой документ на Яндекс Диске по тому, что в нём написано, и поручите ИИ-агенту читать, раскладывать и +Находите любой документ на Яндекс Диске по тому, что в нем написано, и поручите ИИ-агенту читать, раскладывать и отправлять файлы за вас. `ydisk` копирует на ваш компьютер текст выбранных папок Диска, поэтому поиск по словам «lease» или «договор аренды» -найдёт PDF, даже если файл называется `scan_0042.pdf`, и даже без интернета. Когда нужен сам Диск, тот же инструмент -показывает, скачивает, загружает, переносит и раздаёт файлы там. +найдет PDF, даже если файл называется `scan_0042.pdf`, и даже без интернета. Когда нужен сам Диск, тот же инструмент +показывает, скачивает, загружает, переносит и раздает файлы там. -ИИ-агент с `ydisk` отвечает на вопрос «где договор с типографией и какие в нём условия оплаты?» цитатой и путём к +ИИ-агент с `ydisk` отвечает на вопрос «где договор с типографией и какие в нем условия оплаты?» цитатой и путем к файлу на Диске. Он работает с Claude Code, Codex, Gemini CLI и другими агентами, которые запускают команды, с Claude Desktop и Cursor через MCP, а с ChatGPT и Claude в браузере через ваш собственный туннель. -Нужны Node.js и токен OAuth Яндекса: ключ, который даёт инструменту доступ к вашему Диску. Получить токен можно минут +Нужны Node.js и токен OAuth Яндекса: ключ, который дает инструменту доступ к вашему Диску. Получить токен можно минут за пять, один раз. **На этой странице:** @@ -34,13 +34,13 @@ Desktop и Cursor через MCP, а с ChatGPT и Claude в браузере ч - **Агенту можно доверить.** В терминале инструмент спрашивает перед удалением, перезаписью и созданием публичной ссылки. Для агента каждый такой вопрос можно отключить или разрешить только чтение. - **Один поиск по всем источникам.** Копия лежит в том же локальном хранилище, что и ваши Telegram, WhatsApp, почта, - заметки и встречи из других инструментов WireCat, поэтому один поиск покрывает всё. + заметки и встречи из других инструментов WireCat, поэтому один поиск покрывает все. - **Бесплатно и с открытым кодом.** Apache 2.0, macOS, Linux и Windows. Аккаунт WireCat и сервер WireCat не нужны: инструмент обращается к официальному API Яндекса прямо с вашего компьютера. ## Как это устроено -- **Профиль для каждого аккаунта.** Профиль это имя, которое вы выбираете для одного аккаунта Яндекса, например +- **Профиль для каждого аккаунта.** Профиль: имя, которое вы выбираете для одного аккаунта Яндекса, например `personal` или `work`. Каждая команда, которой нужен аккаунт, начинается с него: `ydisk personal search budget`. - **Копия текста, а не файлов.** `sync` читает выбранные вами папки и хранит их текст в локальном хранилище, это один файл базы данных на вашем компьютере. Сами файлы остаются на Диске. Фото и другие файлы без текста сохраняются diff --git a/translations/ydisk/installation.ru.md b/translations/ydisk/installation.ru.md index 8cd1d48c..e2aec2ea 100644 --- a/translations/ydisk/installation.ru.md +++ b/translations/ydisk/installation.ru.md @@ -2,9 +2,9 @@ title: "Установка и вход" --- -Настройте `ydisk` один раз на каждом компьютере, где работаете вы или ваш агент. После этих шагов ваш Диск подключён -под именем профиля, которое вы выбрали, и первый поиск работает. Вход это вставка токена OAuth Яндекса: ключа, который -Яндекс выдаёт для вашего собственного аккаунта и который даёт инструменту доступ к Диску. Получить его можно минут за +Настройте `ydisk` один раз на каждом компьютере, где работаете вы или ваш агент. После этих шагов ваш Диск подключен +под именем профиля, которое вы выбрали, и первый поиск работает. Вход: вставка токена OAuth Яндекса: ключа, который +Яндекс выдает для вашего собственного аккаунта и который дает инструменту доступ к Диску. Получить его можно минут за пять, один раз. **На этой странице:** @@ -12,7 +12,7 @@ title: "Установка и вход" 1. [Установите инструмент](#install-the-tool) 2. [Получите токен Яндекса](#get-a-yandex-token) 3. [Войдите](#sign-in) -4. [Проверьте, что всё работает](#check-that-it-works) +4. [Проверьте, что все работает](#check-that-it-works) 5. [Компьютер без связки ключей](#a-computer-with-no-keyring) 6. [Обновление](#update) 7. [Удаление](#remove) @@ -34,7 +34,7 @@ ydisk doctor ## Получите токен Яндекса -Токен Яндекс выдаёт приложению, которое вы регистрируете для себя. Приложение здесь только название и список прав в +Токен Яндекс выдает приложению, которое вы регистрируете для себя. Приложение здесь только название и список прав в вашем аккаунте Яндекса. Ничего не публикуется. Шаги повторяют собственные инструкции Яндекса: [регистрация приложения для доступа к API](https://yandex.ru/dev/id/doc/en/register-api) и [быстрый старт API Диска](https://yandex.ru/dev/disk-api/doc/en/concepts/quickstart). Страницы Яндекса на русском, @@ -53,7 +53,7 @@ ydisk doctor удаления и публичных ссылок. Для токена только на чтение не добавляйте его. Тогда любое изменение завершится ошибкой. 4. Создайте приложение («Создать приложение»). На его странице будет **ClientID**, строка из букв и цифр. Скопируйте - её. + ее. 5. Откройте в браузере этот адрес, дописав ClientID в самый конец, после `client_id=`: `https://oauth.yandex.ru/authorize?response_type=token&client_id=` 6. Яндекс спросит, разрешить ли приложению доступ к вашему Диску. Разрешите, и Яндекс покажет токен на странице. @@ -75,13 +75,13 @@ ydisk personal session start ``` Сначала инструмент проверяет токен у Яндекса и сохраняет его, только если Яндекс его принял. Токен лежит в системной -связке ключей (Keychain в macOS, Credential Manager в Windows, Secret Service в Linux). Токен никогда не передаётся +связке ключей (Keychain в macOS, Credential Manager в Windows, Secret Service в Linux). Токен никогда не передается аргументом команды и не попадает ни в вывод, ни в журнал. `session start` читает токен и из stdin, так что скрипт может передать его из менеджера паролей. У второго аккаунта будет свой профиль: `ydisk work session start`. -## Проверьте, что всё работает +## Проверьте, что все работает ```sh ydisk personal session status --check diff --git a/translations/ydisk/mcp.es.md b/translations/ydisk/mcp.es.md index fa108140..827938b0 100644 --- a/translations/ydisk/mcp.es.md +++ b/translations/ydisk/mcp.es.md @@ -45,8 +45,8 @@ ydisk personal mcp add claude-code --allow-writes ydisk personal mcp add codex --allow-writes ``` -`--allow-writes` confirma que sabes que el servidor ofrece los comandos que cambian el Disco. Los permisos del perfil -siguen decidiendo qué se ejecuta. Mira [Decide qué puede cambiar el agente](#decide-what-the-agent-may-change). +`--allow-writes` confirma que sabes que el servidor ofrece los comandos que cambian el Disk. Los permisos del perfil +siguen decidiendo qué se ejecuta. Mira [qué puede cambiar el agente](#decide-what-the-agent-may-change). ## Claude Desktop, Cursor y otras aplicaciones MCP @@ -82,7 +82,7 @@ navegador inicia sesión con un código de un solo uso que imprimen `server star ## Decide qué puede cambiar el agente -El servidor MCP ofrece todos los comandos, también los que cambian el Disco. En un terminal la herramienta pregunta +El servidor MCP ofrece todos los comandos, también los que cambian el Disk. En un terminal la herramienta pregunta antes de borrar, sobrescribir o crear un enlace público, pero por MCP no hay nadie a quien preguntar, así que se ejecutan. Elige una de estas opciones para un agente: @@ -100,6 +100,6 @@ ejecutan. Elige una de estas opciones para un agente: Por MCP un agente lee el texto de un archivo con `files download`, pero no puede guardar un archivo en una ruta de tu ordenador. Todas las claves de permisos están en los [ajustes](./configuration.md#permissions), y lo que llega a tu -disco y a la red está en [seguridad](./security.md). +Disk y a la red está en [seguridad](./security.md). Siguiente: [peticiones para probar](./recipes.md). diff --git a/translations/ydisk/mcp.ru.md b/translations/ydisk/mcp.ru.md index e7f88a1f..b64cf45a 100644 --- a/translations/ydisk/mcp.ru.md +++ b/translations/ydisk/mcp.ru.md @@ -98,7 +98,7 @@ MCP-сервер предлагает все команды, в том числ `ydisk personal mcp add claude-code --allow-writes --permission files.delete=deny`. Через MCP агент читает текст файла командой `files download`, но не может сохранить файл по пути на вашем компьютере. -Все ключи разрешений перечислены в [настройках](./configuration.md#permissions), а что доходит до вашего диска и сети, +Все ключи разрешений перечислены в [настройках](./configuration.md#permissions), а что доходит до вашего Диска и сети, описано в разделе [безопасность](./security.md). Дальше: [запросы, которые стоит попробовать](./recipes.md). diff --git a/translations/ydisk/recipes.es.md b/translations/ydisk/recipes.es.md index 32c50505..397a7797 100644 --- a/translations/ydisk/recipes.es.md +++ b/translations/ydisk/recipes.es.md @@ -12,7 +12,7 @@ ejecuta. Dan por hecho que ya has [iniciado sesión](./installation.md), elegido 2. [Responde a partir de un archivo fuera de las carpetas elegidas](#answer-from-a-file-outside-the-chosen-folders) 3. [Ordena las facturas del año pasado en un archivo](#tidy-last-years-invoices-into-an-archive) 4. [Comparte un archivo y cierra el enlace después](#share-a-file-and-close-the-link-later) -5. [Pon en el Disco un informe que escribió el agente](#put-a-report-the-agent-wrote-on-the-disk) +5. [Pon en el Disk un informe que escribió el agente](#put-a-report-the-agent-wrote-on-the-disk) 6. [Deshaz un borrado](#undo-a-delete) 7. [Mantén la copia al día cada mañana](#keep-the-copy-current-every-morning) @@ -72,9 +72,9 @@ ydisk personal files unpublish /Documents/Flat/lease-2026.pdf ``` Cualquiera que tenga un enlace público puede abrir el archivo. En un terminal la herramienta pregunta antes. Por MCP -sigue el permiso `files.share`, mira [conecta tu agente](./mcp.md#decide-what-the-agent-may-change). +sigue el permiso `files.share`, mira [conexión del agente](./mcp.md#decide-what-the-agent-may-change). -## Pon en el Disco un informe que escribió el agente +## Pon en el Disk un informe que escribió el agente ```text prompt Use ydisk CLI with profile personal. Save the summary you just wrote as summary.md in /Reports on my Disk. @@ -85,7 +85,7 @@ ydisk personal files upload ./summary.md --folder /Reports ``` Una subida rechaza los archivos de credenciales, los perfiles de navegador y las carpetas de WireCat, así que un -agente no puede enviarlos al Disco por error. +agente no puede enviarlos al Disk por error. ## Deshaz un borrado @@ -98,7 +98,7 @@ ydisk personal api trash-resources-list --json ydisk personal files restore trash:/old.pdf ``` -`files delete` mueve un archivo a la papelera del Disco, así que puede volver hasta que se vacíe la papelera. +`files delete` mueve un archivo a la papelera del Disk, así que puede volver hasta que se vacíe la papelera. ## Mantén la copia al día cada mañana diff --git a/translations/ydisk/recipes.ru.md b/translations/ydisk/recipes.ru.md index 20a7b6ac..13c74b28 100644 --- a/translations/ydisk/recipes.ru.md +++ b/translations/ydisk/recipes.ru.md @@ -72,7 +72,7 @@ ydisk personal files unpublish /Documents/Flat/lease-2026.pdf ``` Файл откроет любой, у кого есть публичная ссылка. В терминале инструмент сначала спрашивает. Через MCP он учитывает -разрешение `files.share`, см. [подключите агента](./mcp.md#decide-what-the-agent-may-change). +разрешение `files.share`, см. [подключение агента](./mcp.md#decide-what-the-agent-may-change). ## Положите на Диск отчет, который написал агент diff --git a/translations/ydisk/search.es.md b/translations/ydisk/search.es.md index 5a4b1c42..343d54de 100644 --- a/translations/ydisk/search.es.md +++ b/translations/ydisk/search.es.md @@ -2,7 +2,7 @@ title: "Encuentra un documento" --- -Encuentra un contrato, una cifra o una decisión en tus carpetas del Disco por lo que dice el documento, aunque no +Encuentra un contrato, una cifra o una decisión en tus carpetas del Disk por lo que dice el documento, aunque no recuerdes su nombre. La búsqueda lee la copia de tu ordenador, así que responde sin internet y no cuesta ninguna petición a Yandex. Cubre las carpetas que elegiste y sincronizaste. Mira [carpetas y sincronización](./usage.md). @@ -30,10 +30,10 @@ ydisk personal search "invoice 2026" --exact La búsqueda encuentra otras formas de una palabra: "договор" también encuentra "договора" y "договоре", y "budgets" encuentra "budget". `--exact` busca las palabras tal como están escritas. Cada resultado trae el id del documento, -su ruta en el Disco y un fragmento. Pasa el id a `documents show` para ver el texto completo. +su ruta en el Disk y un fragmento. Pasa el id a `documents show` para ver el texto completo. Un campo acota los resultados: `tag:` encuentra los documentos con una etiqueta tuya, y `date:` busca por la fecha -del último cambio en el Disco. +del último cambio en el Disk. ```sh ydisk personal search "budget tag:follow-up" @@ -69,11 +69,11 @@ ydisk personal catalog tree ``` Un archivo fuera de las carpetas elegidas se encuentra en directo: `files list --folder /Documents` lista una carpeta -del Disco. +del Disk. ## Etiquetas y notas -Las etiquetas y las notas son tuyas y se quedan en tu ordenador. El Disco nunca las ve. Se quedan con el documento +Las etiquetas y las notas son tuyas y se quedan en tu ordenador. El Disk nunca las ve. Se quedan con el documento cuando el archivo se mueve. ```sh @@ -88,12 +88,12 @@ documento con sus etiquetas, notas y recuerdos. ## En tus otras fuentes La copia vive en el almacén local que comparten las otras herramientas de WireCat. Con -[Memo](https://wirecat.dev/en/docs/memo), una sola búsqueda encuentra un documento del Disco junto al chat de +[Memo](https://wirecat.dev/en/docs/memo), una sola búsqueda encuentra un documento del Disk junto al chat de Telegram o al correo donde se habló de él. ## Cuando la búsqueda no encuentra nada -Un resultado vacío significa que nada coincidió en la copia, no que el Disco no tenga ese archivo. Comprueba, por +Un resultado vacío significa que nada coincidió en la copia, no que el Disk no tenga ese archivo. Comprueba, por este orden: 1. `ydisk personal folders list`: ¿está elegida la carpeta del archivo? diff --git a/translations/ydisk/search.ru.md b/translations/ydisk/search.ru.md index 1b5e559a..636753b9 100644 --- a/translations/ydisk/search.ru.md +++ b/translations/ydisk/search.ru.md @@ -32,7 +32,7 @@ ydisk personal search "invoice 2026" --exact `--exact` ищет слова ровно так, как они написаны. У каждого результата есть id документа, его путь на Диске и отрывок. Передайте id в `documents show`, чтобы увидеть весь текст. -Поле сужает результаты: `tag:` находит документы с вашим тегом, а `date:` ищет по дате последнего изменения на +Фильтр сужает результаты: `tag:` находит документы с вашим тегом, а `date:` ищет по дате последнего изменения на Диске. ```sh @@ -44,8 +44,8 @@ ydisk personal search "budget date>=30d" Поиск по смыслу находит документ, который отвечает на вопрос другими словами. Например, на вопрос «о чем мы договорились по расходам?» он найдет текст «бюджет утвержден на 2 миллиона». Для этого он использует текстовую модель -на вашем компьютере, общую для всех инструментов WireCat. Скачайте модель один раз через инструмент WireCat с -командой `models`, например [Memo](https://wirecat.dev/en/docs/memo), а затем проиндексируйте копию: +на вашем компьютере, общую для всех инструментов WireCat. Скачайте модель один раз командой `models` любого +инструмента WireCat, например [Memo](https://wirecat.dev/en/docs/memo), а затем проиндексируйте копию: ```sh memo models download embeddinggemma @@ -68,7 +68,7 @@ ydisk personal catalog search "passport" ydisk personal catalog tree ``` -Файл вне выбранных папок находится напрямую на Диске: `files list --folder /Documents` показывает содержимое папки +Файл вне выбранных папок ищите прямо на Диске: `files list --folder /Documents` показывает содержимое папки на Диске. ## Теги и заметки diff --git a/translations/ydisk/security.es.md b/translations/ydisk/security.es.md index 4a79cc6f..fb3fe76b 100644 --- a/translations/ydisk/security.es.md +++ b/translations/ydisk/security.es.md @@ -23,7 +23,7 @@ WireCat, como el llavero, los permisos, MCP y lo que nunca llega a un registro, | Tus etiquetas, notas y recuerdos sobre documentos | El almacén local | `tags remove`, `notes remove` | | Ajustes y registros de ejecución | Las carpetas que muestra `ydisk doctor` | `ydisk runs list` los muestra. Caducan tras los días indicados en los [ajustes](./configuration.md#run-records) | -Los archivos en sí se quedan en el Disco. Solo se guarda una copia de un archivo cuando ejecutas +Los archivos en sí se quedan en el Disk. Solo se guarda una copia de un archivo cuando ejecutas `files download --output`. La sincronización no guarda los enlaces públicos (`public_url`). Nada va a WireCat: no hay servidor de WireCat ni una cuenta con nosotros. @@ -47,7 +47,7 @@ solo del propietario. `files upload` rechaza los archivos de credenciales, los p WireCat salvo que el propietario añada `--allow-any-file`. `files delete`, `--replace` y los comandos de enlaces públicos preguntan primero en una terminal. Por MCP solo los detiene `deny`, así que define `files.delete=deny` y `files.share=deny` para un agente que no deba hacerlo, y `files.upload=deny` para uno que no deba poner ningún archivo -local en el Disco. +local en el Disk. `ydisk personal mcp serve --http` escucha solo en `127.0.0.1`, para aplicaciones del navegador que llegan a él por tu propio túnel. Cada aplicación inicia sesión con un código de un solo uso, y el servidor guarda un hash de cada inicio diff --git a/translations/ydisk/security.ru.md b/translations/ydisk/security.ru.md index e0b84fbb..b20e7f22 100644 --- a/translations/ydisk/security.ru.md +++ b/translations/ydisk/security.ru.md @@ -74,5 +74,5 @@ WireCat, то есть связка ключей, разрешения, MCP и `config.json` сохраняется читаемым только вами (`0600`), а его папка создается только для вас (`0700`). Файл или папка, созданные старой версией, могут быть открыты другим пользователям компьютера: `ydisk doctor` перечисляет -каждый такой в `files.problems` и печатает `chmod`, который это исправляет. Windows не проверяется. О уязвимости +каждый такой в `files.problems` и печатает `chmod`, который это исправляет. Windows не проверяется. Об уязвимости сообщите так, как описано в [SECURITY.md](https://github.com/WireCatLabs/ydisk-cli/blob/main/SECURITY.md). diff --git a/translations/ydisk/troubleshooting.es.md b/translations/ydisk/troubleshooting.es.md index e6748760..b7660aa5 100644 --- a/translations/ydisk/troubleshooting.es.md +++ b/translations/ydisk/troubleshooting.es.md @@ -32,16 +32,16 @@ ydisk personal doctor --online | "refused the token", código de salida 4 | El token es incorrecto, se revocó o caducó. [Consigue un token nuevo](./installation.md#get-a-yandex-token) y vuelve a ejecutar `ydisk personal session start`. | | Un cambio falla con el código de salida 5 | El token no tiene el permiso `cloud_api:disk.write`, o lo rechazan los permisos del perfil o `YDISK_READ_ONLY`. Revisa los [ajustes](./configuration.md#permissions). Para el permiso, registra la aplicación de nuevo con él y consigue un token nuevo. | | "the OS keyring did not answer" en Linux | El bus de sesión se reinició. Cierra la sesión y vuelve a entrar, o inicia sesión con `session start --credential-storage file`. | -| "no such item, or this token cannot see it", código de salida 6 | Comprueba la ruta con `files list --folder` en su carpeta superior. Una ruta del Disco empieza por `/`, como en `/Documents/plan.pdf`. | +| "no such item, or this token cannot see it", código de salida 6 | Comprueba la ruta con `files list --folder` en su carpeta superior. Una ruta del Disk empieza por `/`, como en `/Documents/plan.pdf`. | | "asked to slow down", código de salida 8 | Yandex recibió demasiadas peticiones de esta cuenta. Espera un minuto y vuelve a ejecutar el comando. | | Una sincronización se detiene antes del final | Una sincronización lee hasta 200 archivos. Ejecuta `sync` otra vez hasta que `status` no muestre trabajo pendiente. | -| Faltan los documentos de una carpeta elegida | La carpeta se renombró o se movió en el Disco. Añádela de nuevo con su ruta nueva con `folders add`. | +| Faltan los documentos de una carpeta elegida | La carpeta se renombró o se movió en el Disk. Añádela de nuevo con su ruta nueva con `folders add`. | | La búsqueda no encuentra un archivo que sabes que está | Mira [cuando la búsqueda no encuentra nada](./search.md#when-search-finds-nothing). | | Un PDF se encuentra por el nombre pero no por su texto | Es un escaneo sin capa de texto, o pesa más de 50 MB. `status` lista esos archivos con el motivo. | -| Una subida falla porque el Disco está lleno | Libera espacio en el Disco o vacía su papelera. Reintentar no sirve hasta que haya sitio. | +| Una subida falla porque el Disk está lleno | Libera espacio en el Disk o vacía su papelera. Reintentar no sirve hasta que haya sitio. | | Se rechaza una subida grande | Yandex limita el tamaño de un archivo según el plan: 1 GB sin un plan de Yandex 360, más con uno ([límites de Yandex](https://yandex.ru/support/yandex-360/customers/disk/web/ru/uploading)). | | Un cambio terminó con "outcome_unknown", código de salida 14 | Yandex falló durante el cambio, así que puede que se hiciera o puede que no. Comprueba con `files show` antes de volver a ejecutarlo. | -| Un agente cambió un archivo que no querías que cambiara | Por MCP el nivel ask deja que un comando se ejecute. Deniega `files.delete` y `files.share`, o define `YDISK_READ_ONLY=1`. Mira [conecta a tu agente](./mcp.md#decide-what-the-agent-may-change). Un archivo borrado está en la papelera del Disco: `files restore`. | +| Un agente cambió un archivo que no querías que cambiara | Por MCP el nivel ask deja que un comando se ejecute. Deniega `files.delete` y `files.share`, o define `YDISK_READ_ONLY=1`. Mira [la conexión del agente](./mcp.md#decide-what-the-agent-may-change). Un archivo borrado está en la papelera del Disk: `files restore`. | | El archivo de ajustes no se lee | `doctor` lista cada problema del archivo en `config.issues`. Ejecuta el `config unset` que da cada uno, `config repair`, o corrige el archivo a mano. | | `doctor` lista `files.problems` | Otros usuarios del ordenador pueden leer `config.json` o entrar en su carpeta. Ejecuta cada `chmod` que `doctor` imprime después de "to make it private:". | diff --git a/translations/ydisk/usage.es.md b/translations/ydisk/usage.es.md index 183f1087..b2e06986 100644 --- a/translations/ydisk/usage.es.md +++ b/translations/ydisk/usage.es.md @@ -86,7 +86,7 @@ ydisk personal documents export 1a2b3c --output ./contract.md `documents show` imprime el texto completo de un documento, que encuentras por su id en `search` o `documents list`. El id de arriba es un ejemplo. `documents export` lo escribe en un archivo Markdown nuevo. Las etiquetas, las notas y los -recuerdos se quedan con el documento y nunca llegan al Disk. Consulta [encuentra un documento](./search.md). +recuerdos se quedan con el documento y nunca llegan al Disk. Consulta [búsqueda de documentos](./search.md). ## Trabaja con archivos en vivo @@ -127,4 +127,4 @@ Todos los comandos salvo `mcp serve` aceptan `--json` e imprimen un único valor JSON por stderr, con un `code` para ramificar, y cada tipo de fallo tiene su propio código de salida. La [referencia de comandos](./commands.md) los lista. -Siguiente: [encuentra un documento](./search.md) o [conecta tu agente](./mcp.md). +Siguiente: [búsqueda de documentos](./search.md) o [conexión del agente](./mcp.md). diff --git a/translations/ydisk/usage.ru.md b/translations/ydisk/usage.ru.md index 2f680f32..bca21e8e 100644 --- a/translations/ydisk/usage.ru.md +++ b/translations/ydisk/usage.ru.md @@ -18,7 +18,7 @@ title: "Папки и синхронизация" ## Сначала профиль -Профиль это имя, которое вы выбираете для одного аккаунта. Это первое слово каждой команды, которой нужен аккаунт: +Профиль: имя, которое вы выбираете для одного аккаунта. Это первое слово каждой команды, которой нужен аккаунт: ```sh ydisk personal status @@ -29,7 +29,7 @@ ydisk personal status ## Выберите папки -`folders browse` показывает Диск по одному уровню, вживую, так что папку можно найти по её пути: +`folders browse` показывает Диск по одному уровню, вживую, так что папку можно найти по ее пути: ```sh ydisk personal folders browse @@ -37,8 +37,8 @@ ydisk personal folders browse --folder /Documents ydisk personal folders add /Documents/Contracts ``` -Выбранная папка забирает всё, что в ней лежит, вместе с вложенными папками. `folders list` показывает выбранные -папки, а `folders remove` убирает одну из них. Следующая синхронизация удалит её документы из копии. +Выбранная папка забирает все, что в ней лежит, вместе с вложенными папками. `folders list` показывает выбранные +папки, а `folders remove` убирает одну из них. Следующая синхронизация удалит ее документы из копии. Выбирайте несколько папок с документами, а не весь Диск. Яндекс Диск не сообщает инструменту, что изменилось, поэтому каждая синхронизация заново перечисляет все выбранные папки и их подпапки. Папка с фотографиями добавляет время на @@ -52,7 +52,7 @@ ydisk personal status ``` `sync` скачивает файлы, которые появились или изменили содержимое с прошлой синхронизации, и читает их текст. Файл, -удалённый с Диска, пропадает из копии. Файл, перенесённый внутри выбранных папок, сохраняет свои теги и заметки. +удаленный с Диска, пропадает из копии. Файл, перенесенный внутри выбранных папок, сохраняет свои теги и заметки. Одна синхронизация читает до 200 файлов (`--limit`) и перечисляет до 10 000 элементов, а потом запоминает, где остановилась. Большая папка обрабатывается за несколько запусков: запускайте `sync` снова, пока `status` не покажет, @@ -63,8 +63,8 @@ ydisk personal status работает. `sync --rescan` читает все выбранные папки с начала. Выполните его один раз и дальше возвращайтесь к обычной команде `sync`. -Выбранную папку, которую вы переименовали или перенесли на Диске, инструмент больше не находит, и её документы -уходят из копии. Добавьте её снова под новым путём. +Выбранную папку, которую вы переименовали или перенесли на Диске, инструмент больше не находит, и ее документы +уходят из копии. Добавьте ее снова под новым путем. ## Что хранит копия @@ -74,7 +74,7 @@ ydisk personal status | Отсканированный PDF или картинка | Имя, путь и даты. Текста для чтения нет | | Любой другой файл и любой файл больше 50 МБ | Имя, путь и даты | -`status` перечисляет каждый файл, сохранённый только по имени, с причиной. Сами файлы остаются на Диске, а копия +`status` перечисляет каждый файл, сохраненный только по имени, с причиной. Сами файлы остаются на Диске, а копия хранит их текст. Время хранится и показывается в UTC. ## Читайте синхронизированный документ @@ -112,8 +112,8 @@ ydisk personal files unpublish /Documents/plan.pdf - `files download` без `--output` отвечает текстом файла, до 200 000 символов, так что агент читает файл вне выбранных папок, не сохраняя его. - `files delete` переносит файл в корзину Диска, а `files restore` возвращает его по пути в корзине. -- `files publish` создаёт публичную ссылку, которую может открыть любой, у кого она есть. `files unpublish` закрывает - её. +- `files publish` создает публичную ссылку, которую может открыть любой, у кого она есть. `files unpublish` закрывает + ее. - `--replace` при загрузке, копировании или переносе перезаписывает файл, который уже лежит по этому пути. В терминале инструмент спрашивает перед удалением, перезаписью и публичной ссылкой. Через MCP спросить некого, поэтому From 32adbba33d2bd61ed938c39cacce43dc82cbcd82 Mon Sep 17 00:00:00 2001 From: leemour <leemour@gmail.com> Date: Wed, 18 Nov 2026 15:10:37 +0100 Subject: [PATCH 4/4] docs(ydisk): plain RU sentence for how sign-in works Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- translations/ydisk/installation.ru.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/ydisk/installation.ru.md b/translations/ydisk/installation.ru.md index e2aec2ea..17d57df3 100644 --- a/translations/ydisk/installation.ru.md +++ b/translations/ydisk/installation.ru.md @@ -3,7 +3,7 @@ title: "Установка и вход" --- Настройте `ydisk` один раз на каждом компьютере, где работаете вы или ваш агент. После этих шагов ваш Диск подключен -под именем профиля, которое вы выбрали, и первый поиск работает. Вход: вставка токена OAuth Яндекса: ключа, который +под именем профиля, которое вы выбрали, и первый поиск работает. Чтобы войти, вы вставляете токен OAuth Яндекса. Это ключ, который Яндекс выдает для вашего собственного аккаунта и который дает инструменту доступ к Диску. Получить его можно минут за пять, один раз.