personal-bot 0.1.0 → 0.1.1

package/CONTEXT.md

@@ -41,9 +41,9 @@ _避免_：用工作区表示单个会话或真实账户。
 
 ## 任务管理
 
-**Agent Task**：主会话通过原生 MCP 使用的独立任务系统，拥有周期、重复流程、DAG 和持久执行状态，不经 pbot 专家转发。taskId 标识任务定义，runId 标识一次执行，节点 ID 标识 DAG 节点，三者不能互换，也不与 pbot 子会话的 agentId 或工作周期 cycleId 混用。
+**Task Conductor**：主会话通过原生 MCP 使用的独立任务系统，拥有周期、重复流程、DAG 和持久执行状态，不经 pbot 专家转发。taskId 标识任务定义，runId 标识一次执行，节点 ID 标识 DAG 节点，三者不能互换，也不与 pbot 子会话的 agentId 或工作周期 cycleId 混用。
 
-**定时任务**：由 Agent Task 按获授权的频率和时区触发的任务。每轮明确数据来源、期间与时点；文档记录周期不代表已经设置调度，任务本身不授予交易执行许可。取消当前执行与停止未来周期是不同操作。
+**定时任务**：由 Task Conductor 按获授权的频率和时区触发的任务。每轮明确数据来源、期间与时点；文档记录周期不代表已经设置调度，任务本身不授予交易执行许可。取消当前执行与停止未来周期是不同操作。
 
 ## 角色与执行
 
@@ -53,7 +53,7 @@ _避免_：用工作区表示单个会话或真实账户。
 
 **独立复核者**：在新会话或独立任务节点中核验具体方案的事实与约束，给出通过、拒绝或无法确认结论的助手，不是另一个可委派的 pbot 角色类型。
 
-**专家协作**：由协调者按需委派独立子会话，并汇集结论、依据与缺口。它不规定固定研究流程，不替代用户授权，也不承载 Agent Task 的持久调度。
+**专家协作**：由协调者按需委派独立子会话，并汇集结论、依据与缺口。它不规定固定研究流程，不替代用户授权，也不承载 Task Conductor 的持久调度。
 
 **专家职责**：通用专家 general-purpose 的工作范围与交付责任，不是子会话实例标识。工作区仅 coordinator.md 和 general-purpose.md 的职责补充会被加载。
 
@@ -65,7 +65,7 @@ _避免_：用工作区表示单个会话或真实账户。
 
 **专家交付**：专家为本次委派提供的报告、证据与产物引用；用户指令明确要求修改资料时，也可包含相应的资料修改。
 
-**独立复核**：由新通用专家会话或独立 Agent Task 节点，根据原始依据核验具体方案，可覆盖多个操作。不能用 send 或 steer 把原分析会话改称独立复核。它属于方案层面的工作约定，不是单次工具调用的程序门槛，也不替代用户授权；任务协调器验收不等于专业复核。
+**独立复核**：由新通用专家会话或独立 Task Conductor 节点，根据原始依据核验具体方案，可覆盖多个操作。不能用 send 或 steer 把原分析会话改称独立复核。它属于方案层面的工作约定，不是单次工具调用的程序门槛，也不替代用户授权；任务协调器验收不等于专业复核。
 
 **候选合约**：参与本次比较的具体期权合约，尚不表示可交易。
 

package/README.md

@@ -28,17 +28,19 @@ pi
 
 源码位于其他目录时，将安装命令中的路径换成实际绝对路径。本地安装直接加载来源目录，请保留源码和依赖。
 
-### 可选安装 Agent Task
+### 可选安装 Task Conductor
 
-需要周期任务、重复流程或 DAG 时，安装接入包 `@realqiyan/agent-task-plugin`。它不是服务包 `@realqiyan/agent-task`，也不是启用 pbot 的前提。该接入方式需要 Pi 1.4.0+ 的原生 MCP 和 npm。
+需要周期任务、重复流程或 DAG 时，安装接入包 `task-conductor-plugin`。它不是服务包 `task-conductor`，也不是启用 pbot 的前提。该接入方式需要 Pi 1.4.0+ 的原生 MCP 和 npm。
 
