✨ feat: 新增单节课程分享并统一分享模块

Author: zhxycn

app/(pages)/settings/course/add.tsx

@@ -15,6 +15,7 @@ import {
 } from "react-native";
 import Toast from "react-native-toast-message";
 
+import { CourseShareSheet } from "@/components/share/course-share-sheet";
 import { ConfirmSheet } from "@/components/ui/confirm-sheet";
 import { ScrollLockProvider, useScrollLock } from "@/components/ui/scroll-lock";
 import { WEEKDAY_KEYS as DAY_KEYS } from "@/constants/weekdays";
@@ -144,6 +145,7 @@ export default function AddEditCourseScreen() {
     isEdit && existingRecords.length > 0 ? null : 0,
   );
   const [showDeleteConfirm, setShowDeleteConfirm] = useState(false);
+  const [shareVisible, setShareVisible] = useState(false);
   // 拖动周次网格或节次滑块时临时禁用页面滚动，避免手势冲突
   const [scrollEnabled, setScrollEnabled] = useState(true);
   const scrollLockCount = useRef(0);
@@ -397,6 +399,18 @@ export default function AddEditCourseScreen() {
               </Text>
             </Pressable>
 
+            {isEdit && (
+              <Pressable
+                onPress={() => setShareVisible(true)}
+                className="mt-3 flex-row items-center justify-center rounded-xl bg-white py-3.5 active:bg-neutral-50 dark:bg-neutral-800 dark:active:bg-neutral-700"
+              >
+                <Ionicons name="qr-code-outline" size={18} color="#3b82f6" />
+                <Text className="ml-1.5 text-base font-medium text-blue-500">
+                  {t("schedule.shareCourse")}
+                </Text>
+              </Pressable>
+            )}
+
             {isEdit && (
               <Pressable
                 onPress={() => setShowDeleteConfirm(true)}
@@ -422,6 +436,11 @@ export default function AddEditCourseScreen() {
         destructive
         onConfirm={handleDelete}
       />
+
+      <CourseShareSheet
+        courseName={shareVisible ? (editName ?? null) : null}
+        onClose={() => setShareVisible(false)}
+      />
     </>
   );
 }

app/(pages)/settings/course/palette.tsx

@@ -5,7 +5,7 @@ import { useMemo, useState } from "react";
 import { Pressable, ScrollView, Text, View } from "react-native";
 import Toast from "react-native-toast-message";
 
-import { ScanCodeSheet } from "@/components/scan/scan-code-sheet";
+import { ShareSheet } from "@/components/share/share-sheet";
 import { BottomSheet } from "@/components/ui/bottom-sheet";
 import { MenuGroup, MenuItem } from "@/components/ui/menu-item";
 import {
@@ -20,7 +20,6 @@ import { useT } from "@/lib/i18n";
 import {
   buildSchedulePaletteScanEnvelope,
   buildShareableSchedulePalette,
-  createScanUrl,
   resolveScanAction,
   SCHEDULE_PALETTE_SCAN_TYPE,
 } from "@/lib/scan";
@@ -306,13 +305,12 @@ export default function PaletteScreen() {
         </View>
       </BottomSheet>
 
-      <ScanCodeSheet
+      <ShareSheet
         visible={shareVisible}
         onClose={() => setShareVisible(false)}
         title={t("palette.shareCodeTitle")}
         description={t("palette.shareCodeDesc")}
-        qrValue={JSON.stringify(shareEnvelope)}
-        shareValue={createScanUrl(shareEnvelope)}
+        envelope={shareEnvelope}
       />
     </>
   );

app/(tabs)/index.tsx

@@ -15,6 +15,7 @@ import Animated, { useAnimatedStyle } from "react-native-reanimated";
 import { SafeAreaView } from "react-native-safe-area-context";
 
 import { CourseDetailModal } from "@/components/layout/course-detail-modal";
+import { CourseShareSheet } from "@/components/share/course-share-sheet";
 import { HomeMenu } from "@/components/layout/home-menu";
 import { TabBackground } from "@/components/layout/tab-background";
 import { AnnouncementBanner } from "@/components/ui/announcement-banner";
@@ -276,6 +277,7 @@ export default function HomeScreen() {
 
   const [activeTab, setActiveTab] = useState(() => (allTodayFinished ? 1 : 0));
   const [selectedCourse, setSelectedCourse] = useState<Course | null>(null);
+  const [shareName, setShareName] = useState<string | null>(null);
 
   const openCourseDetail = useCallback(
     (course: Course) => {
@@ -293,6 +295,15 @@ export default function HomeScreen() {
     });
   }, []);
 
+  const handleShareCourse = useCallback(
+    (course: Course) => {
+      haptic();
+      setSelectedCourse(null);
+      setShareName(course.name);
+    },
+    [haptic],
+  );
+
   const pagerRef = useRef<PagerView>(null);
   const [initialPage] = useState(() => (allTodayFinished ? 1 : 0));
   const { position, handler: pagerScrollHandler } =
@@ -700,6 +711,12 @@ export default function HomeScreen() {
         }
         onClose={() => setSelectedCourse(null)}
         onEdit={handleEditCourse}
+        onShare={handleShareCourse}
+      />
+
+      <CourseShareSheet
+        courseName={shareName}
+        onClose={() => setShareName(null)}
       />
     </View>
   );

components/layout/course-detail-modal.tsx

@@ -14,21 +14,23 @@ import type { Course } from "@/store/course";
 
 /**
  * 课程详情弹窗，课表页与首页共用。
- * 操作按钮按需显示：传入 onEdit / onAddAtSameSlot 才渲染对应按钮。
+ * 操作按钮按需显示：传入 onEdit / onShare / onAddAtSameSlot 才渲染对应按钮。
  */
 export function CourseDetailModal({
   course,
   headerColor,
   showOtherWeekTag = false,
   onClose,
   onEdit,
+  onShare,
   onAddAtSameSlot,
 }: {
   course: Course | null;
   headerColor: string;
   showOtherWeekTag?: boolean;
   onClose: () => void;
   onEdit?: (course: Course) => void;
+  onShare?: (course: Course) => void;
   onAddAtSameSlot?: (course: Course) => void;
 }) {
   const t = useT();
@@ -178,7 +180,7 @@ export function CourseDetailModal({
               />
             </View>
 
-            {(onEdit || onAddAtSameSlot) && (
+            {(onEdit || onShare || onAddAtSameSlot) && (
               <View
                 style={{
                   flexDirection: "row",
@@ -191,15 +193,23 @@ export function CourseDetailModal({
                 {onEdit && (
                   <DetailActionButton
                     icon="create-outline"
-                    label={t("schedule.editCourse")}
+                    label={t("common.edit")}
                     isDark={isDark}
                     onPress={() => onEdit(course)}
                   />
                 )}
+                {onShare && (
+                  <DetailActionButton
+                    icon="qr-code-outline"
+                    label={t("common.share")}
+                    isDark={isDark}
+                    onPress={() => onShare(course)}
+                  />
+                )}
                 {onAddAtSameSlot && (
                   <DetailActionButton
                     icon="add-circle-outline"
-                    label={t("schedule.addAtSameSlot")}
+                    label={t("common.add")}
                     isDark={isDark}
                     onPress={() => onAddAtSameSlot(course)}
                   />

components/layout/schedule.tsx

@@ -21,6 +21,7 @@ import {
   View,
 } from "react-native";
 
+import { CourseShareSheet } from "@/components/share/course-share-sheet";
 import { WEEKDAY_KEYS } from "@/constants/weekdays";
 import { MAX_WEEK } from "@/lib/course-weeks";
 import { useColorScheme } from "@/hooks/use-color-scheme";
@@ -392,6 +393,7 @@ export function Schedule({
   const blurTarget = useAndroidBlurTarget();
   const [selected, setSelected] = useState<Course | null>(null);
   const [slotCourses, setSlotCourses] = useState<Course[] | null>(null);
+  const [shareName, setShareName] = useState<string | null>(null);
   const [quickAddSlot, setQuickAddSlot] = useState<QuickAddSlot | null>(null);
 
   // 周末模式下的横向滚动容器
@@ -584,6 +586,13 @@ export function Schedule({
     });
   };
 
+  const handleShareCourse = (course: Course) => {
+    haptic();
+    setSelected(null);
+    setSlotCourses(null);
+    setShareName(course.name);
+  };
+
   const openQuickAddForCourse = (course: Course) => {
     // 始终用完整分组对齐，避免在 compact 模式下（layout.groups 不含 6/7/13 节）
     // 课程 sectionStart 找不到分组导致"添加课程"按钮静默失效。
@@ -815,9 +824,15 @@ export function Schedule({
         showOtherWeekTag={!!selected && !isInCurrentWeek(selected)}
         onClose={() => setSelected(null)}
         onEdit={handleEditCourse}
+        onShare={handleShareCourse}
         onAddAtSameSlot={openQuickAddForCourse}
       />
 
+      <CourseShareSheet
+        courseName={shareName}
+        onClose={() => setShareName(null)}
+      />
+
       <Modal
         visible={!!slotCourses}
         transparent

components/share/course-share-sheet.tsx

@@ -0,0 +1,36 @@
+import { useMemo } from "react";
+
+import { ShareSheet } from "@/components/share/share-sheet";
+import { useT } from "@/lib/i18n";
+import { buildCourseSingleScanEnvelope } from "@/lib/scan";
+import { useCourseStore } from "@/store/course";
+
+export function CourseShareSheet({
+  courseName,
+  onClose,
+}: Readonly<{
+  courseName: string | null;
+  onClose: () => void;
+}>) {
+  const t = useT();
+  const courses = useCourseStore((s) => s.courses);
+
+  const envelope = useMemo(() => {
+    if (!courseName) return null;
+    const records = courses.filter((c) => c.name === courseName);
+    if (records.length === 0) return null;
+    return buildCourseSingleScanEnvelope(records);
+  }, [courseName, courses]);
+
+  if (!envelope) return null;
+
+  return (
+    <ShareSheet
+      visible
+      onClose={onClose}
+      title={t("scan.courseShareTitle")}
+      description={t("scan.courseShareDesc")}
+      envelope={envelope}
+    />
+  );
+}

components/scan/scan-code-sheet.tsx components/share/share-sheet.tsxcomponents/scan/scan-code-sheet.tsx renamed to components/share/share-sheet.tsx

@@ -1,5 +1,5 @@
 import * as Clipboard from "expo-clipboard";
-import { useEffect, useState } from "react";
+import { useEffect, useMemo, useState } from "react";
 import { ActivityIndicator, Pressable, Share, Text, View } from "react-native";
 import QRCode from "qrcode";
 import { SvgXml } from "react-native-svg";
@@ -8,28 +8,52 @@ import Toast from "react-native-toast-message";
 import { BottomSheet } from "@/components/ui/bottom-sheet";
 import { useHaptics } from "@/hooks/use-haptics";
 import { useT } from "@/lib/i18n";
-import { QR_SAFE_BYTE_LIMIT, utf8ByteLength } from "@/lib/scan";
+import {
+  QR_SAFE_BYTE_LIMIT,
+  type ScanEnvelope,
+  utf8ByteLength,
+} from "@/lib/scan";
+import { buildShareArtifacts, resolveShortLink } from "@/lib/share";
 
-export function ScanCodeSheet({
+export function ShareSheet({
   visible,
   onClose,
   title,
   description,
-  qrValue,
-  shareValue,
+  envelope,
 }: Readonly<{
   visible: boolean;
   onClose: () => void;
   title: string;
   description: string;
-  qrValue: string;
-  shareValue?: string;
+  envelope: ScanEnvelope;
 }>) {
   const t = useT();
   const haptic = useHaptics();
-  const link = shareValue ?? qrValue;
+
+  const { qrValue, deepLink } = useMemo(
+    () => buildShareArtifacts(envelope),
+    [envelope],
+  );
   const tooLarge = utf8ByteLength(qrValue) > QR_SAFE_BYTE_LIMIT;
 
+  const [shortLink, setShortLink] = useState<string | null>(null);
+  const link = shortLink ?? deepLink;
+
+  useEffect(() => {
+    if (!visible) return;
+    let cancelled = false;
+    setShortLink(null);
+    resolveShortLink(envelope)
+      .then((url) => {
+        if (!cancelled) setShortLink(url);
+      })
+      .catch(() => {});
+    return () => {
+      cancelled = true;
+    };
+  }, [envelope, visible]);
+
   const [qrResult, setQrResult] = useState<{
     value: string;
     svg: string | null;
@@ -69,7 +93,7 @@ export function ScanCodeSheet({
     await Clipboard.setStringAsync(link);
     Toast.show({
       type: "success",
-      text1: t("scan.codeCopied"),
+      text1: t("share.codeCopied"),
       position: "bottom",
     });
   };
@@ -89,13 +113,13 @@ export function ScanCodeSheet({
         <View className="h-64 w-64 items-center justify-center rounded-2xl bg-white p-3">
           {tooLarge ? (
             <Text className="px-2 text-center text-sm leading-5 text-neutral-500">
-              {t("scan.codeTooLarge")}
+              {t("share.codeTooLarge")}
             </Text>
           ) : qrSvg ? (
             <SvgXml xml={qrSvg} width={232} height={232} />
           ) : failed ? (
             <Text className="text-center text-sm text-red-500">
-              {t("scan.codeRenderFailed")}
+              {t("share.codeRenderFailed")}
             </Text>
           ) : (
             <ActivityIndicator />
@@ -109,15 +133,15 @@ export function ScanCodeSheet({
           onPress={copy}
         >
           <Text className="text-base font-medium text-neutral-600 dark:text-neutral-300">
-            {t("scan.copyCode")}
+            {t("share.copyCode")}
           </Text>
         </Pressable>
         <Pressable
           className="flex-1 items-center rounded-xl bg-blue-500 py-3 active:bg-blue-600"
           onPress={share}
         >
           <Text className="text-base font-medium text-white">
-            {t("scan.shareCode")}
+            {t("share.shareCode")}
           </Text>
         </Pressable>
       </View>