Skip to content

PROJECT_AUDIT_2026-10-19.md

Latest commit

 

History

History
140 lines (101 loc) · 20.2 KB

PROJECT_AUDIT_2026-10-19.md

File metadata and controls

140 lines (101 loc) · 20.2 KB
Raw

仓库审计与第一轮改进

审计日期：2026-10-19（Asia/Shanghai）

审计对象：本地仓库工作区，以及通过 GitHub CLI 可读取的公开仓库元数据、Issue、PR 和标签。 范围说明：审计读取本地完整文档树、站点配置、生成脚本、测试、许可和维护文件。开始时工作区已有约 70 个 tracked/untracked 文件改动；这些内容被视为已有工作并按当前版本审阅，不能据此推断作者。审计完成后，应用户后续要求，整套改进提交 1c4d964 已推送到 codex/up-learning-system-audit 并提交 PR #204；PR 尚未合并，没有触发生产发布，也没有修改远端仓库元数据。审计发现和 GitHub 队列数字仍是 2026-10-19 的快照。

执行摘要

已观察到的优势

  1. 这不是尚待搭建的资源清单：它保留从英语学习指南扩展而来的作者经历，同时已将 AI、项目、创业、生活恢复、关系与自我成长放在一条“问题—练习—交付—证据—复测—迁移”的主线上。
  2. 英语、AI 和创业实操已经有明确任务、首版样本、验收或停止条件、延迟复测与适用边界；个人故事也明确是个人经验，不冒充普遍处方。
  3. 中英导航、网页和电子书共用结构化来源；出版 manifest、链接/隐私/双语检查、浏览器回归、许可分层与来源台账，为持续维护提供了可验证的基础。

最重要的问题

  1. 首页原先把一项五分钟起步任务说成完整英语诊断，而四项工作表需要更久，形成承诺与实际动作不一致；本轮已拆成单项基线与完整诊断。
  2. 公开 Issue 表单引用的分类标签并不都存在，安全政策还写着已退役的 master 分支；本轮已对齐现存标签与 main，但现有 28 个公开 Issue 仍没有标签，远端队列需要维护者处理。
  3. 康复内容包含心理健康和危机相关行动建议，现有文献不能替代合格专业人员的内容审阅；此外，仓库 About 描述仍是关键词串，且部分 AI 产品信息已超出维护指南建议的 30 天复核周期。

策略

保留现有书稿主线和个性，不新建并行课程或账号产品。先降低首次行动的门槛、修复高影响事实/链接入口、请专业人士审阅高风险段落；随后用自愿、私密优先的真实使用回执验证入口、练习和复测是否可行。

审计清单

分级表示潜在影响，不表示已测得的实际伤害。成本是维护者工作量的粗估，不包含外部专业人员的排期。

