EN 中文

# Commands Reference

# 命令参考

All slash commands, key bindings, and CLI flags.

全部斜杠命令、快捷键和 CLI 参数。

### Slash Commands (TUI)

Command | 命令 | Usage | Description | 说明
--- | --- | --- | --- | ---
/help | /help, /? | Show help topic picker, or pass a topic (all, commands, keys, about)
/hooks | /hooks | List active shell hooks (user + project) | 列出活跃的 shell 钩子
/clear | /clear | Start a fresh conversation (saves current session, opens new one, clears screen). Ctrl+L to only clear the display. | 开始新对话（保存当前会话、打开新会话、清屏）。Ctrl+L 仅清屏。
/new | /new | Start a fresh conversation (same as /clear) | 开始新对话（同 /clear）
/model | /model [id] | Switch model — no arg opens a picker | 切换模型——无参数打开选择器
/effort | /effort [off|high|max] | Set DeepSeek reasoning effort | 设置推理深度
/yolo | /yolo | Toggle --yolo (bypass permission prompts) | 切换 yolo 模式（跳过权限提示）
/plan | /plan | Toggle plan mode (read-only exploration) | 切换规划模式（只读探索）
/review | /review [branch] | Code review working-tree changes | 审查工作树变更
/branch | /branch | Fork this session (new ID, parent link) | 分叉当前会话
/compact | /compact | Summarise prior history to free up context | 压缩历史以释放上下文
/checkpoints | /checkpoints | List git checkpoints for current session | 列出当前会话的 git 检查点
/distill | /distill | Extract project decisions → M memory | 提炼会话决策到 M 记忆
/skills | /skills | List loaded skills with source paths | 列出已加载的技能
/skill | /skill <verb> [args] | Manage skill packages (install, uninstall, list, …) | 管理 Skill 包
/memory | /memory <verb> [args] | Inspect project memory (list, show, search, archive) | 查看项目记忆
/setup | /setup | Re-run the API-key configuration wizard | 重新运行 API key 配置向导
/upgrade | /upgrade [--force] [--dry-run] | Download latest release and replace binary | 下载最新版本并替换二进制
/exit | /exit, /quit, /q | Quit seek | 退出 seek
/steer | /steer, /s | Interrupt and send new instructions | 中断当前回复并发送新指令
/undo | /undo [path] | Undo the last write or edit | 撤销上一次写入或编辑
/redo | /redo [path] | Redo a previously undone write or edit | 重做上一次撤销
/restore | /restore [turn] | Restore entire working tree from a git checkpoint | 从 git 检查点恢复整个工作树
/agents | /agents | List subagents for this project: spawn time, type, status, turns, tokens, description | 列出当前项目的子代理：派生时间、类型、状态、turn 数、token、描述
/worktrees | /worktrees | List seek-managed git worktrees: id, branch, path (includes prior sessions) | 列出 seek 管理的 git worktree：id、分支、路径（含历史会话）
/diagnose | /diagnose | Print a diagnostic report (version, OS, provider, config, session metadata) — paste into bug reports | 打印诊断报告（版本、OS、provider、配置、session 元数据）——粘到 bug 报告里
/keys | /keys | Show the active keymap (incl. any ~/.seek/keybindings.toml overrides) | 显示当前键位映射（含 ~/.seek/keybindings.toml 覆盖）

### Key Bindings

### 快捷键

Key | 键 | Action | 操作
--- | --- | --- | ---
Enter | Send prompt | 发送 prompt
↑ / ↓ | Recall prompt history (input empty) | 回滚 prompt 历史（输入框为空）
Esc | Cancel ongoing assistant response | 取消 assistant 响应
Shift+Tab | Cycle mode: ask → plan → yolo → ask | 循环切换模式
Ctrl+J | Insert newline in input | 输入框内换行
Ctrl+L | Clear visible screen (same as /clear) | 清屏（同 /clear）
Ctrl+R | Toggle reasoning visibility | 切换推理过程显示
Ctrl+C | Quit seek | 退出 seek
Alt+Enter | Interrupt with new instructions (/steer) | 中断并发送新指令
? | Open this help overlay (/help) | 打开帮助面板

