Import apps/android/src/screens/chat/use-chat-mentions.ts
This commit is contained in:
parent
ab47c1bdd6
commit
5ddc0ac5a2
|
|
@ -0,0 +1,259 @@
|
|||
import { useEffect, useMemo, useRef, useState } from 'react'
|
||||
import { Alert, TextInput } from 'react-native'
|
||||
import { strings } from '../../locales/i18n'
|
||||
import type { SkillEntry } from '../../services/session-tools'
|
||||
import { requireSessionTools } from '../../state/store'
|
||||
import type { RemoteSession, WorkspaceView } from '../../types'
|
||||
import { detectMention, fileMentionText, filterByQuery, maskPersonalPath, sessionMentionText, type MentionGroup, type MentionItem, type MentionType } from '../../ui/mention-popover'
|
||||
import { OfficialMenuIcons } from '../../ui/official-menu-icons'
|
||||
import { resolveSessionDisplayTitle } from '../session-title'
|
||||
import { relativeTime } from './presentation'
|
||||
|
||||
type Options = {
|
||||
session: RemoteSession | undefined
|
||||
sessions: RemoteSession[]
|
||||
workspaces: WorkspaceView[]
|
||||
connectionPhase: string
|
||||
draft: string
|
||||
setDraft: (value: string) => void
|
||||
setPermissionPickerOpen: (value: boolean) => void
|
||||
setModelPickerOpen: (value: boolean) => void
|
||||
}
|
||||
|
||||
export function useChatMentions({ session, sessions, workspaces, connectionPhase, draft, setDraft, setPermissionPickerOpen, setModelPickerOpen }: Options) {
|
||||
// `/` command and `@` reference popover state anchored to the composer cursor.
|
||||
const [mentionType, setMentionType] = useState<MentionType | null>(null)
|
||||
const [mentionQuery, setMentionQuery] = useState('')
|
||||
const [selection, setSelection] = useState({ start: 0, end: 0 })
|
||||
const composerInputRef = useRef<TextInput>(null)
|
||||
const draftRef = useRef(draft)
|
||||
draftRef.current = draft
|
||||
const selectionRef = useRef({ start: 0, end: 0 })
|
||||
/** Start index of the active `/` / `@` trigger inside the draft. */
|
||||
const mentionSpanRef = useRef(0)
|
||||
const [skillCatalog, setSkillCatalog] = useState<SkillEntry[]>()
|
||||
const [skillCatalogFailed, setSkillCatalogFailed] = useState(false)
|
||||
const [workspaceFileRefs, setWorkspaceFileRefs] = useState<WorkspaceFileRef[]>()
|
||||
const [fileListFailed, setFileListFailed] = useState(false)
|
||||
const skillRequestedRef = useRef<string | undefined>(undefined)
|
||||
const filesRequestedRef = useRef<string | undefined>(undefined)
|
||||
// `/` 技能目录与 `@` 文件树按会话懒加载一次;未拉取成功时技能分组回落到内置技能。
|
||||
useEffect(() => {
|
||||
setSkillCatalog(undefined)
|
||||
setSkillCatalogFailed(false)
|
||||
setWorkspaceFileRefs(undefined)
|
||||
setFileListFailed(false)
|
||||
skillRequestedRef.current = undefined
|
||||
filesRequestedRef.current = undefined
|
||||
setMentionType(null)
|
||||
}, [session?.sessionId])
|
||||
useEffect(() => {
|
||||
const sessionId = session?.sessionId
|
||||
if (mentionType === null || sessionId === undefined) return
|
||||
if (session?.backend === 'codex' || session?.backend === 'claude' || session?.backend === 'hermes' || connectionPhase !== 'connected') return
|
||||
if (mentionType === 'command' && skillCatalog === undefined && skillRequestedRef.current !== sessionId) {
|
||||
skillRequestedRef.current = sessionId
|
||||
void Promise.resolve().then(() => requireSessionTools().listSkills(sessionId))
|
||||
.then(rows => { if (skillRequestedRef.current === sessionId) setSkillCatalog(rows) })
|
||||
.catch(() => { if (skillRequestedRef.current === sessionId) setSkillCatalogFailed(true) })
|
||||
}
|
||||
if (mentionType === 'context' && workspaceFileRefs === undefined && filesRequestedRef.current !== sessionId) {
|
||||
filesRequestedRef.current = sessionId
|
||||
void loadWorkspaceFileRefs(sessionId)
|
||||
.then(rows => { if (filesRequestedRef.current === sessionId) setWorkspaceFileRefs(rows) })
|
||||
.catch(() => { if (filesRequestedRef.current === sessionId) setFileListFailed(true) })
|
||||
}
|
||||
}, [mentionType, session?.sessionId, session?.backend, connectionPhase, skillCatalog, workspaceFileRefs])
|
||||
const skillItems: MentionItem[] = useMemo(() => (skillCatalog ?? []).map(row => ({
|
||||
id: `skill:${row.name}`,
|
||||
icon: OfficialMenuIcons.skill,
|
||||
title: row.name,
|
||||
description: row.modelInvocable ? row.description : `${strings.mention.skillUserOnly} · ${row.description}`,
|
||||
onPress: () => insertMentionText(`/${row.name} `),
|
||||
})), [skillCatalog, strings])
|
||||
// 「@」菜单:对话 / 文件 两组,均支持模糊检索。
|
||||
const sessionItems: MentionItem[] = useMemo(() => sessions.filter(item => item.sessionId !== session?.sessionId && item.backend !== 'codex')
|
||||
.sort((a, b) => b.updatedAt - a.updatedAt)
|
||||
.map(item => {
|
||||
const title = resolveSessionDisplayTitle(item) ?? item.title ?? item.sessionId
|
||||
const owner = workspaces.find(workspace => workspace.sessionIds.includes(item.sessionId))
|
||||
return {
|
||||
id: item.sessionId,
|
||||
icon: OfficialMenuIcons.referenceSession,
|
||||
title,
|
||||
description: owner === undefined ? strings.chat.workspaceNone : `${owner.title} · ${maskPersonalPath(owner.path)}`,
|
||||
meta: relativeTime(item.updatedAt),
|
||||
onPress: () => insertMentionText(sessionMentionText(item.sessionId, title)),
|
||||
}
|
||||
}), [session?.sessionId, sessions, workspaces, strings])
|
||||
const fileItems: MentionItem[] = useMemo(() => (workspaceFileRefs ?? []).map(ref => {
|
||||
const isDir = ref.kind === 'directory'
|
||||
const Icon = isDir ? OfficialMenuIcons.referenceFolder : OfficialMenuIcons.referenceFile
|
||||
return {
|
||||
id: ref.path,
|
||||
icon: Icon,
|
||||
title: ref.path,
|
||||
onPress: () => { const mention = fileMentionText(ref.path, isDir); if (mention !== undefined) insertMentionText(mention) },
|
||||
}
|
||||
}), [workspaceFileRefs])
|
||||
|
||||
const applyDraft = (next: string) => {
|
||||
draftRef.current = next
|
||||
setDraft(next)
|
||||
}
|
||||
|
||||
const closeMention = () => setMentionType(null)
|
||||
|
||||
const updateMention = (text: string, cursor: number) => {
|
||||
const detected = detectMention(text, cursor)
|
||||
if (detected === undefined) {
|
||||
setMentionType(null)
|
||||
return
|
||||
}
|
||||
mentionSpanRef.current = detected.start
|
||||
setMentionQuery(detected.query)
|
||||
setMentionType(detected.type)
|
||||
}
|
||||
|
||||
/** Insert the picked command or reference text at the trigger span, keeping the caret behind it (web composer grammar). */
|
||||
const insertMentionText = (text: string) => {
|
||||
const start = mentionSpanRef.current
|
||||
const end = selectionRef.current.end
|
||||
const current = draftRef.current
|
||||
const next = current.slice(0, start) + text + current.slice(end)
|
||||
const cursor = start + text.length
|
||||
applyDraft(next)
|
||||
selectionRef.current = { start: cursor, end: cursor }
|
||||
setSelection({ start: cursor, end: cursor })
|
||||
setMentionType(null)
|
||||
composerInputRef.current?.focus()
|
||||
}
|
||||
|
||||
const onChangeText = (next: string) => {
|
||||
if (next === draftRef.current) return
|
||||
// Keep the tracked caret in step with the edit so the controlled selection
|
||||
// never yanks the cursor; onSelectionChange refines it right afterwards.
|
||||
const delta = next.length - draftRef.current.length
|
||||
applyDraft(next)
|
||||
const cursor = Math.max(0, Math.min(next.length, selectionRef.current.end + delta))
|
||||
selectionRef.current = { start: cursor, end: cursor }
|
||||
setSelection({ start: cursor, end: cursor })
|
||||
updateMention(next, cursor)
|
||||
}
|
||||
|
||||
const onSelectionChange = (event: { nativeEvent: { selection: { start: number; end: number } } }) => {
|
||||
const next = event.nativeEvent.selection
|
||||
if (next.start === selectionRef.current.start && next.end === selectionRef.current.end) return
|
||||
selectionRef.current = next
|
||||
setSelection(next)
|
||||
if (next.start === next.end) updateMention(draftRef.current, next.end)
|
||||
}
|
||||
|
||||
const runSessionExport = () => {
|
||||
setMentionType(null)
|
||||
const sessionId = session?.sessionId
|
||||
if (sessionId === undefined) return
|
||||
void Promise.resolve().then(() => requireSessionTools().executeCommand(sessionId, '/export'))
|
||||
.then(result => {
|
||||
Alert.alert(strings.mention.exportTitle, result.text ?? (result.kind === 'success' ? strings.mention.exportTriggered : strings.mention.exportFailed))
|
||||
})
|
||||
.catch((error: unknown) => {
|
||||
Alert.alert(strings.mention.exportTitle, error instanceof Error && error.message.length > 0 ? error.message : strings.mention.exportFailed)
|
||||
})
|
||||
}
|
||||
|
||||
// 「/」菜单:添加 / 指令 / 技能 三组,动作按 DeepSeek Harness Web 端绑定。
|
||||
const commandAddItems: MentionItem[] = [
|
||||
{ id: 'file', icon: OfficialMenuIcons.file, title: strings.mention.file, description: strings.mention.fileDescription, onPress: () => insertMentionText('/file ') },
|
||||
{ id: 'goal', icon: OfficialMenuIcons.goal, title: strings.mention.goal, description: strings.mention.goalDescription, onPress: () => insertMentionText('/goal ') },
|
||||
{ id: 'plan', icon: OfficialMenuIcons.plan, title: strings.mention.plan, description: strings.mention.planDescription, onPress: () => insertMentionText('/plan ') },
|
||||
{ id: 'feedback', icon: OfficialMenuIcons.feedback, title: strings.mention.feedback, description: strings.mention.feedbackDescription, onPress: () => insertMentionText('/feedback ') },
|
||||
]
|
||||
const commandControlItems: MentionItem[] = [
|
||||
{ id: 'compact', icon: OfficialMenuIcons.compact, title: strings.mention.compact, description: strings.mention.compactDescription, onPress: () => insertMentionText('/compact') },
|
||||
{ id: 'permission', icon: OfficialMenuIcons.permission, title: strings.mention.permission, description: strings.mention.permissionDescription, onPress: () => { setMentionType(null); setPermissionPickerOpen(true) } },
|
||||
{ id: 'model', icon: OfficialMenuIcons.model, title: strings.mention.model, description: strings.mention.modelDescription, onPress: () => { setMentionType(null); setModelPickerOpen(true) } },
|
||||
{ id: 'export', icon: OfficialMenuIcons.export, title: strings.mention.export, description: strings.mention.exportDescription, onPress: runSessionExport },
|
||||
]
|
||||
const mentionTexts = (item: MentionItem) => [item.title, item.description ?? '', item.meta ?? '']
|
||||
const buildMentionGroups = (): MentionGroup[] => {
|
||||
const matching = (items: MentionItem[], limit = 20) => filterByQuery(items, mentionQuery, mentionTexts).slice(0, limit)
|
||||
switch (mentionType) {
|
||||
case 'command': return [
|
||||
{ key: 'add', title: strings.mention.addSection, items: matching(commandAddItems) },
|
||||
{ key: 'commands', title: strings.mention.commandSection, items: matching(commandControlItems) },
|
||||
{
|
||||
key: 'skills',
|
||||
title: strings.mention.skillSection,
|
||||
items: skillCatalog === undefined && skillCatalogFailed
|
||||
? []
|
||||
: matching(skillItems),
|
||||
},
|
||||
]
|
||||
case 'context': return [
|
||||
{ key: 'sessions', title: strings.mention.sessionSection, items: matching(sessionItems) },
|
||||
{
|
||||
key: 'files',
|
||||
title: strings.mention.fileSection,
|
||||
items: fileListFailed ? [] : matching(fileItems, 30),
|
||||
},
|
||||
]
|
||||
default: return []
|
||||
}
|
||||
}
|
||||
const mentionGroups = buildMentionGroups()
|
||||
/** Insert a reference token at the current cursor/selection, adding a leading space if needed. */
|
||||
const insertAtSelection = (text: string) => {
|
||||
const start = Math.max(0, Math.min(draftRef.current.length, selectionRef.current.start))
|
||||
const end = Math.max(start, Math.min(draftRef.current.length, selectionRef.current.end))
|
||||
const before = draftRef.current.slice(0, start)
|
||||
const after = draftRef.current.slice(end)
|
||||
const prefix = before.length > 0 && !/\s$/u.test(before) ? ' ' : ''
|
||||
const inserted = `${prefix}${text}`
|
||||
const next = `${before}${inserted}${after}`
|
||||
const cursor = before.length + inserted.length
|
||||
applyDraft(next)
|
||||
selectionRef.current = { start: cursor, end: cursor }
|
||||
setSelection({ start: cursor, end: cursor })
|
||||
setMentionType(null)
|
||||
composerInputRef.current?.focus()
|
||||
}
|
||||
|
||||
const resetSelection = () => {
|
||||
selectionRef.current = { start: 0, end: 0 }
|
||||
setSelection({ start: 0, end: 0 })
|
||||
}
|
||||
return {
|
||||
composerInputRef, draftRef, mentionType, setMentionType, selection, mentionGroups,
|
||||
applyDraft, closeMention, onChangeText, onSelectionChange, resetSelection, insertAtSelection
|
||||
}
|
||||
}
|
||||
|
||||
interface WorkspaceFileRef {
|
||||
path: string
|
||||
kind: 'file' | 'directory'
|
||||
}
|
||||
|
||||
/** Shallow workspace tree for the `@` file menu: root entries plus one directory level. */
|
||||
async function loadWorkspaceFileRefs(sessionId: string): Promise<WorkspaceFileRef[]> {
|
||||
const tools = requireSessionTools()
|
||||
const refs: WorkspaceFileRef[] = []
|
||||
const root = await tools.listFiles(sessionId, '')
|
||||
const directories = root.entries.filter(entry => entry.type === 'directory' && !entry.name.startsWith('.'))
|
||||
for (const entry of root.entries) {
|
||||
if (entry.name.startsWith('.')) continue
|
||||
refs.push({ path: entry.name, kind: entry.type === 'directory' ? 'directory' : 'file' })
|
||||
}
|
||||
await Promise.all(directories.slice(0, 12).map(async directory => {
|
||||
try {
|
||||
const listing = await tools.listFiles(sessionId, directory.name)
|
||||
for (const entry of listing.entries) {
|
||||
if (entry.name.startsWith('.')) continue
|
||||
refs.push({ path: `${directory.name}/${entry.name}`, kind: entry.type === 'directory' ? 'directory' : 'file' })
|
||||
}
|
||||
} catch {
|
||||
// Unreadable directories are simply absent from the menu.
|
||||
}
|
||||
}))
|
||||
return refs
|
||||
}
|
||||
Loading…
Reference in New Issue