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

非母语写作者做了个评论润色工具,还顺手学会了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-20 19:43:20
俄乌炸桥冲突再升级,相关谈判设想被放弃,普京预告“更沉重打击”

俄乌炸桥冲突再升级,相关谈判设想被放弃,普京预告“更沉重打击”

环球网资讯
2026-11-21 07:06:38
太夸张!A股罕见一幕!还会有新低?

太夸张!A股罕见一幕!还会有新低?

龙行天下虎
2026-11-21 00:00:26
37岁前归化国脚艾克森社媒晒出多张效力中超时期旧照:中国是我生命中非常特别的一个阶段,我一直珍藏着这些故事

37岁前归化国脚艾克森社媒晒出多张效力中超时期旧照:中国是我生命中非常特别的一个阶段,我一直珍藏着这些故事

极目新闻
2026-11-20 09:35:14
刘德华被问到多个流传多年的传闻,他亲口证实“都是真的”

刘德华被问到多个流传多年的传闻,他亲口证实“都是真的”

韩小娱
2026-11-19 08:49:36
女生雨天等车时被轿车水花从头浇到脚,雨伞都被冲变形……上海一司机被罚150元!

女生雨天等车时被轿车水花从头浇到脚,雨伞都被冲变形……上海一司机被罚150元!

新民晚报
2026-11-20 19:55:27
悲催!20多年倾尽60万培养的211毕业生遭裁员,河南老父亲发帖控诉,引发轩然大波

悲催!20多年倾尽60万培养的211毕业生遭裁员,河南老父亲发帖控诉,引发轩然大波

火山詩话
2026-11-20 09:53:44
1300公里的前线,10公里外的和平:乌克兰父亲最刺骨的战争真相

1300公里的前线,10公里外的和平:乌克兰父亲最刺骨的战争真相

老马拉车莫少装
2026-10-16 17:34:01
白宫发布特朗普访华视频,中国仪仗队再次出圈,特朗普曾多次大赞“叹为观止”

白宫发布特朗普访华视频,中国仪仗队再次出圈,特朗普曾多次大赞“叹为观止”

极目新闻
2026-11-19 09:25:11
汪祥旺退休四年仍被罢免,光谷那把椅子,坐过的人不止他一个!

汪祥旺退休四年仍被罢免,光谷那把椅子,坐过的人不止他一个!

王姐懒人家常菜
2026-11-21 05:52:24
官媒发文,高调官宣47岁沈腾喜讯,全网恭喜,地位又变了!

官媒发文,高调官宣47岁沈腾喜讯,全网恭喜,地位又变了!

叨唠
2026-11-21 04:53:26
定了!天津这所211大学,即将搬迁!

定了!天津这所211大学,即将搬迁!

天津人
2026-11-21 06:11:54
兴奋剂违规!28岁国羽名将遭禁赛3年 曾获全运会冠军 教练被禁1年半

兴奋剂违规!28岁国羽名将遭禁赛3年 曾获全运会冠军 教练被禁1年半

我爱英超
2026-11-20 19:31:46
油价从6块冲到9块再回8块,账单降了,老百姓的心却回不去了

油价从6块冲到9块再回8块,账单降了,老百姓的心却回不去了

沙雕小琳琳
2026-11-21 00:57:39
扫地出门!曼联“标王”或火速转投尤文!2亿镑强援有望空降红魔

扫地出门!曼联“标王”或火速转投尤文!2亿镑强援有望空降红魔

头狼追球
2026-11-20 13:01:14
局势彻底变天了!54年来头一遭,打破美国总统常规,特朗普在深圳究竟看到了什么?引发舆论热议!

局势彻底变天了!54年来头一遭,打破美国总统常规,特朗普在深圳究竟看到了什么?引发舆论热议!

林杰论事
2026-11-20 12:42:26
广东两孩男子晒42岁妻子例假到访消息 全网集体共情

广东两孩男子晒42岁妻子例假到访消息 全网集体共情

奇思妙想生活家
2026-11-21 02:40:38
中国绝不会接受本土遭到攻击后,还陪着你打所谓的 "有限战争"

中国绝不会接受本土遭到攻击后,还陪着你打所谓的 "有限战争"

迷彩人生
2026-11-13 10:25:30
中方:强烈不满,坚决反对!若美方执意妄为,中方将采取反制措施

中方:强烈不满,坚决反对!若美方执意妄为,中方将采取反制措施

经纬戎韬
2026-11-20 00:09:28
现货黄金直线跳水,跌破760元!深圳水贝金店老板直呼“补早了”:870元至880元时补过一批货,没想到跌得更快

现货黄金直线跳水,跌破760元!深圳水贝金店老板直呼“补早了”:870元至880元时补过一批货,没想到跌得更快

封面新闻
2026-11-20 14:10:14
2026-11-21 09:51:00
码上闲叙
码上闲叙
有态度网友ytd
243文章数 107关注度
往期回顾 全部

教育要闻

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

头条要闻

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

头条要闻

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

体育要闻

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

娱乐要闻

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

财经要闻

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

科技要闻

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

汽车要闻

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

态度原创

手机
健康
游戏
家居
公开课

手机要闻

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

医生眼里"很伤腰"的椅子,很多人天天坐

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

家居要闻

2026建博会(广州) 公装联探展交流活动

公开课

李玫瑾:为什么性格比能力更重要?

无障碍浏览 进入关怀版