Problem
1、无法定制repo Wiki的生成策略,比如:指定模型阅读哪些目录或者剔除哪些并输出、关键文件目录指定AI阅读优先级、结合现有的MCP或者业务知识库辅助生成有业务理解的文档
2、无法进行多轮对话持续优化wiki输出
Solution
1、可否通过添加配置文件的方式定制repoWiki的生成策略,类似以下文件
{
// ==================== 索引配置 ====================
"indexing": {
// 基础扫描目录:指定要分析的项目根目录
"baseDir": "/Users/hongweihu/WebstormProjects/yqg_web_user/projects/yqg-user-v2/app-v2/page/cash-loan-mobile",
// 包含规则:定义哪些文件类型和路径需要被索引
"include": [
"**/*.vue", // 所有Vue组件文件
"**/*.js", // 所有JavaScript文件
"**/router/*.js", // 路由配置文件(重复包含以确保优先级)
"**/store/*.js", // 状态管理文件(重复包含以确保优先级)
"**/component/**/*.vue" // 组件目录下的Vue文件(重复包含以确保优先级)
],
// 排除规则:定义哪些文件和目录不需要索引
"exclude": [
"**/node_modules/**", // 排除依赖包目录
"**/dist/**", // 排除构建输出目录
"**/*.test.js", // 排除单元测试文件
"**/*.spec.js" // 排除测试规范文件
],
// 优先级配置:根据文件重要性分级,影响AI分析深度和token消耗
"priority": {
// 关键文件:深度AI分析(4000 tokens),包含完整上下文和MCP数据
"critical": [
"**/router/router.js", // 路由配置文件 - 应用导航核心
"**/store/store.js", // 状态管理文件 - 数据流核心
"**/main.js" // 应用入口文件 - 启动配置核心
],
// 高优先级:标准AI分析(2000 tokens),包含上下文和MCP数据
"high": [
"**/view/**/*.vue", // 业务页面组件 - 核心业务逻辑
"**/component/**/*.vue", // 通用组件 - 可复用UI组件
"**/mixin/**/*.js" // 混入文件 - 共享逻辑
],
// 中等优先级:摘要分析(1000 tokens),不包含上下文
"medium": [
"**/util/**/*.js", // 工具函数 - 辅助功能
"**/constant/**/*.js" // 常量配置 - 配置数据
],
// 低优先级:跳过AI分析(0 tokens),仅基础索引
"low": [
"**/style/**/*.scss" // 样式文件 - 视觉呈现
]
},
// 采样策略:当目录文件过多时,使用采样减少处理量和成本
"sampling": {
"enabled": true, // 启用采样功能
"threshold": 50, // 触发采样的文件数阈值(超过50个文件)
"sampleSize": 10, // 采样数量(从大目录中选取10个代表性文件)
"strategy": "representative" // 采样策略:代表性采样(均匀分布选择)
}
},
// ==================== 生成配置 ====================
"generation": {
"language": "zh", // 文档生成语言:中文
"includeCodeExamples": true, // 在文档中包含代码示例
"includeDiagrams": true, // 在文档中包含流程图和架构图
// MCP增强配置:集成外部数据源丰富文档内容
"mcpEnhancement": {
"enabled": true, // 启用MCP服务增强
"services": [
"tapd", // TAPD - 需求管理、Bug跟踪
"mock-sigma", // Mock-Sigma - API接口文档
"feishu", // 飞书 - 业务文档、技术方案
"ai-rag" // AI-RAG - 历史知识检索
]
}
},
// ==================== 输出配置 ====================
"output": {
"format": "markdown", // 输出格式:Markdown文档
"destination": ".qoder/repowiki/cash-loan-mobile" // 输出目录:生成的文档存放路径
}
}
2、在repoWiki生成以后,通过多轮对话的方式持续优化wiki
Use Case
When would you use this?
Priority
-
High - Blocking issue -
Medium - Important improvement -
Low - Nice to have
Additional Info
(Optional: screenshots, examples, links)