常见问题
为什么不能 npm install @dsh-blue/blue？
Blue 处于预览阶段，尚未发布到 npm。当前唯一支持的安装方式是从源码检出进行本地开发安装，见快速上手。v0.1.0-rc.1 将是首个发布版本，发布后本站会更新安装说明。
粘贴图片没有反应？
Ctrl-V 粘贴依赖两个条件：
- 终端环境：需要剪贴板工具——Linux 上依次探测
wl-paste、xclip（3 秒超时）； - 模型能力：粘贴的图片以图片内容块进入消息。如果当前模型路由不支持图片输入，包含图片块的消息会被拒绝——这是上游 harness 的能力协商行为，换用具备视觉输入的模型即可。
图片落入附件存储（默认 ~/.dsh/attachments，可用 DSH_BLUE_ATTACHMENT_DIR 或 DSH_HOME 改址），单图上限 10MB、每条消息至多 8 张 / 30MB / 16M 像素。
为什么 AGENTS.md 等注入的上下文不显示在会话流里？
harness 会把工作区指令（AGENTS.md 等）、运行时上下文快照等以合成 user 消息注入会话。Blue 按消息来源分拣：人类输入照常呈现为 ❯ 气泡；合成消息零呈现（不产条目、不留占位行）——对齐"模型侧内容模型侧消化"的呈现哲学，保持会话流干净。这些内容仍然完整发送给模型，只是不渲染。
能自定义键位吗？
暂缓。键位经 blueKeymap 注册、重复绑定会被拒绝，但面向用户的自定义配置属于后续阶段（alt-screen 全屏表面同理）。当前全部键位见键位参考。
/quit 按了没反应？
在 agent 尚未 attach 时（会话建立前的极短窗口）输入 /quit，会显示 no active session 而不是退出——命令分发前会检查当前 agent。稍候重试即可。另外交互模式里 1 秒内连按两次 Ctrl-C 也可以退出。
状态栏的 git 分支什么时候刷新？
git 徽章经 TTL 缓存惰性探测（branch 5 秒、status 15 秒），但探测挂在会话上：会话中途切换分支要等下一次会话切换（/new、/resume 或重启）才会显示新分支。
状态栏条目放不下会怎样？
状态栏至多两行。两行都放不下的条目按最低优先级丢弃；超宽条目在各自簇的宽度预算内自行截断。条目顺序与取舍由注册表优先级决定（内置条目占 0 / 5 / 10 / 20 / 30 档），不是写死的。
bash 模式的输出会进入会话历史吗？
不会。! bash 模式的命令经 Blue 自己的执行器运行，输出以 shell 回显卡呈现进滚动区，刻意不进 session transcript——模型看不到这些输出。需要模型知晓的结果请贴回输入框或让模型自己跑工具。