Files
ChatLab/AGENTS.md
T
diguaandCursor dd3cb10414 refactor(services): unify CLI Web and Electron service layer
Extract shared business logic from monolithic web.ts into reusable
services in @openchatlab/node-runtime (session, member, index, summary,
export), using SessionRuntimeAdapter to abstract platform differences.
Split web.ts into 12 domain-specific route modules under routes/web/.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-22 10:20:39 +08:00

1.4 KiB
Raw Blame History

  • 文档:开始开发前,请先查看 ./.docs/README.md,并阅读与当前需求相关的文档
  • 目标:用最小改动快速交付正确、可维护、可回归的业务结果
  • 边界:只解决当前需求,不做与需求无关的重构和"顺手优化"
  • 每次完成任务后,对产生修改的文件进行类型检查、lint检查和format格式化,指定修改的文件路径去执行,确保代码质量
  • 在执行检查时,如果有其他与本次修改无关的报错,也需要一并修复
  • 多语言:代码中的日志、注释、AI 工具描述、错误消息等非 UI 文本默认使用英文。当有运行时 locale 可用时(如工具返回结果、AI 看到的文本),应通过 isChineseLocale(locale) 等机制支持中英双语。数据清洗中与聊天平台格式匹配的标签(如 [分享]、[图片])保持原始语言不变。UI 文案的国际化遵循 .docs/rules/i18n.md
  • 多端复用:维护 Electron 和 CLI Web 的共享业务逻辑时,优先在 packages/node-runtime/src/services/ 下实现,禁止在路由/IPC handler 中绕过 core 直接写 SQL。详见 .docs/README.md 的"多端逻辑复用"章节。
  • Commit 规范:使用 Conventional Commits。scope 规则——通用改动 scope 随意(如 ai、import、sidebar 等模块名);仅当改动是平台特有时才使用平台 scope(electron、cli、web)。