### CLI Subcommands

### CLI 子命令

Command | 命令 | Description | 说明
--- | --- | --- | ---
seek checkpoint list | List git checkpoints for the current session | 列出当前会话的 git 检查点
seek checkpoint restore <turn> | Restore working tree from a checkpoint turn | 从检查点恢复工作树
seek checkpoint prune | Remove old checkpoints (default 90 days) | 清理旧检查点（默认 90 天前）
seek undo [path] | Undo the last file write/edit | 撤销上一次文件写入/编辑
seek redo [path] | Redo a previously undone write/edit | 重做上一次撤销
seek hooks list | List active hooks with average duration | 列出活跃的 hook 及平均耗时
seek hooks check | Dry-run: show which hooks would fire for an event | 干跑：模拟某事件会触发的 hook
seek hooks trust | Reset trust record for project hooks | 重置项目级 hook 信任记录
seek hooks audit | Query hook execution audit log | 查询 hook 执行审计日志
seek skill install <path|url> | Install a skill from local path, git URL, or HTTPS tarball | 从本地路径、git URL 或 https 压缩包安装 skill
seek skill list | List installed skills (user + project) | 列出已安装 skill（用户级 + 项目级）
seek skill uninstall <name> | Remove a skill from user-level installs | 从用户安装中卸载 skill
seek skill update <name> | Re-fetch a git-installed skill | 重新拉取 git 安装的 skill
seek skill stats [--top N] | Show skill call counts ranked by frequency | 按调用频率显示 skill 排行
seek memory list | List M-memory entries for current project | 列出当前项目的 M 记忆条目
seek memory show <name> | Print full content of an M-memory entry | 打印某条 M 记忆全文
seek memory search <query> | Search M-memory by keyword (tagline + body) | 按关键词搜索 M 记忆
seek memory archive <name> | Archive a stale entry (preserved on disk, removed from index) | 归档某条记忆（保留磁盘，移出索引）
seek cron create [flags] <prompt> | Register a scheduled prompt (--at @daily / @every 1h) | 注册定时任务（--at @daily / @every 1h）
seek cron list [--json] | List registered cron jobs with next-run time | 列出已注册 cron 任务及下次触发时间
seek cron run <name> | Fire a cron job immediately (bypass schedule) | 立即触发某 cron 任务（绕过调度）
seek cron delete <name> | Remove a cron job | 删除 cron 任务
seek cron tick | OS-scheduler entry point — scan + fire all due jobs (called every 1 min by launchd/systemd/Task Scheduler) | OS 调度器入口——扫描并触发所有到期任务（launchd/systemd/Task Scheduler 每分钟调用）
seek worktree list | List seek-managed worktrees (includes externally-created ones flagged "external") | 列出 seek 管理的 worktree（标 "external" 表示用户手动创建）
seek worktree gc | Reap orphan worktrees + dangling refs from prior crashes | 回收孤立 worktree + dangling refs
seek keys list | List active key bindings (defaults + user overrides) | 列出当前键位绑定（默认 + 用户覆盖）
seek keys check | Lint ~/.seek/keybindings.toml for conflicts and unknown actions | 检查 ~/.seek/keybindings.toml 是否有冲突或未知动作
seek keys actions | List all bindable actions (the actions a user override can target) | 列出所有可绑定的动作

💡 Many subcommands have TUI slash-command equivalents: `/checkpoints`, `/restore`, `/undo`, `/redo`, `/hooks`, `/skill`, `/memory`, `/agents`, `/worktrees`, `/keys`. Use either path interchangeably. 💡 多数子命令有 TUI 斜杠命令等价：`/checkpoints`、`/restore`、`/undo`、`/redo`、`/hooks`、`/skill`、`/memory`、`/agents`、`/worktrees`、`/keys`。两条路径可互换使用。

