企业官网建设流程全解析

IRIS 是一款开源的终端 Shell 自动补全工具，像代码编辑器的 IntelliSense 一样在真实终端中实时推荐命令。本文面向新手，完整解析 IRIS 进阶用法：如何用一键快捷键在 spec（命令规范）与 history（历史命令）两种模式间切换，以及 Frecency 频率×新鲜度算法是如何驱动历史命令搜索与智能排序的。

🧭 一分钟理解 IRIS 的双模式

IRIS 把建议来源分成两条清晰的"管道"，你在终端里实际感受到的就是两种菜单：

两种模式的合并与排序逻辑分别实现在 root/suggestions.go 与 integration/history.go 中，核心设计文档见 docs/dev/spec.md、docs/dev/history.md。

⚡ 一键切换模式：Ctrl+R 的正确打开方式

IRIS 默认把Ctrl+R从传统的"反向搜索历史"升级成了模式切换键——按一次从spec切到history，再按一次切回来，切换状态会立刻持久化：

• 切换逻辑在 root/wrapper.go 中实现：按下后立即saveMode写入状态文件；
• 状态保存在~/.local/share/iris/state.toml（last-mode字段），下次启动自动恢复上次的模式，源码见 internal/config/state.go。

💡 小技巧：在空提示符下按↑/↓，IRIS 会直接打开当前模式的建议列表（history 模式下就是最近 100 条命令），无需再敲任何字符。

通过配置文件固定初始模式

如果想让每次启动都固定在某一种模式，编辑~/.config/iris/config.toml（用iris config init生成）：

[core] mode = "last" # "last" = 记住上次手动切换的模式 # "spec" = 固定规范补全 # "history" = 固定历史搜索

三种取值的含义：

• last（默认）：跟随你最后一次Ctrl+R切换的结果，最常用；
• spec：强制以命令规范为中心，适合日常写命令；
• history：强制以历史命令为中心，适合"回忆型"工作流。

默认值定义见 internal/config/defaults.go。

🔍 History 模式进阶：模糊搜索 + 分层排序

切到 history 模式后，输入任意片段即可搜索全部历史命令。IRIS 的匹配策略比"纯模糊搜索"更聪明，按匹配强度分层（源码：integration/history.go）：

1. 完全相等>前缀匹配>子串包含>模糊匹配，层级越靠前排名越高；
2. 同层内，子串完全命中的命令按"最近使用"优先，保证长命令不会被模糊评分截断；
3. 极弱的模糊匹配（分数/查询长度 < 150）会被直接过滤，避免乱码输入时刷屏；
4. 别名自动转换：你敲gr会同时搜go run，你敲go run也会反向搜gr，双向都成立；
5. history 模式的置信度还按"结果列表位置"衰减（越靠前分越高），让最近常用的命令稳定置顶。

另外两个实用能力：

• atuin 数据源叠加：atuin-history = 2可把 atuin 数据库里的历史一起搜进来（默认0只用 Shell 原生历史）；
• 惰性加载：只有真正触发历史搜索时才读盘，平时零开销，并且文件一旦更新（你执行了新命令）缓存自动失效重读。

🧠 Frecency 算法完全解析：命令为什么"越用越靠前"

Frecency = Frequency（频率）× Recency（新鲜度）。这是 spec 模式下建议排序的核心引擎，数据落在本地 SQLite 数据库~/.local/share/iris/history.db，实现见 internal/scoring/frecency.go。

1. 打分公式：次数 × 时间衰减权重

每执行一条命令（退出码为 0 时），该命令在当前目录下的计数 +1；随后按"最后使用距今时间"套一档衰减权重：

也就是说：一条"近 1 小时用过 3 次"的命令得分是 300，一条"一个月前用过 20 次"的命令只有 100——近期高频命令永远压制远期高频命令。失败执行的命令只刷新时间、不增加次数，避免"跑不通的命令"被反复推荐。

2. 本地 vs 全局双重检索

打分时会同时查询两个维度（internal/scoring/signals.go）：

• Local：只统计"当前工作目录"下执行过的命令——你在项目 A 里常用的make build，回到项目 B 不会乱入；
• Global：统计所有目录，作为兜底补充。

3. 工作流学习：它会记住你的"命令连招"

IRIS 还会把相邻两条命令记录成"转移对"，并先做骨架归一化：git commit -m "feat: x"会被提取成骨架git commit（参数和引号内容全部剥离，源码：internal/scoring/skeleton.go）。

于是git add之后敲git c时，git commit会因"上一步刚执行过 git add"而获得优先级加成。查询策略是"本地目录优先、查不到再全局汇总，且支持骨架逐级截断兜底"，见 internal/scoring/frecency.go。完整算法设计文档：docs/dev/scoring.md。

⚙️ 高频实用配置速查

在~/.config/iris/config.toml中最值得了解的几项：

[core] mode = "last" # 双模式初始策略 atuin-history = 0 # 0=Shell历史 1=仅atuin 2=两者合并 navigate-closed = "history" # 菜单关闭时按↑↓：浏览IRIS历史列表 / 交还给Shell [keybindings] toggle-mode = "ctrl+r" # 模式切换键，可自行改成别的组合键

配置项清单可运行iris config show查看；模式相关的默认值集中在 internal/config/defaults.go。

🎁 进阶加分项：给自用的命令行工具写一份自定义 spec，spec模式的 Frecency 排序会立刻"认识"它——

iris spec init mycli # 生成 JSONC 模板 iris spec path # 打印 specs 目录位置

spec 文件在启动时自动加载并与内置 spec 合并，格式说明见 README.md 与 spec/schema.json。

📌 总结：三句话掌握 IRIS 进阶用法

• 切换：Ctrl+R一键切换 spec/history，模式自动记忆（state.toml）；
• 搜索：history 模式支持模糊 + 分层排序 + 别名双向匹配，空输入即浏览最近 100 条；
• 排序：spec 模式由 Frecency（次数×时间衰减）+ 本地/全局双维度 + 工作流连招学习共同驱动，用越久越懂你。

理解了这套机制，你就知道为什么 IRIS 的"第一条建议"几乎总是你最想执行的那条命令了。