技能

技能是教 Klaus 完成特定任务的说明书，命中场景时自动加载。

• 市场档：卡片网格浏览技能市场，一键安装。
• 已安装档：列表管理已装技能，可启用/禁用；顶部作用域切换在「全局」和各项目之间切换——全局技能所有会话可用，项目技能只在该项目生效。
• 技能也可由你自己编写，或让 Klaus 帮你创建。

磁盘上的形状与几个容易踩的点：

• 一个技能就是一个目录，里面必须有 SKILL.md；开头一段 YAML 前置属性声明它的名字、描述、图标、标签、允许用的工具，以及适用系统和依赖（需要哪些命令、哪些环境变量）。描述写得准不准直接决定它会不会在对的时候被用上。
• 位置：全局 ~/.klaus/skills/<技能名>，项目 <项目>/.klaus/skills/<技能名>（只限已登记的项目根）。项目目录下只有带 SKILL.md 的目录才算技能，不会把仓库里碰巧同名的目录当成技能。
• 安装：从云端市场下压缩包（包 ≤ 256MB、解开后 ≤ 512MB）。市场内容现在完全由服务端托管，客户端不再随包内置一份本地副本——所以离线时技能广场会直接显示一条错误，而不是退回一份内置清单（未登录的游客也能看和装，市场接口是公开可读可装的）。装过什么、装的哪个版本记在 ~/.klaus/skills/.install-records.json，「有更新」就是拿它比出来的。更新按技能名进行，不指定版本就取最新。
• 禁用不删文件：只在 settings.db 里记一行「这个技能关着」。所以禁用可逆，重新启用不需要重装；真要删掉才是卸载。
• 生效时机：安装、修改、启停或删除技能后，已经开着的会话和输入框里的 / 菜单、技能菜单会自动更新到最新内容，不用重开会话，也不用重启应用。直接在磁盘上改 SKILL.md 也会被发现，最多稍等十秒。已经发出的请求继续用它开始时的那份技能清单；每个会话自己的技能范围（全局、哪个项目）保持不变。

内置的 PDF 技能

Klaus 自带一个 PDF 技能：提取文字和表格、把页面渲染成图片检查版式与图表、生成新的 PDF，以及拆分、合并、旋转。它需要的 Python 运行环境由 Klaus 自己管理：第一次用到时自动下载并校验，之后重复使用，不碰你机器上自己的 Python。它不带 OCR，扫描件里的文字读不出来；远程（SSH）项目里的 PDF 要用远端机器自己的环境处理。