Merge branch 'main' into memory/cron

Author: ployts

.github/workflows/issue-welcome.yml

@@ -0,0 +1,215 @@
+name: Issue Welcome Bot
+
+on:
+  issues:
+    types: [opened]
+
+permissions:
+  issues: write
+
+jobs:
+  welcome:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Welcome Issue Author
+        uses: actions/github-script@v7
+        with:
+          script: |
+            // Helper function for English ordinal suffix (1st, 2nd, 3rd, 4th...)
+            function getOrdinalSuffix(num) {
+              const j = num % 10;
+              const k = num % 100;
+              if (j === 1 && k !== 11) return 'st';
+              if (j === 2 && k !== 12) return 'nd';
+              if (j === 3 && k !== 13) return 'rd';
+              return 'th';
+            }
+
+            const author = context.payload.issue.user.login;
+            const issueNumber = context.payload.issue.number;
+            const issueTitle = context.payload.issue.title;
+            const issueBody = context.payload.issue.body || '';
+
+            // Check if Chinese characters exist in title
+            const hasChinese = /[\u4e00-\u9fff]/.test(issueTitle);
+
+            // Count user's total issues in this repo using search API
+            let issueCount = 0;
+            let hasValidIssueCount = false;
+            let isFirstIssue = false;
+
+            try {
+              const { data: searchResult } = await github.rest.search.issuesAndPullRequests({
+                q: `repo:${context.repo.owner}/${context.repo.repo} type:issue author:${author}`,
+              });
+              issueCount = searchResult.total_count;
+              hasValidIssueCount = true;
+              isFirstIssue = issueCount === 1;
+            } catch (err) {
+              console.log(`Could not get issue count for ${author}, will skip count display`);
+              hasValidIssueCount = false;
+            }
+
+            // Check if user has starred the repo by listing user's starred
+            // repos
+            let hasStarred = false;
+            try {
+              const fullRepoName = `${context.repo.owner}/${context.repo.repo}`;
+              let page = 1;
+              let found = false;
+
+              while (page <= 10 && !found) {
+                const { data: starredRepos } = await github.rest.activity.listReposStarredByUser({
+                  username: author,
+                  per_page: 100,
+                  page: page
+                });
+
+                if (starredRepos.length === 0) break;
+
+                found = starredRepos.some(repo => repo.full_name === fullRepoName);
+                if (found) {
+                  hasStarred = true;
+                  console.log(`User ${author} has starred the repo`);
+                  break;
+                }
+
+                page++;
+              }
+
+              if (!found) {
+                console.log(`User ${author} has not starred the repo`);
+              }
+            } catch (error) {
+              console.log(
+                `Could not verify star status for ${author}:`,
+                error.message
+              );
+            }
+
+            // Check if this is a bug report by title or label
+            // Match "bug", "bugs", or "[Bug]:" prefix (case-insensitive)
+            const titleContainsBug = /\bbug(s)?\b/i.test(issueTitle) || /^\s*\[bug\]\s*:/i.test(issueTitle);
+            const labels = context.payload.issue.labels.map(label => label.name);
+            const hasBugLabel = labels.some(name => name && name.toLowerCase() === 'bug');
+            const isBugRelated = titleContainsBug || hasBugLabel;
+
+            // Check if issue uses bug report template
+            const usedBugTemplate = issueBody.includes('## CoPaw Version') ||
+                                    issueBody.includes('## Environment') ||
+                                    issueBody.includes('## Steps to Reproduce');
+
+            // If bug-related but template not used, need to remind
+            const needBugTemplateReminder = isBugRelated && !usedBugTemplate;
+
+            // Build comment
+            let comment = '';
+
+            if (hasChinese) {
+              // Bilingual response with logo
+              comment = `<div align="center">\n\n`;
+              comment += `<img src="https://copaw.agentscope.io/copaw_ip.svg" width="80" height="80" />\n\n`;
+              comment += `## 欢迎来到 CoPaw! 🐾 Welcome to CoPaw!\n\n`;
+              comment += `</div>\n\n`;
+
+              if (hasValidIssueCount) {
+                if (isFirstIssue) {
+                  comment += `你好 @${author}，感谢你提交的第一个 issue！\n`;
+                  comment += `Hi @${author}, thank you for your first issue!\n\n`;
+                } else {
+                  comment += `你好 @${author}，这是你提交的第 ${issueCount} 个 issue。\n`;
+                  comment += `Hi @${author}, this is your ${issueCount}${getOrdinalSuffix(issueCount)} issue.\n\n`;
+                }
+              } else {
+                comment += `你好 @${author}，感谢你提交 issue！\n`;
+                comment += `Hi @${author}, thank you for your issue!\n\n`;
+              }
+
+              if (needBugTemplateReminder) {
+                comment += `### 📋 关于 Bug Report 模板 / About Bug Report Template\n\n`;
+                comment += `我们注意到你的 issue 似乎与 bug 相关，但没有使用 Bug Report 模板。为了帮助我们更快地定位和修复问题，请确保你的 bug report 包含以下信息：\n`;
+                comment += `We noticed your issue seems to be bug-related, but doesn't use the Bug Report template. To help us reproduce and fix the issue faster, please make sure your bug report includes:\n\n`;
+                comment += `- ✅ **CoPaw 版本 / Version** (使用 \`copaw --version\` 查看)\n`;
+                comment += `- ✅ **操作系统 / OS** (macOS/Linux/Windows 及版本)\n`;
+                comment += `- ✅ **复现步骤 / Steps to Reproduce** (详细的步骤)\n`;
+                comment += `- ✅ **实际结果 vs 预期结果 / Actual vs Expected**\n`;
+                comment += `- ✅ **日志或截图 / Logs or Screenshots**\n\n`;
+                comment += `你可以编辑 issue 来补充这些信息。如果你的 issue 缺少这些信息，维护者可能需要额外时间来询问细节。\n`;
+                comment += `You can edit your issue to add this information. Missing information may require maintainers to ask follow-up questions.\n\n`;
+              }
+
+              comment += `我们会尽快查看你的 issue。感谢你对 CoPaw 的支持！\n`;
+              comment += `We'll review your issue soon. Thank you for supporting CoPaw!\n\n`;
+
+              // Internationalization reminder
+              comment += `---\n\n`;
+              comment += `> **🌍 关于国际化 / About Internationalization**\n`;
+              comment += `> \n`;
+              comment += `> CoPaw 是一个国际化的开源社区。我们建议使用英文提交 issue，这样可以让更多的开发者参与讨论和贡献。\n`;
+              comment += `> \n`;
+              comment += `> CoPaw is an international open-source community. We recommend using English for issues so that more developers worldwide can participate in discussions and contributions.\n\n`;
+
+              // Star reminder at the end
+              if (!hasStarred) {
+                comment += `> [!TIP]\n`;
+                comment += `> **⭐ 如果你觉得 CoPaw 有帮助，请给我们一个 Star！**\n`;
+                comment += `> \n`;
+                comment += `> **⭐ If you find CoPaw useful, please give us a Star!**\n`;
+                comment += `> \n`;
+                comment += `> 你的 star 将帮助更多开发者发现这个项目！🐾\n`;
+                comment += `> \n`;
+                comment += `> Your star helps more developers discover this project! 🐾`;
+              }
+
+            } else {
+              // English only with logo
+              comment = `<div align="center">\n\n`;
+              comment += `<img src="https://copaw.agentscope.io/copaw_ip.svg" width="80" height="80" />\n\n`;
+              comment += `## Welcome to CoPaw! 🐾\n\n`;
+              comment += `</div>\n\n`;
+
+              if (hasValidIssueCount) {
+                if (isFirstIssue) {
+                  comment += `Hi @${author}, thank you for your first issue!\n\n`;
+                } else {
+                  comment += `Hi @${author}, this is your ${issueCount}${getOrdinalSuffix(issueCount)} issue.\n\n`;
+                }
+              } else {
+                comment += `Hi @${author}, thank you for your issue!\n\n`;
+              }
+
+              if (needBugTemplateReminder) {
+                comment += `### 📋 About Bug Report Template\n\n`;
+                comment += `We noticed your issue seems to be bug-related, but doesn't use the Bug Report template. To help us reproduce and fix the issue faster, please make sure your bug report includes:\n\n`;
+                comment += `- ✅ **CoPaw Version** (use \`copaw --version\`)\n`;
+                comment += `- ✅ **Operating System** (macOS/Linux/Windows and version)\n`;
+                comment += `- ✅ **Steps to Reproduce** (detailed steps)\n`;
+                comment += `- ✅ **Actual vs Expected Behavior**\n`;
+                comment += `- ✅ **Logs or Screenshots**\n\n`;
+                comment += `You can edit your issue to add this information. Missing information may require us to ask follow-up questions, which can delay the fix.\n\n`;
+              }
+
+              comment += `We'll review your issue soon. Thank you for supporting CoPaw!\n\n`;
+
+              // Star reminder at the end
+              if (!hasStarred) {
+                comment += `---\n\n`;
+                comment += `> [!TIP]\n`;
+                comment += `> **⭐ If you find CoPaw useful, please give us a Star!**\n`;
+                comment += `> \n`;
+                comment += `> Your star helps more developers discover this project! 🐾`;
+              }
+            }
+
+            // Post comment
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: issueNumber,
+              body: comment
+            });
+
+            const logMessage = hasValidIssueCount
+              ? `Posted welcome comment on issue #${issueNumber} for @${author} (issue #${issueCount})`
+              : `Posted welcome comment on issue #${issueNumber} for @${author}`;
+            console.log(logMessage);