交互式终端
cosh 默认启动 Enhanced Assisted 模式，并保持 Shell 原生提示符外观。
Cosh 可能在 bash 或 zsh 执行前路由自然语言输入。在空提示符按 Shift+Tab
可进入 Enhanced Shell-only。如果要求不加载 Cosh Hook、不观察也不提供洞察，
需要在启动时选择 Native。
状态符号默认关闭。在 config.toml 中设置 shell.status_symbols = true
（或单次会话使用 COSH_SHELL_STATUS_SYMBOLS=1）后，新提示符出现、卡片返回
或路由模式切换时会发布 ◇（Assisted）或 ◌（Shell-only）状态行，它随
终端输出滚动。Shell 提示符从下一行开始，保留正常的换行与光标移动；编辑重绘
不会追加状态行。Native 会话没有 Cosh 状态行。
典型工作流
- 进入目标目录并运行
cosh。 - 像平常一样执行熟悉的命令。
- 普通输入应只交给 Shell 时，按
Shift+Tab。 - 在 Assisted 模式描述任务，并在允许副作用前检查卡片。
- 离开长时间排查前运行
/session status。
常用启动方式：
cosh
cosh --shell zsh
cosh --resume
COSH_SHELL_INTEGRATION=native cosh
输入如何分流
| 输入 | Native | Enhanced Shell-only（开启后显示 ◌） | Enhanced Assisted（开启后显示 ◇） |
|---|---|---|---|
git status | 在 Shell 中执行。 | 在 Shell 中执行，之后可能提供执行洞察。 | 在 Shell 中执行，之后可能提供执行洞察。 |
hello | Shell 通常报告命令不存在。 | Shell 通常报告命令不存在。 | 分类器会检查它，当前仍把这个有歧义的单词交给 Shell。 |
why did the last command fail? | 由 Shell 处理。 | 由 Shell 处理。 | 携带最近终端证据启动 Agent 请求。 |
/session list | 由 Shell 处理。 | 由 Shell 处理。 | 执行 Cosh 控制命令。 |
| Agent 工具请求 | 不可用。 | 明确接受洞察或进入 Agent 后可用。 | 按审批模式执行或显示审批卡片。 |
Native 不会安装 Cosh DEBUG、RETURN 或 ERR trap，也不会开启
extdebug、functrace 或 errtrace。Enhanced 是默认集成；使用
shell.integration = "native" 或 COSH_SHELL_INTEGRATION=native 选择
Native。切换集成需要重新启动 cosh，Shift+Tab 只切换 Enhanced 内部的
路由子状态，不需要重启。
增强集成中获批的 Shell 命令仍在前台 Shell 执行，prompt、输出、任务控制和
Ctrl+C 都可用。安全规则见工具审批。
Bash prompt 兼容边界
Enhanced 将用户的 PROMPT_COMMAND Hook 与 Cosh prompt Hook 组合执行。
集成启动前配置的用户 Hook 按所选 Bash 版本的规则保留执行顺序。
Assisted 和 Shell-only 均使用这套集成。
变量表示和子进程环境存在以下限制：
- Bash 5.1 及以上版本使用数组，保留原有 export 属性，但 Bash 不会导出数组值。
因此，原先导出的 scalar
PROMPT_COMMAND不再传入子进程，原值为空字符串时也如此。 - Bash 4.3–5.0 使用不带 export 属性的组合 scalar，避免 Cosh 内部 Hook 文本 进入子进程；用户原有的 scalar 同样不会被导出。
如果子 Shell 需要独立初始化 prompt Hook，请在各交互 Shell 的启动文件中配置。 如果会话必须保留 Bash 自身的 prompt 变量表示和环境行为，请在启动时选择 Native。 Native 不加载 Cosh Hook、不观察也不提供洞察；将 Enhanced 切换到 Shell-only 不会消除上述限制。
--resume 始终选择 Enhanced，即使设置了 COSH_SHELL_INTEGRATION=native
或 shell.integration = "native"。需要 Native 行为时，请勿使用 --resume。
这些限制仅适用于 Bash 的 PROMPT_COMMAND，不涉及普通环境变量或交互续行提示符 PS2。
会话与主动帮助
- 增强会话由 cosh-core 保存，并按启动 cosh 时所在工作空间隔离。恢复会话只 恢复模型可见的对话内容，不恢复终端进程或旧终端输出。详见 会话恢复。
smart是增强集成中的默认分析模式。调整主动失败帮助的方法见 AI 分析。/help是增强集成命令集合的准确信息，简要参考见 交互命令。