ai_sys_tools —— 核心实用工具库

445 个真实可用的 Python 工具（按 26 个功能分类模块组织），每个工具均为可导入 / 可 CLI 调用的函数，并携带符合 rag_system/docs/格式规范.md 五段模板的工具注册元数据（name / description 含 功能关键词/别名锚点/示例查询/标识 / parameters / examples）——元数据可直接喂给工具注册表（register_any([...])）。

• 包名（PyPI）：ai-sys-tools ｜ 导入名：ai_sys_tools ｜ 版本：1.0.0
• 命令行：ai-sys-tools

安装

pip install ai-sys-tools
# 需要 GPU 显存缓存释放工具（调用 torch.cuda.empty_cache）时：
pip install "ai-sys-tools[gpu]"

本机开发态（仓库内）直接 python main.py … 亦可，src 为模块根。

快速开始

ai-sys-tools list                       # 模块与工具数
ai-sys-tools search 缩略图               # 检索工具
ai-sys-tools registry --out registry.json   # 导出注册表 JSON
ai-sys-tools meta file_read_text        # 查看某工具五段元数据
ai-sys-tools run text_util.txt_b64_encode --kv text=hello
ai-sys-tools check                      # 全库唯一性 + 元数据合规检查

from ai_sys_tools import file_tools, text_util, img_proc, http_req, sys_ctl
print(file_tools.file_read_text("D:/data/a.txt", encoding="utf-8"))

Python 导入使用

from ai_sys_tools import overlay_ctl, file_tools, process_ctl
r = overlay_ctl.ovl_shield_show(opacity=0.85, text="勿动", duration_seconds=3, wait=True)
r = overlay_ctl.ovl_shield_show(lock_input=True, text="锁定10秒", duration_seconds=10, wait=True)
r = file_tools.file_read_text("D:/data/a.txt", encoding="utf-8")
r = process_ctl.proc_list()
# 全部函数返回结构化 dict {ok:…}；失败带中文 reason，不抛异常

工具注册（接入 rag 工具注册表）

from ai_sys_tools._infra import load_src_modules, all_tools
load_src_modules()          # 逐个 import 触发 @tool 注册
metas = all_tools()         # 445 条五段元数据
# ag.register_any(metas, enforce_spec=True, dedup=False)

总览表

合计：26 个分类模块，445 个工具。

约定

• 环境：Python ≥ 3.10（主力开发/测试 3.12）；依赖：curl_cffi（全部下载/请求）、Pillow（图片/截图）、psutil（进程/内存/磁盘）；torch 可选（仅 gpu_cleanup_torch_cache 用，缺失时返回 err）。
• 平台：绝大多数工具面向 Windows（ctypes / winreg / netsh / PowerShell）；file_tools、text_util、crypto_util、archive_util、web_parse、net_util、time_ntp 等为纯标准库实现，跨平台可用。
• 每个函数返回结构化 dict：成功 {"ok": true, ...}；失败/环境不允许 {"ok": false, "reason": "中文原因"}（不抛异常）。
• 破坏性/治理类函数一律 dry_run=True / confirm=False / apply=False 默认；系统电源类需显式 confirm 才执行。
• 模块文件只含 docstring/import/函数/模块尾 CLI；无类；工具名按分类前缀（file_/img_/vid_/web_/http_/shot_/aud_/wnd_/proc_/mem_/disk_/cpu_/gpu_/ntp_/sys_/net_/txt_/crypt_/arc_/ovl_/bt_/lan_/spd_/exe_/fw_/op_）保证全库唯一。

源码仓库内的构建产物

• registry/tool_registry.json：全量工具注册元数据（python -X utf8 build_registry.py 重新生成）。
• main.py：仓库内聚合入口（list / search / registry / meta / run / check）。
• src/_infra.py：基础设施（ok/err、@tool 注册、五段描述组装、CLI 支撑）。

发布

python -m build                       # 产出 dist/ai-sys-tools-1.0.0.{tar.gz,whl}
python -m twine upload dist/*         # 凭据取自 ~/.pypirc（token）