拾光 · 产品介绍
Product Overview
拾光
研发协作智能助手
把飞书里的需求线索收成可执行任务，在本机用 AI 改码，再用看板与卡片完成审核闭环。
拾光 · 产品介绍
Contents
目录
01产品定位
02运行形态
03产品主链
04飞书侧能力
05Web 看板与对话
06IDE 与自定义技能
07多 Agent 分工
08部署与能力边界
09技术架构
01 / 产品定位
解决「需求散、改码难闭环」
研发协作里，常见卡点不在「会不会写代码」，而在线索散落、上下文断裂、审核难回收。
- 需求散落在飞书 合并转发、群聊记录里的需求线索难沉淀，容易漏跟、难回看。
- 改码依赖本机仓库 真正落地要落到本地工程与 Cursor 能力，聊天里说清楚也不等于能直接改。
- 执行与审核难闭环 从收集、齐套、执行到审核缺少一条可操作主链，状态难同步、责任难交接。
拾光怎么解：
飞书负责触达与状态卡片，Web / 桌面负责齐套与深度操作，本机宿主负责 Cursor 改码，串成「收集 → 齐套 → 执行 → 审核 → 完成 / 续接」。
02 / 运行形态
同一套 UI，三种使用方式
Dev
Web 开发
Vite + Express，代理 /api；完整宿主能力，读取仓库 .env。
Desktop
桌面安装包
Tauri 壳拉起本机 Node；飞书长连接 / Cursor / IDE 可用。
Mobile
移动端访问
FRP 或飞书网页应用；看板对话可用，改码仍在 PC 宿主。
03 / 产品主链
以 Task 为唯一业务容器
01
建卡
回复合并转发，判新建/追加与项目
02
积压
写入来源上下文，可自然语言澄清
03
齐套
补齐修改点、涉及文件、提出人
04
执行
Cursor 改码，可中止回退 HEAD
05
审核
质量门分级；发卡操作按钮
06
闭环
完成 / 续接 / 重新执行
04 / 飞书侧能力
卡片与菜单驱动，不做文字指令
- 新建 / 追加：回复合并转发说明意图
- 开始 / 中止 / 通过 / 不通过：任务操作卡片
- 续接 / 重新执行：已完成或已阻塞状态卡片
- 详情：跳回来源会话，无会话则回退看板
- 菜单汇总：任务列表 / 今日 / 本周
积压整理与信息补齐一律在 Web 完成；普通文字只回固定提示。
05 / Web 看板与对话
看板推进状态，对话驱动任务
看板六列：积压 → 待办 → 进行中 → 审核中 / 已阻塞 → 已完成
- 拖拽流转与飞书卡片动作同源
- 抽屉编辑分支、涉及文件、提出人
- 支持复制提示包、打开项目目录
- 对话模式：个人助手 / 普通对话 / 知识问答
- 可用 @技能名 精确触发已启用技能
06 / IDE 与自定义技能
本机改码工作台 + 可扩展技能
IDE /ide
内置代码工作台
- 文件树 / Git / Monaco / Diff
- 命令面板与终端；可绑定当前任务 ID
Skills /skills
自定义技能平台
- 系统预设 + 用户自建（LLM / 脚本 / 图）
- 对话 @技能名；助手也可 run_skill
07 / 多 Agent 分工
角色分派，互不抢跑
同项目改码串行排队
不同项目可并行
中止可回退执行前 HEAD
08 / 部署与能力边界
本机做执行，外网只负责触达
设计目的：改码、仓库与密钥始终落在开发者本机；飞书与手机只负责提出需求、查看进度与审核，不把工程搬到云端。
- 数据不出本机——代码、任务状态与凭据留在本地，穿透层只做转发，不落库、不代执行
- 能力跟得上 IDE——真正改码仍在本机完成，可直接用 Cursor / 本地工具链，和日常开发环境一致
- 随时可触达——手机或飞书侧边栏能看看板、推卡片，不必再装一套移动端
- 边界清晰可控——外网能看、能催、能审；高影响动作仍回到本机与人工把关
把「协作触达」外放，把「执行与数据」留在本机——既方便跟进，又不牺牲安全与工程上下文。
09 / 技术架构
整机功能技术架构
飞书触达与卡片、Web/桌面交互、本机 Express 宿主编排、Agent / IDE / Skills、本地任务状态机，以及 Cursor / LLM 外部能力，汇成一条可闭环的改码协作链路。
能力速查
常见场景怎么走
| 场景 | 入口 | 结果 |
|---|---|---|
| 从飞书需求建卡 | 回复合并转发 | 积压任务 + 来源上下文 |
| 补齐与确认 | Web 看板 / 任务对话 | 齐套后可进待办 |
| 自动改码 | 卡片开始 / 拖入进行中 | 待审核或已阻塞 |
| 人工带走 | 复制提示包 | 不改状态 |
| 审核闭环 | 卡片或质量门 | 完成或退回待处理 |
| 手机随手看 | FRP / 飞书网页应用 | 同一套 Web UI |
拾光 · 产品介绍
Get Started
从一则转发
开始闭环
配置就绪后，用飞书合并转发创建第一个任务。详细操作见《使用说明》，能力细则见《产品说明书》。