用WorkBuddy做AI工具站加餐01:做转化事件看板

大家好，我是宇哥，专注AI编程、智能体，解决小白AI编程问题。

前面主线第 12 篇，我们已经把 AI 工具站的商业化路径拆成了 4 类模式，也定义了 7 个转化验证事件。

这一篇是加餐第 1 篇：不急着接真实统计平台，也不急着收费，而是先做一个本地转化事件看板。

你会用 WorkBuddy 辅助生成一组匿名样例日志，再把日志汇总成：

1. 一个 dashboard-summary.json 汇总文件；
2. 一个 conversion-dashboard.html 本地看板页面；
3. 一份 conversion-dashboard-report.md 运营报告；
4. 一个检查脚本，确认事件、页面、报告都完整。

这篇你能做出什么

跟着做完，你会得到这个目录：

tutorials/workbuddy-tool-directory-extras/demo/extra-01/
├── data/
│   ├── dashboard-summary.json
│   └── demo-events.jsonl
├── prompts/
│   └── workbuddy-conversion-dashboard-prompt.md
├── public/
│   └── conversion-dashboard.html
├── reports/
│   └── conversion-dashboard-report.md
└── scripts/
    ├── build-conversion-dashboard.py
    ├── check-conversion-dashboard.py
    ├── generate-demo-events.py
    └── generate_extra01_images.py

最终验收输出是：

通过 WorkBuddy 转化事件看板检查全部通过

看到这行，就说明你的本地事件日志、汇总 JSON、HTML 看板、Markdown 报告和边界检查都通过了。

适合谁，不适合谁

适合：

• 已经跟完《用 WorkBuddy 做 AI 工具站》主线 12 篇的读者；
• 手里有 conversion-events.json 和 monetization-models.json 的读者；
• 想知道“哪些按钮被点击、哪个商业化方向更值得先验证”的工具站作者。

不适合：

• 还没有工具详情页、还没有事件定义的人；
• 想一上来接真实广告、真实支付、真实用户追踪的人；
• 想用一个本地样例看板证明项目已经能赚钱的人。

这一篇的边界很明确：

本地样例看板只能帮你学习指标结构，不能代表真实用户行为。

准备环境

你需要准备：

上一课输入文件在这里：

tutorials/ai-tool-directory/demo/lesson-12/config/conversion-events.json
tutorials/ai-tool-directory/demo/lesson-12/data/monetization-models.json

注意：这一篇不接真实统计平台，不读取真实用户数据，不写真实密钥。

先看最终效果

这一篇最终会生成 91 行本地匿名样例事件，并汇总出这些指标：

这里的数字来自本地样例日志，不是真实线上数据。它的作用是让你先把看板结构跑通。

第一步｜新建加餐目录

在文章工作区执行：

mkdir -p tutorials/workbuddy-tool-directory-extras/demo/extra-01/{scripts,data,config,reports,prompts,public}

这一步只建立目录。

验收点：目录里能看到：

config
data
prompts
public
reports
scripts

第二步｜把任务交给 WorkBuddy

打开 WorkBuddy，在当前项目里新建任务，把下面提示词复制进去：

你是我的 AI 编程助手。请基于上一课已经定义好的转化事件和商业化模型，做一个本地可运行的“转化事件看板”增强篇。

输入文件：
- tutorials/ai-tool-directory/demo/lesson-12/config/conversion-events.json
- tutorials/ai-tool-directory/demo/lesson-12/data/monetization-models.json

请输出：
1. data/demo-events.jsonl：一组本地匿名样例事件日志，每行一个 JSON。
2. scripts/generate-demo-events.py：根据 conversion-events.json 生成样例日志。
3. scripts/build-conversion-dashboard.py：把日志汇总成 dashboard-summary.json、conversion-dashboard.html 和 Markdown 报告。
4. scripts/check-conversion-dashboard.py：检查事件定义、日志、汇总指标、页面和报告是否完整。
5. reports/conversion-dashboard-report.md：给运营者看的转化事件看板报告。

限制：
- 只使用本地匿名样例数据，不收集真实用户隐私。
- 不接真实统计平台、不接支付、不写真实密钥。
- 看板只帮助判断下一步优先级，不承诺收益。

我把这段提示词保存到了：

tutorials/workbuddy-tool-directory-extras/demo/extra-01/prompts/workbuddy-conversion-dashboard-prompt.md

WorkBuddy 在这里不是帮你“凭感觉做运营”，而是把上一课的事件定义变成可以运行、可以检查的文件。

第三步｜生成本地匿名事件日志

新建脚本：

tutorials/workbuddy-tool-directory-extras/demo/extra-01/scripts/generate-demo-events.py

脚本读取上一课的事件定义：

