给小工具补上的路径检查课

同一需求,三种做法:一个AI小工具里的产品经理、工程师与架构师 同一件事——从股票交易所披露易搜索年报/半年报等公告,下载 PDF,抽取营收同比、EPS 同比、分红变化,再汇总成报告——我们先后尝试了几条路: - 用对话式 AI 编程助手一站式做出本机 Web 工具 - 用 AI 赋能的 IDE 做出可命令行验证的引擎 - 用「AI 赋能的 IDE + 低代码 Agent 平台」做成云端表单入口。 本文把它们放在一起讲:不是比谁「更高级」,而是说明不同协作方式,适配不同角色与不同交付形态。 阅读详情

给小工具补上的路径检查课

路径规则要写到测试里

把失败写成能读懂的结果

我会给这类工具再留几条反例:输入为空、外部依赖拒绝、重复执行和中途取消。断言不仅检查 Result,也检查状态是否被提前修改、临时文件是否清理。这样失败时可以直接判断是契约改变,还是某条收尾分支漏掉了。

错误信息也要指向用户能处理的位置。说明哪个参数或文件有问题,保留必要的底层上下文,不把一长串内部调用栈当作提示。可预测的失败路径比“尽量自动修复”更适合小工具。
允许目录不是一个口头约定。把根目录、允许的扩展名和符号链接策略收进一个小函数,所有读写都从它走。规范化路径之后再判断前缀,避免看起来在工作目录内、实际跳到别处的输入。遇到不能解析的路径,报错比悄悄跳过更容易发现配置问题。

拒绝样例很有价值:父目录穿越、绝对路径、软链接指向工作区外、空路径,各留一个。它们不需要模拟完整命令行,只要证明校验层没有被绕开。后面新加子命令时,复用同一入口,才不会每个命令再写一遍各不相同的保护。
写本地工具时,我以前把“用户传进来的路径”当成普通字符串。后来才明白,路径会同时影响配置读取、输出位置和错误信息,处理得随意就容易越过预期目录。这里记录的是我给练习项目补安全检查的过程,不是完整的权限系统。

先明确工具允许碰什么

开始前先列一张很朴素的表:配置只能从项目目录读取,生成物只能写进指定输出目录,缓存目录单独传入。这样函数不必拿整个工作区路径,更不用到处调用当前目录。若命令需要网络、子进程或环境变量,也要分别说明;文件路径检查只能限制文件访问,不能替代这些权限。

路径校验不能只搜索 ../。不同系统有绝对路径、符号链接和分隔符差异。一个容易理解的做法是先把候选路径与根目录拼接,规范化后检查它是否仍以根目录开头。文件可能还不存在,因此不能把“能否规范化”为唯一判断。对准备创建的文件,应分别校验父目录与最终文件名。

用拒绝样例固定边界

测试里我会把正常路径和越界路径放在一起看,重点不是让测试名字好看,而是让失败原因清楚:

#[test]
fn rejects_parent_directory_escape() {
    let root = std::path::Path::new("fixtures/work");
    assert!(checked_path(root, "notes/today.txt").is_ok());
    assert!(checked_path(root, "../secret.txt").is_err());
}

接着运行 cargo test path_policy。如果实现需要依赖真实目录,就在临时目录创建最少文件,不要借用自己的家目录。错误信息也不要把机器上的完整敏感路径直接打印给终端用户;对外可以说明“路径不在允许目录中”,调试时再记录受控的上下文。

不把检查误当成保证

一个常见误区是校验通过后,再用原始字符串去打开文件。这样等于绕过刚做的工作,后续操作必须使用校验函数返回的路径。另一个误区是忽略符号链接:在有链接的目录里,字符串前缀看起来安全,实际目标可能已经离开根目录。是否需要处理它,要由工具的运行环境决定,不能照抄一段代码就宣称解决了所有问题。

我给自己留的检查顺序是:先收窄能力,再校验输入,再写拒绝测试,最后在命令层显示实际操作范围。这个顺序不酷,但对刚学 Rust 的我来说,比试图一次搭出“安全框架”更容易验证和维护。

