Skip to content

dev_task.md

Latest commit

 

History

History
220 lines (168 loc) · 11.2 KB

dev_task.md

File metadata and controls

220 lines (168 loc) · 11.2 KB
Raw

Dev Task Log

2026-08-10 · v1.4.0 GitHub 发布收口

今日更新

  • 将快速接入、官方 Channel SDK、流式卡片、媒体与文档评论能力收口为 v1.4.0。
  • README、路线图、插件清单、MCP 和包版本统一到最新产品口径。
  • GitHub About、Topics 和 Release 与仓库实际能力同步。
  • Setup、流式卡片、媒体和文档评论在公开文档中标注为 Beta，保留真实环境 UAT 边界。

2026-08-09 · 快速接入与 Channel SDK

今日更新

  • 新增扫码 Setup，创建新应用和更新已有应用采用不同的显式入口。
  • Setup 只把凭据写入本地 .env，不会打印 App Secret；同时设置 owner、默认接收人和 Codex runner。
  • 消息机器人迁移到飞书官方 Channel SDK，保留原有会话、白名单、队列与本地执行边界。
  • Codex 结果改为关联原消息并使用 Markdown，话题消息保持在原话题中。
  • Codex 任务启用官方流式卡片，并保留 Markdown 自动回退。
  • 增加入站媒体隔离下载、工作区文件安全发送和云文档评论回复。

验证结果

  • Setup 参数、权限事件、env 去重写入和 0600 文件权限已加入 smoke test。
  • Channel 消息归一化、原消息回复参数和现有 bot bridge 端到端检查通过。
  • SDK 1.70.0、CLI help、全量 smoke 和敏感信息扫描通过。
  • 流式输出、媒体目录边界、文件大小限制和评论 payload 已加入 smoke test。

2026-07-21 · 日报内容与可读性优化

今日更新

  • 单项目和多项目报告统一为「日期标题 + 整体概述 + 四阶段项目表格」。
  • 新增共享报告格式模块，同时输出 Markdown 表格和飞书原生 Docx 表格块。
  • 报告生成优先参考仓库 CHANGELOG.md，把 Git 活动转译为 Added / Changed / Fixed 风格的产品更新。
  • 内部工程元数据继续用于判断更新范围，但不进入最终日报。
  • 私聊摘要移除英文 Status 和 commit 信息，改为项目名与主要产品变化。

验证结果

  • 日期标题、表格列、产品化文案清理和 Docx 嵌套表格结构已加入 smoke test。
  • 单项目与多项目 Python 脚本通过语法检查。
  • 敏感信息扫描继续作为提交前必跑项。

2026-07-21 · v1.3.0

今日更新

  • 新增多项目总览入口：npm run feishu -- portfolio-report。
  • 新增本地项目清单约定：通过 FEISHU_PROJECTS_FILE 或 --projects-file 指向 projects.json。
  • 新增 examples/projects.example.json，只放占位路径和占位姓名，真实项目路径保留在本地。
  • .gitignore 忽略 projects.json 和 projects.local.json，避免误提交本机项目路径。
  • 多项目总览默认采集每个仓库的 Git 分支、最近提交、工作区状态和 diff stat，不读取完整源码。
  • 多项目报告默认不把本机完整路径写入飞书内容；需要本地调试时才使用 --include-paths。
  • README 增加「全部项目总览」配置和命令说明。
  • 将版本元数据提升到 1.3.0。

验证结果

  • npm run feishu -- portfolio-report --help 通过。
  • scripts/smoke-test.sh 已覆盖项目清单解析、Git 采集和路径脱敏逻辑。
  • 敏感信息扫描继续禁止真实飞书 App ID、Secret、open_id、chat_id、token 和 Bitable token 入库。

后续事项

  • 可选增加组合报告的真实飞书 UAT：--write-doc --bitable --send --confirm。
  • 可选增加定时任务或 launchd 示例，让多项目周报自动推送。
  • 可选把 Project Status 扩展为多表方案：Release Records、Risk Tracker、Case Study Intake。

2026-07-21 · v1.2.0

