@muyichengshayu/promptx 0.2.17 → 0.2.19

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.2.19
+
+- 工作台 Response 卡片新增图片导出预览：右上角“图片”按钮会按 640px 版式生成 2x 高清 PNG，并在弹窗中展示，方便 PC 右键或手机长按保存、复制和转发。
+- 优化导出图片的移动端可读性：生成图片时会使用导出专用排版，表格和代码块不再横向滚动导致截图不全；宽表和长代码会自动换行，优先保证内容完整。
+- 收敛移动端消息卡片工具栏：Prompt / Response 卡片的“查看”“插入”“图片”等按钮在小屏下只保留图标，桌面端继续显示文字，避免按钮文案被挤成竖排。
+
+## 0.2.18
+
+- 源码浏览新增行作者提示：查看代码时默认启用 Git blame，鼠标悬停到源码行会在本行下方靠右显示最近修改作者、提交摘要、短 hash 与时间；非 Git 仓库、未跟踪文件、大文件和二进制文件会平稳降级为不可用提示。
+
 ## 0.2.17
 
 - 修复 Windows 上 Codex 任务实际完成后工作台仍显示运行中、任务卡片持续转圈的问题：runner 在收到 `turn.completed` 后会进入短暂收尾等待；如果 Codex 子进程没有及时退出，会按完成状态落库并回收子进程，避免成功任务长时间卡在 `running`。

package/apps/server/src/codexRoutes.js

@@ -74,6 +74,7 @@ function registerCodexRoutes(app, options = {}) {
     listTaskSlugsByCodexSessionId = () => [],
     listWorkspaceSuggestions,
     listWorkspaceTree,
+    readWorkspaceFileBlame,
     readWorkspaceFileContent,
     resetPromptxCodexSession = () => null,
     runDispatchService,
@@ -173,6 +174,17 @@ function registerCodexRoutes(app, options = {}) {
     })
   })
 
