# Personal Bot 领域术语

用于学习与知识积累、任务与项目推进、研究与决策支持。投资是专业应用领域，相关术语保留其投资含义。

## 研究与接入

**项目**：围绕有明确完成条件的任务保存的目标、过程、证据和结论。研究项目还保存相关假设和实验。

**长期事务**：持续维护的目标、已确认约束、决策依据和复盘，可以引用多个项目。

**长期投资事务**：持续维护的投资目标、已确认约束、决策依据和复盘，可以引用多个研究项目。

**回测实验**：在明确历史数据、策略规则与交易假设下进行的一次检验。结果只适用于记录的条件。

**交易机会分析**：结合目标、市场与持仓约束比较候选行动。等待与证据不足也是有效结论。

**专业方法**：开展学习、任务、研究或复核时使用的方法、判断依据和适用条件，不是所有任务必须经过的固定阶段。

**投资偏好**：用户对风险、仓位、收益、持有期限等事项的个人要求。它补充和约束专业判断，不是助手开展分析或提出方案的前置条件。

**工作区记忆**：跨会话查找、使用和修正所属资料的能力。正文只维护一份；保留的知识不证明当前事实、软件可用性或操作授权。

**项目资料维护**：根据已有工作结果与证据，整理和更新当前任务、直接关联资料及进行中任务的资料，由助手判断相关内容是否更新完整。可由用户主动发起，或由助手在正常交互中识别更新需要。

**能力提供方（provider）**：通过 CLI 或 MCP 提供数据查询、计算或业务操作的外部系统。它不同于 `src/services/` 中的业务服务。

**原生接入**：复用 CLI 的命令与认证，或使用 Pi 原生 MCP 配置、工具发现与调用。Personal Bot 不保存另一套操作目录或逐工具权限。

**受控变更**：经精确准备、必要复核和用户授权后执行的业务状态改变。交易是其中一类，不代表全部变更。

**接入知识**：对具体能力提供方的接口、调用方法、数据含义、限制及已验证事实的理解。知识不证明当前可用性，也不授予操作权限。

**能力提供方使用手册**：汇集一个能力提供方的接入知识、资料依据和验证记录的文档。

**调用约定**：原生操作的输入、结果与执行要求，按当前版本的帮助或协议定义核对。

**工作区**：组织学习资料、长期事务、项目、能力接入与执行记录的工作范围。用途可以组合；投资任务可覆盖多个市场。用户资料可以共享，应用状态独立保存。
_避免_：用工作区表示单个会话或真实账户。

**Personal Bot 启用**：Pi 按原生配置加载 Personal Bot 扩展。没有独立的工作区就绪状态；资料和外部服务是否准备好不影响加载，也不证明某项能力可用或已获执行许可。

**配套插件**：与 Personal Bot 配合提供附加能力、可独立安装的组件。其依赖的外部服务不属于插件本体，安装插件不代表服务已准备好。

**配套插件清单**：维护者为 Personal Bot 安装提供的候选插件集合，用户从中选择本次需要的插件。清单不等同于工作区实际安装内容；移出清单不表示卸载已有插件。

## 任务管理

**Task Conductor**：主会话通过原生 MCP 使用的独立任务系统，拥有周期、重复流程、DAG 和持久执行状态，不经 pbot 专家转发。taskId 标识任务定义，runId 标识一次执行，节点 ID 标识 DAG 节点，三者不能互换，也不与 pbot 子会话的 agentId 或工作周期 cycleId 混用。

**定时任务**：由 Task Conductor 按获授权的频率和时区触发的任务。每轮明确数据来源、期间与时点；文档记录周期不代表已经设置调度，任务本身不授予交易执行许可。取消当前执行与停止未来周期是不同操作。

## 角色与执行

**协调者**：协助用户学习和积累知识、推进任务与项目、开展研究并支持决策的主助手，负责方案建议、专家协作和已授权操作的结果跟踪。

**通用专家（general-purpose）**：pbot 唯一可委派类型，在独立子会话中完成研究、分析、计算或独立复核，按任务选择专业方法。start 使用新上下文，send 可继续既有上下文；独立复核须新建会话。通用职责不表示可以超出委派范围或绕过用户授权。

**独立复核者**：在新会话或独立任务节点中核验具体方案的事实与约束，给出通过、拒绝或无法确认结论的助手，不是另一个可委派的 pbot 角色类型。

**专家协作**：保留独立委派与团队工作。协调者组织和验收，团队成员可直接交换原文；轮流讨论或并行轮次由代码安排，不依赖协调者模型逐条转述。它不规定固定研究流程，不替代用户授权，也不承载 Task Conductor 的持久调度。

**团队（team）**：同一父会话中的固定成员和公共记录，以 teamId 标识。成员仍有各自的私人 Pi 上下文；团队关闭不销毁成员或清除记忆。

**团队批次（team run）**：以 runId 标识的一批有限轮次，采用 roundRobin 或 parallel。后者同轮并行、轮间汇合；结束不代表业务完成，暂停或恢复不自动重跑旧请求。该 runId 与 Task Conductor 的 runId 分属不同系统。

**专家职责**：通用专家 general-purpose 的工作范围与交付责任，不是子会话实例标识。工作区仅 coordinator.md 和 general-purpose.md 的职责补充会被加载。

**子会话（agent）**：由 start 创建的独立 Pi 会话，以 agentId 标识；新布局中它也是原生 session ID，对话文件由 Pi 管理。工作结束后可用 send 继续对话；停止后用 resume 携新要求显式恢复，不重放旧工作。它绑定父会话与创建分支，不是持久任务调度器。

**工作周期（cycle）**：子会话从开始处理到本轮结束的一次活动，以 cycleId 标识。一个周期可处理多条消息；进程空闲不代表上轮工作成功。

**消息请求（request）**：父侧提交的一条子会话消息，以 requestId 标识。入队或接收不证明模型已阅读或任务已完成。

**专家交付**：专家为本次委派提供的报告、证据与产物引用；用户指令明确要求修改资料时，也可包含相应的资料修改。

**独立复核**：由新通用专家会话或独立 Task Conductor 节点，根据原始依据核验具体方案，可覆盖多个操作。不能用 send 或 steer 把原分析会话改称独立复核。它属于方案层面的工作约定，不是单次工具调用的程序门槛，也不替代用户授权；任务协调器验收不等于专业复核。

**候选合约**：参与本次比较的具体期权合约，尚不表示可交易。

**交易方案**：包含对象、方向、数量、价格条件及约束的具体行动建议。

**交易复核**：对具体方案的规则、数据、持仓、计算和订单约束进行独立核验。复核通过不代表用户授权。
_避免_：将批准与授权混用。

**复核证据**：本次核验的规则、数据、计算和订单依据，包含来源与时间。

**用户授权**：用户请求或明确确认的业务范围与条件。工具可用、研究请求和复核通过不自动授权业务变更。

**执行意图**：包含目标、参数和约束的具体操作准备，不表示已获许可或已发送。
_避免_：用订单指尚未发送的意图。

**执行尝试**：一次操作进入执行阶段的事实，不证明外部能力提供方已收到或执行。

**执行回执**：外部工具返回的结果，不必然证明成功或成交。

**未知执行义务**：调用可能已生效但结果无法确定的待核对事项，不自动阻塞其他调用，也不授予重发许可。后续操作仍须符合当前任务授权；不能从未知结果推断没有副作用。

**人工结案**：用户核对外部事实后记录处理结论，结束该未知义务的核对事项，不授权重发操作。