pypto-tools 收集面向 Linux 服务器、共享计算环境和工程运维的小型实用工具。
我们希望每个工具都易于安装、容易审查，并能在多台服务器上使用一致的方式部署。
新工具默认遵循以下约定，现有项目可逐步迁移：
- 公开命令使用
pto-<name>格式，例如pto-path。 - 正式文件统一放在
/home/pypto-tools/<tool-name>/。 - 工具目录按
app/、config/、state/、logs/、tmp/划分职责。 /usr/local/bin/pto-<name>只作为公开命令入口，实际程序位于工具的app/目录。- 源码与部署副本分离；升级只更新
app/，不覆盖配置或删除运行状态。 - 默认不依赖
/data；大体积数据可通过配置或软链接显式迁移。 - 仓库不提交密码、令牌、私钥、会话数据和未授权的第三方文件。
- 安装、配置和真正生效应明确分离；有副作用的操作必须显式执行。
- 每个仓库必须保留一份仓库级 AI Skill，默认位于
skills/<repo-name>/SKILL.md。 - Skill 必须说明只读检查、配置变更和有副作用操作的边界，不得引导 AI 输出或提交凭据。
- 项目还应包含简明 README 和可重复执行的自动测试。
pto-path：按目标管理 direct、UniVPN、网关和 SSH 跳板访问路径。pto-simpler-perf-tracker：追踪 Simpler PR 级 Ascend NPU 性能变化。pto-system-doctor：诊断共享 Linux 服务器的网络和磁盘健康状态。npu-taskqueue：面向共享 Ascend NPU 服务器的轻量任务队列。ci-panel：管理 GitHub Actions self-hosted runner 的 Web 面板。pto-toolbox：自包含单文件 shell 小工具集合，收纳小到不值得单独开仓的工具。
每个项目的具体安装、权限和安全边界，以各仓库 README 为准。