拉片工具 - 专业影片分析工具

拉片工具是一款专业的影片分析工具，支持视频播放、时间点标记、结构化笔记和多种格式导出。无论是电影专业学生、影视爱好者还是内容创作者，都可以通过本工具进行深入的影片分析。

主要功能

• 🎬 视频播放控制 - 基于ArtPlayer.js的流畅视频播放体验
• ⏱️ 时间点标记 - 精确标记关键时间点，支持截图和笔记
• 📝 结构化笔记 - 支持富文本编辑，创建层次分明的分析笔记
• 💾 项目管理 - 创建、保存、加载和管理多个分析项目
• 📤 多格式导出 - 支持导出为word、PDF等多种格式
• 🎨 响应式设计 - 适配各种屏幕尺寸，提供一致的用户体验

技术架构

前端技术栈

• HTML5 - 语义化标记，提供良好的可访问性
• CSS3 - 响应式设计，美观的界面
• JavaScript (ES6+) - 原生JavaScript实现，无需框架依赖
• ArtPlayer.js - 强大的HTML5视频播放器
• LocalStorage - 本地数据存储

后端技术栈

• PHP - 简单的服务器端接口，用于项目保存和加载
• JSON - 数据交换格式

项目结构

lapian/
├── README.md              # 项目说明文档
├── LICENSE                # MIT许可证
├── CONTRIBUTING.md        # 贡献指南
├── CHANGELOG.md           # 更新日志
├── SECURITY.md            # 安全政策
├── package.json           # 项目信息和依赖
├── .eslintrc.json         # ESLint配置
├── .prettierrc            # Prettier配置
├── .gitignore             # Git忽略文件
├── index.html             # 主页面
├── editor.html            # 编辑器页面
├── projects.html          # 项目管理页面
├── styles.css             # 样式文件
├── script.js              # 主要业务逻辑
├── artplayer.js           # ArtPlayer.js库
├── save_project.php       # 保存项目接口
├── load_project.php       # 加载项目接口
├── projects/              # 项目数据存储目录
└── examples/              # 示例项目
    ├── README.md          # 示例说明
    ├── movie-example.json # 电影分析示例
    ├── ad-example.json    # 广告分析示例
    └── short-video-example.json # 短视频分析示例

快速开始

环境要求

• 现代浏览器（Chrome、Firefox、Safari、Edge等）
• 本地文件访问权限
• PHP服务器（可选，用于项目保存和加载功能）

安装步骤

方式一：直接运行（无需服务器）

直接运行

• 双击打开 index.html 文件
• 项目将在浏览器中直接运行，所有数据保存在本地

方式二：本地服务器运行

1. 克隆仓库

   git clone https://github.com/yourusername/pian.git
   cd pian

2. 启动本地服务器

   # 使用Python内置服务器
   python -m http.server 8000
   
   # 或使用PHP内置服务器
   php -S localhost:8000

3. 访问应用 打开浏览器，访问 http://localhost:8000

基本使用

1. 创建新项目

   • 点击"新建项目"按钮
   • 输入影片基本信息（标题、导演、年份等）
   • 点击"创建"按钮

2. 导入视频

   • 在编辑器页面点击"选择视频文件"
   • 选择本地视频文件
   • 视频将自动加载到播放器

3. 添加时间点标记

   • 播放视频到需要标记的时间点
   • 点击"添加标记"按钮
   • 输入标记说明
   • 可选择是否添加当前帧截图

4. 编写分析笔记

   • 使用富文本编辑器编写分析内容
   • 支持标题、段落、列表等格式
   • 可插入时间点标记链接

5. 保存项目

   • 点击"保存项目"按钮
   • 项目将保存到服务器或本地存储

6. 导出分析

   • 点击"导出"按钮
   • 选择导出格式（Markdown、PDF等）
   • 下载导出文件

示例项目

项目提供了三个示例项目，帮助您快速了解如何使用工具进行影片分析：

• 电影分析示例 - 《肖申克的救赎》镜头语言分析
• 广告分析示例 - Apple品牌广告视觉设计分析
• 短视频分析示例 - 抖音热门短视频内容结构分析

详细使用方法请参考 examples/README.md。

贡献指南

我们欢迎任何形式的贡献，包括但不限于：

• 报告问题
• 提出新功能建议
• 改进文档
• 提交代码修复

请阅读 CONTRIBUTING.md 了解如何参与项目开发。

版本历史

请查看 CHANGELOG.md 了解项目的版本历史和更新内容。

安全政策

我们重视所有用户的安全和隐私。如果您发现了安全漏洞，请阅读 SECURITY.md 了解如何报告。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

联系我们

• 问题反馈：GitHub Issues
• 功能建议：GitHub Discussions
• 安全问题：security@yourdomain.com

致谢

感谢以下开源项目和贡献者：

• ArtPlayer.js - 强大的HTML5视频播放器
• 所有为本项目贡献代码和想法的开发者

---

拉片工具 - 让影片分析更专业、更高效！