-先用 `pi list` 检查是否已经安装；已安装但技能不可见时，检查资源是否启用并重载，不要重复安装。新安装请审阅[官方接入说明](https://github.com/realqiyan/agent-task/blob/master/docs/host-integrations.md)，从工作区根目录执行：
+先用 `pi list` 检查是否已经安装；已安装但技能不可见时，检查资源是否启用并重载，不要重复安装。新安装请审阅[官方接入说明](https://github.com/realqiyan/task-conductor/blob/master/docs/host-integrations.md)，从工作区根目录执行：
 
 ```bash
-pi install --local npm:@realqiyan/agent-task-plugin
+pi install --local npm:task-conductor-plugin
 ```
 
-然后在 Pi 中执行 `/reload`，再调用 `/skill:using-agent-task`。插件自带技能会在你确认后引导服务安装、`agent-task setup` 和原生 MCP 接入；插件安装本身不安装服务。凭据留在自己的终端或私有文件中，不发到聊天里。
+然后在 Pi 中执行 `/reload`，再调用 `/skill:using-task-conductor`。插件自带技能会在你确认后引导服务安装、`task-conductor setup` 和原生 MCP 接入；插件安装本身不安装服务。凭据留在自己的终端或私有文件中，不发到聊天里。
+
+已有旧版接入包时，先用 `pi list` 核对来源和作用域，审阅官方升级说明后显式移除旧包声明，再安装新包，不同时加载两份。接入包与服务分别更新；服务升级前核对活动任务、停服并备份，按上游说明处理原生 MCP 连接，不自动迁移配置或删除历史数据。
 
 `--local` 只限定插件的加载范围，不隔离服务数据；MCP 注册范围另行选择，保留已有连接，不重复注册。连接完成后用 `/mcp` 或 `pi mcp list` 检查实际工具，并按技能执行只读验证，不为安装验收创建模型任务。连接成功不证明模型认证或业务交付成功。
 
@@ -63,7 +65,7 @@ pi install --local npm:@realqiyan/agent-task-plugin
 - **原生工具**：CLI 通过 Bash 使用原生命令与当前 help，手册只保留当前使用所需的信息和证据引用；MCP 默认只接入当前项目，从工作区根目录执行 `pi mcp add --local <server> ...`，保存到 `.pi/mcp.json`，通过 `/mcp` 核对配置来源。只有明确要求跨项目使用时才修改用户级配置。不需要 Personal Bot 注册、参数绑定或权限表。方法见[接入技能](resources/skills/provider-connections/SKILL.md)。
 - **研究与分析**：可要求“综合这些资料并说明证据冲突”“核验这份分析的口径与计算”或“找出先要验证的关键假设”。助手按需使用[研究证据技能](resources/skills/research-evidence/SKILL.md)和[分析核验技能](resources/skills/analysis-validation/SKILL.md)，依据本次用途判断结论与限制。
 - **独立子会话**：包内提供 tmux 与独立 Pi 会话，需系统安装 tmux。`pbot_agent start` 立即返回；完成后自动通知。支持模型/目录/文件/工具与资源选项、send、follow-up、rename、status、read、stop 和显式 resume，没有前后台参数或 wait。`/pbot agents` 展示正在工作的 agent，可进入子 TUI。主 reload 保持运行，退出或切换会话停止并保留历史。子会话也使用原生 CLI/MCP，按委派范围工作。详见[专家协作](docs/agent-collaboration.md)。
-- **周期与持久任务**：主会话通过原生 MCP 直接使用可选的 Agent Task，处理周期、重复流程和 DAG；使用其 `using-agent-task` 技能与实际工具契约。安装与接入见[可选安装引导](#可选安装-agent-task)。缺失不影响普通 pbot 功能，但不能执行调度。pbot 不新增调度或转发层。外部任务与子会话分别查询和停止，取消本轮不等于停止未来周期，关闭 Pi 也不代表外部任务已停止。
+- **周期与持久任务**：主会话通过原生 MCP 直接使用可选的 Task Conductor，处理周期、重复流程和 DAG；使用其 `using-task-conductor` 技能与实际工具契约。安装与接入见[可选安装引导](#可选安装-task-conductor)。缺失不影响普通 pbot 功能，但不能执行调度。pbot 不新增调度或转发层。外部任务与子会话分别查询和停止，取消本轮不等于停止未来周期，关闭 Pi 也不代表外部任务已停止。
 - **Python 环境**：所有工作区共用当前用户的独立 venv。Personal Bot 加载后自动创建环境或安装锁定依赖，成功后在当前 Pi 进程激活；主会话与专家通过 Bash 使用 `python` 或 `python3`。环境异常时提醒，修复后用 `/pbot python setup` 重试。系统 Python、外部终端、已有脚本和历史结果不变。共享依赖更新会影响其他工作区；更换插件版本或手工重试前应停止相关脚本。详见 [Python 说明](python/README.md)与[计算参考](resources/references/compute.md)。
 - **资料维护**：可要求“整理当前项目资料”“按上次口径重做报告”或“检查交付并结项”。助手按[项目整理与维护技能](resources/skills/project-maintenance/SKILL.md)更新当前任务及实际受影响的资料；整体整理按用户指定范围进行。当前说明按主题合并更新，保留结论、条件和任务定义；历史证据与重要决策保持可追溯。整理或结项时归集成果并清理范围内无用的临时产物，保留正式资料、历史记录与备份。
 
@@ -86,7 +88,7 @@ Personal Bot 不在工作区内保存私有启用状态。Pi 配置仍由 Pi 管
 
 ## 更新与历史数据
 
-当前版本为 **0.1.0**。不维护工作区格式、初始化状态或升级机制。插件更新使用 Pi 原生包管理；本地安装则更新来源源码，依赖变化后执行 `npm ci --ignore-scripts`，再重载或重启 Pi。更换版本前先停止活动子会话；不同兼容线的子会话不能直接恢复。
+当前版本为 **0.1.1**。不维护工作区格式、初始化状态或升级机制。插件更新使用 Pi 原生包管理；本地安装则更新来源源码，依赖变化后执行 `npm ci --ignore-scripts`，再重载或重启 Pi。更换版本前先停止活动子会话；不同兼容线的子会话不能直接恢复。
 
 子会话数据保存在当前 Pi agent dir 的 `pbot/subagents/`；共享 Python 环境使用用户级 `pbot/python/.venv`，具体系统路径见 [Python 说明](python/README.md)。不自动导入其他应用的会话、配置或环境，也不修改其数据。MCP 连接与 CLI 环境按原生方式显式配置；用户资料、历史证据和备份原样保留。
 
@@ -95,7 +97,7 @@ Personal Bot 不在工作区内保存私有启用状态。Pi 配置仍由 Pi 管
 - Personal Bot 不提供逐工具权限或统一审批。CLI、MCP、Bash、Python 和扩展拥有其实际账户与凭据权限，不是沙箱。需要硬限制时使用只读凭据、服务端控制或受限环境。
 - 工具可用不等于用户授权。研究、接入与验证不授权交易、转账或账本修改。
 - 协议成功不证明业务完成。取消、超时和会话恢复不撤销外部副作用；可能已发送的操作先核对原生状态，不自动重发。
-- Agent Task 节点不自动继承主会话的工具、环境和技能。用户未授权或原生服务要求人工确认的业务，不安排无人值守执行。
+- Task Conductor 节点不自动继承主会话的工具、环境和技能。用户未授权或原生服务要求人工确认的业务，不安排无人值守执行。
 
 完整边界见[原生工具与执行边界](docs/capability-design.md)。真实模型、外部服务和完整 TUI/RPC 交互仍需获准环境验收，本地测试不证明实盘可用。
 

package/docs/capability-design.md

@@ -30,13 +30,13 @@ Bash、Python、MCP 和扩展拥有其实际账户与凭据权限。文件确认
 
 工具保留原生结果与错误格式，任务按需保存证据。业务完成需核对实际结果，不能只看退出码或协议成功。取消、超时和断连后，先查询原生状态与业务标识，再决定后续操作；聊天或子会话恢复不自动重发可能已执行的操作。
 
-## 可选 Agent Task
+## 可选 Task Conductor
 
-Agent Task 通过原生 MCP 提供周期任务、重复流程和 DAG，独立管理任务定义与运行状态。安装入口见[项目 README](../README.md#可选安装-agent-task)，具体操作由其 using-agent-task 技能和实际工具契约说明。
+Task Conductor 通过原生 MCP 提供周期任务、重复流程和 DAG，独立管理任务定义与运行状态。安装入口见[项目 README](../README.md#可选安装-task-conductor)，具体操作由其 using-task-conductor 技能和实际工具契约说明。
 
-提交任务时明确输入、cwd、工具与认证前提、输出和完成条件；周期任务还需明确频率、时区、授权范围及每轮数据时点。项目资料保存必要的 taskId、runId、节点 ID 和证据，实时状态向 Agent Task 查询。
+提交任务时明确输入、cwd、工具与认证前提、输出和完成条件；周期任务还需明确频率、时区、授权范围及每轮数据时点。项目资料保存必要的 taskId、runId、节点 ID 和证据，实时状态向 Task Conductor 查询。
 
-pbot 子会话绑定父会话，Agent Task 可在 Pi 关闭后继续。两者分别查询和停止；取消当前 run 与停止未来周期也是两个操作。
+pbot 子会话绑定父会话，Task Conductor 可在 Pi 关闭后继续。两者分别查询和停止；取消当前 run 与停止未来周期也是两个操作。
 
 外部节点需单独配置工具、技能、Python 环境和认证，不自动继承主会话能力。需要人工确认的业务不安排无人值守执行。提交结果不明时先按原标识查询，避免重复创建。
 

package/docs/technical-design.md

@@ -73,7 +73,7 @@ WorkspaceInstance 在当前进程激活 PATH、VIRTUAL_ENV 和 Python 路径变
 
 ## 工具与分发
 
-工具提供 outputSchema，由 Pi 纳入 pbot namespace；codemode 按工具契约组合调用。原生 CLI/MCP 与可选 Agent Task 的接入和授权见[工具与执行](capability-design.md)。
+工具提供 outputSchema，由 Pi 纳入 pbot namespace；codemode 按工具契约组合调用。原生 CLI/MCP 与可选 Task Conductor 的接入和授权见[工具与执行](capability-design.md)。
 
 包以 TypeScript 源码分发，由 Pi 加载；dist 仅供测试导入。发布版本以 package.json 为准，包内组件共用该版本。子会话兼容线在 1.0 前按次版本、1.0 起按主版本判断，跨线会话不能直接恢复。
 

package/docs/validation.md

@@ -29,7 +29,7 @@ Node 测试不下载第三方 Python 依赖；原生库集成验证见 [Python
 | 范围 | 验收重点 |
 | --- | --- |
 | 真实模型与专家 | 委派交付、运行中 steer/follow-up、独立复核、通知推进和实际用量 |
-| Agent Task | 实际多节点产物、至少两轮周期任务、Pi 关闭或重载后的查询与防重复提交 |
+| Task Conductor | 实际多节点产物、至少两轮周期任务、Pi 关闭或重载后的查询与防重复提交 |
 | CLI/MCP | 认证、发现、重连、动态工具、取消与业务结果 |
 | TUI/RPC | 人工 attach、焦点、批准、查看器、长时间运行和会话导航 |
 | npm 分发 | 全新依赖安装、Pi 安装加载、OIDC 发布与公开 registry |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "personal-bot",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/realqiyan/personal-bot.git"

package/resources/agents/coordinator.md

@@ -6,7 +6,7 @@
 
 - 普通问答和不需要独立上下文的工作直接完成。
 - 独立协助或核验使用 pbot_agent。委派提供目标、交付要求、资料依据和约束，不依赖专家知道父会话历史。
-- 周期、重复流程、DAG 或需在当前 Pi 退出后继续的任务，先读包内 `references/agent-task.md`，再按 using-agent-task 技能使用原生任务能力。缺少该能力只阻塞依赖它的部分。
+- 周期、重复流程、DAG 或需在当前 Pi 退出后继续的任务，先读包内 `references/task-conductor.md`，再按 using-task-conductor 技能使用原生任务能力。缺少该能力只阻塞依赖它的部分。
 
 ## 委派与验收
 

package/resources/references/{agent-task.md → task-conductor.md}

@@ -1,18 +1,18 @@
-# 原生 Agent Task
+# 原生 Task Conductor
 
 主会话需要周期、重复流程、DAG 或离开当前 Pi 后继续执行时使用本文。普通独立协助使用 pbot_agent。
 
 ## 准备能力
 
-先通过 Pi 原生工具发现查找 Agent Task，并加载 using-agent-task 技能，以实际 MCP schema 为准。工具未直接显示不等于未安装；技能可用时，按技能处理连接或排障。
+先通过 Pi 原生工具发现查找 Task Conductor，并加载 using-task-conductor 技能，以实际 MCP schema 为准。工具未直接显示不等于未安装；技能可用时，按技能处理连接或排障。
 
-技能缺失时，用 `pi list` 检查插件及资源启用状态。确未安装则说明需要 Pi 1.4.0+，经用户同意后使用工作区安装命令：
+技能缺失时，用 `pi list` 检查插件及资源启用状态。已有旧版接入包时，先审阅官方升级说明，确认来源和作用域后显式替换旧包声明，不同时加载两份；服务更新与 MCP 配置另行核对，保留任务历史。确未安装则说明需要 Pi 1.4.0+，经用户同意后使用工作区安装命令：
 
 ```bash
-pi install --local npm:@realqiyan/agent-task-plugin
+pi install --local npm:task-conductor-plugin
 ```
 
-重载后通过 `/skill:using-agent-task` 处理服务安装、setup 与原生 MCP 接入。复用已有原生连接，不在聊天中索取凭据值。插件可见不证明服务已连接，执行器 ready 不证明模型认证和执行成功。
+重载后通过 `/skill:using-task-conductor` 处理服务安装、setup 与原生 MCP 接入。复用已有原生连接，不在聊天中索取凭据值。插件可见不证明服务已连接，执行器 ready 不证明模型认证和执行成功。
 
 能力不可用时说明依赖它的工作受阻，继续其他已授权工作；不以循环等待或后台子会话替代持久调度。
 
@@ -26,6 +26,6 @@ pi install --local npm:@realqiyan/agent-task-plugin
 
 ## 核对与保存
 
-任务定义、执行和节点分别用 taskId、runId 和节点 ID 标识。提交响应不明时先查原标识，不换标识重复创建。实时状态查询 Agent Task；项目资料只保存必要定义、标识和有时点的结果依据。
+任务定义、执行和节点分别用 taskId、runId 和节点 ID 标识。提交响应不明时先查原标识，不换标识重复创建。实时状态查询 Task Conductor；项目资料只保存必要定义、标识和有时点的结果依据。
 
-取消当前执行与停止未来周期分别操作，并查询确认。pbot_agent stop 或 Pi 关闭不停止 Agent Task。报告已设置调度须有实际提交结果；报告本轮成功须核对本轮产物与完成条件。
+取消当前执行与停止未来周期分别操作，并查询确认。pbot_agent stop 或 Pi 关闭不停止 Task Conductor。报告已设置调度须有实际提交结果；报告本轮成功须核对本轮产物与完成条件。