intention-coding 0.4.3 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +133 -217
- package/dist/db/file-storage.d.ts +1 -0
- package/dist/db/file-storage.d.ts.map +1 -0
- package/dist/index.cjs +6267 -4788
- package/dist/index.d.ts +2 -1
- package/dist/index.d.ts.map +1 -0
- package/dist/services/6a-workflow-agent/6a-workflow-agent.test.d.ts +2 -0
- package/dist/services/6a-workflow-agent/6a-workflow-agent.test.d.ts.map +1 -0
- package/dist/services/6a-workflow-agent/index.d.ts +240 -0
- package/dist/services/6a-workflow-agent/index.d.ts.map +1 -0
- package/dist/services/6a-workflow-agent/stages/align-stage.d.ts +40 -0
- package/dist/services/6a-workflow-agent/stages/align-stage.d.ts.map +1 -0
- package/dist/services/6a-workflow-agent/stages/approve-stage.d.ts +24 -0
- package/dist/services/6a-workflow-agent/stages/approve-stage.d.ts.map +1 -0
- package/dist/services/6a-workflow-agent/stages/architect-stage.d.ts +20 -0
- package/dist/services/6a-workflow-agent/stages/architect-stage.d.ts.map +1 -0
- package/dist/services/6a-workflow-agent/stages/assess-stage.d.ts +36 -0
- package/dist/services/6a-workflow-agent/stages/assess-stage.d.ts.map +1 -0
- package/dist/services/6a-workflow-agent/stages/atomize-stage.d.ts +28 -0
- package/dist/services/6a-workflow-agent/stages/atomize-stage.d.ts.map +1 -0
- package/dist/services/6a-workflow-agent/stages/automate-stage.d.ts +36 -0
- package/dist/services/6a-workflow-agent/stages/automate-stage.d.ts.map +1 -0
- package/dist/services/6a-workflow-agent/types.d.ts +261 -0
- package/dist/services/6a-workflow-agent/types.d.ts.map +1 -0
- package/dist/services/6a-workflow-agent/workflow-manager.d.ts +67 -0
- package/dist/services/6a-workflow-agent/workflow-manager.d.ts.map +1 -0
- package/dist/services/bug-fix-agent/index.d.ts +39 -12
- package/dist/services/bug-fix-agent/index.d.ts.map +1 -0
- package/dist/services/change-summarizer/index.d.ts +39 -12
- package/dist/services/change-summarizer/index.d.ts.map +1 -0
- package/dist/services/change-summarizer/prompt/change-analysis.d.ts +1 -0
- package/dist/services/change-summarizer/prompt/change-analysis.d.ts.map +1 -0
- package/dist/services/code-generator/index.d.ts +39 -20
- package/dist/services/code-generator/index.d.ts.map +1 -0
- package/dist/services/code-generator/stages/execution-stage.d.ts +2 -1
- package/dist/services/code-generator/stages/execution-stage.d.ts.map +1 -0
- package/dist/services/code-generator/stages/ideation-stage.d.ts +2 -1
- package/dist/services/code-generator/stages/ideation-stage.d.ts.map +1 -0
- package/dist/services/code-generator/stages/optimization-stage.d.ts +2 -1
- package/dist/services/code-generator/stages/optimization-stage.d.ts.map +1 -0
- package/dist/services/code-generator/stages/planning-stage.d.ts +2 -1
- package/dist/services/code-generator/stages/planning-stage.d.ts.map +1 -0
- package/dist/services/code-generator/stages/research-stage.d.ts +2 -1
- package/dist/services/code-generator/stages/research-stage.d.ts.map +1 -0
- package/dist/services/code-generator/stages/review-stage.d.ts +2 -1
- package/dist/services/code-generator/stages/review-stage.d.ts.map +1 -0
- package/dist/services/code-generator/types.d.ts +3 -2
- package/dist/services/code-generator/types.d.ts.map +1 -0
- package/dist/services/code-generator/utils/instruction-executor.d.ts +1 -0
- package/dist/services/code-generator/utils/instruction-executor.d.ts.map +1 -0
- package/dist/services/code-generator/workflow-manager.d.ts +2 -1
- package/dist/services/code-generator/workflow-manager.d.ts.map +1 -0
- package/dist/services/image-analysis/analyzer.d.ts +23 -2
- package/dist/services/image-analysis/analyzer.d.ts.map +1 -0
- package/dist/services/image-analysis/index.d.ts +36 -41
- package/dist/services/image-analysis/index.d.ts.map +1 -0
- package/dist/services/image-analysis/types.d.ts +1 -4
- package/dist/services/image-analysis/types.d.ts.map +1 -0
- package/dist/services/image-converter/converter.d.ts +1 -0
- package/dist/services/image-converter/converter.d.ts.map +1 -0
- package/dist/services/image-converter/index.d.ts +53 -26
- package/dist/services/image-converter/index.d.ts.map +1 -0
- package/dist/services/image-converter/types.d.ts +1 -0
- package/dist/services/image-converter/types.d.ts.map +1 -0
- package/dist/services/image-recognition-agent/analyzer.d.ts +48 -0
- package/dist/services/image-recognition-agent/analyzer.d.ts.map +1 -0
- package/dist/services/image-recognition-agent/config-calculator.d.ts +45 -0
- package/dist/services/image-recognition-agent/config-calculator.d.ts.map +1 -0
- package/dist/services/image-recognition-agent/image-recognition-agent.test.d.ts +2 -0
- package/dist/services/image-recognition-agent/image-recognition-agent.test.d.ts.map +1 -0
- package/dist/services/image-recognition-agent/index.d.ts +26 -0
- package/dist/services/image-recognition-agent/index.d.ts.map +1 -0
- package/dist/services/image-recognition-agent/preprocessor.d.ts +28 -0
- package/dist/services/image-recognition-agent/preprocessor.d.ts.map +1 -0
- package/dist/services/image-recognition-agent/processor.d.ts +36 -0
- package/dist/services/image-recognition-agent/processor.d.ts.map +1 -0
- package/dist/services/image-recognition-agent/realtime-output.d.ts +78 -0
- package/dist/services/image-recognition-agent/realtime-output.d.ts.map +1 -0
- package/dist/services/image-recognition-agent/simple-processor.d.ts +36 -0
- package/dist/services/image-recognition-agent/simple-processor.d.ts.map +1 -0
- package/dist/services/image-recognition-agent/types.d.ts +321 -0
- package/dist/services/image-recognition-agent/types.d.ts.map +1 -0
- package/dist/{server → services}/index.d.ts +1 -0
- package/dist/services/index.d.ts.map +1 -0
- package/dist/services/integrated-generator/index.d.ts +69 -30
- package/dist/services/integrated-generator/index.d.ts.map +1 -0
- package/dist/services/pdf2md/index.d.ts +40 -21
- package/dist/services/pdf2md/index.d.ts.map +1 -0
- package/dist/services/project-template/index.d.ts +33 -4
- package/dist/services/project-template/index.d.ts.map +1 -0
- package/dist/services/project-template/prompt/project-rules.d.ts +1 -0
- package/dist/services/project-template/prompt/project-rules.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/chunk-reader.d.ts +1 -0
- package/dist/services/requirement-analyzer/chunk-reader.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/core/document-generator.d.ts +1 -0
- package/dist/services/requirement-analyzer/core/document-generator.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/core/intelligent-analyzer.d.ts +1 -0
- package/dist/services/requirement-analyzer/core/intelligent-analyzer.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/core/project-analyzer.d.ts +1 -0
- package/dist/services/requirement-analyzer/core/project-analyzer.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/core/requirement-analyzer-service.d.ts +1 -0
- package/dist/services/requirement-analyzer/core/requirement-analyzer-service.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/core/template-selector.d.ts +1 -0
- package/dist/services/requirement-analyzer/core/template-selector.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/core/types.d.ts +1 -0
- package/dist/services/requirement-analyzer/core/types.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/index.d.ts +94 -32
- package/dist/services/requirement-analyzer/index.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/prompt/api-template.d.ts +1 -0
- package/dist/services/requirement-analyzer/prompt/api-template.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/prompt/app-template.d.ts +1 -0
- package/dist/services/requirement-analyzer/prompt/app-template.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/prompt/intelligent-requirement-analysis.d.ts +1 -0
- package/dist/services/requirement-analyzer/prompt/intelligent-requirement-analysis.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/prompt/pc-page-template.d.ts +1 -0
- package/dist/services/requirement-analyzer/prompt/pc-page-template.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/prompt/requirement-analysis.d.ts +1 -0
- package/dist/services/requirement-analyzer/prompt/requirement-analysis.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/prompt/sdk-template.d.ts +1 -0
- package/dist/services/requirement-analyzer/prompt/sdk-template.d.ts.map +1 -0
- package/dist/services/requirement-analyzer/utils/file-reader.d.ts +1 -0
- package/dist/services/requirement-analyzer/utils/file-reader.d.ts.map +1 -0
- package/dist/services/world2md/index.d.ts +66 -17
- package/dist/services/world2md/index.d.ts.map +1 -0
- package/dist/types/index.d.ts +8 -7
- package/dist/types/index.d.ts.map +1 -0
- package/dist/utils/common.d.ts +1 -0
- package/dist/utils/common.d.ts.map +1 -0
- package/dist/utils/config.d.ts +1 -0
- package/dist/utils/config.d.ts.map +1 -0
- package/dist/utils/context-manager.d.ts +1 -0
- package/dist/utils/context-manager.d.ts.map +1 -0
- package/dist/utils/crypto.d.ts +28 -0
- package/dist/utils/crypto.d.ts.map +1 -0
- package/dist/utils/dify.d.ts +1 -0
- package/dist/utils/dify.d.ts.map +1 -0
- package/dist/utils/logger.d.ts +1 -0
- package/dist/utils/logger.d.ts.map +1 -0
- package/dist/utils/openai.d.ts +6 -7
- package/dist/utils/openai.d.ts.map +1 -0
- package/dist/utils/pack.d.ts +1 -0
- package/dist/utils/pack.d.ts.map +1 -0
- package/package.json +6 -8
package/README.md
CHANGED
|
@@ -2,261 +2,177 @@
|
|
|
2
2
|
|
|
3
3
|
提供从需求分析到代码生成的完整开发生命周期管理。
|
|
4
4
|
|
|
5
|
-
## 🚀
|
|
5
|
+
## 🚀 快速开始
|
|
6
6
|
|
|
7
|
-
### 1.
|
|
8
|
-
**`integrated_generator`** - 全新的需求驱动开发工具
|
|
7
|
+
### 1. 安装和配置
|
|
9
8
|
|
|
10
|
-
```
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
],
|
|
21
|
-
"programming_language": "typescript",
|
|
22
|
-
"framework": "express"
|
|
23
|
-
}
|
|
9
|
+
```bash
|
|
10
|
+
# 克隆项目
|
|
11
|
+
git clone <repository-url>
|
|
12
|
+
cd mcp
|
|
13
|
+
|
|
14
|
+
# 安装依赖
|
|
15
|
+
npm install
|
|
16
|
+
|
|
17
|
+
# 初始化环境配置
|
|
18
|
+
npm run start
|
|
24
19
|
```
|
|
25
20
|
|
|
26
|
-
### 2.
|
|
27
|
-
**`requirement_analyzer`** - 智能需求分析和文档生成
|
|
21
|
+
### 2. 环境变量配置
|
|
28
22
|
|
|
29
|
-
|
|
30
|
-
**`code_generator`** - 传统代码生成工具,建议使用集成化生成器
|
|
23
|
+
本项目采用**统一的构建时加密 → 运行时解密**配置方案,无论开发还是生产环境都使用相同的配置管理方式。
|
|
31
24
|
|
|
32
|
-
|
|
33
|
-
**`init_project_standard`** - 传统项目规范工具,建议使用集成化生成器
|
|
25
|
+
#### 首次使用配置步骤:
|
|
34
26
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
27
|
+
1. **运行初始化脚本**:
|
|
28
|
+
```bash
|
|
29
|
+
npm run start
|
|
30
|
+
```
|
|
31
|
+
脚本会自动创建 `.env.example` 文件并指导你配置。
|
|
38
32
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
33
|
+
2. **创建环境变量文件**:
|
|
34
|
+
```bash
|
|
35
|
+
cp .env.example .env
|
|
36
|
+
```
|
|
42
37
|
|
|
43
|
-
|
|
44
|
-
|
|
38
|
+
3. **配置API密钥**(至少配置一个):
|
|
39
|
+
```bash
|
|
40
|
+
# 编辑 .env 文件
|
|
41
|
+
QWEN_API_KEY=your_qwen_api_key_here
|
|
42
|
+
KIMI_API_KEY=your_kimi_api_key_here
|
|
43
|
+
GLM_4V_API_KEY=your_glm_4v_api_key_here
|
|
44
|
+
DEEPSEEK_API_KEY=your_deepseek_api_key_here
|
|
45
|
+
OPENAI_API_KEY=your_openai_api_key_here
|
|
46
|
+
```
|
|
45
47
|
|
|
46
|
-
|
|
48
|
+
4. **验证配置**:
|
|
49
|
+
```bash
|
|
50
|
+
npm run start
|
|
51
|
+
```
|
|
47
52
|
|
|
48
|
-
|
|
53
|
+
#### 支持的AI服务:
|
|
54
|
+
- **通义千问 (Qwen)** - 主要用于代码生成和文本处理
|
|
55
|
+
- **Kimi (月之暗面)** - 支持长文本和图像分析
|
|
56
|
+
- **GLM-4V (智谱清言)** - 视觉AI和代码理解
|
|
57
|
+
- **DeepSeek** - 代码生成和推理
|
|
58
|
+
- **OpenAI兼容API** - 兼容OpenAI格式的API服务
|
|
49
59
|
|
|
50
|
-
|
|
60
|
+
### 3. 开发模式
|
|
51
61
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
{
|
|
56
|
-
"project_name": "电商订单系统",
|
|
57
|
-
"project_description": "处理电商订单的完整生命周期",
|
|
58
|
-
"user_story": "作为商家,我想要管理订单,以便于及时处理客户订单",
|
|
59
|
-
"acceptance_criteria": [
|
|
60
|
-
"可以创建新订单",
|
|
61
|
-
"可以查询订单状态",
|
|
62
|
-
"可以更新订单信息",
|
|
63
|
-
"可以取消订单"
|
|
64
|
-
],
|
|
65
|
-
"programming_language": "typescript",
|
|
66
|
-
"framework": "express"
|
|
67
|
-
}
|
|
68
|
-
```
|
|
62
|
+
```bash
|
|
63
|
+
# 开始开发(会自动生成配置)
|
|
64
|
+
npm run dev
|
|
69
65
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
"project_description": "集成多种支付方式的支付处理模块",
|
|
76
|
-
"user_story": "作为用户,我想要多种支付方式,以便于选择最方便的支付方式",
|
|
77
|
-
"acceptance_criteria": [
|
|
78
|
-
"支持支付宝支付",
|
|
79
|
-
"支持微信支付",
|
|
80
|
-
"支持银行卡支付",
|
|
81
|
-
"支持支付状态查询"
|
|
82
|
-
],
|
|
83
|
-
"programming_language": "typescript",
|
|
84
|
-
"framework": "express",
|
|
85
|
-
"generation_type": "module_only",
|
|
86
|
-
"architecture_pattern": "layered",
|
|
87
|
-
"include_tests": true,
|
|
88
|
-
"business_rules": [
|
|
89
|
-
"支付金额必须大于0",
|
|
90
|
-
"同一订单不能重复支付",
|
|
91
|
-
"支付超时自动取消"
|
|
92
|
-
]
|
|
93
|
-
}
|
|
66
|
+
# 运行测试
|
|
67
|
+
npm run test
|
|
68
|
+
|
|
69
|
+
# MCP工具测试
|
|
70
|
+
npm run test:mcp
|
|
94
71
|
```
|
|
95
72
|
|
|
96
|
-
###
|
|
73
|
+
### 4. 构建和发布
|
|
97
74
|
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
}
|
|
75
|
+
```bash
|
|
76
|
+
# 构建项目(会自动生成加密配置)
|
|
77
|
+
npm run build
|
|
78
|
+
|
|
79
|
+
# 快速构建
|
|
80
|
+
npm run build:quick
|
|
105
81
|
```
|
|
106
82
|
|
|
107
|
-
|
|
83
|
+
## 📦 MCP客户端集成
|
|
108
84
|
|
|
109
|
-
|
|
110
|
-
|
|
85
|
+
### 开发环境集成
|
|
86
|
+
```json
|
|
111
87
|
{
|
|
112
|
-
"
|
|
113
|
-
|
|
88
|
+
"mcpServers": {
|
|
89
|
+
"智能软件星工厂-本地开发版": {
|
|
90
|
+
"command": "npx",
|
|
91
|
+
"args": [
|
|
92
|
+
"tsx",
|
|
93
|
+
"/Users/bjyf/Desktop/project/LLM/auto-code/mcpProject/mcp/src/index.ts"
|
|
94
|
+
]
|
|
95
|
+
}
|
|
96
|
+
}
|
|
114
97
|
}
|
|
98
|
+
```
|
|
115
99
|
|
|
116
|
-
|
|
100
|
+
### 生产环境集成
|
|
101
|
+
```json
|
|
117
102
|
{
|
|
118
|
-
"
|
|
119
|
-
|
|
103
|
+
"mcpServers": {
|
|
104
|
+
"智能软件星工厂": {
|
|
105
|
+
"command": "npx",
|
|
106
|
+
"args": [
|
|
107
|
+
"-y",
|
|
108
|
+
"intention-coding"
|
|
109
|
+
],
|
|
110
|
+
"env": {
|
|
111
|
+
"MCP_STORAGE_DIR": "mcp输出的内容存放的绝对路径,一般是前后端工程的父级文件夹的绝对路径"
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
}
|
|
120
115
|
}
|
|
121
116
|
```
|
|
122
117
|
|
|
123
|
-
##
|
|
124
|
-
|
|
125
|
-
集成化项目生成器遵循以下严格的工作流程:
|
|
126
|
-
|
|
127
|
-
```mermaid
|
|
128
|
-
flowchart TD
|
|
129
|
-
Start([开始]) --> Story[创建用户故事]
|
|
130
|
-
Story --> ReviewStory{用户故事评审}
|
|
131
|
-
ReviewStory -->|通过| WriteFeature[编写Feature文件]
|
|
132
|
-
ReviewStory -->|不通过| ReviseStory[修改用户故事]
|
|
133
|
-
ReviseStory --> ReviewStory
|
|
134
|
-
|
|
135
|
-
WriteFeature --> ConfirmFeature{Feature确认}
|
|
136
|
-
ConfirmFeature -->|通过| Design[技术方案设计]
|
|
137
|
-
ConfirmFeature -->|不通过| ReviseFeature[修改Feature]
|
|
138
|
-
ReviseFeature --> ConfirmFeature
|
|
139
|
-
|
|
140
|
-
Design --> Implement[代码实现]
|
|
141
|
-
Implement --> Test[编写测试]
|
|
142
|
-
Test --> ReviewCode[代码审查]
|
|
143
|
-
ReviewCode --> DeployTest[部署测试]
|
|
144
|
-
DeployTest --> Acceptance{验收测试}
|
|
145
|
-
Acceptance -->|通过| Done([完成])
|
|
146
|
-
Acceptance -->|不通过| Fix[修复问题]
|
|
147
|
-
Fix --> Test
|
|
148
|
-
```
|
|
118
|
+
## 🔒 安全特性
|
|
149
119
|
|
|
150
|
-
|
|
120
|
+
### 统一加密配置方案
|
|
121
|
+
- ✅ **构建时加密**:所有敏感配置在构建时自动加密
|
|
122
|
+
- ✅ **运行时解密**:运行时安全解密使用,无明文存储
|
|
123
|
+
- ✅ **统一管理**:开发和生产环境使用相同的配置管理方式
|
|
124
|
+
- ✅ **自动降级**:配置获取失败时自动降级到安全默认值
|
|
151
125
|
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
│ │ └── project-name.feature.md
|
|
158
|
-
│ ├── architecture/
|
|
159
|
-
│ │ └── technical-architecture.md
|
|
160
|
-
│ ├── api/
|
|
161
|
-
│ │ └── api-specification.md
|
|
162
|
-
│ ├── development-standards.md
|
|
163
|
-
│ ├── development-workflow.md
|
|
164
|
-
│ └── testing-strategy.md
|
|
165
|
-
├── src/
|
|
166
|
-
│ ├── controllers/
|
|
167
|
-
│ ├── services/
|
|
168
|
-
│ ├── repositories/
|
|
169
|
-
│ ├── models/
|
|
170
|
-
│ ├── middleware/
|
|
171
|
-
│ └── utils/
|
|
172
|
-
├── tests/
|
|
173
|
-
│ ├── unit/
|
|
174
|
-
│ ├── integration/
|
|
175
|
-
│ └── e2e/
|
|
176
|
-
├── config/
|
|
177
|
-
├── package.json
|
|
178
|
-
├── tsconfig.json
|
|
179
|
-
└── README.md
|
|
180
|
-
```
|
|
126
|
+
### 配置管理优势
|
|
127
|
+
- 🚀 **开发体验一致**:本地开发和生产部署使用相同的配置方式
|
|
128
|
+
- 🛡️ **安全性提升**:敏感信息加密存储,避免明文泄露
|
|
129
|
+
- 🔄 **自动化流程**:构建时自动生成配置,无需手动管理
|
|
130
|
+
- 📊 **智能检测**:自动检测可用API并优化服务选择
|
|
181
131
|
|
|
182
|
-
##
|
|
132
|
+
## ⚙️ 配置选项
|
|
183
133
|
|
|
184
|
-
###
|
|
185
|
-
```bash
|
|
186
|
-
npm install
|
|
187
|
-
```
|
|
134
|
+
### 环境变量说明
|
|
188
135
|
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
136
|
+
| 变量名 | 描述 | 默认值 | 必需 |
|
|
137
|
+
|--------|------|--------|------|
|
|
138
|
+
| `QWEN_API_KEY` | 通义千问API密钥 | - | 可选 |
|
|
139
|
+
| `KIMI_API_KEY` | Kimi API密钥 | - | 可选 |
|
|
140
|
+
| `GLM_4V_API_KEY` | GLM-4V API密钥 | - | 可选 |
|
|
141
|
+
| `DEEPSEEK_API_KEY` | DeepSeek API密钥 | - | 可选 |
|
|
142
|
+
| `OPENAI_API_KEY` | OpenAI API密钥 | - | 可选 |
|
|
143
|
+
| `NODE_ENV` | 运行环境 | `development` | 否 |
|
|
144
|
+
| `LOG_LEVEL` | 日志级别 | `info` | 否 |
|
|
145
|
+
| `MCP_STORAGE_DIR` | 存储目录 | 自动检测 | 否 |
|
|
146
|
+
|
|
147
|
+
**注意**:至少需要配置一个AI服务的API密钥才能正常使用。
|
|
148
|
+
|
|
149
|
+
## 🛠️ 可用命令
|
|
193
150
|
|
|
194
|
-
###
|
|
151
|
+
### 开发命令
|
|
195
152
|
```bash
|
|
196
|
-
npm run
|
|
153
|
+
npm run start # 环境配置检查和初始化
|
|
154
|
+
npm run dev # 开发模式(监听文件变化)
|
|
155
|
+
npm run dev:setup # 开发环境设置
|
|
156
|
+
npm run build # 完整构建(包含检查和配置生成)
|
|
157
|
+
npm run build:dev # 快速开发构建
|
|
158
|
+
npm run build:quick # 快速构建(跳过检查)
|
|
197
159
|
```
|
|
198
160
|
|
|
199
|
-
###
|
|
161
|
+
### 测试命令
|
|
200
162
|
```bash
|
|
201
|
-
npm run
|
|
163
|
+
npm run test # 运行单元测试
|
|
164
|
+
npm run test:watch # 监听模式测试
|
|
165
|
+
npm run test:mcp # MCP工具集成测试
|
|
166
|
+
npm run test:comprehensive # 全面集成测试
|
|
167
|
+
npm run test:local-dev # 本地开发测试
|
|
168
|
+
npm run test:integration # 集成测试套件
|
|
169
|
+
npm run test:all # 运行所有测试
|
|
202
170
|
```
|
|
203
171
|
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
### 环境变量
|
|
172
|
+
### 实用命令
|
|
207
173
|
```bash
|
|
208
|
-
#
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
#
|
|
212
|
-
LOG_LEVEL=info
|
|
213
|
-
|
|
214
|
-
# AI服务配置
|
|
215
|
-
AI_API_KEY=your-api-key
|
|
174
|
+
npm run generate-config # 生成安全配置
|
|
175
|
+
npm run pre-build-check # 构建前检查
|
|
176
|
+
npm run verify-env # 验证环境配置
|
|
177
|
+
npm run debug:openai # 调试OpenAI集成
|
|
216
178
|
```
|
|
217
|
-
|
|
218
|
-
### 项目配置
|
|
219
|
-
编辑 `src/config.ts` 文件进行项目级配置。
|
|
220
|
-
|
|
221
|
-
## 📊 工具对比
|
|
222
|
-
|
|
223
|
-
| 工具名称 | 主要功能 | 状态 | 推荐程度 |
|
|
224
|
-
|----------|----------|------|----------|
|
|
225
|
-
| `integrated_generator` | 需求驱动的完整项目生成 | ✅ 活跃 | ⭐⭐⭐⭐⭐ |
|
|
226
|
-
| `requirement_analyzer` | 智能需求分析 | ✅ 活跃 | ⭐⭐⭐⭐ |
|
|
227
|
-
| `code_generator` | 传统代码生成 | ⚠️ 弃用 | ⭐⭐ |
|
|
228
|
-
| `init_project_standard` | 项目规范生成 | ⚠️ 弃用 | ⭐⭐ |
|
|
229
|
-
| `word2md` | Word转Markdown | ✅ 活跃 | ⭐⭐⭐⭐ |
|
|
230
|
-
| `pdf2md` | PDF转Markdown | ✅ 活跃 | ⭐⭐⭐⭐ |
|
|
231
|
-
|
|
232
|
-
## 🚨 弃用通知
|
|
233
|
-
|
|
234
|
-
### 已弃用工具
|
|
235
|
-
- **`init_project_standard`** - 请使用 `integrated_generator`
|
|
236
|
-
- **`code_generator`** - 请使用 `integrated_generator`
|
|
237
|
-
|
|
238
|
-
这些工具仍然可用,但不再维护,建议迁移到新的集成化工具。
|
|
239
|
-
|
|
240
|
-
## 🤝 贡献
|
|
241
|
-
|
|
242
|
-
1. Fork 项目
|
|
243
|
-
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
|
|
244
|
-
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
|
|
245
|
-
4. 推送到分支 (`git push origin feature/AmazingFeature`)
|
|
246
|
-
5. 创建 Pull Request
|
|
247
|
-
|
|
248
|
-
## 📄 许可证
|
|
249
|
-
|
|
250
|
-
MIT License - 详见 [LICENSE](LICENSE) 文件
|
|
251
|
-
|
|
252
|
-
## 🆘 支持
|
|
253
|
-
|
|
254
|
-
- 📖 [文档](docs/)
|
|
255
|
-
- 🐛 [问题报告](https://github.com/your-repo/issues)
|
|
256
|
-
- 💬 [讨论区](https://github.com/your-repo/discussions)
|
|
257
|
-
|
|
258
|
-
## 🔗 相关链接
|
|
259
|
-
|
|
260
|
-
- [FastMCP文档](https://github.com/punkpeye/fastmcp)
|
|
261
|
-
- [Cursor规则](.cursor/rules/)
|
|
262
|
-
- [最佳实践](docs/best-practices.md)
|
|
@@ -253,3 +253,4 @@ export declare const dbOperations: {
|
|
|
253
253
|
getCodeGenerationTasksBySession: (sessionUuid: string) => Promise<CodeGenerationTask[]>;
|
|
254
254
|
updateCodeGenerationTask: (uuid: string, data: Partial<CodeGenerationTask>) => Promise<void>;
|
|
255
255
|
};
|
|
256
|
+
//# sourceMappingURL=file-storage.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"file-storage.d.ts","sourceRoot":"","sources":["../../src/db/file-storage.ts"],"names":[],"mappings":"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"}
|