内容提要
作者用AI完成vibecoding项目:为DSH编辑器开发飞书插件,在右侧栏新增飞书页签,可查看今日任务,点击“开工”将任务投入对话,完成后结论自动写回飞书,免去复制粘贴。插件支持任务与文档绑定、定时同步、自动回写AI进度、按需自动开工,提供自建CLI与官方lark-cli两种后端,不绑定租户。文中还记录了授权、改名、多实例冲突等踩坑经验及功能边界。
延伸解读
插件形态与后端选择
该插件同时实现服务端与Web半体,缺一不可。后端提供自建feishu-sync-cli和官方lark-cli两种,能力对齐,面板二选一。自建版适合内网环境,官方版通过npm安装、浏览器授权,凭据存入钥匙串。插件不绑定租户,令牌由CLI管理,插件不接触密钥。选择时需考虑网络与权限条件。
任务同步与自动开工的代价
同步默认30分钟一轮,无webhook,只拉未完成任务。自动开工分三档,默认关闭,每轮最多一条,会真实创建会话并消耗token。工作区只认已登记标题或绝对路径,拼错不会误开工。进展回写仅认文件修改、commit、测试三种硬证据,有节流与补发机制。这些设计在便利与资源消耗间做了权衡。
踩坑揭示的边界与限制
右侧栏注册口非官方,依赖betterSidebar.registerTab,需等待激活并轮询。多实例会互相覆盖状态文件,改为整个DSH_HOME一份。docx无改标题接口,只能改页面块text并加PATCH兜底。推理模型可能吃光预算,需调大token并重试。自动开工与官方lark-cli后端尚未在真实环境完整验证,docx不渲染Markdown。
Q&A
飞书任务开成 DSH 会话这个插件具体是做什么的?
该插件在 DSH 编辑器右侧栏新增「飞书」页签,可查看今日任务,点击「开工」将任务投入当前对话,完成后结论自动写回飞书,免去复制粘贴。还支持任务与文档绑定、定时同步、自动回写 AI 进度、按需自动开工等功能。
这个插件支持哪些后端?如何选择?
插件提供两套能力对齐的后端,在面板中二选一:默认是自建的 feishu-sync-cli(公司内网用,非公共 PyPI 包);官方推荐换成飞书官方 lark-cli(npm 安装、浏览器授权、凭据进钥匙串)。插件不绑定任何租户,令牌由 CLI 自己保管和刷新。
任务同步和自动开工的机制是怎样的?
同步默认每 30 分钟一轮,只拉未完成任务,可按关键词和截止日过滤。自动开工有三档:关(默认)、只开标注过的、所有新任务,每轮最多一条。插件每 30 秒巡检到点任务,到点立刻同步;开工优先在当前对话进行,自动开工则始终新建会话。
AI 进度自动回写飞书是怎么实现的?
每个真有进展的 turn 结束后,插件自动往绑定的飞书任务写一条「🤖 AI 进度」评论。只认三种硬证据:改了文件、有 commit、跑了测试,闲聊不算;整体 700 字以内,同一会话 45 秒节流,失败下次补发一次。
开发这个插件时遇到了哪些坑?
主要坑包括:加载期不能抛异常(客户端半体静默、宿主半体 fail-loud);右侧栏注册口非官方,需用 betterSidebar.registerTab 并等待激活;两个实例会互相覆盖状态文件,改为整个 DSH_HOME 一份;推理模型吃光预算导致起名空结果,改为两档 token 并重试;双击改名不能失焦保存;自定义字段 scope 默认没有,需绕层或换官方 CLI。
这个插件有哪些功能边界或限制?
自动开工默认关(会真建会话、花 token);docx 不渲染 Markdown(表格和 Mermaid 是原样文本);「清单名当工作区」的兜底不生效(CLI 只回 guid 不回名字);文档摘要按修改时间重抓;开工未在真实页面点过(逻辑由冒烟测试覆盖);官方 lark-cli 后端只用假 CLI 跑过集成测试,真实安装和授权未本机验证。