Продуктивность

Поиск по базе знаний

Ищет по локальным Markdown-заметкам и собирает индекс заголовков без внешних сервисов.

Shell Linux macOS Средний
Скачать knowledge_base.sh
Описание

Что делает скрипт

Скрипт обходит папку с заметками, ищет строку с учётом регистра и выводит файлы и номера строк. Фильтр по тегу сужает выдачу, а команда 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 work
  • bash 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

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get productivity-knowledge-base
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Продуктивность

Заметки, время, задачи, напоминания и автоматизация рутины.