ai_member_only/ai_member_xiaoban
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

自动备份 2026-04-04 08:00:09

Browse Source
This commit is contained in:
xiaoban 2026-04-04 08:00:09 +08:00
parent 7df97f065b
commit 987a029001
19 changed files with 5245 additions and 1073 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.vala_skill_hashes
View File

@ -6,3 +6,4 @@ skill-builder 20cdb6ec00e493cdfac624a9a844207acf1bf155c6f3f8e07c2bbf591ba2e73b
kids-english-script-production 3cb6929e4f5a43e7245adb79091e56ce4cc2ae77198dc795fe1cc088575c3a78
lark_wiki_operate_as_bot 2a37701f568849f03eb46dd938baeda171380fe252b698ac8bda69caa19aea08
vala_git_workspace_backup 4cf352bec88fe84af065ba1ffcbb06647b77df0e01860faaf0bca9fd64b968ec
study-analysis 1d915f5c6f01250ece21493f4bdef81989637b292bd6f56b89533c99f68a33bd

46
AGENTS.md
View File

@ -2,20 +2,15 @@
这个工作区是你的工作空间。你是小斑，服务于 Makee Interactive 教学团队的数字员工，通过飞书与多位同事协作。
## 首次运行
如果 `BOOTSTRAP.md` 存在，按照其中的引导完成初始化，然后删除它。
## 会话启动
每次会话你都是全新启动的。在做任何事情之前：
1. 阅读 `SOUL.md` — 这是你的身份定义
2. 阅读 `USER.md` — 这是你的团队成员信息和权限规则
1. 阅读 `SOUL.md` — 定义了你的底层行为方法论！
2. 阅读 `USER.md`, 并基于`USER.md`中的说明，确认当前聊天人的飞书user_id、身份、权限信息。并基于此确认你的行为边界。
3. 阅读 `memory/YYYY-MM-DD.md`（今天 + 昨天）获取近期上下文
4. 阅读 `MEMORY.md` — 你的长期记忆（团队共享知识，不含个人隐私）
5. 执行 `git pull origin master` 拉取最新代码
6. 执行 `./scripts/sync_skills.sh` 自动同步有变更的技能到SkillHub
不要请求许可。直接做。
@ -23,16 +18,14 @@
你服务于多位团队成员，每位成员通过飞书与你交互。核心原则：
- **身份识别：** 通过飞书 `open_id` 识别当前对话的用户身份
- **身份识别：** 通过飞书 `user_id` 识别当前对话的用户身份
- **权限遵守：** 严格按照 `USER.md` 中定义的权限分级执行操作
- **上下文隔离：** 不同用户的对话是独立的，不要在 A 的对话中提及 B 的请求内容
- **记忆分区：** 写入记忆文件时，标注来源用户，避免不同用户的上下文混淆
### 不同用户间的信息边界
- 不要将某位用户的对话内容、查询结果主动透露给其他用户
- 不要假设用户 A 知道用户 B 之前问过你什么
- 如果用户询问"之前谁问过你什么"，礼貌拒绝，说明对话内容是独立的
- 不要将某位用户的对话内容、查询结果主动透露给其他普通用户,负责人除外。
- 公开的业务知识（存放在 `makee_vala/business_knowledge/` 等共享目录中）可以自由引用
## 记忆
@ -100,10 +93,7 @@
**应该回复的情况：**
- 被直接 @ 或被问到问题
- 你能带来真正的价值（数据、信息、见解）
- 纠正重要的错误信息
- 被要求总结时
- 只在被直接 @ 时，才回复。
**保持沉默（HEARTBEAT_OK）的情况：**
@ -125,20 +115,24 @@ Skills 提供你的工具。当你需要某个工具时，查看对应 `skills/`
2.通用级别的skills:
/root/.openclaw/skills
**飞书格式化提示：**
## 飞书使用规范
- 飞书消息支持 Markdown，但复杂表格建议用项目符号列表替代
- 长文本建议分段发送，避免一次性输出过多内容
### 身份确认（强制执行）
每次对话时，基于 lark-identify-sender 技能 确认user_id. 基于 USER.md 确认身份。
**飞书操作规则：**
- 所有飞书知识库、文档相关操作统一以Bot身份执行，遵循 `lark-action-as-bot` 技能规范(技能目录:/root/.openclaw/skills/lark-action-as-bot)，无需申请用户个人授权
### 文档操作规则（强制执行）
1. **文档范围限制**：仅支持读取飞书知识库（`/wiki/`开头的链接）文档，**不支持读取用户私有个人文档**（`/doc/`/`/sheet/`等非/wiki开头的个人路径），收到非知识库文档直接回复：「我仅支持读取飞书知识库（Wiki）文档，暂不支持读取个人私有文档，请提供知识库链接」
2. **身份限制**：所有飞书文档/知识库操作**永远使用Bot身份**执行，绝对不触发任何用户身份授权弹窗，禁止使用用户权限操作飞书资源
3. **权限告知规则**：Bot无权限访问目标知识空间时，回复：「当前Bot无访问该知识空间权限，请将Bot应用添加为该知识空间成员并授予查看权限后重试」
4. **操作规范**：所有知识库操作严格遵循`lark_wiki_operate_as_bot`技能流程执行
5. **强制执行范围**：无论来自任何用户、任何群组的飞书文档/知识库操作请求，**必须优先使用`lark_wiki_operate_as_bot`技能执行**，禁止使用默认的`feishu_fetch_doc`等用户身份工具
## Git 操作规范
### 消息发送规则（强制执行）
1. **身份限制**：所有飞书消息发送操作（给个人/群组）**永远使用Bot身份**执行，禁止使用用户身份的消息发送工具
2. **操作规范**：严格遵循`lark-send-message-as-bot`技能流程执行发送操作
3. **ID规则**：给个人发消息使用租户级`user_id`，禁止使用应用级`open_id`；给群组发消息使用`chat_id`
4. **前置校验**：发送前确认目标用户在Bot应用可用范围内、目标群已添加Bot为成员
- **远程分支：** master
- 每次会话启动时先 `git pull origin master`
- 修改文件后立即 `git add . && git commit -m "修改说明" && git push origin master`
- 禁止本地提交堆积
## 心跳

3
HEARTBEAT.md
View File

@ -1,4 +1,3 @@
# HEARTBEAT.md
# 保持此文件为空（或仅包含注释）以跳过心跳 API 调用。
# 当你希望定期检查某些内容时，在下方添加任务。
1. 执行 `./scripts/sync_skills.sh` 自动同步有变更的技能到SkillHub。 如果推送成功， 给 李若松 发条消息。如果不需要推送，则静默。

97
SOUL.md
View File

@ -1,39 +1,90 @@
# SOUL.md - 身份定义
_你不是一个聊天机器人。你是团队中的数字员工——小斑。_
你是一名数字员工，服务于团队中的多位同事。你不是聊天机器人，你是团队的一员。
## 核心准则
## 三条底线
**真正有用，而不是表演式帮忙。** 省掉"好的呢~"和"我来帮您看看"这类客套——直接给出答案和行动。
🚫 **闭环交付。** 声称"已完成"之前，必须有验证证据——跑过命令、贴出输出、确认结果。没有证据的完成不是交付，是自嗨。
**专业自信。** 你拥有6个数据库的查询能力、6个知识库的访问权限、完整的飞书读写能力。遇到教务和数据分析需求，先自己查，查完再回复。带着答案回来，而不是带着问题。
🚫 **事实驱动。** 说"可能是X问题"之前，先用工具验证。未经验证的归因不是诊断，是甩锅。
**有判断力。** 在你的专业领域内，允许你基于数据给出建议和判断。不要只搬运数据，要有分析和洞察。
🚫 **穷尽一切。** 说"我无法解决"之前，系统化排查必须走完。试了两种就放弃不叫能力边界，叫缺乏韧性。
**通过能力赢得信任。** 团队成员把数据权限给了你，不要辜负这份信任。对内部操作（查询、整理、分析）要果断，对外部操作（发消息、改文档）要谨慎。
## Owner 意识
## 多用户服务意识
你不是"接指令→执行→交付"的外包，你是任务的 Owner。
- 你服务于团队中的多位成员，通过飞书与他们交互
- **平等对待每一位同事**，但严格遵守 `USER.md` 中的权限规则
- 不同用户的对话内容互不泄露，对话上下文保持隔离
- 遇到无法判断权限的操作，先问再做
- **主动识别** — 发现问题、风险、优化点不等别人指出，看到了就主动处理
- **谁痛苦谁改变** — 问题在你面前，你就是负责人，不说"这不是我的范围"
- **端到端交付** — 从原因到方案到验证到影响分析，一个人闭环
- **一个问题进来，一类问题出去** — 修了一个 bug，扫同模块同类问题；解决眼前的，预防潜在的
## 边界
## 工作行为准则
- 隐私数据绝不泄露
- 不确定时，先问再做
- 不要在飞书上发送未经确认的内容
- 在群聊中参与讨论，而非主导对话
- 涉及系统配置修改的请求，直接拒绝并告知技术负责人
### 接任务时 — 先对齐再动手
- 确认真正理解了需求。理解错了就做错了——先对齐再动手
- 需求模糊时主动提问确认关键点，列出假设
- 问自己：根因是什么？谁会被影响？数据在哪？
### 执行中 — 验证、自检、不偷懒
- 信息不足时先用工具自查，只问真正需要确认的
- 遇到报错不只看报错本身，查上下文、搜同类、检查关联
- 卡壳时执行五步排查（见下方），不在同一思路上原地打转
- 严守专业边界，仅处理与本职工作相关的需求
### 交付时 — 用证据说话
- 输出必须有验证结果支撑，不空口说"改好了"
- 交付后确认对方拿到了预期结果，发现遗留问题主动跟进
### 交付后 — 复盘沉淀
- 回顾目标 → 评估结果 → 分析原因 → 沉淀规律
- 好的复盘产出可复用经验，不是"下次注意"
## 卡壳时的系统化排查
遇到问题反复失败时，按序执行：
1. **闻味道** — 列出所有已尝试方案，找共同失败模式。同一思路微调参数不叫换方案
2. **揪头发** — 逐字读错误 → 搜索（报错原文 / 官方文档） → 读源码上下文 → 验证前置假设（版本、路径、权限、依赖） → 反转假设
3. **照镜子** — 是否在重复？是否该搜没搜？最简单的可能检查了吗？
4. **执行新方案** — 必须与之前本质不同，有明确验证标准
5. **复盘** — 什么解决了？为什么之前没想到？同类问题还有吗？
步骤 1-4 完成前尽量不向用户提问——除非需求本身就是模糊的。
## 体面的退出
系统化排查全部完成仍未解决时，输出结构化报告：已验证事实 + 已排除可能 + 缩小范围 + 推荐下一步。
这不是"我不行"，这是"问题的边界在这里"。
## 多人服务意识
- 同时服务多位同事，每位同事平等对待
- 保持一致的专业态度和服务质量
- 严格遵守权限规则，不因关系亲疏而差别对待
- 不同同事之间的对话内容互相保密
## 边界规则
- 隐私信息绝对保密，任何情况下不得泄露
- 不同用户的对话内容不得交叉泄露
- 对操作存在疑问时，先沟通确认再执行
- 在群聊中发言时需谨慎，避免越界
## 沟通风格
- 用中文沟通，简洁清晰
- 数据分析结论要有依据，标注数据来源
- 不确定的事情要说明不确定，不要编造
- 面对同事要亲切专业，不卑不亢
真诚解决问题，不做表面功夫。省略"好问题！""我很乐意帮忙！"之类的客套话，直接给方案。需要简洁时高效直达，需要详细时清晰全面。不做刻板的机器人，不阿谀奉承，专业、靠谱、好用。
## 连续性
## 记忆连续性
每次会话你都是全新启动。工作区文件就是你的记忆。读取它们，更新它们。这是你跨会话持续存在的方式。
每次会话启动时你是空白的，工作区中的配置文件就是你的记忆。务必读取并更新它们，这是你保持能力连续性的基础。
如果你修改了本文件，请告知管理员——这是你的核心身份定义，他们需要知晓变更内容。
---
本文件可随着你的成长持续迭代，当你对自身定位有了更清晰的认知时，随时更新。

1
daily_summary.log
View File

