git-weekly 0.2.0__tar.gz

git_weekly-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 woaichilajiaochaorou
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

git_weekly-0.2.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: git-weekly
+Version: 0.2.0
+Summary: Generate weekly reports from Git commit history, with optional AI summary
+Author: woaichilajiaochaorou
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/woaichilajiaochaorou/git-weekly
+Project-URL: Repository, https://github.com/woaichilajiaochaorou/git-weekly
+Project-URL: Issues, https://github.com/woaichilajiaochaorou/git-weekly/issues
+Keywords: git,weekly,report,changelog,productivity,ai,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: ai
+Requires-Dist: openai>=1.0; extra == "ai"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Dynamic: license-file
+
+# git-weekly
+
+从 Git 提交记录自动生成周报，支持 AI 智能总结。告别"我这周干了啥"的灵魂拷问。
+
+## 功能
+
+- 扫描指定时间范围内的所有 Git 提交
+- 自动分析 diff，归类为：新功能、Bug 修复、重构、文档、测试等
+- 生成结构化周报（Markdown / 终端输出）
+- 支持多仓库聚合
+- 代码统计（新增 / 删除 / 修改的文件数）
+- **AI 智能总结**：接入 OpenAI 兼容 API，自动生成连贯的工作总结
+
+## 安装
+
+```bash
+pip install git-weekly
+```
+
+如需 AI 总结功能：
+
+```bash
+pip install "git-weekly[ai]"
+```
+
+或从源码安装：
+
+```bash
+git clone https://github.com/woaichilajiaochaorou/git-weekly.git
+cd git-weekly
+pip install -e ".[ai]"
+```
+
+## 使用
+
+```bash
+# 生成本周周报（默认当前仓库）
+git-weekly
+
+# 指定时间范围
+git-weekly --since "2025-02-24" --until "2025-02-28"
+
+# 指定仓库路径
+git-weekly --repo /path/to/your/project
+
+# 多仓库聚合
+git-weekly --repo ./project-a --repo ./project-b
+
+# 输出为 Markdown 文件
+git-weekly -o weekly-report.md
+
+# 指定作者（默认为 git config 中的用户）
+git-weekly --author "your-name"
+
+# AI 智能总结（需要安装 git-weekly[ai]）
+git-weekly --ai
+git-weekly --ai --api-key sk-xxx
+git-weekly --ai --base-url https://api.deepseek.com/v1 --model deepseek-chat
+```
+
+## 输出示例
+
+```
+──────────────────────────────────────────────────
+ 📋 周报 (02/24 - 02/28)
+──────────────────────────────────────────────────
+
+本周工作
+
+  🚀 新功能
+    • 用户登录模块：实现 JWT 鉴权
+    • 添加文件上传接口，支持图片和 PDF
+
+  🐛 Bug 修复
+    • 修复分页查询在最后一页返回空数据的问题
+    • 修复并发请求下 session 丢失
+
+  ♻️ 重构
+    • 将数据库操作抽取为 Repository 层
+
+  📝 文档
+    • 更新 API 接口文档
+
+代码统计
+
+  提交次数  12 次
+  文件变更  23 个文件
+  新增行数  +847
+  删除行数  -312
+
+🤖 AI 总结
+
+  本周主要完成了用户登录模块的 JWT 鉴权实现和文件上传接口开发，
+  同时修复了分页查询和并发 session 相关的两个稳定性问题。
+  技术层面对数据库操作进行了 Repository 层抽取，提升了代码可维护性。
+```
+
+## AI 配置
+
+API Key 支持三种配置方式（优先级从高到低）：
+
+**1. 命令行参数**
+
+```bash
+git-weekly --ai --api-key sk-xxx
+```
+
+**2. 环境变量**
+
+```bash
+export GIT_WEEKLY_API_KEY=sk-xxx
+export GIT_WEEKLY_BASE_URL=https://api.deepseek.com/v1  # 可选
+export GIT_WEEKLY_MODEL=deepseek-chat                    # 可选
+```
+
+**3. 配置文件** `~/.config/git-weekly/config.toml`
+
+```toml
+[ai]
+api_key = "sk-xxx"
+base_url = "https://api.openai.com/v1"
+model = "gpt-4o-mini"
+```
+
+### 支持的 LLM 服务
+
+任何兼容 OpenAI API 的服务都可以使用，例如：
+
+| 服务 | base_url | 推荐模型 |
+|------|----------|----------|
+| OpenAI | `https://api.openai.com/v1` (默认) | `gpt-4o-mini` |
+| DeepSeek | `https://api.deepseek.com/v1` | `deepseek-chat` |
+| 通义千问 | `https://dashscope.aliyuncs.com/compatible-mode/v1` | `qwen-plus` |
+| Ollama (本地) | `http://localhost:11434/v1` | `llama3` |
+
+## 开发
+
+```bash
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 运行测试
+pytest
+
+# 代码检查
+ruff check .
+```
+
+## License
+
+MIT

