方法与局限
本轮网页怎么读数据
- 主入口 lightweight/index.json 与 directory.json,契约 0.3.0 加法扩展。
- 完成只认 completion_status 与 count_as_completed;禁止按有 profile、有 README、有旧 154 稿自动计完成。
- 详情页顺序:概述 → 原作者介绍 → 当前具体详情 / 限制 / 来源缺口。勘误单独保留。
- 来源 local_path 是研究机缓存路径,未打进包,页面不生成失效本地链接;只用 source.url。
- 全部 strict_open_source_verified=false 不作严格开源保证。
- 本构建不部署、不改研究事实、不补资料。
机器可读契约
{
"version": "0.3.0-concrete-description-additive",
"scope": "pt779u/pt780u:只做币圈具体描述;M1不完成,旧稿/B1按实际内容逐项评估,全领域暂停",
"old_contract_unchanged": true,
"entrypoint": "lightweight/index.json",
"directory": "lightweight/directory.json",
"paths_relative_to": "delivery-data",
"required_section_order": [
"overview_zh",
"author_intro",
"details"
],
"tiers": {
"L_existing154_study_reuse": "既存154稿提炼,无新增研究,原勘误/引文不确定性保留",
"M1_author_metadata_light_intro": "逐项读作者description/topics后整理;不是README详情/实现核验",
"B1_readme_light_intro": "实际逐项读README/官方文档的简明介绍,不是深架构/代码研究"
},
"fields": {
"author_intro": "作者自述与短摘;metadata类型不可标README引文;外文提供中文要点,来源/快照明确",
"how_to_use_zh": "M1尚未核实用法为字符串;旧稿复用为含business_flow_from_existing_study与deployment_from_existing_study的对象,须标非新核验",
"excerpt_kind": "description_literal为作者简介短摘;topics_literal为无简介时topics原文,不能标成README引文",
"audience_basis": "用户画像若为推断必须显示分析属性",
"license": "SPDX仅旧快照,许可正文未读不能认定严格开源",
"status": "严格按tier/status展示,不把M1标文档完整核验或草稿充深研",
"overview_basis": "目录未写轻简介的记录可能只有相关性判定,不当完整项目介绍",
"B1_author_intro": "readme_literal为已读README短摘,中文要点与能力/限制单列;usage仅文档描述不代表已执行。",
"maintenance_and_license": "目录追加created_cst/last_push_cst/archived_snapshot(仅元数据),及license_spdx_snapshot/license_review_zh/open_source_review_bucket;strict_open_source_verified=false不作严格开源保证。研究目录不是全部OSI项目榜。",
"source_local_path": "来源local_path指研究机缓存,未打进纯数据包,不作网页本地链接;引用应使用来源url。",
"catalog_groups": "default_core_directory为历史相关性保留口径,包含教程/资料;软件主目录用default_software_catalog,资源及二进制运维资料按display_group_zh单列;任何分组都不等于严格开源已核。",
"detail_completion": "新增对象:status仅简短简介/具体详情已完成/详情待补;tier是来源层级而非完成标准。problem_solved_zh与documented_use_case_zh为已逐项复核后的编辑整理,不是作者原话。",
"completion_status": "only_short_intro / specific_details_complete / details_pending互斥;旧154与B1不自动合格;未评估为details_pending,不等于全文无效。",
"count_as_completed": "只有按pt780u具体标准逐项评估合格为true;禁止按有profile、有README或篇数自动计完成。"
},
"no_execution": true,
"no_deployment": true,
"readme_source_index": "lightweight/readme-source-index.json (B1实际文档读取的独立证据索引;旧root238来源索引只管原154稿)",
"concrete_description_standard": "pt780u-concrete-v1",
"completion_count_field": "index[].count_as_completed",
"specific_description_summary": "lightweight/specific-description-summary.json",
"official_document_source_index": "lightweight/official-document-source-index.json (official docs only; README URL/body counts remain separate)"
}
specific-description-summary
{
"standard_id": "pt780u-concrete-v1",
"generated_cst": "2026-11-17T08:59:01.559651+08:00",
"retained_profiles": 2587,
"counts": {
"details_pending": 205,
"specific_details_complete": 91,
"only_short_intro": 2291
},
"readme_briefs": 142,
"individually_assessed_under_new_standard": 112,
"qualified_new_standard": 91,
"reviewed_but_insufficient": 21,
"prior154_studies_and_prior30_B1_requiring_content_review": 184,
"description_target_complete": false,
"all_retained_need_specific_description": true,
"not_code_or_full_documentary_audit": true
}
生命周期通知
- Polymarket/py-clob-client:
README明确archived/no longer maintained/no longer functional,指向Polymarket/py-sdk;不把旧元数据当当前状态
- guildxyz/guild.xyz:
旧React/Next.js界面,当前app在别处;产品新功能不全归公开仓库实现
- flashbots/mev-inspect-py:
作者已deprecated,引向历史MEV数据
- LightCountry/TokenPay:
GPLv3与仅用于学习交流并存,效力未核;无外部数据库不等于无外部API