ID / 级别 问题、读者影响与证据 建议 成本 验收方式 / 状态
A1 / P1 首屏曾承诺“五分钟完成英语能力诊断”，入口链接指向四项诊断；工作表任务包含 2–4 分钟音频、600–1000 词阅读、2 分钟口语和 20 分钟写作。读者可能无法在承诺时间内完成。位置：docs/README.md、docs/topics/english-diagnostic.md、docs/templates/english-diagnostic.md。 将起步任务明确限定为四项中任选一项，完整诊断另列。 低，约 1 小时 已修改中英文首页、入口和工作表；新增 Playwright 验收。真实的“5 分钟完成率”尚无用户数据，需后续可用性测试。
A2 / P1 50 个研究来源链接指向 Crossref 的 JSON API 元数据，而不是一般读者容易打开的论文入口；这增加核验主张的摩擦。位置：中英文 docs/**/threads/part-1/{1-understanding,2-vocabulary,3-listening,4-reading,5-speaking,6-writing,grammar}.md。 将 DOI resolver 作为阅读入口；保留论文语境、样本和局限文字。链接替换不等于重新验证全部论文结论。 低，约 1 小时 50 个链接已改为 doi.org；所有源章标注文字更新日期，但 sources_checked 仍保留真实的上次来源核验日。逐条核对引用结论仍未完成。
A3 / P1 心理恢复章节提及危机信号、移除潜在伤害物品、就医和复工等高影响行动；存在 WHO 来源与免责声明，但没有证据表明来源覆盖了文中每项具体操作。位置：docs/threads/part-2/recovery.md 与英文对应页。 在后续发布前由有资质的心理健康或医疗专业人员审读危机边界、具体行动和转介说法；地区热线只从官方渠道核验并标注地区与日期。 中，约 2–4 小时编辑协调，另需专业人员 未修改具体建议。验收应有逐项审阅记录、地区适用说明和中英文一致性检查；这是人工待办。
A4 / P1 GitHub Issue 表单曾要求 content、learning-method、site、translation 等分类，但公开仓库当前仅有 bug、enhancement、broken-link 等标签。只读检查显示 28 个开放 Issue 全部无标签；开放 PR #199 为草稿且状态 CONFLICTING。 Issue 表单使用当前已有的粗分标签；由维护者按完整讨论给存量问题分类、回复或关闭，不对外部队列执行写操作。 本地低；存量队列需约 1–3 小时人工 triage 五份表单及 ISSUE_TRIAGE.md 已对齐现存标签和 2026-10-19 状态快照。远端 28 个问题仍未打标签；#199 未处理。
A5 / P1 GitHub About description 是多个关键词拼接，与双语开放书稿和实践系统定位不一致；本地 CLI 返回的 homepage 与主站一致，topics 也已有合理覆盖。 由仓库维护者在 GitHub 设置中改成一句自然描述，并回读 API 确认。 低，约 10 分钟 未改远端元数据（本任务不执行未授权外部写操作）。候选描述见本报告定位。
A6 / P1 PROJECT_REVIEW.md 的“当前出版文件清单”哈希、字节数和页数与本地 manifest 及出版文件不一致，会削弱出版物可核验性。 以生成 manifest 为唯一数字来源，并交叉核对实际 SHA-256。 低，约 20 分钟 已按 2026-10-19 的 EPUB/PDF manifest 和四个文件本身修正；shasum -a 256 输出与表格一致。
A7 / P2 AI 产品功能信息变化快；ATTRIBUTIONS.md 中部分产品入口最近核验于 2026-08-24，而 MAINTENANCE.md 为政策、安全公告、产品功能建议 30 天复核。过期不等于错误，但下一次复核时限已到。 下一次发布前核对官方入口、地区、套餐与产品功能；不需要的排名/细节删去而不是保留过时断言。 低至中，约 1–2 小时 未声称本次已重核。维护者按 30 天时效逐项更新 sources_checked/来源台账，并抽查正文支持关系。
A8 / P2 工作表数量较多，初次使用可能把精力放在选择模板。另一方面，docs/templates/toolkit.md 已明确说明只选一张、不要全部填写。 先维持现有工具箱；先测新读者任务完成和耗时，再决定是否合并模板。 低，约 1 小时测试设计 目前没有模板使用率或完成率数据。不得把“模板很多”直接当作已证实的主要障碍。
A9 / P2 现有增长内容地图记录的是 Search Console 查询假设，不是排名或点击证据；仅靠内容发布无法证明增长因果。 持续把查询标成假设；由站点所有者基于已验证的 Search Console 导出观察，并同时记录发布日期与其他变化。 低，每月约 30 分钟 GROWTH_CONTENT_MAP.md 已注明假设边界。没有控制台导出或新用户数据，不报告基线和提升幅度。
A10 / P2 当前没有独立的学习成果验证器；但已有学习状态、证据链、英语诊断、AI 评测和读者回执等本地工作表。 先不造网页工具。对单人学习，Markdown 工作表可离线、可复制、无上传默认值；只有真实使用表明跨会话保存或比较带来持续摩擦，才评估静态本地优先小工具。 当前为零；后续 MVP 约 2–4 天 若未来实施：无网络请求、无账号/后端、数据留在用户设备、支持 Markdown/JSON 导出、键盘操作完整；以离线验收和导出往返测试验收。
A11 / P2 新专题声明 Schema.org HowTo，原站点钩子把所有 H2（包括受众、常见问题、下载和下一步）都转换为 HowToStep，结构化数据语义不准确。 将专题页标记为 Article；若未来确需 HowTo，只将真实操作步骤显式列入 schema。 低，约 1 小时 六个中英文专题已改 Article 并删除按标题猜测步骤的转换；浏览器断言确认不再输出虚假的 step。
A12 / P1 资源目录声明 2026-10-14 已核验，但来源台账只记录 Biezou 的 2026-09-02 核验，且 Telegram 频道明确未独立审查，日期与范围超出证据。 以台账为准修正日期，明确区分 Biezou 页面定位与用户提供的频道地址。 低，约 20 分钟 中英文资源页现标注台账最近日期 2026-09-02 和未审查内容；Issue 与测试已同步。
A13 / P2 社交图原校验逐字节比较 Sharp/系统字体栅格输出，并由站点构建重写文件；跨操作系统字体替代可能使 CI 非确定性失败或污染构建产物。 构建只验证已提交图像可读取且为 1200×630 PNG；显式修改模板时才重新生成并人工检查视觉效果。 低，约 1 小时 分享图校验改为格式/尺寸检查，docs:build 不再生成图；本地格式检查通过。CI 的 Ubuntu 实际结果待推送后确认。

