FAQ

FAQ

为什么打开画廊是空白？

位图样本不在 git 里。先 python scripts/ensure_pack.py --check。失败时看 JSON 里的体积和 source，同意后再 --install。不要指望 clone 完就能看见 160 张 PNG。

Agent 能不能自己把包下下来？

不能先下。SKILL 要求：缺包 → 先问大约体积和来源 → 用户同意 → 再 --install。开发工作区从 visual-reviews/images 拷贝同样要口头授权。

为什么专业架构图不给成品图？

评审级架构需要可编辑结构和真实模块名。位图模型做不到这一点。走专业路径：在项目里写 tta-visual-professional-<主题>.md，分模块写清要求，文末是给下一个 Agent 的 handoff。把文件拖过去就能接着画 Mermaid / SVG / draw.io。

Agent 为什么要弹出选项卡，而不是让我回 1/2/3/4？

封闭选择必须走编程工具自带的提问 UI。聊天编号只是备用。第二档热门画风写了外貌说明，习惯之后不必每次开画廊。

画廊页上的组名是产品名吗？

不是。那是对照壳上的组标题，方便你指着说「跟这一组像」。tta 对外品牌仍是 threetwoa / tta-visual；默认角色是眼镜火柴人和暖黄边牧。

安装副本和源仓不一样？

改 Skill 只改源仓 tta-visual/。~/.claude/skills/tta-visual/ 是运行时副本，不会在维护任务里自动覆盖。要用新版，按 Getting-Started 重新 clone 或自行同步。

怎么本地预览 README？

维护排版时，在源仓根目录运行 python preview/serve.py，打开 http://127.0.0.1:8766/preview/ 。那一页按 GitHub 的 Markdown API 渲染 README.md，用来对照 GitHub 上的样子，不是产品站。

从 oil-* 怎么迁？

见仓库 README「从 oil-* 迁移」：删旧安装和旧配置目录，再 clone Aafff623/tta-visual。