@rtc-agent/component 0.2.7-rc.4 → 0.2.8-rc.0

package/README.md

@@ -133,7 +133,7 @@ RTC Agent 使用 SharedWorker + Comlink 架构实现多 Tab 共享：
 - 共享 IndexedDB 存储
 - Master Tab 选举（Web Locks API）
 
-详细设计见 [docs/shared-worker-proposal.md](../../docs/shared-worker-proposal.md)。
+详细配置见 [SharedWorker 配置指南](./SHARED-WORKER-SETUP.md)。
 
 ### 公开属性
 
@@ -142,39 +142,41 @@ RTC Agent 使用 SharedWorker + Comlink 架构实现多 Tab 共享：
 | `theme` | `'light' \| 'dark' \| 'system'` | `'system'` | 主题 |
 | `app-label` | `string` | `'RTC Agent'` | 标题栏 / 气泡 tooltip 文本 |
 | `bubble-icon` | `string` | `''` | 最小化气泡内的 SVG / HTML |
+| `logo` | `{ light?: string; dark?: string } \| null` | `null` | 自定义 Logo（light/dark 两套） |
+| `worker-url` | `string` | `''` | SharedWorker 文件 URL |
 | `scenarios-url` | `string` | `''` | Scenario 文档 URL |
 | `agentConfig` | `AgentConfig \| null` | `null` | 声明式函数注册 |
 | `registry` | `FunctionRegistry \| null` | `null` | 命令式函数注册（高级） |
 
 ### 公开事件
 
-所有公开事件遵循 `rtc-agent-<event>` 命名模式：
+所有公开事件遵循 `rtc-<event>` 命名模式：
 
 **生命周期事件：**
 
 - `rtc-agent-ready` — 组件就绪
-- `rtc-agent-beforeDestroy` — 组件即将销毁
-- `rtc-agent-themeChange` — 主题变化
+- `rtc-before-destroy` — 组件即将销毁
+- `rtc-theme-change` — 主题变化
 
 **消息拦截事件：**
 
-- `rtc-agent-beforeMessageSend` — 消息发送前（可取消或修改）
+- `rtc-before-message-send` — 消息发送前（可取消或修改）
 
-**工具调用事件：**
+**工具调用事件（EventBus 桥接，通过 `on` 配置注册）：**
 
-- `rtc-agent-toolCallStart` — 工具调用开始
-- `rtc-agent-toolCallSuccess` — 工具调用成功
-- `rtc-agent-toolCallError` — 工具调用失败
-- `rtc-agent-toolCallProgress` — 工具调用进度
+- `toolCallStart` — 工具调用开始
+- `toolCallSuccess` — 工具调用成功
+- `toolCallError` — 工具调用失败
+- `toolCallProgress` — 工具调用进度
 
 **会话和消息事件：**
 
-- `rtc-session-created` / `rtc-session-switched`
-- `rtc-message-sent`
+- `rtc-session-created` / `rtc-session-switched` / `rtc-session-renamed` / `rtc-session-deleted`
+- `rtc-message-sent` / `rtc-message-received`
 
 **认证事件：**
 
-- `rtc-auth-login-requested`
+- `rtc-auth-login-requested` / `rtc-auth-login` / `rtc-auth-refresh-failed` / `rtc-auth-logout`
 
 ### 控制器访问
 
@@ -186,6 +188,100 @@ agent.messageController.actions.sendMessage(content);
 agent.skillController.actions.setRegistry(registry);
 ```
 
+## 代码高亮
+
+消息中的代码块使用 highlight.js 进行语法高亮。为控制包体积，组件按需注册了 15 种常用语言（含别名）：
+
+| 类别 | 语言 | 别名 |
+| --- | --- | --- |
+| Web 开发 | JavaScript, TypeScript, XML, CSS, JSON | `js`, `ts`, `html`, `yml` |
+| 后端/系统 | Python, Go, Bash, YAML, SQL | `py`, `golang`, `sh`, `shell` |
+| 配置/标记 | Markdown, Diff, Plaintext | `md`, `text` |
+
+未注册的语言将回退到无高亮纯文本渲染。如需扩展支持的语言，可在宿主应用中通过 `hljs.registerLanguage()` 注册额外语言包（需自行引入 highlight.js）。
+
+## 稳定性与已知问题
+
+### v0.2.8-rc.0 会话导出与 Function Debugger
+
+本次发布引入会话导出功能和 Function Debugger 面板，并包含多项稳定性修复。
+
+**会话导出功能**：
+
+- 新增 `/export` 斜杠命令，支持将当前会话导出为静态 HTML 文件
+- 导出选项对话框支持配置：消息数量限制、是否包含 tool calls、是否包含 thinking
+- HTML 导出使用 highlight.js 代码高亮，支持离线阅读和分享
+- 消息分类渲染：用户/助手消息展开显示，tool calls/thinking 等折叠显示
+
+**Function Debugger**：
+
+- 新增 Function Debugger 面板，支持查看函数调用历史
+- 历史记录迁移到 IndexedDB，支持分页加载
+- Activity Bar 配置重构，functions 显隐统一到 `disabledActivities` 数组
+
+**Tool Call 增强**：
+
+- `todoWrite` 工具支持专门的渲染卡片
+- Tool call 卡片支持点击复制 function name
+
+**稳定性修复**：
+
+- 修复 AuthProvider 未传递 `getUserId` 导致数据库隔离问题
+- 修复 Vite HMR 时 React StrictMode 下的登出问题
+- 修复 SharedWorker 连接在 tab 强制关闭后的 stale 连接问题
+- 修复 JSON console output 的双重序列化问题
+
+**文档更新**：
+
+- 添加代码高亮文档，说明支持的 15 种语言
+- 更新 SharedWorker 设置指南
+- 同步事件系统文档与实现
+
+### v0.2.7-rc.3 稳定性改进
+
+本次发布包含多项稳定性和数据一致性修复：
+
+**Worker 连接稳定性**：
+
+- 开发模式下使用带时间戳的 Worker 名称（`rtc-agent-worker-dev-{timestamp}`），避免连接到调试会话残留的 stale Worker
+- 改进 Worker 验证超时错误信息，提供清晰的 `chrome://inspect/#workers` 手动清理指引
+- 动态模块加载（DOMPurify、highlight.js）增加自动重试机制（2 次尝试），处理 chunk hash 过期问题
+
+**数据一致性保护**：
+
+- VirtualFS 读-改-写操作包装在事务中，防止并发写入导致数据损坏
+- `handleEditorSave` 增加 per-file 并发锁，防止 Ctrl+S 与自动-save 并行写入时旧内容覆盖新内容
+- `flushGapFillBuffer` 延迟 offset 推进，确保数据持久化成功后才移动游标，防止永久数据丢失
+
+**React StrictMode 兼容**：
+
+- 修复 `connectedCallback → disconnectedCallback → connectedCallback` 生命周期竞态
+- `RtcProcessor` 增加 `cancel()` 方法，支持组件卸载时优雅关闭 RTC 循环
+- Master Tab 切换时立即退出处理循环，防止与新 Master 并发执行
+
+**UI 与事件系统**：
+
+- 提取 `EventBindingController`，集中管理 30+ DOM 事件监听器
+- 验证错误消息翻译为英文，与 Agent 提示语言保持一致
+
+### 开发环境注意事项
+
+**SharedWorker 残留问题**：
+
+如果在调试过程中遇到无限递归或其他严重错误导致 Tab 强制终止，SharedWorker 可能处于不一致状态。解决方法：
+
+1. 访问 `chrome://inspect/#workers`
+2. 终止名为 `rtc-agent-worker` 的 SharedWorker 实例
+3. 刷新页面
+
+开发模式下会自动避免此问题（每次加载创建新的 Worker 实例）。
+
+**动态模块加载失败**：
+
+组件库热重载后，如果遇到 "Failed to fetch dynamically imported module" 错误，组件会自动重试 2 次。如果仍然失败，清除浏览器缓存并重启开发服务器。
+
+详细故障排除指南见 [SharedWorker 配置指南](./SHARED-WORKER-SETUP.md#故障排除)。
+
 ## License
 
 [MIT](../../LICENSE)

package/dist/.generated/locales/en-US.d.ts

@@ -2,35 +2,45 @@ export declare const templates: {
     s0016a70887124d70: string;
     s01366f0961abde4c: string;
     s013e9b380fa77bee: import("@lit/localize").StrResult;
-    s028df6915f235766: string;
     s0293d842f6e611ae: string;
-    s03259582cecb7f6f: string;
     s035e62088a8f0790: string;
     s041e26088b672986: string;
     s056efa20c6a8b2e7: string;
     s0649af088d321069: string;
     s072cdcb911e30e5a: string;
     s099e7a9f8436eb13: string;
+    s09f39e7686bc7b12: string;
     s0df0b8096c673ba1: string;
+    s0e2db60893d059e4: string;
+    s0e4e4c846c34f036: string;
     s0f4f1bba95d2298b: string;
     s1030030894d624c7: string;
     s1031140894dad7d3: string;
+    s105944089541c74f: string;
     s112886089625cc92: string;
     s116379089658e1c2: string;
+    s11655be4b30fede6: string;
     s116b640896bcf4e1: string;
+    s116cee0896181b15: string;
     s116ef308966c6210: string;
     s1240310896b4f8b8: string;
+    s131c338472a22911: string;
+    s135bde3870514299: import("@lit/localize").StrResult;
+    s14a1840024c09831: import("@lit/localize").StrResult;
     s1511980899235644: string;
     s1513b208992f91ed: string;
+    s15a3e0089a35e30d: string;
     s15a45bb12c36294e: string;
     s15e8bb089a90e6bd: string;
     s169b937d864e2dd9: string;
+    s17284a089b388be8: string;
     s17cbdcb3d08e1faa: string;
     s19575e089d1dae1b: string;
+    s1aac76f0f5345d7c: string;
+    s1b3be8769609cc19: string;
     s1b4a39089e8e0ba6: string;
     s1b8b53f0f6b4d555: string;
     s1cc47dc4d80a1842: string;
-    s1e3b8c46001e3962: string;
     s2046a88742040df7: import("@lit/localize").StrResult;
     s21bea120f4f64d80: import("@lit/localize").StrResult;
     s222bafc5622c3fd0: string;
@@ -38,10 +48,13 @@ export declare const templates: {
     s234934e1656e53a4: string;
     s239712be1485333a: string;
     s23e84510a641ea77: string;
+    s253cca08a6b1c098: string;
     s2611be08a7910384: string;
     s28af5a8fabdda335: string;
     s28bbcff0ca38cbfa: string;
+    s2b24c608abd8b973: string;
     s2bf07bb911ff2d3d: string;
+    s2e5c781bb630d349: string;
     s2f834ec7550c9db3: string;
     s2f94de08af7c2cd1: string;
     s2fa45d68e8e7c9db: string;
@@ -50,15 +63,20 @@ export declare const templates: {
     s34169a7f5e3cb214: string;
     s356dec08b50028d3: string;
     s3712d672f4315799: string;
+    s387bc87d440bc5ad: string;
     s38a3347d83d583d3: string;
+    s395c3508b86010f1: string;
     s3bd3f018e0432f30: string;
     s3bf2e6dab30ef3f6: string;
     s3d70bc709c396bfd: string;
+    s3db3bf246500402c: string;
     s3faeacd5ca504f5d: string;
     s4005447f5c22615f: string;
     s40ed993dc74df287: string;
     s42226a08bfe2c3f0: string;
+    s4234dfe5c862ffeb: string;
     s43fefc62381b84ab: string;
+    s46e8259bbcd7df58: string;
     s47960b97d8d2ef8c: string;
     s486b44ffdbc324a4: string;
     s48d771522e54d62f: string;
@@ -66,31 +84,39 @@ export declare const templates: {
     s49a0df2ed77024c0: string;
     s4ac9679f256d437d: import("@lit/localize").StrResult;
     s4c5ab7fb1d23cc62: string;
+    s4fc0d048d8433bde: string;
     s5007a4b7896f1b7a: string;
     s517d88be67d6e3a1: string;
     s51b507b884967f54: string;
     s53d0584edced7d5f: import("@lit/localize").StrResult;
+    s54ac4b7ff12547c5: string;
     s5534ea14f2cc2b87: string;
     s56afba1902e970ea: string;
     s57fed4463f34bb30: string;
     s58001194e857ab9e: string;
+    s5a4967f99deadf5f: string;
+    s5c645b6e9f52886d: string;
+    s5d3c3f3c60ffc0c1: string;
     s5ecd97c510a4f3de: string;
     s60571c91c53b82fd: string;
-    s61b232fc4d1f652a: string;
     s6230bbe9df46da66: string;
     s642cc600292d5ea7: string;
     s66f8df91e53055b9: string;
     s69d4b7b972b239d4: string;
+    s6a580dd9b55d003e: string;
     s6beb126e6d1c828e: string;
     s6c43bf7ffc56685f: string;
     s6d4e9348f09b8cd1: string;
     s6d5204080aabb951: string;
+    s6dd2d6080ba660ea: string;
     s6e6fcdcdc7f1d8ed: string;
+    s6e9e88739bc12d4c: string;
     s6f5e80d8df78807c: string;
     s6f6ff6080ce73d26: string;
     s6ffdf1b6d6afe7b5: string;
     s7005b25019cc68ec: import("@lit/localize").StrResult;
     s74d863b5dab8f5a3: string;
+    s751d17081136b578: string;
     s756e3761c6bda497: string;
     s783adf081440d848: string;
     s7a3a550815a6de71: string;
@@ -100,25 +126,29 @@ export declare const templates: {
     s7fbb7359d395acdc: string;
     s8113c0081bda9c10: string;
     s813535081c1375df: string;
-    s814dfb26b607cdf3: string;
     s81522d081c024698: string;
+    s8162a1081c0a0595: string;
     s825b1a7334e42ce8: string;
     s835830081d3105a9: string;
     s85677cf9448ac90e: string;
     s87df31162aa2c32d: string;
     s88a3ac78fc8c5c69: string;
+    s89cc810afc952547: import("@lit/localize").StrResult;
+    s8a88dde2b0e3d4e2: string;
     s8baa4f887fe090f0: import("@lit/localize").StrResult;
     s8d10f47b7be30353: string;
     s8e904bba6bce5305: string;
     s8f39c831592be416: string;
     s90ec41e502050332: string;
     s912a87b19f6ee361: string;
+    s9259c59fc1ab601b: string;
     s95203a8a3bd01de5: import("@lit/localize").StrResult;
     s956e8dd8b5855dee: string;
     s962bdbdeeca87ed7: string;
+    s974744082ed5612e: string;
     s98c96ddda9eb32e5: string;
-    s999e1da626842b8c: string;
     s9a3854a632c60986: string;
+    s9af1764f80413fbb: string;
     s9b36eca633645997: string;
     s9b9f3c08329ae856: string;
     s9c255408322fd48a: string;
@@ -130,26 +160,30 @@ export declare const templates: {
     sa062c958bd25c534: string;
     sa0ed14fd850830c6: string;
     sa1230a5be083ab6a: string;
-    sa33d70ea05452700: string;
     sa74001c408f0c766: string;
+    sa752a6d9e9728b78: string;
     sa75dc5fb5e59f435: string;
     sa7aa088d79fc05bb: string;
     sa89c48e09a724a1a: import("@lit/localize").StrResult;
     sa8a184ccbfdd1145: string;
     sa99214edf2192eb6: string;
+    sac0458d68b5c8b73: string;
     sac9eec7e70455963: string;
     sadea7069d35b5725: string;
+    sadeb4474860a6375: string;
     saf85a24c863b4ffe: string;
     safb79b4c86903a19: string;
     sb32373084660391d: string;
     sb330c4084676d9c0: string;
     sb3ce019fa1dd0ac1: import("@lit/localize").StrResult;
     sb413b6091ff8ea35: string;
+    sb9775a7db22f4988: string;
     sba5f9c092611d8af: string;
     sba8df9c0de68d224: string;
     sbc25ddf9669f1a6e: string;
     sbc651b0927b335dc: string;
     sbde5411128e19ff9: string;
+    sbf288fc6928ca3de: string;
     sbfd8fcb2d22028e7: string;
     sc0ea59c46f0381fa: import("@lit/localize").StrResult;
     sc4fc0e6eb8473f10: string;
@@ -160,6 +194,7 @@ export declare const templates: {
     sc78f100857f6faef: string;
     sc81820b7ef327434: string;
     sc8642c233baa3709: string;
+    sc98997e0e9944d8d: import("@lit/localize").StrResult;
     sc992ab0858c53e28: string;
     sca6fb271b73ed1e1: string;
     scad05556becd2c42: string;
@@ -171,19 +206,29 @@ export declare const templates: {
     sce1b842370d4db0c: string;
     scf9e1bf93156a843: string;
     sd0236d545cb80b16: string;
+    sd03a6a085efe167a: string;
     sd06ce7085f313af5: string;
+    sd07f7841388d4f68: string;
     sd14166351f66ba7a: string;
     sd1fbeecd54907e11: string;
     sd3263a7a96df83b8: string;
     sd32c4c18db924931: string;
     sd3f11dfa2287048c: string;
+    sd52ab5086352f443: string;
     sd6033e5780676c2b: string;
+    sd6edb44c5859c745: string;
+    sd76245f332c51ea2: string;
+    sd7c5a28b8e06a0fc: string;
     sd8bf93698cb1b49e: string;
     sd959e77c2a48c8e5: string;
+    sdae148f01d938da7: string;
     sdaf29b61b062ec42: string;
+    sdb3c0da90bf80180: string;
     sdc04230409cbaa04: string;
+    sdc131c0942088919: string;
     sdce945c24ad44e16: string;
     sdd5a7cb7d074a219: import("@lit/localize").StrResult;
+    sdd83a682a05ea0b1: string;
     sdd9f19f38158a338: import("@lit/localize").StrResult;
     sddd11705d58eb498: string;
     sded54abab00e3aa8: string;
@@ -203,12 +248,15 @@ export declare const templates: {
     seac90f283e7fd6c7: string;
     sec24c2a678528b50: string;
     sec6e6ce73af02035: string;
+    sedc12275baa03e2c: string;
     seec4d689a0c51623: string;
     sf1136409548a9686: string;
     sf1380a0954b4a679: string;
     sf14eef0954efc3b7: string;
     sf23abf0955854338: string;
+    sf3925ca5791c14d2: string;
     sf48abfbac2896b17: string;
+    sf517c24157589a6f: string;
     sf9233eede445eae0: string;
     sfb9613db0964d8c0: string;
     sfb96d9095ccbf1e1: string;

package/dist/.generated/locales/en-US.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en-US.d.ts","sourceRoot":"","sources":["../../../src/.generated/locales/en-US.ts"],"names":[],"mappings":"AAUI,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0NrB,CAAC"}
+{"version":3,"file":"en-US.d.ts","sourceRoot":"","sources":["../../../src/.generated/locales/en-US.ts"],"names":[],"mappings":"AAUI,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0QrB,CAAC"}