feat(extension): improve server connection handling and add sponsor

- Add graceful handling when Huntly server connection fails, showing
  warning and allowing AI features to work with external providers
- Hide Huntly AI option in toolbar when server is not connected
- Fix shortcuts_preview message being sent twice by adding skipPreview
  flag when preview is already open
- Bump extension version to 0.5.2
- Add jtsang4 to sponsors list

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: lcomplete

README.md

@@ -149,5 +149,6 @@ Thank you to all our sponsors for your generous support!
     <td align="center"><a href="https://www.jetbrains.com/">jetbrains</a></td>
     <td align="center"><a href="https://taresky.com/">TARESKY</a></td>
     <td align="center"><a href="https://x.com/Db9el25LULCBrcn">抹茶</a></td>
+    <td align="center"><a href="https://github.com/jtsang4">jtsang4</a></td>
   </tr>
 </table>

README.zh.md

@@ -149,5 +149,6 @@ sudo xattr -r -d com.apple.quarantine /YOUR_PATH/Huntly.app
     <td align="center"><a href="https://www.jetbrains.com/">jetbrains</a></td>
     <td align="center"><a href="https://taresky.com/">TARESKY</a></td>
     <td align="center"><a href="https://x.com/Db9el25LULCBrcn">抹茶</a></td>
+    <td align="center"><a href="https://github.com/jtsang4">jtsang4</a></td>
   </tr>
 </table>

app/extension/public/manifest.json

