使用手册

从登录到关闭:在 Keel 里走完一次变更

本手册对应 Keel 桌面端界面(截图 1280×960)。内部人员使用工作台控制变更闭环;客户使用隔离的变更空间。AI 只提供草案,正式批准与签署由人完成。

目录

01

登录与角色

打开系统后进入登录页。演示环境密码统一为 keel-demo。开发模式可点击邮箱右侧箭头选择账号。

  • 内部账号(如需求分析师 林夏)进入工作台,可看到工程与商务细节。
  • 客户账号(如 马文博、孙怡)自动进入客户门户,看不到内部备注与成本底稿。
  • 审计账号只读,可导出证据包。
登录页
图 1 · 登录。点击截图可查看大图。
02

工作台首页

首页不展示泛化项目 KPI。四个队列分别指向待分诊信号、等待澄清、影响待确认、待决策简报。下方列出高风险在途变更,以及传播失败或客户异议。

  1. 从左侧导航进入各能力模块。
  2. 右上角可开启「客户预览」,检查客户将看到什么。
  3. 点击队列卡片或案例编号,进入对应处理页。
工作台首页
图 2 · 需要处理的变化。
03 · M1

变更雷达

把会议纪要、邮件或客户原话粘贴到收件箱。AI 给出分诊草案(变更 / 缺陷 / 咨询 / 补充 / 重复),不会自动立案。操作人选择:新建案例、合并到既有案例、转人工或忽略。原始文本永久保留。

变更雷达
图 3 · 信号收件箱。每张卡片含原文、AI 判断与一键动作。
04 · M2 / M3 / M4

变更案例与工作台

案例列表可按状态筛选。打开一条 Change Case 后:

  1. 核对顶部编号、状态、风险、范围判断与关闭门禁提示。
  2. 阅读灰色区域中的原始表达——不可覆盖。
  3. 修订 AI 草拟的当前状态 / 目标状态 / 原因 / 验收变化,保存为新版本。
  4. 在语义差异中逐项接受、修订或拒绝。
  5. 用页签处理影响、澄清、方案、决策、传播、验证与审计。
  6. 右侧 AI 工作区查看结论、证据与「重新分析」;客户预览时只显示业务摘要。
变更案例列表
图 4 · 变更案例列表。
变更工作台详情
图 5 · 工作台。澄清未完成时,关闭门禁会列出缺口。
05 · M5

影响实验室

跨案例复核影响候选。直接/间接影响来自追踪图;潜在遗漏来自语义召回。对每一项选择「纳入」「排除」或「调查」。不要只相信高置信度标签——展开证据路径。

影响实验室
图 6 · 按类型与处置筛选候选。
06 · M6

决策中心

待决策队列展示变更简报与推荐方案。CCB 可批准、附条件批准、拒绝或延期。工作量以 T-shirt 尺码表示。客户确认人在门户完成二次确认。AI 意见可被否决。

决策中心
图 7 · 待处理 Brief 与近期结论。
07 · M7

闭环监督

批准之后仍可能失真。本页检查传播、验证与关闭门禁:

  • 决策条件全部满足
  • 已确认影响项均有处置
  • 关键传播项同步成功
  • 必需测试或验收完成
  • 客户确认或记录豁免
  • 新基线已生成

未满足时,「关闭」会失败并提示原因。特权关闭仅限交付负责人 / CCB,并写入审计。

闭环监督
图 8 · 传播与验证状态,以及关闭门禁。
08 · M9

基线与追踪

查看当前基线中的需求、接口、数据、测试、合同对象,以及它们之间的追踪关系。覆盖率与孤立对象帮助判断冷启动是否足够。存疑链接表示变更后关系可能失效,需要人工确认。

基线与追踪
图 9 · 基线对象、覆盖率与存疑链接。
09 · M8 内部

客户空间(内部配置视图)

内部人员在此查看客户入口的品牌、访问方式和可见性规则,并打开客户门户做「以客户身份预览」。确认没有任何内部成本或技术细节泄漏。

客户空间设置
图 10 · 对客户可见的在途变更摘要。
10 · M8 客户

客户门户

客户登录后只看到业务语言:进行中的变更、需要确认的问题、范围与验收。没有「图遍历、候选召回」等术语。

  1. 在「提交变化」用自己的话描述,系统原样保留。
  2. 打开一条变更,核对自己当时说的、现在 / 希望变成,以及已授权的业务影响。
  3. 回答澄清问题;必要时留言或提出异议。
  4. 在供应商给出结论后,确认范围、周期与验收。
客户门户首页
图 11 · 客户门户首页。
客户查看变更详情
图 12 · 客户视角的变更详情与澄清。
客户提交变化
图 13 · 提交一项变化。不会自动变成正式变更。
11

分析与审计

北极星是证据化闭环的有效变更数。本页给出在途 / 已闭环 / 超范围识别,以及状态分布与最近审计事件。关闭后可从工作台导出包含原始诉求、分析、决策、传播、验证的证据包。

分析与审计
图 14 · 证据化闭环指标与审计事件。
12 · M10

设置与开放接口

查看编号规则、状态机和关闭门禁。生成 REST / MCP 密钥(Authorization: Bearer csk_…),配置 Webhook 回调。写入外部系统默认先生成草案。

  • REST:/api/v1 提供工作空间、信号、案例及嵌套资源。
  • MCP:/api/mcp 提供查询基线、提交信号、补充证据、列出缺口、创建传播草案;不开放批准与强制关闭。
工作空间设置
图 15 · 规则、模型、密钥与 Webhook。