Sum2Slides Lite

对话总结成专业PPT，支持纯本地处理和可选飞书上传 (v1.1.6)

Security Scan

The skill's code, optional Feishu upload, and runtime instructions are internally consistent with a PPT generator that can run fully locally; run the provided verification scripts and review the Feishu integration before enabling uploads.

Purpose & Capability

The name/description (convert dialogue to PPT with optional Feishu upload) matches the code and docs: PPT generators, content planner, and an explicit platforms/feishu implementation are present. The SKILL.md and many security docs plainly state Feishu credentials (FEISHU_APP_ID / FEISHU_APP_SECRET) are optional and only needed for upload functionality.

Instruction Scope

SKILL.md restricts network activity to an opt-in Feishu mode and instructs the user to keep feishu.enabled=false and not set FEISHU_* env vars for pure-local operation. The runtime instructions ask users to run local verification/test scripts and to manually copy or symlink files into the skills folder; they do not direct arbitrary file/system/network access beyond the stated functionality.

Install Mechanism

Registry metadata shows no install spec (instruction-only), and SKILL.md gives manual install steps. However, the package contains many code files (not truly 'no-code'), so installation is manual/copy-based. This is lower-risk than a remote installer, but requires the user to perform the manual steps and to review files before copying.

Credentials

No required environment variables are declared and no primary credential is required. The only credentials the code references are FEISHU_APP_ID/FEISHU_APP_SECRET, which are documented as optional and only needed for Feishu uploads — proportional to the stated optional feature.

Persistence & Privilege

The skill is not force-included (always:false) and is user-invocable. Installation is manual (copy/symlink) per instructions; there is no code in the package that requests elevated privileges or modifies other skills' configuration in the provided files.

Assessment

This package appears to implement what it claims: a local PPT generator with an optional Feishu uploader. Before installing: 1) review the code (especially platforms/feishu/feishu_platform.py) to confirm you understand where network calls occur; 2) run the included INSTALL_VERIFICATION.py, quick_permission_check.py, and simple_sum2slides_test.py inside an isolated test directory; 3) keep feishu.enabled=false and do not set FEISHU_APP_ID/FEISHU_APP_SECRET unless you trust the package and want upload functionality; 4) prefer manual copy or symlink installation (as documented) instead of any automated installer. I give medium confidence because many files were truncated/omitted for review — if you want a higher-confidence assessment, provide the omitted files (or search them for exec/eval/dynamic network endpoints and unexpected credential accesses).

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 - 智能对话总结，安全可控

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