+  app.get('/api/codex/sessions/:sessionId/files/blame', async (request, reply) => {
+    const session = getPromptxCodexSessionById(request.params.sessionId)
+    if (!session) {
+      return reply.code(404).send({ messageKey: 'errors.sessionNotFound', message: '没有找到对应的 PromptX 项目。' })
+    }
+
+    return readWorkspaceFileBlame(session.cwd, {
+      path: request.query?.path,
+    })
+  })
+
   app.get('/api/codex/sessions/:sessionId/files/content-search', async (request, reply) => {
     const session = getPromptxCodexSessionById(request.params.sessionId)
     if (!session) {

package/apps/server/src/index.js

@@ -55,6 +55,7 @@ import { listKnownSessionsByEngine, listKnownWorkspacesByEngine } from './agents
 import {
   listDirectoryPickerTree,
   readWorkspaceFileContent,
+  readWorkspaceFileBlame,
   listWorkspaceTree,
   searchDirectoryPickerEntries,
   searchWorkspaceFileContent,
@@ -434,6 +435,7 @@ registerCodexRoutes(app, {
   listTaskSlugsByCodexSessionId,
   listWorkspaceSuggestions: workspaceSuggestionService.listWorkspaceSuggestions,
   listWorkspaceTree,
+  readWorkspaceFileBlame,
   readWorkspaceFileContent,
   resetPromptxCodexSession,
   runDispatchService,

package/apps/server/src/workspaceFiles.js

@@ -1,6 +1,7 @@
 import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
+import { spawnSync } from 'node:child_process'
 import { createApiError } from './apiErrors.js'
 
 const WORKSPACE_HIDDEN_DIRECTORY_NAMES = new Set([
@@ -41,6 +42,8 @@ const DEFAULT_CONTENT_SEARCH_LIMIT = 80
 const MAX_SEARCH_VISITS = 20000
 const DIRECTORY_PICKER_LIMIT = 240
 const DEFAULT_FILE_PREVIEW_LIMIT = 200 * 1024
+const DEFAULT_FILE_BLAME_LINE_LIMIT = Math.max(200, Number(process.env.PROMPTX_FILE_BLAME_LINE_LIMIT) || 5000)
+const DEFAULT_FILE_BLAME_TIMEOUT_MS = Math.max(500, Number(process.env.PROMPTX_FILE_BLAME_TIMEOUT_MS) || 6000)
 const MAX_IMAGE_PREVIEW_BYTES = 2 * 1024 * 1024
 const MAX_CONTENT_SEARCH_FILE_BYTES = 1024 * 1024
 const MAX_CONTENT_MATCHES_PER_FILE = 20
@@ -155,6 +158,17 @@ function createHttpError(message, statusCode = 400) {
   return createApiError('', message, statusCode)
 }
 
+function createWorkspaceUnavailablePayload(target, reason = '', message = '') {
+  return {
+    cwd: target.root,
+    path: target.relativePath,
+    supported: false,
+    reason: String(reason || 'unavailable').trim() || 'unavailable',
+    message: String(message || '').trim(),
+    items: [],
+  }
+}
+
 function toPosixPath(value = '') {
   return String(value || '').replace(/\\/g, '/')
 }
@@ -216,6 +230,25 @@ function resolveWorkspaceTarget(workspacePath, relativePath = '') {
   }
 }
 
+function runGit(workspacePath = '', args = [], options = {}) {
+  const result = spawnSync('git', ['-C', workspacePath, ...args], {
+    encoding: 'utf8',
+    maxBuffer: 12 * 1024 * 1024,
+    timeout: DEFAULT_FILE_BLAME_TIMEOUT_MS,
+    windowsHide: true,
+    ...options,
+  })
+
+  return {
+    status: typeof result.status === 'number' ? result.status : 1,
+    stdout: String(result.stdout || ''),
+    stderr: String(result.stderr || ''),
+    signal: String(result.signal || ''),
+    errorCode: String(result.error?.code || ''),
+    timedOut: String(result.error?.code || '') === 'ETIMEDOUT',
+  }
+}
+
 function getPathType(absolutePath = '') {
   try {
     const stats = fs.statSync(absolutePath)
@@ -232,6 +265,78 @@ function getPathType(absolutePath = '') {
   return ''
 }
 
+function getFileLineCount(absolutePath = '') {
+  const content = fs.readFileSync(absolutePath, 'utf8').replace(/\r\n/g, '\n')
+  return content ? content.split('\n').length : 0
+}
+
+function parseGitBlamePorcelain(output = '') {
+  const items = []
+  const commitMeta = new Map()
+  let current = null
+
+  String(output || '').replace(/\r\n/g, '\n').split('\n').forEach((line) => {
+    const headerMatch = line.match(/^([0-9a-f]{40})\s+\d+\s+(\d+)(?:\s+\d+)?$/i)
+    if (headerMatch) {
+      const commit = headerMatch[1]
+      const lineNumber = Number(headerMatch[2]) || 0
+      const cached = commitMeta.get(commit) || {}
+      current = {
+        line: lineNumber,
+        commit,
+        author: cached.author || '',
+        authorMail: cached.authorMail || '',
+        authorTime: cached.authorTime || '',
+        summary: cached.summary || '',
+      }
+      return
+    }
+
+    if (!current) {
+      return
+    }
+
+    if (line.startsWith('author ')) {
+      current.author = line.slice('author '.length)
+      return
+    }
+    if (line.startsWith('author-mail ')) {
+      current.authorMail = line.slice('author-mail '.length).replace(/^<|>$/g, '')
+      return
+    }
+    if (line.startsWith('author-time ')) {
+      const timestamp = Number(line.slice('author-time '.length)) || 0
+      current.authorTime = timestamp > 0 ? new Date(timestamp * 1000).toISOString() : ''
+      return
+    }
+    if (line.startsWith('summary ')) {
+      current.summary = line.slice('summary '.length)
+      return
+    }
+
+    if (line.startsWith('\t')) {
+      if (current.line > 0) {
+        const meta = {
+          author: current.author,
+          authorMail: current.authorMail,
+          authorTime: current.authorTime,
+          summary: current.summary,
+        }
+        commitMeta.set(current.commit, meta)
+        items.push({
+          line: current.line,
+          commit: current.commit,
+          shortCommit: current.commit.slice(0, 8),
+          ...meta,
+        })
+      }
+      current = null
+    }
+  })
+
+  return items.sort((left, right) => left.line - right.line)
+}
+
 function shouldIgnoreDirectory(entry) {
   return entry?.isDirectory?.() && WORKSPACE_HIDDEN_DIRECTORY_NAMES.has(entry.name)
 }
@@ -1025,6 +1130,71 @@ export function readWorkspaceFileContent(workspacePath, options = {}) {
   }
 }
 
+export function readWorkspaceFileBlame(workspacePath, options = {}) {
+  const target = resolveWorkspaceTarget(workspacePath, options.path)
+
+  let stats
+  try {
+    stats = fs.statSync(target.absolutePath)
+  } catch {
+    throw createApiError('errors.fileNotFound', '文件不存在。', 404)
+  }
+
+  if (!stats.isFile()) {
+    throw createApiError('errors.fileOnly', '只能读取文件内容。')
+  }
+
+  if (stats.size > DEFAULT_FILE_PREVIEW_LIMIT) {
+    return createWorkspaceUnavailablePayload(target, 'too_large', '文件较大，暂不加载行作者信息。')
+  }
+
+  const previewBuffer = readFileSlice(target.absolutePath, Math.min(stats.size, DEFAULT_FILE_PREVIEW_LIMIT))
+  const extension = path.extname(path.basename(target.absolutePath)).toLowerCase()
+  const isKnownTextFile = TEXT_FILE_EXTENSIONS.has(extension)
+  if (!isKnownTextFile && isLikelyBinaryBuffer(previewBuffer)) {
+    return createWorkspaceUnavailablePayload(target, 'binary', '当前文件为二进制内容，暂不加载行作者信息。')
+  }
+
+  const fileLineCount = getFileLineCount(target.absolutePath)
+  if (fileLineCount > DEFAULT_FILE_BLAME_LINE_LIMIT) {
+    return createWorkspaceUnavailablePayload(target, 'too_many_lines', '文件行数较多，暂不加载行作者信息。')
+  }
+
+  const gitCheck = runGit(target.root, ['rev-parse', '--is-inside-work-tree'])
+  if (gitCheck.status !== 0 || String(gitCheck.stdout || '').trim() !== 'true') {
+    return createWorkspaceUnavailablePayload(target, 'not_git', '当前目录不是 Git 仓库。')
+  }
+
+  const blame = runGit(target.root, [
+    'blame',
+    '--line-porcelain',
+    '--',
+    target.relativePath,
+  ])
+
+  if (blame.timedOut) {
+    return createWorkspaceUnavailablePayload(target, 'timeout', '行作者信息加载超时。')
+  }
+
+  if (blame.status !== 0) {
+    const stderr = String(blame.stderr || '').trim()
+    if (/no such path|no such file|not in HEAD|fatal: no such/i.test(stderr)) {
+      return createWorkspaceUnavailablePayload(target, 'untracked', '当前文件尚未被 Git 跟踪。')
+    }
+
+    return createWorkspaceUnavailablePayload(target, 'failed', stderr || '行作者信息加载失败。')
+  }
+
+  return {
+    cwd: target.root,
+    path: target.relativePath,
+    supported: true,
+    reason: '',
+    message: '',
+    items: parseGitBlamePorcelain(blame.stdout),
+  }
+}
+
 export function listDirectoryPickerTree(options = {}) {
   const isRootRequest = !String(options.path || '').trim()
   const targetPath = normalizeDirectoryPickerPath(options.path) || getDirectoryPickerHomePath()

package/apps/server/src/workspaceFiles.test.js

@@ -1,4 +1,5 @@
 import assert from 'node:assert/strict'
+import { execFileSync } from 'node:child_process'
 import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
@@ -7,12 +8,20 @@ import test from 'node:test'
 import {
   listDirectoryPickerTree,
   listWorkspaceTree,
+  readWorkspaceFileBlame,
   readWorkspaceFileContent,
   searchWorkspaceFileContent,
   searchWorkspaceEntries,
   searchDirectoryPickerEntries,
 } from './workspaceFiles.js'
 
+function git(cwd, args = []) {
+  return execFileSync('git', ['-C', cwd, ...args], {
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
+  }).trim()
+}
+
 test('listDirectoryPickerTree returns filesystem roots when path is empty', () => {
   const payload = listDirectoryPickerTree()
 
@@ -277,3 +286,42 @@ test('readWorkspaceFileContent marks binary files', () => {
   assert.equal(payload.binary, true)
   assert.equal(payload.content, '')
 })
+
+test('readWorkspaceFileBlame returns author metadata per source line', () => {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'promptx-workspace-blame-'))
+  const sourcePath = path.join(tempDir, 'src', 'main.js')
+
+  fs.mkdirSync(path.dirname(sourcePath), { recursive: true })
+  fs.writeFileSync(sourcePath, 'const answer = 42\nconsole.log(answer)\n', 'utf8')
+  git(tempDir, ['init'])
+  git(tempDir, ['config', 'user.email', 'promptx@example.com'])
+  git(tempDir, ['config', 'user.name', 'PromptX'])
+  git(tempDir, ['add', 'src/main.js'])
+  git(tempDir, ['commit', '-m', 'initial source'])
+
+  const payload = readWorkspaceFileBlame(tempDir, {
+    path: 'src/main.js',
+  })
+
+  assert.equal(payload.supported, true)
+  assert.equal(payload.path, 'src/main.js')
+  assert.equal(payload.items.length, 2)
+  assert.equal(payload.items[0].line, 1)
+  assert.equal(payload.items[0].author, 'PromptX')
+  assert.equal(payload.items[0].authorMail, 'promptx@example.com')
+  assert.equal(payload.items[0].summary, 'initial source')
+  assert.equal(payload.items[0].shortCommit.length, 8)
+})
+
+test('readWorkspaceFileBlame returns unavailable payload outside git repository', () => {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'promptx-workspace-blame-nongit-'))
+  fs.writeFileSync(path.join(tempDir, 'note.txt'), 'hello\n', 'utf8')
+
+  const payload = readWorkspaceFileBlame(tempDir, {
+    path: 'note.txt',
+  })
+
+  assert.equal(payload.supported, false)
+  assert.equal(payload.reason, 'not_git')
+  assert.deepEqual(payload.items, [])
+})