Skip to content

认识 Story ​

Story 是 TaskHandoff 中组织长期工作的核心单元。一个 Story 可以集中保存相关文档、Codex/OpenCode 会话、预设动作和自动化计划,适合需求开发、故障调查、专题研究或持续维护。

Story 包含什么 ​

内容用途
文档保存需求、背景、计划、结论和交付记录
AI 会话汇总参与该目标的 Codex 与 OpenCode 会话
预设动作保存可重复使用的 Agent、实例、权限和提示词配置
自动化按间隔或指定时间运行预设动作

创建 Story ​

  1. 打开顶部导航中的“Story”。
  2. 选择“新建 Story”。
  3. 填写标题和可选说明。
  4. 选择所属节点。
  5. 设置最多保留的空闲 AI Session 数量并保存。

所属节点决定 Story 文件的保存位置,以及可以直接关联的实例和会话。创建前应选择长期可用的节点。

Story 列表中的所属节点筛选器
按所属节点筛选 Story,便于管理分布在不同节点上的工作。

关联 AI 会话 ​

可以在 Story 内新建会话,也可以加入所属节点上尚未分配的现有会话。新建会话时可选择 Codex 或 OpenCode、目标实例、工作目录、模型和权限模式。

Story 中同时显示当前会话和已关闭的历史会话。关闭 Story 的全部会话会停止其中仍在运行的工作,确认前应检查活跃任务。

Story 中关联的 AI 会话简洁视图
Story 将目标资料与关联的 Codex、OpenCode 会话放在同一工作区。

生命周期 ​

归档适合已经完成但仍需查阅的 Story。归档后应避免继续添加文档或自动化;需要再次工作时先恢复。

删除 Story 会同时删除它的文件目录,属于不可撤销操作。重要文档和结果应提前进入项目仓库或独立备份。

决策 ​

Story 里的 AI 可以提出需要人工确认的决策,决策会出现在 Story 工作区和顶栏“审批”中:

  • 待决策:等待选择,可以直接选给出的选项,也可以用“其他回复”自由输入;
  • 已决策:提交后会作为新的 turn 续接到对应的 AI 会话;
  • 已取消 / 已失效:不再处理,需要时可以重新发起。

决策只在节点支持时可用;节点版本过旧或对应会话已经结束时不能提交,可以在决策卡片里打开 AI 会话查看上下文。

继续阅读 ​