DeepSeek Harness Tauri 桌面版 | Only 8mb installer, zero environment setup, preset plugins, Windows / macOS / Linux.
import type { RuntimeInfo } from '@/types'
import { ArrowRotateRight, ArrowUpRightFromSquare, ChevronRight, CircleInfo, Copy, Power } from '@gravity-ui/icons'
import { Button, Chip, Description, Input, InputGroup, Link, ListBox, Select, Spinner, Switch, Tooltip } from '@heroui/react'
import { useMutation, useQuery } from '@tanstack/react-query'
import { invoke } from '@tauri-apps/api/core'
import { useState } from 'react'
import { useTranslation } from 'react-i18next'
import { If } from 'react-if-lite'
import { useStore } from 'valtio-define'
import { Info } from '@/components/info'
import { Panel } from '@/components/panel'
import { queryKeys } from '@/config/query-keys'
import { useListen } from '@/hooks/use-listen'
import { store } from '@/store'
import { HARNESS_HEAP_MAX_MB, HARNESS_HEAP_MIN_MB } from '@/store/modules/setting'
import { ConfigAutoUpdate } from '@/ui/config/components/auto-update'
import { ConfigCloseAction } from '@/ui/config/components/close-action'
import { ConfigLaunchOnLogin } from '@/ui/config/components/launch-on-login'
import { writeClipboardText } from '@/utils/clipboard'
import { toast } from '@/utils/toast'
export interface CliLinkStatus {
enabled: boolean
shim_exists: boolean
path_registered: boolean
user_dsh_preserved: boolean
bin_dir: string
shim_path: string
}
export interface ProxyTestResult {
ok: boolean
reason: 'invalid' | 'timeout' | 'connect' | 'request' | 'status' | null
status: number | null
latency_ms: number
}
const PROXY_TEST_MESSAGE: Record<string, string> = {
timeout: 'network.test_timeout',
connect: 'network.test_connect',
status: 'network.test_status',
}
export function ConfigDebug() {
const { t, i18n } = useTranslation()
const { serviceRunning, busyAction } = useStore(store.harness)
const { updateInfo } = useStore(store.harnessUpdater)
// 端口编辑态:用户尚未输入时为 undefined,展示值始终以 store 中已保存的端口为准。
// 初值不写入 state(避免渲染期副作用),用户一旦输入即以输入值为准。
const [portInput, setPortInput] = useState<number>()
const [proxyInput, setProxyInput] = useState<string>()
const [heapInput, setHeapInput] = useState<string>()
const { data: info, refetch: refreshInfo } = useQuery({
queryKey: queryKeys.info,
queryFn: () => invoke<RuntimeInfo>('get_runtime_info'),
})
// 设置变更(如端口避让后服务地址变化)会让运行时信息过期,重拉一次
useListen('setting_updated', () => {
void refreshInfo()
})
const { port: savedPort, proxy_url: savedProxy, harness_max_heap_mb: savedHeapMb } = useStore(store.setting)
const port = portInput ?? savedPort
const proxy = proxyInput ?? savedProxy
const heapValue = heapInput ?? String(savedHeapMb ?? '')
/** 空输入代表自动值(null),其余按数字解析,非法值交给保存前的整数校验拦下 */
const parsedHeap = heapValue.trim() === '' ? null : Number(heapValue)
const { data: cliStatus, refetch: refreshCliStatus } = useQuery({
queryKey: queryKeys.cliStatus,
queryFn: () => invoke<CliLinkStatus>('get_cli_link_status'),
})
function handleShowNewVersion() {
store.harnessUpdater.showToast(() => store.harnessUpdater.handleUpdate())
}
const { mutate: onToggleCliLink } = useMutation({
mutationFn: async (enabled: boolean) => {
// 命令会先建/删 shim 与 PATH 再落盘,前端只改 store 不会产生这些副作用
await store.setting.update({ cliLinkEnabled: enabled })
await refreshCliStatus()
},
onError: (err: unknown) => {
console.error('[ConfigDebug] toggle cli link failed:', err)
toast(t('messages.cli_link_failed'), { variant: 'danger' })
},
})
const { mutate: onCopyServiceUrl } = useMutation({
mutationFn: async () => {
await invoke('copy_service_url')
toast(t('messages.copy_success'))
},
onError: (err: unknown) => {
console.error('[ConfigDebug] copy url failed:', err)
toast(t('messages.copy_failed'), { variant: 'danger' })
},
})
const { mutate: onCopyEnvironment, isPending: copyingEnvironment } = useMutation({
mutationFn: async () => {
if (!info)
return
await writeClipboardText([
`${t('ui.current_version')}: ${info.app_version}`,
`${t('ui.dsh_version')}: ${info.dsh_version ?? '-'}`,
`${t('ui.node_version')}: ${info.node_version ? `v${info.node_version}` : '-'}`,
`${t('ui.platform')}: ${info.platform} / ${info.arch}`,
].join('\n'), t('messages.environment_copied'))
},
onError: (err: unknown) => {
console.error('[ConfigDebug] copy environment info failed:', err)
},
})
const { mutate: onSavePort } = useMutation({
mutationFn: async (port: number) => {
// 保存前校验:必须是 1–65535 的整数(输入框可能被清空成 0 / 浮点 / NaN)
if (!Number.isInteger(port) || port < 1 || port > 65535) {
throw new Error('PORT_INVALID')
}
// 后端会同时记录 manual_port(端口避让后回落到用户选择,issue #91)
await store.setting.update({ port })
const key = toast(t('messages.port_changed'), {
variant: 'accent',
description: t('messages.port_restart_hint'),
timeout: 10_000,
actionProps: {
children: t('app.restart'),
onPress: () => {
store.harness.restart()
toast.close(key)
},
},
})
},
onError: (err: unknown) => {
console.error('[ConfigDebug] save port failed:', err)
if (String(err).includes('PORT_INVALID')) {
toast(t('messages.port_invalid'), { variant: 'danger' })
}
else {
toast(t('messages.port_save_failed'), { variant: 'danger' })
}
},
})
const { mutate: onSaveProxy, isPending: savingProxy } = useMutation({
mutationFn: async (value: string) => {
const proxyUrl = value.trim()
if (proxyUrl) {
let url: URL
try {
url = new URL(proxyUrl)
}
catch {
throw new Error('PROXY_INVALID')
}
if (!proxyUrl.includes('://') || /\s/.test(proxyUrl)
|| !['http:', 'https:', 'socks5:', 'socks5h:'].includes(url.protocol)
|| !url.hostname || url.port === '0' || !['', '/'].includes(url.pathname)
|| url.search || url.hash) {
throw new Error('PROXY_INVALID')
}
}
await store.setting.update({ proxyUrl })
return proxyUrl
},
onSuccess: (submitted) => {
// 保存期间用户可能又改了输入:只在输入仍等于本次提交值时才收拢编辑态,
// 否则会把在途的新输入抹掉。
setProxyInput(current => (current !== undefined && current.trim() !== submitted ? current : undefined))
toast(t('network.saved'))
},
onError: (error: unknown) => {
toast(t(String(error).includes('PROXY_INVALID') ? 'network.invalid' : 'network.save_failed'), { variant: 'danger' })
},
})
const { mutate: runProxyTest, isPending: testingProxy } = useMutation({
mutationFn: () => invoke<ProxyTestResult>('test_proxy'),
onSuccess: (result) => {
if (result.ok) {
toast(t('network.test_ok', { ms: result.latency_ms }), { variant: 'success' })
return
}
const key = PROXY_TEST_MESSAGE[result.reason ?? ''] ?? 'network.test_failed'
toast(t(key, { status: result.status ?? '' }), { variant: 'danger' })
},
onError: () => {
toast(t('network.test_failed'), { variant: 'danger' })
},
})
const { mutate: onSaveHeap } = useMutation({
mutationFn: async (mb: number | null) => {
// 空输入 = 交回自动值;Rust 侧把 0 归一化为 None(物理内存一半,见 workflow/heap.rs)
if (mb !== null && (!Number.isInteger(mb) || mb < HARNESS_HEAP_MIN_MB || mb > HARNESS_HEAP_MAX_MB)) {
throw new Error('HEAP_INVALID')
}
await store.setting.update({ harnessMaxHeapMb: mb ?? 0 })
const key = toast(t('messages.heap_changed'), {
variant: 'accent',
description: t('messages.heap_restart_hint'),
timeout: 10_000,
actionProps: {
children: t('app.restart'),
onPress: () => {
store.harness.restart()
toast.close(key)
},
},
})
},
onError: (err: unknown) => {
console.error('[ConfigDebug] save heap limit failed:', err)
if (String(err).includes('HEAP_INVALID')) {
toast(t('messages.heap_invalid'), { variant: 'danger' })
}
else {
toast(t('messages.heap_save_failed'), { variant: 'danger' })
}
},
})
return (
<div className="space-y-3">
<Panel.Header
title={t('config.application')}
testId="dsh-config-panel-title"
action={(
<Button
size="sm"
variant="tertiary"
isDisabled={!info || copyingEnvironment}
onPress={() => onCopyEnvironment()}
>
<If cond={copyingEnvironment} then={<Spinner size="sm" color="current" />} else={<Copy className="size-3.5" />} />
{t('buttons.copy_environment')}
</Button>
)}
/>
<div className="space-y-1.5">
<div className="flex items-center justify-between">
<span className="text-xs font-semibold uppercase tracking-wider text-muted">
{t('ui.connection_status')}
</span>
<Chip
size="sm"
variant="soft"
color={serviceRunning ? 'success' : 'danger'}
className="font-medium"
>
{serviceRunning ? t('ui.running') : t('ui.stopped')}
</Chip>
</div>
<div className="space-y-1.5">
<div className="flex gap-1.5">
<Input
readOnly
variant="secondary"
value={info?.service_url ?? '-'}
aria-label={t('ui.service_url')}
className="font-mono text-xs flex-1"
/>
<Button
size="sm"
variant="ghost"
isIconOnly
onPress={() => onCopyServiceUrl()}
aria-label={t('buttons.copy')}
>
<Copy className="size-3.5" />
</Button>
<Button
size="sm"
variant="ghost"
isIconOnly
onPress={store.harness.openBrowser}
isDisabled={busyAction !== null}
aria-label={t('app.open_browser')}
>
<If cond={busyAction === 'openBrowser'} then={<Spinner size="sm" color="current" />} else={<ArrowUpRightFromSquare className="size-3.5" />} />
</Button>
</div>
</div>
</div>
<div className="flex items-center gap-2">
<If cond={serviceRunning}>
<Button
size="sm"
variant="tertiary"
className="flex-1"
onPress={store.harness.restart}
isDisabled={busyAction !== null}
>
<If cond={busyAction === 'restart'} then={<Spinner size="sm" color="current" />} else={<ArrowRotateRight className="size-3.5" />} />
{t('app.restart')}
</Button>
<Button
size="sm"
variant="danger"
className="flex-1"
onPress={store.harness.shutdown}
isDisabled={busyAction !== null}
>
<If cond={busyAction === 'shutdown'} then={<Spinner size="sm" color="current" />} else={<Power className="size-3.5" />} />
{t('app.shutdown')}
</Button>
</If>
</div>
<div className="border-t border-line/30" />
<div>
<div className="space-y-1">
<Info term={t('ui.current_version')}>{info?.app_version ?? '-'}</Info>
<Info term={t('ui.dsh_version')}>
<span>{info?.dsh_version ?? '-'}</span>
<If cond={updateInfo}>
<Link className="ml-2 text-[10px] text-info" onClick={handleShowNewVersion}>
{t('menu.new_version')}
<ChevronRight className="scale-75" />
</Link>
</If>
</Info>
<Info term={t('ui.node_version')}>{info?.node_version ? `v${info.node_version}` : '-'}</Info>
<Info term={t('ui.platform')}>
{info ? `${info.platform} / ${info.arch}` : '-'}
</Info>
</div>
</div>
<div className="border-t border-line/30" />
<div className="space-y-1.5">
<ConfigAutoUpdate />
<ConfigLaunchOnLogin />
<ConfigCloseAction />
<div className="flex items-center justify-between">
<span className="text-xs font-medium text-ink">{t('ui.language')}</span>
<Select
variant="secondary"
selectedKey={i18n.language}
onSelectionChange={key => i18n.changeLanguage(String(key))}
className="w-[80px]"
aria-label={t('ui.language')}
>
<Select.Trigger data-testid="dsh-config-language-select" className="min-h-8! h-8 py-0 items-center">
<Select.Value />
<Select.Indicator />
</Select.Trigger>
<Select.Popover>
<ListBox>
<ListBox.Item data-testid="dsh-config-language-option-zh" className="min-h-8!" id="zh-CN" textValue={t('ui.languages.zh')}>{t('ui.languages.zh')}</ListBox.Item>
<ListBox.Item data-testid="dsh-config-language-option-en" className="min-h-8!" id="en-US" textValue={t('ui.languages.en')}>{t('ui.languages.en')}</ListBox.Item>
<ListBox.Item data-testid="dsh-config-language-option-ko" className="min-h-8!" id="ko-KR" textValue={t('ui.languages.ko')}>{t('ui.languages.ko')}</ListBox.Item>
</ListBox>
</Select.Popover>
</Select>
</div>
<div className="border-t border-line/30" />
<div className="flex items-center justify-between gap-2">
<span className="flex items-center gap-1 text-xs font-medium text-ink">
{t('network.proxy_url')}
<Tooltip delay={0}>
<Button isIconOnly size="sm" variant="ghost" className="size-5 text-muted" aria-label={t('network.description')}>
<CircleInfo className="size-3.5" />
</Button>
<Tooltip.Content className="max-w-[320px]">{`${t('network.description')} ${t('network.formats')}`}</Tooltip.Content>
</Tooltip>
</span>
<div className="flex items-center gap-1.5">
<Input
type="text"
autoComplete="off"
spellCheck={false}
variant="secondary"
value={proxy}
placeholder="http://127.0.0.1:7897"
onChange={e => setProxyInput(e.target.value)}
className="w-52 h-8"
aria-label={t('network.proxy_url')}
data-testid="dsh-proxy-url"
/>
<Tooltip delay={0}>
<Button
size="sm"
variant="secondary"
className="h-8"
onPress={() => {
// 测试只针对已保存的配置:输入框里有未保存的修改时先保存,避免测到旧值
if (proxy === savedProxy) {
runProxyTest()
return
}
onSaveProxy(proxy, { onSuccess: () => runProxyTest() })
}}
isDisabled={testingProxy || savingProxy || proxy.trim() === ''}
data-testid="dsh-proxy-test"
>
<If cond={testingProxy} then={<Spinner size="sm" color="current" />} else={t('network.test')} />
</Button>
<Tooltip.Content className="max-w-[320px]">{t('network.test_hint')}</Tooltip.Content>
</Tooltip>
<Button
size="sm"
variant="primary"
className="h-8"
onPress={() => onSaveProxy(proxy)}
isDisabled={proxy === savedProxy}
data-testid="dsh-proxy-save"
>
{t('buttons.save')}
</Button>
</div>
</div>
<div className="flex items-center justify-between gap-2">
<span className="text-xs font-medium text-ink">{t('ui.port')}</span>
<div className="flex items-center gap-1.5">
<Input
type="number"
variant="secondary"
value={String(port)}
onChange={e => setPortInput(Number(e.target.value))}
className="w-24 h-8 [appearance:textfield] [&::-webkit-outer-spin-button]:appearance-none [&::-webkit-inner-spin-button]:appearance-none"
aria-label={t('ui.port')}
/>
<Button
size="sm"
variant="primary"
className="h-8"
onPress={() => onSavePort(port)}
>
{t('buttons.save')}
</Button>
</div>
</div>
<div className="flex items-center justify-between gap-2">
<span className="text-xs font-medium text-ink">{t('ui.heap_limit')}</span>
<div className="flex items-center gap-1.5">
<InputGroup variant="secondary" className="w-24 h-8 min-h-8!">
<InputGroup.Input
type="number"
value={heapValue}
placeholder={t('ui.heap_limit_auto')}
onChange={e => setHeapInput(e.target.value)}
className="min-w-0 py-0 [appearance:textfield] [&::-webkit-outer-spin-button]:appearance-none [&::-webkit-inner-spin-button]:appearance-none"
aria-label={t('ui.heap_limit')}
data-testid="dsh-config-heap-input"
/>
<InputGroup.Suffix className="px-1.5" data-testid="dsh-config-heap-unit">MB</InputGroup.Suffix>
</InputGroup>
<Button
size="sm"
variant="primary"
className="h-8"
onPress={() => onSaveHeap(parsedHeap)}
>
{t('buttons.save')}
</Button>
</div>
</div>
<div className="border-t border-line/30" />
<div>
<div className="flex items-center justify-between">
<span className="flex items-center gap-1 text-xs font-medium text-ink">
{t('ui.cli_link_enabled')}
<Tooltip delay={0}>
<Button isIconOnly size="sm" variant="ghost" className="size-5 text-muted" aria-label={t('ui.cli_link_hint')}>
<CircleInfo className="size-3.5" />
</Button>
<Tooltip.Content>{t('ui.cli_link_hint')}</Tooltip.Content>
</Tooltip>
</span>
<Switch
isSelected={cliStatus?.enabled ?? false}
onChange={onToggleCliLink}
aria-label={t('ui.cli_link_enabled')}
>
<Switch.Content>
<Switch.Control>
<Switch.Thumb />
</Switch.Control>
</Switch.Content>
</Switch>
</div>
<If cond={cliStatus != null}>
<div className="flex flex-col">
<If
cond={!cliStatus?.user_dsh_preserved}
else={<Description className="text-[10px] text-muted/70">{t('ui.cli_link_user_dsh_preserved')}</Description>}
>
<Description className="text-[10px] text-muted/70">{cliStatus?.bin_dir}</Description>
</If>
</div>
</If>
</div>
</div>
</div>
)
}