CHANGELOG.zh.md

更新日志

1.1.1 (2026-04-08)

• 修复可能存在的 SystemExit 错误

1.1.0 (2025-08-08)

• 新增循环调用模式 :loop
• 为脚本内调用提供一个易用接口

---

1.0.1 (2025-07-25)

• 允许占用 "-h" 传参, 并在适当的时机转义为 "help"

1.0.0 (2025-06-05)

我们在 0.7 版本经过了长期且广泛的验证及应用, 现在决定将版本号正式转为 1.0 正式版.

请注意本版本相较于 0.7.2 没有明显的变化, 您可以从 0.7 平滑过渡到此版本.

• 更新配置中的帮助界面显示选项
• 一些边缘修复

---

0.7.2 (2025-04-11)

• 简化装饰器写法: 使用 @cli 替代 @cli.cmd()

0.7.1 (2025-02-19)

• 修复对 sys.argv 的解析
• 修复对无参函数的调用

0.7.0 (2025-02-08)

• 非侵入式调用脚本

---

0.6.4 (2025-01-17)

• 优化 help 界面的参数描述
• 修复 python -m <package> 在 python 3.8 上的问题

0.6.3 (2025-01-03)

• 修复 sys.argv 相关问题

0.6.2 (2024-12-26)

• 支持以 snake_case 传入函数名称

0.6.1 (2024-12-24)

• 更新对无参函数的处理

0.6.0 (2024-12-19)

• 新的命令行帮助界面
• 改进函数注释文档解析器

---

0.5.8 (2024-06-18)

• 兼容 lk-logger 的 traceback 功能

0.5.7 (2024-04-11)

• 修复 python 3.8 兼容问题

0.5.6 (2024-01-19)

• 修复全局参数引起的 help 命令报错

0.5.5 (2024-01-02)

• 添加 :empty 来传递空字符串
• 修复对 *args 的处理

0.5.4 (2023-11-03)

• 修复 args 参数无法通过 kwargs 语法传递的问题

0.5.3 (2023-10-05)

• 默认不警告重复的 (被 @cli.cmd() 装饰的) 函数

0.5.2 (2022-11-21)

• :help/:helpx 参数优先被全局使用.
• 对下划线开头的参数名特殊处理.

0.5.1 (2022-11-21)

• 修复类型解析错误.

0.5.0 (2022-11-20)

• 支持 *args 和 **kwargs 传参.
• 更好的单元测试.

---

0.4.3 (2022-11-12)

• 样式调整.
• 其他优化.

0.4.2 (2022-08-30)

修复 python 3.8 适配问题.

0.4.1 (2022-07-26)

修复类型检查错误.

0.4.0 (2022-07-24)

允许 "匿名" 的方式传入 option 参数.

# befoer
python3 login.py username --password 123456

# after
python3 login.py username 123456

---

0.3.1

修复了一些细节.

0.3.0

优化了文字颜色, 使文字在不同终端主题下尽量保持一致的感觉, 提升美观性.

---

0.2.2

加强参数类型转换.

0.2.1

"did-you-mean" 功能:

0.2.0

完善命令行传参错误的处理方式.

现在, 当发生报错时, 将提供参数位置, 报错原因等信息, 如下图所示:

---

0.1.2

调整了输出样式.

一些值得注意的细节:

• 解决了传参问题, 发现之前的版本几乎不可能在正常传参的情况下工作.
• 字段宽度对齐策略有所放松. 该调整让实际效果更美观了.
• 灵活的标题头样式, 在考虑到实际情况 (比如想要复制标题作为下次的命令时), 现在更加切合实际需求了.
• 首页的文档有了最新的截图.

0.1.1

空参传递的时候, 回调到 help 命令上.

0.1.0

argsense 的基本功能验证通过.

重要的, help 和 helpx 命令及输出效果都符合预期.