✨ 功能特性 | Features

🎯 核心功能

• 📄 实时预览 - 像Word一样查看DOCX文档内容
• ⏰ 自动刷新 - 5秒自动刷新，倒计时可视化
• 🔄 智能解压 - 一键解压DOCX为XML结构
• ⚡ 实时同步 - 编辑XML自动同步到DOCX文件
• 🎯 智能打包 - 编辑完成后一键生成DOCX

🎨 用户体验

• 🎛️ 三悬浮按钮 - 手动刷新、自动控制、倒计时指示
• �� 状态管理 - 状态栏实时显示同步状态
• 🔧 多文件夹 - 同时管理多个DOCX项目
• 📱 触屏友好 - 50px大按钮，适合各种设备

🎬 演示效果 | Demo

┌─────────────────────────────────────┐
│ 📄 DOCX文档预览     [🔄] [⏸️] [5] │  ← 三个悬浮按钮
├─────────────────────────────────────┤
│ Strategic Marketing and Product     │
│ Innovation for Expanding the        │
│ Resin Cat Figurine Market          │
│                                     │
│ Data Collection:                    │
│ Primary data will be gathered...    │
│                                     │
│ 自动倒计时: 5→4→3→2→1→🔄→重新开始  │
└─────────────────────────────────────┘

🚀 快速开始 | Quick Start

📦 安装

方法一：开发调试

git clone https://github.com/yourusername/DOCX_AotoPKUNZIP_AutoSave_Plugin.git
cd DOCX_AotoPKUNZIP_AutoSave_Plugin
npm install
# 在VSCode中按F5启动调试

方法二：VSIX安装

npm install -g vsce
vsce package
# 在VSCode中安装生成的.vsix文件

🎯 基本使用

1. 预览文档

   右键DOCX文件 → "DOCX: 预览文档"
   

2. 编辑文档

   右键DOCX文件 → "DOCX: 解压文档" → 编辑XML → 保存
   

3. 实时同步

   右键文件夹 → "DOCX: 启用实时同步" → 自动同步编辑
   

👥 适用场景 | Use Cases

📝 文书工作者

• 法律文档 - 批量处理合同模板
• 技术文档 - 多语言文档维护
• 学术论文 - 格式标准化处理
• 商务文档 - 模板批量定制

🔧 开发者

• 前端开发 - 处理Word模板和报告
• 数据分析 - 自动化报告生成
• 文档工程 - 大规模文档处理

📊 版本历程 | Version History

v1.2.3 (最新) ⏰

• ⏰ 5秒自动刷新 - 预览内容自动更新
• 🔄 智能倒计时 - 可视化下次刷新时间
• ⏸️ 一键控制 - 启用/停止自动刷新
• 🎯 三按钮布局 - 优化用户交互体验

v1.2.2 🎨

• 🗑️ 简化界面 - 移除冗余功能按钮
• 🎯 悬浮按钮 - 固定位置圆形按钮
• ✨ 交互动画 - 悬停放大、点击反馈
• 📱 触屏优化 - 大按钮适配移动设备

v1.2.1 🎨

• 🎯 UI优化 - 分离启用/停止命令
• 📊 智能状态栏 - 动态显示操作状态
• ✨ 体验改进 - 明确的反馈提示

v1.2.0 🚀

• 🔄 实时同步 - 自动监控文件夹变化
• ⚡ 防抖机制 - 2秒防抖避免频繁同步
• 📊 状态指示 - 实时显示同步状态
• 🎯 多文件夹 - 同时监控多个项目

🛠️ 技术架构 | Technical Architecture

核心技术栈

• VSCode Extension API - 插件框架
• JSZip - ZIP文件处理
• fs-extra - 文件系统操作
• WebView - 文档预览渲染
• FileSystemWatcher - 实时文件监控

项目结构

DOCX_AotoPKUNZIP_AutoSave_Plugin/
├── extension.js                 # 插件核心代码
├── package.json                 # 插件配置
├── README.md                    # 项目说明
├── 必看使用教程_Essential_User_Guide.md  # 详细教程
├── .vscode/                     # VSCode配置
│   ├── launch.json             # 调试配置
│   └── settings.json           # 工作区设置
└── docs/                       # 文档目录
    ├── v1.2.3自动刷新功能说明.md
    ├── v1.2.2预览界面优化说明.md
    └── ...                     # 其他版本说明

🤝 贡献 | Contributing

我们欢迎所有形式的贡献！ | We welcome all forms of contributions!

🐛 报告Bug | Report Bugs

在 Issues 中提交Bug报告

💡 功能建议 | Feature Requests

在 Issues 中提交功能建议

🔧 代码贡献 | Code Contributions

1. Fork 这个仓库
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证 | License

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

This project is licensed under the MIT License - see the LICENSE file for details

🙏 致谢 | Acknowledgments

• VSCode团队 - 提供强大的扩展API
• JSZip项目 - 优秀的ZIP文件处理库
• 开源社区 - 持续的支持和反馈
• 用户反馈 - 推动功能不断完善

📞 联系我们 | Contact

• GitHub Issues: 提交问题
• Email: your.email@example.com
• Twitter: @yourusername