Name: garss-studio
Author: zhaoolee

Imported from zhaoolee/garss (garss-studio/AGENTS.md). Install upstream with npx skills add zhaoolee/garss --skill garss-studio. Copyright stays with the author.

AGENTS

这个文件给后续进入 garss-studio/ 的 agent 使用。

开始前先看

按这个顺序建立上下文：

PROJECT_MEMORY.md
README.md
src/App.tsx
src/styles.css
server/index.ts

当前产品基线

前端：React + TypeScript + Zustand
后端：Express + TypeScript
Docker 外部只暴露一个端口：25173
开发环境通过 Vite 代理 /api 和 /socket.io
生产环境通过 Nginx 代理 /api 和 /socket.io

UI 约定

顶部 header 高度固定为 62px
阅读页是左右布局：
- 左侧为单选订阅源索引
- 右侧只显示当前选中订阅源的文章
- 右侧支持“重新拉取当前源”
- 左右区域都在固定高度内独立滚动
- 后端缓存文件是 storage/reader-cache.json
- 页面初始化默认读缓存，不主动触发真实 RSS 拉取
- 自动拉取和手动重新拉取才会访问真实 RSS 源，并更新缓存
设置页是与“阅读 RSS”“管理订阅源”并列的一级页面：
- 左侧为条目列表，当前固定为“拉取设置”“关于”
- 拉取设置必须走后端持久化，存储文件是 storage/settings.json
- storage/settings.json 需要按用户标识分桶；用户标识就是 URL 里的 pw 参数，当前默认是 banana
- 自动拉取必须由后端按 cron 风格调度，前端不能再自己用 setInterval 触发真实拉取
- “距离下一次自动拉取”必须显示后端计算出的下一次 cron 触发时间
- “拉取设置”右侧展示自动拉取时间间隔、并行拉取数量、下一次拉取倒计时、socket.io 连接状态和任务进度条
- 自动拉取时间间隔默认 30 分钟，使用下拉选项配置
- 单次并行拉取数量默认 2，使用下拉选项配置，范围 1-10
- “关于”右侧只展示项目 GitHub 地址 https://github.com/zhaoolee/garss
管理页是左右布局：
- 左侧为分类列表
- 左侧支持小加号就地创建新类型
- 右侧为当前分类下的订阅源
- 新增和编辑都通过弹窗表单完成
视觉方向应保持接近锤子便签，不要改成通用后台模板风格

订阅源约定

订阅源字段至少包含：
- id
- category
- name
- routePath
- description
- enabled
routePath 同时支持：
- RSSHub 路径，例如 /36kr/newsflashes
- 完整 RSS URL，例如 https://iao.su/feed

自动导入约定

EditREADME.md 是规范化来源，不要手工逐条搬运
同步命令：

npm run sync:editreadme

实现脚本：scripts/sync-editreadme.mjs
输入：仓库根目录 EditREADME.md
输出：
- storage/subscriptions.json
- 仓库根目录 garssInfo.json

修改时避免破坏的点

不要把阅读页和管理页改回上下堆叠主布局
不要移除 category 体系
不要把 EditREADME.md 导入逻辑重新做成依赖模型理解的流程
不要破坏单端口部署假设

Install garss-studio and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "zhaoolee-garss-garss-studio", "kind": "skill", "name": "garss-studio", "description": "这个文件给后续进入 `garss-studio/` 的 agent 使用。", "publisher": "zhaoolee", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "这个文件给后续进入 `garss-studio/` 的 agent 使用。" ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/zhaoolee/garss", "path": "garss-studio/AGENTS.md", "ref": "2208709e4dd932e98789a11cf2b6236ebc27b6f0", "url": "https://github.com/zhaoolee/garss/blob/2208709e4dd932e98789a11cf2b6236ebc27b6f0/garss-studio/AGENTS.md", "key": "zhaoolee/garss/garss-studio/AGENTS.md" } }, "instructions": "# AGENTS\n\n这个文件给后续进入 `garss-studio/` 的 agent 使用。\n\n## 开始前先看\n\n按这个顺序建立上下文：\n\n1. `PROJECT_MEMORY.md`\n2. `README.md`\n3. `src/App.tsx`\n4. `src/styles.css`\n5. `server/index.ts`\n\n## 当前产品基线\n\n- 前端：React + TypeScript + Zustand\n- 后端：Express + TypeScript\n- Docker 外部只暴露一个端口：`25173`\n- 开发环境通过 Vite 代理 `/api` 和 `/socket.io`\n- 生产环境通过 Nginx 代理 `/api` 和 `/socket.io`\n\n## 推荐启停命令\n\n仓库根目录有各平台统一入口，双击后选择启动、关闭、升级、查看状态或退出控制台；执行完一次操作后会返回菜单。控制台入口直接调用 Docker，不依赖宿主机 Node.js。退出控制台或关闭窗口不应停止服务，只有“关闭”动作会停止容器：\n\n```text\nGARSS-MACOS.command\nGARSS-LINUX.sh\nGARSS-WINDOWS.bat\n```\n\n命令行入口：\n\n```bash\nnpm run quick:start\nnpm run quick:stop\nnpm", "cost": { "context_tokens": 518 } }

garss-studio

About

AGENTS

开始前先看

当前产品基线

推荐启停命令

UI 约定

订阅源约定

自动导入约定

修改时避免破坏的点

Install garss-studio and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews