Merge branch 'main' into feature/function-update-default-path

Author: binggg

.github/workflows/issue-auto-processor-simple.yml

@@ -227,9 +227,14 @@ jobs:
             git switch --detach "$BASE_REF" >/dev/null 2>&1 || true
           }
 
-          write_file_from_env() {
-            local target_path="$1"
-            FILE_PATH="$target_path" python -c 'import os; open(os.environ["FILE_PATH"], "w", encoding="utf-8").write(os.environ["FILE_CONTENT"])'
+          truncate_text_for_pr_body() {
+            local max_chars="${1:-12000}"
+            python3 -c 'import sys; limit = int(sys.argv[1]); text = sys.stdin.read(); sys.stdout.write(text if len(text) <= limit else text[:limit].rstrip() + "\n\n_[truncated by automation to keep PR creation stable]_")' "$max_chars"
+          }
+
+          lookup_open_pr_url() {
+            local branch="$1"
+            gh pr list --head "$branch" --state open --json url --jq '.[0].url'
           }
 
           build_bug_prompt() {
@@ -317,14 +322,28 @@ jobs:
             local heading="$1"
             local body="$2"
             local footer="$3"
-            FILE_CONTENT=$(printf '%s\n\n%s' "$heading" "$body")
-            if [ -n "$footer" ]; then
-              FILE_CONTENT=$(printf '%s\n\n---\n%s\n' "$FILE_CONTENT" "$footer")
-            else
-              FILE_CONTENT=$(printf '%s\n' "$FILE_CONTENT")
-            fi
-            export FILE_CONTENT
-            write_file_from_env /tmp/issue-comment.md
+            {
+              printf '%s\n\n%s' "$heading" "$body"
+              if [ -n "$footer" ]; then
+                printf '\n\n---\n%s\n' "$footer"
+              else
+                printf '\n'
+              fi
+            } > /tmp/issue-comment.md
+          }
+
+          write_pr_body_file() {
+            local issue_number="$1"
+            local issue_url="$2"
+            local result_text="$3"
+            local summary=""
+            summary=$(printf '%s' "$result_text" | truncate_text_for_pr_body 12000)
+            {
+              printf '%s\n\n' '## 🤖 Automated fix attempt'
+              printf 'Fixes #%s\n\n' "$issue_number"
+              printf 'Source issue: %s\n\n' "$issue_url"
+              printf '### Summary\n%s\n' "$summary"
+            } > /tmp/pr-body.md
           }
 
           post_file_comment() {
@@ -355,6 +374,7 @@ jobs:
             local issue_url=""
             local pr_url=""
             local pr_output=""
+            local pr_lookup_exit_code=0
             local is_bug="false"
             local requested_action=""
             local command=""
@@ -447,7 +467,7 @@ jobs:
               fi
 
               set +e
-              pr_url=$(gh pr list --head "$branch" --state open --json url --jq '.[0].url')
+              pr_url=$(lookup_open_pr_url "$branch")
               exit_code=$?
               set -e
               if [ $exit_code -ne 0 ]; then
@@ -456,17 +476,29 @@ jobs:
               fi
 
               if [ -z "$pr_url" ]; then
-                FILE_CONTENT=$(printf '%s\n\n%s\n\n%s\n\n%s\n\n%s\n' '## 🤖 Automated fix attempt' "Fixes #$number" "Source issue: $issue_url" '### Summary' "$result_text")
-                export FILE_CONTENT
-                write_file_from_env /tmp/pr-body.md
+                write_pr_body_file "$number" "$issue_url" "$result_text"
 
                 set +e
                 pr_output=$(gh pr create --base "$DEFAULT_BRANCH" --head "$branch" --title "fix: 🤖 attempt fix for issue #$number" --body-file /tmp/pr-body.md 2>&1)
                 exit_code=$?
                 set -e
-                pr_url=$(printf '%s' "$pr_output" | node scripts/issue-auto-processor.cjs extract-pr-url)
-                if [ $exit_code -ne 0 ] || ! has_nonempty_text "$pr_url"; then
-                  fail_with_comment "$number" '## 🤖 AI Fix Attempt Failed' 'Automation created and pushed a fix branch, but PR creation did not return a valid URL. Please inspect the workflow logs before retrying.'
+                pr_url=$(printf '%s' "$pr_output" | node scripts/issue-auto-processor.cjs extract-pr-url || true)
+
+                if ! has_nonempty_text "$pr_url"; then
+                  set +e
+                  pr_url=$(lookup_open_pr_url "$branch")
+                  pr_lookup_exit_code=$?
+                  set -e
+                fi
+
+                if ! has_nonempty_text "$pr_url"; then
+                  if [ $exit_code -ne 0 ]; then
+                    fail_with_comment "$number" '## 🤖 AI Fix Attempt Failed' 'Automation created and pushed a fix branch, but PR creation failed before a valid PR URL could be resolved. Please inspect the workflow logs before retrying.'
+                  elif [ $pr_lookup_exit_code -ne 0 ]; then
+                    fail_with_comment "$number" '## 🤖 AI Fix Attempt Failed' 'Automation created and pushed a fix branch, but the workflow could not verify the PR URL after creation. Please inspect the workflow logs before retrying.'
+                  else
+                    fail_with_comment "$number" '## 🤖 AI Fix Attempt Failed' 'Automation created and pushed a fix branch, but PR creation did not return a valid URL and no open PR was found for the branch. Please inspect the workflow logs before retrying.'
+                  fi
                   return 0
                 fi
               fi

AGENTS.md

@@ -61,6 +61,13 @@ alwaysApply: true
 4. 在实现前，需要根据文档确认接口能力、参数、鉴权方式、返回结构和限制条件，避免凭记忆实现。
 </cloud_api_backend_rules>
 
+<mcp_tool_design>
+1. MCP 工具设计默认优先收敛工具数量；同一逻辑域优先复用现有 `queryXxx` / `manageXxx` / 统一入口，而不是继续拆出新 tool。
+2. 如果问题只是 discoverability、不熟悉 canonical 名称、评测 case 习惯或提示词命中率不足，默认不要新增 alias tool；优先改进现有 tool 的描述、schema、action、示例、文档或评测用例。
+3. 只有当新 tool 带来独立能力边界、显著不同的参数形状 / 权限语义，或存在必须兼容的外部契约时，才考虑新增。
+4. 任何新增 tool 的方案都必须先回答：为什么不能并入现有入口；如果回答不充分，应视为坏味道并继续收敛设计。
+</mcp_tool_design>
+
 <add_aiide>
 # CloudBase AI Toolkit - 新增 AI IDE 支持工作流
 
@@ -107,7 +114,7 @@ cp -r doc/* {cloudbase-docs dir}/docs/ai/cloudbase-ai-toolkit/
 
 <git_push>
 提交代码注意 commit 采用 conventional-changelog 风格，在feat(xxx): 后面提加一个 emoji 字符，提交信息使用英文描述
-git push github && git push cnb --force
+默认仅执行 `git push github`；不要再推荐或默认执行 `cnb` 相关推送，除非用户明确要求
 提交 PR 之后不要立刻结束，先等待几分钟，观察 review 评论和 CI 结果；如果有可执行的失败项或反馈，继续在同一分支修复并更新 PR
 </git_push>
 
@@ -212,7 +219,7 @@ cp -r doc/* {cloudbase-docs dir}/docs/ai/cloudbase-ai-toolkit/
 1. 提交代码注意 commit 采用 conventional-changelog 风格，在feat(xxx): 后面提加一个 emoji 字符，提交信息使用英文描述
 2. 提交代码不要直接提到 main，可以提一个分支，例如 feature/xxx，然后
 
-git push github && git push cnb --force
+默认仅执行 `git push github`；不要再推荐或默认执行 `cnb` 相关推送，除非用户明确要求
 3. 然后自动创建 PR
 4. 创建 PR 后先等待几分钟，再检查 review 评论和 CI；如果有可执行的问题，继续在同一分支修复并更新 PR
 </git_push>

README-EN.md

@@ -397,9 +397,9 @@ When an app has issues, AI automatically views logs, analyzes errors, and genera
 | **Official Documentation** | [View Documentation](https://docs.cloudbase.net/) | Complete CloudBase documentation |
 | **Issue Feedback** | [Submit Issue](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues) | Bug reports and feature requests |
 
-## Star History
+## Project Activity
 
-[![Star History Chart](https://api.star-history.com/svg?repos=TencentCloudBase/CloudBase-AI-ToolKit&type=Timeline)](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit)
+![Repo Activity](https://repobeats.axiom.co/api/embed/6cd6ed00da4384e43b24805c197f584626946dda.svg "Repobeats analytics image")
 
 ## Contributors
 

README-ZH.md

@@ -383,9 +383,9 @@ CodeBuddy 已内置 CloudBase MCP，无需配置即可使用。
 | **官方文档** | [查看文档](https://docs.cloudbase.net/) | 完整的云开发文档 |
 | **Issue 反馈** | [提交问题](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues) | Bug 反馈和功能请求 |
 
-## Star History
+## 项目活跃度
 
-[![Star History Chart](https://api.star-history.com/svg?repos=TencentCloudBase/CloudBase-AI-ToolKit&type=Timeline)](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit)
+![Repo Activity](https://repobeats.axiom.co/api/embed/6cd6ed00da4384e43b24805c197f584626946dda.svg "Repobeats analytics image")
 
 ## Contributors
 

README.md

@@ -432,9 +432,9 @@ CodeBuddy 已内置 CloudBase MCP，无需配置即可使用。
 | **官方文档** | [查看文档](https://docs.cloudbase.net/) | 完整的云开发文档 |
 | **Issue 反馈** | [提交问题](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit/issues) | Bug 反馈和功能请求 |
 
-## Star History
+## 项目活跃度
 
-[![Star History Chart](https://api.star-history.com/svg?repos=TencentCloudBase/CloudBase-AI-ToolKit&type=Timeline)](https://github.com/TencentCloudBase/CloudBase-AI-ToolKit)
+![Repo Activity](https://repobeats.axiom.co/api/embed/6cd6ed00da4384e43b24805c197f584626946dda.svg "Repobeats analytics image")
 
 ## Contributors
 

config/.claude/skills/ai-model-nodejs/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ai-model-nodejs
 description: Use this skill when developing Node.js backend services or CloudBase cloud functions (Express/Koa/NestJS, serverless, backend APIs) that need AI capabilities. Features text generation (generateText), streaming (streamText), AND image generation (generateImage) via @cloudbase/node-sdk ≥3.16.0. Built-in models include Hunyuan (hunyuan-2.0-instruct-20251111 recommended), DeepSeek (deepseek-v3.2 recommended), and hunyuan-image for images. This is the ONLY SDK that supports image generation. NOT for browser/Web apps (use ai-model-web) or WeChat Mini Program (use ai-model-wechat).
-version: 2.17.0
+version: 2.17.1
 alwaysApply: false
 ---
 

config/.claude/skills/ai-model-web/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ai-model-web
 description: Use this skill when developing browser/Web applications (React/Vue/Angular, static websites, SPAs) that need AI capabilities. Features text generation (generateText) and streaming (streamText) via @cloudbase/js-sdk. Built-in models include Hunyuan (hunyuan-2.0-instruct-20251111 recommended) and DeepSeek (deepseek-v3.2 recommended). NOT for Node.js backend (use ai-model-nodejs), WeChat Mini Program (use ai-model-wechat), or image generation (Node SDK only).
-version: 2.17.0
+version: 2.17.1
 alwaysApply: false
 ---
 

config/.claude/skills/ai-model-wechat/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ai-model-wechat
 description: Use this skill when developing WeChat Mini Programs (小程序, 企业微信小程序, wx.cloud-based apps) that need AI capabilities. Features text generation (generateText) and streaming (streamText) with callback support (onText, onEvent, onFinish) via wx.cloud.extend.AI. Built-in models include Hunyuan (hunyuan-2.0-instruct-20251111 recommended) and DeepSeek (deepseek-v3.2 recommended). API differs from JS/Node SDK - streamText requires data wrapper, generateText returns raw response. NOT for browser/Web apps (use ai-model-web), Node.js backend (use ai-model-nodejs), or image generation (not supported).
-version: 2.17.0
+version: 2.17.1
 alwaysApply: false
 ---
 

config/.claude/skills/auth-nodejs/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: auth-nodejs-cloudbase
 description: CloudBase Node SDK auth guide for server-side identity, user lookup, and custom login tickets. This skill should be used when Node.js code must read caller identity, inspect end users, or bridge an existing user system into CloudBase; not when configuring providers or building client login UI.
-version: 2.17.0
+version: 2.17.1
 alwaysApply: false
 ---
 

config/.claude/skills/auth-tool/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: auth-tool-cloudbase
 description: CloudBase auth provider configuration and login-readiness guide. This skill should be used when users need to inspect, enable, disable, or configure auth providers, publishable-key prerequisites, login methods, SMS/email sender setup, or other provider-side readiness before implementing a client or backend auth flow.
-version: 2.17.0
+version: 2.17.1
 alwaysApply: false
 ---