git_weekly-0.2.0/README.md

@@ -0,0 +1,151 @@
+# git-weekly
+
+从 Git 提交记录自动生成周报，支持 AI 智能总结。告别"我这周干了啥"的灵魂拷问。
+
+## 功能
+
+- 扫描指定时间范围内的所有 Git 提交
+- 自动分析 diff，归类为：新功能、Bug 修复、重构、文档、测试等
+- 生成结构化周报（Markdown / 终端输出）
+- 支持多仓库聚合
+- 代码统计（新增 / 删除 / 修改的文件数）
+- **AI 智能总结**：接入 OpenAI 兼容 API，自动生成连贯的工作总结
+
+## 安装
+
+```bash
+pip install git-weekly
+```
+
+如需 AI 总结功能：
+
+```bash
+pip install "git-weekly[ai]"
+```
+
+或从源码安装：
+
+```bash
+git clone https://github.com/woaichilajiaochaorou/git-weekly.git
+cd git-weekly
+pip install -e ".[ai]"
+```
+
+## 使用
+
+```bash
+# 生成本周周报（默认当前仓库）
+git-weekly
+
+# 指定时间范围
+git-weekly --since "2025-02-24" --until "2025-02-28"
+
+# 指定仓库路径
+git-weekly --repo /path/to/your/project
+
+# 多仓库聚合
+git-weekly --repo ./project-a --repo ./project-b
+
+# 输出为 Markdown 文件
+git-weekly -o weekly-report.md
+
+# 指定作者（默认为 git config 中的用户）
+git-weekly --author "your-name"
+
+# AI 智能总结（需要安装 git-weekly[ai]）
+git-weekly --ai
+git-weekly --ai --api-key sk-xxx
+git-weekly --ai --base-url https://api.deepseek.com/v1 --model deepseek-chat
+```
+
+## 输出示例
+
+```
+──────────────────────────────────────────────────
+ 📋 周报 (02/24 - 02/28)
+──────────────────────────────────────────────────
+
+本周工作
+
+  🚀 新功能
+    • 用户登录模块：实现 JWT 鉴权
+    • 添加文件上传接口，支持图片和 PDF
+
+  🐛 Bug 修复
+    • 修复分页查询在最后一页返回空数据的问题
+    • 修复并发请求下 session 丢失
+
+  ♻️ 重构
+    • 将数据库操作抽取为 Repository 层
+
+  📝 文档
+    • 更新 API 接口文档
+
+代码统计
+
+  提交次数  12 次
+  文件变更  23 个文件
+  新增行数  +847
+  删除行数  -312
+
+🤖 AI 总结
+
+  本周主要完成了用户登录模块的 JWT 鉴权实现和文件上传接口开发，
+  同时修复了分页查询和并发 session 相关的两个稳定性问题。
+  技术层面对数据库操作进行了 Repository 层抽取，提升了代码可维护性。
+```
+
+## AI 配置
+
+API Key 支持三种配置方式（优先级从高到低）：
+
+**1. 命令行参数**
+
+```bash
+git-weekly --ai --api-key sk-xxx
+```
+
+**2. 环境变量**
+
+```bash
+export GIT_WEEKLY_API_KEY=sk-xxx
+export GIT_WEEKLY_BASE_URL=https://api.deepseek.com/v1  # 可选
+export GIT_WEEKLY_MODEL=deepseek-chat                    # 可选
+```
+
+**3. 配置文件** `~/.config/git-weekly/config.toml`
+
+```toml
+[ai]
+api_key = "sk-xxx"
+base_url = "https://api.openai.com/v1"
+model = "gpt-4o-mini"
+```
+
+### 支持的 LLM 服务
+
+任何兼容 OpenAI API 的服务都可以使用，例如：
+
+| 服务 | base_url | 推荐模型 |
+|------|----------|----------|
+| OpenAI | `https://api.openai.com/v1` (默认) | `gpt-4o-mini` |
+| DeepSeek | `https://api.deepseek.com/v1` | `deepseek-chat` |
+| 通义千问 | `https://dashscope.aliyuncs.com/compatible-mode/v1` | `qwen-plus` |
+| Ollama (本地) | `http://localhost:11434/v1` | `llama3` |
+
+## 开发
+
+```bash
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 运行测试
+pytest
+
+# 代码检查
+ruff check .
+```
+
+## License
+
+MIT

git_weekly-0.2.0/git_weekly/__init__.py

@@ -0,0 +1,3 @@
+"""git-weekly: Generate weekly reports from Git commit history."""
+
+__version__ = "0.2.0"

git_weekly-0.2.0/git_weekly/__main__.py

@@ -0,0 +1,4 @@
+"""Allow running as: python -m git_weekly"""
+from .cli import main
+
+main()

git_weekly-0.2.0/git_weekly/analyzer.py

