<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
    <channel>
        <title>Nudo Blog</title>
        <link>https://nudojs.github.io/nudo/zh-Hans/blog</link>
        <description>Nudo Blog</description>
        <lastBuildDate>Mon, 28 Sep 2026 00:00:00 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>https://github.com/jpmonette/feed</generator>
        <language>zh-Hans</language>
        <item>
            <title><![CDATA[我们把 JS 包上的 `tsc` 退役了——门禁反而更尖]]></title>
            <link>https://nudojs.github.io/nudo/zh-Hans/blog/retiring-typescript-in-practice</link>
            <guid>https://nudojs.github.io/nudo/zh-Hans/blog/retiring-typescript-in-practice</guid>
            <pubDate>Mon, 28 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[JS 包上的 tsc --noEmit 可以退役了。零注解起步、契约只在你接受的地方生效、违例读作值 ⊭ 谓词 + 下一步——出口是 migrate retire，不是永远双跑两个编译器。]]></description>
            <content:encoded><![CDATA[<blockquote>
<p>JS 包上的 <code>tsc --noEmit</code> 可以退役了。零注解起步、契约只在你接受的地方生效、违例读作<strong>值 ⊭ 谓词 + 下一步</strong>——出口是 <code>migrate retire</code>，不是永远双跑两个编译器。</p>
</blockquote>
<p>大多数团队留着 <code>tsc --noEmit</code>，不是因为喜欢写注解，而是因为没有别的 CI 门禁可选。Nudo 的答案不是「再写一套类型语言」，而是三条承诺：</p>
<ol>
<li class=""><strong>JS 保持 JS</strong> —— 不改运行时，不发明第二 IR。</li>
<li class=""><strong>契约按需</strong> —— <code>*.nudo.js</code> / <code>@nudo:contract</code>，义务只来自你接受的声明。</li>
<li class=""><strong>单向门</strong> —— <code>nudo migrate status → strip → verify → retire</code>。出口是 <strong>retire tsc</strong>，不是双跑。</li>
</ol>
<p>我们用三个可运行样例钉住了这个故事，而不是几页幻灯片：一个公开的 checkout-demo，加上两个真实 npm 消费方。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="为什么敢把旧门禁撤掉">为什么敢把旧门禁撤掉<a href="https://nudojs.github.io/nudo/zh-Hans/blog/retiring-typescript-in-practice#%E4%B8%BA%E4%BB%80%E4%B9%88%E6%95%A2%E6%8A%8A%E6%97%A7%E9%97%A8%E7%A6%81%E6%92%A4%E6%8E%89" class="hash-link" aria-label="为什么敢把旧门禁撤掉的直接链接" title="为什么敢把旧门禁撤掉的直接链接" translate="no">​</a></h2>
<p><code>nudo check</code> 是跑在 Abs（shape × term × pred × conf）上的谓词蕴含门禁——类型是可计算的值，所以 <code>x&gt;0</code> 蕴含 <code>x+1&gt;1</code>，而不是退化成 <code>number</code>。门禁对着金标准，不对着感觉：check 套件上 recall = precision = 1.0，外加真实包零误报测试。这才让 <code>nudo check</code> 能当<em>唯一的</em>门禁，而不是一个咨询层。</p>
<p>证据树是提交进仓库、可复跑的（<code>pnpm run verify:examples</code>）：</p>
<table><thead><tr><th>案例</th><th>依赖</th><th>终态</th></tr></thead><tbody><tr><td>checkout-demo</td><td>合成小库</td><td><code>nudo check</code> 一门禁</td></tr><tr><td><strong>ms</strong>（vercel/ms）</td><td>真实 npm</td><td>依赖不动，消费方是纯 JS + Nudo</td></tr><tr><td><strong>debug</strong>（visionmedia/debug）</td><td>真实 npm</td><td>同上；native 返回诚实标 <code>unknown</code></td></tr></tbody></table>
<p><code>ms</code> 和 <code>debug</code> 是真实包，不是合成 fixture——动的是消费方，依赖一个没改。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="四步门">四步门<a href="https://nudojs.github.io/nudo/zh-Hans/blog/retiring-typescript-in-practice#%E5%9B%9B%E6%AD%A5%E9%97%A8" class="hash-link" aria-label="四步门的直接链接" title="四步门的直接链接" translate="no">​</a></h2>
<div class="language-text codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-text codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">audit (migrate status) → strip → verify (nudo check) → retire (drop tsc)</span><br></div></code></pre></div></div>
<p>可直接粘贴，路径换成你的包：</p>
<div class="language-bash codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-bash codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic"># 0. audit —— 还有什么在背着 tsc</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs migrate status ./my-pkg</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic"># 1. strip —— .ts → .js（注解出去，运行时不动）。--write 落盘。</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs migrate strip ./my-pkg/src </span><span class="token parameter variable" style="color:#36acaa">--write</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic"># 2. 可选 —— 把旧注解反向抽取成可评审的契约草稿</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs contract --from-dts ./my-pkg/src/index.ts</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">#    → @nudo:draft（不复制进 *.nudo.js 就不生效）</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic"># 3. verify —— strip 出的 JS 必须过 nudo check</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs migrate verify ./my-pkg/src</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic"># 4. retire —— 卸掉 typescript，改写 tsc 脚本 / GHA 行，写 marker</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs migrate retire ./my-pkg --dry-run   </span><span class="token comment" style="color:#999988;font-style:italic"># 然后去掉 --dry-run</span><br></div></code></pre></div></div>
<table><thead><tr><th>步骤</th><th>效果</th><th>何时出门</th></tr></thead><tbody><tr><td><code>status</code></td><td>数 <code>.ts</code>、找 <code>tsc</code> 脚本 + <code>typescript</code> 依赖、列 <strong>blockers</strong></td><td>你摸清了面积</td></tr><tr><td><code>strip</code></td><td><code>.ts</code> → <code>.js</code>；可选尽力而为的侧车草稿</td><td>源码是纯 JS</td></tr><tr><td><code>verify</code></td><td>对 strip 后的 JS 跑 <code>nudo check</code>（可选 <code>--with-tsc</code> 双跑，<strong>仅限</strong>搬家期间）</td><td>门禁绿</td></tr><tr><td><code>retire</code></td><td>卸 <code>typescript</code>，<code>tsc</code> 脚本 → <code>nudo check</code>，改写 <code>.github/workflows</code>，写 <code>.nudo/migrate-retired.json</code></td><td><strong>tsc 消失</strong></td></tr></tbody></table>
<p>两个细节扛起了信任。<code>--from-dts</code> 草稿<strong>绝不静默生效</strong>：旧注解只有在评审并复制进 <code>*.nudo.js</code> 之后才变成义务。双跑只存在于搬家期间的 <code>migrate verify --with-tsc</code>——共存是迁移战术，从来不是终点。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="违例读起来是什么样">违例读起来是什么样<a href="https://nudojs.github.io/nudo/zh-Hans/blog/retiring-typescript-in-practice#%E8%BF%9D%E4%BE%8B%E8%AF%BB%E8%B5%B7%E6%9D%A5%E6%98%AF%E4%BB%80%E4%B9%88%E6%A0%B7" class="hash-link" aria-label="违例读起来是什么样的直接链接" title="违例读起来是什么样的直接链接" translate="no">​</a></h2>
<p>搬家之后，违例是值和谓词，不是类型名：</p>
<div class="language-text codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-text codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">actual:   0  #exact</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">expected: ms &gt; 0</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">→ use a value satisfying ms &gt; 0</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">fix:  nudo contract --draft</span><br></div></code></pre></div></div>
<p>不是「报得更多」，是**「报得更真、带证据、带下一步」**。全部错误面孔见 <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/error-faces">Error faces</a>。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="诚实的限制">诚实的限制<a href="https://nudojs.github.io/nudo/zh-Hans/blog/retiring-typescript-in-practice#%E8%AF%9A%E5%AE%9E%E7%9A%84%E9%99%90%E5%88%B6" class="hash-link" aria-label="诚实的限制的直接链接" title="诚实的限制的直接链接" translate="no">​</a></h2>
<p>上面每个样例都是来自 <code>docs/examples/</code> 的<strong>示例级</strong>规模（各 2–3 个模块）——耗时与摩擦计数是示例级数字，不是生产规模迁移审计。我们不发布生产级的时/天数，所谓「7 天退役路径」是产品目标叙事，不是测得的中位数：估算真实包请从 <code>migrate status</code> 报出的 <code>.ts</code> 文件数出发，别按博客文章算。</p>
<p>原生或未 harvest 的依赖以引擎债务的形式保持可见：<code>ms()</code> 和 <code>debug()</code> 的返回显示 <code>unknown</code> / <code>conf=opaque</code>，带 <code>nudo:unknown-inference</code> 或 <code>nudo:opaque-result</code> 警告和修复路径（<code>@types/*</code> harvest、<code>@nudo:mock</code>、或 <code>refine return</code>）。诚实的债务在你钉住之前一直是警告——绝不被伪装成成功。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="迁移后的工作流">迁移后的工作流<a href="https://nudojs.github.io/nudo/zh-Hans/blog/retiring-typescript-in-practice#%E8%BF%81%E7%A7%BB%E5%90%8E%E7%9A%84%E5%B7%A5%E4%BD%9C%E6%B5%81" class="hash-link" aria-label="迁移后的工作流的直接链接" title="迁移后的工作流的直接链接" translate="no">​</a></h2>
<p><code>nudo check</code> 是唯一的门禁，签名<strong>即使成功也打印</strong>——未约束的入口参数显示为 <code>any</code>，真正的 <code>unknown</code> 意味着推断失败。有意的 <code>throw</code> 以 L2（<code>nudo:entry-may-throw</code>）浮出，带确切的下一步（<code>@nudo:throws</code>、guard，或第一周先软化的 <code>package.json</code> 配置）。之后收紧约束，面孔就变成值 + 谓词。</p>
<p>完整的命令走查、before/after 代码与诊断、摩擦表：<a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/case-study-retire">Case study: retire tsc</a>。门本身写在 <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/migrating-from-typescript">Migrate from TypeScript</a>；如果你刚接触 Nudo，从 <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/getting-started/quick-start">Quick Start</a> 开始。</p>]]></content:encoded>
            <category>engineering</category>
            <category>typescript</category>
            <category>migrate</category>
            <category>case-study</category>
        </item>
        <item>
            <title><![CDATA[面向 coding agent 的 Nudo —— agents.md、agent 集成与稳定诊断码]]></title>
            <link>https://nudojs.github.io/nudo/zh-Hans/blog/agents-docs</link>
            <guid>https://nudojs.github.io/nudo/zh-Hans/blog/agents-docs</guid>
            <pubDate>Mon, 21 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[发布系列（4/5）—— 2026-09-21 同日成套发布。建议按序阅读：]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><strong>发布系列</strong>（4/5）—— 2026-09-21 同日成套发布。建议按序阅读：
<a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/day0-observe">Day 0 —— 不改写就观察 JavaScript</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/day1-contracts">契约就是 JS —— Day 1 与侧车 *.nudo.js</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/vs-typescript">Nudo vs TypeScript —— 何时该选 JS-first 门禁</a> · <strong>面向 coding agent 的 Nudo —— agents.md、agent 集成与稳定诊断码</strong> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/attribution-gate">22 个文件被涂抹——调用点归因如何险些把假精度当成真发布</a></p>
</blockquote>
<p>Nudo 的观察输出本来就是结构化的。Agent 还需要一份稳定的产品契约。</p>
<p>读 <strong><a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/reference/agents">Agents</a></strong>（人类文档）与机器入口 <strong><a href="https://nudojs.github.io/nudo/agents.md" target="_blank" rel="noopener noreferrer" class="">agents.md</a></strong>。策展索引：<strong><a href="https://nudojs.github.io/nudo/llms.txt" target="_blank" rel="noopener noreferrer" class="">llms.txt</a></strong>。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="一屏-agent-规则">一屏 Agent 规则<a href="https://nudojs.github.io/nudo/zh-Hans/blog/agents-docs#%E4%B8%80%E5%B1%8F-agent-%E8%A7%84%E5%88%99" class="hash-link" aria-label="一屏 Agent 规则的直接链接" title="一屏 Agent 规则的直接链接" translate="no">​</a></h2>
<div class="language-text codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-text codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">Primary gate: npx nudojs check &lt;path&gt;</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Contracts: *.nudo.js / @nudo:contract</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">@nudo:case is debug-only — not the contract product</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Entry params print as any; unknown = inference failed</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">check validates; export projects (lossy)</span><br></div></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="工具面">工具面<a href="https://nudojs.github.io/nudo/zh-Hans/blog/agents-docs#%E5%B7%A5%E5%85%B7%E9%9D%A2" class="hash-link" aria-label="工具面的直接链接" title="工具面的直接链接" translate="no">​</a></h2>
<ul>
<li class="">LSP：<code>@nudojs/lsp</code></li>
<li class="">Agent executeCommand / 工具：<a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/api/agent">API · agent</a></li>
<li class="">Agent 集成：<a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/agent-integration">Agent 集成指南</a></li>
<li class="">JSON 面：<code>npx nudojs check file.js --json</code></li>
<li class="">诊断码：<a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/reference/diagnostics">词典</a></li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="为什么重要">为什么重要<a href="https://nudojs.github.io/nudo/zh-Hans/blog/agents-docs#%E4%B8%BA%E4%BB%80%E4%B9%88%E9%87%8D%E8%A6%81" class="hash-link" aria-label="为什么重要的直接链接" title="为什么重要的直接链接" translate="no">​</a></h2>
<p>2026 年的工具文档，看的是 coding agent 能否<strong>不靠猜产品名词</strong>就完成配置与门禁。Nudo 发布 <code>agents.md</code> + <code>llms.txt</code>，让「欢迎回到 JavaScript」对机器同样可执行。</p>]]></content:encoded>
            <category>ai</category>
            <category>mcp</category>
            <category>nudo</category>
            <category>agents</category>
            <category>launch-series</category>
        </item>
        <item>
            <title><![CDATA[22 个文件被涂抹——调用点归因如何险些把假精度当成真发布]]></title>
            <link>https://nudojs.github.io/nudo/zh-Hans/blog/attribution-gate</link>
            <guid>https://nudojs.github.io/nudo/zh-Hans/blog/attribution-gate</guid>
            <pubDate>Mon, 21 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[发布系列（5/5）—— 2026-09-21 同日成套发布。建议按序阅读：]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><strong>发布系列</strong>（5/5）—— 2026-09-21 同日成套发布。建议按序阅读：
<a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/day0-observe">Day 0 —— 不改写就观察 JavaScript</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/day1-contracts">契约就是 JS —— Day 1 与侧车 *.nudo.js</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/vs-typescript">Nudo vs TypeScript —— 何时该选 JS-first 门禁</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/agents-docs">面向 coding agent 的 Nudo —— agents.md、agent 集成与稳定诊断码</a> · <strong>22 个文件被涂抹——调用点归因如何险些把假精度当成真发布</strong></p>
</blockquote>
<p>调用点发现（<code>nudo test lib/ --from test/</code>）从使用处采集真实实参形态并合成 <code>call@L…</code> case。承诺是零成本精度：不要指令、不要标注，只要你的代码<strong>实际被调用时</strong>的实参。</p>
<p>零成本精度有黑暗面：<strong>归因到错误函数的精度</strong>看起来和成功一模一样。这是归因门的故事——一个 bug 让一个测试 helper 在 22 个文件里制造出 51 条假的「精确」结果，以及关住它的三条不变量。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="症状">症状<a href="https://nudojs.github.io/nudo/zh-Hans/blog/attribution-gate#%E7%97%87%E7%8A%B6" class="hash-link" aria-label="症状的直接链接" title="症状的直接链接" translate="no">​</a></h2>
<p>第一次对真实包的试验里，覆盖率数字跳涨——<code>@hapi/hoek</code> 从 54.8% 到 98.6% 的函数有了精确 case。好得可疑。翻看合成 case 找到了原因：一个定义在测试文件里的 helper 恰好与 22 个库文件里的函数同名。它的一条调用记录被匹配到了每一个声明了同名函数的文件。22 个文件、51 条记录，全是假的：每一条「精确」结果都是 helper 的记录穿着别的函数的名字。</p>
<p>试验数字是一次对谎言的忠实测量。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="不变量归因而不是名字匹配">不变量：归因，而不是名字匹配<a href="https://nudojs.github.io/nudo/zh-Hans/blog/attribution-gate#%E4%B8%8D%E5%8F%98%E9%87%8F%E5%BD%92%E5%9B%A0%E8%80%8C%E4%B8%8D%E6%98%AF%E5%90%8D%E5%AD%97%E5%8C%B9%E9%85%8D" class="hash-link" aria-label="不变量：归因，而不是名字匹配的直接链接" title="不变量：归因，而不是名字匹配的直接链接" translate="no">​</a></h2>
<p>修复是<strong>归因门</strong>：只有当记录被解析出的模块实际指向该文件时——经调用的函数模块，或所绑定导出的目标模块——这条调用记录才参与该文件的匹配。只靠名字匹配，早晚会撞上同名 helper；门让<strong>模块身份</strong>成为真相源。</p>
<p>另外两条不变量补上剩余缺口：</p>
<ul>
<li class=""><strong>使用处泄漏标记。</strong> 在执行使用处代码期间捕获的记录会被标记。它们作为<em>实参证据</em>被信任——调用方传入的形态是真实的——但求值器绝不把测试本地的求值环境当成库自身的环境。</li>
<li class=""><strong><code>never</code> / <code>never</code> 过滤。</strong> 结果类型为 <code>never</code> <strong>且</strong>抛出类型为 <code>never</code> 的记录并没有真正返回——求值在调用中途被打断（如 <code>new Promise(async ...)</code> 执行器里的 <code>await</code>）。这些记录在注入前被过滤，而不是当作「返回 never」。</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="有意义的数字">有意义的数字<a href="https://nudojs.github.io/nudo/zh-Hans/blog/attribution-gate#%E6%9C%89%E6%84%8F%E4%B9%89%E7%9A%84%E6%95%B0%E5%AD%97" class="hash-link" aria-label="有意义的数字的直接链接" title="有意义的数字的直接链接" translate="no">​</a></h2>
<p>加上门之后，诚实的试验数字是 <code>@hapi/hoek</code> 98.6% 覆盖率、<strong>0 条错误归因</strong>（从 291 条假记录降下来）；<code>@discoveryjs/json-ext</code> 91.8%、0 条假记录。头条数字几乎没变——但只有零这一列让它有意义。</p>
<p>没有归因故事的精度声明都是营销。Nudo 发布的每个关于调用点发现的数字都被这三条不变量门禁；完整设计（安全边界、合并策略、<code>--from</code> 天花板）在 <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/callsite-discovery">调用点发现指南</a>，诚实边界在 <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/concepts/limits">Limits</a>。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="为什么这对产品重要">为什么这对产品重要<a href="https://nudojs.github.io/nudo/zh-Hans/blog/attribution-gate#%E4%B8%BA%E4%BB%80%E4%B9%88%E8%BF%99%E5%AF%B9%E4%BA%A7%E5%93%81%E9%87%8D%E8%A6%81" class="hash-link" aria-label="为什么这对产品重要的直接链接" title="为什么这对产品重要的直接链接" translate="no">​</a></h2>
<p>Nudo 的契约是「忠实观察」。假的精确结果比 <code>unknown</code> 更糟：<code>unknown</code> 告诉你引擎没有信息；假精度则自信地告诉你错误的信息。归因门不是性能优化——它是推断与编造之间的分界线。</p>
<p>运行 <code>nudo test --from</code> 就继承了这套安全设计。守护你 CI 诚实的合并策略与 <code>--from</code> 边界都写在<a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/callsite-discovery">指南</a>里；未覆盖函数的 <code>entry@</code> 回退就是诚实的下限。</p>]]></content:encoded>
            <category>engineering</category>
            <category>callsite-discovery</category>
            <category>launch-series</category>
        </item>
        <item>
            <title><![CDATA[Day 0 —— 不改写就观察 JavaScript]]></title>
            <link>https://nudojs.github.io/nudo/zh-Hans/blog/day0-observe</link>
            <guid>https://nudojs.github.io/nudo/zh-Hans/blog/day0-observe</guid>
            <pubDate>Mon, 21 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[发布系列（1/5）—— 2026-09-21 同日成套发布。建议按序阅读：]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><strong>发布系列</strong>（1/5）—— 2026-09-21 同日成套发布。建议按序阅读：
<strong>Day 0 —— 不改写就观察 JavaScript</strong> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/day1-contracts">契约就是 JS —— Day 1 与侧车 *.nudo.js</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/vs-typescript">Nudo vs TypeScript —— 何时该选 JS-first 门禁</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/agents-docs">面向 coding agent 的 Nudo —— agents.md、agent 集成与稳定诊断码</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/attribution-gate">22 个文件被涂抹——调用点归因如何险些把假精度当成真发布</a></p>
</blockquote>
<p>欢迎回到 JavaScript。Nudo 不要求你在看到类型、门禁义务之前，先把 JS 包改写成另一种语言表面。</p>
<p><strong>Day 0 产品面：</strong> <code>nudo check</code> 成功与失败都会打印 signatures。调用点就是证据。无约束入口参数显示为 <strong><code>any</code></strong>——不是 <code>unknown</code>。可选的 <code>nudo test</code> 报告调试用例；它不是 CI 门禁。</p>
<div class="language-bash codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-bash codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs check src/</span><br></div></code></pre></div></div>
<div class="language-text codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-text codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">signatures</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  subtract(a: any, b: any) =&gt; number</span><br></div></code></pre></div></div>
<p>即使没有侧车契约，导出函数也携带 L2 运行时边界：入口函数未消化的 may-throw 是 error（<code>nudo:entry-may-throw</code>），迁移期间可过滤。</p>
<p>在 <a class="" href="https://nudojs.github.io/nudo/zh-Hans/playground">Playground</a> 里试，或读 <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/getting-started/quick-start">Quick Start</a>。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="为什么-day-0-重要">为什么 Day 0 重要<a href="https://nudojs.github.io/nudo/zh-Hans/blog/day0-observe#%E4%B8%BA%E4%BB%80%E4%B9%88-day-0-%E9%87%8D%E8%A6%81" class="hash-link" aria-label="为什么 Day 0 重要的直接链接" title="为什么 Day 0 重要的直接链接" translate="no">​</a></h2>
<p>TypeScript 的默认叙事是「先标注」。Nudo 的默认叙事是<strong>先观察</strong>：在 Abs 上跑抽象解释器，打印执行计算出的东西，再决定要把哪些义务写下来。</p>
<p>这正合 JavaScript-first 的代码库——工具 CLI、脚本层、插件宿主——改写成 <code>.ts</code> 不是它们的产品路径。</p>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="下一步">下一步<a href="https://nudojs.github.io/nudo/zh-Hans/blog/day0-observe#%E4%B8%8B%E4%B8%80%E6%AD%A5" class="hash-link" aria-label="下一步的直接链接" title="下一步的直接链接" translate="no">​</a></h2>
<p>Day 1 是契约：<code>*.nudo.js</code> / <code>@nudo:contract</code>，然后是 <code>nudo check</code> 的 L1 门禁（<code>actual ⊭ expected</code>）。见 <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/contract">nudo contract</a>。</p>]]></content:encoded>
            <category>nudo</category>
            <category>type-inference</category>
            <category>check</category>
            <category>launch-series</category>
        </item>
        <item>
            <title><![CDATA[契约就是 JS —— Day 1 与侧车 *.nudo.js]]></title>
            <link>https://nudojs.github.io/nudo/zh-Hans/blog/day1-contracts</link>
            <guid>https://nudojs.github.io/nudo/zh-Hans/blog/day1-contracts</guid>
            <pubDate>Mon, 21 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[发布系列（2/5）—— 2026-09-21 同日成套发布。建议按序阅读：]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><strong>发布系列</strong>（2/5）—— 2026-09-21 同日成套发布。建议按序阅读：
<a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/day0-observe">Day 0 —— 不改写就观察 JavaScript</a> · *<em>契约就是 JS —— Day 1 与侧车 <em>.nudo.js</em></em> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/vs-typescript">Nudo vs TypeScript —— 何时该选 JS-first 门禁</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/agents-docs">面向 coding agent 的 Nudo —— agents.md、agent 集成与稳定诊断码</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/attribution-gate">22 个文件被涂抹——调用点归因如何险些把假精度当成真发布</a></p>
</blockquote>
<p>Nudo 的契约产品<strong>不是</strong>第二套类型语言。契约是普通 JavaScript 模块：自动绑定同名导出的侧车 <code>*.nudo.js</code>，或源码内 <code>@nudo:contract</code>。</p>
<div class="nudo-code-playground"><div class="nudo-code-playground-bar"><a class="nudo-code-playground-link" href="https://nudojs.github.io/nudo/zh-Hans/playground#code=JTJGJTJGJTIwcHJpY2luZy5udWRvLmpzJTBBaW1wb3J0JTIwJTdCJTIwbnVtYmVyJTJDJTIwZm4lMjAlN0QlMjBmcm9tJTIwJTIyJTQwbnVkb2pzJTJGY29yZSUyMiUzQiUwQSUwQWV4cG9ydCUyMGNvbnN0JTIwbGluZVRvdGFsJTIwJTNEJTIwZm4oJTBBJTIwJTIwJTdCJTIwcHJpY2UlM0ElMjBudW1iZXIoKS5ndCgwKSUyQyUyMHF0eSUzQSUyMG51bWJlcigpLmdlKDEpJTIwJTdEJTJDJTBBJTIwJTIwbnVtYmVyKCkuZ3QoMCklMEEpJTNCJTBB" target="_blank" rel="noopener noreferrer" title="Open this snippet in the browser playground">在 Playground 中运行<span aria-hidden="true"> ↗</span></a></div><div class="language-javascript codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-javascript codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// pricing.nudo.js</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword module" style="color:#00009f">import</span><span class="token plain"> </span><span class="token imports punctuation" style="color:#393A34">{</span><span class="token imports"> number</span><span class="token imports punctuation" style="color:#393A34">,</span><span class="token imports"> fn </span><span class="token imports punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword module" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@nudojs/core"</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword module" style="color:#00009f">export</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> lineTotal </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">fn</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token literal-property property" style="color:#36acaa">price</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">number</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">gt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token literal-property property" style="color:#36acaa">qty</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">number</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">ge</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token function" style="color:#d73a49">number</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token method function property-access" style="color:#d73a49">gt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><br></div></code></pre></div></div></div>
<div class="language-bash codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-bash codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">npx nudojs check pricing.js</span><br></div></code></pre></div></div>
<div class="language-text codeBlockContainer_eCmC theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_rVpS"><pre tabindex="0" class="prism-code language-text codeBlock_dCLX thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_R8QI"><div class="token-line" style="color:#393A34"><span class="token plain">issues</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  [ERROR L5 lineTotal] lineTotal[price]: argument ⊭ precondition  (nudo:constraint-violated)</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      actual:   0  #exact</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      expected: price &gt; 0</span><br></div></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="产品规则">产品规则<a href="https://nudojs.github.io/nudo/zh-Hans/blog/day1-contracts#%E4%BA%A7%E5%93%81%E8%A7%84%E5%88%99" class="hash-link" aria-label="产品规则的直接链接" title="产品规则的直接链接" translate="no">​</a></h2>
<table><thead><tr><th>规则</th><th>含义</th></tr></thead><tbody><tr><td>契约面</td><td><code>*.nudo.js</code> / <code>@nudo:contract</code>（<code>@nudo:contract</code> 是别名）</td></tr><tr><td><code>@nudo:case</code></td><td>仅调试见证——绝不是契约产品</td></tr><tr><td>草稿</td><td><code>nudo contract --draft</code> 可审查；从不自动绑定</td></tr><tr><td>check vs export</td><td><code>check</code> 校验 Abs；<code>export</code> 有损投影 dts/zod/guards</td></tr><tr><td>any vs unknown</td><td>入口 <code>any</code> = 无约束；<code>unknown</code> = 推导失败</td></tr></tbody></table>
<p>逻辑先行的团队从调用点起草；契约先行的团队先写侧车。两者在同一 Abs 面上汇合。</p>
<p>下一步：<a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/contract">契约指南</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/reference/diagnostics">诊断码</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/recipes">配方</a>。</p>]]></content:encoded>
            <category>nudo</category>
            <category>contracts</category>
            <category>check</category>
            <category>launch-series</category>
        </item>
        <item>
            <title><![CDATA[Nudo vs TypeScript —— 何时该选 JS-first 门禁]]></title>
            <link>https://nudojs.github.io/nudo/zh-Hans/blog/vs-typescript</link>
            <guid>https://nudojs.github.io/nudo/zh-Hans/blog/vs-typescript</guid>
            <pubDate>Mon, 21 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[发布系列（3/5）—— 2026-09-21 同日成套发布。建议按序阅读：]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><strong>发布系列</strong>（3/5）—— 2026-09-21 同日成套发布。建议按序阅读：
<a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/day0-observe">Day 0 —— 不改写就观察 JavaScript</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/day1-contracts">契约就是 JS —— Day 1 与侧车 *.nudo.js</a> · <strong>Nudo vs TypeScript —— 何时该选 JS-first 门禁</strong> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/agents-docs">面向 coding agent 的 Nudo —— agents.md、agent 集成与稳定诊断码</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/blog/attribution-gate">22 个文件被涂抹——调用点归因如何险些把假精度当成真发布</a></p>
</blockquote>
<p>诚实定位：Nudo 的目标是在 <strong>JavaScript-first 代码库里取代 TypeScript 作为日常类型门禁</strong>——而不是重写 TypeScript 编译器。</p>
<table><thead><tr><th></th><th>TypeScript</th><th>Nudo</th></tr></thead><tbody><tr><td>主要表面</td><td><code>.ts</code> + 标注</td><td>纯 <code>.js</code></td></tr><tr><td>契约</td><td>类型语言</td><td><code>*.nudo.js</code> 构造器 + <code>@nudo:contract</code></td></tr><tr><td>推断</td><td>来自标注</td><td>来自<strong>执行</strong>代码于 Abs 之上</td></tr><tr><td>CI 门禁</td><td><code>tsc --noEmit</code></td><td><code>nudo check</code></td></tr><tr><td><code>.d.ts</code></td><td>模型本身</td><td>Abs 的<strong>有损投影</strong></td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="优先-nudo-的情形">优先 Nudo 的情形<a href="https://nudojs.github.io/nudo/zh-Hans/blog/vs-typescript#%E4%BC%98%E5%85%88-nudo-%E7%9A%84%E6%83%85%E5%BD%A2" class="hash-link" aria-label="优先 Nudo 的情形的直接链接" title="优先 Nudo 的情形的直接链接" translate="no">​</a></h2>
<ul>
<li class="">包是 JavaScript-first，你拒绝仅为类型引入第二套 IR</li>
<li class="">行为（分支、字符串代数、循环、界）比声明式接口更重要</li>
<li class="">想要 CI 里的运行时形态义务，却不发明 body-AST 槽位</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="保持-typescript-为首的情形">保持 TypeScript 为首的情形<a href="https://nudojs.github.io/nudo/zh-Hans/blog/vs-typescript#%E4%BF%9D%E6%8C%81-typescript-%E4%B8%BA%E9%A6%96%E7%9A%84%E6%83%85%E5%BD%A2" class="hash-link" aria-label="保持 TypeScript 为首的情形的直接链接" title="保持 TypeScript 为首的情形的直接链接" translate="no">​</a></h2>
<ul>
<li class="">代码库是 <code>.ts</code>-first</li>
<li class="">你需要完整的 TS 类型语言本身作为编程工具</li>
<li class="">生态建立在 DefinitelyTyped / project references 上</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_iNnp" id="共存">共存<a href="https://nudojs.github.io/nudo/zh-Hans/blog/vs-typescript#%E5%85%B1%E5%AD%98" class="hash-link" aria-label="共存的直接链接" title="共存的直接链接" translate="no">​</a></h2>
<p><strong>按包拆分</strong>：JS 包用 Nudo LSP + <code>nudo check</code>；TS 包用 <code>tsc</code>。见 <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/coexistence">共存</a> 与 <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/concepts/limits">limits</a>。</p>
<p>完整对照：<a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/vs-typescript">Nudo vs TypeScript</a> · <a class="" href="https://nudojs.github.io/nudo/zh-Hans/docs/guides/migrating-from-typescript">从 TS 迁移</a>。</p>]]></content:encoded>
            <category>nudo</category>
            <category>typescript</category>
            <category>type-inference</category>
            <category>launch-series</category>
        </item>
    </channel>
</rss>