段件库 (Duanjian):段言（Duan）的官方段件包管理器和注册表。
段件库 (Duanjian)
段言（Duan）的官方段件包管理器和注册表。
快速开始
# 安装段件 duanpkg install 网络请求 # 搜索段件 duanpkg search 数据库 # 按命名空间过滤 duanpkg search 工具 --namespace community # 按分类过滤 duanpkg list --category dev # 更新段件库索引 duanpkg update # 升级所有已安装段件 duanpkg upgrade # 列出已安装段件 duanpkg list # 查看段件详情 duanpkg info JSON工具集 # 卸载段件 duanpkg uninstall 网络请求 # 查看注册表统计 duanpkg registry stats # 发布段件 duanpkg publish段件列表
标准库 (std)
| 段件名 | 分类 | 版本 | 描述 |
|---|---|---|---|
| 标准数学扩展 | math | 1.0.0 | 扩展数学函数库：矩阵运算、复数、统计函数 |
| 网络请求 | net | 1.0.0 | HTTP 客户端库：GET/POST 请求、JSON 解析 |
| 命令行工具 | cli | 1.0.0 | CLI 开发工具：参数解析、进度条、颜色输出 |
| 测试框架 | dev | 1.0.0 | 单元测试框架：断言、测试套件、覆盖率 |
| 数据库 | data | 1.0.0 | 数据库操作库：SQL 查询、连接池、ORM |
| 模板引擎 | data | 1.0.0 | 文本模板引擎：变量替换、循环、条件渲染 |
| 日志 | dev | 1.0.0 | 日志记录库：分级日志、文件输出、格式化 |
| 配置管理 | dev | 1.0.0 | 配置文件管理：TOML/JSON/YAML 读写 |
| 加密 | data | 1.0.0 | 加密工具库：哈希、对称加密、Base64 |
| 图像处理 | media | 1.0.0 | 图像处理库：缩放、裁剪、滤镜 |
社区贡献 (community)
| 段件名 | 分类 | 版本 | 描述 |
|---|---|---|---|
| JSON工具集 | data | 1.0.0 | JSON解析、序列化、验证、转换全套工具 |
| 字符串工具集 | dev | 1.0.0 | 字符串处理、验证、转换、正则匹配等实用工具 |
| 文件工具集 | dev | 1.0.0 | 文件操作、路径处理、目录遍历、文件查找等实用工具 |
| 数学工具集 | math | 1.0.0 | 数学计算、统计分析、随机数、线性代数等工具 |
| 时间日期工具集 | dev | 1.0.0 | 日期时间处理、格式化、时区转换、时间段计算等工具 |
测试 (test)
| 段件名 | 分类 | 版本 | 描述 |
|---|---|---|---|
| duanpkgtest | test | 1.0.0 | 段件包测试工具 — 用于验证 duanpkg 命令 |
架构设计
分块存储注册表
为支持大规模包管理，注册表采用分块存储架构：
registry/ ├── index.json # 主索引（包名 -> 分类文件映射） └── categories/ ├── math.json # 数学计算分类 ├── net.json # 网络通信分类 ├── cli.json # 命令行工具分类 ├── dev.json # 开发工具分类 ├── data.json # 数据处理分类 ├── media.json # 媒体处理分类 └── test.json # 测试分类设计优势：
- 📦可扩展：每个分类独立文件，支持数千个包
- 🔍快速检索：主索引仅存元数据，搜索定位后再加载详情
- 🔄增量更新：ETag 机制，仅同步变化的分类文件
- 🏷️命名空间：std/community/test 三级隔离，避免命名冲突
- 📊分类组织：7大分类，按功能维度组织包
命名空间
- std：段言官方标准库，由核心团队维护
- community：社区用户贡献的段件
- test：测试用段件
发布你的段件
创建段件项目
duan init --template lib配置 package.toml
[package] name = "我的段件" version = "1.0.0" description = "描述你的段件" author = "你的名字" namespace = "community" category = "dev" mirrors = [ "https://gitcode.com/你的用户名/仓库名.git", "https://github.com/你的用户名/仓库名.git" ] keywords = ["标签1", "标签2"] dependencies = []推送代码到 Git 仓库
git push生成段件库条目
duanpkg publish提交 PR
- Fork 本仓库：AtomGit - 全球开发者的开源社区,开源代码托管平台
- 在对应分类文件（如
registry/categories/dev.json）中添加你的段件信息 - 更新
registry/index.json的索引和统计数据 - 提交 PR
安装包管理器
pip install duanpkg或者直接运行：
python duanpkg.py install 网络请求特性
- ✅分块存储：分类级别的注册表，支持大规模扩展
- ✅命名空间：std/community/test 三级隔离
- ✅自动测速：从 GitCode/GitHub/Gitee 多镜像中自动选择最快的
- ✅ZIP 下载：无需安装 Git，直接下载 ZIP 包
- ✅缓存机制：避免重复下载，提升安装速度
- ✅索引更新：ETag 增量更新，减少网络传输
- ✅一键升级：升级所有已安装的段件
- ✅依赖解析：自动安装依赖包
- ✅本地开发：packages/ 目录下的包自动识别为本地段件
目录结构
duanpkg/ ├── registry/ # 段件注册表（分块存储） │ ├── index.json # 主索引 │ └── categories/ # 分类注册表 │ ├── math.json │ ├── net.json │ ├── cli.json │ ├── dev.json │ ├── data.json │ ├── media.json │ └── test.json ├── duanpkg.py # CLI 入口 ├── duanpkg/ │ └── installer.py # 安装器核心 ├── packages/ # 已安装段件目录（本地开发模式） ├── test_workflow.py # 工作流测试脚本 └── README.md