误报排除

下载页链接到 ./downloads/pdf-manifest.json 与 ./downloads/epub-manifest.json 在 VitePress 路由下对应公开的 docs/public/downloads/ 资源。经当前站点路径约定和内容检查核对，这不是失效路径，不应为满足静态文件直觉而改坏链接。

产品定位与信息架构

定位判断

候选句“AI 时代的终身学习与实践系统”与现有内容方向相符，但“系统”可能让人预期软件平台或统一课程。项目本质仍是作者持续维护的双语开放书稿和实践工具集，因此建议采用：

一套从英语学习出发，帮助普通自学者借助 AI 学新能力、完成真实任务，并用作品与复测记录成长的双语开放指南。

目标读者

  • 需要英语支持工作、求职、技术阅读或跨文化协作，但不满足于只看分数或背词表的自学者。
  • 面对新工具或新领域、希望把 AI 用于真实任务，同时不愿把判断、隐私与责任外包的人。
  • 有项目/创业想法，需要从问题、用户反馈和交付成本验证下一步的人。
  • 正在经历节奏中断、转变或恢复，希望先做有限且可照顾的行动的人。

生活恢复、关系和个人成长主题仍值得保留；这些读者不必被强行纳入“技能课”用户画像，也不应被承诺统一的成长结果。

核心价值主张

它把作者的真实经历、双语知识路径和可复制工作表放在一起：先从一个具体问题开始，保留个人完成的首版，练习并交付，再通过反馈、延迟复测和新情境迁移决定下一步。与一般链接合集相比，它提供决策方法和验收任务；与普通博客相比，它将经历与可迁移建议区分；与单纯 AI 教程相比，它将模型输出、独立能力和真实结果分开。

主题边界和目录关系

README.md / docs/README.md       30 秒定位、起步行动、目标分流
docs/threads/part-0/             阅读契约、如何进入和回来
docs/threads/part-1/             英语基础能力与求职/协作任务
docs/threads/part-3/             AI 协作、注意力、作品、证据与迁移
docs/threads/practice/           AI 工作流和评测实操
docs/threads/part-2/             作者经历、创业、沟通、关系、选择与恢复
docs/threads/part-4/             日常系统、家庭学习、节律与恢复
docs/threads/part-5/             长期行动、实践复盘与 90 天以后
docs/threads/part-6/             认识、善待和提升自己
docs/topics/                     按搜索意图编排的双语专题入口，不复制平行正文
docs/templates/                  私有优先的任务工作纸与证据记录
docs/resources.md                有边界的第三方入口
docs/threads/archive/            历史文章，保留来路并明确历史语境

