npm package: @ssshuai/telescopex
Description: 🚀 TeleScopeX - Intelligent CLI automation toolkit for development teams
Author: Telefe Team
Latest version: 1.2.4

# 🚀 TeleScopeX

[![npm version](https://badge.fury.io/js/telescopex.svg)](https://badge.fury.io/js/telescopex)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js Version](https://img.shields.io/node/v/telescopex.svg)](https://nodejs.org)

**TeleScopeX** - 为开发团队打造的智能 CLI 自动化工具套件，提升开发效率，简化日常操作。

## ✨ 产品定位

TeleScopeX 是专为 **Telefe 组织**打造的综合效率工具集，旨在简化日常开发流程中的重复性操作，让开发者专注于核心业务。

## 📦 安装

### 全局安装（推荐）

```bash
npm install -g telescopex
```

安装完成后，您可以使用以下命令：

```bash
telescopex  # 完整命令
tsx         # 简短命令
```

### 本地开发

```bash
git clone https://github.com/JefferyMunoz/teleScopeX.git
cd teleScopeX
npm install
node index.js
```

## 🎯 功能模块

### ✅ 已实现功能

#### 🔐 自动登录研发云
- **智能凭证提取** - 自动从浏览器中提取用户账号和 API Key
- **一键 npm 认证** - 无需手动输入，自动完成 npm login
- **项目配置记忆** - 记住成功的项目配置，后续运行无需重复操作
- **跨项目支持** - 自动管理多个不同的项目配置

#### 🛡️ 安全助手
- **智能表单分析** - 自动分析在线表单结构
- **数据提取** - 智能提取关键数据
- **批量填充** - 支持单人或批量填充表单
- **智能匹配** - 使用标准化算法精确匹配内容
- **📸 自动截图** - 完成后自动保存结果截图，方便分享

### 🚧 规划中功能
- 📦 **快速部署工具** - 一键部署到测试/生产环境
- 🔄 **依赖更新助手** - 智能检测和更新项目依赖
- 📝 **代码模板生成** - 快速生成标准化代码模板
- 🔍 **日志查询工具** - 快速查询和分析应用日志
- ...更多功能持续开发中

## 🚀 快速开始

### 自动登录研发云

```bash
telescopex
```

**首次使用流程：**
1. CLI 自动启动 Chrome（远程调试模式）
2. 在 Chrome 中登录到研发云
3. CLI 自动提取凭证并完成 npm login
4. 配置自动保存，后续运行无需重复

**后续使用：**
- 一键运行，自动识别已知项目
- 自动完成所有认证步骤
- 越用越快！

### 安全助手

```bash
telescopex
# 选择 "🛡️ 安全助手"
```

**使用流程：**
1. 输入表单 URL
2. 选择模式（单人/批量）
3. 输入用户名（批量用逗号分隔）
4. 等待自动完成
5. 人工检查后手动提交

**环境准备（首次使用）：**
```bash
# 安装 Python 依赖
npm run setup-python

# 或手动安装
cd auto-exam
pip3 install -r requirements.txt
playwright install chromium
```

详细使用说明请查看 [`auto-exam/README.md`](auto-exam/README.md)

## 🎨 特色

- **🌈 炫酷界面** - Gemini 风格的渐变 ASCII 艺术
- **🧠 智能学习** - 自动记住项目配置，使用越多越智能
- **🌐 浏览器集成** - 连接现有 Chrome，使用你的登录状态
- **🔐 精确提取** - 基于真实 DOM 结构的智能凭证提取
- **⚡ 一键完成** - 全自动化流程，无需手动干预
- **📝 多功能集成** - 集成多个实用工具，一个 CLI 搞定所有

## 📁 项目结构

```
telescopex/
├── index.js              # 主程序
├── auto-exam/            # 安全助手模块
│   ├── auto_exam.py      # 主脚本
│   ├── wrapper.js        # Node.js wrapper
│   ├── requirements.txt  # Python 依赖
│   └── README.md         # 详细使用说明
├── knowledge.json        # 知识库（自动生成）
├── .browser-data/        # 浏览器数据（持久登录）
├── package.json
├── LICENSE
└── README.md
```

## 🤝 团队协作

### 共享知识库

将 `knowledge.json` 提交到 Git，团队成员可以共享项目配置：

```bash
git add knowledge.json
git commit -m "Update project configurations"
git push
```

### 注意事项

- `.browser-data/` 目录包含浏览器数据，不要提交到 Git
- `knowledge.json` 中只包含项目名和 registry，不包含密码

## 📝 配置说明

CLI 会自动查找项目中的 `.npmrc` 文件：
- 当前目录
- `apps/dtconnector/.npmrc`
- 其他子目录

找到后自动提取 registry URL 并开始认证流程。

## 💡 使用示例

```bash
# 全局安装
npm install -g telescopex

# 在您的项目目录中运行
cd your-project
telescopex

# 使用简短命令
tsx

# 安装 Python 依赖（首次使用安全助手前）
npm run setup-python
```

## 🛠 系统要求

- Node.js >= 14.0.0
- Chrome 浏览器（用于自动化认证）
- Python 3.8+（仅安全助手功能需要）
- pip3 和 playwright（仅安全助手功能需要）

## 🛠 开发计划

TeleScopeX 将持续迭代，未来会加入更多提升团队效率的功能模块。

敬请期待！

## 📄 许可证

[MIT](LICENSE)

## 🔗 链接

- [GitHub 仓库](https://github.com/JefferyMunoz/teleScopeX)
- [问题反馈](https://github.com/JefferyMunoz/teleScopeX/issues)
- [npm 包页面](https://www.npmjs.com/package/telescopex)

---

**Made with ❤️ for Telefe Team**