# EmpoweringKnowledgeBase

**Repository Path**: touchx_admin/empowering-knowledge-base

## Basic Information

- **Project Name**: EmpoweringKnowledgeBase
- **Description**: 本项目致力于打造一个"AI驱动的创造力实验场"，让每一位开发者、创作者都能借助最先进的人工智能工具，激发灵感、提升效率、突破创新边界。AI助手不仅是被动响应的工具，更是主动启发、持续进化的"智能伙伴"。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-29
- **Last Updated**: 2025-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EmpoweringKnowledgeBase 赋能知识库

【能力标签】：洞察、创新、优化、协同、成长赋能

---

## 项目简介
EmpoweringKnowledgeBase（赋能知识库）是面向开发者和AI助手的本地智能知识管理系统，支持多模态内容采集、智能检索、成长报告、AI长期记忆与自动化集成，助力用户与AI共成长。

---

## 核心特性
- 多模态内容采集与结构化管理（文本、代码、图片、流程图等）
- 智能检索与本地AI问答（集成deepseek等大模型）
- 成长报告、能力地图、个性化推送
- 与Cursor IDE集成，自动采集对话与操作
- 本地加密存储，数据安全与隐私保障
- 插件化、自动化、可扩展架构

---

## 技术架构
- **后端**：Python FastAPI
- **前端**：React
- **数据库**：SQLite（本地加密）
- **AI集成**：deepseek本地模型
- **插件**：Cursor IDE插件
- **自动化**：CI/CD、Webhook、脚本

---

## 目录结构
```
EmpoweringKnowledgeBase/
├── backend/      # 后端服务（FastAPI、数据库、AI集成）
├── frontend/     # 前端应用（React）
├── plugins/      # IDE插件（如Cursor插件）
├── scripts/      # 自动化脚本、CLI工具
├── docs/         # 项目文档与规范
├── tests/        # 测试用例
├── .cursor/      # Cursor IDE规则与配置
├── README.md     # 项目说明
└── ...
```

---

## 快速启动（本地部署）
1. 克隆仓库
   ```bash
   git clone <repo-url>
   cd EmpoweringKnowledgeBase
   ```
2. 按照 docs/赋能知识库部署与环境配置手册.md 配置本地环境
3. 启动后端服务
   ```bash
   cd backend
   python -m venv venv
   source venv/bin/activate  # Windows: venv\Scripts\activate
   pip install -r requirements.txt
   uvicorn main:app --reload
   ```
4. 启动前端应用
   ```bash
   cd frontend
   npm install
   npm start
   ```
5. （可选）安装并配置Cursor插件，实现IDE对话采集

---

## 一键启动后端服务

- Windows用户可直接双击或在命令行运行：
  ```
  scripts/start_backend.bat
  ```
- 脚本会自动进入backend目录并启动FastAPI开发服务。
- 如需自定义端口或参数，可编辑脚本内容。

## 一键启动前端服务

- Windows用户可直接双击或在命令行运行：
  ```
  scripts/start_frontend.bat
  ```
- 脚本会自动进入frontend目录并启动React开发服务器（默认端口3000）。
- 如需自定义端口或参数，可编辑脚本内容。

---

## 主要文档索引
- 项目实施总纲：docs/项目实施总纲.md
- 需求分析与目标定义：docs/需求分析与目标定义.md
- 技术选型与结构设计：docs/知识库结构与技术选型.md
- 开发手册/API/数据结构/部署/插件/测试等：docs/
- 开发计划与进度：docs/赋能知识库开发计划.md、docs/赋能知识库开发进度记录.md
- 开发规则：.cursor/rules.md

---

## 贡献指南
- 欢迎提交Issue、PR、建议与文档！
- 请遵循 .cursor/rules.md 及 docs/开发手册 相关规范
- 重要变更请更新CHANGELOG.md

---

## 许可证
MIT License

---

【成长型建议】
- 本项目持续迭代，欢迎关注、参与、共创智能知识新范式！ 

# 项目全局规范（rules）

## 1. 协作与分工
- 所有开发、测试、文档、运维需分工明确，责任到人。
- 重要决策、变更需团队评审。

## 2. 分支与提交
- 采用Git Flow或功能分支开发，禁止直接在main分支开发。
- 提交信息需结构化（如feat、fix、chore、docs等），建议中英文结合。

## 3. 文档与知识沉淀
- 所有模块需有README/开发手册，结构变更需同步文档。
- 重要决策、经验、踩坑需沉淀至docs/。

## 4. CI/CD与质量保障
- 所有提交需通过本地CI（lint、test、pre-commit等）。
- 生产部署需二次评审与回归测试。

## 5. 安全与合规
- 禁止提交敏感信息、密钥、数据库文件等至Git。
- 遵守开源协议与数据合规要求。

## 6. 持续优化与成长赋能
- 鼓励代码重构、自动化、创新实践。
- 定期回顾与优化开发流程，促进团队成长。