WorkBuddy自定义Skill默认仅限访问当前工作空间文件,需在SKILL.md中声明allowed_paths或通过图形界面配置路径白名单;Windows路径用双反斜杠或正斜杠,macOS/Linux路径须以/开头;支持通过parameters动态传入路径,但不可跨磁盘分区访问。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

WorkBuddy自定义Skill运行时默认只能访问当前工作空间内的文件,若需让Skill处理指定路径下的文件(比如D:Reports或~/Downloads/),必须在Skill定义中显式声明可读取的目录范围,否则会因权限隔离直接报错“文件不存在”或“无访问权限”。
在SKILL.md中声明允许的文件路径
打开你的Skill文件夹,编辑根目录下的【SKILL.md】文件,在YAML头信息末尾添加allowed_paths字段:
```yaml
name: pdf-summary-skill
display_name: PDF内容摘要生成器
description: 读取PDF并输出结构化摘要
category: document
allowed_paths:
- "/Users/yourname/Documents/reports/"
- "D:\Projects\data\"
```
⚠️注意:Windows路径必须用双反斜杠\或正斜杠/,单反斜杠会被YAML解析为转义字符导致路径失效;macOS/Linux路径必须以/开头,相对路径(如./input/)不被识别。
通过图形界面配置路径白名单(仅限WorkBuddy v3.2+)
方法一:在Skills管理页点击目标Skill右侧的【设置】图标→切换到「安全策略」标签页→在「允许访问的本地路径」输入框中逐行填写绝对路径→点击【保存】。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表,就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
方法二:若该Skill由图形化新建流程创建,可在初始配置页勾选「启用自定义文件路径访问」,随后出现路径输入区;【未勾选此项则SKILL.md中声明的allowed_paths将被忽略】。
使用变量动态限定范围
第一步:在SKILL.md的YAML头中定义路径参数:
```yaml
parameters:
target_folder:
type: string
description: 要处理的文件夹路径
required: true
allowed_paths:
- "{{target_folder}}"
```
第二步:调用Skill时传入具体路径,例如在聊天框输入:“用pdf-summary-skill处理这个文件夹:/Users/yourname/Inbox/PDFs/”。WorkBuddy会校验该路径是否符合系统级工作空间约束——【即使声明了allowed_paths,也不能突破工作空间所在磁盘分区】,比如工作空间在C盘,就无法授权访问D:Data。
第三步:AI执行时自动将{{target_folder}}替换为实际值,并仅扫描该目录下匹配的文件(如*.pdf)。

















