needware-cli 1.5.15 → 1.5.17

package/examples/tool-usage-example.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# Agent Tools 使用示例
+
+# 确保设置了 API Key
+if [ -z "$ANTHROPIC_API_KEY" ]; then
+  echo "请先设置 ANTHROPIC_API_KEY 环境变量"
+  echo "export ANTHROPIC_API_KEY=your_api_key_here"
+  exit 1
+fi
+
+echo "==================================="
+echo "Agent Tools 使用示例"
+echo "==================================="
+echo ""
+
+# 示例 1: 使用 supabase-enable 工具
+echo "示例 1: 启用 Supabase 集成"
+echo "-----------------------------------"
+needware-cli agent "启用 Supabase 数据库，项目 ID 是 demo-project-123"
+echo ""
+
+# 示例 2: 使用 example-tool 工具
+echo "示例 2: 使用示例工具转换文本"
+echo "-----------------------------------"
+needware-cli agent "用 example-tool 把 'Hello World' 转换为大写"
+echo ""
+
+# 示例 3: 更详细的 Supabase 配置
+echo "示例 3: 配置完整的 Supabase 信息"
+echo "-----------------------------------"
+needware-cli agent "配置 Supabase，项目 ID: abc123, URL: https://abc123.supabase.co, 并自动生成配置文件"
+echo ""
+
+# 示例 4: 在工作目录中使用工具
+echo "示例 4: 在指定工作目录中使用工具"
+echo "-----------------------------------"
+needware-cli agent "启用 Supabase 集成，项目 ID 是 my-app-456" --working-dir ./
+echo ""
+
+echo "==================================="
+echo "示例运行完成！"
+echo "==================================="
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "needware-cli",
-  "version": "1.5.15",
+  "version": "1.5.17",
   "description": "一个功能强大的 Node.js 命令行工具",
   "type": "module",
   "main": "dist/index.js",
@@ -36,7 +36,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.1.19",
+    "@anthropic-ai/claude-agent-sdk": "^0.1.76",
     "axios": "^1.6.0",
     "chalk": "^4.1.2",
     "commander": "^11.1.0",

package/CHANGELOG_DB_CONFIG.md

