ActCLI网络聊天桥（实验）
概述
- 目的：人类协作桥梁，让精算师从任何网络聊天UI加入ActCLI研讨会。
- 范围：元素选择器+选择器配置文件（每个源），验证流，存储。没有特定于提供商的自动化。
- 集成：未来MCP将调用Semhost的participants.register/eparticipants.message/events.log。
状态
- 仅限MVP脚手架：清单、弹出窗口、背景、内容覆盖和本地游乐场页面。
- ToS安全：仅限OSS测试；没有提及专有聊天提供商。
装载未包装
- 打开chrome://extensions → 启用开发者模式
- 装载时未包装→ 选择
ActCLI-Extensions/ - 打开测试页面（请参阅
playground/)然后单击扩展图标。
基本流程
- 拾取元素：单击输入→ send → 历史。
- 验证：模拟打字和发送；观察历史。
- 配置文件：通过按来源存储
chrome.storage.local. - MCP：在弹出窗口中配置Semhost URL，操作将POST到
/mcp/rpc并简要流/mcp/sse完成作业（记录到的事件out/audit.json). - 提示：如果聊天是通过键盘提交的（例如，Enter或Ctrl+Enter），在“发送”阶段选择时，请按输入上的实际组合键。配置文件存储了一个基于键盘的发送操作，Validate将在输入上合成该击键（带有表单提交回退）。
游乐场
- 启动静态服务器或直接打开文件：
- playground/textarea.html - playground/contenteditable.html - playground/virtualized.html - playground/iframe.html
选择器发动机测试（A2）
- 打开
tests/selectors.spec.html在浏览器中。该页面报告了核心启发式的通过/失败。 - 无依赖关系；完全在客户端运行。
学期整合（A5）
- 宣传工具：
participants.register,participants.message,events.log. - 连接：使用生成的id注册参与者并记录事件。
- 验证：记录
events.log记录包括是否观察到历史附加。
编剧技巧（PW精通）
- 始终使用持久的Chromium上下文加载MV3扩展；保持
headless: false. - 通过HTTP（而非file://）为Playground提供服务：
python -m http.server 4400→http://127.0.0.1:4400. - 集
EXTENSION_PATH指向此文件夹的绝对路径（包含manifest.json). - 在交互之前，请等待MAIN‑world调试API：
- await page.waitForFunction(() => Boolean(window.__actcli_bridge?.pick)).
- 首选通过MAIN‑world调试API驱动流，以避免弹出交互。
- 对于iframe，请使用
frameLocator并且在帧的页面上下文中调用API。 - 捕获控制台/页面错误以加速调试：
- page.on('console', ...) 和 page.on('pageerror', ...).
- 如果环境缓慢，则碰撞超时：
--timeout=60000或按步骤等待。 - 清除过时的配置文件：删除
.pw-chrome-profile*在tests/e2e/在重新运行之前。 - 看
tests/e2e/README.md了解完整的故障排除和示例。
备注
- 这是普通的JS/HTML；不需要bundler。保持最小权限。
- 该代码有意避免后台自动化，并尊重人类节奏的使用。