@comate/zulu 1.2.1-beta.2 → 1.3.0

package/comate-engine/assets/skills/icode-comate/scripts/submit-acr.sh

@@ -0,0 +1,236 @@
+#!/bin/bash
+# submit-acr.sh - AI 代码评审脚本 (Linux/macOS)
+# 自动执行 AI 代码评审 + 问题修复的循环流程
+#
+# 使用方法:
+#   ./submit-acr.sh [CR编号] [最大循环次数] [AI评审超时秒数] [严重度阈值]
+#
+# 示例:
+#   ./submit-acr.sh                        # 自动检测 CR，使用默认参数
+#   ./submit-acr.sh 120247220              # 指定 CR
+#   ./submit-acr.sh 120247220 10 1200 5    # 完整参数
+
+set -e
+
+# 加载公共函数
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# 触发 AI 评审
+trigger_ai_review() {
+    local change_number=$1
+
+    local result
+    local stderr_output
+    local exit_code
+    stderr_output=$(mktemp)
+
+    # 临时禁用 set -e，避免命令失败时脚本退出
+    set +e
+    result=$("$ICODE_CLI" api start_ai_review --change-number "$change_number" -o json 2>"$stderr_output")
+    exit_code=$?
+    set -e
+
+    if [ $exit_code -ne 0 ]; then
+        # 检查是否有 API 错误信息
+        if grep -q "API_REQUEST_FAILED\|BAD_REQUEST" "$stderr_output" 2>/dev/null; then
+            local api_error
+            api_error=$(grep -oE '"message":"[^"]*"' "$stderr_output" | head -1 | sed 's/"message":"//;s/"$//')
+            log_error "API 调用失败: $api_error" >&2
+        else
+            log_error "触发 AI 评审失败" >&2
+            cat "$stderr_output" >&2
+        fi
+        rm -f "$stderr_output"
+        return 1
+    fi
+    rm -f "$stderr_output"
+
+    if [ -z "$result" ]; then
+        log_error "触发 AI 评审失败: 无返回结果" >&2
+        return 1
+    fi
+
+    local status
+    status=$(echo "$result" | "$ICODE_CLI" jq -r '.status' 2>/dev/null)
+
+    if [ "$status" != "OK" ]; then
+        local message
+        message=$(echo "$result" | "$ICODE_CLI" jq -r '.message' 2>/dev/null)
+        log_error "触发 AI 评审失败: $message" >&2
+        return 1
+    fi
+
+    echo "$result" | "$ICODE_CLI" jq -r '.conversationId' 2>/dev/null
+}
+
+# 获取 AI 评审结果
+get_ai_review_result() {
+    local conversation_id=$1
+    "$ICODE_CLI" api get_ai_review --conversation-id "$conversation_id" -o json 2>/dev/null
+}
+
+# 检查 AI 评审状态
+check_ai_review_status() {
+    local result=$1
+    echo "$result" | "$ICODE_CLI" jq -r '.data.crStatus' 2>/dev/null
+}
+
+# 统计需要修复的问题数量
+count_ai_issues() {
+    local result=$1
+    local severity_threshold=$2
+    echo "$result" | "$ICODE_CLI" jq "
+        [.data.results[] |
+         select(.messageType == \"INTERLINEAR_COMMENT\") |
+         .processedContent |
+         select(.severityScore >= $severity_threshold)] | length
+    " 2>/dev/null || echo "0"
+}
+
+# 输出 AI 评审问题详情
+print_ai_issues() {
+    local result=$1
+    local severity_threshold=$2
+
+    echo ""
+    log_warn "========== AI 评审问题 (severityScore >= $severity_threshold) =========="
+    echo ""
+
+    echo "$result" | "$ICODE_CLI" jq -r "
+        .data.results[] |
+        select(.messageType == \"INTERLINEAR_COMMENT\") |
+        .processedContent |
+        select(.severityScore >= $severity_threshold) |
+        \"【文件】\\(.fileName)\\n【行号】\\(.startLine)-\\(.endLine)\\n【严重度】\\(.severityScore)\\n【问题】\\(.message)\\n\"
+    " 2>/dev/null
+
+    log_warn "=========================================="
+    echo ""
+}
+
+# ========== 主流程 ==========
+
+# 初始化环境
+init_toolkit_env
+
+CHANGE_NUMBER=${1:-""}
+MAX_LOOPS=${2:-10}
+AI_CR_TIMEOUT=${3:-1200}
+SEVERITY_THRESHOLD=${4:-5}
+POLL_INTERVAL=10
+
+# 如果没有指定 CR 编号，自动检测
+if [ -z "$CHANGE_NUMBER" ]; then
+    log_step "检测当前 CR..."
+    CHANGE_NUMBER=$(get_current_cr "$ICODE_CLI" "$REPO_NAME" "$USERNAME")
+
+    if [ -z "$CHANGE_NUMBER" ]; then
+        log_error "未找到当前 commit 对应的 CR"
+        log_warn "请先执行 submit-cr.sh 提交 CR，或手动指定 CR 编号"
+        exit 1
+    fi
+fi
+
+echo ""
+log_info "========== AI CR 流程 =========="
+log_info "CR 编号: $CHANGE_NUMBER"
+log_info "最大循环次数: $MAX_LOOPS"
+log_info "AI 评审超时: ${AI_CR_TIMEOUT}s"
+log_info "严重度阈值: $SEVERITY_THRESHOLD"
+log_info "===================================="
+echo ""
+
+# 主循环
+LOOP_COUNT=0
+
+while [ $LOOP_COUNT -lt $MAX_LOOPS ]; do
+    LOOP_COUNT=$((LOOP_COUNT + 1))
+
+    echo ""
+    log_phase "========== 第 $LOOP_COUNT 轮 (共 $MAX_LOOPS 轮) =========="
+    echo ""
+
+    log_phase "AI 代码评审"
+    log_step "触发 AI 评审..."
+
+    set +e
+    CONVERSATION_ID=$(trigger_ai_review "$CHANGE_NUMBER")
+    TRIGGER_EXIT_CODE=$?
+    set -e
+
+    if [ $TRIGGER_EXIT_CODE -ne 0 ] || [ -z "$CONVERSATION_ID" ]; then
+        log_error "触发 AI 评审失败"
+        exit 1
+    fi
+
+    log_info "会话 ID: $CONVERSATION_ID"
+    log_step "轮询 AI 评审结果..."
+
+    ELAPSED=0
+    AI_RESULT=""
+
+    while [ $ELAPSED -lt $AI_CR_TIMEOUT ]; do
+        AI_RESULT=$(get_ai_review_result "$CONVERSATION_ID")
+        AI_STATUS=$(check_ai_review_status "$AI_RESULT")
+
+        case "$AI_STATUS" in
+            "SUSS")
+                log_info "AI 评审完成"
+                break
+                ;;
+            "FAIL")
+                log_error "AI 评审执行失败"
+                exit 1
+                ;;
+            "TIMEOUT")
+                log_error "AI 评审执行超时"
+                exit 1
+                ;;
+            "EXECUTING")
+                log_info "AI 评审执行中... (${ELAPSED}s / ${AI_CR_TIMEOUT}s)"
+                sleep $POLL_INTERVAL
+                ELAPSED=$((ELAPSED + POLL_INTERVAL))
+                ;;
+            *)
+                log_warn "未知状态: $AI_STATUS，继续等待..."
+                sleep $POLL_INTERVAL
+                ELAPSED=$((ELAPSED + POLL_INTERVAL))
+                ;;
+        esac
+    done
+
+    if [ $ELAPSED -ge $AI_CR_TIMEOUT ]; then
+        log_error "轮询超时（${AI_CR_TIMEOUT}s），AI 评审未完成"
+        exit 1
+    fi
+
+    AI_ISSUE_COUNT=$(count_ai_issues "$AI_RESULT" "$SEVERITY_THRESHOLD")
+
+    if [ "$AI_ISSUE_COUNT" -eq 0 ]; then
+        echo ""
+        log_info "=========================================="
+        log_info "✓ AI CR 流程通过！"
+        log_info "  - AI 评审: 无高优问题 (severityScore >= $SEVERITY_THRESHOLD)"
+        log_info "=========================================="
+        exit 0
+    fi
+
+    log_warn "AI 评审发现 $AI_ISSUE_COUNT 个需要修复的问题"
+    print_ai_issues "$AI_RESULT" "$SEVERITY_THRESHOLD"
+
+    if [ $LOOP_COUNT -lt $MAX_LOOPS ]; then
+        log_warn "请 Agent 修复上述 AI 评审问题"
+        log_warn "修复完成后："
+        log_warn "  1. 使用 Edit 工具修复代码"
+        log_warn "  2. 执行 submit-cr.sh 提交"
+        log_warn "  3. 再次运行: $0 $CHANGE_NUMBER $MAX_LOOPS $AI_CR_TIMEOUT $SEVERITY_THRESHOLD"
+        exit 2
+    fi
+done
+
+echo ""
+log_error "=========================================="
+log_error "✗ AI CR 流程失败，已达到最大循环次数 ($MAX_LOOPS)"
+log_error "=========================================="
+exit 1