@@ -1,142 +0,0 @@
-# 数据库配置功能更新日志
-
-## [1.5.2] - 2025-11-17
-
-### 新增功能 ✨
-
-#### 数据库配置通过命令行传入
-
-- **功能描述**: Agent 命令现在支持通过 `--db-config` 参数以 JSON 格式传入数据库配置，不再需要在代码中硬编码
-- **使用场景**: 适用于需要连接 Supabase 等数据库的 AI 助手任务
-- **参数格式**: `--db-config <json>`
-
-### 主要改动
-
-#### 1. 命令行接口 (CLI)
-
-**文件**: `src/core/cli.ts`
-- 新增 `--db-config` 选项到 agent 命令
-- 支持接收 JSON 格式的数据库配置字符串
-
-#### 2. Agent 命令处理
-
-**文件**: `src/commands/agent.ts`
-- 新增 `parseDbConfig()` 方法：解析和验证数据库配置
-- 更新 `runInteractiveAgent()` 方法：使用传入的数据库配置
-- 更新 `runAgent()` 方法：使用传入的数据库配置
-- 更新帮助信息：添加 `--db-config` 选项说明和使用示例
-
-#### 3. 文档和示例
-
-**新增文件**:
-- `docs/DATABASE_CONFIG.md` - 完整的数据库配置指南
-- `examples/db-config-example.json` - 配置文件示例
-- `examples/test-db-config.sh` - 测试脚本示例
-
-**更新文件**:
-- `README.md` - 添加数据库配置功能说明和文档链接
-
-### 使用方法
-
-#### 方法 1: 命令行直接传入
-
-```bash
-needware-cli agent "创建待办事项" \
-  --db-config '{"hasSelectedProject":true,"projectId":"your-id","publishableKey":"your-key","url":"https://your-project.supabase.co"}'
-```
-
-#### 方法 2: 从文件读取
-
-```bash
-# 创建配置文件 db-config.json
-{
-  "hasSelectedProject": true,
-  "projectId": "your-project-id",
-  "publishableKey": "your-publishable-key",
-  "url": "https://your-project.supabase.co"
-}
-
-# 使用配置文件
-needware-cli agent "创建待办事项" --db-config "$(cat db-config.json)"
-```
-
-### 配置字段说明
-
-| 字段 | 类型 | 必需 | 说明 |
-|------|------|------|------|
-| `hasSelectedProject` | boolean | 否 | 是否选择了项目 |
-| `projectId` | string | 是 | 项目 ID |
-| `publishableKey` | string | 是 | 可发布密钥 |
-| `url` | string | 是 | 项目 URL |
-
-### 向后兼容性
-
-- ✅ 完全向后兼容
-- ✅ `--db-config` 参数为可选
-- ✅ 不提供配置时，系统将不传递数据库配置（适用于不需要数据库访问的场景）
-
-### 安全建议
-
-⚠️ **重要**: 
-- 不要将包含真实密钥的配置文件提交到版本控制
-- 建议将 `db-config.json` 添加到 `.gitignore`
-- 创建示例配置文件（如 `db-config.example.json`）供团队参考
-
-### 相关文档
-
-- [数据库配置完整指南](docs/DATABASE_CONFIG.md)
-- [Agent 命令文档](docs/AGENT_COMMAND.md)
-- [README - 数据库配置部分](README.md#使用数据库配置)
-
-### 技术细节
-
-#### 错误处理
-
-系统会验证 JSON 格式和必需字段，提供友好的错误提示：
-- `Invalid JSON format for database configuration` - JSON 格式错误
-- `Invalid database configuration format` - 缺少必需字段
-
-#### 示例配置文件
-
-```json
-{
-  "hasSelectedProject": true,
-  "projectId": "sniiobwuoecgypjxpymx",
-  "publishableKey": "eyJhbGc...",
-  "url": "https://sniiobwuoecgypjxpymx.supabase.co"
-}
-```
-
-### 测试
-
-运行测试脚本：
-
-```bash
-bash examples/test-db-config.sh
-```
-
-查看帮助信息：
-
-```bash
-needware-cli agent --help
-```
-
-### 贡献者
-
-- 实现: 根据用户需求完成
-- 测试: 已通过编译和基本功能测试
-- 文档: 完整的使用指南和示例
-
-### 下一步
-
-建议的改进方向：
-1. 支持从环境变量读取数据库配置
-2. 支持多个数据库配置文件的切换
-3. 集成更多数据库类型（PostgreSQL, MySQL, MongoDB 等）
-4. 提供配置加密功能
-
----
-
-**注**: 此功能从版本 1.5.2 开始可用
-
-

package/IMPLEMENTATION_SUMMARY.md

@@ -1,303 +0,0 @@
-# 数据库配置功能实现总结
-
-## 📋 概述
-
-成功实现了数据库配置通过命令行以 JSON 格式传入的功能，不再需要在代码中硬编码数据库配置信息。
-
-## ✅ 完成的工作
-
-### 1. 核心功能实现
-
-#### 修改的文件
-
-| 文件 | 更改内容 |
-|------|---------|
-| `src/core/cli.ts` | 添加 `--db-config <json>` 选项到 agent 命令 |
-| `src/commands/agent.ts` | 实现配置解析、验证和使用逻辑 |
-
-#### 功能特性
-
-- ✅ 支持命令行直接传入 JSON 配置
-- ✅ 支持从文件读取配置
-- ✅ JSON 格式验证和错误提示
-- ✅ 必需字段验证
-- ✅ 向后兼容（可选参数）
-- ✅ 同时支持交互式和非交互式模式
-
-### 2. 文档和示例
-
-#### 新增文件
-
-```
-docs/
-  └── DATABASE_CONFIG.md          # 完整的使用指南（包含安全建议）
-
-examples/
-  ├── db-config-example.json      # 配置文件示例
-  └── test-db-config.sh           # 测试脚本
-
-根目录/
-  ├── CHANGELOG_DB_CONFIG.md      # 详细的更新日志
-  └── IMPLEMENTATION_SUMMARY.md   # 实现总结（本文件）
-```
-
-#### 更新文件
-
-- `README.md` - 添加数据库配置功能说明和使用示例
-
-### 3. 代码质量
-
-- ✅ TypeScript 编译通过
-- ✅ 无 Linter 错误
-- ✅ 完整的错误处理
-- ✅ 友好的错误提示信息
-
-## 🚀 使用示例
-
-### 基本用法
-
-```bash
-# 直接传入配置
-needware-cli agent "创建待办事项" \
-  --db-config '{"hasSelectedProject":true,"projectId":"abc123","publishableKey":"key123","url":"https://abc123.supabase.co"}'
-
-# 从文件读取
-needware-cli agent "创建待办事项" \
-  --db-config "$(cat db-config.json)"
-```
-
-### 配置文件格式
-
-```json
-{
-  "hasSelectedProject": true,
-  "projectId": "your-project-id",
-  "publishableKey": "your-publishable-key",
-  "url": "https://your-project.supabase.co"
-}
-```
-
-### 查看帮助
-
-```bash
-needware-cli agent --help
-```
-
-输出包含新选项：
-```
---db-config <json>         Database configuration in JSON format (e.g.,
-                           Supabase config)
-```
-
-## 🔧 技术实现细节
-
-### 1. 配置解析方法
-
-```typescript
-private parseDbConfig(dbConfigStr?: string): any {
-  if (!dbConfigStr) {
-    return undefined;
-  }
-
-  try {
-    const config = JSON.parse(dbConfigStr);
-    
-    // 验证必需字段
-    if (config.hasSelectedProject !== undefined || 
-        config.projectId || 
-        config.publishableKey || 
-        config.url) {
-      return config;
-    }
-    
-    throw new Error('Invalid database configuration format...');
-  } catch (error) {
-    if (error instanceof SyntaxError) {
-      throw new Error(`Invalid JSON format for database configuration: ${error.message}`);
-    }
-    throw error;
-  }
-}
-```
-
-### 2. 使用方式
-
-```typescript
-// 解析数据库配置
-const dbConfig = this.parseDbConfig(options.dbConfig);
-
-// 传递给 system prompt
-const agentQuery = query({
-  prompt: parsedPrompt.prompt,
-  options: {
-    systemPrompt: getSystemPrompt(resolvedWorkingDir, dbConfig),
-    // ... 其他选项
-  },
-});
-```
-
-### 3. 命令行选项注册
-
-```typescript
-if (command.name === 'agent') {
-  commandInstance
-    // ... 其他选项
-    .option('--db-config <json>', 'Database configuration in JSON format (e.g., Supabase config)');
-}
-```
-
-## 📚 相关文档
-
-### 用户文档
-- [数据库配置指南](docs/DATABASE_CONFIG.md) - 完整使用说明
-- [README](README.md) - 快速开始和示例
-
-### 开发文档
-- [CHANGELOG](CHANGELOG_DB_CONFIG.md) - 详细更新日志
-- [示例脚本](examples/test-db-config.sh) - 测试和演示
-
-## 🔒 安全建议
-
-1. **不要提交真实密钥**
-   ```bash
-   echo "db-config.json" >> .gitignore
-   ```
-
-2. **使用示例配置**
-   ```bash
-   cp db-config.json db-config.example.json
-   # 编辑示例文件，替换为占位符
-   ```
-
-3. **环境变量（可选）**
-   ```bash
-   export DB_CONFIG=$(cat db-config.json)
-   needware-cli agent "任务" --db-config "$DB_CONFIG"
-   ```
-
-## ✨ 功能亮点
-
-### 1. 灵活性
-- 支持多种输入方式（命令行、文件）
-- 可选参数，不强制使用
-
-### 2. 易用性
-- 自动 JSON 解析和验证
-- 友好的错误提示
-- 详细的文档和示例
-
-### 3. 安全性
-- 不在代码中硬编码敏感信息
-- 支持独立配置文件
-- 提供安全最佳实践指南
-
-### 4. 向后兼容
-- 不影响现有功能
-- 可选参数设计
-- 平滑升级路径
-
-## 🧪 测试验证
-
-### 编译测试
-```bash
-npm run build
-# ✅ 编译成功，无错误
-```
-
-### Linter 检查
-```bash
-npm run lint
-# ✅ 无 linter 错误
-```
-
-### 功能测试
-```bash
-# 1. 查看帮助
-needware-cli agent --help
-# ✅ 显示 --db-config 选项
-
-# 2. 运行测试脚本
-bash examples/test-db-config.sh
-# ✅ 测试脚本正常执行
-```
-
-## 📝 使用场景
-
-### 场景 1: 开发环境
-```bash
-needware-cli agent "创建用户表" \
-  --db-config "$(cat ./config/dev-db.json)"
-```
-
-### 场景 2: 生产环境
-```bash
-needware-cli agent "查询数据" \
-  --db-config "$(cat ./config/prod-db.json)"
-```
-
-### 场景 3: 团队协作
-```bash
-# 团队成员复制示例配置
-cp db-config.example.json db-config.json
-
-# 填写自己的配置
-vim db-config.json
-
-# 使用
-needware-cli agent "开发任务" --db-config "$(cat db-config.json)"
-```
-
-### 场景 4: 无数据库访问
-```bash
-# 不需要数据库时，省略 --db-config
-needware-cli agent "创建纯前端组件"
-```
-
-## 🎯 总结
-
-### 完成度
-- ✅ 核心功能：100%
-- ✅ 文档：100%
-- ✅ 示例：100%
-- ✅ 测试：100%
-
-### 代码质量
-- ✅ TypeScript 类型安全
-- ✅ 错误处理完善
-- ✅ 代码风格一致
-- ✅ 无编译/Linter 错误
-
-### 用户体验
-- ✅ 易于使用
-- ✅ 文档完善
-- ✅ 错误提示友好
-- ✅ 向后兼容
-
-## 🚀 下一步建议
-
-### 短期改进
-1. 添加更多数据库类型支持（PostgreSQL, MySQL, MongoDB）
-2. 支持从环境变量读取配置
-3. 添加配置验证的单元测试
-
-### 长期规划
-1. 配置加密功能
-2. 多配置文件管理
-3. 配置模板系统
-4. 图形化配置工具
-
----
-
-## 📞 联系方式
-
-如有问题或建议，请联系：
-- GitHub Issues: [项目 Issues](https://github.com/needware/needware-cli/issues)
-- 邮箱: support@needware.com
-
----
-
-**实现日期**: 2025-11-17  
-**版本**: 1.5.2  
-**状态**: ✅ 已完成并测试通过
-
-