← 用户指南

深入使用

任务管理、记忆与 Skill。

任务管理

Pawneer 可以同时处理对话和后台任务。当你的请求被识别为需要长时间执行的任务时，Pawneer 会自动提示你是否提交为后台任务。

分析 ~/Downloads/large-dataset.csv 中的所有数据

查看任务列表

pawneer tasks

查看任务统计

pawneer tasks --stats

实时监控任务

pawneer tasks --watch

进入任务对话

pawneer attach <任务ID>

当任务需要你提供额外信息时，Pawneer 会提示你进入任务对话。任务 ID 可以简写。

取消任务

pawneer tasks cancel <任务ID>

记忆

Pawneer 会在对话中记住关于你的信息。

记忆类型

类型	说明
会话记忆	当前对话中的内容。同一次对话内 Pawneer 能记住你说过的话，但关闭后不会自动带入下次对话。
长期记忆	你的名字、偏好等明确告诉 Pawneer 的信息。跨会话保留，只有你自己能看到。
跨会话连续性	关闭对话后重新打开，Pawneer 会提炼上次对话的摘要注入新会话。你可以问"上次聊了什么"。

主动告诉 Pawneer 记住什么

记住，以后回答尽量简洁。

记住，我用 TypeScript，不是 JavaScript。

查看记忆

pawneer memory:status

或者直接问 Pawneer：

你现在记得我什么

压缩会话记忆

当对话较长时，可以主动压缩记忆：

pawneer memory:compact

记忆是私有的。personal 域下的对话内容不会泄露到 work 域。

Pawneer 的能力架构

Pawneer 把能力分为三层，每层各司其职：

Provider：执行底盘。Bocha、AKShare 这些外部 API 的调用都由它负责。你不直接操作它，但密钥和运行时治理都在这一层。
Capability：系统级能力。每个接入的 API 文档被系统接受后成为一项能力。你可以检查它、发布它、看它能不能执行——是日常接触的主要对象。
Skill：认知编排层。把能力组织成可对话、可编排的任务入口。大部分用户不需要直接接触 Skill，系统会在后台按需生成。

所以对用户来说，默认操作路径是：

pawneer capability:list                     # 查看系统已有的能力
pawneer capability:inspect <id>             # 查看某个能力的详细状态
pawneer operator:ingest <材料>              # 接入新能力（自动分流）

统一接入入口

pawneer operator:ingest <材料路径>

系统按材料类型自动判断分流。如果无法判断，会提示你显式指定。

从 GitHub 或 URL 接入

pawneer operator:ingest --from-github <路径>
pawneer operator:ingest --from-url <URL>

专家入口

pawneer capability:ingest <Markdown文件>   # API Markdown 文档
pawneer skill:import <文件或目录>        # Skill 包或目录

导入其他智能体的能力包

Pawneer 可以导入其他 AI 智能体的外部能力包。导入不是直接注入 system prompt—— 它经过完整的零信任安全扫描、域名授权确认和配置验证，然后以受控的执行单元运行。

pawneer operator:ingest ./path/to/skill.yaml

外来能力不能绕过权限边界。导入后的能力需要经过验证线才能正式进入运行态。

资产可携带

你可以把你的能力和配置打包成 .pwnpkg 文件迁移到另一台设备。整个过程受控可审计。

pawneer asset:import-check <包路径>         # 先检查能不能恢复
pawneer asset:import-orchestrate <包路径>     # 自动补齐缺项
pawneer asset:import <包路径>                 # 执行最终导入

如果缺了依赖的外部功能，系统先尝试用本地官方快照补齐，不会直接失败。

能力管理

每个接入的能力都是系统中的一个可治理对象——可以查看执行状态、来源追溯、凭据需求，以及当前是否可执行。

查看所有能力

pawneer capability:list

查看单个能力的详细信息

pawneer capability:inspect <能力ID>

展示完整的执行状态、来源追溯、凭据状态、binding 信息。如果能力当前不可执行，inspect 会显示原因。

查看能力来源

pawneer capability:provenance <能力ID>

能力治理导航

pawneer capability:guide

Skill 管理

Skill 是外部技能的导入容器，通过能力来执行实际操作。查看已安装的技能：

查看已安装的 Skill

pawneer skill:list

初始化后，Skill 列表通常为空。你会看到你主动导入或系统生成的 Skill。

导入 Skill

pawneer skill:import ./path/to/skill.yaml

支持导入单个文件或整个目录。导入过程包含安全扫描。

删除 Skill

pawneer skill:remove <skill名称>

验证 Skill 配置

pawneer skill:validate

凭据安全

API 密钥是系统的一等治理对象。Pawneer 保证密钥不会被模型接触到——你通过命令设置密钥后，系统在执行层注入 HTTP header，模型只看到能力名称，看不到密钥明文。

pawneer credential:set <服务名> <密钥值>   # 安全设置
pawneer credential:list                    # 查看已配置（不显示明文）
pawneer credential:audit                   # 查看变更审计

如果在对话中不小心粘贴了密钥，Pawneer 会自动检测并拦截，引导你改用安全方式设置。

LLM 配置

查看可用模型预设，选择最适合当前任务的模型：

pawneer llm:presets

同步最新模型预设：

pawneer llm:sync