Update code
This commit is contained in:
8
dev-assistant-mcp/dist/resources/codingStandards.d.ts
vendored
Normal file
8
dev-assistant-mcp/dist/resources/codingStandards.d.ts
vendored
Normal file
@@ -0,0 +1,8 @@
|
||||
export declare const codingStandardsResource: {
|
||||
uri: string;
|
||||
name: string;
|
||||
description: string;
|
||||
mimeType: string;
|
||||
};
|
||||
export declare function getCodingStandards(): string;
|
||||
//# sourceMappingURL=codingStandards.d.ts.map
|
||||
1
dev-assistant-mcp/dist/resources/codingStandards.d.ts.map
vendored
Normal file
1
dev-assistant-mcp/dist/resources/codingStandards.d.ts.map
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"codingStandards.d.ts","sourceRoot":"","sources":["../../src/resources/codingStandards.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB;;;;;CAKnC,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,MAAM,CA2B3C"}
|
||||
35
dev-assistant-mcp/dist/resources/codingStandards.js
vendored
Normal file
35
dev-assistant-mcp/dist/resources/codingStandards.js
vendored
Normal file
@@ -0,0 +1,35 @@
|
||||
export const codingStandardsResource = {
|
||||
uri: "devassistant://resources/coding-standards",
|
||||
name: "编码规范",
|
||||
description: "各主流语言的编码最佳实践和规范",
|
||||
mimeType: "text/markdown",
|
||||
};
|
||||
export function getCodingStandards() {
|
||||
return `# 编码规范速查
|
||||
|
||||
## TypeScript / JavaScript
|
||||
- 使用 \`const\` 优先,\`let\` 次之,禁用 \`var\`
|
||||
- 函数和变量使用 camelCase,类和接口使用 PascalCase
|
||||
- 优先使用 \`async/await\` 而非回调和 \`.then()\` 链
|
||||
- 使用严格类型,避免 \`any\`
|
||||
- 错误处理:始终 catch 异步操作的异常
|
||||
- 单个函数不超过 50 行,单个文件不超过 300 行
|
||||
|
||||
## Python
|
||||
- 遵循 PEP 8 规范
|
||||
- 函数和变量使用 snake_case,类使用 PascalCase
|
||||
- 使用 type hints 标注参数和返回值
|
||||
- 使用 f-string 格式化字符串
|
||||
- 使用 \`with\` 语句管理资源
|
||||
- 使用 \`pathlib\` 替代 \`os.path\`
|
||||
|
||||
## 通用原则
|
||||
- **DRY** — Don't Repeat Yourself,消除重复代码
|
||||
- **KISS** — Keep It Simple, Stupid,保持简单
|
||||
- **单一职责** — 每个函数/类只做一件事
|
||||
- **提前返回** — 用 guard clause 减少嵌套
|
||||
- **有意义的命名** — 变量名应表达意图,不用缩写
|
||||
- **最小暴露** — 只暴露必要的公开接口
|
||||
`;
|
||||
}
|
||||
//# sourceMappingURL=codingStandards.js.map
|
||||
1
dev-assistant-mcp/dist/resources/codingStandards.js.map
vendored
Normal file
1
dev-assistant-mcp/dist/resources/codingStandards.js.map
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"codingStandards.js","sourceRoot":"","sources":["../../src/resources/codingStandards.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,EAAE,2CAA2C;IAChD,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,iBAAiB;IAC9B,QAAQ,EAAE,eAAe;CAC1B,CAAC;AAEF,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;CAyBR,CAAC;AACF,CAAC"}
|
||||
8
dev-assistant-mcp/dist/resources/debugGuide.d.ts
vendored
Normal file
8
dev-assistant-mcp/dist/resources/debugGuide.d.ts
vendored
Normal file
@@ -0,0 +1,8 @@
|
||||
export declare const debugGuideResource: {
|
||||
uri: string;
|
||||
name: string;
|
||||
description: string;
|
||||
mimeType: string;
|
||||
};
|
||||
export declare function getDebugGuide(): string;
|
||||
//# sourceMappingURL=debugGuide.d.ts.map
|
||||
1
dev-assistant-mcp/dist/resources/debugGuide.d.ts.map
vendored
Normal file
1
dev-assistant-mcp/dist/resources/debugGuide.d.ts.map
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"debugGuide.d.ts","sourceRoot":"","sources":["../../src/resources/debugGuide.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;;CAK9B,CAAC;AAEF,wBAAgB,aAAa,IAAI,MAAM,CA4CtC"}
|
||||
52
dev-assistant-mcp/dist/resources/debugGuide.js
vendored
Normal file
52
dev-assistant-mcp/dist/resources/debugGuide.js
vendored
Normal file
@@ -0,0 +1,52 @@
|
||||
export const debugGuideResource = {
|
||||
uri: "devassistant://resources/debug-guide",
|
||||
name: "调试指南",
|
||||
description: "常见错误模式和排查方法",
|
||||
mimeType: "text/markdown",
|
||||
};
|
||||
export function getDebugGuide() {
|
||||
return `# 调试指南
|
||||
|
||||
## 调试步骤
|
||||
1. **复现问题** — 找到稳定的复现路径
|
||||
2. **阅读错误信息** — 仔细看完整报错和堆栈
|
||||
3. **缩小范围** — 二分法定位问题代码
|
||||
4. **检查假设** — 用 console.log / print 验证变量值
|
||||
5. **查看变更** — git diff 看最近改了什么
|
||||
6. **搜索已知问题** — Google / StackOverflow / GitHub Issues
|
||||
|
||||
## 常见错误模式
|
||||
|
||||
### TypeError: Cannot read properties of undefined
|
||||
- **原因**:访问了 null/undefined 的属性
|
||||
- **排查**:检查调用链上哪个变量可能为空
|
||||
- **修复**:使用可选链 \`?.\` 或提前判空
|
||||
|
||||
### ECONNREFUSED / ETIMEDOUT
|
||||
- **原因**:网络连接被拒绝或超时
|
||||
- **排查**:检查目标服务是否启动、端口是否正确、防火墙规则
|
||||
- **修复**:确认服务地址和端口,添加重试机制
|
||||
|
||||
### Memory Leak
|
||||
- **表现**:内存持续增长不释放
|
||||
- **排查**:检查未清理的定时器、事件监听器、闭包引用
|
||||
- **修复**:在组件销毁/函数退出时清理资源
|
||||
|
||||
### Race Condition
|
||||
- **表现**:偶发的数据不一致
|
||||
- **排查**:检查并发操作共享状态
|
||||
- **修复**:加锁、使用原子操作、或重新设计数据流
|
||||
|
||||
### Import/Module Error
|
||||
- **原因**:路径错误、循环依赖、导出方式不匹配
|
||||
- **排查**:检查文件路径、ESM vs CJS、default vs named export
|
||||
- **修复**:修正导入路径和方式
|
||||
|
||||
## 调试工具
|
||||
- **Node.js**: \`node --inspect\`, Chrome DevTools
|
||||
- **Python**: \`pdb\`, \`ipdb\`, VS Code debugger
|
||||
- **浏览器**: Chrome DevTools (Sources, Network, Console)
|
||||
- **通用**: \`git bisect\` 定位引入 bug 的提交
|
||||
`;
|
||||
}
|
||||
//# sourceMappingURL=debugGuide.js.map
|
||||
1
dev-assistant-mcp/dist/resources/debugGuide.js.map
vendored
Normal file
1
dev-assistant-mcp/dist/resources/debugGuide.js.map
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"debugGuide.js","sourceRoot":"","sources":["../../src/resources/debugGuide.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,sCAAsC;IAC3C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,eAAe;CAC1B,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CR,CAAC;AACF,CAAC"}
|
||||
8
dev-assistant-mcp/dist/resources/docTemplates.d.ts
vendored
Normal file
8
dev-assistant-mcp/dist/resources/docTemplates.d.ts
vendored
Normal file
@@ -0,0 +1,8 @@
|
||||
export declare const docTemplatesResource: {
|
||||
uri: string;
|
||||
name: string;
|
||||
description: string;
|
||||
mimeType: string;
|
||||
};
|
||||
export declare function getDocTemplates(): string;
|
||||
//# sourceMappingURL=docTemplates.d.ts.map
|
||||
1
dev-assistant-mcp/dist/resources/docTemplates.d.ts.map
vendored
Normal file
1
dev-assistant-mcp/dist/resources/docTemplates.d.ts.map
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"docTemplates.d.ts","sourceRoot":"","sources":["../../src/resources/docTemplates.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB;;;;;CAKhC,CAAC;AAEF,wBAAgB,eAAe,IAAI,MAAM,CAiGxC"}
|
||||
105
dev-assistant-mcp/dist/resources/docTemplates.js
vendored
Normal file
105
dev-assistant-mcp/dist/resources/docTemplates.js
vendored
Normal file
@@ -0,0 +1,105 @@
|
||||
export const docTemplatesResource = {
|
||||
uri: "devassistant://resources/doc-templates",
|
||||
name: "文档模板",
|
||||
description: "README、API 文档、CHANGELOG 等标准模板",
|
||||
mimeType: "text/markdown",
|
||||
};
|
||||
export function getDocTemplates() {
|
||||
return `# 文档模板集合
|
||||
|
||||
---
|
||||
|
||||
## README.md 模板
|
||||
|
||||
\`\`\`markdown
|
||||
# 项目名称
|
||||
|
||||
简短的项目描述(一句话)。
|
||||
|
||||
## 功能特性
|
||||
|
||||
- 特性 1
|
||||
- 特性 2
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 环境要求
|
||||
- Node.js >= 18
|
||||
|
||||
### 安装
|
||||
\\\`\\\`\\\`bash
|
||||
npm install
|
||||
\\\`\\\`\\\`
|
||||
|
||||
### 配置
|
||||
复制 \`.env.example\` 为 \`.env\`,填写配置。
|
||||
|
||||
### 运行
|
||||
\\\`\\\`\\\`bash
|
||||
npm start
|
||||
\\\`\\\`\\\`
|
||||
|
||||
## 项目结构
|
||||
\\\`\\\`\\\`
|
||||
src/
|
||||
├── index.ts # 入口
|
||||
├── routes/ # 路由
|
||||
├── services/ # 业务逻辑
|
||||
└── utils/ # 工具函数
|
||||
\\\`\\\`\\\`
|
||||
|
||||
## API 文档
|
||||
见 [API.md](./API.md)
|
||||
|
||||
## License
|
||||
MIT
|
||||
\`\`\`
|
||||
|
||||
---
|
||||
|
||||
## API 文档模板
|
||||
|
||||
\`\`\`markdown
|
||||
# API 文档
|
||||
|
||||
## Base URL
|
||||
\\\`https://api.example.com/v1\\\`
|
||||
|
||||
## 认证
|
||||
Header: \\\`Authorization: Bearer <token>\\\`
|
||||
|
||||
## 端点
|
||||
|
||||
### POST /endpoint
|
||||
描述
|
||||
|
||||
**请求参数**
|
||||
| 字段 | 类型 | 必填 | 描述 |
|
||||
|------|------|------|------|
|
||||
| name | string | 是 | 名称 |
|
||||
|
||||
**响应**
|
||||
\\\`\\\`\\\`json
|
||||
{ "code": 0, "data": {} }
|
||||
\\\`\\\`\\\`
|
||||
\`\`\`
|
||||
|
||||
---
|
||||
|
||||
## CHANGELOG 模板
|
||||
|
||||
\`\`\`markdown
|
||||
# Changelog
|
||||
|
||||
## [1.0.0] - 2025-01-01
|
||||
### Added
|
||||
- 初始版本发布
|
||||
- 功能 A
|
||||
- 功能 B
|
||||
|
||||
### Fixed
|
||||
- 修复问题 X
|
||||
\`\`\`
|
||||
`;
|
||||
}
|
||||
//# sourceMappingURL=docTemplates.js.map
|
||||
1
dev-assistant-mcp/dist/resources/docTemplates.js.map
vendored
Normal file
1
dev-assistant-mcp/dist/resources/docTemplates.js.map
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"docTemplates.js","sourceRoot":"","sources":["../../src/resources/docTemplates.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG,EAAE,wCAAwC;IAC7C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,+BAA+B;IAC5C,QAAQ,EAAE,eAAe;CAC1B,CAAC;AAEF,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FR,CAAC;AACF,CAAC"}
|
||||
Reference in New Issue
Block a user