### CLI Flags

### 命令行参数

Flag | 参数 | Type | Default | Description | 说明
--- | --- | --- | --- | --- | ---
-p | string | "" | Prompt text; non-empty → print mode | 提示文本；非空则进入打印模式
-model | string | "" | Model ID override | 模型 ID 覆盖
-max-turns | int | 200 | Agent loop safety bound | Agent 循环安全上限
-max-tokens | int | 0 | Completion token cap (0 → default 16384) | 输出 token 上限
-auto-continue | bool | false | Auto-inject 'continue' on text-only turns | 自动注入 'continue'
-yolo | bool | false | Allow bash + writes outside CWD without prompting | 允许 bash 和写入当前目录外
-plan | bool | false | Read-only: no bash/writes/edits | 只读模式：禁止 bash/写入/编辑
-json | bool | false | Emit agent events as JSONL on stdout | 以 JSONL 格式输出事件
-resume | string | "" | Load a saved session by ID | 通过 ID 恢复会话
-continue | bool | false | Resume most recent session | 恢复最近的会话
-no-save | bool | false | Ephemeral session (don't persist) | 不持久化会话
-list | bool | false | List saved sessions and exit | 列出保存的会话
-no-project-md | bool | false | Skip AGENTS.md auto-load | 跳过 AGENTS.md 自动加载
-provider | string | "deepseek" | LLM provider (deepseek | anthropic | openai | gemini | compatible) | LLM 提供商
-base-url | string | "" | Base URL for --provider=compatible | 兼容端点的 Base URL
-theme | string | "auto" | Color theme (auto | dark | light) | 颜色主题
-rpc | bool | false | JSON-RPC 2.0 server over stdio | JSON-RPC 2.0 服务模式
-version | bool | false | Print version info | 打印版本信息
-upgrade | bool | false | Download latest release and replace binary | 下载最新版本并替换
-upgrade-force | bool | false | Force upgrade even for dev builds | 强制升级开发版本
-upgrade-dry-run | bool | false | Download + verify, do not replace | 下载 + 校验，不替换
-upgrade-check | bool | false | Check for newer release, never modify | 检查新版本，不改动
-dream | bool | false | M→L distillation scan (read-only) | M→L 蒸馏扫描（只读）
-dream-write | bool | false | Write dream candidates to soul.md | 写入 dream 候选到 soul.md
-no-suggest | bool | false | Disable suggested-reply predictor + UI placeholder (v4 柱 D) | 禁用建议回复预测 + UI 占位（v4 柱 D）
-no-cron-tick | bool | false | Skip startup cron auto-tick (jobs still fire via OS scheduler) | 跳过启动时 cron 自动 tick（不影响 OS 调度器触发）
-keep-checkpoints | bool | false | Preserve session checkpoints/ across session end (default: cleaned) | 会话结束时保留 checkpoints/（默认清理）
-install | bool | false | Add seek to user PATH (Windows) | 把 seek 添加到用户 PATH（Windows）
-benchmark | string | "" | Run benchmark task (self-hosting | fim-patch) and report metrics | 跑基准测试任务并报告指标
-benchmark-out | string | "" | With -benchmark: write JSON report to this file (default: stdout) | 与 -benchmark 配合：报告写入文件（默认 stdout）
-provider-name | string | "Compatible" | Display name for --provider=compatible | --provider=compatible 的显示名

💡 Use `seek --help` for the most up-to-date flag list. The table above reflects the source at `cmd/seek/main.go`. Reply language follows your input — there is no `/lang` or `--lang`. 💡 使用 `seek --help` 获取最新参数列表。上表反映 `cmd/seek/main.go` 中的定义。回复语言跟随你的输入，无 `/lang` 或 `--lang`。