feat(knowledge): 新增 query_keywords 工具，基于关键词命中的 BM25 检索

.dockerignore

@@ -0,0 +1,23 @@
+# 忽略 Git 相关的文件夹
+.git
+.gitignore
+
+# 忽略 Python 的缓存文件
+__pycache__/
+*.pyc
+*.pyo
+
+# 忽略虚拟环境目录
+venv/
+env/
+
+# 忽略 node_modules 文件夹（前端项目）
+web/node_modules/
+
+# 忽略日志和临时文件
+*.log
+*.tmp
+
+# 忽略 Docker 本身的文件
+Dockerfile
+docker-compose.yml

.env.template

@@ -0,0 +1,69 @@
+# region model_provider
+SILICONFLOW_API_KEY=  # 推荐使用硅基流动免费服务 https://cloud.siliconflow.cn/i/Eo5yTHGJ
+TAVILY_API_KEY=  # 获取搜索服务的 api key 请访问 https://app.tavily.com/
+
+# JWT 安全配置：首次部署请生成随机值，初始化脚本会在留空时自动生成
+YUXI_ENV=development
+JWT_SECRET_KEY=
+YUXI_INSTANCE_ID=
+
+# # 其余可选配置
+# OPENAI_API_KEY=
+# OPENAI_API_BASE=
+# ZHIPUAI_API_KEY=
+# DASHSCOPE_API_KEY=
+# DEEPSEEK_API_KEY=
+# ARK_API_KEY=
+# MINIMAX_API_KEY=  # MiniMax 大模型 https://platform.minimaxi.com/
+# TOGETHER_API_KEY=
+# # endregion model_provider
+
+# # region neo4j
+# NEO4J_URI=
+# NEO4J_USERNAME=
+# NEO4J_PASSWORD=
+# # endregion neo4j
+
+# # Servies
+# YUXI_SUPER_ADMIN_NAME=
+# YUXI_SUPER_ADMIN_PASSWORD=
+
+# # URL Whitelist (comma-separated domains/IPs, empty to disable URL parsing)
+# YUXI_URL_WHITELIST=github.com,docs.example.com,gitlab.example.com,127.0.0.1
+
+# # MinerU
+# MINERU_API_KEY=
+
+# Sandbox (deerFlow-style provisioner)
+# SANDBOX_PROVIDER=provisioner
+# SANDBOX_PROVISIONER_URL=http://sandbox-provisioner:8002
+# SANDBOX_VIRTUAL_PATH_PREFIX=/home/gem/user-data
+# SANDBOX_EXEC_TIMEOUT_SECONDS=180
+# SANDBOX_MAX_OUTPUT_BYTES=262144
+# SANDBOX_KEEPALIVE_INTERVAL_SECONDS=30
+# SANDBOX_IDLE_TIMEOUT_SECONDS=120
+# SANDBOX_IDLE_CHECK_INTERVAL_SECONDS=10
+# # sandbox-provisioner backend: memory | docker | kubernetes
+# SANDBOX_PROVISIONER_BACKEND=docker
+
+# sandbox-provisioner 通用配置
+# SANDBOX_IMAGE=enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:latest
+# SANDBOX_CONTAINER_PORT=8080
+# SANDBOX_HEALTH_TIMEOUT_SECONDS=300
+# MEMORY_SANDBOX_URL_TEMPLATE=http://agent-sandbox:8000
+# SANDBOX_HTTP_PROXY=http://host.docker.internal:7897
+# SANDBOX_HTTPS_PROXY=http://host.docker.internal:7897
+
+# Docker backend 专用 (used when SANDBOX_PROVISIONER_BACKEND=docker)
+# 注意：网络名称已在 docker-compose.yml 中固定为 yuxi-know_app-network
+# SANDBOX_DOCKER_NETWORK=yuxi-know_app-network
+# SANDBOX_DOCKER_THREADS_HOST_PATH=
+# SANDBOX_DOCKER_SANDBOX_PREFIX=yuxi-sandbox
+# SANDBOX_DOCKER_SANDBOX_HOST=host.docker.internal
+
+# Kubernetes backend 专用 (used when SANDBOX_PROVISIONER_BACKEND=kubernetes)
+# SANDBOX_K8S_NAMESPACE=yuxi-know
+# SANDBOX_NODE_HOST=host.docker.internal
+# KUBECONFIG_PATH=/root/.kube/config
+# THREAD_PVC=yuxi-thread
+# SKILLS_PVC=yuxi-skills  # 当前代码会读取，但 Pod 挂载实际仍只使用 THREAD_PVC

.github/ISSUE_TEMPLATE/提交一个bug.md

@@ -0,0 +1,47 @@
+---
+name: 提交一个BUG或者报错
+about: 无法启动、无法回答、后端报错等等
+title: 'Error: '
+labels: ''
+assignees: ''
+
+---
+
+1️⃣ 描述一下问题
+
+<!-- 简单描述一下问题（如何产生的，什么情况下，进行什么操作的时候）-->
+
+
+
+2️⃣ 报错日志
+
+请运行以下命令，并提供部分相关日志：
+
+```sh
+# macOS / Linux
+make logs
+
+# Windows
+docker logs --tail=100 api-dev
+git rev-parse HEAD
+```
+
+<!-- 在下面粘贴日志的输出 -->
+
+```
+make logs 的输出：
+
+
+
+```
+
+
+3️⃣ 相关截图
+
+
+
+
+#️⃣ 其他相关信息
+
+
+✅ 如果问题与模型调用相关，请尝试切换到其他在线模型

.github/ISSUE_TEMPLATE/提交一个docker启动问题.md

