网易实习第三周：技术做得再深，讲不清楚等于没做

实习第三周，我的工作从单点功能开发进一步转向架构、测试和工程表达。除了继续改进翻译助手，我还要把做过的事情、遇到的问题和背后的思考讲给别人听。

本周完成

1. 完成 trans_agent-demo v1.1.0 系统改进

• 使用 ESLint 和 Prettier 统一代码规范，将 lint 告警清零。
• 加入请求缓存与懒加载，响应时间降低约 40%。
• 增加错误恢复、翻译历史回溯和批量导入功能。
• 重构模块边界，降低模块之间的耦合。

2. 完善测试、安全与 Skill 工具

• 搭建由 8 个测试文件和分析报告组成的测试体系。
• 完善评分系统中的 PBKDF2 与 AES-GCM 加密流程。
• 开发由 3 个模块组成的 Skills 导出工具，整理 34 个 Skill 定义。
• 完成七个输出模块的第一层实现，并为不同模块补齐契约、Prompt、评测脚本和语义样例。
• 测试数量由 119 项增加到 132 项并全部通过。

3. 准备工作汇报与工程问题分享

• 完成 10 页工作汇报答辩 PPT，并使用 Ardot 画布完成版面设计。
• 制作水墨动画 HTML 演示稿。
• 完成 9 页工程问题分享稿，分析“反馈按钮互斥”和“重试上下文丢失”两个 Bug 的根因与修复方案。

遇到的问题及解决方式

第一个问题是 Ardot 画布不支持动画。我没有放弃原来的视觉想法，而是改用 HTML 和 Canvas，实现水墨冲刷式的翻页效果。

第二个问题是工程分享稿第一版塞入了太多代码。虽然技术细节完整，但别人很难迅速理解。第二轮修改时，我把大段代码换成 SVG 图解和生活化类比，让问题的状态变化、根因和修复逻辑更直观。

两个 Bug 带来的思考

“反馈按钮互斥”和“重试上下文丢失”表面上并不相关，但继续向下分析后，我发现它们有相同的根因：把界面表现误当成了系统状态的唯一来源。

界面会重新渲染，局部数据也可能丢失。真正可靠的状态应该被明确建模和管理，而不是从按钮是否高亮、页面当前显示什么反向推断。

这让我体会到，修复 Bug 不能只盯着出问题的那一行代码。找到共同根因，才能避免同类问题再次出现。

下周计划

1. 根据答辩反馈继续修改和完善 PPT。
2. 跟进 v1.1.0 后续改进项。
3. 继续迭代产品规格文档和模块化架构。
4. 持续验证模型路由、多模块组合和边界场景表现。

本周收获与感想

这一周，我不仅更理解了状态管理、模块解耦和测试体系，也重新认识了技术表达。

图比大段文字更容易理解，大白话比堆砌术语更有效。技术做得再深，如果不能让团队理解它解决了什么问题、为什么这样设计，就很难真正产生价值。

第三周的关键词是：重构、验证、表达。