evolver-tools 1.4.0__py3-none-any.whl

evolver_tools/vendor/markdown_check/__init__.py

@@ -0,0 +1,211 @@
+#!/usr/bin/env python3
+"""markdown-check — Markdown 格式校验器
+
+检查 Markdown 文件中的常见问题：
+  · 标题层级跳跃 (h1→h3)
+  · 断开的锚点链接
+  · 代码块未配对
+  · 尾随空白
+  · 空列表项
+  · 过长的行
+
+用法:
+  markdown-check README.md
+  markdown-check docs/**/*.md
+  markdown-check .              # 递归检查所有 .md 文件
+
+输出格式: 文件:行:列  级别  消息
+
+零外部依赖。纯 Python 3.8+。
+"""
+
+import os
+import re
+import sys
+import glob
+
+
+# ── 规则引擎 ──────────────────────────────────────────────
+
+class MarkdownChecker:
+    """对单个 .md 文件执行所有检查规则"""
+
+    def __init__(self, path):
+        self.path = path
+        self.lines = []
+        self.issues = []    # (line, col, level, msg)
+        self._code_fence = None  # 当前是否在代码块内
+
+    def check(self):
+        try:
+            with open(self.path, "r", encoding="utf-8", errors="replace") as f:
+                self.lines = f.readlines()
+        except Exception as e:
+            self.issues.append((1, 0, "ERROR", f"无法读取文件: {e}"))
+            return self
+
+        self._code_fence = None
+        headings_seen = set()
+
+        for i, raw in enumerate(self.lines):
+            ln = i + 1
+            line = raw.rstrip("\n").rstrip("\r")
+            stripped = line.strip()
+
+            # ── 跟踪代码块 ──
+            if line.startswith("```") or line.startswith("~~~"):
+                fence_char = line[:3]
+                if self._code_fence is None:
+                    self._code_fence = fence_char
+                elif self._code_fence == fence_char:
+                    # 检查代码块关闭后是否有多余内容
+                    rest = line[3:].strip()
+                    if rest and self._code_fence is None:
+                        pass  # 围栏有语言标注，正常
+                    self._code_fence = None
+                continue
+
+            # 代码块内跳过 lint
+            if self._code_fence:
+                continue
+
+            # ── 规则 1: 尾随空白 ──
+            if raw.endswith(" \n") or raw.endswith("\t\n") or raw.endswith("  \r\n"):
+                self.issues.append((ln, len(raw.rstrip("\n\r")), "WARN", "尾随空白"))
+
+            # ── 规则 2: 标题层级跳跃 ──
+            heading_match = re.match(r"^(#{1,6})\s+(.+)$", line)
+            if heading_match:
+                level = len(heading_match.group(1))
+                text = heading_match.group(2).strip()
+                # 检查 ATX 标题是否以 # 结尾（不规范但常见）
+                if text.endswith("#"):
+                    self.issues.append((ln, len(line) - text[::-1].index("#"), "INFO",
+                                        "标题尾部有多余 #"))
+
+                # 检查是否有更高级别标题出现过
+                if headings_seen:
+                    max_seen = max(headings_seen)
+                    if level - max_seen > 1:
+                        self.issues.append((ln, 0, "WARN",
+                                            f"标题层级跳跃: h{max_seen} → h{level}"))
+                headings_seen.add(level)
+
+            # ── 规则 3: 空列表项 ──
+            if re.match(r"^(\s*[-*+]|\s*\d+\.)\s*$", line):
+                self.issues.append((ln, 0, "WARN", "空列表项"))
+
+            # ── 规则 4: 过长行 ──
+            if len(line) > 120 and not line.startswith("|"):  # 跳过表格
+                self.issues.append((ln, 120, "INFO", f"行过长 ({len(line)} > 120 字符)"))
+
+            # ── 规则 5: 重复的标点 ──
+            if re.search(r"[!?.,:;]{3,}", line):
+                self.issues.append((ln, 0, "INFO", "重复标点"))
+
+            # ── 规则 6: 图片缺少 alt 文本 ──
+            for match in re.finditer(r"!\[(.*?)\]\(.*?\)", line):
+                alt_text = match.group(1).strip()
+                if not alt_text:
+                    self.issues.append((ln, match.start(), "WARN", "图片缺少 alt 文本"))
+
+        # ── 文件级检查 ──
+        # 代码块未关闭
+        if self._code_fence:
+            self.issues.append((len(self.lines), 0, "ERROR", "代码块未关闭"))
+
+        # 没有标题
+        if not headings_seen and self.lines:
+            self.issues.append((1, 0, "INFO", "文件没有标题"))
+
+        # 空文件
+        if not self.lines or all(l.strip() == "" for l in self.lines):
+            self.issues.append((1, 0, "WARN", "空文件"))
+
+        return self
+
+    def report(self, show_all=False):
+        """返回格式化报告"""
+        total = {"ERROR": 0, "WARN": 0, "INFO": 0}
+        lines = []
+        for ln, col, level, msg in self.issues:
+            total[level] = total.get(level, 0) + 1
+            if level == "INFO" and not show_all:
+                continue
+            col_str = f":{col}" if col else ""
+            lines.append(f"  {self.path}:{ln}{col_str}  {level:<5} {msg}")
+
+        if not lines:
+            return "  ✓ 整洁\n"
+
+        header = (f"  {self.path}: "
+                  f"{total.get('ERROR', 0)} error(s), "
+                  f"{total.get('WARN', 0)} warn(s), "
+                  f"{total.get('INFO', 0)} info(s)")
+        return header + "\n" + "\n".join(lines) + "\n"
+
+
+# ── CLI 入口 ──────────────────────────────────────────────
+
+def main():
+    import argparse
+
+    parser = argparse.ArgumentParser(
+        description="markdown-check — Markdown 格式校验器",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="示例:\n  markdown-check README.md\n  markdown-check docs/\n  markdown-check -a .  # 显示所有信息级提示",
+    )
+    parser.add_argument("target", nargs="?", default=".", help="文件或目录（默认: 当前目录）")
+    parser.add_argument("-a", "--all", action="store_true", help="显示所有信息级提示（含 INFO）")
+    parser.add_argument("-q", "--quiet", action="store_true", help="只显示有问题的文件")
+    parser.add_argument("--no-recursive", action="store_true", help="不递归搜索子目录")
+
+    args = parser.parse_args()
+    target = args.target
+
+    # 收集文件
+    files = []
+    if os.path.isfile(target):
+        if target.endswith(".md") or target.endswith(".markdown"):
+            files = [target]
+        else:
+            print(f"错误: 不是 Markdown 文件: {target}", file=sys.stderr)
+            sys.exit(1)
+    elif os.path.isdir(target):
+        pattern = "**/*.md" if not args.no_recursive else "*.md"
+        files = sorted(glob.glob(os.path.join(target, pattern), recursive=True))
+    else:
+        # 尝试 glob
+        matches = glob.glob(target, recursive=True)
+        files = sorted(f for f in matches if f.endswith((".md", ".markdown")))
+
+    if not files:
+        print("未找到 .md 文件", file=sys.stderr)
+        sys.exit(0)
+
+    # 执行检查
+    total_errors = 0
+    total_warns = 0
+    checked = 0
+
+    for fpath in files:
+        checker = MarkdownChecker(fpath)
+        checker.check()
+        if not args.quiet or any(i[1] != "INFO" or args.all for i in checker.issues):
+            print(checker.report(show_all=args.all))
+        for _, _, level, _ in checker.issues:
+            if level == "ERROR":
+                total_errors += 1
+            elif level == "WARN":
+                total_warns += 1
+        checked += 1
+
+    # 汇总
+    print(f"---\n检查了 {checked} 个文件，"
+          f"{total_errors} 个错误，{total_warns} 个警告")
+
+    sys.exit(1 if total_errors > 0 else 0)
+
+
+if __name__ == "__main__":
+    main()

