网易首页 > 网易号 > 正文 申请入驻

非母语写作者做了个评论润色工具,还顺手学会了FastAPI

0
分享至

每次在 dev.to 发评论前,这位作者都要把草稿粘进 AI 聊天窗口,再粘一遍那段长长的提示词,把修改结果复制回来,最后贴进 dev.to。每一次都这样。


作者不是英语母语者,dev.to 是其公开练习写作的地方。作者不希望拼写或语法错误分散读者对内容的注意力,所以会在发布前用 AI 检查一遍。但每次重复粘贴同一段提示词实在繁琐,于是作者做了一个小型本地网页应用:粘贴评论,拿到修改稿和解释,不用再重复粘贴提示词。

它做什么

界面分两栏。在左侧面板粘贴评论,点击 Revise,会得到四项结果:

  • 修改后的文本:可直接复制发布
  • 段落解释:改了什么、为什么改
  • 历史记录:最近 10 次提交
  • Markdown 语法保留:行内代码和代码块原样不动

作者认为最有用的部分是解释,它把一次纠错变成可以学习的东西。示例:

原文:“I have learned the principles behind the main stream AI agent like OpenClaw, Claude Code.”

修改后:“I have learned the principles behind mainstream AI agents like OpenClaw and Claude Code.”

解释包括两条:把“main stream”改成“mainstream”,使用标准拼写;把“AI agent like OpenClaw, Claude Code”改成“AI agents like OpenClaw and Claude Code”,修正单复数一致和列举标点。

这就是拼写检查器和写作教练的区别。拼写检查器只告诉你改了什么,这个工具还告诉你为什么改。

它怎么工作

浏览器把评论发送到 POST /feedback。FastAPI 先校验请求:空白或只有空格的评论会在调用 AI 之前被拒绝。

llm.py 向 DeepSeek 发送两条消息:一条固定的系统提示词,一条用户评论。系统提示词要求输出两个带确切标题的部分——## Revised Text 和 ## Paragraph Explanations。代码随后按这两个标题切分回复,一次 AI 回复就变成两个字段。

最后,提交记录存入 SQLite,并以 JSON 返回。GET /history 默认返回最近十条提交,由 FastAPI 从 SQLite 读取。

三个决定塑造了代码:提示词是一个文件(prompts.py),不是用户每次手打的;输出格式是一份契约,提示词要求两个标题,代码依赖它们;历史记录用纯 SQL 加 Python 内置的 sqlite3,因为这个项目同时是一次 SQL 学习练习。

怎么建起来的

作者用 GLM-5.3-Flash 构建了这个应用。应用本身调用 DeepSeek 的 API,模型在 .env 中设置(.env.example 使用 deepseek-flash)。

作者从最小的版本开始,先做一个能证明想法的命令行 MVP:第一版从终端读取文本,带上固定系统提示词发送,打印结果。没有界面,没有数据库。它只回答一个问题:AI 修改到底有没有用?答案是有用。

大部分工作花在提示词上。提示词经过几轮修改:先是技术写作和评论的风格,然后是保持作者语气、保留代码块和技术术语的规则,最后是解析器需要的确切输出标题。

接下来,作者把它扩展成 FastAPI 应用,一个 HTML 页面加一个 SQLite 历史记录。作者当时不会 FastAPI,也不懂数据库,于是让 AI 写了第一版。

应用跑起来后,作者试着理解它、学习 FastAPI 和 SQL。从 AI 助手那里得到的建议很简单:读官方文档或教程,然后在项目里找到同样的模式,把两者对照。文档里的示例容易跟,项目代码是真实应用,对照既确认了学到的东西,也暴露了漏掉的细节。

比如 SQL 课程教的是普通语句:

INSERT INTO submissions (original, revised, explanation, model, created_at) VALUES ('...', '...', '...', '...', '...');

项目里的代码却是把值作为参数单独传入。这叫参数化查询,真实应用在运行时就是这样插入数据的。

自己试试

代码在 GitHub 上:dev-comment-reviser。需要 Python 3.10+ 和一个 DeepSeek API 密钥。在 Windows 上,如果 python 不在 PATH 里,用 py -m 代替 python -m。

克隆仓库、进入目录、安装依赖、复制 .env.example 为 .env,把 DeepSeek API 密钥填进 .env,然后启动服务器,打开 http://127.0.0.1:8000。

默认情况下,评论会被发送到 DeepSeek API 修改,历史记录留在本机的 SQLite 文件里。想换别家 API,在 .env 里设置 DS_BASE_URL、DS_MODEL 和 DS_API_KEY。任何兼容 OpenAI 的 API 应该都能用;不兼容的 API 需要改 llm.py 里的客户端。

作者做这个工具的全部理由,就是不想再重复粘贴同一段提示词。作者好奇别人怎么处理这件事:会用 AI 修改写作吗?用哪个工具?这个答案会影响下一步做什么。

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相关推荐
热点推荐
迈阿密主帅:球队必须适应梅西,他状态好球队就会表现更好

迈阿密主帅:球队必须适应梅西,他状态好球队就会表现更好

懂球帝
2026-11-21 04:48:12
读了马斯克我发现:穷人变富最快的方式就3个字,很多人都忽略了

读了马斯克我发现:穷人变富最快的方式就3个字,很多人都忽略了

阿胖读书
2025-06-29 23:00:33
特朗普向英伟达董事会下“政治通牒”:希望黄仁勋返回英伟达

特朗普向英伟达董事会下“政治通牒”:希望黄仁勋返回英伟达

砚底沉香LIU
2026-11-21 08:57:31
“领导夫人跳舞,我们可不敢看!”海淀区母女火出圈,被识破:真正的有钱人才不这样扭

