Локальные папки

Локальные папки — это закладки на директории вашего компьютера. Они предоставляют именованную ссылку, отображающуюся в вашем списке источников, с дополнительной документацией через guide.md.

Никакой дополнительной настройки не требуется. Локальные папки используют те же инструменты Read, Write, Glob и Grep, которые работают с любым путём. Главное — это организация и документация.

Когда использовать локальные папки

Потребность	Решение
Работа в одной директории проекта	Используйте рабочую папку
Закладки нескольких папок	Используйте локальные папки
Документирование содержимого и конвенций папки	Используйте локальные папки с guide.md

Конфигурация

Создайте папку источника с файлом config.json:

terminaljson

{
  "type": "local",
  "name": "My Notes",
  "slug": "my-notes",
  "enabled": true,
  "provider": "local",
  "local": {
    "path": "/Users/me/Documents/Notes"
  }
}

Поля

Поле	Описание
`type`	Должно быть `"local"`
`name`	Отображаемое имя в списке источников
`slug`	URL-безопасный идентификатор (используется как имя папки)
`enabled`	Активен ли источник
`provider`	Идентификатор сервиса, используйте `"local"`
`local.path`	Абсолютный путь к папке

Опционально: подсказка формата

Вы можете добавить подсказку формата, чтобы помочь вашему агенту понять содержимое папки:

terminaljson

{
  "type": "local",
  "name": "Obsidian Vault",
  "slug": "my-vault",
  "provider": "obsidian",
  "local": {
    "path": "/Users/me/Documents/ObsidianVault",
    "format": "obsidian"
  }
}

Добавление локальной папки

Самый простой способ — попросить вашего агента:

«Добавь мою папку Desktop как источник»

Или создайте вручную:

Создайте папку источника:

terminalbash

~/.craft-agent/workspaces/{workspace-id}/sources/my-folder/

Добавьте config.json с конфигурацией выше
Опционально добавьте guide.md с контекстом о папке

Пример guide.md

Руководство помогает вашему агенту понять, что находится в папке и как с ней работать:

terminalbash

# Desktop

Temporary files and downloads. Check here for recent screenshots and exports.

## Contents
- Screenshots from CMD+Shift+4
- Downloaded PDFs and documents
- Temporary exports from apps

## Conventions
- Screenshots go in /Screenshots subfolder
- Delete files older than 1 week
- Don't commit anything from here to git

Разрешения в режиме изучения

По умолчанию локальные папки работают в режиме Изучения с стандартными командами bash только для чтения (ls, cat, head, tail и т.д.).

Для настройки добавьте permissions.json:

terminaljson

{
  "allowedBashPatterns": [
    { "pattern": "^ls\\s", "comment": "List contents" },
    { "pattern": "^tree\\s", "comment": "Show directory tree" }
  ]
}