daodou-command 1.4.6 → 1.4.8

package/AI_QUICK_REFERENCE.md

@@ -1,202 +0,0 @@
-# AI智能体快速参考卡片
-
-> 为AI智能体提供项目快速理解和开发指导
-
-## 🎯 项目核心信息
-
-- **项目名称**: daodou-command (刀豆命令行工具)
-- **主命令**: `dao`
-- **当前版本**: 1.2.1
-- **主要功能**: 构建、多语言管理、自动更新
-
-## 📁 关键文件位置
-
-```
-bin/daodou.js                    # 主程序入口，命令注册
-lib/commands/                    # 命令实现目录
-├── build.js                    # 构建命令
-├── lang.js                     # 多语言命令  
-└── upgrade.js                  # 更新命令
-lib/utils/                      # 工具模块
-├── update-checker.js           # 后台更新检查
-├── git.js                      # Git操作
-└── ...                        # 其他工具
-```
-
-## ⚡ 快速添加新命令
-
-### 1. 在 `bin/daodou.js` 中注册
-```javascript
-program
-  .command('new-command')
-  .description('新命令描述')
-  .option('-o, --option <value>', '选项描述')
-  .action(async (options) => {
-    try {
-      const commandModule = require('../lib/commands/new-command');
-      await commandModule.execute(options);
-    } catch (error) {
-      console.error(chalk.red('执行失败:'), error.message);
-      process.exit(1);
-    }
-  });
-```
-
-### 2. 创建命令文件 `lib/commands/new-command.js`
-```javascript
-const chalk = require('chalk');
-const ora = require('ora');
-
-async function execute(options) {
-  const spinner = ora('执行中...').start();
-  try {
-    // 业务逻辑
-    spinner.succeed('执行成功');
-  } catch (error) {
-    spinner.fail('执行失败');
-    throw error;
-  }
-}
-
-module.exports = { execute };
-```
-
-## 🔧 常用工具模块
-
-### 更新检查器
-```javascript
-const updateChecker = require('../lib/utils/update-checker');
-updateChecker.startBackgroundCheck(); // 启动后台检查
-updateChecker.shouldRemindUpdate();   // 检查是否需要提醒
-```
-
-### Git工具
-```javascript
-const git = require('../lib/utils/git');
-const branch = await git.getCurrentBranch();
-const hasChanges = await git.hasUncommittedChanges();
-```
-
-## 📝 代码规范要点
-
-### 必须遵循
-- ✅ 使用 `async/await` 处理异步
-- ✅ 使用 `chalk` 进行彩色输出
-- ✅ 使用 `ora` 显示加载状态
-- ✅ 统一的错误处理模式
-- ✅ 详细的JSDoc注释
-
-### 避免的做法
-- ❌ 同步阻塞操作
-- ❌ 未处理的Promise
-- ❌ 硬编码的配置
-- ❌ 缺少错误处理
-
-## 🚨 错误处理模板
-
-```javascript
-async function execute(options) {
-  try {
-    // 参数验证
-    if (!options.param) {
-      throw new Error('缺少必需参数');
-    }
-    
-    // 业务逻辑
-    const result = await performAction(options);
-    console.log(chalk.green('成功:'), result);
-    
-  } catch (error) {
-    console.error(chalk.red('错误:'), error.message);
-    throw error; // 重新抛出供上层处理
-  }
-}
-```
-
-## ⚠️ 重要注意事项
-
-### 🚨 必须遵循的规则
-- **新命令自动获得更新检查功能** - 无需手动实现
-- **不要修改主程序中的更新检查逻辑**
-- **不要重复实现更新检查功能**
-- **避免在命令中直接调用 `process.exit()`**
-- **不要阻塞主事件循环**
-- **网络请求必须设置超时时间**
-
-### 🔄 命令执行流程
-```
-1. 启动后台更新检查（异步）
-2. 检查并显示更新提醒（如有新版本）
-3. 执行具体命令逻辑
-4. 返回执行结果
-```
-
-## 📋 命令开发检查清单
-
-- [ ] 在 `bin/daodou.js` 中注册命令
-- [ ] 创建 `lib/commands/命令名.js` 文件
-- [ ] 实现 `execute(options)` 函数
-- [ ] 添加参数验证
-- [ ] 添加错误处理
-- [ ] 使用彩色输出
-- [ ] 添加加载状态
-- [ ] 更新帮助信息
-- [ ] 更新 README.md
-- [ ] 更新 CHANGELOG.md
-- [ ] 确保不干扰更新检查机制
-- [ ] 设置网络请求超时
-- [ ] 处理文件操作权限错误
-
-## 🔄 发布流程
-
-1. 更新版本号: `npm version patch/minor/major`
-2. 更新 CHANGELOG.md
-3. 提交代码: `git commit -m "描述"`
-4. 发布: `npm publish`
-
-## 🚫 禁止事项
-
-### ❌ 绝对不要做
-- 修改 `bin/daodou.js` 中的更新检查逻辑
-- 重复实现更新检查功能
-- 直接调用 `process.exit()`
-- 阻塞主事件循环
-- 硬编码配置信息
-
-### ⚠️ 需要特别注意
-- 网络请求必须设置超时（5-10秒）
-- 文件操作要处理权限错误
-- 大量数据要分块处理
-- 避免内存泄漏
-- 验证所有用户输入
-
-## 💡 开发提示
-
-- 新命令会自动获得后台更新检查功能
-- 使用 `--help` 查看命令帮助
-- 错误信息要用户友好
-- 长时间操作要显示进度
-- 网络请求要设置超时
-
-## 🎨 输出样式
-
-```javascript
-// 成功信息
-console.log(chalk.green('✅ 操作成功'));
-
-// 错误信息  
-console.error(chalk.red('❌ 操作失败'));
-
-// 警告信息
-console.log(chalk.yellow('⚠️ 警告信息'));
-
-// 信息提示
-console.log(chalk.blue('ℹ️ 提示信息'));
-```
-
-## 🔍 调试技巧
-
-- 使用 `console.log` 输出调试信息
-- 检查 `~/.daodou-update-state.json` 更新状态
-- 使用 `node bin/daodou.js 命令名` 直接测试
-- 检查网络连接和npm registry状态