C++游戏开发入门:从语法到完成第一个小游戏的完整路径 编程学习常从语法开始,但真正动手做项目时,环境配置与工程结构往往是第一道坎。C++ 语言本身提供变量、类、向量等基础工具,而游戏开发则需将其组织为窗口管理、输入处理、逻辑更新与渲染循环的完整结构。理解从控制台程序到交互式应用的跃迁,掌握编译器、调试器与运行库的协同工作,是技术落地的关键。在 Windows 平台,Visual Studio 或 VS Code 配合 MinGW 是常见选择,同时需注意 Microsoft Visual C++ Redistributable 的安装,否则程序可能因缺少运行库而 阅读详情

相关推荐

vibe coding 完整学习路径:从自然语言驱动到工程化落地

随着 AI 编程工具的爆发,自然语言驱动开发(vibe coding)正从一种极客玩法演变为软件工程的新范式。它并非“偷懒式编程”,而是将人类意图翻译为代码的新协作方式:开发者用结构化描述定义需求与边界,AI 负责生成实现,再通过代码审查、异常补强、测试与版本管理完成工程化兜底。面对复杂业务,还可引入 spec-driven(规格驱动)与 agent harness 约束机制,让 AI 在明确范围内高效产出。文章梳理了一条从零基础到团队落地的学习路径,涵盖工具选型、提示词技巧、常见坑点与真实案例复盘,适合希

weixin_33843409的博客 402

functions.php 里加小工具,把 Codex 的 Base URL 改到 TaoToken 后跑通

functions.php 里加小工具却拖不动,多半是没注册侧边栏。这篇直接让 Codex 补全 register_sidebar,并把 Codex 的 Base URL 改到 TaoToken 统一 API 通道后跑通全流程。从官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 拿 Key,改 ~/.codex/config.toml 里的模型 ID 和接口地址,再让 Codex 生成带 function_exists 判断的代码,最后回

weixin_42588555的博客 9

用C# WinForms开发定时自动清理过期文件的小工具

磁盘空间紧张常常源于临时文件、日志和备份文件的持续堆积。针对这一场景,定时删除机制结合文件生命周期管理成为高效解决方案。文章从需求边界出发,介绍了如何利用C# WinForms构建可视化配置界面,通过Timer控件实现定时扫描,依据文件最后写入时间判断过期条件,并支持回收站保护和扩展名过滤。同时探讨了.NET Framework 4.7.2与.NET 8的选型权衡,以及框架依赖与自包含发布对分发的实际影响。该方案适用于数据库备份清理、日志滚动和下载目录整理等典型场景,既有实践代码,也有排坑经验,为需要自动化

weixin_33834137的博客 321

Cherry Studio 用户看 HanaAgent,TaoToken 补上自主执行

从 Cherry Studio 迁移到 HanaAgent 执行模式,最容易卡住的是模型入口和权限边界。TaoToken 在这里扮演统一出口:注册 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建 Key,把 Base URL 填成 https://taotoken.net/api,HanaAgent 四类模型(对话、大工具、小工具、视觉)分别绑定不同型号,成本立刻可解释;同一 Key 还能复用到 Claude Code 的 setting

weixin_42607969的博客 11

数据集分享 | IWR1642呼吸心跳数据集

雷达开源数据库 数据集

【调皮连续波】雷达技术领域知识博主 3209

利用Skipper跨层追踪技术高效定位LVS Short问题

本文详细介绍了如何利用Skipper跨层追踪技术高效定位LVS Short问题。通过解析Skipper的跨层trace net原理和实战操作步骤,帮助芯片设计工程师快速识别版图中的短路问题,显著提升验证效率。文章还提供了处理大规模设计的高级技巧和常见问题排查方法。

weixin_29239661的博客 510

大模型API接入指南:从五分钟打通链路到构建AI小工具

