docs: 新增 README + 更新 Deploy.md + 整理 .gitignore

- 新增 README.md 完整项目概览(架构、功能、快速开始)
- 更新 Deploy.md 修正过时的服务状态和端口信息
- 整理 .gitignore 补充缺失规则并移除无效项

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-22 19:59:47 +08:00
parent e83f28d646
commit 8c19b79a02
5 changed files with 349 additions and 328 deletions
+45 -33
View File
@@ -1,29 +1,17 @@
# ========== 依赖 ==========
node_modules/
# ========== 构建产物 ==========
dist/
.env
backend/.env
*.log
data/
docs/
.DS_Store
dev_must_read.md
scripts/tunnel.sh
.debug/
*.exe
# Test scripts
test/
# DevTools
devtools/node_modules/
devtools/logs/
devtools/package-lock.json
# Go 编译二进制 (模块根 + cmd/ 内产出)
# ========== Go 编译二进制 ==========
backend/ai-core/main
backend/ai-core/cmd/main
backend/ai-core/ai-core
backend/gateway/main
backend/gateway/cmd/main
backend/gateway/cmd/gateway
backend/gateway/gateway
backend/iot-debug-service/main
backend/iot-debug-service/cmd/main
@@ -32,25 +20,49 @@ backend/memory-service/main
backend/memory-service/cmd/main
backend/memory-service/memory-service
backend/tool-engine/main
backend/tool-engine/cmd/main
backend/tool-engine/cmd/tool-engine
backend/tool-engine/tool-engine
backend/voice-service/voice-service
backend/voice-service/cmd/voice-service
# Compiled binaries (voice-service)
backend/voice-service/main
backend/voice-service/main2
backend/voice-service/voice-svc-new
backend/voice-service/cmd/main
backend/voice-service/cmd/voice-service
backend/voice-service/voice-service
backend/cmd/
# Compiled binaries (gateway)
backend/gateway/cmd/gateway
# Stale build artifact (legacy)
backend/cmd
# 用户上传文件
# ========== 运行时数据 ==========
logs/
*.log
*.pid
uploads/
backend/gateway/uploads/
data/
# Voice Service 外部依赖 (C++编译产物 / 模型文件)
# ========== 环境与敏感配置 ==========
.env
backend/.env
.claude/
# ========== 文档 (项目规范:docs/ 不纳入版本管理) ==========
docs/
# ========== 调试临时文件 (项目规范:debug/cache/ 为临时脚本目录) ==========
debug/cache/
debug/logs/
# ========== DevTools 运行时 ==========
devtools/node_modules/
devtools/logs/
devtools/package-lock.json
# ========== 语音服务外部依赖 (C++ 编译产物 / 模型文件) ==========
backend/voice-service/whisper.cpp/
backend/voice-service/models/
backend/voice-service/models/
# ========== 打包归档 ==========
*.tar.gz
*.zip
# ========== 平台杂项 ==========
.DS_Store
Thumbs.db
scripts/tunnel.sh