# joplin附件清理

**Repository Path**: pkxt/joplin-plugin-clean-resources

## Basic Information

- **Project Name**: joplin附件清理
- **Description**: 清理未使用的资源文件,在 工具->清理未使用的附件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-26
- **Last Updated**: 2025-06-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Clean Unused Resources - Joplin 插件

一个用于清理 Joplin 中未使用附件的插件。

## 功能特点

- 自动扫描所有笔记和附件
- 智能识别未使用的附件
- 显示附件大小和名称
- 支持批量删除
- 带进度条显示
- 安全的确认机制

## 安装方法

1. 在 Joplin 中打开 工具 -> 选项 -> 插件
2. 搜索 "Clean Unused Resources"
3. 点击安装
4. 重启 Joplin

## 使用方法

### 清理未使用附件

1. 在 Joplin 菜单中点击 工具 -> 清理未使用的附件
2. 插件会自动扫描所有笔记和附件
3. 显示未使用附件的列表，包括：
   - 文件名
   - 文件大小
   - 总数量和总大小
4. 确认删除后开始清理
5. 显示进度条和实时状态
6. 完成后显示清理结果

### 注意事项

1. **删除前确认**
   - 插件会显示详细的附件信息
   - 提供确认对话框
   - 可以在删除前取消操作

2. **安全机制**
   - 只删除确实未被引用的附件
   - 支持所有类型的附件引用
   - 包括直接引用和 Markdown 引用

3. **进度显示**
   - 实时显示处理进度
   - 显示已删除数量
   - 显示释放的空间大小

## 附件引用检测

插件会检测以下类型的附件引用：
1. Markdown 图片引用：`![image](:/123456789)`
2. 普通附件引用：`[file](:/123456789)`
3. 直接引用：`:/123456789`

## 常见问题

1. **如何确定附件未被使用？**
   - 插件会扫描所有笔记内容
   - 检查所有可能的引用方式
   - 只有完全未被引用的附件才会被标记为未使用

2. **删除操作是否可恢复？**
   - 删除操作是永久的
   - 建议在删除前仔细确认
   - 可以通过 Joplin 的备份恢复误删的文件

3. **为什么看不到某些附件？**
   - 插件只显示未被任何笔记引用的附件
   - 如果附件被任何笔记引用，就不会出现在列表中

## 系统要求

- Joplin v2.8.0 或更高版本
- 支持所有 Joplin 支持的操作系统：
  - Windows
  - macOS
  - Linux

## 隐私说明

- 插件只在本地运行
- 不会发送任何数据到外部
- 不收集任何用户信息

## 更新日志

### v1.0.0
- 初始版本发布
- 基本的清理功能
- 进度显示
- 安全确认机制

## 反馈与支持

- [问题反馈](https://github.com/your-username/joplin-plugin-clean-resources/issues)
- [功能建议](https://github.com/your-username/joplin-plugin-clean-resources/issues)
- 邮件支持：your-email@example.com

## 许可证

MIT License

## 致谢

感谢以下开源项目：
- [Joplin](https://joplinapp.org/)
- [TypeScript](https://www.typescriptlang.org/)
- [Webpack](https://webpack.js.org/)