更新日志
每次版本都写清“改了什么、为什么改、怎么验证”;本页与 /api/changelog
同源,直接读仓库根 CHANGELOG.md,不手抄、不二次编辑。
当前版本
v0.5.59
· 发布于 2026-11-17
· JSON
v0.4.1
2026-10-28
一句话:线上代码进 git 了——0.4.0 整批改动此前只存在于工作区(无版本保护),本批补提交入册;顺带清剿快照遗留的测试代次错配与树内杂物,测试体检恢复可用。
修复(运维闭环,闲时批次 2026-10-28)
- 补提交 0.4.0 线上状态(0e716fe,28 文件 +6310/-3150):pager.js/about 页/kb 强化等自 10-25 上线以来首次进入 git 历史;生产仓从此工作区干净。
- 测试套件对齐(9af4c98):快照内 12 个测试文件是比 app 模块更老的孤本(导入从不存在的符号,收集即错),用主仓版对齐恢复收集;0.4.0 关键回归子集36 passed / 1 skipped(分页合同、pager.js、版本链一致、kb 告警转发、内联 JS 语法)。
- 树内归档:树根 5 个历史 patch、2 个 .bak、5 个 _debug 测试 →
_patch_baks/;旧 backup 目录 → backups/(只 mv 零删除)。
已知边界(留给下个版本)
- 14 个测试文件因主仓↔生产 app API 真分叉(97 文件热修未回流)无法对齐,收敛方案见主仓
docs/部署一页纸-改代码到上生产-20261028.md。
v0.4.0
2026-10-25
一句话:列表页都能翻到底了——生产 /kb 公开来源 33,392 条、文档版本 11,698 条、/capabilities 68 项,原来各自写死一个 limit 就当"分页",用户翻不到底而页面还写着总数。现在统一走一份分页组件,形态按数据量选(长期增长用上下页,卡片流用加载更多),并且"新加列表却忘了分页"会直接让测试变红。
新增
app/web/pager.js:全站唯一的分页实现(无依赖,UMD 导出以便 Node 直接断言)。两种形态:renderPages(上一页/页码/下一页 + 第 N–M 条、共 T 条)与renderMore(加载更多 + 已显示/总数);纯逻辑 paginate/pageList/mergeUnique/moreState。窄屏(< 680px)自动收窗:页码窗口 2→1、上一页/下一页换成箭头,464 宽不再折行。/kb 公开来源分页(服务端,每页 50):33,392 条。原来固定 limit=100,页面写着"共 33392 个来源"却只渲染前 100 条——99.7% 的数据在界面上不存在。/kb 管理员来源分页(服务端,每页 100):同 33,392 条,且原来一次性拉全量、渲染 33,392 个 <tr>,直接是内存炸弹。/kb 文档版本分页(服务端,每页 50):11,698 条,原来看不到 11,648 个版本。/kb 问答留痕(每页 50)、近似重复复核队列(每页 100)分页。/kb 复核留痕、草稿留痕:日志型列表,追加式"加载更多",终止条件看 total 而不是"本页是否为空"(审计记录会被清理,本页空但前面还有是正常的)。/capabilities 能力总库(前端,每页 12):68 项,加载更多 + "已显示 12 / 68";改搜索词或换域时把已显示条数重置回第一页,否则从"全部域"切到只有 5 项的域会看到5 项却没有任何"加载更多",像丢了数据。
变更
GET /api/v1/kb/sources 加 limit(默认 200,上限 2000,0 表示不限)+ offset + total。count 语义由"总数"改为"本页条数",总数改看 total(唯一调用方是 kb.html,已同步)。GET /api/v1/kb/versions 加 offset + total;/kb/reviews、/kb/qa 加 offset + total;/kb/reviews/actions、/kb/drafts/actions 补 total。统一口径:count = 本页条数,total = 总数,offset / limit = 回显请求参数。- 只读接口一律分页:这一版之后,凡"返回列表"的公开读取接口都必须能报出
total 并接受 offset,否则前端无法判断"是不是还有"——分页条只能显示"本页几条",等于没说。
修复
loadSources 的 .then(loadSources):删除来源后回调收到的是 DELETE 的响应对象,一旦函数签名收 page 参数就会把它当页码算,直接 NaN。改成显式 .then(function () { … })。loadQA / rateQA 同款问题(.then(loadQA)),一并改成显式调用。
验证
tests/test_pager_js.py:Node 真跑 pager.js,45 条边界断言——0 条/1 条/恰好整除/整除多一条、页码越界(过大/0/负数)收敛、pageSize=0 不除零、非数字不产出 NaN、页码窗口(少页全列/多页首尾+窗口/两端不留孤立省略号)、去重合并、加载更多终止条件。变异检验 10/10 全杀(ceil→round、<→<=、去掉除零兜底、序号从 0 起、页码不收敛、gap 判据放宽、去重失效、终止条件放宽、窗口上界算错),复原后 md5 一致。tests/test_pagination_contract.py:登记表 + 反向判据。① 每个登记项必须在页面里真的带 offset 或调分页器,判据做在"URL 出现位置前后窗口"里,不做整页搜索(整页搜索时删掉某一处 offset 依然绿,等于没写);② 服务端分页的接口必须在 OpenAPI 里真的暴露 offset——抓的是"前端传了、后端无视"的假分页;③ 页面里出现的带 limit= 的列表请求,既没登记也没豁免 → 直接红(这是"以后新列表忘分页"的兜底);④ 豁免必须写清"为什么不用分页 + 数据上界",写 TODO/暂时 一律红。变异检验 11/11 全杀(逐页删 &offset=、删后端 offset 参数、新增未登记列表、豁免理由改 TODO)。tests/test_inline_js_syntax.py:把每个页面的内联 <script> 抽出来交给 node --check。这些页面没有构建链,JS 写错只会"整块不执行":页面照样 200、HTML 照样完整、pytest 照样全绿,只有人打开控制台才看得见——分页会整个消失而没有任何报错。
v0.3.9
2026-10-25
一句话:把「它怎么改自己」讲清楚——/about 新增第 6 章「自我改进怎么运转」,补齐三条互补主线、三层改进回路、五类执行机制与证据分级;首页与全站导航不变。
新增
/about 新增第 6 章「自我改进怎么运转」(原第 6–11 章顺延为 7–12,锚点 id 全部未变):三条互补主线(Harness² 改善当前任务的执行方式/Dream-RSI 改善探索、预算与停止策略/RRSI 约束修改幅度与过拟合);三层回路(A 任务内适配、B 改进策略演化、C 能力资产发布)及其「共享同一份账本」的前提;五类执行机制(循环/工具使用/观察整理/上下文整理/完成判断)与「先定位跨任务重复失败、再限域、最后验交互」的顺序;四条同预算对照基线(原 H0/best-of-N 与固定重试/仅轨迹反思/拟议组合策略);发现树重放的硬约束(只暴露当前前缀、看不到未来分支质量、未观察动作返回 unsupported、停止后不可再花费)。- 治理章新增「证据分级」:
DEV_TRACE/PROMOTION_DECISION/AUDIT_ONLY 三类访问权限,写明「归档不等于对提案者可见」,且检索、日志、错误响应、经验库守同一套约束—— 只要还剩一条旁路能读到隐藏答案,自我改进就退化成背答案。 - 规划章补入 RSI 工作分组与验收合同:RSI-00…15 映射进原有 159 项台账、不重复计完成,依赖方向(00→01/02→03/04→05、01/02→06→07→08、03/05/08→09、09/10→12→14)与可选支线(13/15)写清;RSA-01…12 的必备字段与几条最见真章的检验(前缀隔离、重放真实性、组合再执行、成本与恢复、不可改的控制边界、真正生效与回退、外部动作幂等)。同时明确「它同时是还没上线的清单」:分组是规划与验收口径,不代表机制已在运行。
- 分级表 L5/L6 补入口:L5 走循环 B(注册版本化提案/探索政策 → 同预算基线对照 → 独立未来任务确认 → 失败保留原策略);L6 要求落在两个独立真实项目上,并留下「能力被再次调用」与「长任务可恢复」的证据。
- 架构表「进化层」补三层循环分工。
变更
/about 页内目录标签收紧,12 项在 1280 宽不再折行(如「分级与当前级别」→「分级与级别」、「自我改进怎么运转」→「改进怎么转」);章节锚点 id 未变,既有外链不受影响。meta description 增补「三条自我改进回路」。
验证
- 本地
tests/test_site_shell.py + tests/test_version_changelog.py 20 passed。 - 新增用例
test_about_page_covers_improvement_loops 做变异检验:删证据访问类别、删回路免责句、删同预算对照、删未上线声明、删重放约束——6 个变异体全部被杀,页面复原后 md5 一致。 - 移动端 464 宽实测无横向溢出;桌面 1280 宽目录单行、三列回路卡对齐。
- 生产部署后逐页核验
/、/about、/kb、/experience、/capabilities、/changelog、/api/docs、/learning 与 /api/version。