fix: reset to v0.6.4 & add skeleton api & lock fix

Author: wantWhatBike

internal/dto/backend.go

@@ -225,7 +225,7 @@ type FileSkeletonData struct {
 	Elements  []*FileSkeletonElement `json:"elements"`
 }
 
-// FileSkeletonImport 导入信息（还原后的原始内容）
+// FileSkeletonImport 导入信息
 type FileSkeletonImport struct {
 	Content string `json:"content"` // 原始导入语句
 	Range   []int  `json:"range"`   // [startLine, startCol, endLine, endCol] - 从1开始

internal/handler/backend.go

@@ -318,3 +318,36 @@ func (h *BackendHandler) ReadCodeSnippets(c *gin.Context) {
 	}
 	response.OkJson(c, list)
 }
+
+// GetFileSkeleton 获取文件骨架信息
+// @Summary 获取文件骨架
+// @Description 获取文件的骨架信息，包括导入、包、元素等
+// @Tags files
+// @Accept json
+// @Produce json
+// @Param clientId query string true "用户机器ID"
+// @Param workspacePath query string true "工作区绝对路径"
+// @Param filePath query string true "文件路径"
+// @Param filteredBy query string false "过滤类型：definition | reference"
+// @Success 200 {object} response.Response{data=dto.FileSkeletonData} "成功"
+// @Failure 400 {object} response.Response "请求参数错误"
+// @Failure 500 {object} response.Response "服务器内部错误"
+// @Router /codebase-indexer/api/v1/files/skeleton [get]
+func (h *BackendHandler) GetFileSkeleton(c *gin.Context) {
+	var req dto.GetFileSkeletonRequest
+	if err := c.ShouldBindQuery(&req); err != nil {
+		h.logger.Error("invalid request format: %v", err)
+		response.Error(c, http.StatusBadRequest, err)
+		return
+	}
+
+	h.logger.Info("get file skeleton request: ClientId=%s, Workspace=%s, FilePath=%s", req.ClientId, req.WorkspacePath, req.FilePath)
+
+	skeleton, err := h.codebaseService.GetFileSkeleton(c, &req)
+	if err != nil {
+		h.logger.Error("get file skeleton err: %v", err)
+		response.Error(c, http.StatusBadRequest, err)
+		return
+	}
+	response.OkJson(c, skeleton)
+}

internal/server/backend.go

@@ -17,6 +17,7 @@ func SetupBackendRoutes(router *gin.Engine, backendHandler *handler.BackendHandl
 		api.GET("/search/reference", AuthMiddleware(logger), BackendRateLimitMiddleware(logger), backendHandler.SearchReference)
 		api.GET("/search/definition", AuthMiddleware(logger), BackendRateLimitMiddleware(logger), backendHandler.SearchDefinition)
 		api.GET("/files/content", AuthMiddleware(logger), BackendRateLimitMiddleware(logger), backendHandler.GetFileContent)
+		api.GET("/files/skeleton", AuthMiddleware(logger), BackendRateLimitMiddleware(logger), backendHandler.GetFileSkeleton)
 		api.POST("/snippets/read", AuthMiddleware(logger), BackendRateLimitMiddleware(logger), backendHandler.ReadCodeSnippets)
 		api.GET("/codebases/directory", AuthMiddleware(logger), BackendRateLimitMiddleware(logger), backendHandler.GetCodebaseDirectory)
 		api.GET("/files/structure", AuthMiddleware(logger), BackendRateLimitMiddleware(logger), backendHandler.GetFileStructure)

internal/service/codebase.go

@@ -64,6 +64,9 @@ type CodebaseService interface {
 	DeleteIndex(ctx context.Context, req *dto.DeleteIndexRequest) error
 	ExportIndex(c *gin.Context, d *dto.ExportIndexRequest) error
 	ReadCodeSnippets(c *gin.Context, d *dto.ReadCodeSnippetsRequest) (*dto.CodeSnippetsData, error)
+
+	// GetFileSkeleton 获取文件骨架信息
+	GetFileSkeleton(ctx context.Context, req *dto.GetFileSkeletonRequest) (*dto.FileSkeletonData, error)
 }
 
 const maxReadLine = 5000
@@ -683,13 +686,49 @@ func convertStatus(status int) string {
 	return indexStatus
 }
 
+func (s *codebaseService) GetFileSkeleton(ctx context.Context, req *dto.GetFileSkeletonRequest) (*dto.FileSkeletonData, error) {
+	// 1. 参数校验
+	if req.WorkspacePath == "" || req.FilePath == "" {
+		return nil, errs.NewMissingParamError("workspacePath or filePath")
+	}
+
+	// 2. 路径处理（相对/绝对）
+	filePath := req.FilePath
+	if !filepath.IsAbs(filePath) {
+		filePath = filepath.Join(req.WorkspacePath, filePath)
+	}
+
+	// 验证路径是否在 workspace 内
+	if err := s.checkPath(ctx, req.WorkspacePath, []string{filePath}); err != nil {
+		return nil, err
+	}
+
+	// 3. 获取原始 FileElementTable
+	table, err := s.indexer.GetFileElementTable(ctx, req.WorkspacePath, filePath)
+	if err != nil {
+		return nil, fmt.Errorf("failed to get file element table: %w", err)
+	}
+
+	// 4. 读取文件内容（用于提取签名和还原imports）
+	fileContent, err := s.workspaceReader.ReadFile(ctx, filePath, types.ReadOptions{})
+	if err != nil {
+		s.logger.Warn("failed to read file content for %s: %v", filePath, err)
+		fileContent = nil // 继续处理，但签名和imports还原会失败
+	}
+
+	// 5. 转换数据结构
+	result := convertToFileSkeletonData(table, fileContent, req.FilteredBy)
+
+	return result, nil
+}
+
 // convertToFileSkeletonData 转换 FileElementTable 到 FileSkeletonData
 func convertToFileSkeletonData(
 	table *codegraphpb.FileElementTable,
 	fileContent []byte,
 	filteredBy string,
 ) *dto.FileSkeletonData {
-	// 按行分割文件内容（KISS原则）
+	// 按行分割文件内容
 	var lines []string
 	if fileContent != nil {
 		lines = strings.Split(string(fileContent), "\n")

internal/service/indexer.go

@@ -71,6 +71,9 @@ type Indexer interface {
 
 	// IndexIter 获取索引迭代器
 	IndexIter(ctx context.Context, projectUuid string) store.Iterator
+
+	// GetFileElementTable 获取文件元素表
+	GetFileElementTable(ctx context.Context, workspacePath string, filePath string) (*codegraphpb.FileElementTable, error)
 }
 
 // indexer 代码索引器
@@ -2237,6 +2240,15 @@ func (i *indexer) RenameIndexes(ctx context.Context, workspacePath string, sourc
 	return nil
 }
 
+// GetFileElementTable 通过工作区路径和文件路径获取FileElementTable（公开方法）
+func (i *indexer) GetFileElementTable(ctx context.Context, workspacePath string, filePath string) (*codegraphpb.FileElementTable, error) {
+	project, err := i.GetProjectByFilePath(ctx, workspacePath, filePath)
+	if err != nil {
+		return nil, err
+	}
+	return i.getFileElementTableByPath(ctx, project.Uuid, filePath)
+}
+
 // getFileElementTableByPath 通过路径获取FileElementTable
 func (i *indexer) getFileElementTableByPath(ctx context.Context, projectUuid string, filePath string) (*codegraphpb.FileElementTable, error) {
 	language, err := lang.InferLanguage(filePath)