冰朔
ecfeca40e2
铸渊 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
37 lines
1 KiB
JSON
37 lines
1 KiB
JSON
{
|
|
"name": "guanghu-knowledge-base",
|
|
"version": "0.1.0",
|
|
"description": "光湖知识库模块 — Git 驱动的文档管理系统",
|
|
"type": "module",
|
|
"scripts": {
|
|
"dev": "concurrently \"npm run dev:server\" \"npm run dev:client\"",
|
|
"dev:server": "tsx watch server/index.ts",
|
|
"dev:client": "vite",
|
|
"build": "tsc -b && vite build",
|
|
"preview": "vite preview",
|
|
"start": "NODE_ENV=production node dist-server/index.js"
|
|
},
|
|
"dependencies": {
|
|
"express": "^5.1.0",
|
|
"cors": "^2.8.5",
|
|
"simple-git": "^3.27.0",
|
|
"gray-matter": "^4.0.3",
|
|
"marked": "^15.0.0",
|
|
"diff": "^7.0.0"
|
|
},
|
|
"devDependencies": {
|
|
"@types/express": "^5.0.0",
|
|
"@types/cors": "^2.8.17",
|
|
"@types/diff": "^6.0.0",
|
|
"@types/node": "^22.0.0",
|
|
"@types/react": "^19.0.0",
|
|
"@types/react-dom": "^19.0.0",
|
|
"@vitejs/plugin-react": "^4.3.0",
|
|
"concurrently": "^9.1.0",
|
|
"react": "^19.0.0",
|
|
"react-dom": "^19.0.0",
|
|
"tsx": "^4.19.0",
|
|
"typescript": "^5.7.0",
|
|
"vite": "^6.2.0"
|
|
}
|
|
}
|