{"id":28947855,"url":"https://github.com/cenglin123/aleph-managergui","last_synced_at":"2026-04-24T11:36:08.932Z","repository":{"id":296509099,"uuid":"993622118","full_name":"cenglin123/aleph-managerGUI","owner":"cenglin123","description":"一个基于 Python 的 Aleph.im 文件上传\u0026管理 GUI 工具","archived":false,"fork":false,"pushed_at":"2025-06-01T02:32:12.000Z","size":272,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-23T10:02:20.485Z","etag":null,"topics":["ipfs"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cenglin123.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-31T06:37:03.000Z","updated_at":"2025-06-10T12:58:40.000Z","dependencies_parsed_at":"2025-05-31T18:49:14.260Z","dependency_job_id":"97c3f2dc-efd2-4758-b6b4-e21545c9a354","html_url":"https://github.com/cenglin123/aleph-managerGUI","commit_stats":null,"previous_names":["cenglin123/aleph-managergui"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/cenglin123/aleph-managerGUI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cenglin123%2Faleph-managerGUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cenglin123%2Faleph-managerGUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cenglin123%2Faleph-managerGUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cenglin123%2Faleph-managerGUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cenglin123","download_url":"https://codeload.github.com/cenglin123/aleph-managerGUI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cenglin123%2Faleph-managerGUI/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261458422,"owners_count":23161175,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ipfs"],"created_at":"2025-06-23T10:02:20.428Z","updated_at":"2025-11-11T11:20:08.914Z","avatar_url":"https://github.com/cenglin123.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n# Aleph 分享助手\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/aleph_managerGUI.ico\" width=\"128\" height=\"128\" alt=\"Aleph Manager Icon\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e一个基于 Python 的 Aleph.im 网络文件管理图形界面工具\u003c/strong\u003e\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/cenglin123/aleph-managerGUI\"\u003e项目主页\u003c/a\u003e |\n  \u003ca href=\"https://github.com/cenglin123/aleph-managerGUI/releases/latest\"\u003e最新版本下载\u003c/a\u003e |\n  作者：层林尽染\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"imgs/interface.jpg\" alt=\"Aleph Manager Icon\"\u003e\n\u003c/p\u003e\n\n---\n\n## 1. 功能特点 📋\n\n- **账户管理**\n    \n    - 创建新的 Aleph.im 账户\n        \n    - 切换活跃账户\n        \n    - 删除不需要的账户\n        \n    - 实时刷新账户列表\n        \n    - 显示账户文件详情（JSON 格式）\n        \n- **CID 操作**\n    \n    - 批量 Pin CID 到 Aleph 网络\n        \n    - 支持 CID v0 (`Qm` 开头) 和 CID v1 (`bafy` 开头) 格式\n        \n    - 自动转换 CID v1 到 v0 格式\n        \n    - 批量删除文件（支持按 CID 或 item_hash）\n        \n    - 智能识别输入类型（CID / item_hash）\n        \n- **用户友好界面**\n    \n    - 简洁直观的图形界面\n        \n    - 实时操作日志显示\n        \n    - 支持剪贴板粘贴\n        \n    - 操作状态实时反馈\n        \n    - 支持多行批量输入\n        \n\n---\n\n## 2. 快速开始 🚀\n\n### 系统要求\n\n- Windows 10 / 11\n    \n- Python 3.8+（若从源码运行）\n    \n- IPFS Desktop 或 IPFS 守护进程（用于 CID 转换）\n    \n\n---\n\n### 安装步骤\n\n#### 方式一：直接使用打包版本（推荐）\n\n1. **下载最新版本**\n    \n    - 从 [Releases 页面](https://github.com/cenglin123/aleph-managerGUI/releases/latest) 下载最新的 `Aleph_ManagerGUI.zip`\n        \n    - 解压后即可使用。\n        \n2. **初始化 Aleph 环境**\n    \n    - 解压后的 `tools` 目录中包含 `aleph_py.exe`（Windows 版命令行客户端）\n        \n    - 程序首次运行时会提示初始化，引导创建默认账户，账户的密钥存储于程序路径 `.\\tools\\alpeh_py\\.aleph-im\\private-keys\\` \n        \n3. **启动程序**\n    \n    - 直接运行 `aleph_managerGUI.exe`\n        \n    - 或从命令行运行：\n        \n        ```powershell\n        .\\aleph_managerGUI.exe\n        ```\n        \n\n---\n\n#### 方式二：安装包安装\n\n（待开发）\n\n---\n\n### 可选：IPFS 支持\n\n- 下载并安装 [IPFS Desktop](https://docs.ipfs.tech/install/ipfs-desktop/)，或者 [IPFS 分享助手](https://github.com/cenglin123/IPFS-ShareAssistant)。\n    \n- 上述程序启动后会在后台运行 IPFS 节点\n    \n- Aleph 分享助手可自动检测并使用本地 IPFS 节点来转换 CID\n    \n\n---\n\n## 3. 使用指南 📖\n\n### 账户管理\n\n1. **创建账户**\n    \n    - 在“创建新账户”输入框中输入账户名\n        \n    - 点击【创建】按钮\n        \n    - 程序会生成私钥文件并配置为默认账户，账户密钥默认路径 `.\\tools\\alpeh_py\\.aleph-im\\private-keys\\` \n        \n2. **切换账户**\n    \n    - 从下拉列表中选择目标账户\n        \n    - 点击“切换账户”即可更新默认配置\n        \n3. **查看账户文件**\n    \n    - 点击“显示账户文件”查看当前账户的全部文件\n        \n    - 显示文件哈希、大小、类型、创建时间等信息\n        \n\n---\n\n### CID 操作\n\n1. **Pin 文件**\n    \n    - 在输入框中输入 CID（可多行输入）\n        \n    - 支持格式：\n        \n        - CID v0：`Qm...`\n            \n        - CID v1：`bafybei...`（如果输入 v0 格式，程序会自动转换）\n            \n    - 点击【PIN】按钮开始上传\n        \n2. **删除文件**\n    \n    - 输入要删除的 CID 或 item_hash\n        \n    - 点击【删除】\n        \n    - 若同一个 CID 对应多个文件，会弹出选择框\n        \n\n---\n\n### 快捷操作\n\n- **粘贴**：支持从剪贴板粘贴 CID\n    \n- **清空**：清空输入框\n    \n- **关于 IPFS ↗**：打开本地 IPFS 网关\n    \n\n---\n\n## 4. 文件结构 🔧\n\n```\naleph-managerGUI/\n├── aleph_managerGUI.exe          # 图形界面程序\n├── assets/                       # 资源文件\n│   ├── aleph_managerGUI.ico      # 程序图标\n└── tools/                        # 工具目录\n    └── aleph_py/                 # Aleph 命令行客户端目录\n        ├── aleph_py.exe          # Windows 版 Aleph 命令行客户端\n        └── .aleph-im/            # Aleph 主目录（自动生成）\n            └── private-keys/     # 私钥存储目录\n```\n\n---\n\n## 5. 故障排除 ⚙️\n\n1. **找不到 `aleph_py.exe`**\n    \n    - 确保 `tools/` 目录存在且包含 `aleph_py.exe`\n        \n    - 若缺失，可重新下载 Release 包或运行初始化脚本\n        \n2. **IPFS 未启动**\n    \n    - 确保 IPFS Desktop 正在运行\n        \n    - 或手动启动：\n        \n        ```bash\n        ipfs daemon\n        ```\n        \n3. **CID 转换失败**\n    \n    - 检查 CID 格式是否正确\n        \n    - 确认 IPFS 节点可访问\n        \n\n---\n\n## 6. 安全说明 🛡️\n\n- 私钥文件存放于程序目录下的 `.aleph-im/private-keys/`\n    \n- 请妥善备份私钥文件，**丢失将无法恢复账户访问权限**\n    \n- 不要与他人分享私钥内容\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"imgs/about_private-key.jpg\" alt=\"about_private-key\"\u003e\n\u003c/p\u003e\n\n---\n\n## 7. 更新日志 📝\n\n### v1.0.6（当前版本）\n\n- 移除 WSL 依赖，全面支持 Windows 原生运行\n    \n- 新增 `aleph_py.exe` 内置命令行客户端\n    \n- 优化私钥路径管理与编码兼容性\n    \n- 加快启动速度（使用 onedir 打包）\n    \n\n---\n## 贡献 🤝\n\n欢迎提交 Issue 和 Pull Request！\n\n## License 📄 \n\n本项目采用 [MIT License](LICENSE) 开源许可证。\n\n## 相关链接 🔗 \n\n- [防炸教程：如何安全分享资源？](https://github.com/cenglin123/SteganographierGUI/wiki/%E9%98%B2%E7%82%B8%E6%95%99%E7%A8%8B%EF%BC%9A%E5%A6%82%E4%BD%95%E5%AE%89%E5%85%A8%E5%88%86%E4%BA%AB%E8%B5%84%E6%BA%90%EF%BC%9F)\n- [Aleph.im 官网](https://aleph.im/)\n- [IPFS 官网](https://ipfs.io/)\n- [WSL 文档](https://docs.microsoft.com/windows/wsl/)\n\n## 作者 👨‍💻 \n\n**[层林尽染](https://github.com/cenglin123)**\n\n---\n\n\u003cp align=\"center\"\u003e\n  如果这个项目对您有帮助，请给个 ⭐️ Star！\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcenglin123%2Faleph-managergui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcenglin123%2Faleph-managergui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcenglin123%2Faleph-managergui/lists"}