SuperAPI AI 工具集

add-module

编程与开发

查看项目

更新于 10-16 08:39

技能介绍

用途:在 CLY 项目中自动化创建新模块,分为演示模块(modules/demo/<name>/,用于展示 Bubbletea/Charm 组件)与工具模块(modules/<name>/,提供实际功能)。核心是模块隔离原则:所有逻辑应放在该模块目录内,只依赖标准库、Bubbletea/Bubbles/Lipgloss、Cobra 及 pkg/ 共享工具,绝不跨模块导入;复制该文件夹到新仓库后应只需改导入路径即可工作。

主要能力:提供目录结构、cmd.go 注册模板、实现文件模板(含 model、initialModel、Init、Update、View)、注册到父命令的写法,以及 tea.Program 选项如 tea.WithAltScreen、tea.WithMouseAllMotion、tea.WithReportFocus、tea.WithFilter。给出演示与工具模块的完整创建流程与验证清单。

使用方式:先确定模块类型,演示模块可参考 references/bubbletea/examples/<name>/,创建目录后编写 cmd.go 与实现文件,在 modules/demo/cmd.go 或 cmd/root.go 的 init() 中注册。用 go build、go run main.go --help、go run main.go demo <name> 验证,并确保可用 q 或 Ctrl+C 退出。

适用场景:为 CLY 添加 TUI 演示模块或实用命令。限制:仅适用于 CLY 项目结构;非交互终端可能报 could not open TTY;需处理未使用导入与包名命名(连字符目录用下划线包名)。