- Add comprehensive refactoring plan documentation (REFACTORING_PLAN.md) - Create automated refactoring scripts for imports, types, and logger migration - Reorganize renderer components into functional groups (layout, sidebar, settings, editor) - Split large monolithic files (Sidebar.tsx, SettingsModal.tsx, AgentService.ts) into smaller modules - Migrate all console.log/warn/error calls to centralized Logger utility across 60+ files - Standardize import paths from relative paths to @/ alias throughout codebase - Create shared Logger utility in src/shared/utils for cross-process logging - Update TypeScript and Vite configurations to support new module structure - Restructure services directory with functional categorization (lsp, completion, storage, file) - Reorganize agent features into core, tools, context, and store subdirectories - Improve code maintainability and reduce circular dependencies through better separation of concerns
1.9 KiB
1.9 KiB
Adnify 重构脚本
使用方法
1. 预览变更(推荐先执行)
# 预览所有变更
node scripts/refactor/run-all.js --dry-run
# 或单独预览
node scripts/refactor/migrate-imports.js --dry-run
node scripts/refactor/migrate-console-to-logger.js --dry-run
2. 执行变更
# 执行所有重构
node scripts/refactor/run-all.js
# 或单独执行
node scripts/refactor/migrate-imports.js
node scripts/refactor/migrate-console-to-logger.js
3. 验证
# TypeScript 编译检查
npx tsc --noEmit
# 运行测试
npm test
# 构建
npm run build
脚本说明
| 脚本 | 功能 |
|---|---|
migrate-imports.js |
将相对路径 ../ 迁移到路径别名 @/ |
migrate-console-to-logger.js |
将 console.* 替换为 logger.* |
run-all.js |
按顺序运行所有脚本 |
路径别名映射
| 别名 | 路径 |
|---|---|
@/* |
src/* |
@main/* |
src/main/* |
@renderer/* |
src/renderer/* |
@shared/* |
src/shared/* |
@components/* |
src/renderer/components/* |
@features/* |
src/renderer/features/* |
@services/* |
src/renderer/services/* |
@store/* |
src/renderer/store/* |
@hooks/* |
src/renderer/hooks/* |
@utils/* |
src/renderer/utils/* |
@types/* |
src/renderer/types/* |
日志分类映射
脚本会根据文件路径自动推断日志分类:
| 路径包含 | 分类 |
|---|---|
/agent/ |
agent |
/services/lsp |
lsp |
/services/completion |
completion |
/store/ |
store |
/components/ |
ui |
/ipc/ |
ipc |
/security/ |
security |
/indexing/ |
index |
| 其他 | system |
注意事项
- 执行前请确保代码已提交到 Git
- 建议在新分支上执行重构
- 执行后需要手动检查并修复可能的问题
- 某些复杂的相对路径可能需要手动调整