Продуктивность
Поиск по базе знаний
Ищет по локальным Markdown-заметкам и собирает индекс заголовков без внешних сервисов.
Shell
Linux
macOS
Средний
Что делает скрипт
Скрипт обходит папку с заметками, ищет строку с учётом регистра и выводит файлы и номера строк. Фильтр по тегу сужает выдачу, а команда index создаёт новый файл с заголовками. Исходные заметки не изменяются.
Перед запуском
- Индекс создаётся как новый файл и не заменяет существующий без --force.
Запуск
Быстрый старт
bash knowledge_base.sh --dir notes --query "деплой"
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
Другие варианты
bash knowledge_base.sh --dir notes --query "деплой"bash knowledge_base.sh --dir notes --query "api" --tag workbash knowledge_base.sh --dir notes --index notes/index.md
Что понадобится
Bash 4+
Стандартные утилиты coreutils, grep и awk
Linux
sudo apt install bash
macOS
brew install bash
Исходник
knowledge_base.sh
#!/usr/bin/env bash
set -euo pipefail
usage() {
echo "Использование: $0 --dir PATH [--query TEXT] [--tag TAG] [--files-only] [--index FILE] [--force]"
}
dir=""
query=""
tag=""
files_only=0
index_file=""
force=0
while [[ $# -gt 0 ]]; do
case "$1" in
--dir) dir="${2:-}"; shift 2 ;;
--query) query="${2:-}"; shift 2 ;;
--tag) tag="${2:-}"; shift 2 ;;
--files-only) files_only=1; shift ;;
--index) index_file="${2:-}"; shift 2 ;;
--force) force=1; shift ;;
-h|--help) usage; exit 0 ;;
*) echo "Неизвестный аргумент: $1" >&2; usage >&2; exit 2 ;;
esac
done
if [[ -z "$dir" || ! -d "$dir" ]]; then
echo "Укажите существующую папку через --dir" >&2
exit 2
fi
if [[ -n "$index_file" ]]; then
if [[ -e "$index_file" && "$force" -eq 0 ]]; then
echo "Файл уже существует: $index_file. Добавьте --force." >&2
exit 1
fi
mkdir -p "$(dirname "$index_file")"
{
echo "# Индекс заметок"
echo
find "$dir" -type f -name '*.md' -print0 | while IFS= read -r -d '' file; do
if [[ "$file" == "$index_file" ]]; then
continue
fi
title="$(awk '/^# / { sub(/^# /, ""); print; exit }' "$file")"
if [[ -z "$title" ]]; then
title="$(basename "$file" .md)"
fi
echo "- [${title}](${file})"
done
} > "$index_file"
echo "Индекс сохранён: $index_file"
exit 0
fi
if [[ -z "$query" ]]; then
echo "Укажите --query или --index" >&2
exit 2
fi
search_files() {
if [[ -n "$tag" ]]; then
find "$dir" -type f -name '*.md' -print0 | while IFS= read -r -d '' file; do
if grep -Fqi -- "#${tag}" "$file"; then
printf '%s\0' "$file"
fi
done
else
find "$dir" -type f -name '*.md' -print0
fi
}
if (( files_only )); then
search_files | while IFS= read -r -d '' file; do
if grep -Fqi -- "$query" "$file"; then
echo "$file"
fi
done
exit 0
fi
search_files | while IFS= read -r -d '' file; do
grep -Fni -- "$query" "$file" || true
done
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.