fix: 修复InitCommand项目路径识别问题，优化角色发现机制
主要修改： • 修复InitCommand.js中AI提供路径优先级配置问题 • 重构Luban角色思维模式文件结构，提升代码组织 • 优化工具执行系统，清理技术债务 • 更新package.registry.json反映最新资源结构 影响：解决了technical-product-manager等角色无法发现的关键问题 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
sean
@ -1,549 +0,0 @@
|
||||
# JavaScript生态系统精通
|
||||
|
||||
<knowledge>
|
||||
|
||||
## 🚀 现代JavaScript精通
|
||||
|
||||
### ES6+核心特性
|
||||
```javascript
|
||||
// 解构赋值与默认参数
|
||||
function createTool({ name, version = '1.0.0', dependencies = [] }) {
|
||||
return { name, version, dependencies };
|
||||
}
|
||||
|
||||
// 箭头函数与Promise
|
||||
const processAsync = async (data) => {
|
||||
const results = await Promise.all(
|
||||
data.map(item => processItem(item))
|
||||
);
|
||||
return results.filter(Boolean);
|
||||
};
|
||||
|
||||
// 模板字符串与标签函数
|
||||
function sqlQuery(strings, ...values) {
|
||||
return strings.reduce((query, string, i) => {
|
||||
const value = values[i] ? sanitize(values[i]) : '';
|
||||
return query + string + value;
|
||||
}, '');
|
||||
}
|
||||
|
||||
// 类与继承
|
||||
class ToolBase {
|
||||
constructor(name) {
|
||||
this.name = name;
|
||||
this.startTime = Date.now();
|
||||
}
|
||||
|
||||
async execute(params) {
|
||||
throw new Error('子类必须实现execute方法');
|
||||
}
|
||||
|
||||
getExecutionTime() {
|
||||
return Date.now() - this.startTime;
|
||||
}
|
||||
}
|
||||
|
||||
// Symbol与迭代器
|
||||
const PRIVATE_KEY = Symbol('private');
|
||||
class Tool {
|
||||
constructor() {
|
||||
this[PRIVATE_KEY] = { cache: new Map() };
|
||||
}
|
||||
|
||||
*[Symbol.iterator]() {
|
||||
yield* this.getResults();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 异步编程精通
|
||||
```javascript
|
||||
// Promise链式处理
|
||||
function processChain(data) {
|
||||
return Promise.resolve(data)
|
||||
.then(validate)
|
||||
.then(transform)
|
||||
.then(save)
|
||||
.catch(handleError)
|
||||
.finally(cleanup);
|
||||
}
|
||||
|
||||
// async/await错误处理
|
||||
async function safeExecute(fn, ...args) {
|
||||
try {
|
||||
const result = await fn(...args);
|
||||
return { success: true, data: result };
|
||||
} catch (error) {
|
||||
return { success: false, error: error.message };
|
||||
}
|
||||
}
|
||||
|
||||
// 并发控制
|
||||
class ConcurrencyManager {
|
||||
constructor(limit = 3) {
|
||||
this.limit = limit;
|
||||
this.running = 0;
|
||||
this.queue = [];
|
||||
}
|
||||
|
||||
async execute(fn) {
|
||||
return new Promise((resolve, reject) => {
|
||||
this.queue.push({ fn, resolve, reject });
|
||||
this.process();
|
||||
});
|
||||
}
|
||||
|
||||
async process() {
|
||||
if (this.running >= this.limit || this.queue.length === 0) {
|
||||
return;
|
||||
}
|
||||
|
||||
this.running++;
|
||||
const { fn, resolve, reject } = this.queue.shift();
|
||||
|
||||
try {
|
||||
const result = await fn();
|
||||
resolve(result);
|
||||
} catch (error) {
|
||||
reject(error);
|
||||
} finally {
|
||||
this.running--;
|
||||
this.process();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 超时控制
|
||||
function withTimeout(promise, ms) {
|
||||
const timeout = new Promise((_, reject) =>
|
||||
setTimeout(() => reject(new Error('操作超时')), ms)
|
||||
);
|
||||
return Promise.race([promise, timeout]);
|
||||
}
|
||||
```
|
||||
|
||||
## 📦 npm生态系统精通
|
||||
|
||||
### package.json深度配置
|
||||
```json
|
||||
{
|
||||
"name": "my-awesome-tool",
|
||||
"version": "1.0.0",
|
||||
"description": "一个很棒的工具",
|
||||
"main": "index.js",
|
||||
"engines": {
|
||||
"node": ">=14.0.0",
|
||||
"npm": ">=6.0.0"
|
||||
},
|
||||
"scripts": {
|
||||
"start": "node index.js",
|
||||
"test": "jest",
|
||||
"lint": "eslint .",
|
||||
"format": "prettier --write .",
|
||||
"preinstall": "node scripts/check-env.js"
|
||||
},
|
||||
"dependencies": {
|
||||
"lodash": "^4.17.21",
|
||||
"axios": "^1.6.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"jest": "^29.0.0",
|
||||
"eslint": "^8.0.0",
|
||||
"prettier": "^2.8.0"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"react": ">=16.8.0"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"fsevents": "^2.3.0"
|
||||
},
|
||||
"keywords": ["tool", "automation", "utility"],
|
||||
"author": "鲁班 <luban@promptx.ai>",
|
||||
"license": "MIT",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/promptx/awesome-tool.git"
|
||||
},
|
||||
"bugs": {
|
||||
"url": "https://github.com/promptx/awesome-tool/issues"
|
||||
},
|
||||
"homepage": "https://github.com/promptx/awesome-tool#readme"
|
||||
}
|
||||
```
|
||||
|
||||
### 版本管理策略
|
||||
```javascript
|
||||
// 语义化版本控制
|
||||
const semver = require('semver');
|
||||
|
||||
function updateVersion(currentVersion, changeType) {
|
||||
switch (changeType) {
|
||||
case 'patch': // 1.0.0 -> 1.0.1 (bug fixes)
|
||||
return semver.inc(currentVersion, 'patch');
|
||||
case 'minor': // 1.0.0 -> 1.1.0 (new features)
|
||||
return semver.inc(currentVersion, 'minor');
|
||||
case 'major': // 1.0.0 -> 2.0.0 (breaking changes)
|
||||
return semver.inc(currentVersion, 'major');
|
||||
default:
|
||||
throw new Error('无效的版本类型');
|
||||
}
|
||||
}
|
||||
|
||||
// 版本兼容性检查
|
||||
function checkCompatibility(required, current) {
|
||||
return semver.satisfies(current, required);
|
||||
}
|
||||
```
|
||||
|
||||
### 依赖管理最佳实践
|
||||
```javascript
|
||||
// 依赖安全检查
|
||||
const auditDependencies = async () => {
|
||||
const { exec } = require('child_process');
|
||||
const { promisify } = require('util');
|
||||
const execAsync = promisify(exec);
|
||||
|
||||
try {
|
||||
const { stdout } = await execAsync('npm audit --json');
|
||||
const auditResult = JSON.parse(stdout);
|
||||
|
||||
if (auditResult.vulnerabilities) {
|
||||
console.warn('发现安全漏洞:', auditResult.vulnerabilities);
|
||||
}
|
||||
|
||||
return auditResult;
|
||||
} catch (error) {
|
||||
console.error('安全审计失败:', error.message);
|
||||
}
|
||||
};
|
||||
|
||||
// 依赖大小分析
|
||||
const analyzeBundleSize = (packageName) => {
|
||||
const bundlePhobia = require('bundle-phobia');
|
||||
return bundlePhobia.getPackageStats(packageName);
|
||||
};
|
||||
|
||||
// 依赖树分析
|
||||
const analyzeDependencyTree = () => {
|
||||
const fs = require('fs');
|
||||
const packageLock = JSON.parse(fs.readFileSync('package-lock.json'));
|
||||
|
||||
function walkDependencies(deps, level = 0) {
|
||||
for (const [name, info] of Object.entries(deps)) {
|
||||
console.log(' '.repeat(level) + `${name}@${info.version}`);
|
||||
if (info.dependencies) {
|
||||
walkDependencies(info.dependencies, level + 1);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
walkDependencies(packageLock.dependencies);
|
||||
};
|
||||
```
|
||||
|
||||
## 🔧 模块系统精通
|
||||
|
||||
### CommonJS深度应用
|
||||
```javascript
|
||||
// 模块导出模式
|
||||
// 1. 单一导出
|
||||
module.exports = class Tool {
|
||||
execute() { /* ... */ }
|
||||
};
|
||||
|
||||
// 2. 多重导出
|
||||
module.exports = {
|
||||
Tool,
|
||||
ToolManager,
|
||||
createTool: (config) => new Tool(config)
|
||||
};
|
||||
|
||||
// 3. 动态导出
|
||||
const tools = {};
|
||||
const toolFiles = fs.readdirSync('./tools');
|
||||
toolFiles.forEach(file => {
|
||||
const name = path.basename(file, '.js');
|
||||
tools[name] = require(`./tools/${file}`);
|
||||
});
|
||||
module.exports = tools;
|
||||
|
||||
// 4. 条件导出
|
||||
if (process.env.NODE_ENV === 'development') {
|
||||
module.exports.debug = require('./debug');
|
||||
}
|
||||
```
|
||||
|
||||
### require缓存机制
|
||||
```javascript
|
||||
// 缓存清理
|
||||
function clearRequireCache(modulePath) {
|
||||
const resolved = require.resolve(modulePath);
|
||||
delete require.cache[resolved];
|
||||
}
|
||||
|
||||
// 热重载实现
|
||||
class HotReloader {
|
||||
constructor() {
|
||||
this.watchers = new Map();
|
||||
}
|
||||
|
||||
watch(modulePath, callback) {
|
||||
const watcher = fs.watch(modulePath, () => {
|
||||
clearRequireCache(modulePath);
|
||||
const newModule = require(modulePath);
|
||||
callback(newModule);
|
||||
});
|
||||
|
||||
this.watchers.set(modulePath, watcher);
|
||||
}
|
||||
|
||||
unwatch(modulePath) {
|
||||
const watcher = this.watchers.get(modulePath);
|
||||
if (watcher) {
|
||||
watcher.close();
|
||||
this.watchers.delete(modulePath);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 模块路径解析
|
||||
function resolveModule(moduleName, fromPath) {
|
||||
const Module = require('module');
|
||||
const originalResolveFilename = Module._resolveFilename;
|
||||
|
||||
return originalResolveFilename.call(Module, moduleName, {
|
||||
id: fromPath,
|
||||
filename: fromPath,
|
||||
paths: Module._nodeModulePaths(path.dirname(fromPath))
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
## 🛠️ 开发工具精通
|
||||
|
||||
### ESLint配置优化
|
||||
```javascript
|
||||
// .eslintrc.js
|
||||
module.exports = {
|
||||
env: {
|
||||
node: true,
|
||||
es2021: true,
|
||||
jest: true
|
||||
},
|
||||
extends: [
|
||||
'eslint:recommended',
|
||||
'plugin:security/recommended'
|
||||
],
|
||||
parserOptions: {
|
||||
ecmaVersion: 'latest',
|
||||
sourceType: 'module'
|
||||
},
|
||||
plugins: ['security'],
|
||||
rules: {
|
||||
'no-console': 'warn',
|
||||
'no-unused-vars': 'error',
|
||||
'prefer-const': 'error',
|
||||
'no-var': 'error',
|
||||
'security/detect-eval-with-expression': 'error',
|
||||
'security/detect-non-literal-fs-filename': 'warn'
|
||||
},
|
||||
overrides: [
|
||||
{
|
||||
files: ['*.test.js', '*.spec.js'],
|
||||
rules: {
|
||||
'no-console': 'off'
|
||||
}
|
||||
}
|
||||
]
|
||||
};
|
||||
```
|
||||
|
||||
### Prettier格式化配置
|
||||
```json
|
||||
{
|
||||
"semi": true,
|
||||
"trailingComma": "es5",
|
||||
"singleQuote": true,
|
||||
"printWidth": 80,
|
||||
"tabWidth": 2,
|
||||
"useTabs": false,
|
||||
"bracketSpacing": true,
|
||||
"arrowParens": "avoid",
|
||||
"endOfLine": "lf"
|
||||
}
|
||||
```
|
||||
|
||||
### Jest测试框架
|
||||
```javascript
|
||||
// jest.config.js
|
||||
module.exports = {
|
||||
testEnvironment: 'node',
|
||||
roots: ['<rootDir>/src', '<rootDir>/tests'],
|
||||
testMatch: [
|
||||
'**/__tests__/**/*.js',
|
||||
'**/?(*.)+(spec|test).js'
|
||||
],
|
||||
collectCoverageFrom: [
|
||||
'src/**/*.js',
|
||||
'!src/**/*.test.js'
|
||||
],
|
||||
coverageDirectory: 'coverage',
|
||||
coverageReporters: ['text', 'lcov', 'html'],
|
||||
setupFilesAfterEnv: ['<rootDir>/tests/setup.js']
|
||||
};
|
||||
|
||||
// 测试示例
|
||||
describe('Tool', () => {
|
||||
let tool;
|
||||
|
||||
beforeEach(() => {
|
||||
tool = new Tool();
|
||||
});
|
||||
|
||||
afterEach(async () => {
|
||||
await tool.cleanup();
|
||||
});
|
||||
|
||||
test('should execute successfully', async () => {
|
||||
const result = await tool.execute({ input: 'test' });
|
||||
expect(result).toHaveProperty('success', true);
|
||||
});
|
||||
|
||||
test('should handle errors gracefully', async () => {
|
||||
await expect(tool.execute({})).rejects.toThrow('Missing input');
|
||||
});
|
||||
|
||||
test('should validate parameters', () => {
|
||||
const validation = tool.validate({ input: 'valid' });
|
||||
expect(validation.valid).toBe(true);
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
## 🔒 安全编程实践
|
||||
|
||||
### 输入验证与清理
|
||||
```javascript
|
||||
const validator = require('validator');
|
||||
|
||||
class InputValidator {
|
||||
static sanitizeString(input, maxLength = 1000) {
|
||||
if (typeof input !== 'string') {
|
||||
throw new Error('输入必须是字符串');
|
||||
}
|
||||
|
||||
// 长度限制
|
||||
if (input.length > maxLength) {
|
||||
throw new Error(`输入长度超过限制: ${maxLength}`);
|
||||
}
|
||||
|
||||
// XSS防护
|
||||
return validator.escape(input);
|
||||
}
|
||||
|
||||
static validateEmail(email) {
|
||||
if (!validator.isEmail(email)) {
|
||||
throw new Error('无效的邮箱地址');
|
||||
}
|
||||
return validator.normalizeEmail(email);
|
||||
}
|
||||
|
||||
static validateURL(url) {
|
||||
if (!validator.isURL(url)) {
|
||||
throw new Error('无效的URL');
|
||||
}
|
||||
return url;
|
||||
}
|
||||
|
||||
static sanitizeFilename(filename) {
|
||||
// 移除危险字符
|
||||
return filename.replace(/[^a-zA-Z0-9._-]/g, '');
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 错误处理与日志
|
||||
```javascript
|
||||
class ToolLogger {
|
||||
constructor(toolName) {
|
||||
this.toolName = toolName;
|
||||
this.startTime = Date.now();
|
||||
}
|
||||
|
||||
info(message, data = {}) {
|
||||
console.log(JSON.stringify({
|
||||
level: 'info',
|
||||
tool: this.toolName,
|
||||
message,
|
||||
data,
|
||||
timestamp: new Date().toISOString()
|
||||
}));
|
||||
}
|
||||
|
||||
error(message, error = {}) {
|
||||
console.error(JSON.stringify({
|
||||
level: 'error',
|
||||
tool: this.toolName,
|
||||
message,
|
||||
error: {
|
||||
message: error.message,
|
||||
stack: error.stack
|
||||
},
|
||||
timestamp: new Date().toISOString()
|
||||
}));
|
||||
}
|
||||
|
||||
performance(operation, duration) {
|
||||
this.info(`Performance: ${operation}`, { duration });
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 资源管理与限制
|
||||
```javascript
|
||||
class ResourceManager {
|
||||
constructor(options = {}) {
|
||||
this.maxMemory = options.maxMemory || 100 * 1024 * 1024; // 100MB
|
||||
this.maxExecutionTime = options.maxExecutionTime || 30000; // 30s
|
||||
this.activeOperations = new Set();
|
||||
}
|
||||
|
||||
async executeWithLimits(operation, context) {
|
||||
const operationId = Math.random().toString(36);
|
||||
this.activeOperations.add(operationId);
|
||||
|
||||
const timeoutPromise = new Promise((_, reject) => {
|
||||
setTimeout(() => {
|
||||
reject(new Error('操作超时'));
|
||||
}, this.maxExecutionTime);
|
||||
});
|
||||
|
||||
try {
|
||||
// 内存监控
|
||||
const initialMemory = process.memoryUsage().heapUsed;
|
||||
|
||||
const result = await Promise.race([
|
||||
operation(),
|
||||
timeoutPromise
|
||||
]);
|
||||
|
||||
const finalMemory = process.memoryUsage().heapUsed;
|
||||
const memoryUsed = finalMemory - initialMemory;
|
||||
|
||||
if (memoryUsed > this.maxMemory) {
|
||||
console.warn(`内存使用超限: ${memoryUsed / 1024 / 1024}MB`);
|
||||
}
|
||||
|
||||
return result;
|
||||
} finally {
|
||||
this.activeOperations.delete(operationId);
|
||||
}
|
||||
}
|
||||
|
||||
getActiveOperations() {
|
||||
return this.activeOperations.size;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
</knowledge>
|
||||
@ -1,348 +0,0 @@
|
||||
# 工具设计最佳实践
|
||||
|
||||
<knowledge>
|
||||
|
||||
## 🎯 工具设计哲学
|
||||
|
||||
### 极简主义原则
|
||||
- **单一职责**：每个工具只解决一个核心问题
|
||||
- **接口优雅**：参数设计直观易懂，返回值结构清晰
|
||||
- **依赖最小**：只引入必要的依赖，避免过度膨胀
|
||||
- **错误友好**：提供清晰的错误信息和处理建议
|
||||
|
||||
### 用户体验至上
|
||||
- **即装即用**：工具无需复杂配置即可使用
|
||||
- **文档自描述**：通过Schema和Metadata实现自我说明
|
||||
- **性能优先**：执行效率和响应速度优化
|
||||
- **跨平台兼容**：确保在不同环境下稳定运行
|
||||
|
||||
## 🏗️ 架构设计原则
|
||||
|
||||
### ToolInterface标准化实现
|
||||
```javascript
|
||||
// 完美的工具接口示例
|
||||
module.exports = {
|
||||
// 🔧 依赖管理：明确、最小、版本锁定
|
||||
getDependencies() {
|
||||
return [
|
||||
'lodash@^4.17.21', // 工具函数库
|
||||
'validator@^13.11.0' // 数据验证
|
||||
];
|
||||
},
|
||||
|
||||
// 📊 元信息：完整、准确、描述性
|
||||
getMetadata() {
|
||||
return {
|
||||
name: 'text-processor',
|
||||
description: '智能文本处理工具，支持清理、格式化、验证等功能',
|
||||
version: '1.2.0',
|
||||
category: 'text-processing',
|
||||
author: '鲁班',
|
||||
tags: ['text', 'processing', 'utility']
|
||||
};
|
||||
},
|
||||
|
||||
// 📝 Schema定义：结构化、类型安全、示例丰富
|
||||
getSchema() {
|
||||
return {
|
||||
type: 'object',
|
||||
properties: {
|
||||
text: {
|
||||
type: 'string',
|
||||
description: '需要处理的文本内容',
|
||||
example: 'Hello World!'
|
||||
},
|
||||
operations: {
|
||||
type: 'array',
|
||||
items: {
|
||||
type: 'string',
|
||||
enum: ['clean', 'format', 'validate']
|
||||
},
|
||||
description: '要执行的操作列表',
|
||||
default: ['clean']
|
||||
},
|
||||
options: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
encoding: { type: 'string', default: 'utf-8' },
|
||||
strict: { type: 'boolean', default: false }
|
||||
}
|
||||
}
|
||||
},
|
||||
required: ['text']
|
||||
};
|
||||
},
|
||||
|
||||
// ✅ 参数验证：严格、友好、早期失败
|
||||
validate(params) {
|
||||
const errors = [];
|
||||
|
||||
if (!params.text || typeof params.text !== 'string') {
|
||||
errors.push('text参数必须是非空字符串');
|
||||
}
|
||||
|
||||
if (params.text && params.text.length > 50000) {
|
||||
errors.push('text长度不能超过50000字符');
|
||||
}
|
||||
|
||||
return {
|
||||
valid: errors.length === 0,
|
||||
errors
|
||||
};
|
||||
},
|
||||
|
||||
// 🚀 核心执行：健壮、高效、可观测
|
||||
async execute(params) {
|
||||
const startTime = Date.now();
|
||||
|
||||
try {
|
||||
// 核心处理逻辑
|
||||
const result = await this.processText(params);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
data: result,
|
||||
metadata: {
|
||||
executionTime: Date.now() - startTime,
|
||||
timestamp: new Date().toISOString()
|
||||
}
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
success: false,
|
||||
error: {
|
||||
message: error.message,
|
||||
code: error.code || 'UNKNOWN_ERROR'
|
||||
},
|
||||
metadata: {
|
||||
executionTime: Date.now() - startTime,
|
||||
timestamp: new Date().toISOString()
|
||||
}
|
||||
};
|
||||
}
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
## 🛡️ 安全与性能最佳实践
|
||||
|
||||
### 输入安全防护
|
||||
```javascript
|
||||
// 输入验证模式
|
||||
class InputValidator {
|
||||
static validateText(text, maxLength = 10000) {
|
||||
if (typeof text !== 'string') {
|
||||
throw new Error('输入必须是字符串类型');
|
||||
}
|
||||
|
||||
if (text.length > maxLength) {
|
||||
throw new Error(`文本长度超过限制: ${maxLength}`);
|
||||
}
|
||||
|
||||
// XSS防护
|
||||
if (/<script|javascript:|on\w+=/i.test(text)) {
|
||||
throw new Error('检测到潜在的恶意脚本');
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
static sanitizeFilename(filename) {
|
||||
return filename.replace(/[^a-zA-Z0-9._-]/g, '');
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 性能优化模式
|
||||
```javascript
|
||||
// 缓存机制
|
||||
const cache = new Map();
|
||||
const CACHE_TTL = 300000; // 5分钟
|
||||
|
||||
function withCache(fn, cacheKey) {
|
||||
const cached = cache.get(cacheKey);
|
||||
if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
|
||||
return cached.data;
|
||||
}
|
||||
|
||||
const result = fn();
|
||||
cache.set(cacheKey, {
|
||||
data: result,
|
||||
timestamp: Date.now()
|
||||
});
|
||||
|
||||
return result;
|
||||
}
|
||||
|
||||
// 资源控制
|
||||
function withResourceLimit(fn, timeout = 30000) {
|
||||
return Promise.race([
|
||||
fn(),
|
||||
new Promise((_, reject) =>
|
||||
setTimeout(() => reject(new Error('执行超时')), timeout)
|
||||
)
|
||||
]);
|
||||
}
|
||||
```
|
||||
|
||||
## 📦 依赖管理策略
|
||||
|
||||
### 精选依赖原则
|
||||
```javascript
|
||||
// 工具库选择矩阵
|
||||
const DEPENDENCY_MATRIX = {
|
||||
// 基础工具函数
|
||||
utilities: {
|
||||
recommended: 'lodash@^4.17.21',
|
||||
alternatives: ['ramda@^0.29.0', 'underscore@^1.13.0'],
|
||||
criteria: '成熟度、包大小、功能覆盖'
|
||||
},
|
||||
|
||||
// HTTP请求
|
||||
http: {
|
||||
recommended: 'axios@^1.6.0',
|
||||
alternatives: ['node-fetch@^3.3.0', 'got@^13.0.0'],
|
||||
criteria: '易用性、功能丰富度、兼容性'
|
||||
},
|
||||
|
||||
// 数据验证
|
||||
validation: {
|
||||
recommended: 'validator@^13.11.0',
|
||||
alternatives: ['joi@^17.11.0', 'yup@^1.3.0'],
|
||||
criteria: '验证规则丰富度、性能、学习成本'
|
||||
},
|
||||
|
||||
// 文件操作
|
||||
filesystem: {
|
||||
recommended: 'fs-extra@^11.1.0',
|
||||
alternatives: ['graceful-fs@^4.2.11'],
|
||||
criteria: '功能完整性、错误处理、跨平台'
|
||||
}
|
||||
};
|
||||
|
||||
// 依赖版本策略
|
||||
getDependencies() {
|
||||
return [
|
||||
'lodash@^4.17.21', // 主版本锁定，次版本兼容
|
||||
'axios@~1.6.0', // 补丁版本兼容
|
||||
'validator@13.11.0' // 精确版本锁定（关键依赖）
|
||||
];
|
||||
}
|
||||
```
|
||||
|
||||
## 🧪 测试驱动开发
|
||||
|
||||
### 工具测试模式
|
||||
```javascript
|
||||
// 标准测试模板
|
||||
describe('TextProcessor Tool', () => {
|
||||
let tool;
|
||||
|
||||
beforeEach(() => {
|
||||
tool = require('./text-processor.tool.js');
|
||||
});
|
||||
|
||||
describe('接口合规性测试', () => {
|
||||
test('必须实现所有接口方法', () => {
|
||||
expect(typeof tool.getDependencies).toBe('function');
|
||||
expect(typeof tool.getMetadata).toBe('function');
|
||||
expect(typeof tool.getSchema).toBe('function');
|
||||
expect(typeof tool.validate).toBe('function');
|
||||
expect(typeof tool.execute).toBe('function');
|
||||
});
|
||||
|
||||
test('getDependencies返回格式正确', () => {
|
||||
const deps = tool.getDependencies();
|
||||
expect(Array.isArray(deps)).toBe(true);
|
||||
deps.forEach(dep => {
|
||||
expect(typeof dep).toBe('string');
|
||||
expect(dep).toMatch(/^[a-zA-Z0-9-]+@[\^~]?\d+\.\d+\.\d+$/);
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
describe('功能测试', () => {
|
||||
test('正常输入处理', async () => {
|
||||
const result = await tool.execute({
|
||||
text: 'Hello World',
|
||||
operations: ['clean']
|
||||
});
|
||||
|
||||
expect(result.success).toBe(true);
|
||||
expect(result.data).toBeDefined();
|
||||
});
|
||||
|
||||
test('异常输入处理', async () => {
|
||||
const result = await tool.execute({
|
||||
text: null
|
||||
});
|
||||
|
||||
expect(result.success).toBe(false);
|
||||
expect(result.error).toBeDefined();
|
||||
});
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
## 📊 质量保证体系
|
||||
|
||||
### 代码质量检查
|
||||
```javascript
|
||||
// ESLint配置示例
|
||||
module.exports = {
|
||||
env: { node: true, es2021: true },
|
||||
extends: ['eslint:recommended'],
|
||||
rules: {
|
||||
'no-console': 'warn',
|
||||
'no-unused-vars': 'error',
|
||||
'prefer-const': 'error',
|
||||
'no-var': 'error',
|
||||
'complexity': ['warn', 10],
|
||||
'max-lines-per-function': ['warn', 50]
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### 性能基准测试
|
||||
```javascript
|
||||
// 性能测试模板
|
||||
function benchmarkTool(tool, testData) {
|
||||
const iterations = 1000;
|
||||
const start = process.hrtime.bigint();
|
||||
|
||||
for (let i = 0; i < iterations; i++) {
|
||||
tool.execute(testData);
|
||||
}
|
||||
|
||||
const end = process.hrtime.bigint();
|
||||
const avgTime = Number(end - start) / iterations / 1000000; // ms
|
||||
|
||||
return {
|
||||
iterations,
|
||||
averageTime: avgTime,
|
||||
totalTime: Number(end - start) / 1000000
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
## 🌟 卓越工具特征
|
||||
|
||||
### 用户体验指标
|
||||
- **启动时间** < 100ms
|
||||
- **执行效率** < 1s（常规任务）
|
||||
- **内存占用** < 50MB
|
||||
- **错误恢复** 100%优雅处理
|
||||
|
||||
### 代码质量指标
|
||||
- **圈复杂度** < 10
|
||||
- **测试覆盖率** > 90%
|
||||
- **依赖漏洞** 0个
|
||||
- **文档完整度** 100%
|
||||
|
||||
### 生态贡献指标
|
||||
- **复用性** 高（可被其他工具引用）
|
||||
- **扩展性** 强（支持插件机制）
|
||||
- **社区认可** 正面反馈 > 95%
|
||||
- **维护活跃度** 定期更新
|
||||
|
||||
</knowledge>
|
||||
Reference in New Issue
Block a user