常见问题

关于 Pawneer 的常见疑问。

Pawneer 怎么处理我的文件？

Pawneer 默认不信任任何外部路径。你需要通过 @ 明确告诉 Pawneer 可以访问哪个文件或文件夹。

每次会话结束，所有外部路径授权自动清空。系统目录（如 /System、/etc）始终不可访问。Pawneer 自己的工作目录（如 data/workspaces/）不需要额外授权。

打开 Pawneer 交互模式后，输入 @ 会弹出文件浏览器。方向键导航，Enter 选择。选中的文件夹或文件会被授权给当前会话。

底部状态栏会显示当前已授权的外部路径。

Provider、Capability 和 Skill 有什么区别？

它们不是同一层的东西，是三层分工：

Provider（执行底盘）负责真正调用外部 API，比 如 Bocha、AKShare。你不需要操作它，但凭据和运行时治理都在这一层。

Capability（系统能力）是 Provider 包装成可治理对象后的形态。可以被检查、发布、授权、 判断是否可执行。是日常接触的主要对象。

Skill（认知编排）把能力组织成可以对话、可以编排的任务入口。 大部分用户不需要直接接触它。

所以对用户来说：pawneer capability:list 是查看系统有什么能力，pawneer operator:ingest 是接入新能力。

Pawneer 怎么和其他 AI 助手不一样？

三个关键差异：

模型看不到密钥：你设置的 API 密钥在执行层注入， 模型只看到能力名，看不到密钥值。这是架构性隔离，不是提示词约束。

默认零信任：Pawneer 默认碰不到你的文件系统。 你需要通过 @ 主动授权每个路径，会话结束后授权自动清空。

LLM 不直接写系统状态：改名字、写记忆、导入能力 都经过受控的执行管道，模型只负责理解意图，执行层负责落盘。

Pawneer 记得我什么？

Pawneer 的记忆分三层：

会话记忆：当前对话中的内容。关闭后不会自动带入下次对话。

长期记忆：你的名字、偏好等明确告诉 Pawneer 的信息。跨会话保留，只有你自己能看到。

跨会话连续性：关闭对话后重新打开，Pawneer 会注入上次对话的摘要。你可以问"上次聊了什么"，Pawneer 会基于摘要回答，但不会暴露完整的原始对话。

Pawneer 不会把你个人对话中的内容带入工作场景。

personal 和 work 域有什么区别？

Pawneer 将你的使用场景分为不同的"域"：

personal（个人）：日常对话、个人事务。个人信息不会被 work 域引用。

work（工作）：工作场景。无法看到你的个人记忆。

Pawneer 怎么保护我的 API 密钥？

Pawneer 把 API 密钥当作系统治理对象——不是工具配置项。 密钥存储在本地 secrets.json 中，不经过模型上下文。 当你执行能力时，系统在 HTTP 请求层注入密钥，模型只看到能力名称， 看不到密钥明文。

通过 pawneer credential:set <服务名> <值> 安全设置密钥。 如果在对话中不小心粘贴了密钥，Pawneer 会自动检测并拦截，引导你改用安全方式。

Skill 是什么？

Skill 是 Pawneer 的能力扩展。每个 Skill 是一个经过验证的执行单元，拥有明确的能力边界。你可以通过 pawneer operator:ingest <材料> 统一接入， 系统会自动判断材料应该成为能力还是 Skill。

不同于其他 AI 助手的"插件"，Pawneer 的 Skill 在导入后需要经过验证才能运行——这保证了 Skill 不会越权操作。导入的 Skill 走零信任安全扫描，高风险 Skill 会被拦截。

初始化后为什么 skill:list 是空的？

这是正常的。Pawneer 初始化后默认不包含任何预装 Skill。你只会看到你主动导入或系统生成的 Skill。如果你看到标记为 [residue] 的残留记录，运行 pawneer init --reset 即可清理。

怎么切换模型？

Pawneer 支持多模型路由，会根据任务自动选择最合适的模型。你可以通过 pawneer llm:presets 查看当前可用模型。想同步最新的模型预设：

pawneer llm:sync

Pawneer 为什么有时候回复慢？

首次对话会稍慢（加载模型和配置），后续对话会更快。如果请求被识别为复杂任务（需要多步规划），可能会有额外延迟——这是 Pawneer 在分析、规划、验证你的请求。任务执行过程中你可以继续聊天，不阻塞。