1
#!/bin/bash
2
set -e
3

4
model="gemini-2.5-flash"
5
out="./docs/services"
6
mkdir -p "$out"
7

8
for file in $(grep -rl "^@service" app/src/core); do
9
  relative=${file#app/src/core/}
10
  relative="app/src/core/$relative"
11
  service=$(grep -oP '@service\("\K[^"]+(?="\))' "$file")
12
  service=$(echo "$service" | sed -E 's/([a-z0-9])([A-Z])/\1-\L\2/g' | tr '[:upper:]' '[:lower:]')
13

14
  doc="$out/$service.zh-CN.mdx"
15
  [[ -e $doc ]] && { echo "$(tput setaf 3)文件 $doc 已存在，跳过"; continue; }
16

17
  prompt=$(cat <<EOF
18
下面是一段 TypeScript 源码。请完成三件事，用三行“---”作为分隔符输出：
19

20
1. 用中文概述这个服务的用途，要求同以前（不要称“类”，分段，善用标题，不要一级标题，API 方法也要标题）。
21
2. 给这个服务起一个 lucide 的大驼峰图标名。
22
3. 把服务原始大驼峰名翻译成中文，格式：“[原文的大驼峰形式][空格][译文]”。
23

24
不要输出多余的解释或空白。
25

26
example:
27
用于管理用户会话，跟踪登录状态与权限……
28

29
## API
30

31
### \`login(userId: string): Promise<void>\`
32

33
……
34

35
### \`logout(): Promise<void>\`
36

37
……
38
---
39
UserCog
40
---
41
UserService 用户服务
42
end example.
43

44
---
45
$(cat "$file")
46
EOF
47
  )
48

49
  tput setaf 4
50
  echo "正在生成 $service.zh-CN.mdx, $relative"
51
  tput setaf 8
52

53
  # 一次请求拿到三段
54
  raw=$(gemini -p "$prompt" -m "$model")
55

56
  # 用 awk 按 "---" 拆分
57
  doc_body=$(echo "$raw" | awk -v RS='---' 'NR==1{print; exit}')
58
  icon=$(echo      "$raw" | awk -v RS='---' 'NR==2{gsub(/[[:space:]]/, ""); print}')
59
  title=$(echo     "$raw" | awk -v RS='---' 'NR==3{gsub(/^[[:space:]]+|[[:space:]]+$/, ""); print}')
60

61
  tput setaf 2
62
  echo "标题: $title"
63
  echo "图标: $icon"
64

65
  cat > "$doc" <<EOF
66
---
67
title: $title
68
icon: $icon
69
relatedFile: $relative
70
---
71

72
$doc_body
73
EOF
74
done