Imported from chiimagnus/SyncNos (AGENTS.md). Install upstream with npx skills add chiimagnus/SyncNos. Copyright stays with the author.

仓库指南

Name: SyncNos
Author: chiimagnus

贡献流程、提交规范和通用验证要求统一见 docs/CONTRIBUTING.md。本文件只维护代码架构、不可破坏契约和 agent 特有的实现约束。

分层与依赖方向

src/ui/**：React 组件、样式和 DOM surface。
src/viewmodels/**：UI 状态编排，只调用 service。
src/services/**：业务流程、协议和可复用算法。
src/platform/**：浏览器 runtime、storage、messaging、IndexedDB 等适配。
src/collectors/**：站点 DOM 采集与视频字幕解析。
src/entrypoints/**：background、content、popup、app 等装配入口。

依赖方向必须保持：

ui -> viewmodels -> services -> platform/domain/client/shared
entrypoints -> ui/viewmodels/services/platform
collectors -> services/shared

禁止：

src/ui/** 或 src/viewmodels/** import @platform/*。
src/services/** import @ui/* 或 @viewmodels/*。
把可复用数据处理留在组件内。

路径别名：@ui/*、@viewmodels/*、@services/*、@platform/*、@collectors/*、@entrypoints/*、@i18n/*。

必须保持的契约

UI 圆角只使用 src/ui/styles/tokens.css 中的 --radius-*；细则见 src/ui/AGENTS.md。
会话列表必须使用 bootstrap + loadMore 分页，禁止恢复全量读取。
ChatGPT 与 Google AI Studio 的虚拟列表会卸载离屏轮次，禁止加入 AI_CHAT_AUTO_SAVE_COLLECTOR_IDS；完整历史只走手动抓取和 prepareManualCapture()。
评论选区只附加到根评论 composer；reply 输入框和评论面板内选区不得覆盖正文引用。
根评论允许仅划线：正文引用可在评论正文为空时保存，但必须有可验证的定位或稳定导入身份；reply 仍必须有非空正文。
评论定位只接受全局唯一 exact Range，不新增模糊匹配、比例滚动或父元素高亮回退。
$ mention 使用 $ 打开候选，Tab/Enter 插入；站点支持真源在 src/collectors/ai-chat-sites.ts。
markdown_reading_profile_v1 未知值归一到 medium。
anti_hotlink_rules_v1 命中后补 referer 并尝试缓存图片，但图片失败不得阻断正文采集。
Provider 的手动同步与自动同步必须收敛到同一 orchestrator / SyncJob 生命周期；scheduler、handler 或 UI 不得另写第二套 progress / terminal job 状态。某 conversation 的非空标题一旦已知，后续空 progress/error payload 不得把它降级回仅 ID；provider 自己的事务、并发和远端写入语义不能被共享 lifecycle 改写。
IndexedDB 业务层统一借用 src/platform/idb/schema.ts 的 canonical connection；受 revision 跟踪的 writer 必须让业务变更与 revision 同事务提交，consumer 以 durable revision + canonical reread 为正确性真源，禁止重新引入自定义 event/Port 总线作为第二套数据一致性协议。恢复/失败语义见 docs/storage.md。

Agent 实现约束

默认不查看或编辑 i18n 文案，除非任务明确涉及文案。
新 API、新状态或新文件必须接入生产入口；不要留下只被测试引用、没有生产消费者的实现。

架构自检

通用验证矩阵见 docs/CONTRIBUTING.md。涉及对应边界时额外运行：

rg -n "@platform/|src/platform|/platform/" src/ui src/viewmodels
rg -n "@ui/|@viewmodels/" src/services
rg -n "border-radius:\\s*[0-9]|tw-rounded-\\[" src/ui src/entrypoints

{ "ocm": "1", "id": "chiimagnus-syncnos-syncnos", "kind": "skill", "name": "SyncNos", "description": "贡献流程、提交规范和通用验证要求统一见 [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md)。本文件只维护代码架构、不可破坏契约和 agent 特有的实现约束。", "publisher": "chiimagnus", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "贡献流程、提交规范和通用验证要求统一见 [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md)。本文件只维护代码架构、不可破坏契约和 agent 特有的实现约束。" ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/chiimagnus/SyncNos", "path": "AGENTS.md", "ref": "7ee2ce11acfe8a60cd5c3c30e88e5df5bbd937d4", "url": "https://github.com/chiimagnus/SyncNos/blob/7ee2ce11acfe8a60cd5c3c30e88e5df5bbd937d4/AGENTS.md", "key": "chiimagnus/SyncNos/AGENTS.md" } }, "instructions": "# 仓库指南\n\n贡献流程、提交规范和通用验证要求统一见 [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md)。本文件只维护代码架构、不可破坏契约和 agent 特有的实现约束。\n\n## 分层与依赖方向\n\n- `src/ui/**`：React 组件、样式和 DOM surface。\n- `src/viewmodels/**`：UI 状态编排，只调用 service。\n- `src/services/**`：业务流程、协议和可复用算法。\n- `src/platform/**`：浏览器 runtime、storage、messaging、IndexedDB 等适配。\n- `src/collectors/**`：站点 DOM 采集与视频字幕解析。\n- `src/entrypoints/**`：background、content、popup、app 等装配入口。\n\n依赖方向必须保持：\n\n```text\nui -> viewmodels -> services -> platform/domain/client/shared\nentrypoints -> ui/viewmodels/services/platform\ncollectors -> services/shared\n```\n\n禁止：\n\n- `src/ui/**` 或 `src/viewmode", "cost": { "context_tokens": 562 } }

SyncNos

About

仓库指南

分层与依赖方向

必须保持的契约

Agent 实现约束

架构自检

Use it

Manifest

Reviews