大模型API接入本质上是基于HTTP协议的一次请求-响应交互,开发者通过POST请求携带结构化消息与模型通信,其中Token作为计费与上下文处理的基本单位,直接影响调用成本与输出限制。理解这一基本原理,是完成从“拿到API Key”到“稳定调用”的关键。在实际工程中,选择适配场景的模型、合理编排messages结构、控制max_tokens与temperature参数,并建立错误排查与成本监控机制,才能将单次请求转化为可复用的AI小工具。本文从命令行快速验证连通性开始,逐步演示用Python封装周报生成器等

weixin_30621959的博客 365

告别臃肿VS!仅用Visual Studio 2022 Build Tools为Qt 5.12.12配置MSVC2017开发环境

本文详细介绍了如何仅使用Visual Studio 2022 Build Tools为Qt 5.12.12配置MSVC2017开发环境,避免安装臃肿的完整VS。通过精准选择组件、配置Qt Creator编译器和优化Kit设置,实现高效、精简的Windows平台Qt开发环境搭建,特别适合追求性能和资源优化的开发者。

weixin_30340617的博客 352

Claude Code 用量监控:菜单栏小工具让 Token 消耗一目了然

在大模型驱动的开发流程中,Token 是计费的基本单位,而 Claude Code 这类 Agent 工具会在一次任务中发起多轮请求,累计消耗往往远超预期。理解 Usage(用量)与 Quota(额度)的差异,是控制成本的前提。通过解析本地日志或调用 API 接口,开发者可以实时掌握当前消耗。菜单栏工具正是将这一能力轻量化呈现,它常驻系统顶部,在运行长任务前即可快速评估用量是否充裕,避免任务中途触发额度告警。对于高频使用 Claude Code 的开发者、共享团队账号或接入第三方模型网关的用户,这类工具提供

weixin_34152820的博客 451

有关SPSS中Fisher精确检验无法进行的解决方法(由于无法打开临时文件,因此无法进行计算)

最近在帮一个四年生完成她的毕业论文,在用SPSS进行R×C表检验的时候,发现Fisher精确检验的结果无法显示,提示为“由于无法打开临时文件,因此无法进行计算”,大概像下图一样。 (这图是从网上找的) 然...

chuyang37的博客 3万+

Foxmail 7.2.25以下版本XSS漏洞实战复现:手把手教你如何构造恶意邮件(含防御方案)

本文深入解析Foxmail 7.2.25以下版本的XSS漏洞(CNVD-2025-06036),详细展示如何构造恶意邮件进行跨站脚本攻击,并提供从客户端升级到企业级防护的多层次防御方案,帮助用户有效防范安全风险。

view3的博客 164

colorpix取色小工具_Tableau——给新手的一些实用小技巧

(头图来源于网络)定位:放的教程偏简单,主要是记录自己的学习过程,外加给新人指指路,外加做教程备份~有官方教程会先放官方教程,视情况也会加一点自己的内容(比如一些额外的辅助小工具)。也是一个不定期更新的系列,这个系列会比坑系列长一些,毕竟能轻松解决的问题都不能算是问题。搭tableau的情景显示:模板颜色设置背景:当被要求按指定色系来搭系统(PS咨询师写PPT也会根据客户VI系统去设置配色表)先上...

weixin_39652658的博客 559

airodump-ng、aircrack-ng使用教程

wifi破解、airodump-ng、aircrack-ng脚本

ssmbyss的博客 2237

AI智能体开发入门:一份免费的18节课进阶路线图

如果你已经让大模型帮你写过周报、改过代码、翻译过文档,你可能会遇到一个共同的问题:**AI很聪明,但它不会"干活"**。它无法替你查数据库里的订单状态,无法在确认价格后帮你下单,更无法在处理到一半时发现"方向错了"然后自己纠正回来。 这恰恰是"AI聊天机器人"和"AI智能体"之间那条最深的鸿沟。今天要介绍的这个开源项目 `ai-agents-for-beginners`,就是专门用来填平这条鸿沟

