讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

Seko
Seko

AI短剧一键生成成片

Infusion 文档生成 CLI 工具

浅明君_9639

浅明君_9639

发布时间:2024-09-14 08:21:01

|

867人浏览过

|

来源于dev.to

转载

infusion 文档生成 cli 工具

Infusion 是一个开源工具,用于在代码文件中生成文档。它使用OpenAI gpt-4模型来编写注释。这是我的项目,我用 Python 编写的。

GitHub 链接:
https://github.com/SychAndrii/infusion

explainer.js 是一个开源工具,用于解释代码文件中的代码片段。它使用 Groq 模型来编写注释。这是我的队友 @aamfahim 的一个项目,他用 Node.JS 编写的

GitHub 链接:
https://github.com/aamfahim/explainer.js

我目前正在塞内卡理工学院 (Seneca Polytechnic) 参加一门开源课程,我们的任务是与另一个人合作,审查彼此的代码,并使用 GitHub 问题提出一些改进建议。我将描述这个过程。

沟通方式

两个存储库生成的大多数问题都是通过 Discord 调用使​​用同步通信完成的。之后,我们使用 Discord 消息进行异步交谈,因为使用 bash 脚本简化项目设置对我来说是一个困难的问题,并且每次我需要测试它是否在他的机器上运行时打电话给我的队友似乎没有必要。在我的机器上使用 Docker 容器和 WSL Linux 子系统进行测试与在 Al 的系统上进行测试不同,它突出显示了重要的错误。

审查某人代码的经历

在检查队友的代码时,我没有遇到任何异常,因为我有丰富的 Node.JS 开发经验。我喜欢创造问题,然后立即提出解决方案。我们遇到的一个问题是,我们无法找到一种方法让我在我创建的问题上贴上标签,只有 Al 可以做到,这很烦人。

有人审查我的代码的经历

Al 提出了很多改进的空间,特别是在安装我的 CLI 工具方面。当他第一次分叉我的存储库时,最终用户需要手动安装特定版本的 python,这绝对是一项令人沮丧的任务。此外,他还强调了为了方便使用工具而可能进行的其他改进,例如引入 .env 文件,这样您就不必在每次启动该工具时输入 API 密钥。我喜欢从其他人那里获取对我的代码的输入,因为它可以让我成长为一名开发人员,并且它肯定会扩展我对开发生命周期的看法。

git-cliff Git 仓库可定制变更日志生成器
git-cliff Git 仓库可定制变更日志生成器

git-cliff 使用约定式提交和正则表达式驱动的自定义解析器从 Git 历史记录中生成变更日志文件。该工具使用 Rust 编写,通过 TOML 配置文件提供高度可定制的模板,并集成了 GitHub Actions、Docker 和 CI/CD 流水线。

下载

审查和测试期间的问题

我们遇到的大部分问题都与我的工具有关,因为 Al 的 CLI 程序是用 Node.JS 编写的,而且我们都有很多使用它的经验。相比之下,我们都不喜欢Python生态系统,所以我们在与它交互时遇到了很多麻烦。在测试 Al 的存储库时,我发现他的 README 中编写的文档具有误导性或难以理解,尤其是模型和 api-key 选项。我们必须经历反复试验的过程,才能确定他的工具接受哪些 API 密钥和模型。在测试我的存储库时,Al 系统上的 python 版本非常过时(2.7),因此他必须手动安装 3.10.6(使用我的工具所需的版本)。然而,即便如此,问题并没有结束。尽管他安装了它,但我的工具使用 pipelinev 创建的虚拟环境仍然无法识别它。此后,我们每次启动工具时都对输入使用该工具所需的 API 密钥感到沮丧。最后,自述文件对安装没有帮助。我们试图遵循它们,但我们不断收到与 PATH 上无法识别的某些脚本相关的错误。就在那时,我决定我们需要某种自动化工具来为您完成所有安装。我的一个想法是对应用程序进行 docker 化,但随后它需要我以某种方式将 Docker 卷映射到为我的工具指定的输出目录和输入文件,这将使一切变得更加复杂。因此,我记得很多包管理器实际上是命令行工具,如果您通过克隆 GitHub 存储库来安装它们,那么您需要通过执行某种 bash 设置脚本来设置它们。这就是我决定实施的想法。最后,我们都无法找到一种方法来为我们提交的问题分配错误或增强等标签。

我提交的问题

https://github.com/aamfahim/explainer.js/issues/13
https://github.com/aamfahim/explainer.js/issues/12
https://github.com/aamfahim/explainer.js/issues/11
https://github.com/aamfahim/explainer.js/issues/10
https://github.com/aamfahim/explainer.js/issues/9

总结我发现的问题,它们主要涵盖了该项目的自述文件中编写的选项实际上不起作用,或者它们的工作方式被误导性描述的情况。

在我的存储库中提交的问题

https://github.com/SychAndrii/infusion/issues/11
https://github.com/SychAndrii/infusion/issues/10
https://github.com/SychAndrii/infusion/issues/9
https://github.com/SychAndrii/infusion/issues/8

总结一下我的仓库中发现的问题,它们主要与我的工具使用的便利性有关。此外,当您向我的工具提供语法正确的源代码的文件时,存在一个错误,它会将其识别为不包含有效源代码的文件。

我设法解决的问题

我解决了所有问题。所有这些都花了不到 30 分钟的时间来修复,但有一个问题,我花了大约 2-3 个小时才修复:
https://github.com/SychAndrii/infusion/issues/8

这看起来很奇怪,因为自述文件的增强应该很容易实现,但是 Al 的第一个建议要求我完全重新制作我的工具的安装过程,这需要我引入 2 个安装脚本 - 一个用于 bash 和一个用于 Powershell。我大部分时间无法解决的问题是,即使这些安装脚本正确安装了所需版本的python,但该版本的python并没有传递到虚拟环境,您需要在使用我的工具之前进入虚拟环境。最终,我解决了这个问题。

我学到了什么

我的 README 技能确实得到了提高。我提供示例用法的方式让最终用户感到非常困惑。此外,我终于使用 bash 和 powershell 语言自己做了一些事情,不是为了学校作业,不是因为这是一项要求,而是因为我想简化与我的工具交互的过程。最后,我决定面对我绝对无法忍受的语言——那就是Python。使用它对我来说绝对不是一件愉快的事,但我认为如果你今天想找到工作,能够使用它是至关重要的,尤其是在人工智能趋势方面。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

5176

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1475

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1978

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

10703

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

1080

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

3324

2023.09.04

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

1709

2023.09.14

js截取字符串的方法介绍
js截取字符串的方法介绍

JavaScript字符串截取方法,包括substring、slice、substr、charAt和split方法。这些方法可以根据具体需求,灵活地截取字符串的不同部分。在实际开发中,根据具体情况选择合适的方法进行字符串截取,能够提高代码的效率和可读性 。

5729

2023.09.21

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Navicat 18 Linux 用户手册
Navicat 18 Linux 用户手册

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn