铸渊 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
99 lines
2.8 KiB
TypeScript
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>
|
|
);
|
|
}
|