ROOT = Path('/root/workspace/wechat-articles')
DEMO = ROOT / 'tutorials/workbuddy-tool-directory-extras/demo/extra-01'
PREV = ROOT / 'tutorials/ai-tool-directory/demo/lesson-12'
EVENT_CONFIG = PREV / 'config/conversion-events.json'

然后为每个事件生成一组本地样例日志：

weights = {
    'tool_outbound_click': 42,
    'affiliate_slot_click': 9,
    'sponsor_slot_click': 5,
    'save_tool_click': 14,
    'export_click': 7,
    'lead_form_view': 11,
    'lead_form_submit': 3,
}

这些数字不是线上数据，只是为了让看板里有足够多的样例记录，方便你观察汇总逻辑。

运行：

cd /root/workspace/wechat-articles/tutorials/workbuddy-tool-directory-extras/demo/extra-01
python3 scripts/generate-demo-events.py

我这边真实运行输出是：

样例事件日志生成完成
事件类型数： 7
日志行数： 91
输出文件：data/demo-events.jsonl

验收点：打开 data/demo-events.jsonl，每一行都应该是一个 JSON，例如：

{"event_id":"evt-0001","event":"tool_outbound_click","page":"/tools/dify.html","anonymous_session":"session-02","source":"local_demo_only"}

第四步｜把日志汇总成看板

新建脚本：

scripts/build-conversion-dashboard.py

这个脚本做 3 件事：

1. 读取 demo-events.jsonl；
2. 统计每类事件次数、匿名会话数、表单样例提交率；
3. 输出 JSON、HTML 和 Markdown 报告。

流程是这样的：

核心汇总逻辑可以这样写：

rows = [json.loads(line) for line in LOG_PATH.read_text(encoding='utf-8').splitlines() if line.strip()]
counts = Counter(row['event'] for row in rows)
sessions = {row['anonymous_session'] for row in rows}
lead_submit = counts['lead_form_submit']
lead_view = counts['lead_form_view']
lead_rate = round(lead_submit / lead_view * 100, 1) if lead_view else 0

运行：

python3 scripts/build-conversion-dashboard.py

真实输出是：

转化事件看板生成完成
事件日志行数： 91
匿名会话数： 17
官网点击数： 42
意向事件数： 35
优先验证路径： 联盟推荐
汇总文件：data/dashboard-summary.json
看板页面：public/conversion-dashboard.html
报告文件：reports/conversion-dashboard-report.md

验收点：本地会生成 3 个核心结果：

data/dashboard-summary.json
public/conversion-dashboard.html
reports/conversion-dashboard-report.md

第五步｜看懂 dashboard-summary.json

打开：

data/dashboard-summary.json

你会看到 totals、event_counts、model_priority 和 recommendation。

其中 totals 是看板最基础的一组指标：

{
  "event_types": 7,
  "event_rows": 91,
  "anonymous_sessions": 17,
  "outbound_clicks": 42,
  "intent_events": 35,
  "commercial_slot_clicks": 14,
  "lead_form_view": 11,
  "lead_form_submit": 3,
  "lead_form_submit_rate_percent": 27.3
}

注意：如果你重新运行脚本，时间戳会变化，但这些样例统计值应该保持一致。

model_priority 会把上一课的 4 类商业化路径按事件得分排序。这样你就不是凭感觉决定“先做广告还是先做会员”，而是先看事件信号。

第六步｜打开 HTML 看板

看板文件在：

public/conversion-dashboard.html

你可以直接用浏览器打开它。

如果在服务器上无法打开浏览器，就先用文件检查：

python3 scripts/check-conversion-dashboard.py

看板里至少应该有 3 块内容：

1. 顶部指标卡片；
2. 事件统计表；
3. 商业化路径优先级。

不要把它理解成正式运营后台。它只是一个本地静态页面，用来确认：事件日志可以被汇总，指标可以被展示，商业化方向可以被排序。

第七步｜运行检查脚本

新建检查脚本：

scripts/check-conversion-dashboard.py

这个脚本至少检查：

• 上一课输入文件是否存在；
• 转化事件是不是 7 个；
• 样例日志是否只包含已定义事件；
• 汇总事件行数和日志是否一致；
• HTML 页面是否包含关键统计；
• Markdown 报告是否包含边界和建议；
• 是否出现夸张宣传、外部联系引导或真实密钥。

运行完整验证：

cd /root/workspace/wechat-articles/tutorials/workbuddy-tool-directory-extras/demo/extra-01
python3 scripts/generate-demo-events.py && python3 scripts/build-conversion-dashboard.py && python3 scripts/check-conversion-dashboard.py

我这边真实验证输出如下：

