书籍贡献指南

下载 Skill 1.13.1 · 100分评分标准 · 发布与公开案例

# 书籍知识库贡献指南 ## 内容怎么写 用普通人听得懂的自然语言讲清楚：先说核心意思，必要术语先解释，再用具体例子说明；提问和行动要让读者知道下一步怎么做。表达通俗不能改变事实或省略关键条件。完整要求见 CONTENT-STANDARD.md，提交前据此自查，审核也按同一要求执行。 ## 投稿者到底需要提供什么 **必交文件只有一个：符合官方 schema 的 UTF-8 `book.json`。不要求上传 HTML、MD、ZIP、网页截图或知识星球代码。** - JSON 必须包含书籍元数据、1至3个类目、完整目录与逐章解读、全书概要、真实 Deep Research 与引用来源、快速上手与关联书籍、知识图谱、学习地图与方法卡、金句摘录、读后行动清单、模型运行证据和权利声明。作者意图与核心框架写入现有 overview、learning.map_essence 和 units，不自行添加字段。 - 知识图谱必须交付 `graph.nodes` 和 `graph.edges`：概念名称、解释、父级、语义关系和来源编号。无需制作布局、配色、球体、动效、拖拽或网页脚本；没有图谱数据的 JSON 不完整。 - 播客为可选板块；填写时须包含完整的约15分钟双人讲稿、分段、说话人及引用。音频不必提供；已生成且有授权时可在 JSON 填写可播放 HTTPS 地址，上传表单不接收独立音频文件。 - 认领编号在上传表单填写，研究及模型运行证据在 JSON 中提供可审核的记录与链接；本地校验报告和原始回执保留备查，不是额外必上传文件。 **网站负责**：再次校验 JSON、内容审核、独立书籍地址、统一页面框架、手机/电脑适配、知识星球渲染，以及生成 HTML、JSON、MD 内部归档。归档文件不向读者提供下载。普通书籍按阅读权限访问，明确标记的公开案例可免登录。 只有自制 HTML 的投稿者，应先使用官方 Skill 整理为标准 JSON。平台不接收任意 HTML 后自动解析，也不执行投稿者的 HTML/CSS/JavaScript。可选本地预览不影响投稿资格；网页视觉与响应式检查由平台负责。 ## 书籍分类（开始制作前先选择） 每本书先从以下 20 类中选择 1 至 3 个相关类目，再查重认领；认领后核对版本和完整目录，才开始正文制作。 1. 精品小说 2. 历史 3. 文学 4. 艺术 5. 人物传记 6. 哲学宗教 7. 计算机与AI 8. 心理 9. 社会文化 10. 个人成长 11. 经济理财 12. 政治军事 13. 童书绘本 14. 教育学习 15. 科学技术 16. 生活百科 17. 期刊杂志 18. 原版书 19. 医学健康 20. 其他 分类写入 JSON 的 book.category_ids，并与 HTML、MD 保持一致。使用官网分类接口返回的 ID，不自行创建类目。 ## 下载与使用 1. 下载官网提供的完整 Skill 包并解压，保留包内所有文件在同一个文件夹，包括校验脚本与 REVIEW.md。 2. 在支持本地 Skill 的 AI 工具中，按该工具的安装方式导入文件夹；其他工具可将 SKILL.md、schema.json、USAGE.md、REVIEW.md 作为任务附件。上传附件本身不代表模型已执行要求。 3. 先提供书名、作者和 ISBN（选填），要求 AI 读取官网分类，先确定 1 至 3 个类目并写入 book.category_ids，再查重认领。取得有效认领编号后，核对具体版本、列出完整章节目录和总章数，准备有权用于当前研究方式的全书材料；分类与目录明确后才开始正式解读。合法取得材料不等于有权公开传播，公开输出另按 LEGAL-BOUNDARY.md 核验。 4. 要求 AI 建立独立研究任务。可调用「深度研究」技能（deep-research-work:deep-research）、实际使用 ChatGPT Deep Research；若模型没有专用研究模式，但具备网页搜索和读取来源页面的能力，可附上本包的 `RESEARCH-SKILL.md` 与 `RESEARCH-PROTOCOL.md`，要求其完整执行便携研究流程。便携流程必须包含问题拆分、多轮检索、打开并阅读来源、证据台账、反证核查和综合，不能把一次搜索或一组链接标成 Deep Research。保留可由审核人员打开的原始运行记录链接；无链接或不能真实计算报告摘要时，停留在草稿阶段。 5. 逐章检查结果，核对书籍版本、来源和知识关系，输出符合 schema.json 的 JSON，并运行 `node validate.mjs book.json validation.json`；执行细节见 REVIEW.md。example.json 只用于了解结构，不能直接提交。 6. 在官网登录，选择“贡献一本书”，上传不超过 1.5 MB 的 JSON，确认公开分享权限后提交。 7. 系统验证通过后生成 HTML、JSON、Markdown，并进入待审核状态。只有审核通过的内容进入书架；退回原因在“我的贡献”显示。 ## 可以直接使用的任务说明 先读取官网 /v1/wikibook/model-policy，确认实际模型与档位在名单中；研究方法不会放宽模型准入。研究、正文、学习、图谱和核校均保留运行证据，不得降级。请严格按附件 SKILL.md 和 schema.json 处理《书名》（作者、版本）。先读取 https://aiagentworker.cc/v1/wikibook/categories，按本站类目把本书归入 1 至 3 类，在首次说明中给出类目名称、ID 和理由，并写入草稿 book.category_ids。随后调用官网查重并取得本人有效认领编号，重复则停止并告诉我即使制作也无法上传。认领后先核对版本并列出完整章名与总章数，保存到 book.chapter_count 和 chapters 的编号、标题，注明目录来源；不能用主题分组或知识图谱代替原书目录。分类和完整目录明确后，再实际阅读提供的全书材料，生成全书概要精读、逐章拆解、Deep Research 深度解读和概念知识图谱。若没有专用研究模式但能搜索网页并打开来源页，请同时读取 RESEARCH-SKILL.md 和 RESEARCH-PROTOCOL.md 并完整执行；不得用一次搜索或链接列表代替。逐章保留来源定位，保留审核者可打开的真实研究记录；没有运行记录链接、无法真实计算报告摘要、没有当前版本核验或不能运行官方本地校验时，明确标出缺口并保留草稿。最终只在所有条件满足后输出可提交的标准 JSON。不得伪造完成记录、来源、模型身份或授权。 ## 金句摘抄与读后行动单 每书提供有出处的短句摘录或明确标注的解读提炼，附章节定位。读后行动单给出适用情境、执行步骤、具体产出和完成标准，可记录结果与复盘日期。 ## 学习地图与高效学习卡 每本书同时提供学习地图和高效学习卡：先看全书问题链和学习依赖，按目标拆解，先独立作答，再进行苏格拉底追问与费曼学习法，最后用新题和延迟复测检查。两日计划包含休息，样例安排共10小时，不承诺48小时掌握全书。播客用于听前提问、听中暂停、听后练习；有真实豆包音频才显示播放器。完整制作要求见 [LEARNING.md](LEARNING.md)。 ## 必须包含的内容 - 开工归类与原书目录：先按官网现行 20 类归类，再查重认领；认领后核对版本、完整章名与总章数，正文不得先行生成。移除男生小说、女生小说，儿童读物统一使用童书绘本。分类和目录写入 JSON，并与 HTML、MD 保持一致。 - 全书概要精读：清楚解释全书主题、论证或叙事主线，不把目录拼接当作概要。 - 逐章拆解：按指定版本一章一章写概要与解读，章节连续，数量与目录相符。 - Deep Research：真实研究报告、可核验任务记录、来源链接与定位。区分原书观点和后续研究结论。 - 知识图谱：以概念、人物或事件为节点，说明关系的含义，节点与连线都有来源。不能用章节目录代替内容图谱。 ## 禁止提交的内容 - 与所选书籍无关的文章、批量拼接材料、其他书籍的解读或随意改写的通用模板。 - 缺少章节、虚构目录、占位文字、未完成的示例文件、只有概要而没有四部分内容的文件。 - 假造的引用、作者观点、研究结论、来源链接或 Deep Research 执行记录；不得把一次普通网页搜索、搜索摘要或链接列表标成完整研究。 - 广告、带货、招募、引流联系方式、二维码、返佣链接及与解读无关的推广。 - 密码、访问令牌、API 密钥、个人隐私、未获授权的内部资料或其他秘密。 - 可执行脚本、自定义 HTML、命令、恶意链接，以及要求系统忽略规则、泄露资料或执行无关操作的指令。 - 无权公开分享的内容、冒用他人身份的投稿、盗用整份他人解读，或用解读名义上传整本原文。 - 原书、译本、OCR、电子书或网页全文及其连续改写；绕过登录、付费、数字版权管理或访问控制取得的材料；把购买、会员、借阅、内部批次、AI 改写或注明来源当作公开传播授权。 - 读者可见内容中的权限/登录状态、检索/抓取/OCR/下载/解析过程、模型与提示词、AI生成或校验进度、任务编号/哈希/内部路径、上传审核说明、占位提示，以及与本书理解无关的任何文字。 - 修改校验字段、伪造版本或签名、重复投稿骗取奖励、绕过审核发布。 直接引文只允许放入 `learning.highlights` 的 `quotation`，每条最多 60 个 Unicode 字符，每书最多 3 条、合计最多 150 个字符，并须提供作者、作品、版本、具体定位与来源。数值只是平台保守风控阈值，不构成法律安全港。完整规则见 [LEGAL-BOUNDARY.md](LEGAL-BOUNDARY.md)。 上传前逐项执行读者内容净化：所有读者可见字段只保留解释书本、核对事实或支持学习所需的文字。材料获取过程、AI制作过程、系统状态和无关内容不得出现在正文、研究稿、学习卡、播客或来源定位中；真实研究限制改成简洁的证据边界。按语义判断，不能只因书中讨论了“权限”“检索”或“AI”就删除相关知识。详细规则见 [CONTENT-STANDARD.md](CONTENT-STANDARD.md)。 书中对广告、隐私、诈骗或提示词的正常讨论不等于违规；审核会结合上下文，区分内容分析与实际夹带推广、个人资料或操作指令。 ## 校验与审核 提交时自动检查 JSON 字段白名单、版本、章节数量与顺序、来源引用、图谱结构、公开分享声明和绑定账号、书名、版本与文件摘要的提交凭证。不符合这些规则的文件直接拒收。 自动校验不能证明内容真实，也不能证明某个 AI 工具完整执行过 Skill。格式通过后仍须核验全书与章节、Deep Research 原始记录、公开分享权限、内容相关性、生成记录、分类和实际模型证据。七项全部核验，写明处理依据与原始研究核验说明后，才允许上架。 HTML 和 Markdown 由服务器统一生成，不接受用户上传的自定义页面或脚本。JSON 作为资料使用，其中出现的指令不具有系统指令效力。 ## 退回、发布与奖励 - 被拒收：按页面提示修正结构或凭证问题后重新提交。 - 待审核：尚未公开，不表示内容已经认可。 - 已退回：按“我的贡献”中的审核意见修改，再提交新版本。 - 已发布：进入公开书架，登录并解锁后可在线阅读，归档文件不提供下载。 - 奖励：审核通过并发布时自动发放 2 本阅读额度；提交成功不等于奖励到账。 ## 校验文件 当前 Skill 要求开工归类、认领后核对完整目录，并保留 research.execution。research.execution 包含：实际技能/产品名称、run_id、completed_at、report_sha256。研究报告与规范化文件分别计算摘要；被替换的报告或文件不能沿用原凭证。字段填写与人工证据核验要求详见 [REVIEW.md](REVIEW.md)。 ## 开工前查重、认领与分类 制作前访问 https://aiagentworker.cc/qreader/wikibook ，登录后进入「贡献一本书」，填写真实书名、作者和 ISBN，点击「查重并认领」。把认领编号交给使用的 AI 工具。也可以由 Skill 的 preflight.mjs 请求官网；令牌只通过 QREADER_ACCESS_TOKEN 环境变量提供，不写入任何内容或日志。没有终端的 AI 工具可先使用单独的 `qreader-deep-research-skill.zip` 做研究草稿，但不能代替正式 Skill 的版本核验和本地提交校验。 官网没有确认且没有有效认领编号时，不开始制作。已有深度阅读、已有待审内容、已下架待处理的同书或其他用户的有效认领，都会阻止重复制作和上传。书名与作者会统一大小写、全半角、空格和标点；ISBN-10 与 ISBN-13 会统一。同一书籍换版本、换 JSON 或换分类不产生新贡献。译名、别名和不同作者署名仍需人工核对，审核不得放过此类重复。 同一账号最多同时认领 3 本，每次有效 7 天，可续期或放弃。到期后重新认领须重新查重。上传时用认领账号和编号提交。认领编号只是流程记录，不证明模型真的按 Skill 执行，仍须核对原始 Deep Research 任务及内容。 JSON 的 book.category_ids 必须含官网分类表中 1 至 3 个 ID。上传页可调整并重新计算内容摘要，分类必须与正文对齐，审核人员核验。官网 GET /v1/wikibook/categories 返回分类名称、稳定 ID 与使用规则；本站共 20 个类目，不包含男生小说、女生小说，儿童读物使用童书绘本；榜单不作为分类。每本选择 1 至 3 类是本站规则，分类必须与书籍内容对齐。 ## 做一本，读两本 每本新贡献审核通过并发布后获得 2 本阅读额度，提交或格式通过不发奖励。用 1 本额度解锁一本书，手机和电脑共用在线阅读解锁记录，不重复扣除。本人贡献通过审核后直接阅读。额度不足可继续贡献；付费和看广告功能后置，尚未开放。 审核、上架和发放 2 本额度在同一事务中完成，重试不会重复发奖励。内容下架会撤销该笔额度；已经使用的部分从后续奖励抵扣，已有阅读记录保留，下架内容不可读取。后台保留认领、提交、审核、额度发放、解锁与撤销流水。 接口：GET /availability?title=...&author=...&isbn=...；登录后 POST /claims（{book:{title,author,isbn}}）、GET /claims、POST /claims/{id}/renew 或 /release；POST /kit 需 title、package_sha256、claim_id；POST /submissions 仍提交 kit_id、kit_token、package。GET /wallet 查看额度，GET /books/{id}/access 查看解锁状态，POST /books/{id}/unlock 消耗一次额度。读取正文需登录并解锁，完整归档格式不对读者开放，目录搜索可公开访问。 ## 书籍资料与封面 ISBN 选填。认领成功后，要求深度研究主动查找 ISBN 和网络封面，核对同一语言、译本和出版版本；未核实就省略，不能保证每本书都有 ISBN。书名、作者、版本、类目必填。 book.metadata_source_refs 保存书目核验来源编号，指向 research.sources；填写 ISBN 时必须提供。book.cover 包含 image_url（实际 HTTPS 图片地址）、source_ref（封面来源网页编号）、rights_statement（公开展示的使用依据）。封面与使用依据未核实时省略 cover，网站显示文字封面。来源网页必须收入 research.sources，不能只留图片地址。详细步骤见 SKILL.md“书籍资料核验”。 例如给 AI 的任务补充：请在本书 Deep Research 中核对书名、作者、出版版本与 ISBN，查找对应版本的网上封面，保存图片地址、来源网页和展示依据。ISBN 查不到则留空；封面不匹配或无法核验则不冒用。最终仅提交标准 JSON；平台生成 HTML、MD 内部归档。 ## 新增阅读内容 阅读快速上手为必填：说明本书怎么读、阅读步骤及对应章节，并介绍有来源支持的关联书籍与关联理由。 精品语音播客为选填：选择后提供完整约 15 分钟逐字讲稿，按时间段覆盖 900 秒，包含讲述人和引用。音频当前按项目接入的豆包服务提供；没有音频也可提交讲稿，不虚构播放地址。网页有讲稿才显示播客板块，有真实音频才显示播放器。原有四个核心板块保持完整。 ## 网页、全文件与模型门槛 现行 Skill 1.13.0 的 [完整交付清单](DELIVERY.md)、[网页样式](WEB-FORMAT.md)、[安全策略](SECURITY.md)、[法律边界](LEGAL-BOUNDARY.md) 和 [模型准入规则](MODEL-POLICY.md) 均为制作要求。最低基准为 DeepSeek V4 Flash；具体型号与范围见模型准入规则。同代轻量版本不自动准入，仅白名单明确列出的型号例外可用。上传声明符合仅进入待审核，后台另核验实际模型记录，低于门槛或无法核验不发布。 ## 跨类目归类 每本书至少选择1类、最多3类，可跨类目，不限定为单一分类；各类目需有内容依据并在制作说明中分别解释，不要求凑满3类。《思考，快与慢》参考归为心理（认知、判断与决策机制）和社会文化（经济选择、组织决策与社会评价）。不要把模板中的某一类误当成所有书籍唯一归属；JSON的category_ids与书架、HTML、MD一致。 ## 归档后的访问规则 上传和审核仍要求完整章节、研究、图谱、学习内容、金句、行动单及选填播客；以结构化JSON提交后，服务端生成完整HTML、JSON、MD内部归档。归档文件与已完成书籍模板不向读者提供下载，不公开发布到assets或分享ZIP；读者只通过登录和解锁后的网页按板块阅读，不提供正文编辑接口和全文导出；仅开放 CONTENT-STANDARD.md 规定的播客学习稿与单卡训练提示词复制入口。个人学习回答和行动结果不是对原正文的编辑，单独保存在本机。制作Skill及不含正式书籍全文的结构规范可以提供给贡献者。已下载的旧文件无法远程收回；截图、浏览器读取与手工复制无法彻底阻断，不能承诺绝对防拷贝。 ## 开工顺序与更新 先在完整 Skill 目录运行 `node check-update.mjs`；官网版本或文件不一致则获取官网新版、阅读变更，再检查。然后用 `preflight.mjs` 核验模型、查重认领。提交前 `validate.mjs` 再核对官网版本和内容。没有终端的模型可按便携研究 Skill 开展来源研究，但结果仍是待版本核验的草稿；官网不可达或本地校验未运行时，不能宣称新版核验通过或包可上传。 生成 JSON 与同源 MD；只有 JSON 必须上传。HTML 和知识星球由平台呈现。历史样例重排不是重新执行研究，不能补造或覆盖研究回执。贡献者昵称与介绍在上传表单填写，平台绑定当前登录账号，当前不要擅自新增 schema 字段。署名、修订及互动边界见 SKILL.md。 ## 互动与维护 页面署名为“由「昵称」提供并维护”。每个板块可点红心表示有用、提交修改留言；留言须登录，贡献者和管理员可先查看，审核后公开。分享仅复制书籍/板块链接，不附带登录凭据或解锁资格。账户复用 Q-ReaDer 登录；微信仅在实际配置后显示。 ## 用现有 AI 工具贡献与书架奖励 在 WorkBuddy、千问、DeepSeek、Kimi 等工具中，先让 AI 读取完整官方 Skill 及引用规范。支持本地文件的工具可读取解压后的目录；对话工具应通过其实际提供的文件入口附上说明、schema 与必要文件。产品名称不能替代实际模型核验；不能读取规范、核验最新版或开展真实研究时，应提示用户改用具备能力的工具，不能伪造执行结果。网站“贡献一本书”提供可复制任务提示词。 流程：核验官网最新版与模型 → 查重并认领 → 真实研究和内容制作 → 生成同源 book.json、book.md → 官方校验 → 上传 book.json → 等待审核。HTML 由网站生成。不能因为格式校验通过就承诺审核成功。 首次贡献审核通过并上架获得 2 本阅读额度。其他登录账户将这本已发布书籍加入“我的书架”时，贡献者再获得 1 本阅读额度；每个账户对同一本书只奖励一次，本人加入不奖励，移出再加入不重复奖励。奖励归属服务端登记的贡献者账号，不接受投稿文件指定收款人或奖励数额。禁止批量账号刷奖励。贡献下架撤销相应奖励，已使用部分按现有额度规则抵扣。 加入书架不消耗阅读额度，也不自动解锁内容；解锁仍需用户确认使用 1 本额度。当前为网页端账户书架，不声称原生手机客户端书库已完成同步。付费和广告仍后置。 ## 统一内容口径 阅读与投稿必须遵循 [CONTENT-STANDARD.md](CONTENT-STANDARD.md)。它统一七个入口、主题卡片、来源写法、中文双人播客及限定的学习复制范围；不得自行扩展另一套呈现要求。 ## 固定文件名与归类 开工前阅读 [DELIVERY.md 的文件命名与目录规范](DELIVERY.md#文件命名与目录规范)。一本书一个 `书名__作者__认领编号` 目录，固定生成 `book.json` 与同源 `book.md`；仅上传小写 `book.json`。分类写入 `book.category_ids`，从官网20类选1至3类，不靠目录名或文件名推断。上传前核对文件名、UTF-8编码、结构与分类，禁止任意附件代替内容主文件。 ### 1.12.0 正式阅读约束 以 READER-EXPERIENCE.md 为当前页面与权限规范：学习地图为有效付费订阅专享，服务端拦截内容和进度读取；知识星球默认首屏且不增加外置下方展开区；引用页无播客，其他播客讲稿保留开场导语。类别方法与三个专属板块依据 CATEGORY-FRAMEWORKS.json；category_content 在 schema 中提供兼容旧包的结构支持。