更新 readme

Author: chai2010

README-zh.md

@@ -167,6 +167,23 @@ $ cd waroot && wa run -target=wasi examples/prime
 
 运行的结果和英文语法的示例相同。
 
+## 例子：Chrome本地AI
+
+Chrome builtin Gemini Nano Demo:
+
+```wa
+import "ai"
+
+func main {
+	ai.RequestSession(func(session: ai.Session){
+		session.PromptAsync("Who are you?", func(res: string) {
+			println(res)
+		})
+	})
+}
+```
+
+
 更多例子 [waroot/examples](waroot/examples)
 
 ## 贡献者名单

README.md

@@ -168,6 +168,22 @@ Print prime numbers up to 30:
 
 Output is the same as the previous example.
 
+## Example: Chrome Native AI
+
+Chrome builtin Gemini Nano Demo:
+
+```wa
+import "ai"
+
+func main {
+	ai.RequestSession(func(session: ai.Session){
+		session.PromptAsync("Who are you?", func(res: string) {
+			println(res)
+		})
+	})
+}
+```
+
 More examples [waroot/examples](waroot/examples)
 
 ## Contributors

waroot/changelog.md

@@ -7,6 +7,7 @@
   - 预定义常量统一用大写字母, 并增加 `__COLUMN__` 常量
   - `wa build` 和 `wa run` 增加 `-optimize` 优化参数, 优化后输出体积大约为原来的 1/3 到 1/4
   - 优化 `wa run` 默认行为, 只有 wasi 默认命令行执行
+  - 实验性增加 Chrome 内置 AI 支持
 - v0.16.0 (2024-09-16)
   - “国产语言论坛”被动关闭: ~~https://zh-lang.osanswer.net~~
   - 增加 `__package__`/`__FILE__`/`__LINE__`/`__func__` 预定义常量, 表示当前位置信息

waroot/examples/hello-ai/README.md

@@ -12,9 +12,9 @@ func main {
 		session.PromptAsync("Who are you?", func(res: string) {
 			println(res)
 		})
-	} , "")
+	})
 }