共同方法放在阅读指南、实践路线图、学习状态、证据与迁移章节中；具体专题保留自身合适结构。技能训练采用目标、原始样本、实践、验收、失败边界、复测和迁移；故事、观点、资源目录和恢复内容不机械套表。无需删除英语起源、创业/恢复叙事或独立专题；应避免复制长正文、把每个主题做成同构课程，或把下载模板变成强制记录负担。

学习成果验证器决策

现有工作表能记录基线、练习、原始作品、复测差异、错误、迁移和下一轮计划；读者回执还明确默认私有，并允许没有行动或复测的真实记录。当前没有数据证明网页交互比 Markdown 更易用，因此本轮不实施验证器。Issue #190 提出的 AI 跨会话状态问题，可先由可编辑的 learning-state.md 和交接字段回应，不需要把学习数据传给 AI 服务。

后续只有在多位读者实际使用后，持续报告手工保存/平行任务比较造成的具体摩擦，才设计静态本地优先 MVP：选目标和基线、保存作品引用、创建另一题复测、对照验收项、记录错误与下一轮动作。数据默认只在浏览器内存或显式本地文件；明确导出 Markdown/JSON；不建立账号、服务器、遥测或模型上传。验收包括断网可用、刷新/导出边界清楚、导出可读且可再次导入、键盘可操作、无个人数据请求。若需求仍能由一页工作表解决，就继续用工作表。

轻量协作与增长建议

  • 新贡献使用现有双语 Issue Form 和 PR 模板，描述问题、目标读者、具体步骤、结果/可验证证据、适用范围/局限和来源；遇到敏感信息改走 SECURITY.md 私下流程。
  • 新主题先进入增长内容地图，作为待验证查询意图；专题入口链接既有正文与模板，不复制课程。提交前要求中英任务、边界和证据等级一致。
  • 每季度维护者可复查 About、Release、导航、下载物与 GitHub 队列。只在实际读者实践回执或项目可复现证据基础上传播案例，取得当事人同意并做隐私删减。
  • 可尝试作者已有读者渠道发布一篇具体任务示例，标明这是分发实验；追踪点击与自愿完成反馈，不以星标变化单独判断内容效果，不承诺增长数字。
  • 许可已区分正文 CC BY-NC 4.0 与代码 MIT；整体宜称“开放内容项目”，不要把非商业正文许可误称为整个仓库的 OSI 开源软件许可。

不以 Star 为中心的质量指标

默认不增加站内分析、用户账户或个人记录上传。以下指标以自愿任务测试或汇总反馈测量；没有实际数据时不建立虚构基线。

指标 定义与测量 偏差 隐私边界
找到入口成功率 新访客在最多 30 秒内选到合适路径的人数 / 参与者总数；用主持的首页任务测试记录用时和路径。 招募样本偏向已有兴趣者，主持提示会抬高成功率。 只记匿名任务结果，不留姓名、浏览历史或屏幕录像，除非另行明确同意。
首任务完成比例 自愿参与者中，在约定时间完成第一项并保存个人作品的人数 / 开始该任务人数；读者可用回执自报。 自报遗漏、工作/健康容量差异、未完成者更少反馈。 作品留在读者设备；反馈只收去识别化描述。
核心练习完成率 选择某一核心练习后，达到页面验收标准的人数 / 声明开始该练习的人数；分任务报告，不合并不同技能。 练习难度、材料、帮助条件不一致。 不要求提交原始作品，只记录是否达到标准及匿名条件。
延迟复测参与率 完成首版并同意后续回访者中，在 7–14 天后完成平行任务人数 / 同意回访人数。 流失会使留下的样本更有动力；不等于学习保持效果。 联系信息与任务结果分开；优先匿名邀请或由参与者主动返回。
真实成果与有效反馈 经授权、可复现且包含任务/条件/限制的成果回执数；审核是否能改变文稿中的一个决定。 公开故事更容易偏向成功；内容丰富不代表代表性。 公开前单独取得许可并删除可识别信息；拒绝公开不影响反馈被参考。
修复时效 从有效内容错误/失效链接报告到确认、修复或说明的日历时间中位数；分开记录确认与解决。 报告复杂度、节假日和外站短暂故障造成长尾。 不记录报告者非必要身份；私密报告不进入公开数据。
贡献可复现性与审核成本 PR 描述是否含问题、目标人群、步骤、结果证据、限制、来源；维护者记录一次通过比例与审阅耗时。 审核人熟悉度、改动大小不同，不宜跨类型简单比较。 仅汇总协作过程，不收集贡献者私人背景。