gitblog_00368的博客 266

粒子群优化与蚁群算法求解多旅行商问题

它要求在给定一组城市和旅行商之间的距离矩阵的情况下,找到一条最优的路径方案,使得所有旅行商可以分别从起始城市出发,途径其他城市,并最终回到起始城市,同时总旅行距离达到最小。这两种算法都是基于群体智能的优化算法,在求解组合优化问题时具有较好的性能表现。假设有n个城市需要被m个旅行商访问,城市间的距离由距离矩阵D表示,其中D(i,j)表示第i个城市到第j个城市的距离。粒子群优化算法是一种基于群体智能的优化算法,其中的粒子代表了潜在的解,并通过模拟粒子在解空间中的移动来搜索最优解。一、多旅行商问题建模。

m0_47037246的博客 553

基于PCL的电力线点云提取与分割实现

本文基于PCL库实现电力线点云提取与分割,包含6个核心处理阶段:文件读取与结果文件夹创建、高程滤波分割候选点云、欧式聚类去噪、电力线分段提取、球形邻域搜索补全点云、最终分割与可视化保存。通过PCA计算点云线性特征(阈值0.91)筛选电力线点,采用欧式聚类(容忍度3.0)去除噪点,并针对不同规模聚类差异化设置球形搜索半径(4.0/6.0)补全点云。最终通过欧式聚类分割并可视化带颜色点云。算法对高程滤波阈值、聚类参数等具有敏感性,需根据点云特性调整优化。

weixin_45196569的博客 197

世界杯开幕了,手把手教你做个看球小工具

这篇文章介绍了如何开发一个轻量级的世界杯赛程查询工具。文章首先分析了核心需求:按球队或日期查询比赛,并自动转换时区显示北京时间。然后详细讲解了项目结构,包括使用JSON存储赛程数据和使用Python处理查询逻辑。重点说明了时区转换的关键技术,特别是如何正确组合日期、时间和时区信息,以及使用Python的zoneinfo模块进行可靠的时间换算。最后展示了第一版程序的运行效果,成功输出了比赛信息及其对应的北京时间。这个小工具虽然简单,但涵盖了结构化数据设计、命令行参数处理和跨时区时间换算等实用开发技巧。

2501_92842654的博客 192

jdk-8u144-linux-x64.tar.gz.

该资源为搭建Linux系统Java环境用,资源的后缀为tar.gz格式的压缩包

Claude用量监控菜单栏小工具:运行前一眼掌握剩余配额

在AI辅助编程逐渐成为主流的今天,开发者对API调用次数的敏感度越来越高。尤其在使用Claude Code或Claude API进行长时间重构任务时,token消耗速度往往超出预期,一旦额度耗尽,工作流被迫中断,上下文丢失的代价远大于短暂等待。用量监控因此成为开发者工具链中不可忽视的一环。与终端日志或网页后台不同,macOS菜单栏提供了最自然的信息可达位置。一个精炼的菜单栏小工具,能在运行前以色彩和图标反馈剩余配额,让开发者低干扰地掌握用量状态。基于SwiftUI的MenuBarExtra框架,可以快速搭建

weixin_34133829的博客 420

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

Win11Debloat 十分钟跑通:3 种启动方式与完整的 Windows 11 精简回退方案

