项目实践¶

造轮子的价值

最好的学习方式是解决自己的真实痛点。这里收录的项目从全栈数据可视化系统到日常效率工具，每个都源于真实场景需求。

🧩 项目总览¶

桥见九州 · 中国古桥时空图谱

全栈数据可视化系统：支持地图下钻、多维联动筛选、AI 智能问答，收录 100 座古桥 覆盖 22 个省级行政区。计算机设计大赛参赛作品。

Vue 3 ECharts 5 FastAPI DeepSeek MCP
- 🗺️ 时空探索：中国地图下钻 + 6 类联动图表，"时域形义"四维信息架构
- 🤖 AI 对话：三级候选收敛策略 + 14 条 prompt 约束 + 回答后处理管线
- 🔍 来源过滤：11KB 可信来源三级分类，MCP 联网搜索仅保留权威结果
- 🎨 水墨设计：自定义古纸色系 + 书法字体降级链 + 8145 行 CSS 视觉系统
项目复盘 AI 系统解析视觉设计
Git 交互式提交助手

PowerShell 脚本，解决多文件改动时"一锅端"提交的痛点。

PowerShell Git CLI 自动化
- ✨ 分批提交：按编号选择文件，一次提交一组
- 🛡️ 安全防护：敏感文件警告 + 大文件提醒 + 主分支保护
- 📊 遗漏检测：实时统计已提交/剩余文件，退出前二次确认
- 🎨 可视化：彩色状态标识、进度统计、会话汇总
查看完整文档
PPT 批量转 PDF 工具

Python 脚本，通过 Windows COM 接口调用 PowerPoint 原生导出能力。

Python COM 自动化 办公效率
- 📁 批量处理：自动扫描文件夹中所有 .ppt / .pptx 文件
- 🎯 高保真：调用 PowerPoint 原生引擎，格式零损失
- 🔄 容错设计：单文件失败不中断全局，try/finally 确保资源释放
- 📈 进度反馈：实时显示转换进度与成功/失败统计
查看完整文档
AI 对话导航插件

浏览器扩展，为 AI 长对话生成悬浮目录，告别疯狂翻滚。

JavaScript Chrome Extension Manifest V3
- 🚀 一键导航：自动提取所有提问，生成侧边栏目录
- 🤖 全平台支持：Gemini / ChatGPT / Claude 三端适配
- 🏗️ 适配器模式：新增平台只需添加一个适配器文件
- ⚡ 零依赖：纯原生 JS，体积 < 200KB，加载极快
查看完整文档

🛠️ 技术栈分布¶

graph LR
    Root["项目实践"] --> FullStack["全栈系统"]
    Root --> Auto["自动化脚本"]
    Root --> Plugin["浏览器插件"]

    FullStack --> Bridge["桥见九州"]
    Auto --> Git["Git 提交助手"]
    Auto --> PPT["PPT 转 PDF"]
    Plugin --> Nav["AI 对话导航"]

    Bridge --> Vue["Vue 3"]
    Bridge --> ECharts["ECharts 5"]
    Bridge --> FastAPI["FastAPI"]
    Bridge --> DeepSeek["DeepSeek"]
    Git --> PS["PowerShell"]
    Git --> GitTool["Git CLI"]
    PPT --> Py["Python"]
    PPT --> COM["Windows COM"]
    Nav --> JS["原生 JavaScript"]
    Nav --> MV3["Manifest V3"]

    style Root fill:#7c4dff,stroke:#fff,stroke-width:2px,color:#fff
    style FullStack fill:#6a4735,stroke:#fff,color:#fff
    style Auto fill:#00bcd4,stroke:#fff,color:#fff
    style Plugin fill:#e91e63,stroke:#fff,color:#fff

📊 项目速览¶

项目	语言 / 技术	规模	核心价值
桥见九州 · 古桥时空图谱	Vue 3 + ECharts + FastAPI + DeepSeek	~73K (后端) + 8K CSS	全栈数据可视化 + AI 对话 + 地图下钻
Git 交互式提交助手	PowerShell	~96K	分批提交 + 遗漏检测 + 安全防护
PPT 批量转 PDF	Python + COM	~7K	高保真批量转换 + 容错设计
AI 对话导航插件	JavaScript	~9K	多平台适配 + 零依赖 + 悬浮目录

💡 设计理念¶

四个共同特征

解决真实痛点：每个项目都源于日常工作中的具体问题，而非为了技术展示而造的 Demo。
即插即用：所有项目均附完整技术文档，修改配置即可在自己的环境中运行。
容错优先：每个项目都内置了错误处理与回退机制——单点失败不会拖垮整个流程。
无损降级：关键功能都有离线/降级方案（如双模式架构、图片 fallback），保证核心体验不受环境影响。