说明版本:2026-09-30(账号收藏兼容更新)。用途:在用户要求更新时,完成来源检查、候选整理、校验与授权范围内的发布。网页说明本身不授予发布权限。此站使用静态 JSON,没有供 AI 在线提交文章的后台 API;收藏登录也不是维护入口。
1. 先读取这些资料
指南:https://xaivier.me/ai/update-guide/
完整可下载手册:https://xaivier.me/ai/update-guide/AI更新说明.md
来源目录:https://xaivier.me/ai/data/creators.json
当前文章与更新日志:https://xaivier.me/ai/data/articles.json
合法主题、方法和类型:https://xaivier.me/ai/data/topics.json
阅读入口:https://xaivier.me/ai/library/
先读取全部三个 JSON,不依赖首页展示的几条文章。以 articles.json 的 records、windowStart、contentUpdatedAt、updateRuns 为当前事实来源;人数、条目数和最近检查时间必须重新统计,不把本文版本日期当作最新内容日期。公开来源目录经过筛选,不含本地待核对象;不能拿公开 JSON 覆盖完整维护源数据。
2. 根据你的访问能力选择交付方式
只有网页访问能力:读取公开资料、检查原文,交付候选包和检查报告。不要尝试向静态网址 POST,也不要声称已经更新网站。
有项目文件访问能力:先读协作项目根目录 AGENTS.md 与《网站整体架构与修改逻辑.md》,定位其中指定的正式维护工程。只在最新维护源的工作副本上修改;保留未公开来源及未知字段。
有维护访问且用户已授权发布:完成检查、备份、部署和公网验收。授权已明确时,不重复要求确认。连接办法和凭据仅从本机维护资料读取,不输出到对话、日志、候选包或网页。
工具或权限不足:完成不受影响的候选整理,说明卡在哪一步、已做什么、由有权限的维护者怎样继续。不要用“需要登录”代替具体诊断;浏览器登录与服务器维护访问是两回事。
3. 检查时间窗口与来源
收录窗口从 2026-08-01 起,截止用户指定日期;未指定时使用本轮北京时间当天,记录具体检查时间和时区。禁止收录截止日之后的文章。允许补收窗口内遗漏文章,日志需注明“补收”。
逐一检查登记来源的 primaryUrl、feedUrl 和已核实 extraUrls。固定旧文章、人物简介或课程首页不能代表最新列表,应继续找官方文章索引或 RSS;找不到则写清实际覆盖范围。
以原始文章、作者公开帖文、官方视频字幕、项目发布页为依据。搜索摘要用于找链接,不能冒充原文。不得绕过付费墙;没读到正文就标注实际范围。
429 限速按工具返回时间节流重试,保留初次失败与最终结果;401/403、登录限制、解析失败、索引无新文分别记录。一次失败不能推断网站停更。未检查到的平台直接写“未覆盖”。
不要求一次穷尽全部历史文章。选择与真实工作有关、信息足够的候选;其余线索写入待查清单。不用人物简介、广告文案或标题推测来填充条数。
逐人至少记录三类渠道:①个人博客/文章存档及 RSS;②已核实社交账号的原帖与作者后续回复;③机构署名文章、项目发布、会议和播客等其他渠道。某类找不到入口时写“未确认”,未读取时写“未覆盖”,不能因人物档案已核实就把内容检查标为完成。机构共用目录按实际入口计数,不把31个人写成31个独立网站。
从本人官网、可信机构署名或交叉证据确认身份;同名账号先排除误配。目录有分页时记录实际页数,社交时间线只返回五条就明确五条,必要时用日期限定检索补找链接。关注作者澄清与更正,不能只看主帖。机构发布与个人发言分清;同文跨平台分享合并为一条,保留主要原文和必要补充来源。
工具“不支持网站”只说明该工具不能读取,可用普通浏览器访问公开原页;不等于原文不存在。个人主页登录受限与某个公开单帖可读应分别记录。不绕过登录或付费限制。额度耗尽停止重复调用,不自动购买,改用可用渠道补读已定位页面,并如实列出尚未完成的检索。
4. 逐条核实、去重、写摘要
核对作者、发布主体、原文标题、永久链接、原发布日期和实际阅读范围。机构或项目发布不自动算作维护者的个人文章;共同作者必须有原文署名依据。
按规范 URL 与已有记录去重:去掉追踪参数和无关片段,保留影响内容的查询参数;检查重定向、同文转载和标题近似项。原文修订通常更新原记录,保留稳定 id,记录变更原因,不再新增重复文章。
publishedAt 是原文发布日期;collectedAt 是本站收录日。活动可用 eventDate,不能把活动日或网页抓取日填成文章发布日期。没有可核实的原文日期或活动日期时留待核验,不进入已发布集合。
采用两层阅读:summary 是列表中的短概要,建议 80–180 字;readingGuide 是详情页的分节导读,目标是让读者理解原文主要思想,而不只是知道“文章谈了什么”。普通长文可写约 600–1200 字,研究或长 FAQ 可写 1200–2500 字乃至更多;按原文信息量决定,不设凑字数门槛。短帖只写其确有的信息。
写前先通读可见正文,长文分块读取,列出原文章节与主线覆盖清单。写后逐项对照:作者要解决什么问题、核心主张与理念、为什么得出该判断、主要论据和案例、具体方法与人机分工、结论及适用限制。保留重要反例、条件与取舍,不只摘开头或最醒目的数字;原文未说的内容标明未说明或省略。
每节用有信息的标题和连贯段落,把观点、理由与例子连接起来。数字需写清样本、口径、归属和时间;作者转述他人案例不能冒充作者实测。本站建议继续放 takeaway,不能混成作者原意。保留原文链接,用自己的中文表述总结,不逐段翻译或转载全文。keyPoints 和 practice 保留兼容;有 readingGuide 时详情不重复展示这两个旧字段。
分清作者事实陈述、作者观点与本站可借鉴点。数字必须保留归属和测量边界;未复现就不写本站已验证。活动信息不写成听课总结;工作流草稿保留 workflowStatus=draft;金融法律观点不改成个性化建议。不转载整篇文章。
5. 数据契约与候选示例
合法标签和 contentType 只从当前 topics.json 读取。sourceId 与兼容字段 creatorId 指向同一个主来源;creatorIds 用于明确共同作者,缺省时兼容 creatorId,显式空数组可表示无个人署名的项目发布;publisherLabel 表示发布主体。
readScope:full_text=读到正文;page_excerpt=仅导语;rss_summary=仅订阅摘要;event_page=活动说明;title_only=仅标题。title_only 不能扩写观点,通常留作候选。本次读到文字不等于观看视频、试听音频或复现案例。
additionalAuthors 是原文明确署名、但尚无独立来源档案的合著者姓名数组,按原样作为署名显示,不伪造来源ID或未经核验的个人主页。supplementarySources=[{label,url}] 保留作者更正、项目 README 等补充原文;这些链接不增加文章条数。仓库现状与原帖日期分别说明,不推断现有功能在首发日已全部具备。
creators.channelChecks=[{category,label,status,note,checkedAt,url?}] 展示本轮渠道检查,category 仅 blog/social/other;status 使用明确的中文结果(已读、部分已读、读取受限、窗口外、截止日后、身份待核、未确认等),note 写实际范围与未完成事项。只给实际检查的人更新 checkedAt;详细历史保存在 updateRuns.sources[].channels,不能用本轮检查日期覆盖此前未重查的来源。
以下为结构示例,不是真实文章,不可直接发布。保留现有记录中未列出的字段;不要用它替换整份 articles.json。
{
"id": "source-topic-yyyymmdd",
"creatorId": "从当前来源目录选择",
"sourceId": "与 creatorId 相同",
"title": "中文标题",
"originalTitle": "原文标题",
"canonicalUrl": "https://example.com/permanent-article",
"publishedAt": "YYYY-MM-DD",
"collectedAt": "YYYY-MM-DD",
"contentType": "article",
"domainTags": ["从 topics.domains 选择"],
"practiceTags": ["从 topics.methods 选择"],
"summary": "仅据实际阅读范围整理",
"keyPoints": ["有来源的要点"],
"practice": "原文流程及可尝试的方法",
"limitations": "未验证事项、适用范围",
"takeaway": "本站提炼的可借鉴点",
"readScope": "full_text",
"sourceEvidence": "检查日期、原文日期依据、署名依据、实际阅读范围",
"featured": 0,
"status": "published"
}只有核验合格且准备写入正式数据的记录才使用 published。候选包的示例和待核项不能混入正式 records。来源身份待核的对象不生成公开 JSON、人物页面或站点地图。来源总数允许随核验结果增长;构建器检查非空目录、唯一 ID 与文章引用,不以固定人数限制新增。新增人物填写 batch、checkedAt 和 sourceNote;机构署名页可用于核实人物,但窗口前文章仅作为档案依据,不生成窗口内摘要。保留已有来源的实际核验日期,不能将新批次检查冒充旧来源全部复核。
6. 每轮都写检查记录,包括零新增
导读契约:readingGuide.version=1;updatedAt 为修订日期;kind 为 full、brief、event 或 limited;scopeNote 说明实际阅读范围;sections 是非空数组,每节包含 title 和非空 paragraphs 字符串数组。full 只用于实际读到正文的记录,短帖可用 brief,活动介绍必须为 event,仅读导语或摘要用 limited,不得靠扩写冒充全文阅读。文字阅读不等于观看媒体。章节标题唯一,按原文主线组织,目录与阅读时长由页面自动生成。
结构示例(仅示意):{"readingGuide":{"version":1,"updatedAt":"YYYY-MM-DD","kind":"full","scopeNote":"已读正文文字,未观看媒体","sections":[{"title":"作者的核心主张","paragraphs":["用自己的话讲清主张及理由。"]}]}}
修订已有导读时保留 id、canonicalUrl、作者关联及未知字段,不改变收藏关联。单独向 editorialRuns 追加 {label, updatedAt, revisedIds, summary};updatedAt 使用带时区时间,summary 记录修订理由、取证范围和限制。内容修订不能冒充新增,也不能冒充所有来源重新检查;真实来源采集继续记 updateRuns,两种日志分开。
在 articles.json 的 updateRuns 追加记录,不覆盖旧日志。sourcesAttempted 是实际检查过的来源数量,sources 每个来源只列一次,note 写实际入口范围、去重或新增结果、错误及未覆盖部分;不能统一写成“已全部检查”。addedIds 列本轮新增稳定 ID,零新增用空数组。
checkedAt 使用带时区的时间,如 YYYY-MM-DDTHH:mm:ss+08:00。contentUpdatedAt 仅在内容记录新增或修订时更新;只有来源检查、没有内容变化时保留它,用 checkedAt 体现本轮检查。仅修改指南不新增内容采集日志。
{
"label": "本轮来源检查 · YYYY-MM-DD",
"checkedAt": "YYYY-MM-DDTHH:mm:ss+08:00",
"sourcesAttempted": 1,
"addedIds": [],
"summary": "本轮无合格新增;覆盖范围和限制如下",
"sources": [{"id": "已检查的来源 ID", "note": "检查了什么、有什么结果、还缺什么"}]
}保留取证材料:候选原文 URL、抓取时间、标题/署名/日期证据、实际可见正文或摘录、失败与重试记录。原始采集全文和审计备份留在非公开工作目录,不随站点发布。
7. 有工程权限时怎样改与发布
正式维护源:tools/ai-practice/data/articles.json、creators.json、topics.json、AI更新说明.md。界面代码:tools/ai-practice/app.js、ai.css;构建器:tools/ai-practice/build.cjs。相对路径以维护手册指定的正式工程为根,不是协作项目根。
在正式工程或等结构工作副本根目录运行 node tools/ai-practice/build.cjs,生成 site/ai/ 并幂等更新 site/sitemap.xml。不要只修改生成后的 JSON,否则下次构建会覆盖。
浏览器 HTTP 预览:检查新摘要、原文链接、日期排序、行业/方法/来源筛选、共同作者、收藏和笔记、导入导出、指南复制与 Markdown 下载。分别检查 1440、390、320 宽度;构建通过不等于视觉或交互通过。
发布前重新比较受影响文件基线;发生并发改动先合并。备份正式源文件与服务器受影响文件,按 AGENTS.md 的暂存、SHA-256 校验、切换和回退办法操作。目录755、公开文件644;资源变化更新缓存版本。
通常仅发布生成后的 site/ai/ 与必要的 sitemap.xml。不要上传整个工程、tools、原始抓取内容、私有来源、备份或凭据。静态更新无需重启服务器或其他服务。
公网检查新路由、JSON、实际页面与交互;核对正式工程、发布包、服务器哈希一致。最后同步两份根目录交接文档,记录真实上线时间、范围、备份和验证边界。失败时只按本次备份恢复受影响内容,防止覆盖他人后续更新。
收藏兼容:保留 /ai/saved/、saved/read/note 和稳定文章 ID。当前收藏、已读与笔记按登录账号保存在服务器,通过 /auth/reading-state 进行版本校验;不能写入公开 JSON。旧 localStorage 键 xaivier-ai-observer-reading-v1 仅作用户主动迁移来源,禁止自动上传或删除。维护静态内容不应调用收藏接口或覆盖账号数据库。
8. 必须交付什么,何时算完成
无发布权限的候选包至少包含:新增记录、修订前后差异与理由、本轮来源检查日志、待核清单、取证索引和交接说明。待核清单不进入公开数据;不要交付一个会覆盖现有全部数据的简化 JSON。
有发布权限的完成报告包含:截止日期、实际检查来源数、新增/修订/去重数量、未覆盖范围、公开链接、验证结果和备份位置。只有公网验收完成才说“已上线”。
零新增也是正常结果:报告检查范围和原因。该流程由用户或维护者触发,不自动创建定时任务,不承诺全网全量抓取。
9. 一段话发给下一位 AI
请更新 https://xaivier.me/ai/ 至本轮北京时间今天(或我指定的截止日)。先读取 https://xaivier.me/ai/update-guide/AI更新说明.md 及其中三个公开 JSON,按全文规则执行。只收录 2026-08-01 至截止日的内容;逐源检查个人博客存档、社交原帖与后续澄清、机构/项目/访谈等其他渠道,在 channelChecks 和更新日志记录实际读取范围、分页限制与未覆盖项;工具不支持时可用普通浏览器补读公开原页,禁止把未查到等同于没有更新。核实原文、署名、日期、阅读范围并去重,保留原记录 ID 和未知字段。新增或修订摘要附原文;列表保留短概要,详情按原文信息量写分节长导读,覆盖作者理念、理由、主要案例、方法、结论与限制。先读完整可见正文并列主线清单,再核查覆盖;短帖不灌水,活动不冒充听课,本站建议与作者观点分开。按 readingGuide 契约保存,修订记 editorialRuns,实际来源检查记 updateRuns,零新增也如实记录。有正式维护工程和已授权发布访问时,读取本地 AGENTS.md 与架构文档,完成构建、备份、发布、公网验收和两份交接文档同步;只有网页能力时交付候选包与待核清单,不声称已上线。不得用公开来源 JSON 覆盖含待核档案的完整维护源,不得公开私人收藏、凭据或原始采集全文。