@@ -0,0 +1,85 @@
+---
+name: 提交一个启动问题
+about: Docker镜像拉取、服务启动、端口占用等相关问题
+title: 'Startup: '
+labels: startup
+assignees: ''
+
+---
+
+## 1️⃣ 问题描述
+
+请清晰描述您在使用 Docker 或启动服务时遇到的问题：
+- 操作步骤：您执行了什么操作？
+- 预期结果：您期望看到什么？
+- 实际结果：实际发生了什么？
+
+例如："执行 `docker compose up -d` 后，api-dev 服务一直重启，查看日志显示无法连接到 Milvus"
+
+
+## 2️⃣ 环境信息
+
+请提供以下信息，帮助我们快速定位问题：
+- 操作系统：Windows/macOS/Linux 及版本
+- Docker 版本：执行 `docker --version` 输出
+- Docker Compose 版本：执行 `docker compose --version` 输出
+- 项目版本：执行 `git rev-parse HEAD` 输出
+
+
+## 3️⃣ 启动命令
+
+请提供您使用的完整启动命令：
+```bash
+# 例如
+docker compose up -d
+# 或
+make up
+```
+
+
+## 4️⃣ 日志信息
+
+请提供相关服务的日志（至少包含最近 100 行）：
+
+```bash
+# 查看所有服务状态
+docker ps
+
+# 查看 api-dev 服务日志
+docker logs --tail=100 api-dev
+
+# 查看所有服务日志
+docker compose logs --tail=100
+```
+
+将日志粘贴到下方（可根据问题相关性选择部分日志）：
+
+```
+# api-dev 日志
+...
+
+# 其他相关服务日志
+...
+```
+
+
+## 5️⃣ 配置文件（可选）
+
+如果您修改过 `docker-compose.yml` 或 `.env` 文件，请提供相关配置片段（注意隐藏敏感信息）：
+
+```yaml
+# docker-compose.yml 相关部分
+...
+
+# .env 相关部分
+...
+```
+
+
+## 6️⃣ 其他信息
+
+您还可以提供以下信息帮助我们解决问题：
+- 是否已尝试过重启 Docker 服务？
+- 是否已清理过 Docker 缓存或旧容器？
+- 网络环境是否有特殊配置（如代理、防火墙等）？
+- 是否有其他相关的错误提示或截图？

.github/ISSUE_TEMPLATE/提交一个提问.md

@@ -0,0 +1,11 @@
+---
+name: 提交一个提问
+about: 关于项目使用的问题
+title: 'Question: '
+labels: question
+assignees: ''
+
+---
+
+**问题描述**
+

.github/ISSUE_TEMPLATE/提交一个需求建议.md

@@ -0,0 +1,17 @@
+---
+name: 提交一个需求建议
+about: 为这个项目提个建议
+title: 'Feat: '
+labels: enhancement
+assignees: ''
+
+---
+
+**#️⃣ 您的功能请求是否与某个问题相关？请描述。**
+<!--清晰简明地描述问题所在。例如：当[...]时，我感觉不方便。-->
+
+**#️⃣ 描述您期望的解决方案**
+<!--清晰简明地描述您希望看到的结果。-->
+
+**#️⃣ 附加背景信息**
+<!--在此处添加关于该功能请求的其他背景信息或截图。-->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,22 @@
+## 变更描述
+简要描述这个 PR 做了什么
+
+## 变更类型
+- [ ] 新功能
+- [ ] Bug 修复
+- [ ] 文档更新
+- [ ] 其他
+
+## 测试
+- [ ] 已在 Docker 环境测试
+- [ ] 相关功能正常工作
+
+**相关日志或者截图**
+
+
+## 说明
+（可选）有什么需要特别说明的吗？
+
+---
+
+💡 **提示**: 提交前可以运行 `make lint` 和 `make format` 检查代码规范

.github/workflows/close-stale-issues.yml

@@ -0,0 +1,29 @@
+# This workflow warns and then closes issues and PRs that have had no activity for a specified amount of time.
+#
+# You can adjust the behavior by modifying this file.
+# For more information, see:
+# https://github.com/actions/stale
+name: Mark stale issues and pull requests
+
+on:
+  schedule:
+  - cron: '40 9 * * *'
+
+jobs:
+  stale:
+
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+
+    steps:
+    - uses: actions/stale@v5
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: '此 Issue 已标记为待关闭，若 14 天内无进一步活动将被自动关闭。'
+        close-issue-message: '因 14 天无响应，此 Issue 已自动关闭。如有需要，请重新打开。'
+        stale-issue-label: 'no-issue-activity'
+        only-labels: 'to-be-closed'
+        days-before-stale: 30
+        days-before-close: 14

.github/workflows/deploy.yml

@@ -0,0 +1,72 @@
+# 构建 VitePress 站点并将其部署到 GitHub Pages 的示例工作流程
+#
+name: Deploy VitePress site to Pages
+
+on:
+  # 在 docs 相关变更推送时运行构建（任意分支）
+  push:
+    paths:
+      - 'docs/**'
+      - '.github/workflows/deploy.yml'
+
+  # 在面向 main 的 PR 中提前验证 docs 构建
+  pull_request:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/deploy.yml'
+
+  # 允许你从 Actions 选项卡手动运行此工作流程
+  workflow_dispatch:
+
+# 设置 GITHUB_TOKEN 的权限，以允许部署到 GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# 只允许同时进行一次部署，跳过正在运行和最新队列之间的运行队列
+# 但是，不要取消正在进行的运行，因为我们希望允许这些生产部署完成
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  # 构建工作
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # 如果未启用 lastUpdated，则不需要
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+      - name: Install dependencies
+        run: npm install
+        working-directory: docs
+      - name: Build with VitePress
+        run: npm run build
+        working-directory: docs
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+  # 部署工作
+  deploy:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    name: Deploy
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4