evolver_tools/vendor/nb/__init__.py

@@ -0,0 +1,319 @@
+#!/usr/bin/env python3
+"""
+nb — 命令行笔记簿
+终端下的轻量笔记管理工具。
+"""
+
+import json
+import os
+import sys
+import time
+import re
+from pathlib import Path
+from datetime import datetime
+
+NOTES_DIR = Path.home() / '.nb'
+NOTES_FILE = NOTES_DIR / 'notes.json'
+NOTES_EXPORT = NOTES_DIR / 'export'
+
+def ensure_db():
+    NOTES_DIR.mkdir(parents=True, exist_ok=True)
+    if not NOTES_FILE.exists():
+        with open(NOTES_FILE, 'w') as f:
+            json.dump([], f)
+
+def load_notes():
+    ensure_db()
+    try:
+        with open(NOTES_FILE) as f:
+            return json.load(f)
+    except (json.JSONDecodeError, FileNotFoundError):
+        return []
+
+def save_notes(notes):
+    ensure_db()
+    with open(NOTES_FILE, 'w') as f:
+        json.dump(notes, f, indent=2, ensure_ascii=False)
+
+def next_id(notes):
+    if not notes:
+        return 1
+    return max(n['id'] for n in notes) + 1
+
+def timestamp():
+    return datetime.now().strftime('%Y-%m-%d %H:%M')
+
+def cmd_new(args):
+    """nb new <title> — 创建新笔记（从 stdin 读取内容或交互输入）"""
+    title = ' '.join(args) if args else '未命名笔记'
+
+    print(f"📝 标题: {title}")
+    print("输入内容（空行 + Ctrl+D 结束）:")
+    lines = []
+    try:
+        while True:
+            line = sys.stdin.readline()
+            if not line:
+                break
+            line = line.rstrip('\n')
+            if line == '' and lines and lines[-1] == '':
+                break
+            lines.append(line)
+    except (EOFError, KeyboardInterrupt):
+        pass
+
+    content = '\n'.join(lines).strip()
+    if not content:
+        print("✗ 笔记内容为空，取消")
+        return
+
+    notes = load_notes()
+    note = {
+        'id': next_id(notes),
+        'title': title,
+        'content': content,
+        'created': timestamp(),
+        'updated': timestamp(),
+    }
+    notes.insert(0, note)  # newest first
+    save_notes(notes)
+    print(f"✓ 笔记 #{note['id']} 已保存: {title}")
+
+
+def cmd_list(args):
+    """nb list [--all] — 列出笔记"""
+    notes = load_notes()
+    if not notes:
+        print("(没有笔记)")
+        return
+
+    show_all = '--all' in args
+    display = notes if show_all else notes[:20]
+
+    for n in display:
+        created = n.get('created', '?')
+        title = n['title']
+        preview = n['content'][:60].replace('\n', ' ')
+        if len(preview) < len(n['content']):
+            preview += '...'
+        print(f"  [{n['id']:>3}] {created}  {title}")
+        print(f"       {preview}")
+        print()
+
+    if not show_all and len(notes) > 20:
+        print(f"... 还有 {len(notes) - 20} 条 (使用 --all 查看全部)")
+
+
+def cmd_show(args):
+    """nb show <id> — 显示笔记详情"""
+    if not args:
+        print("用法: nb show <id>")
+        return
+    try:
+        nid = int(args[0])
+    except ValueError:
+        print("无效的 ID")
+        return
+
+    notes = load_notes()
+    for n in notes:
+        if n['id'] == nid:
+            print(f"╔══════════════════════════════════════╗")
+            print(f"║ #{n['id']}  {n['title']}")
+            print(f"║  创建: {n.get('created', '?')}")
+            print(f"║  更新: {n.get('updated', '?')}")
+            print(f"╚══════════════════════════════════════╝")
+            print()
+            print(n['content'])
+            return
+    print(f"✗ 未找到笔记 #{nid}")
+
+
+def cmd_search(args):
+    """nb search <query> — 搜索笔记"""
+    if not args:
+        print("用法: nb search <query>")
+        return
+    query = ' '.join(args).lower()
+
+    notes = load_notes()
+    results = []
+    for n in notes:
+        if query in n['title'].lower() or query in n['content'].lower():
+            results.append(n)
+
+    if not results:
+        print(f"(未找到匹配 '{query}' 的笔记)")
+        return
+
+    print(f"找到 {len(results)} 条匹配 '{query}':\n")
+    for n in results:
+        # Highlight matches
+        title = n['title']
+        preview = n['content'][:80].replace('\n', ' ')
+        print(f"  [{n['id']:>3}] {n.get('created', '?')}  {title}")
+        print(f"       {preview}")
+        print()
+
+
+def cmd_delete(args):
+    """nb delete <id> — 删除笔记"""
+    if not args:
+        print("用法: nb delete <id>")
+        return
+    try:
+        nid = int(args[0])
+    except ValueError:
+        print("无效的 ID")
+        return
+
+    notes = load_notes()
+    for i, n in enumerate(notes):
+        if n['id'] == nid:
+            confirm = input(f"删除笔记 #{nid} 「{n['title']}」? (y/N) ").lower()
+            if confirm == 'y':
+                notes.pop(i)
+                save_notes(notes)
+                print(f"✓ 笔记 #{nid} 已删除")
+            else:
+                print("取消")
+            return
+    print(f"✗ 未找到笔记 #{nid}")
+
+
+def cmd_edit(args):
+    """nb edit <id> — 编辑笔记内容（替换内容）"""
+    if not args:
+        print("用法: nb edit <id>")
+        return
+    try:
+        nid = int(args[0])
+    except ValueError:
+        print("无效的 ID")
+        return
+
+    notes = load_notes()
+    for n in notes:
+        if n['id'] == nid:
+            print(f"编辑笔记 #{nid} 「{n['title']}」")
+            print("当前内容:")
+            print(n['content'])
+            print("\n--- 输入新内容（空行 + Ctrl+D 结束）---")
+            lines = []
+            try:
+                while True:
+                    line = sys.stdin.readline()
+                    if not line:
+                        break
+                    line = line.rstrip('\n')
+                    if line == '' and lines and lines[-1] == '':
+                        break
+                    lines.append(line)
+            except (EOFError, KeyboardInterrupt):
+                pass
+            content = '\n'.join(lines).strip()
+            if content:
+                n['content'] = content
+                n['updated'] = timestamp()
+                save_notes(notes)
+                print(f"✓ 笔记 #{nid} 已更新")
+            else:
+                print("内容为空，未修改")
+            return
+    print(f"✗ 未找到笔记 #{nid}")
+
+
+def cmd_export(args):
+    """nb export — 导出所有笔记为 Markdown 文件"""
+    notes = load_notes()
+    if not notes:
+        print("(没有笔记可导出)")
+        return
+
+    export_dir = NOTES_EXPORT
+    export_dir.mkdir(parents=True, exist_ok=True)
+
+    # Also clear old exports
+    for f in export_dir.glob('*.md'):
+        f.unlink()
+
+    for n in notes:
+        safe_title = re.sub(r'[^\w\s-]', '', n['title']).strip()[:40]
+        safe_title = re.sub(r'[-\s]+', '-', safe_title).lower()
+        if not safe_title:
+            safe_title = f'note-{n["id"]}'
+        filename = f"{n['id']:03d}-{safe_title}.md"
+
+        md = f"# {n['title']}\n\n"
+        md += f"- **ID**: #{n['id']}\n"
+        md += f"- **创建**: {n.get('created', '?')}\n"
+        md += f"- **更新**: {n.get('updated', '?')}\n\n"
+        md += "---\n\n"
+        md += n['content'] + '\n'
+
+        with open(export_dir / filename, 'w') as f:
+            f.write(md)
+
+    print(f"✓ 已导出 {len(notes)} 条笔记到 {export_dir}")
+
+
+def cmd_count(args):
+    """nb count — 统计笔记数量"""
+    notes = load_notes()
+    total = len(notes)
+    total_chars = sum(len(n['content']) for n in notes)
+    print(f"📊 笔记数: {total}")
+    print(f"📊 总字数: {total_chars}")
+
+
+def show_help():
+    print("nb — 命令行笔记簿")
+    print()
+    print("用法:")
+    print("  nb new <title>          创建新笔记")
+    print("  nb list [--all]         列出笔记")
+    print("  nb show <id>            查看笔记")
+    print("  nb search <query>       搜索笔记")
+    print("  nb edit <id>            编辑笔记")
+    print("  nb delete <id>          删除笔记")
+    print("  nb export               导出 Markdown")
+    print("  nb count                统计信息")
+    print("  nb help                 显示帮助")
+    print()
+    print("创建笔记时，输入内容后 Ctrl+D 结束。")
+
+
+def main():
+    if len(sys.argv) < 2 or sys.argv[1] in ('help', '--help', '-h'):
+        show_help()
+        return
+
+    cmd = sys.argv[1]
+    args = sys.argv[2:]
+
+    commands = {
+        'new': cmd_new,
+        'list': cmd_list,
+        'ls': cmd_list,
+        'show': cmd_show,
+        'get': cmd_show,
+        'search': cmd_search,
+        'find': cmd_search,
+        'edit': cmd_edit,
+        'delete': cmd_delete,
+        'rm': cmd_delete,
+        'export': cmd_export,
+        'count': cmd_count,
+        'stats': cmd_count,
+    }
+
+    if cmd in commands:
+        ensure_db()
+        commands[cmd](args)
+    else:
+        print(f"未知命令: {cmd}")
+        print("使用 'nb help' 查看帮助")
+
+
+if __name__ == '__main__':
+    main()

evolver_tools/vendor/nb/__main__.py

@@ -0,0 +1,3 @@
+"""CLI entry point for `python -m nb`"""
+from nb import main
+main()