1作者: alonsovm5 个月前
Hi HN, 我是一个独立开发者,厌倦了“文档地狱”,要么花几个小时写文档,结果文档很快就过时了,要么干脆没有文档。我想要一个工具,将文档生成视为一个标准的构建步骤,所以我开发了Docgen。 Docgen是一个用C++编写的轻量级AI CLI工具,它将文档视为代码进行处理。它位于你的代码库中(通过一个.docgen文件夹和一个Docfile),并在你的源代码旁边生成Markdown文件。 以下是一些关于其工作原理的技术细节: - 本地优先 & 私有:它默认使用本地的Ollama,这样你的专有代码永远不会离开你的机器(尽管如果你愿意,它也支持像OpenAI/Gemini这样的云API)。 - 智能增量构建:它使用内容哈希。当你运行docgen update时,它只重新生成实际更改过的文件的文档,从而节省大量的API积分和计算时间。 - 上下文感知(RAG):它会自动分析#include依赖关系,为LLM提供正确的上下文,而不是盲目地向它提供单个文件。 - 零依赖:编译成一个单一的静态二进制文件。只需下载并运行即可。 - “自动”模式:这是我最喜欢的部分。如果你运行“docgen auto”,它会充当一个文件监视器,并内置了防抖动功能(在你停止输入/保存后等待几秒钟)。它会在后台默默地更新你的Markdown文档,让你保持流畅的开发状态。 我目前专注于改进RAG上下文处理。 你可以在这里查看:[https://github.com/alonsovm44/docgen](https://github.com/alonsovm44/docgen) 我很乐意听取你的想法,对架构的批评,或者你认为我应该处理的任何边缘情况!
6作者: yodaiken5 个月前
多年来,人们一直在尝试将更多的编程工作转移给最终用户,而不是专业的开发者。电子表格在这方面非常有趣,因为它们是一个非常成功的案例,当然,我们现在正经历着最新一波浪潮(AI/氛围编码)。 对于那些在电子表格兴起时就在场的人来说,当时的情况是怎样的?人们是否担心它们会消除对专业软件的需求?是否有人将它们视为玩具而置之不理?
1作者: stayicon5 个月前
AI 编码助手(Cursor、Claude Code、Copilot)速度极快,但它们经常会搞乱你的 UI 设计令牌或结构语义,而你直到 PR 合并后才会注意到这一点。 我构建了 drift-guard 来防止这种情况。它是一个纯 CLI 工具(零令牌开销,无 MCP 服务器),可以对你的设计令牌和 DOM 结构进行快照,然后在代码级别检查“漂移”。 工作原理: 1. init 扫描你的 CSS/HTML 并对所有设计令牌(颜色、字体、间距、阴影、圆角、布局、效果)以及你的 DOM 的结构指纹进行快照。 2. rules 为 5 个 AI 工具生成规则文件(.cursorrules, CLAUDE.md, AGENTS.md, copilot-instructions.md, .clinerules)。 3. check 将当前状态与快照进行比较,如果漂移超过阈值,则退出,代码为 1。 关键设计决策: * 零令牌开销:纯 CLI。 * 静态分析:使用 css-tree 和 cheerio(无无头浏览器,< 1 秒)。 * 过时快照警告:如果基线超过 7 天,则发出警告。 * 结构 + 样式:同时监控 CSS 令牌和 DOM 层次结构。 * 提交前钩子:在提交落地前阻止漂移的提交。 GitHub:https://github.com/Hwani-Net/drift-guard npm:npm i -g @stayicon/drift-guard 我很乐意收到反馈!你是否在使用 AI 编码工具时遇到过“设计漂移”问题?
2作者: sajeerzeji5 个月前
全新发布的 Toolpack SDK — 一个完全开源的统一 TypeScript SDK,用于 AI 开发 如果你使用过多个 LLM 提供商,你就会知道其中的痛苦:每个提供商都有不同的 API、不同的工具格式、不同的怪癖。 Toolpack SDK 为你提供了一个跨 OpenAI、Anthropic、Gemini 和 Ollama 的统一接口。 它内置了 77 个工具,用于文件操作、Git、数据库、网页抓取、代码分析和 shell 命令。你也可以创建和集成你自己的自定义工具。 工作流引擎可以逐步规划和执行任务。你开箱即用 Agent 和 Chat 模式,还可以创建根据你的需求定制的自定义模式。如果你想添加其他 LLM,还有一个自定义提供商 API。 完全支持 TypeScript。如果你更喜欢终端 UI 而不是代码,CLI 为你提供了一个交互式聊天界面,让你可以在命令行中使用 AI 和工具。 Toolpack SDK: npm: npm install toolpack-sdk GitHub: github.com/toolpack-ai/toolpack-sdk 文档: toolpacksdk.com 注意:请按照文档说明设置配置,并在环境变量中设置你的 API 密钥。 Toolpack CLI(交互式终端 UI): npm: npm install -g toolpack-cli GitHub: github.com/toolpack-ai/toolpack-cli 注意:安装后,使用终端中的 `toolpack` 命令打开它。请记住按照文档说明在环境变量中设置你的 API 密钥。 https://toolpacksdk.com