跳转到内容

命令

qialike 的命令行参数与面板内的斜杠命令。

所有命令都在运行 qialike 后可直接使用。


命令行

Terminal window
qialike # 开启新会话并显示 hero 首屏(从不自动续接)
qialike resume # 继续当前目录下最近一次会话
qialike --workspace ~/proj # 在 ~/proj 下操作(其自身的会话)
qialike --resume <sessionId> # 恢复指定持久化会话
qialike --model deepseek-flash # 选择模型(DeepSeek V4.1 Flash)
qialike --help
参数说明
[mode]可选位置参数。目前仅接受 resume:继续当前目录下有内容的最近会话。拼错会报错退出,不会静默当作新会话。
--workspace <dir>代理操作的目录,默认是调用时的目录。
--resume <sessionId>恢复指定持久化会话,直接进入会话界面。
--model <model>模型覆盖,例如 deepseek-flash。
--help / -h打印宽度自适应的帮助并退出。
--dump-config打印组合后的 profile 分层(内嵌层 + 用户层)并退出。
--no-project-overlay本次启动忽略仓库里的 .dsh/tui.cordis.patch.yml。

另有几个转发的子命令:

Terminal window
qialike web [flags] # 打开 DeepSeek Harness 浏览器 UI(需要 dsh 在 PATH 上)
qialike upgrade [版本] # 升级(见「更新」)
qialike plugin <子命令> # 管理 skills 与 MCP 行(见「插件」)
qialike uninstall # 清空 $DSH_HOME(默认 ~/.dsh,保留 bin/)与 PATH 安装痕迹

qialike web 的 web 参数(--port / --no-open 等)原样透传给已安装的 dsh CLI;--host 0.0.0.0 会被 web profile 直接拒绝(对网络开放等于开放远程代码执行),远程访问请用回环绑定 + SSH 隧道, 见无头 / 远程访问。


更新

能自动更新的安装会自动更新:启动约 1 秒后,后台以子进程检查一次新版本(不阻塞界面,失败静默)。只有补丁版(patch)会静默安装;小版本(minor)与大版本(major)只在状态栏提示。

  • 能被自动更新的前提:二进制有人管——curl 安装器的 ~/.dsh/bin(Linux / macOS),或 npm 全局前缀下的副本(含 Windows)。自行编译的检出构建与手动解压的二进制永远不会被替换。
  • 关闭或改为只提示:设置项 qialike-update.auto 可取 true(默认,静默装补丁版)/ false(完全不检查)/ "notify"(只提示、从不自动装);也可用 QIALIKE_DISABLE_AUTOUPDATE=1 全局关闭,或用 QIALIKE_ALWAYS_NOTIFY_UPDATE=1 强制只提示。
  • 手动更新:
Terminal window
qialike upgrade # 升级到最新版
qialike upgrade <版本> # 装指定版本(接受 v 前缀)
qialike upgrade --check # 只报告,不安装

TUI 内也可用 /upgrade。能不能真的安装取决于二进制由谁管,而不是取决于平台:npm 副本由 npm 替换(Windows 上也能);~/.dsh/bin 的副本由安装器替换(仅 POSIX);没人管的副本会被拒绝并建议改用安装器重装。完整说明(含 qialike-update.auto 的三个取值)见 更新。

Windows 上大多只能手动更新:安装器是 bash、运行中的 .exe 也无法被替换,所以安装器装的与手动解压的副本只做检查——qialike upgrade --check 报版本并打印下载链接,更新方式即手动替换:下载新 .zip、退出 qialike、替换 qialike.exe。npm 装的副本是例外(它自动更新补丁版,qialike upgrade 直接交给 npm),见 更新 → 按安装方式更新。


插件

qialike 的一切都是插件——界面本身也是。因此扩展不需要重新编译,两条通道都只吃数据文件:

  • Skills:把技能包放到 $DSH_HOME/skills/<name>/SKILL.md(或项目的 .dsh/skills/、.agents/skills/,或 ~/.agents/skills/),harness 会自动发现,没有开关要开。
  • MCP server:其工具随即以 mcp__<名字>__<tool> 出现在模型面前。

qialike plugin 可以代你操作这些文件,不必手写 YAML:

Terminal window
qialike plugin list [--available] # 各层与其中的行;--available 再列出本构建打包的全部插件
qialike plugin add-mcp <名字> <命令> [参数...] [--project]
qialike plugin remove-mcp <名字> [--project]
qialike plugin trust-overlay # 信任仓库里的 overlay(见下)

--project 作用于仓库级 overlay(<repo>/.dsh/tui.cordis.patch.yml)而非你个人的那份。启用或禁用内建行不需要命令:写一条不带 insert、内容为 disabled: true 的行按 id 覆盖即可。qialike --dump-config 会打印各层组合结果与每个插件的来源层。


斜杠命令

在输入框里键入 / 会打开斜杠命令面板:↑/↓ 移动高亮,Enter 执行,Esc 关闭。

/help

打开帮助对话框,提示你按 Ctrl+P 查看当前上下文中所有可用的操作与命令。Esc 关闭。

/models

打开全屏的模型与 API key 管理对话框,行为与 web 的 Models 页一致:

  • 第一级按供应商归类,每个已配置 key 的提供商一行,行尾标注其模型数。
  • Enter 进入该供应商的模型子列表;Esc 返回一级。
  • 三个列表(一级 / 二级 / Add provider)都支持打字即过滤。
  • 子列表选中模型后 Enter 保存;下一次请求即切换。

完整语义(推理强度、隐藏供应商、自定义 provider、主题等)见 模型。

/compact

手动把当前会话的较旧历史压缩成一条摘要,与 web 界面共用 harness 的 compaction 服务。

  • 不接受参数;带参数会提示 Usage: /compact (no arguments)。
  • 成功时显示 Compacted N history items (~X tokens).
  • 没有可压缩内容时显示 No compactable history yet.
  • 失败时按分类(busy / cancelled / changed / summary / commit / persistence)显示对应文案。

/clear

清空当前转写区显示(视图层),不删除会话记录。会话日志仍然留在磁盘上,可以从 /sessions 或 --resume 找回。

/new

就地开启一个全新会话:取消当前回合、创建新 agent、拆除旧 agent。harness 对所有会话自动持久化,因此之前的对话仍可从 /sessions / --resume 找回。当前模型选择与工作目录保留。

/sessions

打开会话管理器(唯一的会话选择入口)。它列出仅当前工作目录的持久化会话,按创建时间倒序并按日期分组:

  • 打字即过滤(标题 / id / cwd)。
  • Enter 恢复所选会话。
  • Ctrl+R 改名、Ctrl+F 置顶/取消置顶、Ctrl+D 删除(两次确认,当前会话受保护)。
  • Esc 两级退出。

开启全新会话由 /new 负责,/sessions 只承载历史记录。

/exit

退出 qialike。