feat(devins-lang): enhance usage command output with file path and line number #358

- Add file path and line number information to the usage command output
- Improve the readability and usefulness of the command result
- Update usage command example in toolExamples

Author: phodal

exts/devins-lang/src/main/kotlin/cc/unitmesh/devti/language/compiler/exec/UsageInsCommand.kt

@@ -5,8 +5,14 @@ import cc.unitmesh.devti.devin.dataprovider.BuiltinCommand
 import cc.unitmesh.devti.language.compiler.error.DEVINS_ERROR
 import cc.unitmesh.devti.provider.RelatedClassesProvider
 import cc.unitmesh.devti.provider.devins.DevInsSymbolProvider
+import cc.unitmesh.devti.util.relativePath
 import com.intellij.openapi.application.runReadAction
 import com.intellij.openapi.project.Project
+import com.intellij.psi.PsiNamedElement
+import com.intellij.psi.PsiElement
+import com.intellij.psi.PsiFile
+import com.intellij.openapi.editor.Document
+import com.intellij.psi.PsiDocumentManager
 
 class UsageInsCommand(val myProject: Project, private val symbol: String) : InsCommand {
     override val commandName: BuiltinCommand = BuiltinCommand.RELATED
@@ -24,8 +30,25 @@ class UsageInsCommand(val myProject: Project, private val symbol: String) : InsC
 
         if (psiElements.isEmpty()) return "$DEVINS_ERROR: No usage found for $symbol"
 
-        return "Here is related to $symbol usage" + psiElements.joinToString("\n\n") {
-            runReadAction { it.text }
+        return "Here is related to $symbol usage:\n\n" + psiElements.joinToString("\n\n") { element: PsiNamedElement ->
+            runReadAction { 
+                val (filePath, lineRange) = getFileAndLineInfo(element)
+                "Follow code from $filePath (line $lineRange):\n${element.text}"
+            }
         }
     }
+    
+    private fun getFileAndLineInfo(element: PsiElement): Pair<String, String> {
+        val containingFile = element.containingFile
+        val virtualFile = containingFile.virtualFile
+        val filePath = virtualFile?.relativePath(myProject) ?: "unknown file"
+        
+        val document = PsiDocumentManager.getInstance(myProject).getDocument(containingFile)
+        val startLine = document?.getLineNumber(element.textRange.startOffset)?.plus(1) ?: 0
+        val endLine = document?.getLineNumber(element.textRange.endOffset)?.plus(1) ?: 0
+        
+        val lineRange = if (startLine == endLine) "$startLine" else "$startLine-$endLine"
+
+        return Pair(filePath, lineRange)
+    }
 }

exts/devins-lang/src/main/resources/agent/toolExamples/usage.devin

@@ -1 +1,3 @@
-/usage:cc.unitmesh.untitled.demo.service.BlogService.createBlog
+Query usage of some method, should use following format: <package>.<class>.<method>
+/usage:cc.unitmesh.untitled.demo.service.BlogService.createBlog
+the return include file path, usage's method (caller) text.

exts/ext-vue/src/233/main/kotlin/cc/unitmesh/vue/provider/VueRelatedClassProvider.kt

@@ -134,11 +134,9 @@ class VueRelatedClassProvider : RelatedClassesProvider {
     private fun symbolLocationFromPropertySignature(property: TypeScriptPropertySignature): WebTypesSymbolLocation? {
         if (!property.isValid) return null
 
-        // TypeScript GlobalComponents definition
         val symbolName = property.memberName.takeIf { it.isNotEmpty() }
             ?: return null
 
-        // Locate module
         val packageName =
             property.containingFile?.originalFile?.virtualFile?.let { PackageJsonUtil.findUpPackageJson(it) }
                 ?.let { PackageJsonData.getOrCreate(it) }