@@ -0,0 +1,218 @@
+"""Git log parsing and diff analysis."""
+
+from __future__ import annotations
+
+import re
+import subprocess
+from dataclasses import dataclass, field
+from datetime import datetime, timedelta
+from pathlib import Path
+
+COMMIT_SEPARATOR = "\x00"
+COMMIT_FORMAT = "%H%x00%an%x00%aI%x00%s"
+
+CATEGORY_PATTERNS: dict[str, dict[str, object]] = {
+    "feat": {
+        "keywords": ["add", "feat", "feature", "new", "implement", "support", "create"],
+        "label": "\U0001f680 新功能",
+    },
+    "fix": {
+        "keywords": ["fix", "bug", "patch", "resolve", "close", "repair", "correct"],
+        "label": "\U0001f41b Bug 修复",
+    },
+    "refactor": {
+        "keywords": ["refactor", "restructure", "reorganize", "clean", "simplify", "extract",
+                      "move", "rename", "optimize"],
+        "label": "\u267b\ufe0f 重构",
+    },
+    "docs": {
+        "keywords": ["doc", "readme", "comment", "changelog", "license"],
+        "label": "\U0001f4dd 文档",
+    },
+    "test": {
+        "keywords": ["test", "spec", "coverage", "mock", "assert"],
+        "label": "\U0001f9ea 测试",
+    },
+    "chore": {
+        "keywords": ["chore", "ci", "cd", "build", "deploy", "config", "deps", "bump",
+                      "upgrade", "update dep", "docker", "makefile", "lint"],
+        "label": "\U0001f527 工程化",
+    },
+    "style": {
+        "keywords": ["style", "format", "indent", "whitespace", "prettier", "eslint"],
+        "label": "\U0001f3a8 代码风格",
+    },
+    "other": {
+        "keywords": [],
+        "label": "\U0001f4e6 其他",
+    },
+}
+
+CATEGORY_ORDER: list[str] = ["feat", "fix", "refactor", "docs", "test", "chore", "style", "other"]
+
+
+@dataclass
+class CommitInfo:
+    hash: str
+    author: str
+    date: datetime
+    message: str
+    files_changed: int = 0
+    insertions: int = 0
+    deletions: int = 0
+    files: list[str] = field(default_factory=list)
+
+
+@dataclass
+class RepoStats:
+    repo_path: str
+    repo_name: str
+    commits: list[CommitInfo] = field(default_factory=list)
+    total_files_changed: int = 0
+    total_insertions: int = 0
+    total_deletions: int = 0
+
+    @property
+    def total_commits(self) -> int:
+        return len(self.commits)
+
+
+def _run_git(args: list[str], cwd: str) -> str:
+    result = subprocess.run(
+        ["git"] + args,
+        cwd=cwd,
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        raise RuntimeError(f"git command failed: git {' '.join(args)}\n{result.stderr.strip()}")
+    return result.stdout.strip()
+
+
+def get_git_user(repo_path: str) -> str:
+    try:
+        return _run_git(["config", "user.name"], cwd=repo_path)
+    except RuntimeError:
+        return ""
+
+
+def get_repo_name(repo_path: str) -> str:
+    path = Path(repo_path).resolve()
+    try:
+        remote = _run_git(["remote", "get-url", "origin"], cwd=repo_path)
+        name = remote.rstrip("/").split("/")[-1]
+        return name.removesuffix(".git")
+    except RuntimeError:
+        return path.name
+
+
+def parse_commits(
+    repo_path: str,
+    since: str,
+    until: str,
+    author: str | None = None,
+) -> RepoStats:
+    """Parse git log and return structured commit data."""
+    repo_path = str(Path(repo_path).resolve())
+    repo_name = get_repo_name(repo_path)
+
+    git_args = [
+        "log",
+        f"--since={since}",
+        f"--until={until}",
+        f"--format={COMMIT_FORMAT}",
+        "--numstat",
+    ]
+    if author:
+        git_args.append(f"--author={author}")
+
+    raw = _run_git(git_args, cwd=repo_path)
+    if not raw:
+        return RepoStats(repo_path=repo_path, repo_name=repo_name)
+
+    stats = RepoStats(repo_path=repo_path, repo_name=repo_name)
+    commits: list[CommitInfo] = []
+    current_commit: CommitInfo | None = None
+
+    for line in raw.split("\n"):
+        if not line:
+            continue
+
+        if COMMIT_SEPARATOR in line:
+            parts = line.split(COMMIT_SEPARATOR, 3)
+            if len(parts) == 4 and len(parts[0]) == 40:
+                if current_commit:
+                    commits.append(current_commit)
+                current_commit = CommitInfo(
+                    hash=parts[0],
+                    author=parts[1],
+                    date=datetime.fromisoformat(parts[2]),
+                    message=parts[3],
+                )
+                continue
+
+        if current_commit and "\t" in line:
+            parts = line.split("\t")
+            if len(parts) == 3:
+                added, deleted, filepath = parts
+                try:
+                    ins = int(added) if added != "-" else 0
+                    dels = int(deleted) if deleted != "-" else 0
+                    current_commit.insertions += ins
+                    current_commit.deletions += dels
+                    current_commit.files_changed += 1
+                    current_commit.files.append(filepath)
+                except ValueError:
+                    pass
+
+    if current_commit:
+        commits.append(current_commit)
+
+    stats.commits = commits
+    stats.total_files_changed = len({f for c in commits for f in c.files})
+    stats.total_insertions = sum(c.insertions for c in commits)
+    stats.total_deletions = sum(c.deletions for c in commits)
+
+    return stats
+
+
+def categorize_commit(commit: CommitInfo) -> str:
+    """Categorize a commit based on its message using keyword matching."""
+    msg = commit.message.lower()
+
+    prefix_match = re.match(r"^(\w+)[\(:]", msg)
+    if prefix_match:
+        prefix = prefix_match.group(1)
+        for cat_key in CATEGORY_PATTERNS:
+            if cat_key == "other":
+                continue
+            if prefix == cat_key or prefix in CATEGORY_PATTERNS[cat_key]["keywords"]:
+                return cat_key
+
+    extensions = {Path(f).suffix for f in commit.files}
+    if extensions & {".md", ".rst", ".txt"} and not (extensions - {".md", ".rst", ".txt"}):
+        return "docs"
+    if commit.files and all("test" in f.lower() or "spec" in f.lower() for f in commit.files):
+        return "test"
+
+    for cat_key, cat_info in CATEGORY_PATTERNS.items():
+        if cat_key == "other":
+            continue
+        for keyword in cat_info["keywords"]:
+            if keyword in msg:
+                return cat_key
+
+    return "other"
+
+
+def get_default_since() -> str:
+    """Return the Monday of the current week as YYYY-MM-DD."""
+    today = datetime.now()
+    monday = today - timedelta(days=today.weekday())
+    return monday.strftime("%Y-%m-%d")
+
+
+def get_default_until() -> str:
+    """Return tomorrow as YYYY-MM-DD to include today's commits."""
+    tomorrow = datetime.now() + timedelta(days=1)
+    return tomorrow.strftime("%Y-%m-%d")

git_weekly-0.2.0/git_weekly/cli.py

@@ -0,0 +1,129 @@
+"""Command-line interface for git-weekly."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+from .analyzer import get_default_since, get_default_until, get_git_user, parse_commits
+from .report import build_report, render_markdown, render_terminal
+
+
+def main():
+    """Generate weekly report from Git commit history."""
+    parser = argparse.ArgumentParser(
+        description="Generate weekly report from Git commit history.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""\
+examples:
+  git-weekly                                    # 当前仓库本周周报
+  git-weekly --since 2025-02-24 --until 2025-02-28
+  git-weekly --repo /path/to/project
+  git-weekly --repo ./proj-a --repo ./proj-b    # 多仓库聚合
+  git-weekly -o report.md                       # 输出 Markdown 文件
+  git-weekly --all-authors                      # 包含所有人的提交
+  git-weekly --ai                               # AI 智能总结
+  git-weekly --ai --base-url https://api.deepseek.com/v1  # 用 DeepSeek
+""",
+    )
+    parser.add_argument(
+        "--repo", "-r", action="append", default=None,
+        help="Git repository path (can specify multiple times, default: current directory)",
+    )
+    parser.add_argument(
+        "--since", "-s", default=None,
+        help="Start date YYYY-MM-DD (default: Monday of current week)",
+    )
+    parser.add_argument(
+        "--until", "-u", default=None,
+        help="End date YYYY-MM-DD (default: today)",
+    )
+    parser.add_argument(
+        "--author", "-a", default=None,
+        help="Filter by author name (default: git config user.name)",
+    )
+    parser.add_argument(
+        "--output", "-o", default=None,
+        help="Output to Markdown file instead of terminal",
+    )
+    parser.add_argument(
+        "--all-authors", action="store_true", default=False,
+        help="Include commits from all authors",
+    )
+    parser.add_argument(
+        "--ai", action="store_true", default=False,
+        help="Enable AI-powered summary (requires: pip install git-weekly[ai])",
+    )
+    parser.add_argument(
+        "--api-key", default=None,
+        help="LLM API key (or set GIT_WEEKLY_API_KEY env var)",
+    )
+    parser.add_argument(
+        "--base-url", default=None,
+        help="LLM API base URL (default: OpenAI; set for DeepSeek/Ollama/etc.)",
+    )
+    parser.add_argument(
+        "--model", default=None,
+        help="LLM model name (default: gpt-4o-mini)",
+    )
+
+    args = parser.parse_args()
+
+    repos = args.repo or ["."]
+    since = args.since or get_default_since()
+    until = args.until or get_default_until()
+    author = args.author
+
+    if not author and not args.all_authors:
+        first_repo = str(Path(repos[0]).resolve())
+        author = get_git_user(first_repo)
+        if not author:
+            print("Warning: could not detect git user, showing all authors", file=sys.stderr)
+            author = None
+
+    reports = []
+    for repo_path in repos:
+        resolved = str(Path(repo_path).resolve())
+        if not Path(resolved, ".git").exists():
+            print(f"Error: {repo_path} is not a git repository", file=sys.stderr)
+            sys.exit(1)
+
+        try:
+            stats = parse_commits(resolved, since, until, author if not args.all_authors else None)
+            report = build_report(stats, since, until)
+            reports.append(report)
+        except RuntimeError as e:
+            print(f"Error: {e}", file=sys.stderr)
+            sys.exit(1)
+
+    if not reports:
+        print("No repositories to analyze.", file=sys.stderr)
+        sys.exit(0)
+
+    if args.ai:
+        try:
+            from .llm import generate_summary, load_config
+
+            llm_cfg = load_config(
+                api_key=args.api_key,
+                base_url=args.base_url,
+                model=args.model,
+            )
+            print("Generating AI summary...", file=sys.stderr)
+            summary = generate_summary(reports, llm_cfg)
+            for report in reports:
+                report.ai_summary = summary
+        except RuntimeError as e:
+            print(f"AI summary failed: {e}", file=sys.stderr)
+
+    if args.output:
+        md = render_markdown(reports)
+        Path(args.output).write_text(md, encoding="utf-8")
+        print(f"Report saved to {args.output}")
+    else:
+        render_terminal(reports)
+
+
+if __name__ == "__main__":
+    main()

