SCENE 1 · 看板
看板 · 常态(已绑定 repo)
清理掉 phase 1 不做的 Template / Session 概念。task 卡片仅显示 title + labels + 父任务标识;右侧 task 详情仓库列表降级为只读。
未开始
2
数据库迁移脚本
用户认证系统
新建
进行中
3
实现登录 API
重构 API 网关 限流模块
前端登录页面
新建
已完成
2
埋点上报 SDK 升级
修复列表分页 bug
新建
Task 详情
实现登录 API
未开始
进行中
已完成
接入公司 SSO,支持邮箱 + Magic Link。需要考虑未注册用户的首次登录流程,以及 session 续期。
lark-agents/backend
lark-agents/frontend
lark-agents/shared
清理点:① 顶部 toolbar 去掉 Template / Session chip,仅保留标签 + 自由筛选 + 搜索;② 列表 tab 灰显,带 phase 2 角标;③ 卡片不显示 session row;④ Task 详情的"仓库"区是只读(visual 上保留 checkbox 状态来表达"当时选了哪些");⑤ 设置入口齿轮放左侧 rail 左下角;⑥ 标题右侧新增「...」 菜单触发点。
SCENE 2 · 看板
看板 · 未绑 repo · 顶部 hint
项目没挂任何 repo 时,顶部出现 hint 直达 Settings;hint 可关闭本次会话,刷新后如果仍未绑定 repo 会再次出现。
项目「Eyrie · Phase 1」尚未绑定任何 repo,新建 task 时不会关联代码仓库。
去 Settings 添加
未开始0
新建
进行中0
新建
已完成0
新建
触发条件:
project_repos 行数 = 0。可关闭:右侧 ✕ dismiss 本次会话;如果用户就想当无 repo 看板用,不应该被反复打扰。不持久化关闭:刷新后会再次出现(保留 actionable 入口)。SCENE 3 · Create Project
Create Project · 首次空态
首次启动应用时直接落在这里。picker 显示"未选择项目",下方完全替换为 Create Project 表单。无「取消」按钮(没有上一页可回)。
欢迎使用 Eyrie
先创建一个项目来组织你的 task。项目可以挂多个代码仓库,task 创建时从这些 repos 里挑选。
尚未添加任何仓库
允许创建无 repo 的项目;之后可在 Settings 里补
"整页"= 替换 .ob-layout 区:保留顶部 chrome + 左 rail + 底部 status bar,中间从看板 / toolbar 整体替换为 Create Project 表单。
首次空态特殊处理:picker 文字 = "未选择项目",picker 不可点;右下角隐藏「取消」按钮,因为没有可回的上一页。
首次空态特殊处理:picker 文字 = "未选择项目",picker 不可点;右下角隐藏「取消」按钮,因为没有可回的上一页。
SCENE 4 · Create Project
Create Project · 已有 + 新拖入 + 目录选择悬浮窗
表单允许混合两种来源的 repo 行。点「+ 拖入新目录」打开浅层悬浮窗,仅负责"选目录"这一步;选中后窗口关闭,回主表单解析元数据落行。
新建项目
项目可以挂多个代码仓库,task 创建时从这些 repos 里挑选。
lark-agents/backend
lark-agents/shared
ops-cli
选择目录
backendgit
frontendgit
sharedgit
scriptsgit
tmp
拖入目录或在上方选择 → 选中后窗口关闭,回到主表单
两个入口可来回切换、随意混合。每行右侧 hint 区分来源:
每行 repo name 不允许在这里改——repo name 是全局的,要改去 Settings → Repos。本表单只能改 project 自身的 name。
已注册 / 新注册 / 已注册的 repo(git_common_dir 命中已有 Repo → 静默复用)。每行 repo name 不允许在这里改——repo name 是全局的,要改去 Settings → Repos。本表单只能改 project 自身的 name。
SCENE 5 · Create Project
Create Project · 目录选择悬浮窗 · 拒绝 non-git
拖入 / 选择的目录不是 git 仓库时就近 inline 报错,不允许"选择此目录",让用户立刻换一个。
新建项目
项目可以挂多个代码仓库,task 创建时从这些 repos 里挑选。
lark-agents/backend
选择目录
backendgit
frontendgit
sharedgit
docsno-git
tmp
不是一个 git 仓库
~/code/lark-agents/docs 内没有 .git,phase 1 暂不支持非 git 目录。请换一个目录。
拖入目录或在上方选择 → 选中后窗口关闭,回到主表单
phase 1 严格拒绝 non-git 目录。错误就近渲染在悬浮窗内,主表单状态不动。
未来放宽后,可以在这里加 fallback:「初始化为 git 仓库 / 跳过」二选一。
未来放宽后,可以在这里加 fallback:「初始化为 git 仓库 / 跳过」二选一。
SCENE 6 · Task 新建
未保存 task · 创建中
点「+」后,列底出现虚线占位卡片(暗示落库位置),右侧详情面板切到未保存模式:title 自动 focus,repos 默认全选。
未开始
3
数据库迁移脚本
用户认证系统
未保存 task
新建
进行中
3
实现登录 API
重构 API 网关 限流模块
前端登录页面
新建
已完成
2
埋点上报 SDK 升级
修复列表分页 bug
新建
新建 task 未保存
lark-agents/backend
lark-agents/frontend
lark-agents/shared
提交「创建」→「未保存 task」落库,列底占位变成真卡片。取消或切换 Project → 直接丢弃,无确认弹窗。
右侧底部「创建 / 取消」用 sticky footer,长描述时按钮不被推下去。
右侧底部「创建 / 取消」用 sticky footer,长描述时按钮不被推下去。
SCENE 7 · Task 新建
未保存 task · 未绑 repo 的 project
该 project 没绑 repo 时,repos 区域不显示空 checkbox 列表,而是显示一条带去 Settings deep-link 的提示。允许提交,task 落库 task_repos 为空。
未开始0
新建
进行中0
新建
已完成0
新建
语义:repos 字段不消失,而是显式告知用户"现在没的可选",并给一条直达 Settings 的链接。这样用户的 mental model 是连贯的。
SCENE 8 · Task 编辑
Task 详情 · 状态切换
右侧详情顶部"状态"区可点切换列,等价于在看板上把卡片拖到另一列。除了拖拽外多一个 inline 入口,给键鼠用户。
未开始
2
数据库迁移脚本
用户认证系统
新建
进行中
3
实现登录 API
重构 API 网关 限流模块
前端登录页面
新建
已完成
2
埋点上报 SDK 升级
修复列表分页 bug
新建
Task 详情
删除 task
实现登录 API
未开始
进行中
已完成
接入公司 SSO,支持邮箱 + Magic Link。需要考虑未注册用户的首次登录流程,以及 session 续期。
lark-agents/backend
lark-agents/frontend
lark-agents/shared
状态切换两条路径:① 看板上直接拖卡片(手感最佳);② 这里点 pill(键鼠 / 不离开详情)。两者底层走同一个 PATCH status_id。
删除入口:走标题右侧「...」 菜单 → 弹出「删除 task」 选项 → 点击后才出 confirm(scene 9)。两步式刻意保留,避免误触。
删除入口:走标题右侧「...」 菜单 → 弹出「删除 task」 选项 → 点击后才出 confirm(scene 9)。两步式刻意保留,避免误触。
SCENE 9 · Task 编辑
删除 task · 二次确认
点删除后 dim 整页,居中弹一个紧凑 confirm。phase 1 不展示级联(不告诉用户 sessions 会怎样——sessions 在 phase 1 不暴露)。
未开始
2
数据库迁移脚本
用户认证系统
新建
进行中
3
实现登录 API
重构 API 网关 限流模块
前端登录页面
新建
已完成
2
埋点上报 SDK 升级
修复列表分页 bug
新建
Task 详情
实现登录 API
未开始
进行中
已完成
接入公司 SSO,支持邮箱 + Magic Link。需要考虑未注册用户的首次登录流程,以及 session 续期。
lark-agents/backend
lark-agents/frontend
lark-agents/shared
删除这个 task?
实现登录 API 将被删除。这是一个不可恢复的操作。copy 风格:清晰、不卖关子。一句话标题 + 一句话副本 + 操作按钮。action:红色"删除"为主,左侧"取消"次之,默认焦点在"取消"上避免误删。
SCENE 10 · Labels
Labels · inline picker
点详情面板的"+ 添加"打开 picker。输入新名 → 命中已有时显示可选项;无命中时显示"新建标签 \"xxx\"",选择后立即新建并选中。
未开始
2
数据库迁移脚本
用户认证系统
新建
进行中
3
实现登录 API
重构 API 网关 限流模块
前端登录页面
新建
已完成
2
埋点上报 SDK 升级
修复列表分页 bug
新建
Task 详情
实现登录 API
未开始
进行中
已完成
接入公司 SSO,支持邮箱 + Magic Link。需要考虑未注册用户的首次登录流程,以及 session 续期。
#backend
#database
#data-migration
新建标签
"data"
lark-agents/backend
lark-agents/frontend
lark-agents/shared
B4 实现:输入命中已有 → 展示已有项;只有完全无命中时展示新建项。
phase 1 标签的重命名 / 删除没有 UI——这是有意为之的轻量管理。
phase 1 标签的重命名 / 删除没有 UI——这是有意为之的轻量管理。
SCENE 11 · Settings
Settings · Projects tab
齿轮打开居中大 modal。左侧 nav 只有"资源"分组(Projects / Repos);点击 project 在右侧详情挂卸 repo、inline 重命名。删除 project 不做。
未开始
2
数据库迁移脚本
用户认证系统
新建
进行中
3
实现登录 API
重构 API 网关 限流模块
前端登录页面
新建
已完成
2
埋点上报 SDK 升级
修复列表分页 bug
新建
Task 详情
实现登录 API
未开始
进行中
已完成
接入公司 SSO,支持邮箱 + Magic Link。需要考虑未注册用户的首次登录流程,以及 session 续期。
lark-agents/backend
lark-agents/frontend
lark-agents/shared
资源
Projects3
Repos4
Project
Eyrie · Phase 1
3 projects total
名称
已绑定 Repos 3
lark-agents/backend
lark-agents/frontend
lark-agents/shared
挂 / 卸 repo 的两个入口和 Create Project 一致(「+ 选择已有仓库」+「+ 拖入新目录」)。解绑:图标用 unlink,hover 出 tooltip"解绑此 repo",点击后直接解绑;已有 task 不受影响,新 task 不再可选。
SCENE 12 · Settings
Settings · Repos tab
Repos 是全局列表。git_common_dir / remote_url 只读展示;只有 name 可改(inline)。删除不做,也不在 UI 里展示删除入口。
未开始
2
数据库迁移脚本
用户认证系统
新建
进行中
3
实现登录 API
重构 API 网关 限流模块
前端登录页面
新建
已完成
2
埋点上报 SDK 升级
修复列表分页 bug
新建
Task 详情
实现登录 API
未开始
进行中
已完成
接入公司 SSO,支持邮箱 + Magic Link。需要考虑未注册用户的首次登录流程,以及 session 续期。
lark-agents/backend
lark-agents/frontend
lark-agents/shared
资源
Projects
Repos
Repo
lark-agents/backend
4 repos total
名称
git 元数据 · 只读
remote_url
git@github.com:lark/agents.git
git_common_dir — Repo 身份指纹
/Users/lz/code/lark-agents/.git
关联的 projects 3
Eyrie · Phase 1
Lark Agents
Side Sandbox
Repos tab 只负责全局 repo 信息:改名、查看只读 git 元数据、查看关联 projects。Project 下的解绑动作在 Projects tab 完成,点击后直接生效。
SCENE 13 · 导航
Project picker · 下拉打开
左上角点 picker → dropdown 列出全部 projects + 底部固定「+ 新建项目」入口。phase 1 项目项不带 hover 菜单——重命名 / 挂卸 repo 一律走 Settings。
Eyrie 工作区
Lark Agents
Side Sandbox
新建项目
未开始
2
数据库迁移脚本
用户认证系统
新建
进行中
3
实现登录 API
重构 API 网关 限流模块
前端登录页面
新建
已完成
2
埋点上报 SDK 升级
修复列表分页 bug
新建
Task 详情
实现登录 API
未开始
进行中
已完成
接入公司 SSO,支持邮箱 + Magic Link。需要考虑未注册用户的首次登录流程,以及 session 续期。
lark-agents/backend
lark-agents/frontend
lark-agents/shared
项目项不带 hover 菜单:避免在导航瞬间触发破坏性操作。「+ 新建项目」入口:跳到 scene 3/4 的 Create Project 整页(不是 modal)。