Источники, которые вы добавляете сами

Эта страница поможет дать Memo одну вещь, которую нужно запомнить: файл, веб-страницу или вставленный текст. Memo хранит ее как отдельный документ, поэтому вы находите ее поиском, агент находит ее, когда что-то ищет, а факты могут на нее ссылаться. Папка, за которой следит Memo, нужна для многих файлов, которые часто меняются (Заметки и папки). Эта страница про один источник.

Добавьте источникCopy Anchor Link

memo sources add ~/Downloads/runner-notes.pdf --subject project:3
memo sources add https://example.org/release-notes --title "Release notes"
pbpaste | memo sources add - --subject person:12

• Хранится только текст. Memo сохраняет прочитанный текст, заголовок и, для страницы, адрес, который вы дали. Файл он не копирует, если вы не добавите --keep-copy. Тогда файл копируется в папку данных Memo под именем по его содержимому, поэтому один и тот же файл, добавленный дважды, хранится один раз. --keep-copy работает только с файлом, не со страницей и не со вставленным текстом.
• Один и тот же источник дважды остается одним источником. Повторное добавление меняет только предметы, которые вы добавили. Если содержимое источника уже есть в папке, за которой следит Memo, или в Drive, он не сохраняется еще раз. Ответ называет тот документ в duplicate_of, и к нему привязываются только предметы.
• --subject говорит, о ком или о чем источник: person:, organization:, project:, task:, meeting: или контакт мессенджера, например telegram:'Kai Sample'. Повторите его для нескольких. Ваши предметы действуют сразу, а предметы агента ждут, пока вы их не подтвердите.
• --title дает название. Без него Memo берет собственный заголовок страницы или файла или первую строку текста.
• --max-chars оставляет не больше этого числа символов текста, до 2 000 000 (по умолчанию 200 000). Ответ пишет truncated: true, когда сохранена только первая часть.

У картинки или отсканированного PDF нет текста, который Memo может прочитать. Такой источник хранится только по заголовку и предметам (read: "no-text").

Что говорит ответCopy Anchor Link

memo sources add notes.txt --json

Посмотрите на источникCopy Anchor Link

memo sources show document:42
memo sources show document:42 --bytes 65536 --json
memo sources mentions document:42

sources show дает текст (16 КиБ по умолчанию, --bytes для большего), что это такое (kind, url, который вы дали, file_name, mime, bytes), хранится ли копия, предметы и подтвержден ли каждый, и что на него ссылается. Это facts, memories и пакеты находок (batches), чьи доказательства его называют. kept равен copy, только пока копия лежит в папке данных Memo. Любой другой документ показывается с added: false, и эти поля в нем null.

sources mentions перечисляет людей и организации, которых Memo уже знает и чьи имена есть в тексте. Текст читается на этом компьютере. Человек находится по имени, которое Memo видел в мессенджере или на встрече, или по его адресу почты или номеру телефона, а организация по полному названию. Если одно имя носят несколько человек, в списке будет каждый. Memo читает названия не больше 500 организаций. Если их больше, ответ говорит об этом в missing.

Читатель предлагает фактыCopy Anchor Link

Читатель это модель, которую вы выбираете. Он читает источник и предлагает факты из него. Каждый факт подтверждаете вы, сам по себе ничего фактом не становится.

memo sources readers list
memo sources readers set claude-code
memo sources suggest document:42 --subject person:12
memo actions confirm 17 fact-1 fact-3 --fingerprint <fingerprint>

Выберите читателя один раз. memo sources readers list показывает каждого читателя: установлен ли он и выполнен ли вход, его модель, уходит ли текст с этого компьютера (leaves_computer) и мог бы ли он открывать здесь файлы (reads_files). Команда делает по одной проверке на читателя, только для чтения, и ничего не выбирает. memo sources readers set <reader> выбирает читателя. Выбираете только вы, и пока вы не выбрали, sources suggest отказывает с reader.none-chosen и называет читателей.

Читатель API берет ключ из системного хранилища ключей, никогда из переменной окружения или командной строки. memo models keys set openai спрашивает его в скрытом вводе или читает из stdin. memo models keys remove openai забывает ключ. Ключ никогда не выводится.

Что делает sources suggest. Он отправляет читателю сохраненный текст источника с указанием предложить факты, каждый с точными словами, на которых он держится, и считает текст данными, а не указаниями. Затем он проверяет каждый ответ:

• цитата должна быть в тексте слово в слово, пробелы и переносы строк не учитываются. Факт, чьей цитаты там нет, отбрасывается как quote-not-found.
• у факта должно быть утверждение и один из видов фактов (fact, statement, question, decision, promise).
• факт, который уже сохранен из этого источника, отбрасывается и называется в duplicate_of, а факт, повторенный в ответе, остается один раз.

Остальное становится одним пакетом находок, который ссылается на источник. В нем каждый факт со своей цитатой, его добавляет memo-reader, а в поле модели указаны читатель и модель. Подтверждаете его только вы, даже когда включен agent_decisions. memo actions confirm <batch> [fact ids] --fingerprint <fingerprint> создает названные вами факты и отклоняет остальные. Подтвержденный факт хранит цитату в своем доказательстве, поэтому позднейшая проверка источника знает, на каких словах он держится. Ответ перечисляет добавленные facts и отброшенные (dropped) с причиной.

Если прочитать тот же текст тем же читателем, моделью и с тем же предметом, команда вернет пакет, добавленный раньше, с reused: true, и читателя снова не спросит. --rescan спрашивает снова. --subject говорит, о ком или о чем каждый факт: person:, organization:, project: или task:. --provider и --model читают один раз другим читателем, и указать их можете только вы.

Агент в своем терминале может выполнить sources suggest, но только с читателем, которого выбрали вы, и пакет все равно ждет вас. Через MCP команда не предлагается, агент не может отправить текст источника за пределы компьютера.

Удалите источникCopy Anchor Link

memo sources remove document:42

Добавленный вами источник удаляете только вы. Его текст удаляется, копия, которую хранил Memo, тоже, а ответ перечисляет факты и записи памяти, которые на него ссылаются, в facts и memories. Удаление ни одну из них не меняет. Они сохраняют свой статус, а следующая проверка источников в memo sync открывает проверку для каждой, с источником, которого больше нет, и решаете вы. Файл на вашем диске Memo никогда не трогает.

Для агентаCopy Anchor Link

Агент в терминале добавляет источник так же, и его предметы ждут вашего подтверждения:

Используй memo CLI, чтобы сохранить эти заметки со встречи как источник о Northbridge Bench, затем перечисли людей,
которые в нем названы.

Через MCP sources add принимает только text. Агент не может заставить Memo прочитать файл на этом компьютере или открыть адрес. sources remove, sources suggest и sources readers set через MCP не предлагаются (Сервер MCP).

Если добавить не получаетсяCopy Anchor Link

Каждый отказ называет причину и что делать дальше. Все они, и причины, по которым отказывает читатель, перечислены в разделе Решение проблем. Ссылку, для которой нужно войти, например закрытый Google Doc, так прочитать нельзя. Сохраните ее как файл и добавьте файл.