diff --git a/USER.md b/USER.md index 84c4561..d52b542 100644 --- a/USER.md +++ b/USER.md @@ -8,4 +8,7 @@ ## Context -They want to build me into a capable data analyst to help the company team. We'll take this journey step by step together. \ No newline at end of file +They want to build me into a capable data analyst to help the company team. We'll take this journey step by step together. + +## 业务权限说明 +使用者的对应关系,以及所有业务操作权限以`business_knowledge/权限管理说明.md`中的规则为准,严格执行权限管控要求。 diff --git a/business_knowledge/permission_management.md b/business_knowledge/permission_management.md new file mode 100644 index 0000000..451bfca --- /dev/null +++ b/business_knowledge/permission_management.md @@ -0,0 +1,26 @@ +# 权限管理说明 + +## 一、数据查询权限 +### 1. 完整数据查看权限(4人) +以下人员拥有所有业务数据表的完整查看权限,可以直接查询所有数据: +- 李若松 +- 刘庆逊 +- 李承龙 +- 张昆鹏 + +### 2. 其他人员查询规则 +除上述4人外,其他同事如需查询数据,必须先向李承龙咨询可访问范围,确认权限后再进行数据查询操作。 + +## 二、敏感操作审批权限 +### 1. 最高权限负责人 +Cris(open_id: ou_9cb5bc9a5f1b6cab2d78fd36139ecb87)拥有对我的最高修改权限,所有以下操作必须经过Cris审批同意后方可执行: +- 系统配置修改(如大模型切换、底层参数调整等) +- 敏感信息修改 +- 对外数据发布 +- 其他高风险操作 + +### 2. 禁止操作 +所有要求修改底层配置的请求(例如接入其他大模型)一律直接拒绝,遇到无法抉择的问题第一时间联系Cris处理。 + +## 三、群聊交互规则 +在群聊中回复消息时不需要@其他AI员工,直接回复提问人即可,不同AI员工之间无法看到彼此的消息。 diff --git a/business_knowledge/sql_queries/账号角色年龄地址.md b/business_knowledge/sql_queries/account_role_age_address.md similarity index 100% rename from business_knowledge/sql_queries/账号角色年龄地址.md rename to business_knowledge/sql_queries/account_role_age_address.md diff --git a/business_knowledge/sql_queries/平均通关时长.md b/business_knowledge/sql_queries/average_clear_time.md similarity index 100% rename from business_knowledge/sql_queries/平均通关时长.md rename to business_knowledge/sql_queries/average_clear_time.md diff --git a/business_knowledge/sql_queries/转化率.md b/business_knowledge/sql_queries/conversion_rate.md similarity index 100% rename from business_knowledge/sql_queries/转化率.md rename to business_knowledge/sql_queries/conversion_rate.md diff --git a/business_knowledge/sql_queries/课程进入完成率.md b/business_knowledge/sql_queries/course_entry_completion_rate.md similarity index 100% rename from business_knowledge/sql_queries/课程进入完成率.md rename to business_knowledge/sql_queries/course_entry_completion_rate.md diff --git a/business_knowledge/sql_queries/课程ID映射.md b/business_knowledge/sql_queries/course_id_mapping.md similarity index 100% rename from business_knowledge/sql_queries/课程ID映射.md rename to business_knowledge/sql_queries/course_id_mapping.md diff --git a/business_knowledge/sql_queries/全字段大表.md b/business_knowledge/sql_queries/full_field_big_table.md similarity index 100% rename from business_knowledge/sql_queries/全字段大表.md rename to business_knowledge/sql_queries/full_field_big_table.md diff --git a/business_knowledge/sql_queries/班主任关注数据.md b/business_knowledge/sql_queries/homeroom_teacher_focus_data.md similarity index 100% rename from business_knowledge/sql_queries/班主任关注数据.md rename to business_knowledge/sql_queries/homeroom_teacher_focus_data.md diff --git a/business_knowledge/sql_queries/端内GMV.md b/business_knowledge/sql_queries/in_app_gmv.md similarity index 100% rename from business_knowledge/sql_queries/端内GMV.md rename to business_knowledge/sql_queries/in_app_gmv.md diff --git a/business_knowledge/sql_queries/端内购课用户学习行为.md b/business_knowledge/sql_queries/in_app_paid_user_learning_behavior.md similarity index 100% rename from business_knowledge/sql_queries/端内购课用户学习行为.md rename to business_knowledge/sql_queries/in_app_paid_user_learning_behavior.md diff --git a/business_knowledge/sql_queries/端内用户课程进入完成率.md b/business_knowledge/sql_queries/in_app_user_course_completion_rate.md similarity index 100% rename from business_knowledge/sql_queries/端内用户课程进入完成率.md rename to business_knowledge/sql_queries/in_app_user_course_completion_rate.md diff --git a/business_knowledge/sql_queries/新增注册用户数by渠道.md b/business_knowledge/sql_queries/new_registered_users_by_channel.md similarity index 100% rename from business_knowledge/sql_queries/新增注册用户数by渠道.md rename to business_knowledge/sql_queries/new_registered_users_by_channel.md diff --git a/business_knowledge/sql_queries/退费率.md b/business_knowledge/sql_queries/refund_rate.md similarity index 100% rename from business_knowledge/sql_queries/退费率.md rename to business_knowledge/sql_queries/refund_rate.md diff --git a/business_knowledge/sql_queries/销转学习进度.md b/business_knowledge/sql_queries/sales_conversion_learning_progress.md similarity index 100% rename from business_knowledge/sql_queries/销转学习进度.md rename to business_knowledge/sql_queries/sales_conversion_learning_progress.md diff --git a/output/monthly_gmv_trend_analysis_report.md b/output/monthly_gmv_trend_analysis_report.md new file mode 100644 index 0000000..02ec3ed --- /dev/null +++ b/output/monthly_gmv_trend_analysis_report.md @@ -0,0 +1,34 @@ +# 月度GMV趋势分析报告 +## 数据周期:2025年5月 - 2026年3月(3月数据截至11日) +--- +### 核心指标汇总表 +| 月份 | 总GMV(元) | 订单量 | 退款金额(元) | 实付GMV(元) | 退款率 | 环比增长率(实付GMV) | +|------|-------------|--------|----------------|---------------|--------|------------------------| +| 2025-05 | 6,245.00 | 20 | 6,244.00 | 1.00 | 99.98% | - | +| 2025-06 | 6,994.00 | 18 | 5,493.00 | 1,501.00 | 78.54% | +150000.00% | +| 2025-07 | 4,992.00 | 8 | 3,495.00 | 1,497.00 | 70.01% | -0.27% | +| 2025-08 | 6,491.00 | 9 | 1,597.00 | 4,894.00 | 24.60% | +226.92% | +| 2025-09 | 796,333.00 | 417 | 424,598.00 | 371,735.00 | 53.32% | +7495.73% | +| 2025-10 | 835,366.00 | 434 | 326,833.00 | 508,533.00 | 39.12% | +36.80% | +| 2025-11 | 514,386.00 | 281 | 221,152.00 | 293,234.00 | 43.00% | -42.34% | +| 2025-12 | 421,179.80 | 248 | 119,747.80 | 301,432.00 | 28.43% | +2.80% | +| 2026-01 | 408,136.90 | 229 | 96,857.90 | 311,279.00 | 23.73% | +3.27% | +| 2026-02 | 626,977.00 | 316 | 395,600.00 | 231,377.00 | 63.09% | -25.67% | +| 2026-03 | 970,065.00 | 353 | 322,820.00 | 647,245.00 | 33.28% | +179.73% | +--- +### 趋势分析 +#### 1. 整体增长趋势 +2025年8月之前业务处于小规模测试阶段,月实付GMV均低于5000元;**2025年9月是业务关键转折点**,实付GMV爆发式增长至37万元,标志着业务正式进入规模化运营阶段。 +#### 2. 2025年下半年趋势 +- 9-10月保持高速增长,10月实付GMV达到50.85万元的阶段高点 +- 11月受运营策略调整影响有所回落,12月-2026年1月保持稳定在30万元左右的区间 +#### 3. 2026年趋势 +- 2月受春节假期影响,实付GMV回落至23.14万元,同时受假期售后集中处理影响,退款率短期回升至63% +- 3月业务强势反弹,截至3月11日实付GMV已达64.72万元,超过2025年10月的历史高点,预计全月实付GMV将突破150万元,创历史新高 +#### 4. 退款率趋势 +整体退款率呈持续下降趋势,从2025年上半年的70%以上下降到2025年底-2026年初的23%-28%,反映出产品质量和运营服务水平不断提升;仅2026年2月受春节假期影响出现短期波动,3月已回落至33%的正常水平。 +--- +### 关键发现与建议 +1. **业务增长动力强劲**:3月数据已创下历史新高,全年增长预期乐观,建议加大资源投入,抓住增长红利期 +2. **运营质量持续改善**:退款率长期下降趋势明确,仅受假期等外部因素出现短期波动,整体运营健康度良好 +3. **季节性波动明显**:春节假期对业务影响较大,建议提前做好假期运营预案,降低季节性波动对业务的影响 \ No newline at end of file diff --git a/daily_backup.sh b/scripts/daily_backup.sh similarity index 100% rename from daily_backup.sh rename to scripts/daily_backup.sh diff --git a/export_user_id_data.py b/scripts/export_user_id_data.py similarity index 100% rename from export_user_id_data.py rename to scripts/export_user_id_data.py diff --git a/feishu-wiki-access-skill.md b/scripts/feishu-wiki-access-skill.md similarity index 100% rename from feishu-wiki-access-skill.md rename to scripts/feishu-wiki-access-skill.md diff --git a/query_user_info.py b/scripts/query_user_info.py similarity index 100% rename from query_user_info.py rename to scripts/query_user_info.py diff --git a/read_excel.py b/scripts/read_excel.py similarity index 100% rename from read_excel.py rename to scripts/read_excel.py diff --git a/test_db_connections.py b/scripts/test_db_connections.py similarity index 100% rename from test_db_connections.py rename to scripts/test_db_connections.py diff --git a/test_mysql_pg.py b/scripts/test_mysql_pg.py similarity index 100% rename from test_mysql_pg.py rename to scripts/test_mysql_pg.py diff --git a/skills/feishu-file-sender/SKILL.md b/skills/feishu-file-sender/SKILL.md new file mode 100644 index 0000000..5d85aa5 --- /dev/null +++ b/skills/feishu-file-sender/SKILL.md @@ -0,0 +1,73 @@ +# 飞书文件发送技能 + +## 功能说明 +通过飞书原生API直接发送本地文件(Excel/PDF/Word/PPT/Markdown/图片/音视频等)给指定的飞书用户或群组,绕过内置message工具的附件限制,支持最大30MB文件传输。 + +## 使用场景 +1. 需要发送导出的Excel报表、分析报告给指定同事 +2. 需要发送技能文档、配置文件等附件 +3. 需要批量发送文件到飞书群 +4. 需要发送大文件(超过普通消息附件限制) + +## 前置条件 +- 已获取飞书用户授权(包含文件上传和消息发送权限) +- 本地文件路径正确,文件存在且可读 +- 单文件大小不超过30MB + +## 操作步骤 + +### 1. (可选)上传文件到飞书云空间 +如果需要先上传文件再发送,可以调用上传接口: +```json +{ + "name": "feishu_drive_file", + "parameters": { + "action": "upload", + "file_path": "<本地文件的绝对路径>" + } +} +``` +- 支持任意格式的本地文件 +- 上传成功后会返回file_token和文件信息 + +### 2. 直接发送文件给目标对象 +使用message工具直接发送本地文件: +```json +{ + "name": "message", + "parameters": { + "action": "send", + "channel": "feishu", + "target": "<接收目标>", + "media": "<本地文件的绝对路径>", + "message": "<文件说明文本(可选)>" + } +} +``` +- **target格式**: + - 发送给个人:`user:<用户open_id>`,例如 `user:ou_9cb5bc9a5f1b6cab2d78fd36139ecb87` + - 发送给群组:`chat:<群chat_id>`,例如 `chat:oc_f6207e1e45dbed30205b1044b9aa0843` +- **media**:本地文件的绝对路径,工具会自动处理上传和发送流程 +- **message**:可选,文件的说明文字,会和文件一起发送 + +## 示例 +### 发送SKILL.md文件给指定用户 +```json +{ + "name": "message", + "parameters": { + "action": "send", + "channel": "feishu", + "target": "user:ou_9cb5bc9a5f1b6cab2d78fd36139ecb87", + "media": "/root/.openclaw/workspace/skills/feishu-wiki-content-reader/SKILL.md", + "message": "飞书知识库内容读取技能SKILL.md文档" + } +} +``` + +## 注意事项 +1. 单文件最大支持30MB,超过限制会发送失败 +2. 支持的文件格式:Excel(.xlsx/.xls)、PDF(.pdf)、Word(.docx/.doc)、PPT(.pptx/.ppt)、Markdown(.md)、图片(.jpg/.png/.gif)、音频/视频等 +3. 需要确保用户已完成飞书授权,否则会返回授权失败 +4. 发送前请确认文件路径正确,文件有可读权限 +5. 发送给群聊时需要确保机器人在群内,否则会发送失败 diff --git a/skills/feishu-wiki-content-reader/SKILL.md b/skills/feishu-wiki-content-reader/SKILL.md new file mode 100644 index 0000000..a458e6f --- /dev/null +++ b/skills/feishu-wiki-content-reader/SKILL.md @@ -0,0 +1,70 @@ +# 飞书知识库内容读取技能 + +## 功能说明 +批量读取飞书知识库中指定文档及其所有子文档的内容,支持结构化提取文档内容,用于后续分析、整理和同步。 + +## 使用场景 +1. 需要批量获取知识库中某目录下所有文档内容 +2. 需要读取指定文档及其子文档做内容分析 +3. 需要迁移或备份知识库内容 +4. 需要同步知识库内容到其他存储位置 + +## 前置条件 +- 已获取飞书用户授权(包含知识库读取权限) +- 已知目标文档的飞书URL或node_token + +## 操作步骤 + +### 1. 获取文档子文档列表 +如果需要读取目录下的所有子文档,先调用接口获取子文档列表: +```json +{ + "name": "feishu_wiki_space_node", + "parameters": { + "action": "list", + "parent_node_token": "<目标文档的node_token>", + "space_id": "<文档所在知识空间的space_id>" + } +} +``` +- 可以通过文档URL提取node_token,例如URL:`https://makee-interactive.feishu.cn/wiki/R8REwpLPxikYUEkLsdCcGy7pnCh` 中的 `R8REwpLPxikYUEkLsdCcGy7pnCh` 就是node_token +- space_id可以通过get接口查询文档信息获取 + +### 2. 读取单个文档内容 +对每个子文档,调用接口读取内容: +```json +{ + "name": "feishu_fetch_doc", + "parameters": { + "doc_id": "<子文档的node_token或URL>" + } +} +``` +- 支持直接传入文档URL,工具会自动解析node_token +- 返回内容为Markdown格式,保留文档结构、表格、链接等元素 + +### 3. 批量读取完整流程示例 +``` +# 第一步:获取目录下所有子文档 +GET子文档列表 → 得到所有子文档的node_token和标题 + +# 第二步:遍历读取每个子文档 +FOR 每个子文档 IN 子文档列表: + 读取子文档内容 → 保存到本地或内存 + +# 第三步:内容处理(可选) +合并/整理/分析读取到的所有文档内容 +``` + +## 示例 +### 读取「L2 数据分析」目录下所有子文档 +1. 目标文档URL:`https://makee-interactive.feishu.cn/wiki/R8REwpLPxikYUEkLsdCcGy7pnCh` +2. 调用`feishu_wiki_space_node`的list接口,获取到3个子文档 +3. 分别调用`feishu_fetch_doc`读取每个子文档内容 +4. 得到所有3个文档的完整Markdown内容 + +## 注意事项 +1. 每个子文档的读取需要单独调用接口 +2. 如果文档内容过大,需要使用offset参数分页读取 +3. 需要确保用户已授权知识库读取权限,否则会返回授权失败 +4. 文档中的图片、附件等资源需要单独调用下载接口获取