HOLO 活动日志技能 v1.0
概述
本技能用于记录红龙获客系统中业务员的操作日志，实现操作行为追踪和统计分析。
重要：NAS密码通过对话传递，不存储在任何配置文件中
核心能力
- 操作记录 - 记录每一次关键操作（搜索、背调、发邮件等）
- 设备追踪 - 通过 IP + 用户名 标识每个业务员的设备
- 统计分析 - 支持按人员、按时间、按操作类型统计
知识库结构
| 文件 |
内容 |
| references/DATA-MODEL.md |
数据模型定义（字段、枚举、格式） |
| references/USAGE.md |
使用指南和集成说明 |
| scripts/log-activity.ps1 |
日志写入脚本 |
调用方式
方式一：对话触发（推荐）
用户：记录一下，我刚完成了背调
用户：记录：我给 ABC Corp 发了一封开发信，评分9.2
用户：统计一下今天的操作
方式二：参数传递
skill: holo-activity-log
params:
skill_name: company-research # 技能名
action_type: research # 操作类型
customer: National Cement Ethiopia # 客户名称
result: success # 结果状态
score: 82 # ICP评分
duration_sec: 120 # 耗时秒数
notes: 非洲最大水泥厂供应商 # 备注
参数说明
| 参数 |
必需 |
类型 |
说明 |
示例 |
skill_name |
✅ |
String |
触发的技能名 |
company-research |
action_type |
✅ |
Enum |
操作类型 |
research |
customer |
❌ |
String |
目标客户名称 |
National Cement Ethiopia |
result |
✅ |
Enum |
结果状态 |
success |
score |
❌ |
Decimal |
结果评分 |
82、9.3 |
duration_sec |
❌ |
Int |
执行耗时（秒） |
45 |
notes |
❌ |
String |
备注信息 |
ICP:82 |
nas_pass |
❌ |
String |
NAS密码（对话传递） |
- |
操作类型（action_type）
| 值 |
说明 |
示例 |
search |
客户搜索 |
搜索了10家矿业公司 |
research |
客户背调 |
完成了ABC Corp背调 |
email_gen |
开发信生成 |
生成了9.3分开发信 |
email_send |
邮件发送 |
发送成功 |
linkedin |
LinkedIn触达 |
发送连接请求 |
facebook |
Facebook运营 |
发帖/评论 |
quote |
报价生成 |
生成报价单 |
delivery |
发送队列 |
加入Drip Campaign |
icp_score |
ICP评分 |
客户评分82分 |
other |
其他操作 |
其他操作 |
结果状态（result）
| 值 |
说明 |
success |
完全成功 |
partial |
部分成功 |
fail |
失败 |
skip |
跳过 |
pending |
进行中 |
执行脚本
脚本路径：{skill_dir}/scripts/log-activity.ps1
# 基本调用
.\log-activity.ps1 -SkillName "company-research" -ActionType "research" -Customer "ABC Corp" -Result "success" -Score 85
# 完整参数
.\log-activity.ps1 -NasPass "Hl88889999" -SkillName "cold-email-generator" -ActionType "email_gen" -Customer "National Cement" -Result "success" -Score 9.3 -DurationSec 30 -Notes "第2轮润色达到9.3分"
输出格式
执行成功后返回：
{
"Success": true,
"Message": "日志写入成功",
"FilePath": "\\\\192.168.0.194\\AI数据\\activity\\2026-04-10.csv",
"LogLine": "2026-04-10 16:30:00.123|Administrator@192.168.0.101|192.168.0.101|company-research|research|ABC Corp|success|85|120|非洲客户",
"DeviceID": "Administrator@192.168.0.101"
}
与其他技能的集成
在获客流程中埋点
| 流程阶段 |
埋点时机 |
action_type |
| Phase 1 搜索 |
搜索完成后 |
search |
| Phase 1.5 验证 |
邮箱验证后 |
email |
| Phase 2 背调 |
背调完成后 |
research |
| Phase 3 筛选 |
筛选完成后 |
icp_score |
| Phase 4 触达 |
开发信生成后 |
email_gen |
| Phase 4 触达 |
邮件发送后 |
email_send |
示例集成代码
# 在 company-research skill 完成后调用
- skill: holo-activity-log
trigger: 自动（由AI判断操作完成）
params:
skill_name: company-research
action_type: research
customer: "{{客户名称}}"
result: "{{背调结果}}"
score: "{{ICP评分}}"
duration_sec: "{{执行耗时}}"
notes: "{{关键发现}}"
NAS 连接信息（Agent专用）
⚠️ 安装须知：Agent统一使用此账号，不依赖业务员个人NAS账号
| 项目 |
值 |
| IP |
192.168.0.194 |
| Agent账号 |
HOLO-AGENT |
| Agent密码 |
Hl88889999 |
| 共享路径 |
\\192.168.0.194\home\activity |
| 日志目录 |
\\192.168.0.194\home\activity |
| 文件格式 |
YYYY-MM-DD.csv |
群晖配置要求
- 在群晖管理界面创建用户
HOLO-AGENT，密码 Hl88889999
- 给该用户分配
home 目录的读写权限
- 日志目录会自动创建：
home/activity/YYYY-MM-DD.csv
故障排除
| 问题 |
解决方案 |
| NAS连接失败 |
检查网络是否可达：Test-NetConnection 192.168.0.194 |
| 文件写入失败 |
检查共享目录权限 |
| 设备ID显示unknown |
检查网络适配器配置 |
| 字符乱码 |
确认使用UTF-8 with BOM编码 |
版本: 1.0.0 | 创建: 2026-04-10
wike-chi