镜像自 HugoXK/LaunchPad@5cfa983 · upstream · 在 GitHub 上编辑 docs/management-agent.md ↗
统一管理服务与管理助手
顶部「管理助手」进入整页管理助手(#/management),刷新或分享地址仍打开该页;从项目页点击时选中该项目。项目设置里的「管理助手」仍在当前页面唤起悬浮窗口并选中该项目。打开管理范围按「页内显式选择(项目页带来的项目,或本页下拉里选的项目/组织)> 顶部项目切换器所选项目 > 全部有权项目」决定,全部项目 即全部有权项目;浏览器里以前存下的管理范围不再决定打开范围,页内临时选择标注为覆盖、只在本次打开期间有效。窗口顶部始终显示管理范围及其来源,支持全部有权项目、组织和单项目作用域。整页与悬浮窗口共用会话、输入草稿及正在运行的请求,切换展示方式不会重新发送消息。离开整页时助手收回入口,再唤起可继续对话;悬浮状态切页不改范围,收起后有新回复时入口会提示。手机(767px 及以下)没有悬浮入口:底栏「助手」就是唯一入口,收起后焦点回到它,处理中与未读状态也显示在它上面,打开的仍是同一个助手实例与同一条会话。退出登录会移除窗口并清理本次草稿。旧的项目 /management 链接仍在项目旁唤起窗口。
悬浮窗口左上角可拖动调节宽高,也可聚焦该手柄后用方向键微调;大小记在当前用户的浏览器里,并随视口限制在可见范围内。「全屏」覆盖整个可见区域,「退出全屏」或 Escape 恢复原来的展示方式和悬浮尺寸;悬浮时再按 Escape 收起。整页中的「悬浮窗口」返回此前页面并继续同一会话;直接打开或刷新整页后,默认返回项目列表。
窗口以连续对话为主,发送后立即显示处理状态与耗时。助手回答按实际模型流逐步显示,查询和修改操作以可展开的执行步骤呈现,区分进行中、已完成、失败和结果待确认;回执与请求参数可展开核对。中间说明与最终回答分别保留,停止或失败时保留已经收到的内容,服务重启中断也会明确标注。助手可以用 send_message 发送阶段消息(每轮最多 10 条,每并入一条新消息再多 1 条,见服务角色),它们以「进展消息 N」单独标注、按顺序显示在最终回答之前,不算执行步骤;从飞书私聊发起时同时发到私聊。工具进展只反映实际调用,不以模型文字推断操作成功。
回答支持 Markdown 标题、列表、代码块、引用、表格、任务清单和链接,并可复制原始 Markdown。渲染使用随服务提供的 Marked 与 DOMPurify,限制为文档标签,移除脚本、事件属性、危险协议及自动加载的图片;外部链接在新标签打开。新消息默认跟随底部,向上翻阅后暂停跟随,可用「回到最新消息」返回。断线时直接提供「重新连接」,只续读事件,不重发请求;处理中可以继续写下一条草稿。
「新建会话」位于顶部,「会话记录」可切换持久会话。「快捷操作」集中放置查询、Manager 章节表单、任务管理及定时计划,执行配置或任务命令后返回对话查看结果。Ctrl / ⌘ + Enter 发送,Escape 收起;收起和重新连接不会重复提交命令。
查询、显式表单和自然语言工具调用使用 ManagementService。「角色」页的 Manager 配置、项目策略、角色配置与 Task 操作也进入相同命令服务。ActorContext 由服务端的 resolveActor 创建;可信 IM 适配器可使用身份模块解析后的 actor,不能反序列化客户端 actor 或自行授予权限。
飞书个人私聊与控制台使用同一管理 Agent 和工具目录。问候和跨项目概览不要求选择项目,按真实查询结果使用项目名称,需要目标而存在歧义时自然追问。模型和用量属于服务角色「管理助手」(management-assistant),在「全局设置 → 服务角色」配置,不取账户可读的第一个项目,也不会改用项目的模型;管理助手没有配置模型时直接提示到控制台配置,详见 服务角色。当前授权下最近 20 轮用户请求与回答用于续接,每条较早的回答最多取 4000 字,整段历史超过 96 KiB 时从最早的一轮开始略去并注明略去轮数;写入前重新查询事实和版本。一轮回答不限步数,在模型不再调用工具、用户停止或授权被撤回时结束;助手可以在同一步里对多个项目各发一个查询,数量不设上限;调用了未提供的工具、参数不是 JSON 或不符合格式时,结果作为这次调用的观察交还模型改正,不让整轮对话失败;权限拒绝、版本冲突等其他失败仍结束本轮,并按原因显示。工具结果的预算和省略规则见 Agent 运行时。在飞书私聊里建的任务,完成、提交 PR、失败或取消时结果发回这个私聊;控制台里建的任务不发,见 消息渠道。飞书群聊由绑定到群的服务角色回答,权限和项目范围在控制台为每个群单独设置,见 消息渠道。飞书应用机器人已接入相同服务,安装、双端身份证明、群范围和渠道回执的使用方式见 消息渠道与飞书应用机器人。
查询与命令契约
POST /api/management/query 接受 { operation, target, arguments }。目录与 JSON Schema 见 src/management/catalog.ts;get_capabilities 返回当前作用域和可用注册项。分页使用 offset、limit,Task run、事件与角色记录中的 offset 对应返回的 next_after。
查询包括 list_projects、list_tasks、get_task、get_effective_config、get_usage、list_audit、search_knowledge。get_task 可选 detail、logs、runs、events、roles 或 source。日志与原始证据保留来源引用,原始来源展开额外要求 knowledge.read;知识记录不能从 trace 前缀绕过 ACL。读取只使用现有 Task、run、日志和模型用量表,不创建业务任务。
POST /api/management/commands 的必填字段:
| 字段 | 含义 |
|---|---|
operation |
目录中的确定性业务操作 |
target |
project_id,以及适用的 task_id;workflow.update 的 workflow_id 是工作类型 id |
arguments |
此操作的闭合 Schema 业务参数 |
expected_revision |
最近一次查询返回的版本摘要 |
idempotency_key |
操作者范围内唯一的请求标识 |
source_conversation / source_message |
原始会话与消息引用 |
命令包括 project.update、manager.update(Manager 提示词、工作类型的开关和写入、事件开关)、workflow.update(兼容旧名称:改一个工作类型的章节、开关或写入)、roles.update、task.create、task.pause、task.cancel、task.retry、task.instructions、task.contract、task.adopt-config 和扩展注册入口。模型只有 query / command 工具,以及管理助手自己的独立任务工具(start_own_task、continue_own_task、list_own_tasks,见服务角色),不能指定 actor、tenant、capabilities、SQL、后台地址或控制面 shell。模型调用的来源和幂等键由会话服务生成。
命令回执包含操作者、渠道、目标、参数、修改前后版本、状态和结果。GET /api/management/commands/:id 回读;重复键和相同参数返回原回执,参数变化返回 idempotency_conflict。版本冲突返回 management_revision_conflict,客户端必须重读并重新形成修改,不能覆盖新配置。配置回执提供 diff 和重新绑定当前版本后可提交的回滚参数。
实际执行重新检查账号、授权 revision、项目状态、安装范围、凭据。待执行期间安装、执行账号或组织策略变化会停止原命令。金额只做用量统计,不拦截管理命令、任务或对话;已知费用按币种展示,未计价请求单独计数。
提示词的三种含义
Manager 或角色默认行为只影响之后的分派和新建任务。可用的模型选择、工作类型的写入和 RoleDefinitionV2 配置在任务创建时保存,首次读取的规则/Skill 也固定在 task_execution_configs 与既有 run 快照中。模型凭据密封保存,不进入公开快照;凭据撤销、权限、停用、资源上限和模型版本仍实时检查。
当前任务补充指令用 task.instructions 追加历史,后续步骤读取,不改写旧 run、目标或验收条件。改变正在使用的执行配置时先 task.pause,等待旧执行释放检查点,再 task.adopt-config;同一 task /角色实例采用新配置 revision,保留旧 run 引用,清除旧候选和验收。新配置 revision 也参与候选身份计算,旧验收不能匹配新候选。
RoleDefinitionV2 的显式角色 apply 仍在安全检查点结束旧 run,并在同一实例上以新 snapshot_id、config_revision 和 role_revision 续接;后续默认设置变更不会覆盖该实例已显式采用的版本。Pi prepare、环境释放和实时角色权限检查保持在原角色执行路径中。
改变目标、范围或验收条件必须显式 task.contract,增加 contract revision 并清除旧候选和验收;已经发布成果的合同禁止原地修改。task.create 必须有目标、范围、验收条件和交付终点,进入普通 Task 调度、统一交付和独立 QA。
生效来源与配置 PR
get_effective_config 返回每条规则的来源(builtin 内置文本或 console Manager 章节;只有仓库 skill 为 repository)和版本。.bot/ 文件不再读取(#935),workflow.update 和 manager.update 保存后即对之后的新任务生效,回执为 effect: future_tasks、effective: true。
configuration.pr 只允许仓库 skill 路径(.agents/skills/<名称>/SKILL.md;.bot/ 文件不再读取),行为规则用 manager.update、roles.update 和 project.update 的标签字段修改;它使用已有 GitHub App installation token,不接受个人写 Token。必须先刷新默认分支规则来源;默认分支变化后要求重新读取。创建 PR 返回 pending_merge 和链接,合入并刷新来源之前不宣称生效。分支和 PR 使用持久命令 ID 对账;任何未知外部响应都进入 unknown,POST /api/management/commands/:id/resume 先查原 PR,未查到仍保留未知状态,绝不盲目重复创建。
会话、停止和执行
/api/management/conversations 创建与列出本人会话,scope 为 platform、tenant:<tenant id> 或 project:<project id>,其中 platform 仅表示全部当前有权项目:会话若已选定组织或项目,就是该范围内有权的项目,而不是拒绝(403)。项目管理员可以在自己已启动的项目上使用管理助手;还没有已启动项目时创建会话会得到 403 scope_forbidden,界面应说明原因并给出重试,而不是一直转圈。会话由 principal、tenant 和 scope 隔离;授权修订后隐藏旧权限下的消息,范围撤回后旧会话不可访问。
POST /conversations/:id/messages 接受一个自然语言 content、结构化 query 或 command,以及唯一 source_message。消息先持久化再运行,重复消息不会再次执行。GET /conversations/:id/events?after=<sequence>&stream=1 输出 NDJSON;重连只读事件。阶段消息是 message 事件,数据为 {text,sequence,remaining};最终回答仍是 reply 事件。POST /conversations/:id/messages/:message/stop 停止后续模型/工具调用,已提交命令保留回执。重启将未完成消息标记为 interrupted,不能自动重放外部写入。
授权范围内的命令直接执行,没有审批或人工确认步骤:一个人或一个群能做什么,都在控制台的授权、角色权限和群绑定的权限档位里配置好。旧版本的组织审批策略 management_policies.approval_operations 不再读取;升级时仍在等待审批的命令标记为失败(approval_retired),不会执行,需要时重新发起。以前的审批记录和“已拒绝”回执保留可查。日志、引用文本和模型回复都不能授权操作。
管理会话有新内容时才显示「回到最新消息」。阅读旧记录、选中回复文字或在输入框起草下一条消息时,新内容不会把记录区自动滚到底;明确点击该按钮后才回到最新位置。正在选中的回答暂缓 Markdown 重绘,避免流式回复替换节点后丢失选区;取消选区后补齐内容并保留阅读位置。停止生成、收起窗口和取消已提交业务操作仍按各自的原语义处理。
仓库接入向导
接入向导(#929)让仓库的管理员在项目启动之前,先和管理助手谈清楚 bot 在这个仓库能做什么、该怎样配置。对话只读:不写 GitHub,不启动项目,不用项目电脑,也不改任何设置;管理员在接入页确认方案之后,控制面才按方案逐项应用(见下文「确认与应用」)。
接入页(#934):控制台地址 #/onboarding/<仓库 id>。左边是对话(流式回复、阶段消息、停止),右边是仓库画像、问题和方案三段,手机上用标签切换;页面只显示上面这些接口读回的状态,所以刷新或换设备都回到同一步。入口是项目列表「待接入的仓库」和身份页待接入仓库旁的「开始接入」、超级管理员安装列表里未启动仓库的「开始接入」,以及已启动项目「基本设置」里的「重新运行接入向导」。用法见接入指南。
谁能打开:已启动的项目,要求项目管理员权限(config.write,含委派);已安装但没有启动的仓库,要求 GitHub 认定的仓库管理员或组织所有者(与 #848 自己启动的条件相同),或者超级管理员。仓库必须在本部署某个 GitHub App 安装之下。其他人(例如只有 Write 的协作者)得到 403 repository_admin_required。控制台会话限定了组织或项目时,只能打开其中的仓库。
会话:POST /api/management/onboarding/<仓库 id> 打开这个仓库的向导会话,已有进行中的会话就返回它;GET 读取页面状态;POST .../close 结束会话,之后再打开会新建一个。一个仓库同时只有一个进行中的会话,它属于仓库而不属于个人:每位管理员打开的都是同一个会话,都能读到全部消息(会话里只有这个仓库的事实),它不出现在个人的管理会话列表里,也不能经 /api/management/conversations 以 onboarding: 范围新建。对话、流式事件和停止都沿用上面的会话接口;向导里只接受自然语言消息,不接受直接的 query 或 command(onboarding_content_required),并且同一时间只跑一轮(onboarding_turn_running),会话结束后再发消息得到 onboarding_session_closed。
读取:管理助手只能读这一个仓库,工具是 github_read、github_search、read_job_log。每轮按需为这个仓库签发安装令牌,权限只有 Metadata、Contents、Issues、Pull requests、Actions、Checks、Statuses 的读,本轮结束即撤销;令牌只在控制面里使用,不进入模型请求、事件和日志。系统提示词是 docs/prompts/onboarding.md 的原文,加上超级管理员给管理助手写的补充说明。已启动的项目还会带上它当前的能力上限、事件开关、测试命令和检视语言,供重新运行时只提出差异。
两个工具:
ask_onboarding_questions:一次至多 5 个问题,每题 2~5 个选项,带推荐答案(必须是其中一个选项)和理由。最新一组问题保存在会话里,页面据此显示;人可以选、可以改,也可以直接用自然语言回答。propose_onboarding_plan:提交结构化方案,控制面校验后保存为新一版草稿(按仓库递增版本),不应用。方案项只对应现有设置:能力档capability_ceiling、交给 Manager 的事件events(与 Manager 的事件开关同一套键和校验,含actions.run_failed)、test_command(启动后才验证)、review_language、要新建或沿用的标签labels(名称、颜色、说明;不能用保留标签agent/*、pr/*、gate/*、blocker、priority/critical,不能重名)、写进角色提示词的约定conventions(标签用法、检视重点、"简单问题"的界定)、CI 建议ci(文字和要改的文件)、定时巡检schedules(名称、五段 cron、时区、检查内容)和飞书群建议feishu(档位与理由),另有仓库画像摘要profile(含读过的来源)。不合法时工具结果给出error和出错的field(以及原因),交还模型改正,不让整轮失败。
模型与用量:仓库所属组织受信任(#848)且设了默认模型、该模型仍是共享模型时用它,否则用管理助手自己的共享模型;都没有时这一轮失败并提示请超级管理员先配置,不会改用其他模型(也不用项目自己的模型),页面在发送之前就能从 model.available 看到。启动前后用同一个模型:项目只承担用量,所以共享模型即使只限定给其他项目,也照样运行已启动项目的向导。用量记在管理助手名下,并记在这个仓库上:已启动的项目直接计入项目用量;项目还没启动时,模型请求按会话保存(model_requests.repository_id 外键指向已启动的项目,这时还没有这一行),启动项目的同一事务里改记到该项目,之后在项目用量里可见。页面状态里的 usage 是本次会话的请求数、令牌和费用。
确认与应用
整份方案一次确认(#932),可以去掉其中几项;确认后控制面按固定顺序逐项应用,每项都走人自己会用的现有通道,以确认人的身份执行,权限照常检查,不借用任何别人的权限。
确认什么:页面状态的 plan.changes 是这份方案与项目现状的差异,每项带 item、生效位置 where、现值 current 和方案值 proposed,按应用顺序排列:启动 start(仓库还没启动时)、能力上限 capability_ceiling、Manager 的事件开关 events、test_command、review_language、约定 conventions、要新建的标签 labels、Manager 定时检查 schedules、CI 建议 ci。已经和方案一样的项不列出:已启动的项目重新运行时只剩差异,没有差异时为空,接入页据此说明"无需改动";以前的确认已经建过或找到的标签、同一条 CI 建议建过的任务、同名的 Manager 定时检查、正文已在提示词里的约定都算已经一样。方案生成之后有人改过设置,差异里看到的就是改后的现值,由确认的人决定是否覆盖。约定只认接入向导段落(「本仓库约定(接入向导第 N 版…」标题下)里的内容,提示词别处出现同样的字不算。启动一项还写明仓库是否属于受信任组织;属于时带 organization_capability_ceiling,即自己启动时用的组织能力档。飞书群建议不是应用项,留给完成页给出绑定入口。plan.changes_revision 标识这份差异。
确认:POST /api/management/onboarding/<仓库 id>/confirm,请求体 {version, changes_revision, items, schedule_destination_id?}。version 必须是这个仓库最新一版方案(否则 409 onboarding_plan_outdated),changes_revision 必须与当前差异一致(否则 409 onboarding_changes_outdated,重新读取后再确认),items 是差异里要应用的项(不在差异里或为空返回 400 invalid_onboarding_items,没有差异返回 409 onboarding_nothing_to_apply);仓库还没启动时 start 必须在内(400 onboarding_start_required)。确认记录确认人、时间和方案版本,方案本身不再改动,要改就让管理助手出新一版。同一版方案只能确认一次,再次确认直接返回已有的结果,不会重复应用。页面状态的 application 是这个仓库最近一次确认和它的回执。
每项怎么应用:
start:超级管理员按方案的能力上限和部署默认共享模型(onboarding.model)启动;仓库属于受信任组织(#848)时,它的管理员按组织默认值自己启动,随后的capability_ceiling项再把能力上限调到方案值,和启动后在项目设置里调整一样;其他人确认时由控制面提交启动申请(见下文「申请启动与审批」),这一项保持pending(start_approval_pending,detail.request_id是申请),等超级管理员决定。启动之前其余各项保持pending(project_not_started),启动成功后接着应用。capability_ceiling、test_command、review_language:管理命令project.update。测试命令不在这里运行,回执标明verified: false,由首个任务或 CI 任务验证。events:管理命令manager.update的events,与「监听与触发」同一套校验。conventions:以「本仓库约定(接入向导第 N 版,日期)」为标题的独立段落,追加到 Manager 提示词(项目保存过完整的分派提示词时追加到它末尾,否则追加到 Manager 提示词的前言,分派提示词以前言开头),并追加到每个启用的角色(跨任务的 coordinator 除外)的角色提示词(manager.update、roles.update),不覆盖已有内容,也不写.bot/文件;仓库的.bot/文件不再读取(#935),这两处就是生效的规则。已经带有这一版段落的提示词不再追加。labels:先读仓库现有标签;不存在的经github_write POST /labels新建(只放行这条路由,项目能力上限至少要comment),已经存在的同名标签不改颜色和说明,记为exists。写入按标签名记账,重试不会重复创建。schedules:Manager 定时检查(#851)是项目计划,用项目服务身份运行;项目还没有服务身份时,这一项以确认人的委托创建(只拿确认人自己在项目里的能力,失去时随之失效);差异里这一项的service_principal为delegated时接入页在确认前写明这一点,已有服务身份时为existing。计划需要通知目的地:确认或重试时带schedule_destination_id;没带时这一项失败(schedule_destination_required),回执的detail.destinations列出可选的目的地。已有同名的 Manager 定时检查不再创建。ci:管理命令task.create建一个普通开发任务,合同就是这条建议(目标、要改的文件、经 bot PR 交付由人合并),并带workflow_changes:确认 CI 一项就是人在控制台确认这项任务可以修改.github/workflows/(#931),所以这些命令的来源是console:onboarding:<仓库 id>;项目能力上限不到develop时这一项失败并写明原因。同一份确认里已经建成的任务(例如建成之后控制面重启、回执没来得及写)在重试时直接沿用,不会再建一个。
回执:每项一条,状态为 succeeded、exists(已经和方案一样)、failed(带 error,必要时带 detail)或 skipped(确认时去掉了),并记录执行人、尝试次数和管理命令回执 id;审计记录确认(onboarding.confirmed)和每项结果(onboarding.item.<状态>)。某项失败不影响后面的项。POST /api/management/onboarding/<仓库 id>/items/<项>/retry(可带 schedule_destination_id)只重试一项失败的项(其他状态返回 409 onboarding_item_not_failed),以新的幂等键执行;重试启动成功后接着应用等待它的项。控制面在应用途中重启时,正在应用的项记为失败(onboarding_item_interrupted),可以重试。同一个仓库同一时间只应用一份确认(在这个控制面进程里按仓库加锁):正在应用时再确认或重试都返回 409 onboarding_apply_running,回执保持原状,稍后再试。
申请启动与审批
仓库所属组织不受信任时(#848),它的管理员不能自己启动项目(#933)。他确认方案时控制面为这个仓库提交一份启动申请,记录申请人、时间和这次确认(方案版本);同一仓库同时只有一份待处理的申请,再次确认或重试启动都沿用它(新的确认接替旧的)。受信任组织的仓库没有这一步。
通知:每位超级管理员在控制台「待处理」页顶部的启动申请里看到它(在那里同意或拒绝),在自己与 bot 的飞书私聊里收到一条通知(仓库、能力档、要建的标签、定时检查、是否有 CI 建议和仓库画像摘要);决定之后申请人在飞书私聊里收到结果。私聊消息经持久的消息发件箱发送,只走仓库所属组织的飞书应用或平台自己的应用,不经别的组织的应用;发送前再次核对收件人仍是这个私聊的主人,超级管理员的通知还要求收件人仍是超级管理员。没有绑定私聊的人只在控制台看到。部署配置了控制台公网地址时,通知末尾带处理链接:超级管理员的指向「待处理」,申请人的指向这个仓库的接入页。
在飞书私聊里处理:超级管理员直接回复通知即可,「同意」启动,「拒绝」要写原因。有待处理的申请时,超级管理员与管理助手的每一轮对话(飞书私聊和控制台都是)带上这些申请(pending_start_requests,与下面的列表接口同一形状)和工具 start_requests:list 重新读取,approve {request_id, capability_ceiling?, model_id?, trust_organization?} 和 reject {request_id, reason} 与下面的同意、拒绝接口是同一套处理,权限、记录和通知申请人都一样。助手只在超级管理员明确同意或拒绝时调用;同时有几份申请而没说是哪一份时先追问;拒绝没写原因时,工具返回 rejection_reason_required,由助手追问原因。还没有任何项目时,有申请待处理的超级管理员照常进入对话,不会只收到「没有可访问的项目」。经组织自己的飞书应用(#424)聊天时,身份限于该组织,不是超级管理员,所以那里收到的通知只写到控制台「待处理」处理,助手也没有这个工具。
接口(超级管理员,否则 403 super_admin_required):GET /api/management/onboarding-requests?state=pending|approved|rejected|withdrawn|lapsed|all(默认 pending,最近 100 条)、GET /api/management/onboarding-requests/<id>,每条带仓库、申请人、方案版本和摘要、决定人、时间、原因和决定。
- 同意:
POST .../<id>/approve {model_id?, capability_ceiling?, trust_organization?}。超级管理员按自己选的模型和能力档启动项目(不填时用部署默认共享模型和方案的能力档;三档都在超级管理员的权限之内),可以顺带信任这个组织,此时按 #848 的语义把这次的共享模型和能力档作为组织默认,之后该组织的仓库由管理员自己启动。启动这一项记在超级管理员名下(detail.by为approval);超级管理员改了能力档时,方案的能力档一项记为skipped(decided_by_approval),不再改回方案值;其余各项以申请人的身份、按申请人自己当前的权限接着应用,失败的项由申请人在接入页重试。 - 拒绝:
POST .../<id>/reject {reason},必须写原因(400rejection_reason_required);启动一项失败(start_rejected,detail.reason),申请人收到原因,之后可以重试启动再次申请。 - 撤回:仓库的管理员
POST /api/management/onboarding/<仓库 id>/request/withdraw;启动一项失败(start_request_withdrawn)。 - 失效:仓库被移出安装、项目已经以别的方式启动,或者组织变成受信任组织时,待处理的申请失效(
lapsed),读取申请时检查,不需要后台任务;启动一项失败(start_request_lapsed,项目已启动时除外),组织受信任后重试启动就是自己启动。申请不按时间过期。
已经决定或失效的申请再处理返回 409 onboarding_request_closed。页面状态的 request 是这个仓库最近一份申请。
扩展与验证
ManagementService.register 为配置发布、知识修订、计划和通知提供可信 execute / reconcile 注册接口。knowledgeSearch 是受限检索接入点。计划和通知由 持久化调度模块 注册,表单和管理工具走同一服务;未注册的业务工作流处理器明确不支持。知识模块未注册时返回明确不可用。角色配置沿用 RoleDefinitionV2 接口与版本检查;Pi prepare、角色快照和显式 revision 续接与项目主控共用现有实现。
e2e/management-live.spec.mjs 通过真实模型 SSE 和管理事件流验证完成前渲染、工具进展、多轮文本、Markdown 安全边界、停止、失败、重连、滚动及历史回读。test/repository-onboarding.test.mjs 覆盖接入向导:未启动仓库的只读分析(只签发一次只读令牌并在本轮后撤销、令牌不进模型与事件、GitHub 没有写入、项目仍未启动)、非管理员的错误码、多人共用同一会话、问题与方案草稿的校验和保存、一次一轮、启动后用量转记到项目、已启动项目带当前设置,以及受信任组织的默认模型;test/repository-onboarding-apply.test.mjs 覆盖确认与应用:差异与确认的各种拒绝、各项经现有通道生效(能力上限、事件、测试命令、Manager 与角色提示词的约定段落、GitHub 新标签、开发任务带 workflow_changes)、已存在的标签不改、缺少目的地的定时检查单独失败并可重试、重复确认和重试不重复写入、重新运行只列差异,以及未启动仓库的启动顺序(需要审批、受信任组织自己启动后调到方案档位、超级管理员按方案档位启动);test/repository-onboarding-requests.test.mjs 覆盖启动申请:确认即申请、启动一项等待、超级管理员的列表和飞书私聊通知、非超级管理员不能查看和决定、撤回后重试再申请、拒绝必须写原因并通知申请人、同意时改能力档并信任组织、其余各项以申请人身份应用、移出安装后申请失效,以及超级管理员在飞书私聊里回复拒绝(带原因)和同意、申请人的私聊没有这一工具、经组织应用的通知只指向控制台。阶段消息(事件流、10 条上限、私聊送达)和不限步数由 test/channel-stage-messages.test.mjs 与 e2e/stage-messages.spec.mjs 覆盖。test/management.test.mjs 覆盖权限、并发、幂等、配置来源、直接执行(旧审批策略不再生效、遗留待审批命令不执行)、未知结果、停止和会话隔离;e2e/management.spec.mjs 使用独立 SQLite、随机监听端口和本地模型协议夹具验证真实持久化查询、配置修改、任务管理及浏览器/API 一致性。全部临时产物应放在工作树 .tmp/,运行测试时设置 TMPDIR 为该目录。