@@ -1,8 +1,8 @@
 {
   "manifest_version": 3,
   "name": "Huntly",
-  "description": "AI shortcuts (summarization, bilingual translation, key points extraction, etc.), auto-saves web pages and tweets, and provides immersive article preview.",
-  "version": "0.5.1",
+  "description": "Huntly - AI shortcuts (summarization, bilingual translation, key points extraction, etc.), auto-saves web pages and tweets, and provides immersive article preview.",
+  "version": "0.5.2",
   "options_ui": {
     "page": "options.html",
     "open_in_tab": true

app/extension/src/background.ts

@@ -27,32 +27,11 @@ function cancelVercelAITask(taskId: string): boolean {
   return false;
 }
 
-function startProcessingWithShortcuts(task: any, shortcuts: any[]) {
+function startProcessingWithShortcuts(task: any, shortcuts: any[], skipPreview: boolean = false) {
   if (!task) return;
-  
-  chrome.tabs.sendMessage(task.tabId, {
-    type: 'shortcuts_preview',
-    payload: {
-      shortcuts: shortcuts,
-      taskId: task.taskId,
-      page: {
-          title: task.title,
-          content: task.content,
-          url: task.url,
-          description: "",
-          thumbUrl: "",
-          author: "",
-          siteName: "",
-          language: "",
-          category: "",
-          isLiked: false,
-          isFavorite: false,
-          domain: "",
-          faviconUrl: "",
-          contentType: task.contentType, // Pass contentType for snippet mode
-      }
-    }
-  }, function(response) {
+
+  // Function to start the actual processing
+  const startProcessing = () => {
     // 发送处理开始的消息
     chrome.tabs.sendMessage(task.tabId, {
       type: 'shortcuts_processing_start',
@@ -62,22 +41,22 @@ function startProcessingWithShortcuts(task: any, shortcuts: any[]) {
         taskId: task.taskId
       }
     });
-    
+
     let accumulatedContent = "";
-    
+
     // 使用新的 SSERequestManager 处理文章内容
     sseRequestManager.processContentWithShortcutStream(
       task.taskId,
       task.tabId,
-      task.content, 
+      task.content,
       task.shortcutId,
       task.shortcutName,
       task.url,
       task.title, // 传递文章标题
       // onData callback - 接收流式数据
       (data: string, taskId: string) => {
         accumulatedContent += data;
-        
+
         // 发送流式数据到预览页面
         try {
           chrome.tabs.sendMessage(task.tabId, {
@@ -114,7 +93,7 @@ function startProcessingWithShortcuts(task: any, shortcuts: any[]) {
       // onError callback - 处理错误
       (error: any, taskId: string) => {
         console.error("Error processing with shortcut for task:", taskId, error);
-        
+
         try {
           chrome.tabs.sendMessage(task.tabId, {
             type: 'shortcuts_process_error',
@@ -129,6 +108,39 @@ function startProcessingWithShortcuts(task: any, shortcuts: any[]) {
         }
       }
     );
+  };
+
+  // If preview is already open, skip sending shortcuts_preview message
+  if (skipPreview) {
+    startProcessing();
+    return;
+  }
+
+  // Send shortcuts_preview to open the preview window first
+  chrome.tabs.sendMessage(task.tabId, {
+    type: 'shortcuts_preview',
+    payload: {
+      shortcuts: shortcuts,
+      taskId: task.taskId,
+      page: {
+          title: task.title,
+          content: task.content,
+          url: task.url,
+          description: "",
+          thumbUrl: "",
+          author: "",
+          siteName: "",
+          language: "",
+          category: "",
+          isLiked: false,
+          isFavorite: false,
+          domain: "",
+          faviconUrl: "",
+          contentType: task.contentType, // Pass contentType for snippet mode
+      }
+    }
+  }, function(response) {
+    startProcessing();
   });
 }
 
@@ -304,7 +316,8 @@ chrome.runtime.onMessage.addListener(function (msg: Message, sender, sendRespons
         contentType: msg.payload.contentType,
       };
       const shortcuts = msg.payload.shortcuts || [];
-      startProcessingWithShortcuts(task, shortcuts);
+      const skipPreview = msg.payload.skipPreview || false;
+      startProcessingWithShortcuts(task, shortcuts, skipPreview);
     } else {
       // Use Vercel AI SDK for other providers
       const task = {

app/extension/src/components/AIToolbar.tsx

@@ -76,6 +76,8 @@ export interface AIToolbarProps {
   externalModels?: ExternalModelsData;
   /** Initial selected model (used when auto-executing from popup) */
   initialSelectedModel?: ModelItem | null;
+  /** Hide Huntly AI option (e.g., when server is not connected) */
+  hideHuntlyAI?: boolean;
 }
 
 // Gradient definition for AI icon
@@ -98,6 +100,7 @@ export const AIToolbar: React.FC<AIToolbarProps> = ({
   externalShortcuts,
   externalModels,
   initialSelectedModel,
+  hideHuntlyAI = false,
 }) => {
   // Determine if using external data
   const useExternalShortcuts = !!externalShortcuts;
@@ -152,6 +155,18 @@ export const AIToolbar: React.FC<AIToolbarProps> = ({
     }
   }, [initialSelectedModel]);
 
+  // Switch away from Huntly AI if it's hidden
+  useEffect(() => {
+    if (hideHuntlyAI && selectedModel?.provider === 'huntly-server') {
+      const nonHuntlyModel = models.find(m => m.provider !== 'huntly-server');
+      if (nonHuntlyModel) {
+        setSelectedModel(nonHuntlyModel);
+      } else {
+        setSelectedModel(null);
+      }
+    }
+  }, [hideHuntlyAI, selectedModel, models]);
+
   // Menu state
   const [shortcutAnchorEl, setShortcutAnchorEl] = useState<null | HTMLElement>(null);
   const [modelAnchorEl, setModelAnchorEl] = useState<null | HTMLElement>(null);
@@ -343,8 +358,8 @@ export const AIToolbar: React.FC<AIToolbarProps> = ({
     (showUserSystemPrompts && (userPrompts.length > 0 || systemPrompts.length > 0));
   const hasModels = models.length > 0;
 
-  // Group models by provider - only show Huntly AI when huntlyShortcutsEnabled is true
-  const huntlyModels = huntlyShortcutsEnabled
+  // Group models by provider - only show Huntly AI when huntlyShortcutsEnabled is true and not hidden
+  const huntlyModels = (huntlyShortcutsEnabled && !hideHuntlyAI)
     ? models.filter(m => m.provider === 'huntly-server')
     : [];
   const otherModels = models.filter(m => m.provider !== 'huntly-server');

app/extension/src/components/ArticlePreview.tsx

@@ -178,6 +178,7 @@ export const ArticlePreview: React.FC<ArticlePreviewProps> = ({
         title: isSnippetMode ? "" : page.title,
         contentType: isSnippetMode ? 4 : undefined,
         selectedModel: selectedModel,
+        skipPreview: true, // Preview is already open, skip shortcuts_preview message
       },
     });
   }, [isProcessing, currentTaskId, page, isSnippetMode]);

app/extension/src/popup.tsx

@@ -75,6 +75,7 @@ const Popup = () => {
     const [storageSettings, setStorageSettings] = useState<StorageSettings>(null);
     const [username, setUsername] = useState<string>(null);
     const [loadingUser, setLoadingUser] = useState(true);
+    const [serverConnectionFailed, setServerConnectionFailed] = useState(false);
     const [page, setPage] = useState<PageModel>(null);
     const [autoSavedPageId, setAutoSavedPageId] = useState<number>(0);
     const [articleOperateResult, setArticleOperateResult] = useState<PageOperateResult>(null);
@@ -151,16 +152,21 @@ const Popup = () => {
       if (!settings.serverUrl) {
         // No server enabled - still load page info for parsing, but skip server-related operations
         setLoadingUser(false);
+        setServerConnectionFailed(false);
         loadPageInfoOnly();
       } else {
         setLoadingUser(true);
+        setServerConnectionFailed(false);
         getLoginUserInfo().then((data) => {
           const result = JSON.parse(data);
           setUsername(result.username);
 
           loadPageInfo();
         }).catch(() => {
           setUsername(null);
+          // Server connection failed - still show article preview in read-only mode
+          setServerConnectionFailed(true);
+          loadPageInfoOnly();
         }).finally(() => {
           setLoadingUser(false);
         });
@@ -551,9 +557,9 @@ const Popup = () => {
                   <CircularProgress/>
                 </div>
               }
-              {/* Server configured but not signed in */}
+              {/* Server configured but not signed in and server is reachable */}
               {
-                !loadingUser && storageSettings?.serverUrl && !username && <div>
+                !loadingUser && storageSettings?.serverUrl && !username && !serverConnectionFailed && <div>
                   <div className={'mt-5'}>
                     <Alert severity={'info'}>Please sign in to start.</Alert>
                   </div>
@@ -562,9 +568,17 @@ const Popup = () => {
                   </div>
                 </div>
               }
-              {/* Server configured and signed in, or no server configured (read-only mode) */}
+              {/* Server configured and signed in, no server configured (read-only mode), or server connection failed */}
               {
-                !loadingUser && (username || !storageSettings?.serverUrl) && <div>
+                !loadingUser && (username || !storageSettings?.serverUrl || serverConnectionFailed) && <div>
+                  {/* Server connection failed warning */}
+                  {serverConnectionFailed && (
+                    <div className={'mb-2'}>
+                      <Alert severity={'warning'}>
+                        Cannot connect to Huntly server.
+                      </Alert>
+                    </div>
+                  )}
                   {/* RSS Feed Subscription Interface */}
                   {checkingRssFeed && (
                     <div className={'flex justify-center items-center h-[120px]'}>
@@ -662,8 +676,8 @@ const Popup = () => {
                       <div>
                         <div className={'flex items-center'}>
                           <TextField value={activePage.url} size={"small"} fullWidth={true} disabled={true}/>
-                          {/* Only show action buttons when server is configured and not on Huntly site */}
-                          {storageSettings?.serverUrl && !isHuntlySite && <div className={'grow shrink-0 pl-2'}>
+                          {/* Only show action buttons when server is configured, connected, and not on Huntly site */}
+                          {storageSettings?.serverUrl && !isHuntlySite && !serverConnectionFailed && <div className={'grow shrink-0 pl-2'}>
                             {
                               activeOperateResult?.readLater ? (
                                 <Tooltip title={"Remove from read later"}>
@@ -784,6 +798,7 @@ const Popup = () => {
                             onShortcutClick={handleAIShortcutClick}
                             isProcessing={processingShortcut}
                             compact={true}
+                            hideHuntlyAI={serverConnectionFailed}
                           />
                         </div>
                       </div>