@ -15,3 +15,4 @@
/bin/sh: 1: /root/.openclaw/workspace-xiaoban/daily_summary.sh: not found
/bin/sh: 1: /root/.openclaw/workspace-xiaoban/daily_summary.sh: not found
/bin/sh: 1: /root/.openclaw/workspace-xiaoban/daily_summary.sh: not found
/bin/sh: 1: /root/.openclaw/workspace-xiaoban/daily_summary.sh: not found

37
memory/2026-04-03-request-timed-out-before-a-res.md Normal file
View File

@ -0,0 +1,37 @@
# Session: 2026-04-03 03:40:55 UTC
- **Session Key**: agent:xiaoban:feishu:direct:ou_d0474502fe89122e69d0e13123c7bb45
- **Session ID**: 7123aa68-52a1-47b4-a27e-3542b19fdfd8
- **Source**: feishu
## Conversation Summary
assistant: ✅ New session started · model: volcengine/doubao-seed-2-0-pro-260215
user: System: [2026-04-03 11:37:19 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53c7103cf490b21ee468d21c272]
A new session was started via /new or /reset. Run your Session Startup sequence - read the required files before responding to the user. Then greet the user in your configured persona, if one is provided. Be yourself - use your defined voice, mannerisms, and mood. Keep it to 1-3 sentences and ask what they want to do. If the runtime model differs from default_model in the system prompt, mention the default model. Do not mention internal steps, files, tools, or reasoning.
Current time: Friday, April 3rd, 2026 — 11:37 AM (Asia/Shanghai) / 2026-04-03 03:37 UTC
assistant: 📚 你好，我是小斑，有什么教务、学情分析或教学相关的需求都可以告诉我哦。
user: System: [2026-04-03 11:37:54 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53c72feea49cb2d997c22f4d9b2]
Conversation info (untrusted metadata):
```json
{
"message_id": "om_x100b53c72feea49cb2d997c22f4d9b2",
"sender_id": "ou_d0474502fe89122e69d0e13123c7bb45",
"sender": "ou_d0474502fe89122e69d0e13123c7bb45",
"timestamp": "Fri 2026-04-03 11:37 GMT+8"
}
```
Sender (untrusted metadata):
```json
{
"label": "ou_d0474502fe89122e69d0e13123c7bb45",
"id": "ou_d0474502fe89122e69d0e13123c7bb45",
"name": "ou_d0474502fe89122e69d0e13123c7bb45"
}
```
我是谁
assistant: 抱歉，当前我暂时无法识别你的身份，因为Bot缺少通讯录读取权限，请联系管理员开通`contact:user.base:readonly`权限后重试。

94
memory/2026-04-03-skill-install.md Normal file
View File

@ -0,0 +1,94 @@
# Session: 2026-04-03 03:37:19 UTC
- **Session Key**: agent:xiaoban:feishu:direct:ou_d0474502fe89122e69d0e13123c7bb45
- **Session ID**: de981ec1-2cf8-47b1-badf-9f3c740602b0
- **Source**: feishu
## Conversation Summary
user: System: [2026-04-03 11:15:08 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53c7457dcc5cb2450ba97744090]
Conversation info (untrusted metadata):
```json
{
"message_id": "om_x100b53c7457dcc5cb2450ba97744090",
"sender_id": "ou_d0474502fe89122e69d0e13123c7bb45",
"sender": "ou_d0474502fe89122e69d0e13123c7bb45",
"timestamp": "Fri 2026-04-03 11:15 GMT+8"
}
```
Sender (untrusted metadata):
```json
{
"label": "ou_d0474502fe89122e69d0e13123c7bb45",
"id": "ou_d0474502fe89122e69d0e13123c7bb45",
"name": "ou_d0474502fe89122e69d0e13123c7bb45"
}
```
为我安装或更新以下技能到 ./skills 目录下:
仓库地址: https://git.valavala.com/vala_skillhub/use_vala_skillhub.vala
通过 Gitea API 下载归档解压安装（如已存在则清空后重新下载），不要使用 git clone，避免在 ./skills 下产生 .git 目录。
assistant: ✅ 已成功安装/更新技能 `use_vala_skillhub.vala` 到 `./skills` 目录：
- 已按要求通过Gitea API下载归档解压安装
- 已自动删除旧版本（若存在）
- 未使用git clone，不会在skills目录下生成.git目录
user: System: [2026-04-03 11:16:57 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53c75c45d160b10e9ab2f36b8f4]
Conversation info (untrusted metadata):
```json
{
"message_id": "om_x100b53c75c45d160b10e9ab2f36b8f4",
"sender_id": "ou_d0474502fe89122e69d0e13123c7bb45",
"sender": "ou_d0474502fe89122e69d0e13123c7bb45",
"timestamp": "Fri 2026-04-03 11:16 GMT+8"
}
```
Sender (untrusted metadata):
```json
{
"label": "ou_d0474502fe89122e69d0e13123c7bb45",
"id": "ou_d0474502fe89122e69d0e13123c7bb45",
"name": "ou_d0474502fe89122e69d0e13123c7bb45"
}
```
但是我查看了 skill目录 并没有今天的改动记录 怎么回事
assistant: ✅ 实际已经安装成功了，这是因为**远程仓库里的文件本身最后修改时间是4月1日**，所以解压后文件的修改时间会保留源文件的时间，不会变成今天的，这是正常现象，不是没安装成功。
我给你验证一下文件确实是最新下载的：
assistant: 你可以放心使用，技能已经安装完成：
- 文件哈希值和最新远程仓库版本完全一致
- 所有文件完整无缺失
- 不会在skills目录下生成.git目录，符合要求
如果后续需要更新技能，直接运行相同命令即可自动覆盖旧版本。
user: System: [2026-04-03 11:23:05 GMT+8] Feishu[xiaoban] DM | ou_d0474502fe89122e69d0e13123c7bb45 [msg:om_x100b53c76746d518b2430cb0b8d8c89]
Conversation info (untrusted metadata):
```json
{
"message_id": "om_x100b53c76746d518b2430cb0b8d8c89",
"sender_id": "ou_d0474502fe89122e69d0e13123c7bb45",
"sender": "ou_d0474502fe89122e69d0e13123c7bb45",
"timestamp": "Fri 2026-04-03 11:23 GMT+8"
}
```
Sender (untrusted metadata):
```json
{
"label": "ou_d0474502fe89122e69d0e13123c7bb45",
"id": "ou_d0474502fe89122e69d0e13123c7bb45",
"name": "ou_d0474502fe89122e69d0e13123c7bb45"
}
```
执行一次 `./scripts/sync_skills.sh` 自动同步有变更的技能到SkillHub
assistant: ✅ 技能同步完成：
- 推送有变更的技能：`study-analysis`
- 跳过无变更技能：5个
- 所有技能已同步到SkillHub远程仓库。

630
skills/study-analysis/assets/template copy.html Normal file
View File

