WangDL 23a6999b56 docs: 推送所有未提交的文档更新
- 5/19-5/20 工作日志
- 后端实现状态更新
- 服务器部署方案更新
- 知识库设计更新
- 进行中文档更新
- 执行计划与任务清单更新

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-20 18:10:44 +08:00

91 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 后端 — 进行中
> 更新时间2026-05-20 14:00
> 关联:[总待完成清单](../总待完成清单.md)
---
## ✅ 5/20 已完成
- **CI/CD: api-server deploy pipeline** — `/home/ubuntu/api-server/.gitea/workflows/deploy.yml` 已配置gitea-runner 正常运行zhixi-api Docker 容器自动构建部署
- **CI/CD: web-projects deploy pipeline** — `/tmp/web-projects/.gitea/workflows/deploy.yml` 已配置,今日 13:38 部署成功,`/var/www/longde.cloud/`
- **rag-worker 代码部署到 8核32G** — 10 个文件 + .env 已就位API 密钥已配置
- **gitea-runner-web** — 单一 `gitea-runner` 服务同时处理 api-server + web-projects 两端 CI/CD无需独立 runner
---
## 🟠 B11 — AI 联调 + Prompt 调优
**状态**进行中rag-worker 代码已部署systemd 待补)
**已完成**
- [x] DeepSeek Key 已配置8核32G + .env
- [x] 硅基流动 Key 已配置bge-m3 embedding + 其他模型)
- [x] RAG Worker 代码已部署到 `/opt/zhixi/backend/rag-worker/`
- [x] RAG Worker .env 配置完整
**待完成**
- [ ] 补全 Python 依赖(缺 pydantic/python-docx/markdown/pandas/Pillow/qdrant-client/python-dotenv
- [ ] 创建 systemd `zhixi-worker` 服务
- [ ] DeepSeek 真实调用测试(通过 rag-worker 端到端)
- [ ] 5 个 Prompt 逐一调优active-recall / feynman-evaluation / knowledge-import / review-card / learning-trend
- [ ] 输出格式稳定性验证Zod schema 通过率)
- [ ] 延迟/成本基准测试
---
## 🔵 B28 — iOS 接口缺口审计
**状态**:待开始
**决策**:🔵 需架构设计
**背景**:用户反馈"iOS 模块逐个修改,有些页面功能不太对,可能涉及到加接口"。
**子任务**
- [ ] 列出 iOS 全部页面对应的后端 API
- [ ] 逐页检查:字段是否够用、分页是否支持、错误处理是否完善
- [ ] 标记缺口(缺接口 / 缺字段 / 缺错误码)
- [ ] 输出审计报告 → 补充接口清单
---
## 🔵 B29 — 知识库存储架构
**状态**进行中COS 凭据已配置Bucket 待验证)
**决策**:🔵 需架构设计
**已完成**
- [x] COS 凭据已配置到 8核32G 环境变量SECRET_ID/SECRET_KEY/BUCKET/REGION/DOMAIN
- [x] knowledge-source 模块已完成(资料来源 CRUD + DocumentImport 自动生成)
- [x] import-candidate 模块已完成(候选知识点 + KnowledgeItem 自动生成)
- [x] Python parser 已支持 PDF/DOCX/TXT/MD/CSV/XLSX + OCR 预留
**待完成**
- [ ] 验证 COS Bucketzhixi-1259685406已创建且可访问
- [ ] 百度 OCR 开通
- [ ] COS 目录路径规范设计user-uploads / knowledge-assets / exports
- [ ] 与 KnowledgeImportWorkflow 的对接方案
- [ ] 大文件分片上传方案
---
## 🆕 B30 — CI/CD Pipeline 完善 ✅ 已完成
**状态**:两端均已配置并验证通过
**已完成**
- [x] 8核32G: gitea-runner systemd 自启
- [x] 4核4G: gitea-runner systemd 自启(单一 runner 覆盖两端)
- [x] api-server deploy.yml ✅
- [x] web-projects deploy.yml ✅(今日 13:38 部署成功)
- [x] Astro 构建 → Nginx 部署 → 后端健康检查全流程验证
---
## ⚪ 远期(暂不启动)
- B23: Plans + Membership + Subscription🔴 需先定定价)
- B24: Admin 后台(🟢)
- B25: SupportTicket + Dify + HelpCenter🟢
- B26: AIQuota / UsageLimit🔵