[260630] x-cmd v0.9.10：别再把噪音目录喂给 Agent 了，x find 帮你自动过滤、x bfind 由浅入深地搜索

• x find 默认排除 .git / node_modules / Library 等噪音目录，专为 Agent 设计
• x bfind 升级为 BFS 广度优先搜索，并新增 --dfs2bfs 把任意 DFS 输出重排为浅层优先
• x claw 新增 service install/uninstall，可注册为系统开机自启动服务（macOS launchd / Linux systemd）

🚀 X-CMD v0.9.10 Beta 更新详情

claw 🤖

修复 x claw log 内部 awk 迭代调用的问题

修复 x claw log 内部 awk 迭代调用函数的问题 —— 说实话，这个坑藏得有点深。

x claw log 在解析日志时内部用 awk 做函数迭代调用，结果在某些场景下会触发 awk 的实现差异（比如函数递归/迭代深度、变量作用域），导致日志输出中断或者格式错乱。

这次把内部调用逻辑理顺了，绕过 awk 的迭代限制，现在 x claw log 在各种环境下都能稳定出日志。

# 查看 claw 日志
x claw log

新增 x claw service install/uninstall

新增 x claw service install/uninstall 功能 —— 让 x claw 能自己照顾自己开机。

之前想让 x claw 随系统启动，得自己手写 launchd plist 或者 systemd unit，步骤不少还容易配错。我干脆把它包成两个命令。

现在你只需要：

• x claw service install —— 自动生成并注册开机自启动（macOS 用 launchd plist，Linux 用 systemd unit）
• x claw service uninstall —— 干净移除，不留痕迹

# 注册开机自启动
x claw service install

# 移除开机自启动
x claw service uninstall

当然，不同系统的服务路径和权限要求略有不同，如果安装完没生效，检查一下对应的服务管理器状态就行。

优化 x claw 的运行时体验

优化 x claw 的运行时体验 —— 配置、心跳、告警、日志这几块都顺手多了。

之前初次配置步骤多、心跳固定轮询有点浪费、agent 挂了没动静、日志又全堆在一起，排查起来费劲。这次一并收拾了一下：

• 交互配置流程合并精简，默认选项给好，几步就能配完
• 心跳调度策略优化，减少不必要的轮询
• agent 连续失败或抛错时，会通过已连接的 IM 平台发告警
• 日志分级分类优化，排查问题更顺手

# 交互配置
x claw init

# 启动后新调度、告警自动生效
x claw start

整体用起来更省资源，出问题也更好定位。

find 🔍

x find 重构为"三维剪枝"模型 —— 为 Agent 量身打造的 find，默认就把噪音目录挡在门外。

原生 find 搜代码，结果里总混着 .git、node_modules、.cursor、.claude 一堆噪音；搜 $HOME 时 Library、Desktop 也会冒出来，macOS 还弹一堆权限框。这些噪音喂给 Agent，token 瞬间被撑爆。x find 把"什么该排除"拆成三个互不干扰的维度，按需开关：

• 隐藏目录 —— 最大的噪声源。默认 .* 全排，--unhide .vscode:.claude 按目录放行。
• 项目噪音 —— 默认只排 node_modules、__pycache__，--prune vendor:venv 追加。
• HOME 平台目录 —— 根为 $HOME 时自动排 Applications/Library 等（顺带避开权限弹窗），--no-homeprune 关闭。

100% 兼容原生 find 表达式，--prune / --unhide 支持 : 分隔多值，-v 看生效列表、--dryrun 打印生成命令，三维全关即退化原生 find。

# 自动排除隐藏目录和 node_modules 等噪音
x find . -name "*.ts"

# 放行 .vscode .claude，只在这俩里找 json
x find --unhide .vscode:.claude -- . -name "*.json"

# 追加排除 build、release 目录
x find --prune build:release -- . -name "*.go"

# 看看当前到底排了哪些
x find -v -- . -name "*.ts"

bfind 📂

x bfind 升级为 BFS 广度优先搜索 —— 浅层结果先出，让 Agent 先看到最相关的文件。

原生 find 是深度优先，会一头扎进 node_modules 层层依赖的最深处才回头，可项目真正的源码、配置都在浅层——agent 先翻过一堆深层噪音，最后才在浅层撞见想要的文件。x bfind 换成广度优先，浅层打头、逐层深入，agent 先拿到项目骨架，不够再往下，又快又省。

更妙的是 --dfs2bfs——它不搜索、只重排，把任何工具的 DFS 输出按深度重排成 BFS 顺序。现有 find / grep 管道尾巴接一个 | x bfind --dfs2bfs，结果立刻浅层优先；原生 find、x find、grep -rl 匹配文件都能一键"浅层优先化"。默认 3 层（--depth 加深、--all 不限），剪枝规则与 x find 一致；终端里按深度分段着色、文件名高亮。

# BFS 搜索当前目录，默认 3 层
x bfind .

# 任意 find/grep 结果按浅层优先重排
grep -rl "TODO" . | x bfind --dfs2bfs

# 加深到 5 层；--all 不限深度
x bfind --depth 5 .

⬆️ 如何升级

现有用户可以通过以下命令快速切换至 Beta 版本进行体验：

x upgrade beta

如果你没有安装 x-cmd, 只需要打开你的终端:

eval "$(curl https://get.x-cmd.com)"

x-cmd 是一个一站式的命令行工具集，其强大的功能可以为人类用户和AI共同使用。它还简化了很多工具的安装方法。
马上安装，让 x-cmd 协同 AI 成为你的最强助手，实现生产力翻倍！

🤝 开发者反馈

如果您在自定义配置或代理设置中遇到任何疑问，欢迎前往 GitHub Issues 提交反馈，共同完善 X-CMD 生态。