今日更新

  • 完成 Bitable 真实 UAT：创建 Codex Project Operations Base 和 Project Status 表。
  • 验证 report --write-doc --bitable --send --confirm 可以同时创建 Docx、写入 Bitable 记录并发送私聊消息。
  • 在本地 Feishu HTTP client 中增加用户 token 自动刷新：当 FEISHU_USER_ACCESS_TOKEN 过期或失效时，使用 FEISHU_USER_REFRESH_TOKEN 续期，写回 .env 并重试原请求。
  • 新增 npm run feishu -- bitable-bootstrap，把 Base / Project Status 表创建流程产品化。
  • 精简 README 为中文新手优先结构，默认第一路径改为私人助理推送。
  • 新增两张 README 图文介绍图，用于解释私人助理推送和项目报告闭环。
  • 将版本元数据提升到 1.2.0。

验证结果

  • 用户 token refresh 接口真实验证通过。
  • Bitable Project Status 表字段创建通过：Project、Status、Owner、Next Step、Updated At。
  • 真实 Bitable record 写入通过。
  • npm run feishu -- bitable-bootstrap --preview --owner "Hunk Wu" 通过。
  • bash scripts/smoke-test.sh 通过。
  • scripts/check-sensitive-values.sh 通过。
  • README 图片路径、本地链接和敏感信息扫描通过。

后续事项

  • 梳理 media/ 目录，决定是否纳入公开素材或继续保留为本地未跟踪文件。
  • 可选继续补充 Release Records / Risk Tracker / Case Study Intake 的 bootstrap 模板。

2026-07-20 · v1.1.0

今日更新

  • 明确产品分工：本项目聚焦 Codex 调用飞书原生协作能力；通用远程 Agent 场景推荐 lark-channel-bridge。
  • 长连接 bot 改为默认拒绝执行，未配置访问控制时不会 spawn 本地命令。
  • 新增 Git-aware 项目报告 CLI，覆盖 Docs/Wiki 检索、结构化 Codex 总结、Docx 写回、消息推送和可选 Bitable 记录。
  • 新增 npm run feishu -- auth 本地 OAuth 回调授权，自动写入用户 token 和 refresh token。
  • 稳定 MCP 增加 Docx 创建、块写入、文档 URL 和 Bitable record 工具。
  • 统一 Apache-2.0 许可证和 v1.1.0 版本元数据。
  • 更新 README、路线图、工作流、认证、文档和 Bitable 指引。

关键边界

  • 不新增流式卡片、附件、多 profile 或跨平台 daemon。
  • Git 采集只包含提交、状态和 diff stat，不读取完整源码。
  • Codex 生成固定使用 read-only 和 ephemeral。
  • 所有真实飞书写入必须显式使用 --confirm；Bitable 默认关闭。

验证结果

  • bash scripts/smoke-test.sh 通过。
  • scripts/check-sensitive-values.sh 通过。
  • 未配置访问控制时，本地执行保持关闭，doctor 返回退出码 2。
  • 项目报告 preview、dry run、失败顺序和 MCP 工具路由通过自动化检查。
  • 使用标题「Codex Feishu v1.1 验证」完成一次真实私人助理周报推送。
  • 已完成 FEISHU_USER_ACCESS_TOKEN 真实配置和 UAT 验证：user_info、Docs 搜索、report --preview、Docx 创建和私聊推送均通过。
  • Bitable 真实写入仍待配置 FEISHU_BITABLE_APP_TOKEN、FEISHU_BITABLE_TABLE_ID 和字段匹配后验证。

2026-06-04 · v1.0.0

