← 返回工具目录

AI 使用指南

让 AI 整理材料、检查字段,再调用同一套工具生成文件。

安装 skill

下载 skill,解压后将 volunteer-tools 文件夹放入助手的技能目录。Codex 使用 ~/.codex/skills/。配套脚本默认连接本站 https://info.rmbsvol.icu,无需另外启动本地服务。

脚本会自动建立本站会话并取得页面安全令牌,不需要配置模型 API Key 或手工复制 Cookie。

交给助手处理

把这份活动名单整理成学生发展网报送表,再帮我生成结项申请书。

助手会先检查姓名、学号、时数等字段。缺失的信息需要补充,最终计算和文书排版由工具完成。

脚本调用示例
python scripts/client.py tools
python scripts/client.py validate reports --files 名单.xlsx
python scripts/client.py generate reports --files 名单.xlsx --out-dir 生成材料
python scripts/client.py generate reports --files 名单.xlsx --college-mode exclude --unknown-policy keep --out-dir 商学院报表
python scripts/client.py generate reports --files 名单.xlsx --then-closing 活动信息.json --out-dir 全套材料

以上路径相对于解压后的 skill 目录。活动信息 JSON 示例:

{"name":"秋季支教项目","responsible_unit":"商学院青年志愿者协会","date_range":"2026年9月至12月","location":"服务地点","frequency":"每周一次","description":"请填写实际活动总结","manager_name":"实际负责人","manager_phone":"实际联系方式"}

调用流程

GET /api/v1/tools发现工具、规则和限制
POST /api/v1/files上传 Excel,取得文件标识
POST /api/v1/{工具}/validate检查材料,返回问题和预览
POST /api/v1/{工具}/generate生成文件,取得下载地址

网页与 AI 沿用相同的学院筛选、2025 年级处理和分数计算规则。原报表和结项文书的输出格式不变。

材料由当前工具服务处理,不自动建档或报送。每次最多 10 文件、5000 行;临时文件按会话隔离、保留 1 小时,也可主动清空。脚本下载后会清理该次调用的临时文件。

志愿北京

本站正式环境不提供志愿北京登录或录入接口。需要人工使用时,请前往独立项目 bv2008BatchTool。

前往 GitHub 项目 ↗