TinyFish Feedback 是 TinyFish 的反馈收集技能,主要用途是把用户的零散反馈整理成结构化内容,并在用户确认后提交为 GitHub issue。资料显示,其核心原则是:在用户看到确切文本之前,任何内容都不会离开本机。
主要能力与使用方式分为几个阶段。收集阶段:简要询问用户想做什么、实际发生了什么、期望是什么;对于安装、认证或连接类问题,可运行 npx -y @tiny-fish/cli@latest doctor 并提议原样附带其 stdout JSON,该输出带 schema 版本且已做脱敏处理(未声明字段在解析时被剥离,消息为撰写而非原始内容);不得添加字段、摘要或附带配置内容;若退出码为 2 表示 doctor 未产生 JSON,应直接说明而不是附带空报告。
结构化阶段:按固定模板整理,包括“What I was doing”“What happened”“Expected”“Environment”(harness 与版本、CLI 版本如已知)以及可选的“Doctor report”,填入 doctor 的 stdout 原文。
预览关卡:向用户展示完整 issue 正文,并要求明确同意后才提交;用户要求的任何修改都在提交前完成。
提交阶段:首选方式是先将正文和标题写入文件,再执行 gh issue create --repo tinyfish-io/tinyfish-cookbook --title "$(cat "$title_file")" --body-file "$body_file"(仅在 gh 已安装并完成认证时使用)。由于标题和正文来自用户自由文本(正文还包含 doctor 的 JSON),二者都不能作为字面文本进入 shell,包括在 title=… 赋值中,反引号或 $(…) 同样会被求值;cat 的输出不会被重新解析;不得将命令拼接为字符串或通过 eval 执行。备选方式是打开预填 issue URL(https://github.com/tinyfish-io/tinyfish-cookbook/issues/new?title=…&body=…),两个值都需百分号编码,未编码的 # 会截断正文、& 会将其拆成无效参数;URL 长度限制会截断长正文,若正文被截断,应告知用户并展示完整文本以便粘贴剩余部分。
适用场景为向 TinyFish 提交缺陷报告、反馈令人困惑的安装步骤、提出缺失功能建议,或附带诊断报告。限制与注意事项:该仓库为公开仓库,若报告包含用户自由输入的内容,需在预览中提醒用户;未提供其他功能、收费或平台信息。