样例事件日志生成完成
事件类型数： 7
日志行数： 91
输出文件：data/demo-events.jsonl
转化事件看板生成完成
事件日志行数： 91
匿名会话数： 17
官网点击数： 42
意向事件数： 35
优先验证路径： 联盟推荐
汇总文件：data/dashboard-summary.json
看板页面：public/conversion-dashboard.html
报告文件：reports/conversion-dashboard-report.md
通过 上一课输入检查通过，事件定义 7 个，商业化模式 4 类
通过 样例日志检查通过，日志 91 行，匿名会话 17 个
通过 看板汇总检查通过，事件行数和汇总一致
通过 HTML 看板检查通过，包含关键统计和优先级
通过 Markdown 报告检查通过，包含边界和建议
通过 未发现夸张宣传、外部联系引导或真实密钥
通过 WorkBuddy 转化事件看板检查全部通过

完整代码 / 配置汇总

这一篇的关键文件如下。

1. WorkBuddy 提示词

tutorials/workbuddy-tool-directory-extras/demo/extra-01/prompts/workbuddy-conversion-dashboard-prompt.md

用途：让 WorkBuddy 生成事件日志、看板脚本、检查脚本和报告。

2. 样例日志生成脚本

tutorials/workbuddy-tool-directory-extras/demo/extra-01/scripts/generate-demo-events.py

用途：读取上一课的 7 个事件定义，生成 91 行本地匿名事件日志。

3. 看板生成脚本

tutorials/workbuddy-tool-directory-extras/demo/extra-01/scripts/build-conversion-dashboard.py

用途：把 JSONL 日志汇总成 JSON、HTML 和 Markdown 报告。

4. 检查脚本

tutorials/workbuddy-tool-directory-extras/demo/extra-01/scripts/check-conversion-dashboard.py

用途：检查输入、日志、汇总、页面、报告和内容边界。

5. 本地看板页面

tutorials/workbuddy-tool-directory-extras/demo/extra-01/public/conversion-dashboard.html

用途：给你一个可以打开看的静态运营仪表盘。

常见报错和排查

报错 1：上一课输入缺失

如果看到：

失败 缺少文件：tutorials/ai-tool-directory/demo/lesson-12/config/conversion-events.json

说明你还没有完成主线第 12 篇，或者文件路径移动了。

解决方法：

1. 先回到第 12 篇；
2. 确认 conversion-events.json 和 monetization-models.json 都存在；
3. 再回来运行本篇脚本。

报错 2：日志里出现未定义事件

如果看到：

失败 日志里出现未定义事件

说明 demo-events.jsonl 里的事件名和 conversion-events.json 对不上。

解决方法：

1. 打开 data/demo-events.jsonl；
2. 检查 event 字段；
3. 只保留上一课定义过的事件名；
4. 重新运行生成和检查命令。

报错 3：汇总行数不一致

如果看到：

失败 汇总事件行数和日志不一致

说明你改过日志，但没有重新生成 dashboard-summary.json。

解决方法：重新运行：

python3 scripts/build-conversion-dashboard.py
python3 scripts/check-conversion-dashboard.py

报错 4：页面缺少关键模块

如果看到：

失败 看板页面缺少：事件统计

说明 HTML 生成脚本被改坏了。

解决方法：让 WorkBuddy 检查 build-conversion-dashboard.py，确认页面里还有：

WorkBuddy 转化事件看板
事件统计
商业化路径优先级

报错 5：出现真实密钥或夸张宣传

如果检查脚本提示内容边界问题，先停下来，不要继续发布。

解决方法：

1. 打开脚本提示的文件；
2. 删除真实 token、secret、password、API Key；
3. 把夸张收益表达改成可验证指标；
4. 再运行检查脚本。

公开教程里宁可少写一点，也不要把真实密钥和不该承诺的结果写出去。

这一篇你学会了什么

这一篇做的是工具站运营能力的第一块积木：

把“用户有没有行动”变成可检查的事件看板。

你现在有了：

• 7 个事件定义；
• 91 行本地匿名样例日志；
• 一个汇总 JSON；
• 一个 HTML 看板；
• 一份 Markdown 报告；
• 一个能挡住文件缺失、事件不一致和内容边界问题的检查脚本。

这比直接讨论“怎么变现”更稳。因为只有先看见用户行为，你才知道下一步该做推荐入口、收藏导出、需求表单，还是先继续补工具数据。

下一篇预告

下一篇继续加餐：

用WorkBuddy做AI工具站加餐02：接入用户反馈表

我们会在不接真实后端的前提下，先做一个本地反馈表样稿，把用户反馈字段、提交样例、检查报告跑通。下一篇会复用这一篇的看板思路：先本地验证结构，再考虑真实上线。

资料来源

• 本系列主线第 12 篇真实产物：conversion-events.json、monetization-models.json
• 本篇真实验证命令：python3 scripts/generate-demo-events.py && python3 scripts/build-conversion-dashboard.py && python3 scripts/check-conversion-dashboard.py
• 本篇本地 demo：tutorials/workbuddy-tool-directory-extras/demo/extra-01/