“领导夫人跳舞,我们可不敢看!”海淀区母女火出圈,被识破:真正的有钱人才不这样扭

蝴蝶花雨话教育
2026-11-20 00:05:13
发表争议言论后,留洋土耳其联赛的29岁中国女排名将删文,并禁止评论

发表争议言论后,留洋土耳其联赛的29岁中国女排名将删文,并禁止评论

尘语者
2026-11-20 11:52:35
苏州一企业家获8000多万拆迁款,18年后被以诈骗罪判14年刑,家属:打击报复

苏州一企业家获8000多万拆迁款,18年后被以诈骗罪判14年刑,家属:打击报复

追月数星
2026-11-19 22:11:49
上海一奥迪女销售请客户吃饭,细节被爆出,父母:脸都被丢尽了

上海一奥迪女销售请客户吃饭,细节被爆出,父母:脸都被丢尽了

红豆讲堂
2025-04-14 12:25:10
AI复活电子垃圾之:压了十年泡面的 Kindle,终于翻身了

AI复活电子垃圾之:压了十年泡面的 Kindle,终于翻身了

果壳
2026-11-19 16:17:10
进游戏第一件事!GTA6脱衣舞俱乐部实机画面首曝

进游戏第一件事!GTA6脱衣舞俱乐部实机画面首曝

游民星空
2026-11-18 23:28:03
终于有经济学家批评体制内退休金太高、加剧代际矛盾,评论区炸锅

终于有经济学家批评体制内退休金太高、加剧代际矛盾,评论区炸锅

慧翔百科
2026-06-23 08:47:02
碾压姆巴佩!皇马隐藏真核才是世界第一!穆里尼奥捡到宝

碾压姆巴佩!皇马隐藏真核才是世界第一!穆里尼奥捡到宝

澜归序
2026-11-20 09:37:45
中国首富张一鸣建议公司员工,不要住在城乡结合部,应该全部住在北京市区,哪怕房子小点,省下的时间可以健身读书看电影!

中国首富张一鸣建议公司员工,不要住在城乡结合部,应该全部住在北京市区,哪怕房子小点,省下的时间可以健身读书看电影!

财经要参
2026-11-09 12:00:05
民意彻底逆转!乌克兰人最恨的不是普京,也不是特朗普,而是曾承诺让乌克兰更好的泽连斯基;而他当初能上台,这件事本身就相当离奇

民意彻底逆转!乌克兰人最恨的不是普京,也不是特朗普,而是曾承诺让乌克兰更好的泽连斯基;而他当初能上台,这件事本身就相当离奇

人生录
2026-10-12 15:41:39
印媒:地球上没有任何力量能阻止印度成为35万亿美元的经济体

印媒:地球上没有任何力量能阻止印度成为35万亿美元的经济体

荆楚寰宇文枢
2026-11-05 23:19:37
副高不带助手,一个人做完全程手术!是医院没人了,还是“体谅后辈”?有没有法律风险?单人手术越来越多,医院以后还招医生吗?

副高不带助手,一个人做完全程手术!是医院没人了,还是“体谅后辈”?有没有法律风险?单人手术越来越多,医院以后还招医生吗?

梅斯医学
2026-11-20 07:53:08
阿三又酸了!莫迪没被邀请去深圳参加APEC,印度前部长喊"伤尊严"

阿三又酸了!莫迪没被邀请去深圳参加APEC,印度前部长喊"伤尊严"

行者聊官
2026-11-20 20:30:00
中日斗法:遍布我国的日本学校,被组成困龙局,749局高人一招化解

中日斗法:遍布我国的日本学校,被组成困龙局,749局高人一招化解

天字号野史
2024-11-29 11:55:59
中国帮韩国解了气?韩国网友欢呼中…

中国帮韩国解了气?韩国网友欢呼中…

奋斗在韩国
2026-11-20 11:18:37
你在民政局听到过哪些大八卦?网友:我领离婚证那天就一对结婚的

你在民政局听到过哪些大八卦?网友:我领离婚证那天就一对结婚的

带你感受人间冷暖
2026-11-10 17:14:36
欧盟提议再援乌450亿欧元,冯德莱恩扬言:俄赔偿后乌才需偿还

欧盟提议再援乌450亿欧元,冯德莱恩扬言:俄赔偿后乌才需偿还

军机Nova
2026-11-20 11:19:34
2026-11-21 10:11:00
码上闲叙
码上闲叙
有态度网友ytd
243文章数 107关注度
往期回顾 全部

教育要闻

2026年留学趋势复盘:国内教育与国际教育生源争夺战升级

头条要闻

历时14小时特朗普返回美国 刚下飞机就发布"重大预告"

头条要闻

历时14小时特朗普返回美国 刚下飞机就发布"重大预告"

体育要闻

脚步未停!西班牙摩托车手赤脚徒步入境中国

娱乐要闻

官媒发文 官宣赵丽颖新身份,进步很大

财经要闻

最大回撤超37%,黄金崩盘了吗?

科技要闻

老黄想回来?英伟达董事会:没门

汽车要闻

全新红旗H9最有意思的地方,是它开始有自己的豪华逻辑了

态度原创

手机
教育
游戏
时尚
军事航空

手机要闻

2026年最后一款超模旗舰!小米18标准版屏幕、性能、影像全面领跑

教育要闻

曾经“感动中国”的庞众望完成清华大学博士论文答辩,本人发声:将继续潜心钻研,在科研探索的道路上不断前行

PC Gamer试玩GTA6百小时:双主角出色但任务重复

秋天衣服别总穿纯色,试试这几件条纹单品,简单时尚又减龄

军事要闻

沙特首都第一高楼遭袭:炮弹从天而降

无障碍浏览 进入关怀版