add some log & rename feature for join-issue

Author: Sunrisepeak

src/components/scan_join_issues.py

@@ -15,10 +15,11 @@
     add_user_to_team,
     is_user_in_team,
     list_open_join_issues,
+    update_issue_title,
 )
 from libs.utils import load_simple_yaml
 
-def scan():
+def scan(verbose=False):
     # Load configuration first
     config_path = Path(__file__).parent.parent / "config" / "join-config.yml"
     cfg = load_simple_yaml(str(config_path))
@@ -39,44 +40,98 @@ def scan():
 
     teams_cfg = cfg.get("teams") or {}
 
+    if verbose:
+        print(f"扫描仓库: {repo}")
+        print(f"组织: {org}")
+        print(f"配置的团队: {list(teams_cfg.keys())}")
+        print()
+
     issues = list_open_join_issues(token, repo)
 
+    if verbose:
+        print(f"找到 {len(issues)} 个待处理的加入请求\n")
+
     for it in issues:
         issue_number = it["number"]
         author = it["user"]["login"]
+        issue_title = it["title"]
+
+        if verbose:
+            print(f"处理 Issue #{issue_number} - 作者: @{author}")
+
+        # Replace @<your-username> with actual username in title
+        if "@<your-username>" in issue_title:
+            new_title = issue_title.replace("@<your-username>", f"@{author}")
+            code, _ = update_issue_title(token, repo, issue_number, new_title)
+            if code in (200, 201):
+                if verbose:
+                    print(f"  ✓ 更新标题: {issue_title} → {new_title}")
+            else:
+                if verbose:
+                    print(f"  ✗ 更新标题失败 (HTTP {code})")
 
         target = get_target_from_labels(it)
         if not target or target not in teams_cfg:
+            if verbose:
+                print(f"  ⊘ 跳过: 未找到有效的目标团队标签 (target={target})\n")
             continue
 
         team_cfg = teams_cfg[target]
         team_slug = team_cfg.get("team_slug", "") or ""
 
+        if verbose:
+            print(f"  目标团队: {target} (team_slug={team_slug})")
+
         # If not org member yet, remind and keep open
         if not is_org_member(token, org, author):
+            if verbose:
+                print(f"  ⊘ 跳过: @{author} 还不是 @{org} 成员")
             if has_label(it, "invited"):
+                if verbose:
+                    print(f"  → 发送提醒评论")
                 comment(token, repo, issue_number,
                         f"@{author} 温馨提示：你还未加入 **@{org}**。请在这里接受邀请：\n\nhttps://github.com/orgs/{org}/invitation")
+            if verbose:
+                print()
             continue
 
+        if verbose:
+            print(f"  ✓ @{author} 已是组织成员")
+
         # If needs team, ensure team membership
         if team_slug:
             if not is_user_in_team(token, org, team_slug, author):
+                if verbose:
+                    print(f"  → 添加到团队 @{org}/{team_slug}")
                 code, payload = add_user_to_team(token, org, team_slug, author)
                 if code not in (200, 201):
                     # Can't add team for some reason; leave a note and continue
+                    if verbose:
+                        print(f"  ✗ 添加团队失败 (HTTP {code})")
                     comment(token, repo, issue_number,
                             f"@{author} 已检测到你已加入 **@{org}**，但加入 **@{org}/{team_slug}** 仍失败，将稍后重试。\n\n"
                             f"HTTP {code}\n\n```json\n{json.dumps(payload, ensure_ascii=False, indent=2)}\n```")
+                    if verbose:
+                        print()
                     continue
+                if verbose:
+                    print(f"  ✓ 成功添加到团队")
+            else:
+                if verbose:
+                    print(f"  ✓ 已在团队 @{org}/{team_slug} 中")
 
         # Now complete: comment + close
+        if verbose:
+            print(f"  ✓ 处理完成，关闭 Issue")
         if team_slug:
             comment(token, repo, issue_number, f"@{author} ✅ 已确认你已加入 **@{org}** 并加入 **@{org}/{team_slug}**，本 Issue 将关闭。")
         else:
             comment(token, repo, issue_number, f"@{author} ✅ 已确认你已加入 **@{org}**，本 Issue 将关闭。")
 
         close_issue(token, repo, issue_number)
 
+        if verbose:
+            print()
+
 if __name__ == "__main__":
     scan()

src/components/task_checker.py

