技能名称: insight-engine
详细描述:
最后使用: 2026-03-24
记忆引用: 18
状态: 活跃

insight-engine

从运营日志中获取数据驱动的洞察：收集 → 统计 → LLM 解读 → Notion。

架构

收集（仅限 Python 统计）
├── Langfuse OTEL 追踪/评分/观测
├── OpenClaw/网关日志
├── Git 活动
└── 控制平面评分
↓
build*data_packet() ← 所有统计在 LLM 调用前由 Python 计算
↓
callclaude(systemprompt, structured_json) ← LLM 负责解读，不负责计算
↓
write*reflection() → Notion

完整设计原理请参见 references/architecture.md。

快速开始

bash

安装依赖

pip install anthropic requests pyyaml

配置

cp scripts/config/analyst.yaml.example config/analyst.yaml

编辑 config/analyst.yaml — 设置 langfuse URL、notion ID、模型选择

试运行（本地 Ollama，不写入 Notion）

python3 scripts/src/engine.py --mode daily --dry-run

仅输出数据包 + 提示（供代理使用，不调用 API）

python3 scripts/src/engine.py --mode daily --data-only

正式运行

python3 scripts/src/engine.py --mode daily python3 scripts/src/engine.py --mode weekly python3 scripts/src/engine.py --mode monthly

必需的环境变量

bash
ANTHROPICAPIKEY=sk-ant-... # Anthropic API 密钥
NOTIONAPIKEY=secret_... # Notion 集成令牌
LANGFUSEBASEURL=http://localhost:3100 # Langfuse 服务器地址
LANGFUSEPUBLICKEY=pk-lf-... # Langfuse 公钥
LANGFUSESECRETKEY=sk-lf-... # Langfuse 密钥
NOTIONROOTPAGE_ID= # 报告根 Notion 页面
NOTIONDAILYDB_ID= # 每日条目的 Notion 数据库

或在 config/analyst.yaml 中配置。

关键设计原则

1. 1. 统计优先于 LLM — Python 计算所有数值。LLM 负责解读，不负责聚合。
2. 强制引用提示 — 系统提示要求每个论断引用具体数字。
3. 禁止虚构趋势 — < 7 个数据点 → 报告数据不足（n=X）
4. 试运行模式 — 使用本地 Ollama（免费）预览输出；跳过 Notion 写入。
5. 仅数据模式 — 输出完整数据包 + 提示供代理/子代理使用。

Cron 设置（LaunchAgent 示例）

xml

StartCalendarInterval

Hour23
Minute0

ProgramArguments

/usr/bin/python3
/path/to/insight-engine/scripts/src/engine.py
--modedaily

扩展至新的数据源

在 scripts/src/collectors/ 中添加收集器：

1. 1. 创建 mysource.py，包含返回普通字典的 fetch*() 函数
2. 在 engine.py 的 builddailydatapacket() 中导入并调用
3. 在 prompts/dailyanalyst.md 的数据源部分引用新键

参见

• - references/architecture.md — 完整设计原理和层级说明
• scripts/prompts/daily_analyst.md — 包含引用规则的系统提示
• scripts/config/analyst.yaml.example — 配置模板