mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-09 10:19:00 +08:00
1239fb4651
- 新增 gframework-doc-refresh 统一技能入口，并补齐模块扫描、证据顺序、模板与校验脚本 - 更新共享文档规范与模块映射，收口源码模块到 README、docs 和 ai-libs 的固定关联 - 删除旧 vitepress-* 公开技能定义，避免继续以文档类型拆分入口 - 同步 documentation-governance-and-refresh 的恢复点、风险和下一步
57 lines
1.4 KiB
Bash
57 lines
1.4 KiB
Bash
#!/bin/bash
|
|
# 验证 Markdown 代码块是否闭合并带有语言标记。
|
|
|
|
set -e
|
|
|
|
FILE="$1"
|
|
|
|
if [ -z "$FILE" ]; then
|
|
echo "用法: $0 <文件路径>"
|
|
exit 1
|
|
fi
|
|
|
|
if [ ! -f "$FILE" ]; then
|
|
echo "错误: 文件不存在: $FILE"
|
|
exit 1
|
|
fi
|
|
|
|
ERROR_COUNT=0
|
|
WARNING_COUNT=0
|
|
CODE_FENCE_COUNT=$(grep -c '^```' "$FILE" || true)
|
|
|
|
if [ $((CODE_FENCE_COUNT % 2)) -ne 0 ]; then
|
|
echo "✗ 错误: 存在未闭合的代码块"
|
|
ERROR_COUNT=$((ERROR_COUNT + 1))
|
|
fi
|
|
|
|
LINE_NUMBER=0
|
|
while IFS= read -r LINE; do
|
|
LINE_NUMBER=$((LINE_NUMBER + 1))
|
|
|
|
if echo "$LINE" | grep -qE '^```(cs|c#|C#)$'; then
|
|
echo "⚠ 警告: 第 $LINE_NUMBER 行使用了非标准 C# 标记，建议改为 csharp"
|
|
WARNING_COUNT=$((WARNING_COUNT + 1))
|
|
fi
|
|
|
|
if echo "$LINE" | grep -qE '^```$'; then
|
|
NEXT_LINE=$(sed -n "$((LINE_NUMBER + 1))p" "$FILE")
|
|
if [ -n "$NEXT_LINE" ] && ! echo "$NEXT_LINE" | grep -qE '^```'; then
|
|
echo "⚠ 警告: 第 $LINE_NUMBER 行的代码块缺少语言标记"
|
|
WARNING_COUNT=$((WARNING_COUNT + 1))
|
|
fi
|
|
fi
|
|
done < "$FILE"
|
|
|
|
if [ $ERROR_COUNT -eq 0 ] && [ $WARNING_COUNT -eq 0 ]; then
|
|
echo "✓ 代码块验证通过"
|
|
exit 0
|
|
fi
|
|
|
|
if [ $ERROR_COUNT -eq 0 ]; then
|
|
echo "⚠ 代码块验证通过，但有 $WARNING_COUNT 个警告"
|
|
exit 0
|
|
fi
|
|
|
|
echo "✗ 代码块验证失败（$ERROR_COUNT 个错误，$WARNING_COUNT 个警告）"
|
|
exit 1
|