今日更新

  • 完成 Feishu bot bridge 的本地闭环验证：
    • 群消息进入
    • 本地 runner 执行
    • 结果回写飞书
  • 完成 macOS launchd 常驻运行联调：
    • start
    • status
    • restart
    • stop
  • 补充 bot 诊断能力：
    • /ids
    • 更丰富的 /status
    • access denied 提示里直接带 allowlist 配置片段
  • 补充轻量日报入口：
    • npm run feishu -- digest --preview
    • npm run feishu -- digest --send --confirm
  • 完成默认日报模板中文化，并做了真实飞书推送验证。
  • 完成 GitHub 开源文档收口：
    • README 内容结构优化，降低首屏图片占用，突出亮点和快速接入。
    • README、CONTRIBUTING 统一为中文优先，保留必要英文摘要。
    • CHANGELOG 统一以 1.0.0 作为首个公开版本。
    • package、插件清单、MCP / Webhook 可见版本同步到 1.0.0。
    • 删除独立 release note 和 case study 目录后，将必要信息收口到 CHANGELOG 与 dev task。
  • 完成公开文档规则收口：
    • README / CHANGELOG / release notes 只记录用户可感知能力、行为变化、修复、兼容说明和验证证据。
    • 不把不影响用户使用的维护动作写入公开更新日志。

今日遇到的问题

  1. 飞书消息未进入本地 bot 原因：本地配置使用了错误的 Feishu App ID，并非当前要联调的机器人应用。

  2. 同一条飞书消息出现重复回复 原因：飞书侧存在同一 message_id 的重复投递，本地 bot 之前没有幂等保护。

  3. 后台常驻与前台联调容易混淆 原因：launchd service 状态、bot 实际收消息状态、Hermes 现有机器人路径在联调阶段容易混在一起。

  4. 定时日报需求存在明显维护膨胀风险 原因：如果直接做完整 schedule 子系统，会额外引入第二套 service、状态、日志和调度文档。

  5. 默认日报模板内容中文不完整 原因：结构标题已经中文化，但模板正文仍保留英文示例条目。

  6. README 首屏信息过散 原因：截图和背景说明占用过多篇幅，用户进入仓库后不容易快速理解「能做什么」和「如何接入」。

  7. 公开更新日志混入维护动作 原因：发布收口时把内部文档整理、版本策略说明等内容也写进 CHANGELOG，容易干扰用户判断真实能力变化。

  8. 中英文文档维护成本偏高 原因：完整双语 README 和独立 release note 容易造成重复维护、信息漂移和过期链接。

解决方案

  1. 更换本地 .env 中的 Feishu 应用配置，并重新做长连接联调。
  2. 在 bot 中增加基于 message_id 的幂等保护，避免重复执行和重复回复。
  3. 用统一 CLI、launchd status、runner 日志和真实飞书回包来拆分验证层次。
  4. 放弃完整 schedule 子系统，改为轻量 digest 包装脚本，加仓库外 launchd 示例。
  5. 把默认 project-update-template.md 完整改成中文，确保 digest 默认输出适合真实私聊推送。
  6. 重写 README 首屏结构，优先展示项目定位、核心能力、5 分钟接入和真实功能边界。
  7. 将 CONTRIBUTING 改为中文优先、英文补充，降低中文用户贡献门槛。
  8. 将 CHANGELOG 改为只保留公开用户可见变化，移除不影响用户的维护动作说明。
  9. 将文档结构收口为 README、CHANGELOG、roadmap、pre-release checklist 和 dev task，减少重复来源。

验证结果

  • bash scripts/smoke-test.sh 通过
  • scripts/check-sensitive-values.sh 通过
  • npm run feishu -- digest --preview 通过
  • npm run feishu -- digest --send --confirm 已真实成功
  • npm run feishu -- help 通过
  • README 本地链接与已删除目录引用检查通过
  • 相关 GitHub 提交：
    • c8386e0
    • 932ce18
    • 9a5511d
    • d98bd85
    • 05d159b
    • c90e853
    • 2d479ef

明日计划

  • 继续收紧访问控制默认值，降低误触发本地执行风险。
  • 评估是否需要把日报内容源从固定模板升级为半自动摘要。
  • 继续积累已打码截图和真实验证材料，补强开源项目对外证据链。
  • 检查 GitHub 首页展示效果，确认 README 首屏、目录和截图在网页端阅读顺畅。
  • 做一次从零安装路径复核，重点验证 .env.example、权限说明、doctor 和 help 是否足够引导新用户。
  • 梳理下一阶段 v1.1.0 的最小增量，优先考虑会话连续性、工作区绑定和更稳定的真实 codex exec 对接。