git_weekly-0.2.0/git_weekly/llm.py

@@ -0,0 +1,153 @@
+"""LLM-powered weekly report summarization (OpenAI-compatible API)."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .report import CategorizedReport
+
+try:
+    import tomllib  # Python 3.11+
+except ModuleNotFoundError:
+    try:
+        import tomli as tomllib  # type: ignore[no-redef]
+    except ModuleNotFoundError:
+        tomllib = None  # type: ignore[assignment]
+
+CONFIG_DIR = Path.home() / ".config" / "git-weekly"
+CONFIG_FILE = CONFIG_DIR / "config.toml"
+
+DEFAULT_BASE_URL = "https://api.openai.com/v1"
+DEFAULT_MODEL = "gpt-4o-mini"
+
+SYSTEM_PROMPT = """\
+你是一位专业的技术周报撰写助手。根据提供的 Git commit 数据，写一段 3-5 句话的工作总结。
+
+要求：
+- 用中文输出
+- 像开发者写给团队看的周报，语气专业但不生硬
+- 突出本周重点工作和技术亮点，不要逐条罗列 commit
+- 如果有 bug fix，简要提及稳定性改进
+- 如果有重构，说明技术改进的意义
+- 不要编造不存在的内容，只基于提供的数据总结
+"""
+
+
+@dataclass
+class LLMConfig:
+    api_key: str
+    base_url: str = DEFAULT_BASE_URL
+    model: str = DEFAULT_MODEL
+
+
+def _load_config_file() -> dict[str, str]:
+    """Load config from ~/.config/git-weekly/config.toml if it exists."""
+    if tomllib is None or not CONFIG_FILE.exists():
+        return {}
+    try:
+        with open(CONFIG_FILE, "rb") as f:
+            data = tomllib.load(f)
+        return data.get("ai", {})
+    except Exception:
+        return {}
+
+
+def load_config(
+    *,
+    api_key: str | None = None,
+    base_url: str | None = None,
+    model: str | None = None,
+) -> LLMConfig:
+    """Build LLM config from CLI args > env vars > config file."""
+    file_cfg = _load_config_file()
+
+    resolved_key = (
+        api_key
+        or os.environ.get("GIT_WEEKLY_API_KEY")
+        or file_cfg.get("api_key", "")
+    )
+    if not resolved_key:
+        raise RuntimeError(
+            "未找到 API Key。请通过以下任一方式配置：\n"
+            "  1. --api-key 参数\n"
+            "  2. 环境变量 GIT_WEEKLY_API_KEY\n"
+            f"  3. 配置文件 {CONFIG_FILE}\n\n"
+            "配置文件示例：\n"
+            "  [ai]\n"
+            '  api_key = "sk-xxx"\n'
+            '  base_url = "https://api.openai.com/v1"\n'
+            '  model = "gpt-4o-mini"'
+        )
+
+    resolved_url = (
+        base_url
+        or os.environ.get("GIT_WEEKLY_BASE_URL")
+        or file_cfg.get("base_url", "")
+        or DEFAULT_BASE_URL
+    )
+    resolved_model = (
+        model
+        or os.environ.get("GIT_WEEKLY_MODEL")
+        or file_cfg.get("model", "")
+        or DEFAULT_MODEL
+    )
+
+    return LLMConfig(api_key=resolved_key, base_url=resolved_url, model=resolved_model)
+
+
+def _build_prompt(reports: list[CategorizedReport]) -> str:
+    """Serialize reports into structured text for the LLM."""
+    from .analyzer import CATEGORY_PATTERNS
+
+    parts: list[str] = []
+    for report in reports:
+        parts.append(f"仓库: {report.stats.repo_name}")
+        parts.append(f"时间范围: {report.since} ~ {report.until}")
+        parts.append(f"提交次数: {report.stats.total_commits}")
+        parts.append(f"文件变更: {report.stats.total_files_changed} 个文件")
+        parts.append(f"新增: +{report.stats.total_insertions} 行, 删除: -{report.stats.total_deletions} 行")
+        parts.append("")
+
+        for cat_key, commits in report.categories.items():
+            label = CATEGORY_PATTERNS.get(cat_key, {}).get("label", cat_key)
+            parts.append(f"【{label}】")
+            for c in commits:
+                file_hint = ""
+                if c.files:
+                    top_files = c.files[:3]
+                    file_hint = f" ({', '.join(top_files)})"
+                parts.append(f"  - {c.message}{file_hint}")
+            parts.append("")
+
+    return "\n".join(parts)
+
+
+def generate_summary(reports: list[CategorizedReport], config: LLMConfig) -> str:
+    """Call OpenAI-compatible API to generate a narrative summary."""
+    try:
+        from openai import OpenAI
+    except ImportError:
+        raise RuntimeError(
+            "AI 功能需要安装 openai 库。请运行:\n"
+            '  pip install "git-weekly[ai]"'
+        )
+
+    client = OpenAI(api_key=config.api_key, base_url=config.base_url)
+
+    user_content = _build_prompt(reports)
+
+    response = client.chat.completions.create(
+        model=config.model,
+        messages=[
+            {"role": "system", "content": SYSTEM_PROMPT},
+            {"role": "user", "content": user_content},
+        ],
+        temperature=0.3,
+        max_tokens=1024,
+    )
+
+    return response.choices[0].message.content or ""

git_weekly-0.2.0/git_weekly/report.py

@@ -0,0 +1,147 @@
+"""Report generation and formatting."""
+
+from __future__ import annotations
+
+from collections import defaultdict
+from dataclasses import dataclass
+from datetime import datetime
+
+from .analyzer import CATEGORY_ORDER, CATEGORY_PATTERNS, CommitInfo, RepoStats, categorize_commit
+
+
+@dataclass
+class CategorizedReport:
+    """Commits grouped by category with summary info."""
+    categories: dict[str, list[CommitInfo]]
+    stats: RepoStats
+    since: str
+    until: str
+    ai_summary: str | None = None
+
+
+def build_report(stats: RepoStats, since: str, until: str) -> CategorizedReport:
+    """Categorize commits and build a structured report."""
+    categories: dict[str, list[CommitInfo]] = defaultdict(list)
+    for commit in stats.commits:
+        cat = categorize_commit(commit)
+        categories[cat].append(commit)
+    return CategorizedReport(
+        categories=dict(categories),
+        stats=stats,
+        since=since,
+        until=until,
+    )
+
+
+def _format_date_range(since: str, until: str) -> str:
+    try:
+        s = datetime.strptime(since, "%Y-%m-%d")
+        u = datetime.strptime(until, "%Y-%m-%d")
+        return f"{s.month:02d}/{s.day:02d} - {u.month:02d}/{u.day:02d}"
+    except ValueError:
+        return f"{since} ~ {until}"
+
+
+def render_terminal(reports: list[CategorizedReport]) -> None:
+    """Render reports to terminal with ANSI colors."""
+    BOLD = "\033[1m"
+    CYAN = "\033[36m"
+    GREEN = "\033[32m"
+    RED = "\033[31m"
+    DIM = "\033[2m"
+    RESET = "\033[0m"
+
+    for report in reports:
+        date_range = _format_date_range(report.since, report.until)
+        title = f" \U0001f4cb 周报 ({date_range})"
+        if len(reports) > 1:
+            title += f" — {report.stats.repo_name}"
+
+        width = 50
+        print()
+        print(f"{CYAN}{'─' * width}{RESET}")
+        print(f"{BOLD}{CYAN}{title}{RESET}")
+        print(f"{CYAN}{'─' * width}{RESET}")
+
+        if not report.stats.commits:
+            print(f"\n  {DIM}这段时间没有提交记录{RESET}\n")
+            continue
+
+        print(f"\n{BOLD}本周工作{RESET}\n")
+
+        for cat_key in CATEGORY_ORDER:
+            if cat_key not in report.categories:
+                continue
+            commits = report.categories[cat_key]
+            label = CATEGORY_PATTERNS[cat_key]["label"]
+            print(f"  {BOLD}{label}{RESET}")
+            for commit in commits:
+                msg = commit.message
+                if len(msg) > 72:
+                    msg = msg[:72] + "..."
+                print(f"    • {msg}")
+            print()
+
+        print(f"{BOLD}代码统计{RESET}\n")
+        print(f"  提交次数  {BOLD}{report.stats.total_commits}{RESET} 次")
+        print(f"  文件变更  {BOLD}{report.stats.total_files_changed}{RESET} 个文件")
+        print(f"  新增行数  {GREEN}+{report.stats.total_insertions}{RESET}")
+        print(f"  删除行数  {RED}-{report.stats.total_deletions}{RESET}")
+        print()
+
+        if report.ai_summary:
+            print(f"{BOLD}\U0001f916 AI \u603b\u7ed3{RESET}\n")
+            for line in report.ai_summary.strip().splitlines():
+                print(f"  {line}")
+            print()
+
+
+def render_markdown(reports: list[CategorizedReport]) -> str:
+    """Render reports as Markdown string."""
+    lines: list[str] = []
+
+    for report in reports:
+        date_range = _format_date_range(report.since, report.until)
+        heading = f"周报 ({date_range})"
+        if len(reports) > 1:
+            heading += f" — {report.stats.repo_name}"
+
+        lines.append(f"# {heading}")
+        lines.append("")
+
+        if not report.stats.commits:
+            lines.append("_这段时间没有提交记录_")
+            lines.append("")
+            continue
+
+        lines.append("## 本周工作")
+        lines.append("")
+
+        for cat_key in CATEGORY_ORDER:
+            if cat_key not in report.categories:
+                continue
+            commits = report.categories[cat_key]
+            label = CATEGORY_PATTERNS[cat_key]["label"]
+            lines.append(f"### {label}")
+            lines.append("")
+            for commit in commits:
+                lines.append(f"- {commit.message}")
+            lines.append("")
+
+        lines.append("## 代码统计")
+        lines.append("")
+        lines.append("| 指标 | 数据 |")
+        lines.append("|------|------|")
+        lines.append(f"| 提交次数 | {report.stats.total_commits} 次 |")
+        lines.append(f"| 文件变更 | {report.stats.total_files_changed} 个文件 |")
+        lines.append(f"| 新增行数 | +{report.stats.total_insertions} |")
+        lines.append(f"| 删除行数 | -{report.stats.total_deletions} |")
+        lines.append("")
+
+        if report.ai_summary:
+            lines.append("## \U0001f916 AI \u603b\u7ed3")
+            lines.append("")
+            lines.append(report.ai_summary.strip())
+            lines.append("")
+
+    return "\n".join(lines)

git_weekly-0.2.0/git_weekly.egg-info/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: git-weekly
+Version: 0.2.0
+Summary: Generate weekly reports from Git commit history, with optional AI summary
+Author: woaichilajiaochaorou
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/woaichilajiaochaorou/git-weekly
+Project-URL: Repository, https://github.com/woaichilajiaochaorou/git-weekly
+Project-URL: Issues, https://github.com/woaichilajiaochaorou/git-weekly/issues
+Keywords: git,weekly,report,changelog,productivity,ai,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: ai
+Requires-Dist: openai>=1.0; extra == "ai"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Dynamic: license-file
+
+# git-weekly
+
+从 Git 提交记录自动生成周报，支持 AI 智能总结。告别"我这周干了啥"的灵魂拷问。
+
+## 功能
+
+- 扫描指定时间范围内的所有 Git 提交
+- 自动分析 diff，归类为：新功能、Bug 修复、重构、文档、测试等
+- 生成结构化周报（Markdown / 终端输出）
+- 支持多仓库聚合
+- 代码统计（新增 / 删除 / 修改的文件数）
+- **AI 智能总结**：接入 OpenAI 兼容 API，自动生成连贯的工作总结
+
+## 安装
+
+```bash
+pip install git-weekly
+```
+
+如需 AI 总结功能：
+
+```bash
+pip install "git-weekly[ai]"
+```
+
+或从源码安装：
+
+```bash
+git clone https://github.com/woaichilajiaochaorou/git-weekly.git
+cd git-weekly
+pip install -e ".[ai]"
+```
+
+## 使用
+
+```bash
+# 生成本周周报（默认当前仓库）
+git-weekly
+
+# 指定时间范围
+git-weekly --since "2025-02-24" --until "2025-02-28"
+
+# 指定仓库路径
+git-weekly --repo /path/to/your/project
+
+# 多仓库聚合
+git-weekly --repo ./project-a --repo ./project-b
+
+# 输出为 Markdown 文件
+git-weekly -o weekly-report.md
+
+# 指定作者（默认为 git config 中的用户）
+git-weekly --author "your-name"
+
+# AI 智能总结（需要安装 git-weekly[ai]）
+git-weekly --ai
+git-weekly --ai --api-key sk-xxx
+git-weekly --ai --base-url https://api.deepseek.com/v1 --model deepseek-chat
+```
+
+## 输出示例
+
+```
+──────────────────────────────────────────────────
+ 📋 周报 (02/24 - 02/28)
+──────────────────────────────────────────────────
+
+本周工作
+
+  🚀 新功能
+    • 用户登录模块：实现 JWT 鉴权
+    • 添加文件上传接口，支持图片和 PDF
+
+  🐛 Bug 修复
+    • 修复分页查询在最后一页返回空数据的问题
+    • 修复并发请求下 session 丢失
+
+  ♻️ 重构
+    • 将数据库操作抽取为 Repository 层
+
+  📝 文档
+    • 更新 API 接口文档
+
+代码统计
+
+  提交次数  12 次
+  文件变更  23 个文件
+  新增行数  +847
+  删除行数  -312
+
+🤖 AI 总结
+
+  本周主要完成了用户登录模块的 JWT 鉴权实现和文件上传接口开发，
+  同时修复了分页查询和并发 session 相关的两个稳定性问题。
+  技术层面对数据库操作进行了 Repository 层抽取，提升了代码可维护性。
+```
+
+## AI 配置
+
+API Key 支持三种配置方式（优先级从高到低）：
+
+**1. 命令行参数**
+
+```bash
+git-weekly --ai --api-key sk-xxx
+```
+
+**2. 环境变量**
+
+```bash
+export GIT_WEEKLY_API_KEY=sk-xxx
+export GIT_WEEKLY_BASE_URL=https://api.deepseek.com/v1  # 可选
+export GIT_WEEKLY_MODEL=deepseek-chat                    # 可选
+```
+
+**3. 配置文件** `~/.config/git-weekly/config.toml`
+
+```toml
+[ai]
+api_key = "sk-xxx"
+base_url = "https://api.openai.com/v1"
+model = "gpt-4o-mini"
+```
+
+### 支持的 LLM 服务
+
+任何兼容 OpenAI API 的服务都可以使用，例如：
+
+| 服务 | base_url | 推荐模型 |
+|------|----------|----------|
+| OpenAI | `https://api.openai.com/v1` (默认) | `gpt-4o-mini` |
+| DeepSeek | `https://api.deepseek.com/v1` | `deepseek-chat` |
+| 通义千问 | `https://dashscope.aliyuncs.com/compatible-mode/v1` | `qwen-plus` |
+| Ollama (本地) | `http://localhost:11434/v1` | `llama3` |
+
+## 开发
+
+```bash
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 运行测试
+pytest
+
+# 代码检查
+ruff check .
+```
+
+## License
+
+MIT

git_weekly-0.2.0/git_weekly.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+git_weekly/__init__.py
+git_weekly/__main__.py
+git_weekly/analyzer.py
+git_weekly/cli.py
+git_weekly/llm.py
+git_weekly/report.py
+git_weekly.egg-info/PKG-INFO
+git_weekly.egg-info/SOURCES.txt
+git_weekly.egg-info/dependency_links.txt
+git_weekly.egg-info/entry_points.txt
+git_weekly.egg-info/requires.txt
+git_weekly.egg-info/top_level.txt

git_weekly-0.2.0/git_weekly.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

git_weekly-0.2.0/git_weekly.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+git-weekly = git_weekly.cli:main

git_weekly-0.2.0/git_weekly.egg-info/requires.txt

@@ -0,0 +1,7 @@
+
+[ai]
+openai>=1.0
+
+[dev]
+pytest>=7.0
+ruff>=0.4

git_weekly-0.2.0/git_weekly.egg-info/top_level.txt

@@ -0,0 +1 @@
+git_weekly

git_weekly-0.2.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "git-weekly"
+version = "0.2.0"
+description = "Generate weekly reports from Git commit history, with optional AI summary"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+dependencies = []
+authors = [
+    {name = "woaichilajiaochaorou"},
+]
+keywords = ["git", "weekly", "report", "changelog", "productivity", "ai", "llm"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+
+[project.urls]
+Homepage = "https://github.com/woaichilajiaochaorou/git-weekly"
+Repository = "https://github.com/woaichilajiaochaorou/git-weekly"
+Issues = "https://github.com/woaichilajiaochaorou/git-weekly/issues"
+
+[project.optional-dependencies]
+ai = [
+    "openai>=1.0",
+]
+dev = [
+    "pytest>=7.0",
+    "ruff>=0.4",
+]
+
+[project.scripts]
+git-weekly = "git_weekly.cli:main"
+
+[tool.ruff]
+line-length = 100
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

git_weekly-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

git_weekly-0.2.0/setup.py

@@ -0,0 +1,5 @@
+# Thin shim for editable installs with pip < 21.3 (no PEP 660 support).
+# All config lives in pyproject.toml.
+from setuptools import setup
+
+setup()