# toolize

**Repository Path**: zgcai/toolize

## Basic Information

- **Project Name**: toolize
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Toolize

[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
[![Packages](https://img.shields.io/badge/packages-1%2C428-brightgreen)](https://github.com/bjzgcai/toolize)
[![English](https://img.shields.io/badge/lang-English-orange)](README.md)

让 AI Agent 适配并使用 1000+ 现有软件，无需改造，即刻可用。

## 总览

| 指标 | 数值 |
|------|------|
| 总包数 | **1,428** |
| 构建成功 | **1,223** |
| 成功率 | **85.6%** |

## 软件 Domain 分布

> 1428 个包由 AI agent 逐包阅读 README 后分类。

| Domain | 包数 | 占比 |
|--------|------|------|
| 🔧 软件开发 | **611** | 42.8% |
| 🖥️ 系统与运维 | **336** | 23.5% |
| 🌐 网络与通信 | **173** | 12.1% |
| 📝 办公与文档 | **89** | 6.2% |
| 🔐 安全与加密 | **83** | 5.8% |
| 🔬 科研与工程 | **76** | 5.3% |
| 🎬 多媒体音视频 | **25** | 1.8% |
| 🎨 图像与设计 | **17** | 1.2% |
| 📦 其他 | **18** | 1.3% |

## 各分类构建成功率

| 分类 | 包数 | 成功 | 成功率 |
|------|------|------|--------|
| python | 57 | 57 | **100%** |
| lang-eco | 24 | 24 | **100%** |
| web / cli-* | 8 | 8 | **100%** |
| remaining | 191 | 187 | **97.9%** |
| admin-net | 174 | 158 | **90.8%** |
| utils | 264 | 239 | **90.5%** |
| devel | 366 | 296 | **80.9%** |
| text-editors | 129 | 103 | **79.8%** |
| science-db | 179 | 143 | **79.9%** |
| javascript | 8 | 5 | 62% |
| cli-data | 3 | 2 | 67% |
| multimedia | 3 | 1 | 33% |

## Agent 如何适配软件

Agent 通过适配层接入现有软件，软件本身无需任何修改。

以 CLI 工具、解释语言库为例，常见工具类软件通过 Docker 容器适配，提供 JSON-RPC 2.0 over stdin/stdout 接口。

```bash
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | docker run --rm -i mass-toolize/<name>
```

作为扩展，GUI 应用或缺少友好 CLI 的软件同样得到适配，提供 JSON-RPC 2.0 over Unix Domain Socket 接口。

**已完成的典型案例：**

| 应用 | 说明 |
|------|------|
| **Google Earth Pro** | AI 操控 3D 地球：飞行导航、视角控制、截取任意位置卫星图 |
| **WPS** | AI 操控表格：填入数据、计算公式、设置样式，无需人工点击 |
| **Mosquitto** | 智能家居仪表盘实时监控温湿度、灯光，远程开关设备 |
| **GnuCash** | AI 自动建账、记账、查账、导出报表 |
| **Pidgin** | AI 操控聊天软件：发消息、改状态，界面即时联动 |
| **Inkscape** | AI 操控矢量绘图，实时画出彩色图形 |

## 快速开始

```bash
# 配置环境（首次，替换 TOOLIZE2026_* 占位符）
cp configure.env.example configure.env
vim configure.env
python3 configure.py

# 构建
CATEGORY=utils MAX_PACKAGES=9999 ./batch-smoke.sh
```

## 协议

JSON-RPC 2.0 over stdin/stdout。扩展部分使用 Unix Domain Socket。

基础镜像 `TOOLIZE2026_REGISTRY/uos:2501-deps`。

## 配置项

首次 clone 后运行 `python3 configure.py` 进行配置：

| 配置项 | 说明 |
|--------|------|
| `TOOLIZE2026_SUDO_PASSWORD` | sudo 密码 |
| `TOOLIZE2026_REGISTRY` | Docker registry 地址 |
| `TOOLIZE2026_INTERNAL_DOMAIN` | 内部域名 |
| `TOOLIZE2026_SMTP_SERVER` | SMTP 邮件服务器 |
| `TOOLIZE2026_PROXY_SERVER` | HTTP/HTTPS 代理 |
| `TOOLIZE2026_DEV_EMAIL_DOMAIN` | 开发者邮箱域名 |
| `TOOLIZE2026_HOME_DIR` | 用户家目录 |
| `TOOLIZE2026_WORKSPACE` | 项目工作区根目录 |