30 天路线图

从 2026-10-19 起算；工时为维护者粗估。第一周的本地入口修正已完成，仍需部署后由陌生读者实测。

优先级 / 时间 工作 估算 预期收益 验收标准
P1 / 第 1 周 运行当前改动的内容/站点回归；修复出版文件同步；由另一位维护者在手机与桌面完成中英文入口审阅。 2–4 小时，不含构建依赖准备 防止首页承诺和出版版本再次不一致。 CI 全绿；两种语言的五分钟任务能在五分钟内完成且说明不构成完整等级。
P1 / 第 1–2 周 请合格专业人员审阅心理恢复章节的高风险操作表述。 2–4 小时编辑协调，专业审阅另计 降低读者把个人经验误读为临床处置的风险。 留存可审查的修改/不修改理由、转介边界与双语核对。
P1 / 第 2 周 维护者修正 GitHub About 描述；人工复核 28 个开放 Issue 与冲突 PR #199，按当前队列决定分类、回复、关闭或保留。 1–3 小时 搜索和协作入口与项目现状一致。 API 回读 About；每个被触及 Issue 有清楚的处理理由，未误关隐私/历史讨论。
P1 / 第 2–3 周 抽查学习科学章节中具有数值或因果含义的引用及 DOI 入口；AI 产品入口按 30 天策略复核。 2–4 小时 提高主张到一手来源的可追溯性。 抽查记录列出主张、原始来源、对象/条件、边界和日期；未检查的来源不更新核验日期。
P2 / 第 3 周 进行 5–8 位自愿读者的首页入口任务测试，观察找到路径、五分钟完成和误解；无需系统埋点。 2–3 小时 找到真实新手摩擦，而不是按维护者直觉改导航。 留下匿名任务摘要、失败处和下一项修改；样本只作定性发现，不作总体效果估计。
P2 / 第 4 周 试用读者回执和贡献模板，复核主要工作表是否重复记录同一决策；若无证据，保留现状。 1–2 小时 降低反馈和贡献审核成本。 至少收集任务步骤、作品/结果、限制和来源；记录哪些字段改变了编辑判断。

风险与未解决事项

  • 没有真实新用户任务完成率、延迟复测或迁移数据；本次不把现有方法描述成已验证有效的普遍方案。
  • 已改 DOI 到达入口，但尚未逐条重新核对原文内容、研究设计或每个章节的引文与结论对应关系。
  • 结构化数据现将专题页标为 Article；真实 HowTo 仍需显式步骤来源，未对 Google 富媒体结果作外部验证。
  • 心理健康内容需要合格专业人员审阅；本文审计不是临床评估或安全认证。
  • 外部产品、平台政策和资源页面持续变化；HTTP 可访问不等于内容准确、安全、适用或有背书。
  • GitHub About、现有 Issue 标签与 PR #199 的处理需要有仓库权限的维护者在远端执行；本地文件提交不会自动解决它们。
  • 当前工作区起始时已有大量未提交变更，构建产物可能落后于这些源文件。发布前必须对最终集成树重新生成 EPUB/PDF/工作表与 manifest 并运行完整 CI。