功能介绍

TeleScopeX 提供了一系列强大的功能，帮助开发团队提升工作效率。

核心功能

🔐 自动登录研发云

这是 TeleScopeX 的核心功能，能够自动完成研发云平台的 npm 认证流程。

工作原理

1. 智能浏览器启动

   • 自动检测并连接现有的 Chrome 调试实例
   • 如果没有运行中的实例，自动启动新的 Chrome（远程调试模式）
   • 保持浏览器会话，实现持久登录

2. 凭证提取

   • 基于真实 DOM 结构的智能凭证提取
   • 精确定位用户名和 API Key 字段
   • 安全可靠，不存储敏感信息

3. 自动 npm 登录

   • 使用提取的凭证自动执行 npm login
   • 支持自定义 registry
   • 自动处理认证流程中的所有交互

使用场景

• ✅ 新项目初始化 - 快速完成 npm 认证设置
• ✅ token 过期 - 重新获取认证 token 无需手动操作
• ✅ 多项目切换 - 在不同项目间快速切换认证配置
• ✅ 团队协作 - 统一的认证流程，降低新成员上手难度

示例

# 进入项目目录
cd my-project

# 运行 TeleScopeX
telescopex

# 首次使用：在浏览器中登录研发云
# 后续使用：自动完成所有步骤

---

🧠 智能配置记忆

TeleScopeX 会自动学习和记住项目配置，让你的工作越来越轻松。

知识库系统

• 自动保存 - 成功的认证配置会被自动保存到 knowledge.json
• 项目识别 - 根据 registry URL 自动识别不同项目
• 快速匹配 - 后续运行时自动匹配已知项目配置
• 团队共享 - 可以将 knowledge.json 提交到 Git 供团队共享

知识库结构

{
  "projects": [
    {
      "name": "my-awesome-project",
      "registry": "https://npm.company.com/repository/npm-group/",
      "timestamp": "2025-12-01T10:30:00.000Z"
    }
  ]
}

优势

• 🎯 零配置 - 首次设置后无需任何配置
• ⚡ 极速执行 - 已知项目认证秒级完成
• 🔄 多项目管理 - 自动管理多个项目的独立配置
• 🤝 团队同步 - 通过 Git 共享知识库，团队成员即用即会

---

🌐 浏览器集成

TeleScopeX 深度集成 Chrome 浏览器，提供无缝的自动化体验。

特性

• 远程调试协议 - 使用 Chrome DevTools Protocol (CDP) 进行浏览器控制
• 会话保持 - 浏览器数据持久化，保持登录状态
• 智能连接 - 优先连接现有实例，避免重复启动
• 安全隔离 - 使用独立的用户数据目录

浏览器数据管理

telefe-cli/
└── .browser-data/  # Chrome 用户数据目录
    ├── Default/
    ├── Crash Reports/
    └── ...

注意

.browser-data/ 目录包含浏览器会话数据，建议添加到 .gitignore 中，不要提交到版本控制系统。

---

⚡ 全自动化流程

一次配置，永久自动化。

自动化步骤

graph TD
    A[启动 TeleScopeX] --> B{检查知识库}
    B -->|已知项目| C[自动连接浏览器]
    B -->|新项目| D[启动 Chrome]
    D --> E[等待用户登录]
    E --> F[提取凭证]
    C --> F
    F --> G[执行 npm login]
    G --> H[保存到知识库]
    H --> I[完成 ✅]

时间对比

操作	手动方式	TeleScopeX
首次认证	~2-3 分钟	~30-60 秒
后续认证	~2-3 分钟	~5-10 秒
切换项目	~2-3 分钟	~5-10 秒

---

🎨 精美的用户界面

终端也可以很美！

视觉特性

• Gemini 风格渐变 - 炫目的彩虹渐变 ASCII 艺术
• 动态加载动画 - 使用 ora 提供流畅的加载状态
• 交互式提示 - 基于 inquirer 的友好交互界面
• 彩色输出 - 使用 chalk 提供清晰的状态提示

界面示例

     ████████╗███████╗██╗     ███████╗███████╗ ██████╗ ██████╗ ███████╗██╗  ██╗
     ╚══██╔══╝██╔════╝██║     ██╔════╝██╔════╝██╔════╝██╔═══██╗██╔══██╗╚██╗██╔╝
        ██║   █████╗  ██║     █████╗  ███████╗██║     ██║   ██║██████╔╝ ╚███╔╝ 
        ██║   ██╔══╝  ██║     ██╔══╝  ╚════██║██║     ██║   ██║██╔═══╝  ██╔██╗ 
        ██║   ███████╗███████╗███████╗███████║╚██████╗╚██████╔╝██║     ██╔╝ ██╗
        ╚═╝   ╚══════╝╚══════╝╚══════╝╚══════╝ ╚═════╝ ╚═════╝ ╚═╝     ╚═╝  ╚═╝

✨ 正在查找项目配置...
✅ 找到 .npmrc 文件
🔍 检查知识库...
⚡ 自动完成 npm login！

---

即将推出的功能

📦 快速部署工具

一键部署到测试/生产环境：

• 支持多种部署目标（测试、预发、生产）
• 自动化构建和打包流程
• 部署前自动检查和验证
• 部署后健康检查

🔄 依赖更新助手

智能管理项目依赖：

• 自动检测过时的依赖
• 安全更新建议
• 一键批量更新
• 更新后自动测试

📝 代码模板生成

快速生成标准化代码：

• 多种代码模板（组件、服务、工具等）
• 自定义模板支持
• 符合团队规范
• 提高开发效率

🔍 日志查询工具

便捷的日志管理：

• 快速查询应用日志
• 日志过滤和搜索
• 实时日志监控
• 日志分析和统计

---

配置选项

环境变量

TeleScopeX 支持以下环境变量：

变量名	描述	默认值
TELESCOPEX_BROWSER_PATH	Chrome 浏览器路径	自动检测
TELESCOPEX_DEBUG_PORT	远程调试端口	9222
TELESCOPEX_TIMEOUT	操作超时时间（毫秒）	30000

使用示例

# 使用自定义 Chrome 路径
export TELESCOPEX_BROWSER_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
telescopex

# 使用自定义调试端口
export TELESCOPEX_DEBUG_PORT=9223
telescopex

---

性能优化

首次启动优化

• 并行化处理 - 浏览器启动和配置查找并行进行
• 智能缓存 - 缓存成功的配置，加快后续访问
• 按需加载 - 延迟加载非关键依赖

后续运行优化

• 配置复用 - 直接使用已保存的配置
• 浏览器复用 - 连接现有浏览器实例
• 快速匹配 - 优化的项目识别算法

---

安全性

数据安全

• ✅ 不存储密码 - 知识库中仅保存项目名和 registry
• ✅ 本地处理 - 所有凭证提取和处理都在本地完成
• ✅ 安全传输 - 使用 HTTPS 通信
• ✅ 会话隔离 - 独立的浏览器用户数据目录

最佳实践

• 🔒 不要将 .browser-data/ 提交到版本控制
• 🔒 定期清理浏览器会话数据
• 🔒 在共享设备上使用后清理凭证
• 🔒 使用强密码保护您的研发云账号

---

下一步

• 🔧 查看 API 参考 了解命令详情
• 📝 阅读 技术博客 了解设计思路
• 💬 提交反馈 帮助我们改进