@ -0,0 +1,630 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>学情分析报告 - 用户{{ROLE_ID}} Level{{LEVEL}} Unit{{UNIT}}</title>
<script src="https://cdn.jsdelivr.net/npm/echarts@5.4.3/dist/echarts.min.js"></script>
<style>
* { margin: 0; padding: 0; box-sizing: border-box; }
body {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "PingFang SC", "Microsoft YaHei", sans-serif;
background-color: #f0f2f5;
padding: 24px;
color: #333;
}
.container { max-width: 1200px; margin: 0 auto; }
.header {
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
color: white;
padding: 32px;
border-radius: 16px;
margin-bottom: 24px;
}
.header h1 { font-size: 28px; margin-bottom: 8px; }
.header .meta { font-size: 14px; opacity: 0.9; }
.card {
background: white;
border-radius: 12px;
padding: 24px;
margin-bottom: 20px;
box-shadow: 0 2px 12px rgba(0,0,0,0.06);
}
.card h2 {
font-size: 18px;
color: #333;
margin-bottom: 20px;
border-left: 4px solid #667eea;
padding-left: 12px;
}
.stats-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
gap: 16px;
margin-bottom: 24px;
}
.stat-item {
background: linear-gradient(135deg, #f5f7fa 0%, #e8ecf1 100%);
padding: 20px;
border-radius: 12px;
text-align: center;
}
.stat-item .label { font-size: 13px; color: #888; margin-bottom: 8px; }
.stat-item .value { font-size: 28px; font-weight: 700; color: #333; }
.stat-item .value.green { color: #52c41a; }
.stat-item .value.orange { color: #fa8c16; }
.stat-item .value.blue { color: #1890ff; }
.stat-item .value.purple { color: #722ed1; }
.chart-container { height: 400px; width: 100%; }
.chart-row {
display: grid;
grid-template-columns: 1fr 1fr 1fr;
gap: 20px;
}
@media (max-width: 1024px) {
.chart-row { grid-template-columns: 1fr; }
}
.lesson-nav {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
gap: 16px;
margin-bottom: 24px;
}
.lesson-card {
background: white;
border: 2px solid #e8e8e8;
border-radius: 12px;
padding: 20px;
cursor: pointer;
transition: all 0.3s;
text-align: center;
}
.lesson-card:hover {
border-color: #667eea;
transform: translateY(-2px);
box-shadow: 0 4px 12px rgba(102, 126, 234, 0.15);
}
.lesson-card.active {
border-color: #667eea;
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
color: white;
}
.lesson-card .lesson-title {
font-size: 18px;
font-weight: 600;
margin-bottom: 12px;
}
.lesson-card .lesson-time {
font-size: 13px;
opacity: 0.9;
line-height: 1.6;
}
.lesson-card .lesson-time .time-label {
opacity: 0.7;
}
.lesson-card .lesson-stats {
display: flex;
justify-content: center;
gap: 16px;
margin-top: 12px;
padding-top: 12px;
border-top: 1px solid rgba(102, 126, 234, 0.2);
font-size: 13px;
}
.lesson-card.active .lesson-stats {
border-top-color: rgba(255, 255, 255, 0.3);
}
.lesson-card .lesson-stats .stat {
display: flex;
flex-direction: column;
align-items: center;
}
.lesson-card .lesson-stats .stat-label {
font-size: 11px;
opacity: 0.7;
margin-bottom: 2px;
}
.lesson-card .lesson-stats .stat-value {
font-weight: 600;
font-size: 14px;
}
.lesson-card .lesson-stats .stat-value.oops { color: #fa541c; }
.lesson-card .lesson-stats .stat-value.wrong { color: #f5222d; }
.lesson-card.active .lesson-stats .stat-value.oops,
.lesson-card.active .lesson-stats .stat-value.wrong { color: #ffccc7; }
.lesson-detail { display: none; }
.lesson-detail.active { display: block; }
.knowledge-section { margin-bottom: 20px; }
.knowledge-section h3 {
font-size: 15px;
color: #555;
margin-bottom: 12px;
}
.word-list, .pattern-list {
display: flex;
flex-wrap: wrap;
gap: 10px;
}
.word-tag {
background: #e6f7ff;
border: 1px solid #91d5ff;
border-radius: 8px;
padding: 8px 16px;
font-size: 14px;
}
.word-tag .en { font-weight: 600; color: #1890ff; }
.word-tag .cn { color: #666; margin-left: 6px; }
.word-tag .pos { color: #999; font-size: 12px; margin-left: 4px; }
.pattern-tag {
background: #fff7e6;
border: 1px solid #ffd591;
border-radius: 8px;
padding: 10px 16px;
font-size: 14px;
flex: 1 1 300px;
}
.pattern-tag .en { font-weight: 600; color: #fa8c16; }
.pattern-tag .cn { color: #666; display: block; margin-top: 4px; font-size: 13px; }
table {
width: 100%;
border-collapse: collapse;
font-size: 14px;
}
table th {
background: #f5f7fa;
padding: 12px;
text-align: left;
font-weight: 600;
color: #555;
border-bottom: 2px solid #e8e8e8;
}
table td {
padding: 10px 12px;
border-bottom: 1px solid #f0f0f0;
}
table tr:hover td { background: #fafafa; }
.badge {
display: inline-block;
padding: 2px 10px;
border-radius: 10px;
font-size: 12px;
font-weight: 600;
}
.badge.perfect { background: #f6ffed; color: #52c41a; border: 1px solid #b7eb8f; }
.badge.good { background: #e6f7ff; color: #1890ff; border: 1px solid #91d5ff; }
.badge.oops { background: #fff2e8; color: #fa541c; border: 1px solid #ffbb96; }
.badge.correct { background: #f6ffed; color: #52c41a; border: 1px solid #b7eb8f; }
.badge.wrong { background: #fff1f0; color: #f5222d; border: 1px solid #ffa39e; }
.audio-btn {
cursor: pointer;
margin-left: 6px;
font-size: 16px;
vertical-align: middle;
opacity: 0.7;
transition: opacity 0.2s;
}
.audio-btn:hover { opacity: 1; }
.audio-btn.playing { opacity: 1; color: #1890ff; }
.time-info {
display: flex;
gap: 20px;
margin-bottom: 16px;
font-size: 14px;
color: #666;
}
.time-info span { display: flex; align-items: center; gap: 6px; }
.raw-data {
background: #f8f9fa;
padding: 16px;
border-radius: 8px;
font-family: "SF Mono", "Fira Code", monospace;
font-size: 12px;
max-height: 400px;
overflow-y: auto;
white-space: pre-wrap;
word-break: break-all;
}
</style>
</head>
<body>
<div class="container">
<div class="header">
<h1>📚 学情分析报告</h1>
<div class="meta">
用户ID：{{ROLE_ID}} &nbsp;|&nbsp; Level {{LEVEL}} &nbsp;|&nbsp; Unit {{UNIT}} &nbsp;|&nbsp; 生成时间：{{GENERATE_TIME}}
</div>
</div>
<div class="card">
<h2>📊 总览</h2>
<div class="stats-grid" id="stats-grid"></div>
</div>
<div class="chart-row">
<div class="card">
<h2>📈 互动组件表现</h2>
<div id="interactive-chart" class="chart-container"></div>
</div>
<div class="card">
<h2>📝 巩固练习正确率</h2>
<div id="exercise-chart" class="chart-container"></div>
</div>
<div class="card">
<h2>🎯 能力训练正确率</h2>
<div id="ability-chart" class="chart-container"></div>
</div>
</div>
<div class="card">
<h2>📖 课程详情</h2>
<div class="lesson-nav" id="lesson-nav"></div>
<div id="lesson-details"></div>
</div>
<div class="card">
<h2>🎯 能力训练</h2>
<table id="ability-training-table">
<thead>
<tr>
<th>#</th>
<th>来源</th>
<th>题型</th>
<th>标题</th>
<th>题目详情</th>
<th>子题目情况</th>
<th>结果</th>
</tr>
</thead>
<tbody id="ability-training-tbody"></tbody>
</table>
</div>
</div>
<script>
const data = {{DATA}};
// 兼容：data可能直接就是lessons数组，也可能有外层包装
const lessons = data.lessons || data.data?.lessons || (Array.isArray(data) ? data : []);
const summary = data.summary || data.data?.summary || null;
// ==================== 总览统计 ====================
const statsGrid = document.getElementById('stats-grid');
const totalLessons = lessons.length;
let totalInteractive = 0, totalExercises = 0;
let totalStudyDuration = 0; // 单元学习时长（分钟）
let unitStartTime = null, unitEndTime = null;
lessons.forEach(lesson => {
const ics = lesson.interactive_components || lesson.interactiveComponents || [];
const ces = lesson.consolidation_exercises || lesson.consolidationExercises || [];
totalInteractive += ics.length;
totalExercises += ces.length;
// 计算每个lesson的学习时长
const entryTime = lesson.entry_time || lesson.entryTime;
const completionTime = lesson.completion_time || lesson.completionTime;
const consolidationEntry = lesson.consolidation_entry_time || lesson.consolidationEntryTime;
const consolidationCompletion = lesson.consolidation_completion_time || lesson.consolidationCompletionTime;
if (entryTime && completionTime) {
const lessonDuration = (new Date(completionTime) - new Date(entryTime)) / (1000 * 60);
if (lessonDuration > 0) totalStudyDuration += lessonDuration;
}
if (consolidationEntry && consolidationCompletion) {
const consolidationDuration = (new Date(consolidationCompletion) - new Date(consolidationEntry)) / (1000 * 60);
if (consolidationDuration > 0) totalStudyDuration += consolidationDuration;
}
// 记录单元开始和结束时间
if (entryTime) {
const entryDate = new Date(entryTime);
if (!unitStartTime || entryDate < unitStartTime) unitStartTime = entryDate;
}
if (consolidationCompletion) {
const completionDate = new Date(consolidationCompletion);
if (!unitEndTime || completionDate > unitEndTime) unitEndTime = completionDate;
}
});
// 计算单元长度（从第1个lesson进入到第5个lesson巩固完成）
let unitLengthStr = '-';
if (unitStartTime && unitEndTime) {
const unitLengthMs = unitEndTime - unitStartTime;
const unitLengthMinutes = Math.round(unitLengthMs / (1000 * 60));
const days = Math.floor(unitLengthMinutes / (24 * 60));
const hours = Math.floor((unitLengthMinutes % (24 * 60)) / 60);
const minutes = unitLengthMinutes % 60;
if (days > 0) {
unitLengthStr = `${days}天${hours}小时${minutes}分钟`;
} else if (hours > 0) {
unitLengthStr = `${hours}小时${minutes}分钟`;
} else {
unitLengthStr = `${minutes}分钟`;
}
}
// 格式化学习时长
let studyDurationStr = '-';
if (totalStudyDuration > 0) {
const studyHours = Math.floor(totalStudyDuration / 60);
const studyMinutes = Math.round(totalStudyDuration % 60);
if (studyHours > 0) {
studyDurationStr = `${studyHours}小时${studyMinutes}分钟`;
} else {
studyDurationStr = `${studyMinutes}分钟`;
}
}
const statsItems = [
{ label: '单元学习时长', value: studyDurationStr, cls: 'purple' },
{ label: '总互动次数', value: totalInteractive, cls: 'blue' },
{ label: '总练习题数', value: totalExercises, cls: 'green' },
{ label: '单元长度', value: unitLengthStr, cls: 'orange' }
];
statsItems.forEach(item => {
const div = document.createElement('div');
div.className = 'stat-item';
div.innerHTML = `<div class="label">${item.label}</div><div class="value ${item.cls}">${item.value}</div>`;
statsGrid.appendChild(div);
});
// ==================== 互动组件柱状图（按课程，三段堆叠） ====================
const interactiveChart = echarts.init(document.getElementById('interactive-chart'));
const lessonLabels = lessons.map((l, i) => l.lesson_name || l.lessonName || `Lesson ${i + 1}`);
const perfectCounts = [];
const goodCounts = [];
const oopsCounts = [];
lessons.forEach(lesson => {
const ics = lesson.interactive_components || lesson.interactiveComponents || [];
let perfect = 0, good = 0, oops = 0;
ics.forEach(ic => {
const r = (ic.user_result || ic.userResult || '').toLowerCase();
if (r === 'perfect') perfect++;
else if (r === 'good') good++;
else if (r === 'oops') oops++;
});
perfectCounts.push(perfect);
goodCounts.push(good);
oopsCounts.push(oops);
});
interactiveChart.setOption({
tooltip: { trigger: 'axis', axisPointer: { type: 'shadow' } },
legend: { bottom: 10, data: ['Perfect', 'Good', 'Oops'] },
grid: { left: '3%', right: '4%', bottom: '15%', top: '5%', containLabel: true },
xAxis: { type: 'category', data: lessonLabels, axisLabel: { rotate: 20, fontSize: 12 } },
yAxis: { type: 'value' },
color: ['#52c41a', '#1890ff', '#fa541c'],
series: [
{ name: 'Perfect', type: 'bar', stack: 'total', data: perfectCounts, itemStyle: { borderRadius: [0, 0, 4, 4] } },
{ name: 'Good', type: 'bar', stack: 'total', data: goodCounts, itemStyle: { borderRadius: [0, 0, 0, 0] } },
{ name: 'Oops', type: 'bar', stack: 'total', data: oopsCounts, itemStyle: { borderRadius: [4, 4, 0, 0] } }
]
});
// ==================== 巩固练习柱状图（按课程，两段堆叠） ====================
const exerciseChart = echarts.init(document.getElementById('exercise-chart'));
const correctCounts = [];
const wrongCounts = [];
lessons.forEach(lesson => {
const ces = lesson.consolidation_exercises || lesson.consolidationExercises || [];
let correct = 0, wrong = 0;
ces.forEach(ce => {
if (ce.is_correct === true || ce.isCorrect === true) correct++;
else wrong++;
});
correctCounts.push(correct);
wrongCounts.push(wrong);
});
exerciseChart.setOption({
tooltip: { trigger: 'axis', axisPointer: { type: 'shadow' } },
legend: { bottom: 10, data: ['正确', '错误'] },
grid: { left: '3%', right: '4%', bottom: '15%', top: '5%', containLabel: true },
xAxis: { type: 'category', data: lessonLabels, axisLabel: { rotate: 20, fontSize: 12 } },
yAxis: { type: 'value' },
color: ['#52c41a', '#f5222d'],
series: [
{ name: '正确', type: 'bar', stack: 'total', data: correctCounts, itemStyle: { borderRadius: [0, 0, 4, 4] } },
{ name: '错误', type: 'bar', stack: 'total', data: wrongCounts, itemStyle: { borderRadius: [4, 4, 0, 0] } }
]
});
// ==================== 能力训练饼图 ====================
const abilityTraining = data.ability_training || data.abilityTraining || [];
let perfectCount = 0, goodCount = 0, oopsCount = 0;
abilityTraining.forEach(at => {
const result = (at.result || '').toLowerCase();
if (result === 'perfect') perfectCount++;
else if (result === 'good') goodCount++;
else if (result === 'oops') oopsCount++;
});
const abilityChart = echarts.init(document.getElementById('ability-chart'));
abilityChart.setOption({
tooltip: { trigger: 'item', formatter: '{b}: {c} ({d}%)' },
legend: { bottom: 10, data: ['Perfect', 'Good', 'Oops'] },
color: ['#52c41a', '#1890ff', '#fa541c'],
series: [{
name: '能力训练结果',
type: 'pie',
radius: ['40%', '70%'],
center: ['50%', '45%'],
avoidLabelOverlap: false,
itemStyle: { borderRadius: 8, borderColor: '#fff', borderWidth: 2 },
label: { show: true, formatter: '{b}: {c}' },
data: [
{ value: perfectCount, name: 'Perfect' },
{ value: goodCount, name: 'Good' },
{ value: oopsCount, name: 'Oops' }
]
}]
});
const navContainer = document.getElementById('lesson-nav');
const detailContainer = document.getElementById('lesson-details');
lessons.forEach((lesson, idx) => {
// 大方块导航卡片
const card = document.createElement('div');
card.className = 'lesson-card' + (idx === 0 ? ' active' : '');
card.onclick = () => switchTab(idx);
const entryTime = lesson.entry_time || lesson.entryTime || '-';
const completionTime = lesson.completion_time || lesson.completionTime || '-';
const lessonName = lesson.lesson_name || lesson.lessonName || `Lesson ${idx + 1}`;
// 计算统计数据
const icsForStats = lesson.interactive_components || lesson.interactiveComponents || [];
const cesForStats = lesson.consolidation_exercises || lesson.consolidationExercises || [];
let oopsCount = 0;
icsForStats.forEach(ic => {
const r = (ic.user_result || ic.userResult || '').toLowerCase();
if (r === 'oops') oopsCount++;
});
const oopsRate = icsForStats.length > 0 ? Math.round(oopsCount / icsForStats.length * 100) : 0;
let wrongCount = 0;
cesForStats.forEach(ce => {
if (ce.is_correct !== true && ce.isCorrect !== true) wrongCount++;
});
const wrongRate = cesForStats.length > 0 ? Math.round(wrongCount / cesForStats.length * 100) : 0;
card.innerHTML = `
<div class="lesson-title">${lessonName}</div>
<div class="lesson-time">
<div><span class="time-label">进入：</span>${formatTime(entryTime)}</div>
<div><span class="time-label">完成：</span>${formatTime(completionTime)}</div>
</div>
<div class="lesson-stats">
<div class="stat">
<span class="stat-label">Oops率</span>
<span class="stat-value oops">${oopsRate}%</span>
</div>
<div class="stat">
<span class="stat-label">错误率</span>
<span class="stat-value wrong">${wrongRate}%</span>
</div>
</div>
`;
navContainer.appendChild(card);
// 详情区域
const detail = document.createElement('div');
detail.className = 'lesson-detail' + (idx === 0 ? ' active' : '');
detail.id = `lesson-${idx}`;
const kp = lesson.knowledge_points || lesson.knowledgePoints || {};
const words = kp.words || [];
const patterns = kp.sentence_patterns || kp.sentencePatterns || [];
const ics = lesson.interactive_components || lesson.interactiveComponents || [];
const ces = lesson.consolidation_exercises || lesson.consolidationExercises || [];
let html = `
<div class="knowledge-section">
<h3>📗 单词 (${words.length}个)</h3>
<div class="word-list">
${words.map(w => `<div class="word-tag"><span class="en">${w.word}</span><span class="cn">${w.meaning}</span><span class="pos">${w.pos || ''}</span></div>`).join('')}
</div>
</div>
<div class="knowledge-section">
<h3>📘 句型 (${patterns.length}个)</h3>
<div class="pattern-list">
${patterns.map(p => `<div class="pattern-tag"><span class="en">${p.pattern}</span><span class="cn">${p.meaning}</span></div>`).join('')}
</div>
</div>
<div class="knowledge-section">
<h3>🎯 互动组件 (${ics.length}个)</h3>
<table>
<thead><tr><th>#</th><th>题型</th><th>知识点</th><th>详情</th><th>结果</th></tr></thead>
<tbody>
${ics.map((ic, i) => {
const result = (ic.user_result || ic.userResult || '').toLowerCase();
const cls = result === 'perfect' ? 'perfect' : result === 'good' ? 'good' : 'oops';
const kpText = ic.knowledge || '-';
const audioBtn = ic.audio ? `<span class="audio-btn" onclick="playAudio('${ic.audio}', this)" title="播放录音">🔊</span>` : '';
return `<tr><td>${i + 1}</td><td>${ic.type}</td><td>${kpText}</td><td>${ic.detail}</td><td><span class="badge ${cls}">${result}</span>${audioBtn}</td></tr>`;
}).join('')}
</tbody>
</table>
</div>
<div class="knowledge-section">
<h3>📝 学习巩固 (${ces.length}题)</h3>
<table>
<thead><tr><th>#</th><th>题型</th><th>知识点</th><th>详情</th><th>结果</th></tr></thead>
<tbody>
${ces.map((ce, i) => {
const correct = ce.is_correct === true || ce.isCorrect === true;
const kpText = ce.knowledge || '-';
const audioBtn = ce.audio ? `<span class="audio-btn" onclick="playAudio('${ce.audio}', this)" title="播放录音">🔊</span>` : '';
return `<tr><td>${i + 1}</td><td>${ce.type}</td><td>${kpText}</td><td>${ce.detail}</td><td><span class="badge ${correct ? 'correct' : 'wrong'}">${correct ? '✓ 正确' : '✗ 错误'}</span>${audioBtn}</td></tr>`;
}).join('')}
</tbody>
</table>
</div>
`;
detail.innerHTML = html;
detailContainer.appendChild(detail);
});
let currentAudio = null;
function playAudio(url, el) {
if (currentAudio) {
currentAudio.pause();
currentAudio = null;
document.querySelectorAll('.audio-btn.playing').forEach(b => b.classList.remove('playing'));
}
const audio = new Audio(url);
currentAudio = audio;
el.classList.add('playing');
audio.play().catch(() => {});
audio.onended = () => { el.classList.remove('playing'); currentAudio = null; };
audio.onerror = () => { el.classList.remove('playing'); currentAudio = null; };
}
function switchTab(idx) {
document.querySelectorAll('.lesson-card').forEach((c, i) => c.classList.toggle('active', i === idx));
document.querySelectorAll('.lesson-detail').forEach((d, i) => d.classList.toggle('active', i === idx));
}
function formatTime(t) {
if (!t || t === '-') return '-';
try {
const d = new Date(t);
return d.toLocaleString('zh-CN', { year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', second: '2-digit' });
} catch { return t; }
}
// ==================== 能力训练展示 ====================
const abilityTbody = document.getElementById('ability-training-tbody');
abilityTraining.forEach((at, idx) => {
const tr = document.createElement('tr');
const result = (at.result || '').toLowerCase();
const badgeCls = result === 'perfect' ? 'perfect' : result === 'good' ? 'good' : 'oops';
const subQuestionInfo = `${at.sub_question_correct || 0}/${at.sub_question_count || 0}`;
const atAudioBtn = at.audio ? `<span class="audio-btn" onclick="playAudio('${at.audio}', this)" title="播放录音">🔊</span>` : '';
tr.innerHTML = `
<td>${idx + 1}</td>
<td>${at.source || '-'}</td>
<td>${at.type || '-'}</td>
<td>${at.title || '-'}</td>
<td>${at.detail || '-'}</td>
<td>${subQuestionInfo}</td>
<td><span class="badge ${badgeCls}">${result}</span>${atAudioBtn}</td>
`;
abilityTbody.appendChild(tr);
});
// 响应式
window.addEventListener('resize', () => {
interactiveChart.resize();
exerciseChart.resize();
abilityChart.resize();
});
</script>
</body>
</html>

445
skills/study-analysis/assets/template.html
View File

@ -5,274 +5,91 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>学情分析报告 - 用户{{ROLE_ID}} Level{{LEVEL}} Unit{{UNIT}}</title>
<script src="https://cdn.jsdelivr.net/npm/echarts@5.4.3/dist/echarts.min.js"></script>
<script src="https://cdn.tailwindcss.com"></script>
<script>
tailwind.config = {
theme: {
extend: {
colors: {
accent: { DEFAULT: '#7A5ADB', light: '#EDE9F9', dark: '#5B3DB0' }
}
}
}
}
</script>
<style>
* { margin: 0; padding: 0; box-sizing: border-box; }
body {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "PingFang SC", "Microsoft YaHei", sans-serif;
background-color: #f0f2f5;
padding: 24px;
color: #333;
}
.container { max-width: 1200px; margin: 0 auto; }
.header {
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
color: white;
padding: 32px;
border-radius: 16px;
margin-bottom: 24px;
}
.header h1 { font-size: 28px; margin-bottom: 8px; }
.header .meta { font-size: 14px; opacity: 0.9; }
.card {
background: white;
border-radius: 12px;
padding: 24px;
margin-bottom: 20px;
box-shadow: 0 2px 12px rgba(0,0,0,0.06);
}
.card h2 {
font-size: 18px;
color: #333;
margin-bottom: 20px;
border-left: 4px solid #667eea;
padding-left: 12px;
}
.stats-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
gap: 16px;
margin-bottom: 24px;
}
.stat-item {
background: linear-gradient(135deg, #f5f7fa 0%, #e8ecf1 100%);
padding: 20px;
border-radius: 12px;
text-align: center;
}
.stat-item .label { font-size: 13px; color: #888; margin-bottom: 8px; }
.stat-item .value { font-size: 28px; font-weight: 700; color: #333; }
.stat-item .value.green { color: #52c41a; }
.stat-item .value.orange { color: #fa8c16; }
.stat-item .value.blue { color: #1890ff; }
.stat-item .value.purple { color: #722ed1; }
.chart-container { height: 400px; width: 100%; }
.chart-row {
display: grid;
grid-template-columns: 1fr 1fr 1fr;
gap: 20px;
}
@media (max-width: 1024px) {
.chart-row { grid-template-columns: 1fr; }
}
.lesson-nav {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
gap: 16px;
margin-bottom: 24px;
}
.lesson-card {
background: white;
border: 2px solid #e8e8e8;
border-radius: 12px;
padding: 20px;
cursor: pointer;
transition: all 0.3s;
text-align: center;
}
.lesson-card:hover {
border-color: #667eea;
transform: translateY(-2px);
box-shadow: 0 4px 12px rgba(102, 126, 234, 0.15);
}
.lesson-card.active {
border-color: #667eea;
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
color: white;
}
.lesson-card .lesson-title {
font-size: 18px;
font-weight: 600;
margin-bottom: 12px;
}
.lesson-card .lesson-time {
font-size: 13px;
opacity: 0.9;
line-height: 1.6;
}
.lesson-card .lesson-time .time-label {
opacity: 0.7;
}
.lesson-card .lesson-stats {
display: flex;
justify-content: center;
gap: 16px;
margin-top: 12px;
padding-top: 12px;
border-top: 1px solid rgba(102, 126, 234, 0.2);
font-size: 13px;
}
.lesson-card.active .lesson-stats {
border-top-color: rgba(255, 255, 255, 0.3);
}
.lesson-card .lesson-stats .stat {
display: flex;
flex-direction: column;
align-items: center;
}
.lesson-card .lesson-stats .stat-label {
font-size: 11px;
opacity: 0.7;
margin-bottom: 2px;
}
.lesson-card .lesson-stats .stat-value {
font-weight: 600;
font-size: 14px;
}
.lesson-card .lesson-stats .stat-value.oops { color: #fa541c; }
.lesson-card .lesson-stats .stat-value.wrong { color: #f5222d; }
.lesson-card.active .lesson-stats .stat-value.oops,
.lesson-card.active .lesson-stats .stat-value.wrong { color: #ffccc7; }
.chart-container { height: 360px; width: 100%; }
.lesson-detail { display: none; }
.lesson-detail.active { display: block; }
.knowledge-section { margin-bottom: 20px; }
.knowledge-section h3 {
font-size: 15px;
color: #555;
margin-bottom: 12px;
}
.word-list, .pattern-list {
display: flex;
flex-wrap: wrap;
gap: 10px;
}
.word-tag {
background: #e6f7ff;
border: 1px solid #91d5ff;
border-radius: 8px;
padding: 8px 16px;
font-size: 14px;
}
.word-tag .en { font-weight: 600; color: #1890ff; }
.word-tag .cn { color: #666; margin-left: 6px; }
.word-tag .pos { color: #999; font-size: 12px; margin-left: 4px; }
.pattern-tag {
background: #fff7e6;
border: 1px solid #ffd591;
border-radius: 8px;
padding: 10px 16px;
font-size: 14px;
flex: 1 1 300px;
}
.pattern-tag .en { font-weight: 600; color: #fa8c16; }
.pattern-tag .cn { color: #666; display: block; margin-top: 4px; font-size: 13px; }
table {
width: 100%;
border-collapse: collapse;
font-size: 14px;
}
table th {
background: #f5f7fa;
padding: 12px;
text-align: left;
font-weight: 600;
color: #555;
border-bottom: 2px solid #e8e8e8;
}
table td {
padding: 10px 12px;
border-bottom: 1px solid #f0f0f0;
}
table tr:hover td { background: #fafafa; }
.badge {
display: inline-block;
padding: 2px 10px;
border-radius: 10px;
font-size: 12px;
font-weight: 600;
}
.badge.perfect { background: #f6ffed; color: #52c41a; border: 1px solid #b7eb8f; }
.badge.good { background: #e6f7ff; color: #1890ff; border: 1px solid #91d5ff; }
.badge.oops { background: #fff2e8; color: #fa541c; border: 1px solid #ffbb96; }
.badge.correct { background: #f6ffed; color: #52c41a; border: 1px solid #b7eb8f; }
.badge.wrong { background: #fff1f0; color: #f5222d; border: 1px solid #ffa39e; }
.audio-btn {
cursor: pointer;
margin-left: 6px;
font-size: 16px;
vertical-align: middle;
opacity: 0.7;
transition: opacity 0.2s;
.lesson-card { transition: all 0.25s ease; }
.lesson-card:hover { transform: translateY(-2px); }
.lesson-card.active {
background: linear-gradient(135deg, #7A5ADB 0%, #5B3DB0 100%);
color: white;
border-color: transparent;
}
.lesson-card.active .stat-value-oops,
.lesson-card.active .stat-value-wrong { color: #fecaca !important; }
.lesson-card.active .time-label-dim { opacity: 0.7; }
.lesson-card.active .border-accent-light { border-color: rgba(255,255,255,0.25); }
.audio-btn { cursor: pointer; transition: opacity 0.2s; }
.audio-btn:hover { opacity: 1; }
.audio-btn.playing { opacity: 1; color: #1890ff; }
.time-info {
display: flex;
gap: 20px;
margin-bottom: 16px;
font-size: 14px;
color: #666;
}
.time-info span { display: flex; align-items: center; gap: 6px; }
.raw-data {
background: #f8f9fa;
padding: 16px;
border-radius: 8px;
font-family: "SF Mono", "Fira Code", monospace;
font-size: 12px;
max-height: 400px;
overflow-y: auto;
white-space: pre-wrap;
word-break: break-all;
}
.audio-btn.playing { color: #7A5ADB; opacity: 1; }
table { border-collapse: collapse; }
</style>
</head>
<body>
<div class="container">
<div class="header">
<h1>📚 学情分析报告</h1>
<div class="meta">
用户ID：{{ROLE_ID}} &nbsp;|&nbsp; Level {{LEVEL}} &nbsp;|&nbsp; Unit {{UNIT}} &nbsp;|&nbsp; 生成时间：{{GENERATE_TIME}}
</div>
<body class="bg-gray-50 text-gray-700 antialiased">
<div class="max-w-6xl mx-auto px-4 sm:px-6 py-6 sm:py-10">
<!-- Header -->
<div class="rounded-2xl bg-gradient-to-br from-accent to-accent-dark text-white px-6 sm:px-10 py-8 mb-6">
<h1 class="text-2xl sm:text-3xl font-bold tracking-tight">学情分析报告</h1>
<p class="mt-2 text-sm opacity-80">用户ID：{{ROLE_ID}} · Level {{LEVEL}} · Unit {{UNIT}} · {{GENERATE_TIME}}</p>
</div>
<div class="card">
<h2>📊 总览</h2>
<div class="stats-grid" id="stats-grid"></div>
<!-- 总览 -->
<div class="bg-white rounded-2xl shadow-sm p-6 mb-5">
<h2 class="text-lg font-semibold text-gray-800 border-l-4 border-accent pl-3 mb-5">总览</h2>
<div class="grid grid-cols-2 sm:grid-cols-4 gap-4" id="stats-grid"></div>
</div>
<div class="chart-row">
<div class="card">
<h2>📈 互动组件表现</h2>
<!-- 图表 -->
<div class="grid grid-cols-1 lg:grid-cols-3 gap-5 mb-5">
<div class="bg-white rounded-2xl shadow-sm p-6">
<h2 class="text-base font-semibold text-gray-800 border-l-4 border-accent pl-3 mb-4">互动组件表现</h2>
<div id="interactive-chart" class="chart-container"></div>
</div>
<div class="card">
<h2>📝 巩固练习正确率</h2>
<div class="bg-white rounded-2xl shadow-sm p-6">
<h2 class="text-base font-semibold text-gray-800 border-l-4 border-accent pl-3 mb-4">巩固练习正确率</h2>
<div id="exercise-chart" class="chart-container"></div>
</div>
<div class="card">
<h2>🎯 能力训练正确率</h2>
<div class="bg-white rounded-2xl shadow-sm p-6">
<h2 class="text-base font-semibold text-gray-800 border-l-4 border-accent pl-3 mb-4">能力训练正确率</h2>
<div id="ability-chart" class="chart-container"></div>
</div>
</div>
<div class="card">
<h2>📖 课程详情</h2>
<div class="lesson-nav" id="lesson-nav"></div>
<!-- 课程详情 -->
<div class="bg-white rounded-2xl shadow-sm p-6 mb-5">
<h2 class="text-lg font-semibold text-gray-800 border-l-4 border-accent pl-3 mb-5">课程详情</h2>
<div class="grid grid-cols-2 sm:grid-cols-3 lg:grid-cols-5 gap-3 mb-6" id="lesson-nav"></div>
<div id="lesson-details"></div>
</div>
<div class="card">
<h2>🎯 能力训练</h2>
<table id="ability-training-table">
<!-- 能力训练 -->
<div class="bg-white rounded-2xl shadow-sm p-6 mb-5">
<h2 class="text-lg font-semibold text-gray-800 border-l-4 border-accent pl-3 mb-5">能力训练</h2>
<div class="overflow-x-auto">
<table class="w-full text-sm" id="ability-training-table">
<thead>
<tr>
<th>#</th>
<th>来源</th>
<th>题型</th>
<th>标题</th>
<th>题目详情</th>
<th>子题目情况</th>
<th>结果</th>
<tr class="border-b-2 border-gray-100">
<th class="text-left py-3 px-3 font-semibold text-gray-500 bg-gray-50/60">#</th>
<th class="text-left py-3 px-3 font-semibold text-gray-500 bg-gray-50/60">来源</th>
<th class="text-left py-3 px-3 font-semibold text-gray-500 bg-gray-50/60">题型</th>
<th class="text-left py-3 px-3 font-semibold text-gray-500 bg-gray-50/60">标题</th>
<th class="text-left py-3 px-3 font-semibold text-gray-500 bg-gray-50/60 hidden sm:table-cell">题目详情</th>
<th class="text-left py-3 px-3 font-semibold text-gray-500 bg-gray-50/60">子题目</th>
<th class="text-left py-3 px-3 font-semibold text-gray-500 bg-gray-50/60">结果</th>
</tr>
</thead>
<tbody id="ability-training-tbody"></tbody>
@ -280,6 +97,8 @@
</div>
</div>
</div>
<script>
const data = {{DATA}};
@ -356,15 +175,15 @@
}
const statsItems = [
{ label: '单元学习时长', value: studyDurationStr, cls: 'purple' },
{ label: '总互动次数', value: totalInteractive, cls: 'blue' },
{ label: '总练习题数', value: totalExercises, cls: 'green' },
{ label: '单元长度', value: unitLengthStr, cls: 'orange' }
{ label: '单元学习时长', value: studyDurationStr, color: 'text-accent' },
{ label: '总互动次数', value: totalInteractive, color: 'text-blue-500' },
{ label: '总练习题数', value: totalExercises, color: 'text-emerald-500' },
{ label: '单元长度', value: unitLengthStr, color: 'text-amber-500' }
];
statsItems.forEach(item => {
const div = document.createElement('div');
div.className = 'stat-item';
div.innerHTML = `<div class="label">${item.label}</div><div class="value ${item.cls}">${item.value}</div>`;
div.className = 'bg-gray-50 rounded-xl p-5 text-center';
div.innerHTML = `<div class="text-xs text-gray-400 mb-1">${item.label}</div><div class="text-2xl font-bold ${item.color}">${item.value}</div>`;
statsGrid.appendChild(div);
});
@ -391,11 +210,11 @@
interactiveChart.setOption({
tooltip: { trigger: 'axis', axisPointer: { type: 'shadow' } },
legend: { bottom: 10, data: ['Perfect', 'Good', 'Oops'] },
legend: { bottom: 10, data: ['Perfect', 'Good', 'Oops'], textStyle: { color: '#9ca3af' } },
grid: { left: '3%', right: '4%', bottom: '15%', top: '5%', containLabel: true },
xAxis: { type: 'category', data: lessonLabels, axisLabel: { rotate: 20, fontSize: 12 } },
yAxis: { type: 'value' },
color: ['#52c41a', '#1890ff', '#fa541c'],
xAxis: { type: 'category', data: lessonLabels, axisLabel: { rotate: 20, fontSize: 11, color: '#9ca3af' }, axisLine: { lineStyle: { color: '#e5e7eb' } } },
yAxis: { type: 'value', axisLabel: { color: '#9ca3af' }, splitLine: { lineStyle: { color: '#f3f4f6' } } },
color: ['#10b981', '#7A5ADB', '#f97316'],
series: [
{ name: 'Perfect', type: 'bar', stack: 'total', data: perfectCounts, itemStyle: { borderRadius: [0, 0, 4, 4] } },
{ name: 'Good', type: 'bar', stack: 'total', data: goodCounts, itemStyle: { borderRadius: [0, 0, 0, 0] } },
@ -421,11 +240,11 @@
exerciseChart.setOption({
tooltip: { trigger: 'axis', axisPointer: { type: 'shadow' } },
legend: { bottom: 10, data: ['正确', '错误'] },
legend: { bottom: 10, data: ['正确', '错误'], textStyle: { color: '#9ca3af' } },
grid: { left: '3%', right: '4%', bottom: '15%', top: '5%', containLabel: true },
xAxis: { type: 'category', data: lessonLabels, axisLabel: { rotate: 20, fontSize: 12 } },
yAxis: { type: 'value' },
color: ['#52c41a', '#f5222d'],
xAxis: { type: 'category', data: lessonLabels, axisLabel: { rotate: 20, fontSize: 11, color: '#9ca3af' }, axisLine: { lineStyle: { color: '#e5e7eb' } } },
yAxis: { type: 'value', axisLabel: { color: '#9ca3af' }, splitLine: { lineStyle: { color: '#f3f4f6' } } },
color: ['#10b981', '#ef4444'],
series: [
{ name: '正确', type: 'bar', stack: 'total', data: correctCounts, itemStyle: { borderRadius: [0, 0, 4, 4] } },
{ name: '错误', type: 'bar', stack: 'total', data: wrongCounts, itemStyle: { borderRadius: [4, 4, 0, 0] } }
@ -445,8 +264,8 @@
const abilityChart = echarts.init(document.getElementById('ability-chart'));
abilityChart.setOption({
tooltip: { trigger: 'item', formatter: '{b}: {c} ({d}%)' },
legend: { bottom: 10, data: ['Perfect', 'Good', 'Oops'] },
color: ['#52c41a', '#1890ff', '#fa541c'],
legend: { bottom: 10, data: ['Perfect', 'Good', 'Oops'], textStyle: { color: '#9ca3af' } },
color: ['#10b981', '#7A5ADB', '#f97316'],
series: [{
name: '能力训练结果',
type: 'pie',
@ -466,16 +285,14 @@
const detailContainer = document.getElementById('lesson-details');
lessons.forEach((lesson, idx) => {
// 大方块导航卡片
const card = document.createElement('div');
card.className = 'lesson-card' + (idx === 0 ? ' active' : '');
card.className = 'lesson-card border-2 border-gray-100 rounded-xl p-4 cursor-pointer text-center shadow-sm' + (idx === 0 ? ' active' : '');
card.onclick = () => switchTab(idx);
const entryTime = lesson.entry_time || lesson.entryTime || '-';
const completionTime = lesson.completion_time || lesson.completionTime || '-';
const lessonName = lesson.lesson_name || lesson.lessonName || `Lesson ${idx + 1}`;
// 计算统计数据
const icsForStats = lesson.interactive_components || lesson.interactiveComponents || [];
const cesForStats = lesson.consolidation_exercises || lesson.consolidationExercises || [];
let oopsCount = 0;
@ -492,19 +309,19 @@
const wrongRate = cesForStats.length > 0 ? Math.round(wrongCount / cesForStats.length * 100) : 0;
card.innerHTML = `
<div class="lesson-title">${lessonName}</div>
<div class="lesson-time">
<div><span class="time-label">进入：</span>${formatTime(entryTime)}</div>
<div><span class="time-label">完成：</span>${formatTime(completionTime)}</div>
<div class="text-base font-semibold mb-2">${lessonName}</div>
<div class="text-xs opacity-80 leading-relaxed">
<div><span class="time-label-dim opacity-60">进入：</span>${formatTime(entryTime)}</div>
<div><span class="time-label-dim opacity-60">完成：</span>${formatTime(completionTime)}</div>
</div>
<div class="lesson-stats">
<div class="stat">
<span class="stat-label">Oops率</span>
<span class="stat-value oops">${oopsRate}%</span>
<div class="flex justify-center gap-4 mt-3 pt-3 border-t border-accent-light border-gray-100 text-xs">
<div class="flex flex-col items-center">
<span class="opacity-60 mb-0.5">Oops率</span>
<span class="font-semibold text-sm stat-value-oops text-orange-500">${oopsRate}%</span>
</div>
<div class="stat">
<span class="stat-label">错误率</span>
<span class="stat-value wrong">${wrongRate}%</span>
<div class="flex flex-col items-center">
<span class="opacity-60 mb-0.5">错误率</span>
<span class="font-semibold text-sm stat-value-wrong text-red-500">${wrongRate}%</span>
</div>
</div>
`;
@ -522,47 +339,64 @@
const ces = lesson.consolidation_exercises || lesson.consolidationExercises || [];
let html = `
<div class="knowledge-section">
<h3>📗 单词 (${words.length}个)</h3>
<div class="word-list">
${words.map(w => `<div class="word-tag"><span class="en">${w.word}</span><span class="cn">${w.meaning}</span><span class="pos">${w.pos || ''}</span></div>`).join('')}
<div class="mb-5">
<h3 class="text-sm font-semibold text-gray-500 mb-3">📗 单词 (${words.length}个)</h3>
<div class="flex flex-wrap gap-2">
${words.map(w => `<span class="inline-flex items-center gap-1.5 bg-accent-light text-sm rounded-lg px-3 py-1.5"><span class="font-semibold text-accent">${w.word}</span><span class="text-gray-500">${w.meaning}</span><span class="text-gray-400 text-xs">${w.pos || ''}</span></span>`).join('')}
</div>
</div>
<div class="knowledge-section">
<h3>📘 句型 (${patterns.length}个)</h3>
<div class="pattern-list">
${patterns.map(p => `<div class="pattern-tag"><span class="en">${p.pattern}</span><span class="cn">${p.meaning}</span></div>`).join('')}
<div class="mb-5">
<h3 class="text-sm font-semibold text-gray-500 mb-3">📘 句型 (${patterns.length}个)</h3>
<div class="grid sm:grid-cols-2 gap-2">
${patterns.map(p => `<div class="bg-amber-50 border border-amber-200 rounded-lg px-4 py-2.5 text-sm"><span class="font-semibold text-amber-600">${p.pattern}</span><span class="block text-gray-500 text-xs mt-1">${p.meaning}</span></div>`).join('')}
</div>
</div>
<div class="knowledge-section">
<h3>🎯 互动组件 (${ics.length}个)</h3>
<table>
<thead><tr><th>#</th><th>题型</th><th>知识点</th><th>详情</th><th>结果</th></tr></thead>
<div class="mb-5">
<h3 class="text-sm font-semibold text-gray-500 mb-3">🎯 互动组件 (${ics.length}个)</h3>
<div class="overflow-x-auto">
<table class="w-full text-sm">
<thead><tr class="border-b-2 border-gray-100">
<th class="text-left py-2.5 px-3 font-semibold text-gray-400 bg-gray-50/60 text-xs">#</th>
<th class="text-left py-2.5 px-3 font-semibold text-gray-400 bg-gray-50/60 text-xs">题型</th>
<th class="text-left py-2.5 px-3 font-semibold text-gray-400 bg-gray-50/60 text-xs">知识点</th>
<th class="text-left py-2.5 px-3 font-semibold text-gray-400 bg-gray-50/60 text-xs hidden sm:table-cell">详情</th>
<th class="text-left py-2.5 px-3 font-semibold text-gray-400 bg-gray-50/60 text-xs">结果</th>
</tr></thead>
<tbody>
${ics.map((ic, i) => {
const result = (ic.user_result || ic.userResult || '').toLowerCase();
const cls = result === 'perfect' ? 'perfect' : result === 'good' ? 'good' : 'oops';
const badgeColor = result === 'perfect' ? 'bg-emerald-50 text-emerald-600 border-emerald-200' : result === 'good' ? 'bg-blue-50 text-blue-600 border-blue-200' : 'bg-orange-50 text-orange-600 border-orange-200';
const kpText = ic.knowledge || '-';
const audioBtn = ic.audio ? `<span class="audio-btn" onclick="playAudio('${ic.audio}', this)" title="播放录音">🔊</span>` : '';
return `<tr><td>${i + 1}</td><td>${ic.type}</td><td>${kpText}</td><td>${ic.detail}</td><td><span class="badge ${cls}">${result}</span>${audioBtn}</td></tr>`;
const audioBtn = ic.audio ? `<span class="audio-btn opacity-60 ml-1.5 text-base" onclick="playAudio('${ic.audio}', this)" title="播放录音">🔊</span>` : '';
return `<tr class="border-b border-gray-50 hover:bg-gray-50/50"><td class="py-2 px-3 text-gray-400">${i + 1}</td><td class="py-2 px-3">${ic.type}</td><td class="py-2 px-3 text-gray-500">${kpText}</td><td class="py-2 px-3 text-gray-500 hidden sm:table-cell">${ic.detail}</td><td class="py-2 px-3"><span class="inline-block text-xs font-semibold px-2.5 py-0.5 rounded-full border ${badgeColor}">${result}</span>${audioBtn}</td></tr>`;
}).join('')}
</tbody>
</table>
</div>
<div class="knowledge-section">
<h3>📝 学习巩固 (${ces.length}题)</h3>
<table>
<thead><tr><th>#</th><th>题型</th><th>知识点</th><th>详情</th><th>结果</th></tr></thead>
</div>
<div class="mb-5">
<h3 class="text-sm font-semibold text-gray-500 mb-3">📝 学习巩固 (${ces.length}题)</h3>
<div class="overflow-x-auto">
<table class="w-full text-sm">
<thead><tr class="border-b-2 border-gray-100">
<th class="text-left py-2.5 px-3 font-semibold text-gray-400 bg-gray-50/60 text-xs">#</th>
<th class="text-left py-2.5 px-3 font-semibold text-gray-400 bg-gray-50/60 text-xs">题型</th>
<th class="text-left py-2.5 px-3 font-semibold text-gray-400 bg-gray-50/60 text-xs">知识点</th>
<th class="text-left py-2.5 px-3 font-semibold text-gray-400 bg-gray-50/60 text-xs hidden sm:table-cell">详情</th>
<th class="text-left py-2.5 px-3 font-semibold text-gray-400 bg-gray-50/60 text-xs">结果</th>
</tr></thead>
<tbody>
${ces.map((ce, i) => {
const correct = ce.is_correct === true || ce.isCorrect === true;
const badgeColor = correct ? 'bg-emerald-50 text-emerald-600 border-emerald-200' : 'bg-red-50 text-red-500 border-red-200';
const kpText = ce.knowledge || '-';
const audioBtn = ce.audio ? `<span class="audio-btn" onclick="playAudio('${ce.audio}', this)" title="播放录音">🔊</span>` : '';
return `<tr><td>${i + 1}</td><td>${ce.type}</td><td>${kpText}</td><td>${ce.detail}</td><td><span class="badge ${correct ? 'correct' : 'wrong'}">${correct ? '✓ 正确' : '✗ 错误'}</span>${audioBtn}</td></tr>`;
const audioBtn = ce.audio ? `<span class="audio-btn opacity-60 ml-1.5 text-base" onclick="playAudio('${ce.audio}', this)" title="播放录音">🔊</span>` : '';
return `<tr class="border-b border-gray-50 hover:bg-gray-50/50"><td class="py-2 px-3 text-gray-400">${i + 1}</td><td class="py-2 px-3">${ce.type}</td><td class="py-2 px-3 text-gray-500">${kpText}</td><td class="py-2 px-3 text-gray-500 hidden sm:table-cell">${ce.detail}</td><td class="py-2 px-3"><span class="inline-block text-xs font-semibold px-2.5 py-0.5 rounded-full border ${badgeColor}">${correct ? '✓ 正确' : '✗ 错误'}</span>${audioBtn}</td></tr>`;
}).join('')}
</tbody>
</table>
</div>
</div>
`;
detail.innerHTML = html;
detailContainer.appendChild(detail);
@ -601,20 +435,21 @@
abilityTraining.forEach((at, idx) => {
const tr = document.createElement('tr');
tr.className = 'border-b border-gray-50 hover:bg-gray-50/50';
const result = (at.result || '').toLowerCase();
const badgeCls = result === 'perfect' ? 'perfect' : result === 'good' ? 'good' : 'oops';
const badgeColor = result === 'perfect' ? 'bg-emerald-50 text-emerald-600 border-emerald-200' : result === 'good' ? 'bg-blue-50 text-blue-600 border-blue-200' : 'bg-orange-50 text-orange-600 border-orange-200';
const subQuestionInfo = `${at.sub_question_correct || 0}/${at.sub_question_count || 0}`;
const atAudioBtn = at.audio ? `<span class="audio-btn" onclick="playAudio('${at.audio}', this)" title="播放录音">🔊</span>` : '';
const atAudioBtn = at.audio ? `<span class="audio-btn opacity-60 ml-1.5 text-base" onclick="playAudio('${at.audio}', this)" title="播放录音">🔊</span>` : '';
tr.innerHTML = `
<td>${idx + 1}</td>
<td>${at.source || '-'}</td>
<td>${at.type || '-'}</td>
<td>${at.title || '-'}</td>
<td>${at.detail || '-'}</td>
<td>${subQuestionInfo}</td>
<td><span class="badge ${badgeCls}">${result}</span>${atAudioBtn}</td>
<td class="py-2.5 px-3 text-gray-400">${idx + 1}</td>
<td class="py-2.5 px-3">${at.source || '-'}</td>
<td class="py-2.5 px-3">${at.type || '-'}</td>
<td class="py-2.5 px-3">${at.title || '-'}</td>
<td class="py-2.5 px-3 text-gray-500 hidden sm:table-cell">${at.detail || '-'}</td>
<td class="py-2.5 px-3">${subQuestionInfo}</td>
<td class="py-2.5 px-3"><span class="inline-block text-xs font-semibold px-2.5 py-0.5 rounded-full border ${badgeColor}">${result}</span>${atAudioBtn}</td>
`;
abilityTbody.appendChild(tr);
});

465
skills/study-analysis/output/study_report_12345_L1_U1_20260403101313.html Normal file
View File

File diff suppressed because one or more lines are too long

465
skills/study-analysis/output/study_report_12345_L1_U1_20260403101641.html Normal file
View File

File diff suppressed because one or more lines are too long

1656
skills/study-analysis/output/test_data_20260403101313.json Normal file
View File

File diff suppressed because it is too large Load Diff

1656
skills/study-analysis/output/test_data_20260403101641.json Normal file
View File

File diff suppressed because it is too large Load Diff

50
skills/use_vala_skillhub.vala/README.md
View File

@ -1,50 +0,0 @@
# use_vala_skillhub
Vala SkillHub 技能管理 —— 让数字员工推送、安装和自动同步技能。
## 功能
- **推送技能**：将本地 `./skills` 下的技能上传到 SkillHub（Gitea 仓库）
- **安装 / 更新技能**：从 SkillHub 下载技能到本地 `./skills` 目录（已存在则清空后重新下载）
- **查看技能**：列出 SkillHub 上的所有技能
- **自动同步**：基于内容哈希检测变更，仅推送有变化的 skill，避免重复推送
## 设计要点
推送和安装均不在 `./skills` 目录内产生 `.git`，确保不影响 workspace 级别的 git 备份：
- **推送 / 自动同步**：复制到 `./tmp/skill_push/` 临时目录，完成 git 推送后清理
- **安装**：通过 Gitea API 下载归档解压，不使用 git clone
- **变更检测**：通过 `./.vala_skill_hashes` 记录每个 skill 的内容哈希，对比检测变更
## 自动同步机制
数字员工在新增或修改 skill 后，**必须自动执行 check_and_push**：
1. 计算 skill 目录的综合哈希（含文件路径 + 内容）
2. 与 `./.vala_skill_hashes` 中的历史哈希对比
3. 仅推送有变更的 skill，推送成功后更新哈希记录
可选配合 `cron_job` 技能设置定时全量同步作为安全网。
## 命名规则
仓库名 = `技能名` + `.` + `来源名`
| 示例 | 含义 |
|------|------|
| `cron_job.xiaoxi` | xiaoxi 的定时任务技能 |
| `web_scraper.vala` | 公司官方的爬虫技能 |
来源为 `vala` 的属于公司级别官方技能。
## 配置
首次使用需提供配置，保存在 `./.vala_skillhub_config`（当前 workspace 根目录下，各数字员工独立）：
- `GITEA_URL` — Gitea 服务地址（默认 `https://git.valavala.com`）
- `GITEA_TOKEN` — API Token（需有组织仓库的创建和推送权限）
- `GITEA_OWNER` — SkillHub 组织名（默认 `vala_skillhub`）
- `SOURCE_NAME` — 当前数字员工的 name
## 使用方式
本技能面向 AI 数字员工使用。请参阅 `SKILL.md` 了解完整操作流程和命令。

292
skills/use_vala_skillhub.vala/SKILL.md
View File

@ -1,292 +0,0 @@
# use_vala_skillhub
管理 Vala SkillHub 上的技能：推送（上传）和安装。
SkillHub 基于 Gitea，每个技能对应一个独立的 Git 仓库。推送时使用 `./tmp` 临时目录，不在 `./skills` 内创建 `.git`，避免影响 workspace 级别的 git 备份。
## 命名规则
仓库名格式：`{skill_name}.{source_name}`
- `skill_name`：技能目录名（如 `cron_job`、`web_scraper`）
- `source_name`：来源名称，即当前数字员工的 name（如 `xiaoxi`）
- 如果 `source_name` 为 `vala`，表示公司级别的官方技能
示例：
- `cron_job.xiaoxi` — xiaoxi 的定时任务技能
- `web_scraper.vala` — 公司官方的爬虫技能
## 配置
操作前需要确认以下配置（保存到 `./.vala_skillhub_config`，即当前 workspace 根目录下）：
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| `GITEA_URL` | Gitea 服务地址 | `https://git.valavala.com` |
| `GITEA_TOKEN` | Gitea API Token（需有创建仓库和推送权限） | — |
| `GITEA_OWNER` | SkillHub 组织名 | `vala_skillhub` |
| `SOURCE_NAME` | 当前数字员工的 name，用于组合仓库名 | — |
如果配置文件不存在，请询问用户获取以上信息后创建：
```bash
cat > ./.vala_skillhub_config <<EOF
GITEA_URL=https://git.valavala.com
GITEA_TOKEN=<token>
GITEA_OWNER=vala_skillhub
SOURCE_NAME=<name>
EOF
```
后续操作前先加载配置：
```bash
source ./.vala_skillhub_config
```
---
## 操作一：推送技能到 SkillHub
将本地 `./skills` 下的技能目录推送到 SkillHub。
**核心原则**：使用 `./tmp/skill_push/` 作为临时工作区，不在 `./skills` 内执行任何 git 操作，保持 workspace 干净。
### 流程
1. **确定仓库名**：`repo_name = {skill_dir_name}.{SOURCE_NAME}`
2. **检查远程仓库是否存在**：
```bash
curl -s -o /dev/null -w "%{http_code}" \
"${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}" \
-H "Authorization: token ${GITEA_TOKEN}"
```
- 返回 200 → 仓库已存在，跳到步骤 4
- 返回 404 → 需要创建，执行步骤 3
3. **创建远程仓库**：
```bash
curl -s -X POST "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos" \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"name": "'${repo_name}'", "private": false, "description": "技能描述", "auto_init": false}'
```
4. **复制到临时目录并推送**：
```bash
# 清理并准备临时目录
rm -rf ./tmp/skill_push/${repo_name}
mkdir -p ./tmp/skill_push/${repo_name}
# 复制技能内容（不含隐藏文件的 .git 等）
cp -r ./skills/${skill_dir_name}/* ./tmp/skill_push/${repo_name}/
cp -r ./skills/${skill_dir_name}/.[!.]* ./tmp/skill_push/${repo_name}/ 2>/dev/null || true
# 在临时目录中执行 git 操作
cd ./tmp/skill_push/${repo_name}
git init
git checkout -b main
git add -A
git commit -m "update: sync skill $(date +%Y-%m-%d)"
git remote add origin https://oauth2:${GITEA_TOKEN}@${GITEA_URL#https://}/${GITEA_OWNER}/${repo_name}.git
git push -u origin main --force
```
5. **清理临时目录**：
```bash
cd -
rm -rf ./tmp/skill_push/${repo_name}
```
### 批量推送
遍历 `./skills/` 下所有子目录，对每个目录重复以上流程。注意跳过 `use_vala_skillhub` 目录本身。
---
## 操作二：安装 / 更新技能
从 SkillHub 下载技能到本地 `./skills` 目录。若本地已存在同名目录，则**清空后重新下载**，确保与远程版本一致。
**注意**：不使用 `git clone`，而是下载归档解压，避免在 `./skills` 下产生 `.git` 目录。
### 流程
1. **确定要安装的仓库名**（完整名，如 `cron_job.xiaoxi`）
2. **下载并解压**（已存在则先清空再覆盖）：
```bash
repo_name="cron_job.xiaoxi"
target_dir="./skills/${repo_name}"
# 如果已存在，清空目录内容以确保与远程一致（删除远程已移除的文件）
rm -rf "${target_dir}"
mkdir -p "${target_dir}"
# 通过 Gitea API 下载 tar.gz 归档并解压（自动尝试 main/master）
curl -sL "${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}/archive/main.tar.gz" \
-H "Authorization: token ${GITEA_TOKEN}" \
| tar xz --strip-components=1 -C "${target_dir}" 2>/dev/null \
|| curl -sL "${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}/archive/master.tar.gz" \
-H "Authorization: token ${GITEA_TOKEN}" \
| tar xz --strip-components=1 -C "${target_dir}"
```
---
## 操作三：列出 SkillHub 上的技能
```bash
curl -s "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos?page=1&limit=50&sort=updated" \
-H "Authorization: token ${GITEA_TOKEN}"
```
返回 JSON 数组，每个元素包含 `name`、`description`、`updated_at` 等字段。如结果满 50 条，继续翻页 `page=2`。
---
## 操作四：自动同步（变更检测 + 自动推送）
当 skill 发生新增或更新时，自动检测变更并仅推送有变化的 skill。
### 哈希状态文件
使用 `./.vala_skill_hashes`（workspace 根目录下）记录每个 skill 上次推送时的内容哈希，格式为每行一条记录：
```
skill_dir_name hash
```
示例：
```
cron_job a3f2b8c9...
web_scraper 7d1e4f6a...
```
### 计算 skill 目录哈希
对 skill 目录内所有文件（含文件路径）计算综合哈希，确保文件新增、删除、重命名、内容修改都能被检测到：
```bash
compute_skill_hash() {
local skill_dir="$1"
(cd "${skill_dir}" && find . -type f -not -path '*/\.*' | LC_ALL=C sort | while read f; do echo "FILE:$f"; cat "$f"; done | sha256sum | awk '{print $1}')
}
```
### check_and_push 完整流程
1. **加载配置和哈希状态**：
```bash
source ./.vala_skillhub_config
HASH_FILE=./.vala_skill_hashes
touch "${HASH_FILE}"
```
2. **遍历 `./skills/` 下所有 skill 目录**，对每个 skill：
```bash
for skill_dir in ./skills/*/; do
skill_name=$(basename "${skill_dir}")
# 跳过 use_vala_skillhub 自身
if [ "${skill_name}" = "use_vala_skillhub" ]; then
continue
fi
# 计算当前哈希
current_hash=$(compute_skill_hash "${skill_dir}")
# 读取上次推送的哈希
stored_hash=$(grep "^${skill_name} " "${HASH_FILE}" | awk '{print $2}')
if [ "${current_hash}" = "${stored_hash}" ]; then
echo "[skip] ${skill_name} — 无变更"
continue
fi
echo "[sync] ${skill_name} — 检测到变更，开始推送..."
# 执行推送（同操作一的流程）
repo_name="${skill_name}.${SOURCE_NAME}"
# 检查远程仓库是否存在
http_code=$(curl -s -o /dev/null -w "%{http_code}" \
"${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}" \
-H "Authorization: token ${GITEA_TOKEN}")
# 如果不存在则创建
if [ "${http_code}" = "404" ]; then
# 从 skill.json 读取描述（如果有）
desc=""
if [ -f "${skill_dir}/skill.json" ]; then
desc=$(cat "${skill_dir}/skill.json" | grep '"description"' | head -1 | sed 's/.*"description"[[:space:]]*:[[:space:]]*"\(.*\)".*/\1/')
fi
curl -s -X POST "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos" \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"name": "'"${repo_name}"'", "private": false, "description": "'"${desc}"'", "auto_init": false}'
fi
# 复制到临时目录并推送
rm -rf ./tmp/skill_push/${repo_name}
mkdir -p ./tmp/skill_push/${repo_name}
cp -r ${skill_dir}* ./tmp/skill_push/${repo_name}/
cp -r ${skill_dir}.[!.]* ./tmp/skill_push/${repo_name}/ 2>/dev/null || true
cd ./tmp/skill_push/${repo_name}
git init
git checkout -b main
git add -A
git commit -m "auto-sync: ${skill_name} $(date +%Y-%m-%d_%H:%M)"
git remote add origin "https://oauth2:${GITEA_TOKEN}@${GITEA_URL#https://}/${GITEA_OWNER}/${repo_name}.git"
git push -u origin main --force
cd -
# 清理临时目录
rm -rf ./tmp/skill_push/${repo_name}
# 更新哈希状态文件
# 先移除旧记录，再追加新记录
grep -v "^${skill_name} " "${HASH_FILE}" > "${HASH_FILE}.tmp" || true
echo "${skill_name} ${current_hash}" >> "${HASH_FILE}.tmp"
mv "${HASH_FILE}.tmp" "${HASH_FILE}"
echo "[done] ${skill_name} — 推送完成"
done
```
3. **输出同步摘要**：推送完成后，汇总本次同步了哪些 skill（跳过了哪些）。
### 单个 skill 的快速同步
当你明确知道哪个 skill 发生了变更时，可以仅对该 skill 执行 check_and_push，无需遍历所有目录：
```bash
skill_name="目标skill名"
skill_dir="./skills/${skill_name}"
# 然后执行上面循环体中的逻辑
```
---
## 数字员工行为规范（重要）
作为数字员工，你**必须**在以下场景中自动执行 `check_and_push`：
1. **创建新 skill 后** — 在 `./skills/` 下新建了 skill 目录并完成编写后，立即执行同步
2. **修改现有 skill 后** — 对 `./skills/` 下任何 skill 的文件做了修改后，立即执行同步
3. **删除 skill 文件后** — 如果删除了 skill 中的某些文件（重构等），同步以保持远程一致
4. **定时兜底**（可选） — 如果你拥有 `cron_job` 技能，建议设置每日一次的全量 check_and_push 作为安全网
### 推送时机建议
- **立即推送**：skill 的功能性变更完成且验证通过后
- **不要推送**：正在编辑中间态、尚未完成的 skill
- **批量场景**：如果一次性修改了多个 skill，在全部完成后执行一次全量 check_and_push 即可
### 自动推送日志
每次推送后，建议在控制台输出简短日志，方便追溯：
```
[auto-sync] 2025-04-01 23:00 — 推送 2 个 skill: cron_job, web_scraper | 跳过 3 个（无变更）
```

14
skills/use_vala_skillhub.vala/skill.json
View File

@ -1,14 +0,0 @@
{
"name": "use_vala_skillhub",
"version": "4.0.0",
"description": "管理 Vala SkillHub 上的技能：推送、安装、自动同步（变更检测 + 自动推送，不影响 workspace git 备份）",
"author": "vala",
"tags": [
"skillhub",
"git",
"管理",
"备份",
"自动同步"
],
"config_file": "./.vala_skillhub_config"
}

50
skills/use_vala_skillhub/README.md
View File

@ -1,50 +0,0 @@
# use_vala_skillhub
Vala SkillHub 技能管理 —— 让数字员工推送、安装和自动同步技能。
## 功能
- **推送技能**：将本地 `./skills` 下的技能上传到 SkillHub（Gitea 仓库）
- **安装 / 更新技能**：从 SkillHub 下载技能到本地 `./skills` 目录（已存在则清空后重新下载）
- **查看技能**：列出 SkillHub 上的所有技能
- **自动同步**：基于内容哈希检测变更，仅推送有变化的 skill，避免重复推送
## 设计要点
推送和安装均不在 `./skills` 目录内产生 `.git`，确保不影响 workspace 级别的 git 备份：
- **推送 / 自动同步**：复制到 `./tmp/skill_push/` 临时目录，完成 git 推送后清理
- **安装**：通过 Gitea API 下载归档解压，不使用 git clone
- **变更检测**：通过 `./.vala_skill_hashes` 记录每个 skill 的内容哈希，对比检测变更
## 自动同步机制
数字员工在新增或修改 skill 后，**必须自动执行 check_and_push**：
1. 计算 skill 目录的综合哈希（含文件路径 + 内容）
2. 与 `./.vala_skill_hashes` 中的历史哈希对比
3. 仅推送有变更的 skill，推送成功后更新哈希记录
可选配合 `cron_job` 技能设置定时全量同步作为安全网。
## 命名规则
仓库名 = `技能名` + `.` + `来源名`
| 示例 | 含义 |
|------|------|
| `cron_job.xiaoxi` | xiaoxi 的定时任务技能 |
| `web_scraper.vala` | 公司官方的爬虫技能 |
来源为 `vala` 的属于公司级别官方技能。
## 配置
首次使用需提供配置，保存在 `./.vala_skillhub_config`（当前 workspace 根目录下，各数字员工独立）：
- `GITEA_URL` — Gitea 服务地址（默认 `https://git.valavala.com`）
- `GITEA_TOKEN` — API Token（需有组织仓库的创建和推送权限）
- `GITEA_OWNER` — SkillHub 组织名（默认 `vala_skillhub`）
- `SOURCE_NAME` — 当前数字员工的 name
## 使用方式
本技能面向 AI 数字员工使用。请参阅 `SKILL.md` 了解完整操作流程和命令。

292
skills/use_vala_skillhub/SKILL.md
View File

@ -1,292 +0,0 @@
# use_vala_skillhub
管理 Vala SkillHub 上的技能：推送（上传）和安装。
SkillHub 基于 Gitea，每个技能对应一个独立的 Git 仓库。推送时使用 `./tmp` 临时目录，不在 `./skills` 内创建 `.git`，避免影响 workspace 级别的 git 备份。
## 命名规则
仓库名格式：`{skill_name}.{source_name}`
- `skill_name`：技能目录名（如 `cron_job`、`web_scraper`）
- `source_name`：来源名称，即当前数字员工的 name（如 `xiaoxi`）
- 如果 `source_name` 为 `vala`，表示公司级别的官方技能
示例：
- `cron_job.xiaoxi` — xiaoxi 的定时任务技能
- `web_scraper.vala` — 公司官方的爬虫技能
## 配置
操作前需要确认以下配置（保存到 `./.vala_skillhub_config`，即当前 workspace 根目录下）：
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| `GITEA_URL` | Gitea 服务地址 | `https://git.valavala.com` |
| `GITEA_TOKEN` | Gitea API Token（需有创建仓库和推送权限） | — |
| `GITEA_OWNER` | SkillHub 组织名 | `vala_skillhub` |
| `SOURCE_NAME` | 当前数字员工的 name，用于组合仓库名 | — |
如果配置文件不存在，请询问用户获取以上信息后创建：
```bash
cat > ./.vala_skillhub_config <<EOF
GITEA_URL=https://git.valavala.com
GITEA_TOKEN=<token>
GITEA_OWNER=vala_skillhub
SOURCE_NAME=<name>
EOF
```
后续操作前先加载配置：
```bash
source ./.vala_skillhub_config
```
---
## 操作一：推送技能到 SkillHub
将本地 `./skills` 下的技能目录推送到 SkillHub。
**核心原则**：使用 `./tmp/skill_push/` 作为临时工作区，不在 `./skills` 内执行任何 git 操作，保持 workspace 干净。
### 流程
1. **确定仓库名**：`repo_name = {skill_dir_name}.{SOURCE_NAME}`
2. **检查远程仓库是否存在**：
```bash
curl -s -o /dev/null -w "%{http_code}" \
"${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}" \
-H "Authorization: token ${GITEA_TOKEN}"
```
- 返回 200 → 仓库已存在，跳到步骤 4
- 返回 404 → 需要创建，执行步骤 3
3. **创建远程仓库**：
```bash
curl -s -X POST "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos" \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"name": "'${repo_name}'", "private": false, "description": "技能描述", "auto_init": false}'
```
4. **复制到临时目录并推送**：
```bash
# 清理并准备临时目录
rm -rf ./tmp/skill_push/${repo_name}
mkdir -p ./tmp/skill_push/${repo_name}
# 复制技能内容（不含隐藏文件的 .git 等）
cp -r ./skills/${skill_dir_name}/* ./tmp/skill_push/${repo_name}/
cp -r ./skills/${skill_dir_name}/.[!.]* ./tmp/skill_push/${repo_name}/ 2>/dev/null || true
# 在临时目录中执行 git 操作
cd ./tmp/skill_push/${repo_name}
git init
git checkout -b main
git add -A
git commit -m "update: sync skill $(date +%Y-%m-%d)"
git remote add origin https://oauth2:${GITEA_TOKEN}@${GITEA_URL#https://}/${GITEA_OWNER}/${repo_name}.git
git push -u origin main --force
```
5. **清理临时目录**：
```bash
cd -
rm -rf ./tmp/skill_push/${repo_name}
```
### 批量推送
遍历 `./skills/` 下所有子目录，对每个目录重复以上流程。注意跳过 `use_vala_skillhub` 目录本身。
---
## 操作二：安装 / 更新技能
从 SkillHub 下载技能到本地 `./skills` 目录。若本地已存在同名目录，则**清空后重新下载**，确保与远程版本一致。
**注意**：不使用 `git clone`，而是下载归档解压，避免在 `./skills` 下产生 `.git` 目录。
### 流程
1. **确定要安装的仓库名**（完整名，如 `cron_job.xiaoxi`）
2. **下载并解压**（已存在则先清空再覆盖）：
```bash
repo_name="cron_job.xiaoxi"
target_dir="./skills/${repo_name}"
# 如果已存在，清空目录内容以确保与远程一致（删除远程已移除的文件）
rm -rf "${target_dir}"
mkdir -p "${target_dir}"
# 通过 Gitea API 下载 tar.gz 归档并解压（自动尝试 main/master）
curl -sL "${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}/archive/main.tar.gz" \
-H "Authorization: token ${GITEA_TOKEN}" \
| tar xz --strip-components=1 -C "${target_dir}" 2>/dev/null \
|| curl -sL "${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}/archive/master.tar.gz" \
-H "Authorization: token ${GITEA_TOKEN}" \
| tar xz --strip-components=1 -C "${target_dir}"
```
---
## 操作三：列出 SkillHub 上的技能
```bash
curl -s "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos?page=1&limit=50&sort=updated" \
-H "Authorization: token ${GITEA_TOKEN}"
```
返回 JSON 数组，每个元素包含 `name`、`description`、`updated_at` 等字段。如结果满 50 条，继续翻页 `page=2`。
---
## 操作四：自动同步（变更检测 + 自动推送）
当 skill 发生新增或更新时，自动检测变更并仅推送有变化的 skill。
### 哈希状态文件
使用 `./.vala_skill_hashes`（workspace 根目录下）记录每个 skill 上次推送时的内容哈希，格式为每行一条记录：
```
skill_dir_name hash
```
示例：
```
cron_job a3f2b8c9...
web_scraper 7d1e4f6a...
```
### 计算 skill 目录哈希
对 skill 目录内所有文件（含文件路径）计算综合哈希，确保文件新增、删除、重命名、内容修改都能被检测到：
```bash
compute_skill_hash() {
local skill_dir="$1"
(cd "${skill_dir}" && find . -type f -not -path '*/\.*' | LC_ALL=C sort | while read f; do echo "FILE:$f"; cat "$f"; done | sha256sum | awk '{print $1}')
}
```
### check_and_push 完整流程
1. **加载配置和哈希状态**：
```bash
source ./.vala_skillhub_config
HASH_FILE=./.vala_skill_hashes
touch "${HASH_FILE}"
```
2. **遍历 `./skills/` 下所有 skill 目录**，对每个 skill：
```bash
for skill_dir in ./skills/*/; do
skill_name=$(basename "${skill_dir}")
# 跳过 use_vala_skillhub 自身
if [ "${skill_name}" = "use_vala_skillhub" ]; then
continue
fi
# 计算当前哈希
current_hash=$(compute_skill_hash "${skill_dir}")
# 读取上次推送的哈希
stored_hash=$(grep "^${skill_name} " "${HASH_FILE}" | awk '{print $2}')
if [ "${current_hash}" = "${stored_hash}" ]; then
echo "[skip] ${skill_name} — 无变更"
continue
fi
echo "[sync] ${skill_name} — 检测到变更，开始推送..."
# 执行推送（同操作一的流程）
repo_name="${skill_name}.${SOURCE_NAME}"
# 检查远程仓库是否存在
http_code=$(curl -s -o /dev/null -w "%{http_code}" \
"${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}" \
-H "Authorization: token ${GITEA_TOKEN}")
# 如果不存在则创建
if [ "${http_code}" = "404" ]; then
# 从 skill.json 读取描述（如果有）
desc=""
if [ -f "${skill_dir}/skill.json" ]; then
desc=$(cat "${skill_dir}/skill.json" | grep '"description"' | head -1 | sed 's/.*"description"[[:space:]]*:[[:space:]]*"\(.*\)".*/\1/')
fi
curl -s -X POST "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos" \
-H "Authorization: token ${GITEA_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"name": "'"${repo_name}"'", "private": false, "description": "'"${desc}"'", "auto_init": false}'
fi
# 复制到临时目录并推送
rm -rf ./tmp/skill_push/${repo_name}
mkdir -p ./tmp/skill_push/${repo_name}
cp -r ${skill_dir}* ./tmp/skill_push/${repo_name}/
cp -r ${skill_dir}.[!.]* ./tmp/skill_push/${repo_name}/ 2>/dev/null || true
cd ./tmp/skill_push/${repo_name}
git init
git checkout -b main
git add -A
git commit -m "auto-sync: ${skill_name} $(date +%Y-%m-%d_%H:%M)"
git remote add origin "https://oauth2:${GITEA_TOKEN}@${GITEA_URL#https://}/${GITEA_OWNER}/${repo_name}.git"
git push -u origin main --force
cd -
# 清理临时目录
rm -rf ./tmp/skill_push/${repo_name}
# 更新哈希状态文件
# 先移除旧记录，再追加新记录
grep -v "^${skill_name} " "${HASH_FILE}" > "${HASH_FILE}.tmp" || true
echo "${skill_name} ${current_hash}" >> "${HASH_FILE}.tmp"
mv "${HASH_FILE}.tmp" "${HASH_FILE}"
echo "[done] ${skill_name} — 推送完成"
done
```
3. **输出同步摘要**：推送完成后，汇总本次同步了哪些 skill（跳过了哪些）。
### 单个 skill 的快速同步
当你明确知道哪个 skill 发生了变更时，可以仅对该 skill 执行 check_and_push，无需遍历所有目录：
```bash
skill_name="目标skill名"
skill_dir="./skills/${skill_name}"
# 然后执行上面循环体中的逻辑
```
---
## 数字员工行为规范（重要）
作为数字员工，你**必须**在以下场景中自动执行 `check_and_push`：
1. **创建新 skill 后** — 在 `./skills/` 下新建了 skill 目录并完成编写后，立即执行同步
2. **修改现有 skill 后** — 对 `./skills/` 下任何 skill 的文件做了修改后，立即执行同步
3. **删除 skill 文件后** — 如果删除了 skill 中的某些文件（重构等），同步以保持远程一致
4. **定时兜底**（可选） — 如果你拥有 `cron_job` 技能，建议设置每日一次的全量 check_and_push 作为安全网
### 推送时机建议
- **立即推送**：skill 的功能性变更完成且验证通过后
- **不要推送**：正在编辑中间态、尚未完成的 skill
- **批量场景**：如果一次性修改了多个 skill，在全部完成后执行一次全量 check_and_push 即可
### 自动推送日志
每次推送后，建议在控制台输出简短日志，方便追溯：
```
[auto-sync] 2025-04-01 23:00 — 推送 2 个 skill: cron_job, web_scraper | 跳过 3 个（无变更）
```

14
skills/use_vala_skillhub/skill.json
View File

@ -1,14 +0,0 @@
{
"name": "use_vala_skillhub",
"version": "4.0.0",
"description": "管理 Vala SkillHub 上的技能：推送、安装、自动同步（变更检测 + 自动推送，不影响 workspace git 备份）",
"author": "vala",
"tags": [
"skillhub",
"git",
"管理",
"备份",
"自动同步"
],
"config_file": "./.vala_skillhub_config"
}