Repository navigation
加上个人令牌和数据下载 - #142
Merged
Merged
加上个人令牌和数据下载#142
Conversation
自己的 Agent 用个人令牌调鼠钟的接口,替本人查项目、订阅、记报名;登录后能下载一届的全部项目(总体设计 §13)。这是 Agent 接入的第一步,MCP 服务等定了用哪个库再做。 - api_tokens 表(迁移 0011),归 accounts 模块,只存 SHA-256;范围 read 只能查询,personal 还能订阅、关注、记报名、提反馈和修改申请 - 带 Authorization: Bearer 的请求只按令牌认人。authorize 按令牌的范围放行:成员能读的 GET 算 read,个人操作标成 personal,别的(直接修改、审核、管理、管令牌)只认网页会话;认不出的令牌一律 401,不当成访客 - 每个令牌每分钟最多 60 次请求,超了返回 429 和 Retry-After;通过 Agent 每人 24 小时内最多提 10 条反馈,记录里标「通过 Agent」 - 每人最多 10 个令牌,90 天没用过的失效;冻结了不能用,解冻后恢复;在鼠洞被封禁的马上不能用,刷新时一起作废;有令牌的人也每小时从鼠洞刷新 - 「我的」加「Agent」:生成令牌(只显示一次,附一段发给 Agent 的话,都能一键复制)、列出和作废令牌、下载这一届 - GET /export?cohort=&format=csv|json:CSV 只带总表那几列,UTF-8 加 BOM,像公式的文字保留成文字;JSON 带全部字段、证据和原文链接;和总表一样带 ETag。总表底部也有下载链接 - /llms.txt:鼠钟是什么、有哪些页面、接口怎么认证、怎么下载,以及使用须知,放在 agents 模块;openapi.json 写明个人令牌的认证方式 - 报名时间的写法和类型的名称挪到服务端的 programs 模块,页面和 CSV 共用一份 - api.md 写明令牌相关的错误码;会话的频率限制没有定数,也没有做,不再写
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
关联
路线图 #2 三期的「Agent 接入」,这是第一步:个人令牌、开放 API 的认证和限额、数据下载、
/llms.txt。MCP 服务(/mcp和接 Codex、Claude Code 的命令)要加一个 MCP 的库,等维护者定了再做第二步。改了什么
自己的 Agent 用个人令牌调鼠钟的接口,替本人查项目、订阅、记报名;登录后能下载一届的全部项目(总体设计 §13)。
read只能查询,personal还能订阅、关注、记报名、提反馈和修改申请Authorization: Bearer的请求只按令牌认人。authorize按令牌的范围放行:成员能读的 GET 算read,个人操作标成personal,别的(直接修改、审核、管理、管令牌)只认网页会话,带令牌返回403 web_onlyRetry-After;通过 Agent 每人 24 小时内最多提 10 条反馈,记录里标「通过 Agent」/llms.txt,调接口带这个令牌)、列出和作废令牌、下载这一届GET /export?cohort=&format=csv|json:CSV 只带总表那几列,UTF-8 加 BOM,像公式的文字保留成文字;JSON 带全部字段、证据和原文链接;和总表一样带 ETag。总表底部也有下载链接/llms.txt:鼠钟是什么、有哪些页面、接口怎么认证、怎么下载,以及使用须知,放在 agents 模块怎么验证的
pnpm check:类型检查、lint、格式和 156 个测试通过;pnpm build通过,pnpm db:codegen --verify类型是最新的,pnpm openapi后openapi/crawler.json没变。新测试覆盖:两种范围和只认网页会话的接口;认不出的令牌一律 401(带着 Cookie、在访客能读的接口上也一样),bearer不分大小写;作废、90 天没用、冻结和鼠洞拒绝了的不能用;每人 10 个、每分钟 60 次;通过 Agent 的反馈记下来源、每天 10 条;鼠洞封禁后刷新时作废令牌;下载的 CSV(BOM、像公式的文字)、JSON、304 和访客 401web_only,作废后返回 401;下载的 CSV 带 BOM、表头对;390px 宽下「我的」六个标签和令牌框都排得开Bearer区分大小写;每分钟的计数只增不删;没有复制按钮;openapi.json 没写个人令牌的认证方式;api.md 和/llms.txt漏写了刷新和文件下载;范围的取值写了两份;测试依赖执行顺序last_used_at并发时可能多写一次;CSV 也查了全部字段再丢掉(下载不常用,没测过耗时)。另一个跑检查的 Codex 被它的安全过滤拦下(内容涉及令牌),检查都由我自己跑了影响
GET、POST /me/tokens,DELETE /me/tokens/{id},GET /export;带 Bearer 的请求按个人令牌认人,新的错误码401 invalid_token、403 token_scope、403 web_only、429 rate_limited、429 agent_feedback_limit。网页会话的行为不变scopes列改成一个scope列(personal包含read);api.md 去掉了没有定数、也没做的「按会话限制频率」