| name | lx-sh |
| version | 1.0.0 |
| description | 虚拟 Shell 引擎，用 UNIX 命令浏览和探索乐享知识库。支持 ls/cat/grep/find/tree/awk/fzf 等命令、管道、重定向、变量替换。两种模式：Worktree 本地模式和 MCP 远程模式。触发词：shell、sh、浏览知识库、grep、ls、cat、搜索文件、虚拟shell |
| metadata | {"requires":{"bins":["lx"]}} |
虚拟 Shell
前置条件： 需要 lx CLI 已配置并登录。
⚡ 什么时候用这个 skill？
进入场景：
- 用户说"浏览知识库"/"看看知识库结构"
- 用户说"搜索文件内容"/"查看文档内容"
- 用户说"在知识库里执行 grep/ls/cat"
禁止在本 skill 中执行：
- 不要修改内容：用户说"编辑某个页面"/"推送修改" → 立即切换到 lx-git 或 lx-block skill
- Shell 是只读的：
/kb 是只读文件系统，rm/mv/cp/mkdir/touch 等写命令会被拦截
⚡ 怎么选命令？（决策树）
识别场景 →
├── 交互式浏览知识库内容? → lx sh（REPL 模式）
├── 执行单条命令后退出? → lx sh --exec "<command>"
├── 连接远程知识库（无需本地 clone）? → lx sh --space sp_xxx
├── 在已有 worktree 中浏览? → cd <worktree> && lx sh
├── 搜索知识库内容? → lx sh --exec "grep -r <pattern> /kb"
├── 查看文档结构? → lx sh --exec "tree /kb"
└── 需要修改内容（push/commit）? → 切换到 lx-git skill
⚠️ 高风险操作与默认优先路径
只读文件系统：
- Shell 中的
/kb 是只读的，rm/mv/cp/mkdir/touch 等写命令会被拦截
- 需要修改内容请使用
lx git 或 lx block 命令
默认优先路径：
- Agent 应优先使用
lx sh --exec "..." 单次执行，避免启动 REPL
- 不想 clone → 用 MCP 远程模式
lx sh --space sp_xxx
- 已有本地 worktree → 在 worktree 目录中执行
lx sh
两种运行模式：
| 模式 | 启动方式 | /kb 映射 | 适用场景 |
|---|
| Worktree | cd <worktree> && lx sh | 本地磁盘 | 已 clone 的知识库，需要快速浏览 |
| MCP 远程 | lx sh --space sp_xxx | 远程 MCP API | 不想 clone，直接浏览远程内容 |
可用工具
启动命令
| 命令 | 说明 |
|---|
lx sh | 启动 REPL 交互模式 |
lx sh --exec "<cmd>" | 执行单条命令后退出 |
lx sh --space sp_xxx | MCP 远程模式 |
lx sh --path <dir> | 指定 worktree 路径 |
详细参数：lx sh --help
Shell 内置命令（在 lx sh 中使用）
| 分类 | 命令 |
|---|
| 文件浏览 | ls, cat, tree, stat |
| 搜索 | grep, find, fzf |
| 文本处理 | head, tail, wc, sort, uniq, awk, cut, tr |
| 导航 | cd, pwd, echo |
| 桥接命令 | search, mcp, git |
详细参数：lx sh --help，或在 Shell 内输入 help
🎯 执行规则
- 只读文件系统：Shell 中的
/kb 是只读的，rm/mv/cp/mkdir/touch 等写命令会被拦截。需要修改内容请使用 lx git 或 lx block 命令。
- 管道和重定向：完整支持
| 管道和 > 重定向。如 grep -r "API" /kb | head -20。
- 别名系统：
rg → grep -rn、eza → ls、fd → find、bat → cat。用户使用现代工具名时自动转换。
- Shell 内 git 只读：在 Shell 中输入
git status/git log/git diff 可用（只读），但 git push/git commit 等写操作会提示退出 Shell 用 lx git 执行。
/tmp 可写：/tmp 目录是内存文件系统，可以写入临时数据。- 非交互模式：Agent 应优先使用
lx sh --exec "..." 单次执行，避免启动 REPL。
- search 命令：Shell 内置的
search <keyword> 是对 MCP search_kb_search 的快捷封装。
- mcp 透传：Shell 内的
mcp <tool_name> [json_args] 可以直接调用任意 MCP tool。
典型组合流程
浏览远程知识库结构
lx sh --space sp_xxx
tree /kb --depth 2
ls -la /kb/项目文档/
cat /kb/项目文档/README.md
在知识库中搜索内容
lx sh --exec "grep -r 'OAuth' /kb | head -10"
lx sh --exec "search OAuth 认证"
分析文档内容
lx sh --exec "wc -l /kb/**/*.md"
lx sh --exec "grep -rl 'TODO' /kb"
lx sh --exec "find /kb -name '*.md' | wc -l"
编程 API 用法（Agent 集成）
lx sh --exec "grep -r 'API 设计' /kb | head -5"
lx sh --exec 'mcp entry_describe_entry {"entry_id": "entry_xxx"}'
