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

非母语写作者做了个评论润色工具,还顺手学会了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.

相关推荐
热点推荐
钱再多有什么用,65岁郎平如今的现状,给所有运动员们提了个醒

钱再多有什么用,65岁郎平如今的现状,给所有运动员们提了个醒

墨策讲历史
2026-11-04 22:47:01
央行中央本部,属于公务员还是事业编?

央行中央本部,属于公务员还是事业编?

网观天下
2026-11-21 09:13:35
中国正在失控的商铺空置潮持续蔓延,怎么破解

中国正在失控的商铺空置潮持续蔓延,怎么破解

律法刑道
2026-11-12 09:49:42
性生活是不是人的刚需?网友说:男性性生活是刚需,女性不是!

性生活是不是人的刚需?网友说:男性性生活是刚需,女性不是!

黯泉
2026-11-09 17:39:59
女子欠同乡男子15万主动提出以身抵债,男子拒绝:我有家庭不能趁人之危

女子欠同乡男子15万主动提出以身抵债,男子拒绝:我有家庭不能趁人之危

花小猫的美食日常
2026-11-21 06:19:26
乌克兰袭击克里米亚大桥之后,欧洲国家骤然改口,宣称不会同俄罗斯爆发冲突,这和先前的态度,显然已经发生了180度大转弯

乌克兰袭击克里米亚大桥之后,欧洲国家骤然改口,宣称不会同俄罗斯爆发冲突,这和先前的态度,显然已经发生了180度大转弯

林杰论事
2026-11-19 12:45:59
中文主场绝不能丢!人民日报定调:在中国,绝不允许英文取代中文

中文主场绝不能丢!人民日报定调:在中国,绝不允许英文取代中文

寻墨阁
2026-11-06 22:54:32
奉劝所有普通家庭的孩子:趁父母还能供养你,拼命读书吧

奉劝所有普通家庭的孩子:趁父母还能供养你,拼命读书吧

起喜电影
2026-11-20 02:16:31
1949年李讷在课堂上指出老师错误,老师恼羞成怒:把你爸爸叫来

1949年李讷在课堂上指出老师错误,老师恼羞成怒:把你爸爸叫来

萧竹轻语
2025-08-04 11:45:40
余文乐做客《背后》:左脚韧带撕裂,但我不会拿它当借口

余文乐做客《背后》:左脚韧带撕裂,但我不会拿它当借口

金牌舆情官
2026-11-20 17:45:09
吃饭砸碗!网友:别着急封杀她,让全世界都看看她有多蠢

吃饭砸碗!网友:别着急封杀她,让全世界都看看她有多蠢

动物奇奇怪怪
2026-11-20 16:44:15
局势反转,美国突然反水,宣布对乌新立场,欧盟:这一天终究来了

局势反转,美国突然反水,宣布对乌新立场,欧盟:这一天终究来了

浯江孤舟
2026-11-20 15:18:35
放松限韩令的风声一出,很快就有影响了

放松限韩令的风声一出,很快就有影响了

清晖有墨
2026-11-19 20:30:22
画面不堪入目!百万粉丝女网红被捕,36部污秽视频藏儿童学习机里

画面不堪入目!百万粉丝女网红被捕,36部污秽视频藏儿童学习机里

寒士之言本尊
2026-07-28 15:27:31
雷军:原本和张彤生两个女儿已足够幸福,没想到如今幸福又升级了

雷军:原本和张彤生两个女儿已足够幸福,没想到如今幸福又升级了

阿讯说天下
2026-11-21 07:46:53
广州地铁13号线是快线,为何不能为约百万居民的金沙洲绕路?

广州地铁13号线是快线,为何不能为约百万居民的金沙洲绕路?

小怪吃美食
2026-11-21 03:39:44
全球公认最清廉的国家之一,靠的不是每天查干部,而是一条简单却杀伤力极强的法规:财产可以有,但来路必须讲得明!

全球公认最清廉的国家之一,靠的不是每天查干部,而是一条简单却杀伤力极强的法规:财产可以有,但来路必须讲得明!

扶苏聊历史
2026-11-18 17:18:26
限制已解除,日本政府身份变了,高市早苗出席晚宴,请帖发往韩国

限制已解除,日本政府身份变了,高市早苗出席晚宴,请帖发往韩国

观锐器
2026-11-20 12:19:02
杭州女子驾车过高架遭风筝线“割顶”,车损达3万余元,最新:肇事者已找到,车主放弃索赔,“放风筝时务必远离城市道路和人员密集区域”

杭州女子驾车过高架遭风筝线“割顶”,车损达3万余元,最新:肇事者已找到,车主放弃索赔,“放风筝时务必远离城市道路和人员密集区域”

极目新闻
2026-11-19 21:31:44
流亡的阿萨德一家何去何从?俄罗斯近日表明了明确态度:即便法院判了死刑,阿萨德也休想离开俄罗斯

流亡的阿萨德一家何去何从?俄罗斯近日表明了明确态度:即便法院判了死刑,阿萨德也休想离开俄罗斯

人生录
2026-10-22 00:20:08
2026-11-21 10:00:49
码上闲叙
码上闲叙
有态度网友ytd
243文章数 107关注度
往期回顾 全部

教育要闻

四年级奥数,难哭很多学生,三阶幻方

头条要闻

牛弹琴:美媒发文"追杀"黄仁勋 细节绝对拉满触目惊心

头条要闻

牛弹琴:美媒发文"追杀"黄仁勋 细节绝对拉满触目惊心

体育要闻

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

娱乐要闻

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

财经要闻

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

科技要闻

Anthropic收涨17.1%,市值一度破2万亿美元

汽车要闻

35万级MPV的满配答案 享界V8正式上市售31.98万起

态度原创

健康
游戏
本地
手机
军事航空

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

《流放之路:降临》国服1.0定档12月12日!我和制作人现场见证并聊了聊

本地新闻

43年起落记忆倒计时,去厦门高崎领绝版登机牌!

手机要闻

华为星芒O1 Pro定价5499元起引争议,总经理刘赫回应称“我们选择创新优先”

军事要闻

俄乌炸桥冲突升级 相关谈判设想被放弃

无障碍浏览 进入关怀版