115 lines
3.6 KiB
Bash
Executable File
115 lines
3.6 KiB
Bash
Executable File
#!/bin/bash
|
|
# lint-fix.sh — 自动修复 lint 发现的低风险问题
|
|
# 用法：bash scripts/lint-fix.sh <wiki_root> [--dry-run]
|
|
# 修复范围：仅处理确定性修复（补 index 条目），不做高风险操作（删页面、改内容）
|
|
# 退出码：0 = 完成，1 = 参数错误
|
|
|
|
set -u
|
|
shopt -s nullglob
|
|
|
|
WIKI_ROOT="${1:-.}"
|
|
DRY_RUN=false
|
|
[ "${2:-}" = "--dry-run" ] && DRY_RUN=true
|
|
|
|
WIKI_DIR="$WIKI_ROOT/wiki"
|
|
INDEX_FILE="$WIKI_ROOT/index.md"
|
|
|
|
if [ ! -d "$WIKI_DIR" ]; then
|
|
echo "ERROR: wiki directory not found: $WIKI_DIR" >&2
|
|
exit 1
|
|
fi
|
|
if [ ! -f "$INDEX_FILE" ]; then
|
|
echo "ERROR: index.md not found: $INDEX_FILE" >&2
|
|
exit 1
|
|
fi
|
|
|
|
FIXED=0
|
|
|
|
index_has_entry() {
|
|
local entry="$1"
|
|
grep -ohE "\[\[[^]]+\]\]" "$INDEX_FILE" 2>/dev/null | \
|
|
sed -e 's/\[\[//g' -e 's/\]\]//g' -e 's/|.*//' | \
|
|
grep -Fxq "$entry"
|
|
}
|
|
|
|
# Insert a [[link]] entry after the matching section header in index.md.
|
|
# If no matching section is found, appends to end of file as fallback.
|
|
insert_under_section() {
|
|
local index_file="$1"
|
|
local section_pattern="$2"
|
|
local entry="$3"
|
|
|
|
# Find the line number of the section header
|
|
local line_num
|
|
line_num=$(grep -n -i -E "^#.*($section_pattern)" "$index_file" 2>/dev/null | head -1 | cut -d: -f1)
|
|
|
|
if [ -n "$line_num" ]; then
|
|
# Scan from section header to find insert point:
|
|
# last "- [[" line before next "##" header or EOF
|
|
local total_lines last_list_line offset
|
|
total_lines=$(wc -l < "$index_file" | tr -d ' ')
|
|
last_list_line="$line_num"
|
|
offset=$((line_num + 1))
|
|
while [ "$offset" -le "$total_lines" ]; do
|
|
local cur_line
|
|
cur_line=$(sed -n "${offset}p" "$index_file")
|
|
case "$cur_line" in
|
|
"##"*) break ;;
|
|
"- [["*) last_list_line="$offset" ;;
|
|
esac
|
|
offset=$((offset + 1))
|
|
done
|
|
# Insert after the last list item
|
|
local tmp_file
|
|
tmp_file=$(mktemp "${index_file}.tmp.XXXXXX") || return 1
|
|
awk -v insert_after="$last_list_line" -v entry="$entry" '
|
|
{ print }
|
|
NR == insert_after { print "- [[" entry "]]" }
|
|
' "$index_file" > "$tmp_file" && mv "$tmp_file" "$index_file"
|
|
else
|
|
# Fallback: append to end of file
|
|
printf '\n- [[%s]]\n' "$entry" >> "$index_file"
|
|
fi
|
|
}
|
|
|
|
echo "=== lint-fix: low-risk auto-repair ==="
|
|
echo ""
|
|
|
|
# Fix 1: Add unlisted pages to index.md
|
|
# Only adds pages that exist in wiki/ but are not referenced in index.md
|
|
# Skips derived pages (queries/, sessions/)
|
|
echo "--- Checking for unlisted pages ---"
|
|
for _subdir in entities topics sources comparisons synthesis; do
|
|
for f in "$WIKI_DIR"/$_subdir/*.md; do
|
|
[ -f "$f" ] || continue
|
|
BASENAME=$(basename "$f" .md)
|
|
# Skip derived pages
|
|
case "$f" in
|
|
*/queries/*|*/sessions/*) continue ;;
|
|
esac
|
|
if ! index_has_entry "$BASENAME"; then
|
|
SECTION_PATTERN=""
|
|
case "$_subdir" in
|
|
entities) SECTION_PATTERN="实体页|Entities" ;;
|
|
topics) SECTION_PATTERN="主题页|Topics" ;;
|
|
sources) SECTION_PATTERN="素材摘要|Sources" ;;
|
|
comparisons) SECTION_PATTERN="对比分析|Comparisons" ;;
|
|
synthesis) SECTION_PATTERN="综合分析|Synthesis" ;;
|
|
esac
|
|
if [ "$DRY_RUN" = true ]; then
|
|
echo " [dry-run] Would add [[$BASENAME]] under $_subdir section"
|
|
else
|
|
insert_under_section "$INDEX_FILE" "$SECTION_PATTERN" "$BASENAME"
|
|
echo " Fixed: added [[$BASENAME]] under $_subdir section"
|
|
fi
|
|
FIXED=$((FIXED + 1))
|
|
fi
|
|
done
|
|
done
|
|
[ "$FIXED" -eq 0 ] && echo " (all pages already listed)"
|
|
echo ""
|
|
|
|
echo "=== lint-fix complete: $FIXED fix(es) applied ==="
|
|
[ "$DRY_RUN" = true ] && echo "(dry-run mode — no files were modified)"
|
|
exit 0
|