-``
+```
 
 然后本地命令行环境执行`wa run`, 然后在打开的页面的开发者控制台可以看到以下输出:
 

waroot/examples/hello-ai/src/main.wa

@@ -7,5 +7,5 @@ func main {
 		session.PromptAsync("Who are you?", func(res: string) {
 			println(res)
 		})
-	} , "")
+	})
 }

waroot/src/ai/ai.wa

@@ -1,4 +1,3 @@
-
 import "js"
 
 global asyncTasks: js.TaskQueue
@@ -7,93 +6,111 @@ global asyncTasks: js.TaskQueue
 
 // Session 对象，不能使用该类型直接声明值，需通过 RequestSession 创建
 #wa:need-constructor
-type Session struct {
-    _extobj: js.ExtObj
+type Session :struct {
+	_extobj: js.ExtObj
 }
 
 // 获取 Session，异步
-#wa:generic RequestSession_Handler
+#wa:generic RequestSession_Handler RequestSessionSimple RequestSession_Handler_Simple
 func RequestSession(requestor: SessionRequestor, option: string) {
-    if requestor == nil  {
-        panic("SessionRequestor can't be nil.")
-    }
-    tid := asyncTasks.Alloc(nil, requestor)
-    jsAiRequestSession(tid, option)
+	if requestor == nil {
+		panic("SessionRequestor can't be nil.")
+	}
+	tid := asyncTasks.Alloc(nil, requestor)
+	jsAiRequestSession(tid, option)
+}
+func RequestSessionSimple(requestor: SessionRequestor) {
+	if requestor == nil {
+		panic("SessionRequestor can't be nil.")
+	}
+	tid := asyncTasks.Alloc(nil, requestor)
+	jsAiRequestSession(tid, "")
 }
-type SessionRequestor interface {
-    OnRequested(session: Session)
+
+type SessionRequestor :interface {
+	OnRequested(session: Session)
 }
 
 func RequestSession_Handler(handler: SessionRequestHandler, option: string) {
-    if handler == nil {
-        panic("SessionRequestHandler can't be nil.")
-    }
-    tid := asyncTasks.Alloc(nil, handler)
-    jsAiRequestSession(tid, option)
+	if handler == nil {
+		panic("SessionRequestHandler can't be nil.")
+	}
+	tid := asyncTasks.Alloc(nil, handler)
+	jsAiRequestSession(tid, option)
+}
+
+func RequestSession_Handler_Simple(handler: SessionRequestHandler) {
+	if handler == nil {
+		panic("SessionRequestHandler can't be nil.")
+	}
+	tid := asyncTasks.Alloc(nil, handler)
+	jsAiRequestSession(tid, "")
 }
-type SessionRequestHandler func(session: Session)
+
+type SessionRequestHandler :func(session: Session)
 
 #wa:import aiproxy request_session
 func jsAiRequestSession(tid: int, option: string)
 
 #wa:export ai.onSessionRequested
 func onSessionRequested(tid: int, sh: js.Handle) {
-    _, handler := asyncTasks.Get(tid)
-    session: Session
-    session._extobj = js.WrapExtObj(sh)
+	_, handler := asyncTasks.Get(tid)
+	session: Session
+	session._extobj = js.WrapExtObj(sh)
 
-    switch h := handler.(type) {
-    case SessionRequestor:
-        h.OnRequested(session)
+	switch h := handler.(type) {
+	case SessionRequestor:
+		h.OnRequested(session)
 
-    case SessionRequestHandler:
-        h(session)
-    }
+	case SessionRequestHandler:
+		h(session)
+	}
 
-    asyncTasks.Free(tid)
+	asyncTasks.Free(tid)
 }
 
 //---------------------------------------------------------------
 
 // 异步 prompt
 #wa:generic PromptAsync_Handler
 func Session.PromptAsync(key: string, prompter: Prompter) {
-    if prompter == nil {
-        panic("Prompter can't be nil.")
-    }
-    tid := asyncTasks.Alloc(this, prompter)
-    jsPromptAsync(tid, this._extobj.GetHandle(), key)
+	if prompter == nil {
+		panic("Prompter can't be nil.")
+	}
+	tid := asyncTasks.Alloc(this, prompter)
+	jsPromptAsync(tid, this._extobj.GetHandle(), key)
 }
-type Prompter interface {
-    OnPrompted(result: string)
+
+type Prompter :interface {
+	OnPrompted(result: string)
 }
 
 func Session.PromptAsync_Handler(key: string, handler: PromptHandler) {
-    if handler == nil {
-        panic("BufferMapHandler can't be nil.")
-    }
-    tid := asyncTasks.Alloc(this, handler)
-    jsPromptAsync(tid, this._extobj.GetHandle(), key)
+	if handler == nil {
+		panic("BufferMapHandler can't be nil.")
+	}
+	tid := asyncTasks.Alloc(this, handler)
+	jsPromptAsync(tid, this._extobj.GetHandle(), key)
 }
-type PromptHandler func(result: string)
+
+type PromptHandler :func(result: string)
 
 #wa:import aiproxy prompt
 func jsPromptAsync(tid: int, session: js.Handle, key: string)
 
 #wa:export ai.onPrompted
 func onPrompted(tid: int, result: string) {
-    _, handler := asyncTasks.Get(tid)
+	_, handler := asyncTasks.Get(tid)
 
-    switch h := handler.(type) {
-    case Prompter:
-        h.OnPrompted(result)
+	switch h := handler.(type) {
+	case Prompter:
+		h.OnPrompted(result)
 
-    case PromptHandler:
-        h(result)
-    }
+	case PromptHandler:
+		h(result)
+	}
 
-    asyncTasks.Free(tid)
+	asyncTasks.Free(tid)
 }
 
 //---------------------------------------------------------------
-