hololake-system-architecture/product-source/guanghu-knowledge-base/src/components/SearchBar.tsx
冰朔 ecfeca40e2 feat(product-source): 光湖知识库模块 v0.1.0 — Git 驱动的完整知识库系统
铸渊 2026-08-08 开发,冰朔架构决策:
- Git 是底层引擎,不依赖任何数据库(PostgreSQL/Redis/ORM)
- Agent 直达底层,中间不隔第三方服务
- 拆解 Outline v0.80.2 为参考样本,光湖自己实现全部能力

技术栈:
- 后端:Express v5 + simple-git + gray-matter(Git 操作层)
- 前端:Vite + React 19 + TypeScript + marked
- 存储:Markdown 文件 + Git 仓库(commit=版本历史,diff=对比)

功能清单(全部可用):
- 文档 CRUD(创建/读取/更新/删除/移动)
- 文档树导航(文件夹层级)
- Markdown 编辑器(编辑/预览双栏)
- 全文搜索(防抖 + 下拉结果)
- 版本历史(git log)
- 版本 diff 对比(选择两个 commit 对比)

API 端点(Agent 和 UI 共用):
- GET/POST/PUT/DELETE /api/docs/{*path}
- GET /api/tree
- GET /api/history/{*path}
- GET /api/version/:hash/{*path}
- GET /api/diff/{*path}?from=&to=
- GET /api/search?q=
- POST /api/move
- GET /api/health
2026-08-08 07:09:54 +08:00

99 lines
2.8 KiB
TypeScript

import { useState, useRef, useEffect } from 'react';
import { api, SearchResult } from '../api';
interface Props {
onSelect: (path: string) => void;
}
export function SearchBar({ onSelect }: Props) {
const [query, setQuery] = useState('');
const [results, setResults] = useState<SearchResult[]>([]);
const [open, setOpen] = useState(false);
const [loading, setLoading] = useState(false);
const timerRef = useRef<ReturnType<typeof setTimeout>>();
const containerRef = useRef<HTMLDivElement>(null);
// 防抖搜索
useEffect(() => {
if (!query.trim()) {
setResults([]);
setOpen(false);
return;
}
clearTimeout(timerRef.current);
timerRef.current = setTimeout(async () => {
setLoading(true);
try {
const r = await api.search(query);
setResults(r);
setOpen(true);
} catch {
setResults([]);
} finally {
setLoading(false);
}
}, 300);
return () => clearTimeout(timerRef.current);
}, [query]);
// 点击外部关闭
useEffect(() => {
const handler = (e: MouseEvent) => {
if (containerRef.current && !containerRef.current.contains(e.target as Node)) {
setOpen(false);
}
};
document.addEventListener('mousedown', handler);
return () => document.removeEventListener('mousedown', handler);
}, []);
return (
<div className="kb-search" ref={containerRef}>
<div className="kb-search-input-wrap">
<span className="kb-search-icon">🔍</span>
<input
className="kb-search-input"
type="text"
value={query}
onChange={e => setQuery(e.target.value)}
placeholder="搜索文档..."
onFocus={() => results.length > 0 && setOpen(true)}
/>
{query && (
<button className="kb-search-clear" onClick={() => { setQuery(''); setResults([]); setOpen(false); }}>
</button>
)}
{loading && <span className="kb-search-loading">...</span>}
</div>
{open && results.length > 0 && (
<div className="kb-search-dropdown">
{results.map((r, i) => (
<div
key={`${r.path}-${i}`}
className="kb-search-result"
onClick={() => {
onSelect(r.path);
setOpen(false);
setQuery('');
}}
>
<div className="kb-search-result-title">{r.title}</div>
<div className="kb-search-result-path">{r.path}</div>
<div className="kb-search-result-snippet">{r.snippet}</div>
</div>
))}
</div>
)}
{open && results.length === 0 && !loading && query && (
<div className="kb-search-dropdown">
<div className="kb-search-empty"></div>
</div>
)}
</div>
);
}