@@ -46,7 +46,7 @@ def get_hours_since_update(issue):
     return delta.total_seconds() / 3600
 
 
-def check_task_timeout(token, repo, issue, config):
+def check_task_timeout(token, repo, issue, config, verbose=False):
     """
     Check if a task issue has timed out and send reminder if needed.
 
@@ -55,24 +55,34 @@ def check_task_timeout(token, repo, issue, config):
         repo: Repository in "owner/name" format
         issue: Issue object from GitHub API
         config: Configuration dictionary
+        verbose: Enable verbose logging
 
     Returns:
         True if reminder was sent, False otherwise
     """
     # Get priority from labels
     priority = get_label_value(issue, config.get("priority_pattern", r"^P([012])$"))
     if not priority:
+        if verbose:
+            print(f"  ⊘ 跳过: 未找到优先级标签")
         return False
 
     # Get timeout hours for this priority
     timeout_key = f"P{priority}"
     timeout_hours = config.get("timeout_hours", {}).get(timeout_key)
     if timeout_hours is None:
+        if verbose:
+            print(f"  ⊘ 跳过: {timeout_key} 未配置超时时间")
         return False
 
     # Check if issue has timed out
     hours_since_update = get_hours_since_update(issue)
+    if verbose:
+        print(f"  优先级: {timeout_key}, 超时阈值: {timeout_hours}h, 距上次更新: {hours_since_update:.1f}h")
+
     if hours_since_update < timeout_hours:
+        if verbose:
+            print(f"  ⊘ 跳过: 未超时")
         return False
 
     # Get assignees to mention
@@ -112,6 +122,8 @@ def check_task_timeout(token, repo, issue, config):
     )
 
     # Add comment
+    if verbose:
+        print(f"  ✓ 发送超时提醒")
     comment(token, repo, issue_number, reminder_msg)
 
     # Optional: Add a label to mark as reminded
@@ -122,14 +134,15 @@ def check_task_timeout(token, repo, issue, config):
     return True
 
 
-def scan_repo_tasks(token, repo, config):
+def scan_repo_tasks(token, repo, config, verbose=False):
     """
     Scan a single repository for task issues that need reminders.
 
     Args:
         token: GitHub API token
         repo: Repository in "owner/name" format
         config: Configuration dictionary
+        verbose: Enable verbose logging
 
     Returns:
         Number of reminders sent
@@ -153,33 +166,45 @@ def scan_repo_tasks(token, repo, config):
         print(f"Error searching {repo}: {e}")
         return 0
 
+    if verbose:
+        print(f"找到 {len(issues)} 个待检查的任务 Issue\n")
+
     # Filter issues by priority and check for timeouts
     priority_filter = config.get("priorities_to_check", ["P0", "P1", "P2"])
     priority_pattern = config.get("priority_pattern", r"^P([012])$")
 
     reminders_sent = 0
     for issue in issues:
+        if verbose:
+            print(f"检查 Issue #{issue['number']}: {issue['title']}")
+
         # Check if issue has one of the target priorities
         priority = get_label_value(issue, priority_pattern)
         if not priority or f"P{priority}" not in priority_filter:
+            if verbose:
+                print(f"  ⊘ 跳过: 优先级 P{priority} 不在检查范围 {priority_filter}\n")
             continue
 
         # Check if timeout and send reminder
-        if check_task_timeout(token, repo, issue, config):
+        if check_task_timeout(token, repo, issue, config, verbose=verbose):
             reminders_sent += 1
-            print(f"Sent reminder for {repo}#{issue['number']}: {issue['title']}")
+            print(f"✓ 发送提醒 {repo}#{issue['number']}: {issue['title']}")
+
+        if verbose:
+            print()
 
     return reminders_sent
 
 
-def scan_org_tasks(token, org, config):
+def scan_org_tasks(token, org, config, verbose=False):
     """
     Scan all repositories in an organization for task issues.
 
     Args:
         token: GitHub API token
         org: Organization name
         config: Configuration dictionary
+        verbose: Enable verbose logging
 
     Returns:
         Number of reminders sent
@@ -191,6 +216,9 @@ def scan_org_tasks(token, org, config):
         print(f"Error listing repos for {org}: {e}")
         return 0
 
+    if verbose:
+        print(f"组织 {org} 中找到 {len(repos)} 个仓库\n")
+
     # Scan each repository
     total_reminders = 0
     for repo_obj in repos:
@@ -199,19 +227,27 @@ def scan_org_tasks(token, org, config):
         # Check if repo should be excluded
         exclude_repos = config.get("exclude_repos", [])
         if repo_full_name in exclude_repos or repo_obj["name"] in exclude_repos:
-            print(f"Skipping excluded repo: {repo_full_name}")
+            if verbose:
+                print(f"⊘ 跳过排除的仓库: {repo_full_name}\n")
+            else:
+                print(f"Skipping excluded repo: {repo_full_name}")
             continue
 
-        print(f"Scanning {repo_full_name}...")
-        reminders = scan_repo_tasks(token, repo_full_name, config)
+        print(f"扫描仓库: {repo_full_name}")
+        reminders = scan_repo_tasks(token, repo_full_name, config, verbose=verbose)
         total_reminders += reminders
+        if verbose:
+            print()
 
     return total_reminders
 
 
-def check():
+def check(verbose=False):
     """
     Main function to check tasks and send reminders based on configuration.
+
+    Args:
+        verbose: Enable verbose logging
     """
     # Load configuration
     config_path = Path(__file__).parent.parent / "config" / "task-checker.yml"
@@ -225,25 +261,32 @@ def check():
     # Get scan scope
     scan_mode = cfg.get("scan_mode", "repo")  # "repo" or "org"
 
+    if verbose:
+        print(f"扫描模式: {scan_mode}")
+        print(f"任务标签: {cfg.get('task_label', 'Task')}")
+        print(f"检查优先级: {cfg.get('priorities_to_check', ['P0', 'P1', 'P2'])}")
+        print(f"超时配置: {cfg.get('timeout_hours', {})}")
+        print()
+
     if scan_mode == "org":
         # Scan entire organization
         org = cfg.get("org", "").strip()
         if not org:
             raise ValueError("Organization (org) must be set in config when scan_mode is 'org'")
 
-        print(f"Scanning organization: {org}")
-        reminders_sent = scan_org_tasks(token, org, cfg)
-        print(f"\nTotal reminders sent: {reminders_sent}")
+        print(f"扫描组织: {org}")
+        reminders_sent = scan_org_tasks(token, org, cfg, verbose=verbose)
+        print(f"\n总计发送提醒: {reminders_sent}")
 
     elif scan_mode == "repo":
         # Scan single repository
         repo = cfg.get("repo", "").strip()
         if not repo:
             raise ValueError("Repository (repo) must be set in config when scan_mode is 'repo'")
 
-        print(f"Scanning repository: {repo}")
-        reminders_sent = scan_repo_tasks(token, repo, cfg)
-        print(f"\nTotal reminders sent: {reminders_sent}")
+        print(f"扫描仓库: {repo}")
+        reminders_sent = scan_repo_tasks(token, repo, cfg, verbose=verbose)
+        print(f"\n总计发送提醒: {reminders_sent}")
 
     else:
         raise ValueError(f"Invalid scan_mode: {scan_mode}. Must be 'repo' or 'org'")

src/libs/github_client.py

@@ -65,6 +65,21 @@ def close_issue(token, repo, issue_number):
     """
     gh("PATCH", f"repos/{repo}/issues/{issue_number}", token, {"state": "closed"})
 
+def update_issue_title(token, repo, issue_number, new_title):
+    """
+    Update the title of a GitHub issue.
+
+    Args:
+        token: GitHub API token
+        repo: Repository in "owner/name" format
+        issue_number: Issue number
+        new_title: New title for the issue
+
+    Returns:
+        Tuple of (status_code, response_payload)
+    """
+    return gh("PATCH", f"repos/{repo}/issues/{issue_number}", token, {"title": new_title})
+
 def has_label(issue, name):
     """
     Check if an issue has a specific label.

src/main.py

@@ -73,7 +73,7 @@ def main():
         print("\n[1/2] Running Join Issues Scanner...")
         print("-" * 60)
         try:
-            scan_join_issues()
+            scan_join_issues(verbose=args.verbose)
             print("✓ Join Issues Scanner completed successfully")
         except Exception as e:
             error_msg = f"✗ Join Issues Scanner failed: {e}"
@@ -87,7 +87,7 @@ def main():
         print("\n[2/2] Running Task Checker...")
         print("-" * 60)
         try:
-            check_tasks()
+            check_tasks(verbose=args.verbose)
             print("✓ Task Checker completed successfully")
         except Exception as e:
             error_msg = f"✗ Task Checker failed: {e}"