AI Knowledge Link（AI知识链接）

把用户的 Word / PDF 文档自动解析为 Markdown、组织成知识库，并为每个知识库生成一个高熵 Secret URL。用户把链接发给任意支持网页访问的 AI，AI 即可按用户描述自主选择并读取文档。

上传文档 → 自动解析 → 转换 Markdown → 建立知识库 → 生成 AI 专属链接
        → 把链接发给任意 AI → AI 读取目录并按描述访问具体文档

状态：开发中（Phase 1 — 项目初始化）。完整架构与技术决策见 docs/technical-review.md。

技术栈（MVP v1）

层	技术
后端	Python 3.12+ · FastAPI · SQLAlchemy 2 · Pydantic v2 · Alembic · Jinja2
前端	Vue 3 · TypeScript · Vite · Element Plus · Pinia
存储	SQLite（元数据）+ 本地文件系统（原始文件 + Markdown）
解析	MarkItDown（优先）· PyMuPDF（PDF fallback）· python-docx（DOCX fallback）
搜索	SQLite FTS5

目录结构

backend/     FastAPI 应用（api 管理端 / public AI公共端 / processors 解析 / retrieval 检索 / storage 存储）
frontend/    Vue 3 管理后台
nginx/       反向代理配置（生产）
data/        SQLite + 用户文件（.gitignore 排除，仅保留 .gitkeep）
docs/        架构与技术文档

快速开始（Windows 开发）

无需 Docker，直接运行。

后端

cd backend
python -m venv .venv
# Git Bash:
source .venv/Scripts/activate
# 或 CMD:
.venv\Scripts\activate

pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --reload --port 8000

• API 文档：http://localhost:8000/api/docs
• 健康检查：http://localhost:8000/api/health

前端

cd frontend
npm install
npm run dev

• 访问：http://localhost:5173
• Vite 代理：/api 和 /k → localhost:8000

生产部署（Ubuntu + Docker）

git clone <repo> /opt/ai-knowledge-link
cd /opt/ai-knowledge-link
cp .env.example .env          # 修改全部密钥
mkdir -p data
docker compose up -d --build

• 数据持久化：./data/ 宿主机 volume，删除容器不丢失
• 备份：SQLite .backup + tar 用户文件目录

安全须知

• .env 携带全部密钥，绝不提交 Git
• 知识库 Secret URL 即访问凭证（链接即钥匙），请勿公开传播
• 公共 AI 页面不依赖 JS/Cookie/登录；含 noindex meta + robots.txt 屏蔽

文档

• 技术审查报告 — 架构、ER、API、安全模型、风险清单、6 个扩展接口