https://wyxbupt.me/posts/%E5%BC%80%E6%BA%90%E5%B7%A5%E4%BD%9C%E7%B3%BB%E5%88%97/ Recent content in 开源工作系列 on 学习笔记 Hugo zh-cn Sun, 24 May 2026 00:00:00 +0800 https://wyxbupt.me/posts/%E5%BC%80%E6%BA%90%E5%B7%A5%E4%BD%9C%E7%B3%BB%E5%88%97/deepseek-tui-markdown%E6%A0%BC%E5%BC%8F%E4%BF%AE%E5%A4%8D/ Sun, 24 May 2026 00:00:00 +0800 https://wyxbupt.me/posts/%E5%BC%80%E6%BA%90%E5%B7%A5%E4%BD%9C%E7%B3%BB%E5%88%97/deepseek-tui-markdown%E6%A0%BC%E5%BC%8F%E4%BF%AE%E5%A4%8D/ <h1 id="我的第一个开源贡献修复-deepseek-tui-的-markdown-渲染问题">我的第一个开源贡献：修复 DeepSeek-TUI 的 Markdown 渲染问题</h1> <h2 id="背景">背景</h2> <p><a href="https://github.com/Hmbown/DeepSeek-TUI">DeepSeek-TUI</a> 是一个用 Rust 编写的终端 AI 助手，基于 DeepSeek V4 模型，支持 1M token 上下文。我在日常使用中发现 AI 的回复里 Markdown 格式完全没有被渲染，严重影响阅读体验。这是我第一次接触 Rust，也是我第一次向开源项目提交 PR。</p> <h2 id="问题现象">问题现象</h2> <p>使用时发现三类渲染问题：</p> <p><strong>1. 表格原样输出</strong></p> <pre tabindex="0"><code>| 名称 | 版本 | 状态 | |----------|------|------| | React | 18.x | 稳定 | </code></pre><p>分隔行 <code>|---|</code> 也直接显示出来，没有任何格式化。</p> <p><strong>2. 粗体/斜体标记符没有被剥掉</strong></p> <pre tabindex="0"><code>**粗体文本** 和 *斜体文本* </code></pre><p>星号原样显示，没有加粗或斜体效果。</p> <p><strong>3. 水平线没有渲染</strong></p> <pre tabindex="0"><code>--- </code></pre><p>直接显示成三个横杠，没有渲染成分隔线。</p> <hr> <h2 id="代码分析">代码分析</h2> <p>项目的渲染逻辑在 <code>crates/tui/src/tui/markdown_render.rs</code>。读完代码后理解了它的设计：</p> <h3 id="两阶段渲染架构">两阶段渲染架构</h3> <pre tabindex="0"><code>源文本 → parse() → ParsedMarkdown (AST) → render_parsed(width) → Vec&lt;Line&gt; </code></pre><ul> <li><strong>parse 阶段</strong>：与终端宽度无关，把源文本分类成 <code>Block</code> 枚举的各种变体</li> <li><strong>render 阶段</strong>：依赖宽度，做折行和样式渲染</li> </ul> <p>这个设计的好处是终端 resize 时只需重新 render，不需要重新 parse，性能更好。</p>