package/comate-engine/assets/skills/icode-comate/scripts/submit-cr.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# submit-cr.sh - 智能提交代码评审脚本 (Linux/macOS)
+# 自动判断新建 CR 或追加到已有 CR（Amend 模式）
+#
+# 使用方法:
+#   ./submit-cr.sh [目标分支]
+#
+# 示例:
+#   ./submit-cr.sh           # 默认 master 分支
+#   ./submit-cr.sh develop   # 指定 develop 分支
+
+set -e
+
+# 加载公共函数
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# 初始化环境
+init_toolkit_env
+
+# 获取本地信息
+LOCAL_COMMIT=$(git rev-parse HEAD)
+COMMIT_MSG=$(git log -1 --format="%s")
+ICAFE_CARD=$(echo "$COMMIT_MSG" | grep -oE '^[A-Za-z0-9]+-[0-9]+' | head -1 || true)
+DEFAULT_BRANCH=${1:-master}
+
+echo ""
+log_info "本地 Commit: $LOCAL_COMMIT"
+log_info "Commit Message: $COMMIT_MSG"
+log_info "iCafe 卡片号: ${ICAFE_CARD:-无}"
+log_info "默认目标分支: $DEFAULT_BRANCH"
+echo ""
+
+# 查询远程 CR
+log_step "查询远程 CR 列表..."
+CR_LIST=$($ICODE_CLI api get_repo_reviews --repo "$REPO_NAME" --status NEW -o json 2>/dev/null || echo '{"data":{"changes":[]}}')
+
+# 方式一：通过 commit hash 匹配
+log_step "匹配已有 CR..."
+MATCHED_BY_HASH=$(echo "$CR_LIST" | $ICODE_CLI jq -r ".data.changes[] | select(.owner.username == \"$USERNAME\" and .current_revision == \"$LOCAL_COMMIT\") | ._number" 2>/dev/null | head -1 || true)
+
+# 方式二：通过 iCafe 卡片号匹配
+MATCHED_BY_CARD=""
+if [ -z "$MATCHED_BY_HASH" ] && [ -n "$ICAFE_CARD" ]; then
+    MATCHED_BY_CARD=$(echo "$CR_LIST" | $ICODE_CLI jq -r ".data.changes[] | select(.owner.username == \"$USERNAME\" and (.subject | startswith(\"$ICAFE_CARD\"))) | ._number" 2>/dev/null | head -1 || true)
+fi
+
+MATCHED_CR=${MATCHED_BY_HASH:-$MATCHED_BY_CARD}
+
+if [ -n "$MATCHED_CR" ]; then
+    MATCHED_BRANCH=$(echo "$CR_LIST" | $ICODE_CLI jq -r ".data.changes[] | select(._number == $MATCHED_CR) | .branch" 2>/dev/null)
+
+    if [ -n "$MATCHED_BY_HASH" ]; then
+        log_info "通过 Commit Hash 匹配到 CR: #$MATCHED_CR"
+    else
+        log_info "通过 iCafe 卡片号 ($ICAFE_CARD) 匹配到 CR: #$MATCHED_CR"
+    fi
+    log_info "目标分支: $MATCHED_BRANCH"
+    echo ""
+
+    log_step "执行 Amend 模式..."
+
+    if [ -n "$(git status --porcelain)" ]; then
+        log_step "添加工作区修改..."
+        git add -A
+        log_step "Amend 提交..."
+        git commit --amend --no-edit
+    else
+        log_warn "工作区没有新修改，直接推送"
+    fi
+
+    log_step "推送 CR..."
+    $ICODE_CLI git push_cr --branch "$MATCHED_BRANCH"
+else
+    log_info "未找到匹配的 CR"
+    log_info "目标分支: $DEFAULT_BRANCH"
+    echo ""
+
+    log_step "执行新建 CR 模式..."
+
+    if [ -n "$(git status --porcelain)" ]; then
+        log_step "添加工作区修改..."
+        git add -A
+
+        echo -e "${YELLOW}请输入 commit message:${NC}"
+        read -r NEW_COMMIT_MSG
+
+        if [ -z "$NEW_COMMIT_MSG" ]; then
+            log_error "commit message 不能为空"
+            exit 1
+        fi
+
+        log_step "创建新 commit..."
+        git commit -m "$NEW_COMMIT_MSG"
+    else
+        log_warn "工作区没有新修改，直接推送当前 commit"
+    fi
+
+    log_step "推送 CR..."
+    $ICODE_CLI git push_cr --branch "$DEFAULT_BRANCH"
+fi
+
+echo ""
+log_info "CR 提交完成！"

