示范图插件骨架脚本：纠偏实现、最小交付与验证方法

# 示范图插件骨架脚本：纠偏实现、最小交付与验证方法

## 摘要
本文记录“示范图”插件的纠偏开发过程。由于前一次实现误将目标写成 Hello World 注入脚本，且历史先例中不存在“示范图”插件的明确业务定义，因此本次遵循 Case Law 与最小偏离原则，停止在错误脚本上继续堆叠功能，改为新建“示范图”插件骨架，并仅交付一个可验证的 healthcheck-only 内容脚本。该脚本用于确认页面注入、插件标识、桥接通讯与未实现业务能力的显式返回。

## 关键词
示范图；浏览器插件；最小交付；健康检查；Case Law

## 1. 引言
当前可确认的信息仅包括插件名称“示范图”、浏览器配对码 `ghmrl8`，以及目标页面与禄得网转债页面相关。历史对话和 Wiki 文档中不存在“示范图”插件的现成实现，也没有关于图表类型、数据来源、触发方式与输出位置的完整定义。在此条件下，直接实现具体业务图表将产生较高误判风险。

## 2. 先例依据与决策
### 2.1 历史先例
通过 `get_conversation_history` 与 `wiki_search` 检索，已知先例主要集中于：
1. 禄得网回测收益率直方图脚本；
2. 群组文档 Hello World 测试文档；
3. 误建的 Hello World 转债页注入脚本。

### 2.2 Case Law 决策
相似情况沿用“先检索上下文，再最小侵入交付”的先例。由于不存在“示范图”的等价现成案例，本次允许最小偏离：
- 不继续修改错误目标 Hello World 脚本；
- 不擅自假设“示范图”即回测收益率直方图；
- 仅构建插件最小骨架，并通过显式 `NOT_IMPLEMENTED` 返回说明需求尚未完整。

## 3. 方法
### 3.1 插件组织
- 插件名称：`示范图`
- 本地脚本目录：`/home/horizon/agentapi/data/automa/ludevip__shifantu/`
- 本地脚本文件：`script.js`
- 本地配置文件：`plugin.json`
- 匹配页面：`https://next.lude.site/rotation/convertible-bond.*`

### 3.2 最小脚本能力
当前脚本实现以下能力：
1. 在页面中注册全局状态对象 `window.__LUDE_DEMO_CHART_PLUGIN__`；
2. 记录插件标识、配对码、URL、标题、加载时间与状态；
3. 监听 `window.postMessage`；
4. 对 `PING` 请求返回 `PONG`；
5. 对 `GENERATE_DEMO_CHART` 返回 `NOT_IMPLEMENTED`，避免伪造业务完成状态。

### 3.3 不做的事情
为避免需求外推，当前版本明确不执行以下动作：
- 不直接绘制业务图表；
- 不默认读取 DOM、文件或后端接口；
- 不自动写回 Wiki 或导出 HTML；
- 不绑定未经确认的业务按钮。

## 4. 结果
### 4.1 本地结果
本地插件骨架已创建，且 `script.js` 与 `plugin.json` 已按最小交付方案写入完成。

### 4.2 远端状态
在尝试将脚本推送到浏览器 `ghmrl8` 并删除误建 Hello World 远端脚本时，工具返回 `busclient: sync call timeout`。因此，当前结论为：
- 本地“示范图”脚本已正确生成；
- 远端浏览器安装/删除动作因浏览器离线或桥接不可用而暂未完成。

## 5. 验证方法
待浏览器恢复在线后，可在目标页面控制台执行以下验证：
1. 查看 `window.__LUDE_DEMO_CHART_PLUGIN__` 是否存在；
2. 发送 `PING` 消息并检查是否收到 `PONG`；
3. 发送 `GENERATE_DEMO_CHART` 消息并确认返回 `NOT_IMPLEMENTED`。

## 6. 结论
本次已将错误方向从 Hello World 注入脚本纠偏为“示范图”插件骨架脚本，并完成本地文件写入。该版本是一个可验证、可扩展、且不伪造业务完成度的最小交付物，适合作为后续真实需求澄清后的开发基线。

## 参考文献
1. 禄得网回测收益率直方图分布脚本：设计、实现与执行方法。
2. 回测结果收益率直方图分布实施方案（已执行）。
3. ChatGPT(o3) 关于“示范图”插件最小纠偏方案的建议。