Win11Debloat 是一个用 PowerShell(系统自带的命令行工具)写的轻量精简工具,能批量移除预装应用、关掉遥测和广告推荐、定制任务栏与界面,每项改动都附带回退办法。适合不想逐条翻设置、想把 Windows 10/11 用得更干净的人。 [![Win11Debloat 主界面,Windows 11 精简与隐私保护选项清单](https://raw.gitcode.com/GitHu

gitblog_00189的博客 938

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

老电脑装 Windows 11 总卡在 TPM 检查?这个免费脚本把绕过的活全包了

我舅舅那台 2015 年的老笔记本,跑 Win10 一直顺顺当当,可系统三天两头弹窗,催着升级 Windows 11。真点了升级,它又立刻翻脸:TPM 2.0 不达标、处理器不在支持名单。说白了,想给老旧电脑免费升级 Windows 11、绕开 TPM 检查,靠官方渠道基本没戏。我最后是靠一个叫 MediaCreationTool.bat 的开源批处理脚本搞定的,今天把整个过程拆开讲给你听。 [

gitblog_00305的博客 157

Flutter Engine 头文件守卫一致性检查工具 header_guard_check 全解析:规范、命名规则、CLI 用法与自动修复

`header_guard_check` 是 Flutter Engine 仓库内置的一套基于 Dart 的命令行检查工具,用于强制所有 C++ 头文件遵循统一、基于路径的 include guard(头文件守卫)命名规范,并提供 `--fix` 自动修复能力。本文围绕其官方 README(见 [engine/src/flutter/tools/header_guard_check/README.

gitblog_00735的博客 1065

EDI认证补上国产化拼图:EasyLink如何领跑安全可信的数据交换

电子数据交换(EDI)是企业间系统自动化传输订单、发票等结构化单据的核心技术,其价值不仅在于格式转换,更在于传输链路的可靠与安全。在供应链集成中,认证是信任的基石,包括产品能力认证与身份认证两层含义。TLS双向认证、数字证书验证、LDAP/SSO统一身份管理,构成了现代EDI平台的安全底座。这些技术保障了数据在传输中不丢、不重、不被篡改,同时满足审计追溯要求。在制造、零售、医药等行业,企业对接海外大客户时,EDI平台是否通过权威认证往往决定其能否进入核心供应链。国产平台长期缺乏第三方能力认证,导致选型受限。

weixin_34198762的博客 325

把Claude用量放进macOS菜单栏:一个可以完整读完的小工具

在API开发与命令行工具的高频使用中,token消耗和用量监控成为开发者必须直面的一环。通常查看Claude API用量需要登录网页控制台,流程繁琐且打断思路,而菜单栏应用作为轻量常驻的桌面交互形式,能将关键数据直接呈现眼前,减少上下文切换。本文从菜单栏工具的设计原理出发,介绍如何基于Claude API返回的usage字段与Claude Code日志采集用量数据,生成统一的JSON结构,并通过SwiftUI的MenuBarExtra或xbar脚本快速构建macOS菜单栏展示。这类小工具强调代码可读性与行为

weixin_34268579的博客 484

制作桌面进制转换(二进制,八进制,十进制,十六进制)小工具 Python学习日记 2.28~3.6

菜鸡的python学习日记

qq_62423835的博客 1977

TypeScript类型检查实战:从原理到项目平滑迁移

动态类型语言在开发中灵活有余,但随着项目规模扩大,函数参数、对象结构等隐式约定成为难以察觉的隐患。静态类型检查通过在编译阶段对变量与数据结构进行约束,能够提前暴露跨模块的类型不匹配问题。类型系统不仅提供接口描述与自动补全,还通过泛型、联合类型等抽象机制提升代码复用与安全性。在大型前端工程、Node.js 服务以及多人协作场景中,类型定义已成为比文档更可靠的技术契约。TypeScript 作为 JavaScript 的超集,以渐进式方式为既有项目引入静态检查,既保留原有运行时行为,又让开发者从运行时报错转向编

weixin_33795093的博客 380

AI 问数真的能替代 BI 报表吗?

AI问数赋能自然语言查询,提升临时分析效率,但无法替代传统报表。报表适用于稳定输出与持续监控,AI则擅长探索性提问。企业用好AI问数,关键在于夯实数据模型、统一指标口径、健全权限体系与结果校验机制。合理组合报表、仪表板与AI,才能实现高效、准确的业务洞察。

葡萄城技术团队博客 341
上一篇: 命令失败后怎样确认没有留下半成品
下一篇: 浏览器插件缓存不要顺手存下输入
第一程序员
博客等级 码龄1年 1万+粉丝 1827原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值