# Personal Bot 领域术语

## 资料与接入

**项目**：围绕明确任务保存的目标、资料、结论与交付物。研究项目还包括假设和实验。

**长期事务**：持续维护的目标、约束、决策依据与复盘，可关联多个项目；投资事务保留相应市场与持仓约定。

**专业方法**：按任务选择的研究、计算、分析或复核方法，包含适用条件与判断依据。

**工作区**：组织资料和开展工作的目录范围。两种宿主共享业务资料与历史归档，各自管理原生会话、配置和运行状态。

**工作区记忆**：跨会话查找、使用与修正资料的能力，同一主题维护一份当前正文。

**历史消息树（history）**：问答原文、分层摘要、父子关系和来源引用组成的检索资料。完整工具日志、图片与会话恢复由原生存储负责。

**资料维护**：根据任务进展更新相关说明，归集成果，提炼可复用的方法与口径。

**能力提供方（provider）**：通过 CLI 或 MCP 提供查询、计算或业务操作的外部系统；代码中的 `src/services/` 则是插件自身的业务服务。

**原生接入**：使用 CLI 的命令与认证，或宿主的 MCP 配置、工具发现与调用。

**提供方手册**：外部系统的使用入口，记录接口用途、数据口径、配置位置、限制与来源。

**调用约定**：当前工具版本的输入、结果与执行要求。

**Personal Bot 启用**：宿主按原生配置加载扩展。资料准备使用可选的 `/pbot init`。

**配套插件**：独立安装的附加能力。所需外部服务按该插件的流程准备。

**配套插件清单**：安装器展示的候选集合；用户选择本次安装项，未选中的已有插件保留。

## 专家与团队

**协调者**：主会话助手，负责分析、任务组织、专家协作和结果跟踪。

**通用专家（general-purpose）**：具有独立上下文和任务归属的子会话，在委派范围内完成研究、实现、计算或复核。工作区可在 `agents/general-purpose.md` 补充职责，协调者对应 `agents/coordinator.md`。

**子会话（agent）**：由 start 创建，以 agentId 标识，绑定所属宿主、父会话和分支。存活时可 send，停止后用 resume 携新要求恢复。

**团队（team）**：同一父会话中的固定成员、共同目标与公共记录，以 teamId 标识。关闭团队保留成员与历史。

**团队批次（team run）**：以 runId 标识的有限轮次。roundRobin 按成员顺序执行；parallel 同轮并行，完成后进入下一轮。继续讨论使用新批次。

**工作周期（cycle）**：子会话一次受管工作，以 cycleId 标识，可处理多条消息。结果通过对应周期报告查看。

**消息请求（request）**：以 requestId 标识的一条输入，按接纳、消费和完成记录状态。

**专家交付**：本次任务的报告、产物与来源引用；要求修改文件时包含约定范围内的修改。

**独立复核**：由新专家会话或独立 Task Conductor 节点，根据原始资料核验具体方案。复核者沿用通用专家类型，复核要求由任务决定。

## 外部任务与操作

**Task Conductor**：通过原生 MCP 使用的独立任务系统，管理周期、重复流程、DAG 与持久执行状态。taskId 对应任务定义，runId 对应一次执行，节点 ID 对应 DAG 节点；与 pbot 的标识分别使用。

**定时任务**：由服务按约定频率和时区触发，每轮明确数据期间与执行范围。当前执行与未来周期分别停止。

**用户授权**：用户请求或明确确认的操作范围与条件。交易、转账和账本修改需在相应授权范围内执行。

**受控变更**：按任务完成准备、必要复核与用户授权后执行的业务状态改变。

**执行意图、尝试与回执**：分别指操作准备、进入执行阶段和外部工具返回的结果。

**未知结果**：操作可能已经生效而结果尚不清楚的状态。先按原业务标识查询，再决定后续动作，避免重复执行。

**人工结案**：用户核对外部事实后保存处理结论，结束待核对事项。

## 投资研究

**投资偏好**：用户对风险、仓位、收益、持有期限等事项的要求。

**回测实验**：使用记录的数据、策略规则、市场约束与交易假设检验策略。

**交易机会分析**：结合目标、市场与持仓约束比较候选行动，可得出继续研究或等待的结论。

**候选合约**：参与当前分析与比较的具体期权合约。

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

**交易复核**：核验方案的规则、数据、持仓、计算与订单约束，保留所用依据和时间。执行仍遵循用户授权。