Update doc for LLM chat

Author: brookhong

README.md

@@ -86,6 +86,8 @@ Surfingkeys is doing its best to make full use of keyboard for web browsing, but
 * Emoji completion in Insert mode
 * Rich hints for keystroke
 * Everything in Surfingkeys works for PDF
+* Regional Hints mode
+* Chat with LLM
 
 ## Quick start
 
@@ -157,9 +159,11 @@ Hints are placed in center of target links, you could add below line in your set
 
 Press `L` to enter regional Hints mode by picking a visually large element. There are some built-in actions in regional Hints mode,
 
+* `Esc` to exit regional hints mode
 * `ct` to copy text from target element
 * `ch` to copy HTML from target element
 * `d` to delete target element
+* `l` to chat with AI about the text of the element
 
 [Demo on YouTube](https://www.youtube.com/watch?v=pFPOzAZDO38)
 
@@ -598,6 +602,66 @@ Some functionalities are also available when you're using original pdf viewer, b
         }
     }`;
 
+## Chat with LLM
+There are several LLM providers integrated into Surfingkeys now, use `A` to call out a chat popup, and chat with your AI providers. The supported LLM providers now are
+
+* Ollama
+* Bedrock
+* DeepSeek
+* Gemini
+
+To use the feature, you need set up your credentials/API keys first, like
+
+        settings.defaultLLMProvider = "bedrock";
+        settings.llm = {
+            bedrock: {
+                accessKeyId: '********************',
+                secretAccessKey: '****************************************',
+                // model: 'anthropic.claude-3-5-sonnet-20241022-v2:0',
+                model: 'us.anthropic.claude-3-7-sonnet-20250219-v1:0',
+            },
+            gemini: {
+                apiKey: '***************************************',
+            },
+            ollama: {
+                model: 'qwen2.5-coder:32b',
+            },
+            deepseek: {
+                apiKey: '***********************************',
+                model: 'deepseek-chat',
+            }
+        };
+
+You can also use `A` in visual mode. Press `v` or `V` to enter visual mode, then `v` again to select the text you'd like to chat with AI about, then `A` to call out the LLM chat box. Now start to chat with AI about the selected text.
+
+Another solution to select the content to chat with AI about is Regional Hints mode. Press `L` to pick an element, then `l` to call out the LLM chat box.
+
+### To use LLM chat with specified system prompt
+
+For example, you can designate your AI to be a translator with below snippets
+
+    api.mapkey('A', '#8Open llm chat', function() {
+        api.Front.openOmnibar({type: "LLMChat", extra: {
+            system: "You're a translator, whenever you got a message in Chinese, please just translate it into English, and if you got a message in English, please translate it to Chinese. You don't need to answer any question, just TRANSLATE."
+        }});
+    });
+
+### 403 Forbidden with Ollama
+
+To use Ollama with Chrome extension, you need run ollama with some modification on `OLLAMA_ORIGINS`
+
+Under Windows
+
+    OLLAMA_ORIGINS=chrome-extension://* ollama serve
+
+Under Mac
+
+    launchctl setenv OLLAMA_ORIGINS chrome-extension://gfbliohnnapiefjpjlpjnehglfpaknnc
+
+Under Mac for both Chrome and Firefox
+
+    launchctl setenv OLLAMA_ORIGINS "chrome-extension://gfbliohnnapiefjpjlpjnehglfpaknnc,moz-extension://*"
+
 ## API Documentation
 
 > The API documentation is currently a work in progress.

README_CN.md

@@ -68,6 +68,8 @@ Surfingkeys尽量让用户使用键盘进行网页浏览，但有些限制是Goo
 * 插入模式下的表情下拉选项
 * 按键实时提示
 * 所有按键对PDF适用
+* Regional Hints mode
+* 大语言模型对话
 
 ## 快速上手
 
@@ -139,9 +141,11 @@ Surfingkeys有三种模式：normal，visual和insert。
 
 按`L`键选择一个大块元素进入Regional Hints mode，目前自带的操作有
 
+* `Esc` 退出Regional Hints mode
 * `ct` 复制该大块元素的文本
 * `ch` 复制该大块元素的HTML
 * `d` 删除该大块元素
+* `l` 与大语言模型讨论选中文本
 
 [Demo on YouTube](https://www.youtube.com/watch?v=pFPOzAZDO38)
 
@@ -583,6 +587,65 @@ Surfingkeys默认使用[这个markdown分析器](https://github.com/chjj/marked)
         }
     }`;
 
+## 大语言模型对话
+目前集成了比较常用的几个大语言模型，可用`A`调出对话窗口，
+
+* Ollama
+* Bedrock
+* DeepSeek
+* Gemini
+
+使用之前，必须设置相应的密钥或者API key，比如
+
+        settings.defaultLLMProvider = "bedrock";
+        settings.llm = {
+            bedrock: {
+                accessKeyId: '********************',
+                secretAccessKey: '****************************************',
+                // model: 'anthropic.claude-3-5-sonnet-20241022-v2:0',
+                model: 'us.anthropic.claude-3-7-sonnet-20250219-v1:0',
+            },
+            gemini: {
+                apiKey: '***************************************',
+            },
+            ollama: {
+                model: 'qwen2.5-coder:32b',
+            },
+            deepseek: {
+                apiKey: '***********************************',
+                model: 'deepseek-chat',
+            }
+        };
+
+你也可以在Visual mode下使用大语言模型对话。按`v`或`V`进入Visual mode，再按`v`选中你关注的文本，最后`A`按调出对话窗口，开始和AI就选中文本进行探讨。
+另一个方式是使用Regional Hints mode选择需要与AI进行探讨的内容。按`L`选择一个区域，再按`l`调出对话窗口。
+
+### 指定系统提示词
+
+比如，你可以这样限定你的AI只做中英文互译
+
+    api.mapkey('A', '#8Open llm chat', function() {
+        api.Front.openOmnibar({type: "LLMChat", extra: {
+            system: "You're a translator, whenever you got a message in Chinese, please just translate it into English, and if you got a message in English, please translate it to Chinese. You don't need to answer any question, just TRANSLATE."
+        }});
+    });
+
+### 403 Forbidden with Ollama
+
+在Chrome扩展中使用Ollama，你需要在启动ollama时指定`OLLAMA_ORIGINS`
+
+Windows下
+
+    OLLAMA_ORIGINS=chrome-extension://* ollama serve
+
+Mac下
+
+    launchctl setenv OLLAMA_ORIGINS chrome-extension://gfbliohnnapiefjpjlpjnehglfpaknnc
+
+Mac下同时允许在Chrome和Firefox里使用
+
+    launchctl setenv OLLAMA_ORIGINS "chrome-extension://gfbliohnnapiefjpjlpjnehglfpaknnc,moz-extension://*"
+
 ## 编译
 
     npm install