SuperAPI AI 工具集

zlib-tui

编程与开发

查看项目

更新于 11-03 16:15

技能介绍

zlib-tui 是 zlib 项目的终端界面开发规范,主要用于指导对 zlib 交互式 CLI 和 shell 入口的界面修改,确保各项改动不破坏共享模型、布局和选择行为。文档首先要求 CLI 与 shell 入口共用模型:profile 使用 profilePageModel,Kindle 使用 runStandaloneShellCommand 处理文件选择、配置、确认、密码设置与发送结果,独立页面返回时退出到终端,并保留 JSON 与非交互发送行为。主页不提供搜索输入框或回车搜索提示,命令需以 / 开头打开,空闲状态下忽略普通输入、粘贴与 Ctrl+K,Esc 关闭命令列表并恢复无输入的主页。

在组件渲染方面,表单、对话框和结果页的所有操作应使用 tui_layout.go 中的 renderActionButton,空闲态用主题表面色与标题色,聚焦态用填充强调色(破坏性操作用错误色),保留两格水平内边距、无边框、无 > 前缀,并用 actionButtonRows 按可用宽度换行。列表与文件夹行保留 selectionRow。主题选择器需保持列表与筛选在当前调色板中,预览跟随高亮名称;自定义主题存放在用户配置的 themes 目录,Ctrl+N 复制选中调色板、Ctrl+E 编辑自定义颜色或复制内置主题、Ctrl+S 保存、Esc 放弃草稿,保存前校验名称与 #RRGGBB 值。

搜索与书籍列表方面,book_feed_view.go 渲染共享的 Search、Favorites、Recommended、Most popular 和 History 列表,行计算与渲染高度需在紧凑和扩展终端尺寸下对齐。搜索结果在请求完成时一次性显示,不做逐行动画;加载、空、失败状态控件保持在底部。search_filter_form.go 中的搜索表单同时展示查询、年份范围、语言、格式、精确匹配和排序,长选项打开居中选择器,Ctrl+S 提交,年份无效时表单保持打开并在字段下方显示错误。结果页复用同一表单并需通过 tea.WindowSizeMsg 调整尺寸。

书籍详情通过 EAPI 按选中 id:hash 获取,选择稳定后拉取并按引用缓存,迟到结果仍绑定原书籍,仅展示响应实际提供的字段。下载失败在所属页面显示书籍、URL 安全的原因和 r 重试;Kindle 发送失败显示文件与原因且不自动重试。下载完成后显示绝对保存路径与返回,仅当文件扩展名在 kindleAllowedTypes 中才显示 Send to Kindle。缺少 SMTP 密码时打开掩码表单,将 ZLIB_SMTP_PWD 保存到全局 .env 并继续发送。Doctor 页面使用 Bubbles list、spinner 与共享帮助渲染器,结果限于 availableDomains 接受的域。Profile 展示 EAPI 每日已用数与上限,以及宽度感知的进度条。shell 主页保留五行字母字形与单列 Accent 到 Link 渐变,命令提示使用弱化描述,未登录时直接打开登录表单。命令面板为居中覆盖层,支持过滤、方向键循环、Tab 补全、Enter 运行、Esc 恢复草稿。命令反馈分 setError、setSuccess、setNotice 三种,后两者五秒后过期,渲染在标题行。文档还要求修改共享布局代码时运行 go test ./... 和 go vet ./...,并在交互或间距规则变化时更新 docs/tui.md。