package/comate-engine/assets/skills/icode-comate/scripts/test-preflight.sh

@@ -0,0 +1,89 @@
+#!/bin/bash
+# test-preflight.sh - icode 前置检测测试
+
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+PASS_COUNT=0
+FAIL_COUNT=0
+
+log_test() { echo -e "${BLUE}[TEST]${NC} $1"; }
+log_pass() { echo -e "${GREEN}[PASS]${NC} $1"; PASS_COUNT=$((PASS_COUNT + 1)); }
+log_fail() { echo -e "${RED}[FAIL]${NC} $1"; FAIL_COUNT=$((FAIL_COUNT + 1)); }
+log_skip() { echo -e "${YELLOW}[SKIP]${NC} $1"; }
+
+REQUIRED_ICODE_CLI_VERSION="0.1.8"
+
+version_ge() {
+    [ "$(printf '%s\n' "$1" "$2" | sort -V | head -n1)" = "$2" ]
+}
+
+echo ""
+echo "=========================================="
+echo "icode 前置检测测试"
+echo "=========================================="
+echo ""
+
+# ----- 测试 icode-cli -----
+log_test "检测 icode-cli..."
+CLI_PATH=""
+if command -v icode-cli &> /dev/null; then
+    CLI_PATH="icode-cli"
+    log_pass "icode-cli 在 PATH 中"
+elif [ -x "$HOME/.icode/bin/icode-cli" ]; then
+    CLI_PATH="$HOME/.icode/bin/icode-cli"
+    log_pass "icode-cli 在 ~/.icode/bin/ 中"
+else
+    log_fail "icode-cli 未找到"
+fi
+
+if [ -n "$CLI_PATH" ]; then
+    CLI_VERSION=$("$CLI_PATH" version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
+    if [ -n "$CLI_VERSION" ]; then
+        if version_ge "$CLI_VERSION" "$REQUIRED_ICODE_CLI_VERSION"; then
+            log_pass "版本 $CLI_VERSION >= $REQUIRED_ICODE_CLI_VERSION"
+        else
+            log_fail "版本 $CLI_VERSION < $REQUIRED_ICODE_CLI_VERSION"
+        fi
+    fi
+fi
+
+echo ""
+
+# ----- 测试登录状态 -----
+log_test "检测登录状态..."
+if [ -n "$CLI_PATH" ]; then
+    LOGIN_OUTPUT=$("$CLI_PATH" login 2>&1)
+    if echo "$LOGIN_OUTPUT" | grep -q "Logged in as"; then
+        USERNAME=$(echo "$LOGIN_OUTPUT" | grep "Logged in as" | awk '{print $NF}')
+        log_pass "已登录: $USERNAME"
+    elif echo "$LOGIN_OUTPUT" | grep -q "Not logged in"; then
+        log_fail "未登录"
+    else
+        log_skip "无法确定登录状态"
+    fi
+else
+    log_skip "icode-cli 未安装"
+fi
+
+echo ""
+
+# ----- 测试 git 仓库 -----
+log_test "检测 git 仓库..."
+if git rev-parse --is-inside-work-tree &> /dev/null; then
+    log_pass "当前目录是 git 仓库"
+else
+    log_skip "当前目录不是 git 仓库"
+fi
+
+echo ""
+echo "=========================================="
+echo "测试结果: 通过 $PASS_COUNT / 失败 $FAIL_COUNT"
+echo "=========================================="
+
+[ $FAIL_COUNT -gt 0 ] && exit 1 || exit 0

package/comate-engine/assets/skills/ku-operator-comate/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: ku-operator
+description: 操作百度内部知识库（Ku）系统的文档。支持文档内容查询、知识库目录查询、新建文档、移动文档等操作。当用户需要在知识库中创建文档、查看文档内容、浏览目录结构、或移动文档位置时使用此 Skill。
+metadata:
+  enableWhen:
+    - isInternal
+---
+
+# 知识库文档操作（Ku Operator）
+
+操作百度内部知识库系统的文档，支持文档 CRUD 操作。所有操作通过同目录下的 CLI 脚本执行。
+
+## 前置依赖
+
+- **Skill 依赖 `get-ugate-token`**：认证通过 get-ugate-token skill 自动获取个人身份 token
+- **环境变量 `COMATE_USERNAME`**：当前用户的百度用户名，认证和创建/移动文档时自动读取
+- **当前用户名**: ${COMATE_USERNAME}，即`COMATE_USERNAME=${COMATE_USERNAME}`
+- **Python 依赖**：`requests` 库
+- **CLI 工具 `dodo_cli bos upload`**：`create-doc` 上传图片/附件时自动调用
+- **执行方式**：在 Skill 目录下使用 **`python3`** 直接运行脚本，不要 import 调用
+
+## 认证说明
+
+本 skill 依赖 `get-ugate-token` skill 进行个人身份认证。调用时自动获取 ugate token：
+- 若本地已有有效的 token 缓存文件，直接使用，无需用户介入
+- 若 token 不存在或已过期，`get-ugate-token` 会向用户推送授权卡片（如流消息），脚本以退出码 2 中断当前任务
+- 用户完成授权后，重新发起操作即可
+
+API 返回 401/403 时，脚本会提示用户重新触发授权流程并以退出码 2 退出。
+
+## 知识库 URL 与 ID 解析（重要）
+
+```
+https://ku.baidu-int.com/knowledge/{spaceGuid}/{groupGuid}/{repoGuid}/{docGuid}
+```
+
+| URL 段 | 含义 | 说明 |
+|--------|------|------|
+| `spaceGuid` | 空间 ID | 一般不需要使用 |
+| `groupGuid` | 分组 ID | 一般不需要使用 |
+| `repoGuid` | **知识库 ID** | 用于 `--repo-guid` 参数 |
+| `docGuid` | **文档 ID** | 用于 `--doc-id` 参数，URL 最后一段 |
+
+**路径段数判断链接类型：**
+- **4 段**（含 docGuid）→ 文档链接，可直接 `query-content` 读取
+- **3 段**（仅到 repoGuid）→ 知识库链接，需先 `query-repo` 查询目录
+
+## 重要概念：文档即目录
+
+知识库中**文档和目录是同一个概念**——任何文档都可以拥有子文档。读取文档后应通过 `query-repo --parent-doc-guid <该文档ID>` 检查是否有子文档，按需加载以提供完整结果。
+
+## 写入目标知识库确定策略
+
+当用户要求"写入知识库"但**未指定目标**时，按优先级：
+
+1. **当前会话中提及的知识库**：从 URL 解析 `repoGuid`/`docGuid`
+2. **项目关联的默认知识库**：读取 `knowledge/ku_doc/ku_doc_usage.md`（可能不存在）
+3. **询问用户**：请用户提供目标知识库文档的 URL
+
+**写入范围约束：**
+- 文档链接（4 段）→ 只能在该文档及其子目录下创建
+- 知识库链接（3 段）→ 可在整个知识库范围内创建
+- 用户明确指定其他位置时，以用户指令为准
+
+## CLI 子命令一览
+
+统一入口：`python3 scripts/ku_operator.py <子命令> [参数]`
+
+| 子命令 | 功能 | 必填参数 | 常用可选参数 |
+|--------|------|----------|-------------|
+| `query-content` | 查询文档内容（Markdown 输出） | `--doc-id` 或 `--url`（二选一） | `--save-assets-dir`, `--no-download-assets`, `--raw-json` |
+| `query-repo` | 查询知识库目录（文本树形输出） | `--repo-guid` | `--parent-doc-guid`, `--page` |
+| `create-doc` | 新建文档 | `--repo-guid` | `--title`, `--content-file`, `--parent-doc-guid` |
+| `copy-doc` | 复制文档 | `--doc-id` | `--to-repo-guid`, `--to-parent-guid`, `--new-title` |
+| `move-doc` | 移动文档 | `--doc-id` + `--to-repo-guid` | `--to-parent-guid` |
+| `delete-doc` | 删除文档 | `--doc-id` | — |
+| `query-comment` | 查询文档评论（格式化文本输出） | `--doc-id` | `--type`, `--page`, `--raw-json` |
+| `query-user-info` | 查询当前用户信息及个人知识库 | — | — |
+| `upload-attachment` | 上传附件到文档正文 | `--doc-id` + `--file` | `--no-insert`, `--view-type` |
+| `query-flowchart` | 查询文档流程图数据 | `--doc-id` | `--flowchart-id`, `--output` |
+| `query-recent-view` | 查询文档浏览记录（格式化文本输出） | `--doc-id` | `--begin-time`, `--end-time`, `--page`, `--raw-json` |
+| `add-member` | 添加文档成员 | `--doc-id` + `--usernames` + `--role` | — |
+| `update-member` | 更新文档成员角色 | `--doc-id` + `--username` + `--role` | — |
+| `query-permission` | 查询用户文档权限 | `--doc-id` + `--usernames` | — |
+| `change-scope` | 修改文档公开/私密范围 | `--doc-id` + `--scope` | — |
+
+**关键用法说明：**
+- `query-content` 默认自动下载远程图片/附件到 `./ku_assets/{doc_id}/`，并替换 Markdown 中的 URL。读取文档后注意 stderr 资源下载摘要，按需用 Read 工具查看已下载的图片。
+- `create-doc` 使用 `--content-file` 时自动上传本地图片/附件到 BOS。**Markdown 中图片/附件引用必须使用绝对路径**。
+- `query-user-info` 返回 `personalRepoGuid`（个人知识库 ID）和 `personalRepoUrl`。
+- 创建者/操作者用户名自动从 `COMATE_USERNAME` 读取。
+
+## API 详细文档
+
+各子命令的详细参数、输出格式、使用示例见 `references/` 目录：
+
+| 文档 | 内容 |
+|------|------|
+| `references/query_content.md` | 文档内容查询详细说明 |
+| `references/query_repo.md` | 知识库目录查询详细说明 |
+| `references/create_doc.md` | 新建文档详细说明 |
+| `references/copy_doc.md` | 复制文档详细说明 |
+| `references/move_doc.md` | 移动文档详细说明 |
+| `references/delete_doc.md` | 删除文档详细说明 |
+| `references/query_comment.md` | 查询文档评论详细说明 |
+| `references/query_user_info.md` | 用户信息查询详细说明 |
+| `references/upload_attachment.md` | 上传附件到文档正文 |
+| `references/query_flowchart.md` | 查询文档流程图数据 |
+| `references/update_member.md` | 更新文档成员角色 |
+| `references/query_permission.md` | 查询用户文档权限 |
+| `references/change_scope.md` | 修改文档公开/私密范围 |
+
+## 错误处理
+
+**可自行修复（重试）：** 参数缺失、ID 格式错误（repoGuid/docGuid 搞反）、页码超出范围
+
+**需告知用户（不重试）：**
+- 认证失败（401/403）→ 提示用户重新发起操作以触发 get-ugate-token 授权
+- 文档不存在（404）→ 告知用户检查文档是否已被删除
+- 无操作权限 → 告知用户联系知识库管理员
+- 服务端错误（5xx）→ 告知用户稍后再试