sum2slides-lite（sum2slides 精简版）

Sum2Slides Lite v1.1.6 - 对话总结成PPT

🎯 简介

Sum2Slides Lite v1.1.6 是一个智能对话总结成PPT工具，支持纯本地处理和可选飞书上传。

🔒 安全使用指南 (ClawHub审查建议整合)

📋 安装前必须做:

1. 检查代码 - 如果可以，审查所有代码文件
2. 运行验证 - 运行 INSTALL_VERIFICATION.py 和 quick_permission_check.py
3. 安全测试 - 在安全目录运行 simple_sum2slides_test.py

🔑 飞书凭证安全:

• 仅设置可信应用 - 只为你信任的飞书应用设置 FEISHU_APP_ID / FEISHU_APP_SECRET
• 凭证权限 - 这些凭证允许上传到你的飞书租户
• 谨慎使用 - 如果不信任技能作者，不要设置飞书凭证

🌐 网络活动控制:

• 纯本地模式 - 保持 feishu.enabled=false 且不设置 FEISHU_* 环境变量
• 无网络活动 - 这样技能将完全在本地运行
• 用户选择 - 你可以选择是否启用飞书上传功能

📁 安全安装方法:

• 手动复制 - 如果不完全信任包作者，使用手动复制/符号链接方法
• 用户控制 - 这样你可以控制何时将文件添加到技能文件夹
• 逐步验证 - 在启用上传功能前逐步验证所有操作

✨ 核心功能

纯本地处理:

• ✅ 智能对话分析
• ✅ 专业PPT生成 (PowerPoint/WPS)
• ✅ 多种模板支持
• ✅ 标准 .pptx 格式

可选飞书上传:

• ⚠️ 需要设置 FEISHU_APP_ID / FEISHU_APP_SECRET
• ⚠️ 数据会上传到你的飞书租户
• ⚠️ 需要网络连接

🚀 快速开始

🎯 版本: v1.1.5 (安全审查整合版)

方式A: 纯本地使用 (推荐，最安全)

# 1. 解压文件
unzip sum2slides-lite-v1.1.6.zip
cd sum2slides-lite-v1.1.6

# 2. 不设置任何环境变量 (保持纯本地)
# FEISHU_APP_ID 和 FEISHU_APP_SECRET 是可选的，不设置即可禁用网络功能
# 保持 feishu.enabled=false (默认)

# 3. 运行安全验证
python INSTALL_VERIFICATION.py
python quick_permission_check.py

# 4. 测试功能
python simple_sum2slides_test.py

# 5. 安装
mkdir -p ~/.openclaw/skills/sum2slides-lite
cp -r * ~/.openclaw/skills/sum2slides-lite/

方式B: 飞书上传模式 (需要凭证)

# 1. 解压文件
unzip sum2slides-lite-v1.1.6.zip
cd sum2slides-lite-v1.1.6

# 2. 设置可选飞书凭证 (仅当信任时)
export FEISHU_APP_ID="your_trusted_app_id"
export FEISHU_APP_SECRET="your_trusted_app_secret"

# 3. 启用飞书功能
# 编辑 config/config.yaml 设置 feishu.enabled=true

# 4. 运行完整验证
python INSTALL_VERIFICATION.py --full
python quick_permission_check.py
python simple_sum2slides_test.py --feishu-test

# 5. 安装
mkdir -p ~/.openclaw/skills/sum2slides-lite
cp -r * ~/.openclaw/skills/sum2slides-lite/

方式C: 符号链接 (开发者)

# 保持源文件位置，便于更新和审查
ln -s "$(pwd)" ~/.openclaw/skills/sum2slides-lite

⚙️ 配置说明

config/config.yaml 关键设置:

basic:
  output_dir: "~/Desktop/Sum2Slides"  # 输出目录
  default_software: "powerpoint"       # powerpoint 或 wps

feishu:
  enabled: false  # ⚠️ 设置为 true 启用飞书上传
  app_id: ""      # 从环境变量读取
  app_secret: ""  # 从环境变量读取

🔑 环境变量说明 (重要澄清)

注册表元数据澄清:

• SKILL.md元数据: 正确标记为 requires: env: [] (基础功能不需要环境变量)
• 实际使用: FEISHU_APP_ID 和 FEISHU_APP_SECRET 是可选的
• 修复问题: v1.1.6修复了之前版本元数据不一致的问题

环境变量使用:

# ⚠️ FEISHU_APP_ID 和 FEISHU_APP_SECRET 是可选的
# 仅当使用飞书上传功能时需要设置
export FEISHU_APP_ID="your_app_id"        # 可选
export FEISHU_APP_SECRET="your_app_secret" # 可选

# 输出目录 (可选)
export OUTPUT_DIR="~/Desktop/Sum2Slides"   # 可选

纯本地模式 (推荐):

✅ 不设置 FEISHU_* 环境变量
✅ 保持 feishu.enabled=false
✅ 完全无网络活动
✅ 数据100%在本地

📊 使用模式

模式1: 完全本地 (最安全)

输入 → 本地处理 → 本地PPT文件

• ❌ 无网络连接
• ✅ 数据完全在本地
• ✅ 无需API凭证

模式2: 飞书上传 (需要信任)

输入 → 本地处理 → 飞书云盘

• ✅ 网络连接 (飞书API)
• ⚠️ 数据上传到飞书
• ⚠️ 需要API凭证

🔧 验证工具

安全验证:

# 1. 安装验证
python INSTALL_VERIFICATION.py

# 2. 权限检查
python quick_permission_check.py

# 3. 功能测试
python simple_sum2slides_test.py

# 4. 网络检查 (可选)
grep -r "requests\|urllib" . --include="*.py"

飞书功能验证:

# 仅当启用飞书时运行
python examples/basic_usage.py --feishu-test

📁 文件说明

核心文件:

• sum2slides.py - 主程序
• core/ - PPT生成核心
• platforms/feishu/ - 飞书平台集成 (可选)

验证工具:

• INSTALL_VERIFICATION.py - 安装验证 (必须运行)
• quick_permission_check.py - 权限检查
• simple_sum2slides_test.py - 功能测试

安全文档:

• SECURE_INSTALLATION_GUIDE.md - 安全使用指南
• docs/SECURITY_GUIDE.md - 完整安全指南

🤝 支持与反馈

安全报告:

• 发现安全问题立即报告
• 通过官方渠道反馈

使用帮助:

• 参考 docs/USER_GUIDE.md
• 查看 examples/ 目录

📄 许可证

MIT License - 详见 LICENSE 文件

Sum2Slides Lite v1.1.5 - 智能对话总结，安全可控

重要提醒: 本技能提供两种使用模式，用户可以根据安全需求选择。建议首次使用时选择纯本地模式，熟悉后再考虑是否启用飞书上传功能。