Skip to content

Latest commit

 

History

History
33 lines (25 loc) · 1.73 KB

File metadata and controls

33 lines (25 loc) · 1.73 KB

SyncNos WebClipper 文档

SyncNos 将 AI 对话、网页文章和已加载的视频字幕统一为浏览器本地 conversation;同步和导出都是派生产物。

入口

目标 页面
本地数据、备份和安全边界 storage.md
设置、构建与环境变量 configuration.md
部署或维护 Feishu OAuth feishu-setup.md
构建、采集和评论定位排障 troubleshooting.md

代码结构、符号和调用关系以 CodeGraph 为准;不可违反的分层和交互规则在根 AGENTS.md

产品模型

来源 sourceType 本地内容
AI 对话 chat 标准化消息序列
网页正文 article article_body,可附评论线程
视频字幕 video video_transcript,可带时间戳

不可破坏的产品规则

  • 采集以本地落库成功为准;远端失败不能丢失本地内容。
  • ChatGPT 与 Google AI Studio 的虚拟列表只允许显式手动完整抓取,不得加入自动保存。
  • 图片缓存和反防盗链是增强项,失败不得阻断正文保存。
  • Reader 只用于 articlevideo;AI chat 不显示阅读器工具。
  • 评论是 article 的本地注释层:只有根评论可记录 locator,且只接受全局唯一 exact Range;失败显示 unavailable,不做模糊回退。
  • $ mention 的站点支持以 src/collectors/ai-chat-sites.ts 为准;使用 $ 打开候选,Tab/Enter 插入。
  • 会话列表只能走 bootstrap + loadMore 分页,禁止恢复全量读取。
  • OAuth token、client secret 等敏感数据不得进入备份;外部 mapping/cursor 不能反向覆盖本地事实。