package/CHANGELOG.md

@@ -1,201 +0,0 @@
-# 更新日志
-
-所有重要的项目更改都将记录在此文件中。
-
-格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
-并且此项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
-
-
-## [1.4.6] - 2025-11-13
-
-### 修复
-- 修复版本更新提示逻辑，当前版本已是最新版本时不再显示更新提示
-- 优化 `getUpdateReminder()` 函数，添加当前版本与最新版本的实时比较
-
-## [1.4.5] - 2025-11-13
-
-### 修复
-- 修正 Node.js 版本要求为 `>=20.18.1`，与 cheerio 1.1.2 依赖要求保持一致
-- cheerio 是最严格的依赖，要求 Node >= 20.18.1
-
-## [1.4.4] - 2025-11-13
-
-### 修复
-- 修正 Node.js 版本要求为 `>=18.0.0`，与 Puppeteer 24.x 依赖要求保持一致
-- 解决安装时 Node 版本不匹配的报错问题
-
-## [1.4.3] - 2025-11-13
-
-### 修复
-- 修复语言代码映射问题，正确识别 `tw` 为繁体中文（台湾）
-- 明确 `zh` 语言代码映射为简体中文
-- 更新所有7个翻译引擎的语言代码映射规则：
-  - Microsoft Translator: `tw` -> `zh-Hant` (繁体中文)
-  - Google Translator: `tw` -> `zh-tw` (繁体中文)
-  - Baidu Translator: `tw` -> `cht` (繁体中文)
-  - Ali Translator: `tw` -> `zh` (中文)
-  - Youdao Translator: `tw` -> `zh-CHT` (繁体中文)
-  - DeepL Translator: `tw` -> `ZH` (中文)
-  - OpenAI Translator: `tw` -> `繁体中文`，`zh` -> `简体中文`
-
-## [1.4.2] - 2025-09-26
-
-### 修复
-- 清理代理功能相关代码，移除已废弃的代理统计信息输出
-
-## [1.4.1] - 2025-09-26
-
-### 修复
-- 移除翻译服务初始化时的冗余输出信息，提升用户体验
-
-## [1.4.0] - 2025-09-26
-
-### 新增
-- 实现7种翻译引擎：微软、Google、百度、阿里云、有道、DeepL、OpenAI
-- 支持多引擎配置和优先级调度
-- HTML文档翻译支持，保持标签结构完整
-- 智能引擎故障转移和重试机制
-- 灵活的API密钥配置管理
-
-### 更改
-- 重构翻译服务架构，支持多引擎调度
-- 优化配置文件结构，翻译引擎配置移至lang命令下
-- 简化配置结构，移除重复的priority字段，统一使用enginePriority
-- 自动生成配置时包含完整的翻译引擎配置
-- 提升翻译服务的稳定性和可靠性
-
-## [1.3.0] - 2025-09-16
-
-### 新增
-- 添加 `dao config` 全局配置管理命令
-  - `dao config init` - 初始化全局配置文件
-  - `dao config show` - 显示当前配置信息（全局+项目+合并后）
-  - `dao config edit` - 编辑配置文件（支持vim等编辑器）
-  - `dao config clear` - 清除配置文件
-  - `dao config` - 交互式配置向导
-- 优化配置结构，代理配置提升到全局配置
-  - `proxyListUrl` 和 `proxyTestUrl` 移至全局配置
-  - 项目配置默认不再生成代理相关配置
-  - 简化项目配置，减少重复配置项
-
-### 更改
-- 默认编辑器从nano改为vim，提升编辑体验
-- 配置管理更加智能和用户友好
-- 全局配置和项目配置层级更清晰
-
-### 技术改进
-- 增强配置管理功能
-- 改进用户交互体验
-- 优化配置文件结构
-
-## [1.2.3] - 2025-09-16
-
-### 修复
-- 更新CHANGELOG.md记录1.2.2版本的完整变更内容
-
-## [1.2.2] - 2025-09-16
-
-### 新增
-- 添加AI智能体开发规范文档
-  - 详细的命令开发指南 (COMMAND_DEVELOPMENT_GUIDE.md)
-  - AI快速参考卡片 (AI_QUICK_REFERENCE.md)
-  - 完整的代码规范和最佳实践
-  - 开发约束和禁止事项说明
-- 智能更新提醒功能
-  - 后台异步检查更新，不影响命令执行性能
-  - 自动提醒用户有新版本可用
-  - 支持重复提醒，确保用户不会错过更新
-
-### 技术改进
-- 优化后台更新检查为完全异步执行
-- 使用setImmediate和setTimeout确保不阻塞主程序
-- 改进错误处理和用户反馈机制
-- 清理测试文件，保持项目整洁
-
-### 文档完善
-- 为AI智能体提供详细的开发规范
-- 包含项目架构、代码规范、错误处理等完整指南
-- 提供快速参考和检查清单
-- 明确开发约束和注意事项
-
-## [1.2.0] - 2025-09-16
-
-### 新增
-- 添加 `dao upgrade` 命令用于检查和更新工具版本
-  - 支持 `--check` 选项仅检查版本不更新
-  - 支持 `--force` 选项强制更新
-  - 自动从npm获取最新版本信息
-  - 智能版本比较和更新提示
-- 主程序自动读取package.json中的版本号，无需手动维护
-
-### 更改
-- 将update命令重命名为upgrade，更符合CLI工具命名习惯
-- 优化版本管理流程，减少手动维护工作
-
-### 技术改进
-- 改进错误处理和用户反馈
-- 添加彩色输出和加载动画
-- 增强网络超时和错误恢复机制
-
-## [1.1.2] - 2025-09-16
-
-### 修复
-- 修复主程序版本号显示问题
-- 主程序现在自动读取package.json中的版本号，无需手动维护
-
-## [1.1.1] - 2025-09-16
-
-### 修复
-- 修复主程序版本号显示问题
-- 主程序现在自动读取package.json中的版本号，无需手动维护
-
-## [1.1.0] - 2025-09-16
-
-### 新增
-- 在package.json中添加git仓库信息
-  - 添加repository字段，指向GitHub仓库
-  - 添加bugs字段，指向GitHub issues页面
-  - 添加homepage字段，指向项目主页
-
-### 更改
-- 版本号从1.0.0升级到1.1.0
-- 更新了npm包信息，现在包含完整的仓库链接
-
-## [1.0.0] - 2025-09-16
-
-### 新增
-- 初始版本发布
-- 支持自动化构建功能
-  - 自动检测Git分支
-  - 一键触发Jenkins构建
-  - 实时监听构建进度
-- 支持多语言管理功能
-  - 多语言文件管理
-  - 自动翻译功能（Google Translate API）
-  - 多代理轮换绕过API限制
-- 命令行工具基础功能
-  - 使用commander.js构建CLI
-  - 支持help和version命令
-  - 配置文件自动生成和管理
-
-### 技术特性
-- 基于Node.js开发
-- 使用simple-git进行Git操作
-- 集成Google Translate API
-- 支持代理轮换
-- 使用Puppeteer进行浏览器自动化
-- 支持JSON5配置文件格式
-
----
-
-## 版本说明
-
-- **主版本号（MAJOR）**: 当你做了不兼容的API修改
-- **次版本号（MINOR）**: 当你做了向下兼容的功能性新增
-- **修订号（PATCH）**: 当你做了向下兼容的问题修正
-
-## 链接
-
-- [GitHub仓库](https://github.com/h025/daodou-command)
-- [npm包页面](https://www.npmjs.com/package/daodou-command)
-- [问题反馈](https://github.com/h025/daodou-command/issues)