[{"content":"开站第一篇说了这个站要写什么，今天进入正题。第一期写自己手搓的小工具——ai-comment-gen，一个 VSCode 插件：选中代码 → 右键 → AI 自动生成注释。掘金上发过开发记录，这篇是站在博客视角的完整版介绍。\n为什么做这个 写注释这件事，做了 10 年前端，从来没真正喜欢过。不是不会写，是不想写——特别是接手别人的烂代码，每行都要猜\u0026quot;这到底在干嘛\u0026quot;；也写过太多\u0026quot;以后补注释\u0026quot;然后永远没补的代码。\nAI 出来后我一直在想：能不能让它把这事干了？试过的已有方案都不解渴：在线工具要复制粘贴，ChatGPT 手动对话更麻烦，现成插件要么太慢要么质量不行。所以干脆自己做一个——1 天时间，做出来了。\n效果长什么样 最直接，看一段代码改造前后：\n// 之前：盯半天 const a = items.filter(x =\u0026gt; x.status === \u0026#39;active\u0026#39;) .sort((a, b) =\u0026gt; b.priority - a.priority) .slice(0, 5); 选中 → 右键 →「AI 生成注释」之后：\n// 从活跃项目中按优先级排序，取前5条 const a = items.filter(x =\u0026gt; x.status === \u0026#39;active\u0026#39;) .sort((a, b) =\u0026gt; b.priority - a.priority) .slice(0, 5); 舒服了。\n三种使用方式 选中生成：右键「AI 生成注释」出简洁一句话；「AI 生成详细注释」出 JSDoc / docstring 整文件批量：右键「AI 为整个文件添加注释」，自动扫描未注释的函数逐个生成，一次最多 5 个（可配），防止手滑烧穿配额 保存时自动补：设置里勾 autoCommentOnSave，每次保存自动补全未注释的函数——懒人专属 语言上自动匹配注释风格：JS/TS 用 // 和 /** */、CSS/SCSS/Less 用 /* */、HTML/Vue 模板用 \u0026lt;!-- --\u0026gt;、Python/Ruby 用 # 和 \u0026quot;\u0026quot;\u0026quot;docstring\u0026quot;\u0026quot;\u0026quot;；中英文在设置里一切换就行。\n技术实现（主体代码 200 行） 技术栈简单到寒酸：Node.js + 官方脚手架 + DeepSeek API（速度快、便宜，百万 token 几块钱）。核心流程就三步：\n// 1. 用户选中代码 → 右键点击 // 2. 调用 AI API 生成注释 // 3. 把注释插入到代码上方 真正花时间的地方：\nPrompt 是灵魂。要注释\u0026quot;不啰嗦也不废话\u0026quot;，试了十几种 Prompt 才找到平衡点，大意是： 你是一个资深前端工程师，请为以下代码生成简洁的中文注释。 只返回注释内容，不要多余的解释。 temperature: 0.3 + max_tokens: 1024。温度越低输出越稳不跑偏，限长防止 AI 开始抒情。 API 走 OpenAI 兼容格式，apiUrl 和 model 都是配置项，默认 DeepSeek，想换任何兼容端点都行。 注释插回编辑器走 WorkspaceEdit——选区行号会动态变，直接改文本必崩，这是 VSCode 扩展 API 给的第一课。 效果实测 拿公司项目测的：\n代码类型 生成速度 注释质量 简单函数 \u0026lt; 1 秒 ⭐⭐⭐⭐⭐ 直接可用 React 组件 1-2 秒 ⭐⭐⭐⭐ 偶尔调几个字 复杂逻辑 2-3 秒 ⭐⭐⭐⭐ 基本能用 CSS/样式 \u0026lt; 1 秒 ⭐⭐⭐⭐⭐ 完美 90% 的场景生成的注释直接可用，改几个字就行，比从零写省 90% 时间。\n但要泼一句冷水 AI 只配写\u0026quot;是什么\u0026quot;，\u0026ldquo;为什么\u0026quot;必须你自己写——它不知道这段 workaround 在绕哪个坑、那个魔法数字是谁拍板的。也别贪多开全文件模式量产 i++ // i 自增 1 式噪音：错的注释比没注释更毒，它会以\u0026quot;文档的权威\u0026quot;误导下一个读代码的人，包括半年后的你。我自己的用法：只对\u0026quot;接手区\u0026quot;选择性生成，what 收下，why 自己补。\n回头看这 1 天 AI 写注释是真的香——不是花架子，是实实在在省时间的工具 小工具也能有大价值——解决一个具体小痛点，比做大而全的产品更有用 VSCode 插件开发比想象中简单——官方文档完善，脚手架一键生成 安装 开源、免费，两个渠道：\nVSCode 插件商店：搜 AI 注释生成器 或 ai-comment-gen（已上架） GitHub：kunjingzhu/ai-comment-gen（MIT），Releases 下载 .vsix → 扩展 → 右上角 ... → 从 VSIX 安装 ⚠️ 需要自备 DeepSeek API Key（platform.deepseek.com 注册，新用户送 500 万 token 额度，够写几万行注释）\n后续计划：更多语言（Go、Rust、Java）、自定义注释风格模板、纯离线模式（本地模型）。觉得有用，去 GitHub 点个 Star ⭐ 让更多人看到。\n本文属于「AI 开发工具」系列。开发过程的完整记录见掘金同名文章，这个博客之后会放更细的实现拆解。\n","permalink":"https://blog.zjkun.top/posts/%E6%90%AD%E7%AB%99%E7%AC%AC%E4%BA%8C%E5%A4%A91%E5%A4%A9%E6%89%8B%E6%90%93%E7%9A%84-vscode-ai-%E6%B3%A8%E9%87%8A%E6%8F%92%E4%BB%B6%E6%AD%A3%E5%BC%8F%E4%BB%8B%E7%BB%8D%E4%B8%80%E4%B8%8B/","summary":"\u003cp\u003e开站第一篇说了这个站要写什么，今天进入正题。第一期写自己手搓的小工具——\u003cstrong\u003e\u003ca href=\"https://github.com/kunjingzhu/ai-comment-gen\"\u003eai-comment-gen\u003c/a\u003e\u003c/strong\u003e，一个 VSCode 插件：选中代码 → 右键 → AI 自动生成注释。掘金上发过开发记录，这篇是站在博客视角的完整版介绍。\u003c/p\u003e","title":"搭站第二天：1天手搓的 VSCode AI 注释插件，正式介绍一下"},{"content":"朱景坤，坐标长沙，前端为主的全栈开发。\n💼 12 年开发经验，Vue / React / TypeScript 为主，正在往 AI 应用方向转型 🤖 在折腾：RAG 全链路（分块、混合检索、Query 改写）、Node/AI 工程化 🐕 在做：3D 打印 × 亚马逊跨境（一个柯基犬的生意） 📕 小红书：「重启老朱」 本站用 Hugo + PaperMod 搭建，部署在自己的服务器上，数据都在自己手里。\n联系：1552394362@qq.com\n","permalink":"https://blog.zjkun.top/about/","summary":"关于老朱","title":"关于我"},{"content":"三年写前端，五年写后端，账号平台换了一个又一个，一直想要一个自己说了算的地方。\n这个站的选型很克制：\n引擎：Hugo（extended v0.168），单二进制、构建毫秒级，2 核 2G 的小服务器毫无压力 主题：PaperMod，简洁路线，分类/标签/归档/搜索全齐 部署：静态文件扔 nginx 容器，域名 zjkun.top，证书 certbot 搜索：先用主题内置的 fuse 站内搜索（零依赖），文章多了再上 Pagefind 评论：暂时关闭。等服务器上独立 MySQL 容器建好，接 Artalk（Go 单进程 + 独立库），免登录评论 以后这里写什么？三条线，和小红书「重启老朱」同源但更深：\nAI 应用 / RAG 实战——混合检索、Query 改写、父子分块这些真跑过、真调过参的东西 全栈踩坑——部署、构建、原生依赖，以及那些报错页面背后的原理 3D 打印跨境——一个柯基犬从打样到上架亚马逊的全程账本 第一篇不放代码了，留个占位——这是本站第一页，更新于 {{ now | date \u0026ldquo;2006-01-02\u0026rdquo; }}。\n种一棵树最好的时间是十年前，其次是把 hugo server 跑起来。\n","permalink":"https://blog.zjkun.top/posts/%E5%BC%80%E7%AB%99%E7%AC%AC%E4%B8%80%E7%AF%87%E4%B8%BA%E4%BB%80%E4%B9%88-2026-%E5%B9%B4%E6%88%91%E8%BF%98%E8%A6%81%E8%87%AA%E5%B7%B1%E6%90%AD%E4%B8%80%E4%B8%AA%E5%8D%9A%E5%AE%A2/","summary":"\u003cp\u003e三年写前端，五年写后端，账号平台换了一个又一个，一直想要一个\u003cstrong\u003e自己说了算\u003c/strong\u003e的地方。\u003c/p\u003e\n\u003cp\u003e这个站的选型很克制：\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e\u003cstrong\u003e引擎\u003c/strong\u003e：Hugo（extended v0.168），单二进制、构建毫秒级，2 核 2G 的小服务器毫无压力\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003e主题\u003c/strong\u003e：PaperMod，简洁路线，分类/标签/归档/搜索全齐\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003e部署\u003c/strong\u003e：静态文件扔 nginx 容器，域名 zjkun.top，证书 certbot\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003e搜索\u003c/strong\u003e：先用主题内置的 fuse 站内搜索（零依赖），文章多了再上 Pagefind\u003c/li\u003e\n\u003cli\u003e\u003cstrong\u003e评论\u003c/strong\u003e：暂时关闭。等服务器上独立 MySQL 容器建好，接 Artalk（Go 单进程 + 独立库），免登录评论\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e以后这里写什么？三条线，和小红书「重启老朱」同源但更深：\u003c/p\u003e","title":"开站第一篇：为什么 2026 年我还要自己搭一个博客"}]