外部知识与网页存档

R08 阅读与批注（编码阶段）

列表与新建分离，列表不自动打开第一条资料。详情保持来源、真实隐私与当前任务；元数据编辑按需展开，独立编辑页直接展开。快照、阅读计划、来源变化和关联分区进入，批注专页不重复新建。资料元数据回读不把批注改绑最新快照，显式换版本清空旧锚点。

新增 GET /api/v2/knowledge/items/:itemId/snapshots/:snapshotId/text，仅按需读取已有 text/plain 快照。复用 knowledge:read、file:read、owner 与原文件字节/摘要校验；SECRET 和 LEGACY_ONLY 按已有原文件边界拒绝。纯文本再核对规范化摘要、Unicode 码点数及双换行段落数，响应 no-store，不抓取外链、不返回 HTML。双端正文以纯文本插值展示；键盘或点击可见段落生成现有 PARAGRAPH 零起始锚点，保存前显示版本和位置，手填字符范围保留高级入口。原文只在当前页面内存驻留，换对象、版本或重新读取资料时清除，迟到响应不能覆盖当前对象。

合同限制：现有 normalizeKnowledgeText 只解码 UTF-8 并统一 BOM/换行，HTML 的旧索引仍基于源码；未实现网页正文提取或旧锚点迁移，HTML 仅保留授权附件下载。书籍只是来源类型，没有新增图书全文/页码合同。无存储引用的历史快照不能伪造正文。ANN-001 此批覆盖纯文本段落与任意子串选文：双端输入或粘贴原文片段，展示每处匹配上下文，由用户选择具体出现位置；不会自动取第一次匹配。范围按不可变正文的 Unicode 码点计算，保留中文、emoji、重复文本与原换行；切换快照或重新读正文清除旧选区。超过 50 处匹配提示缩小片段。图片框选仍有明确合同缺口：知识快照没有原图尺寸，批注仅支持 CHARACTER_RANGE/PARAGRAPH，现有附件下载不等于受控图片阅读与坐标合同，未添加假框选。服务边界定向用例与模板检查不替代 HTTP、PostgreSQL、权限变更竞态、截图和真实双端验收。

2026-09-30 移动分页与阅读补齐

MOB-07（2026-09-30）：移动资料列表提供 nextCursor 追加、部分失败重试和已加载标题筛选。列表与详情请求代次分开；后续页失败不清除已有资料，账号切换清除旧内容。列表文字明确已加载数量，未声称全量搜索。纯组件状态测试覆盖第 101 项，真实 H5 返回/滚动和服务端数据仍待验收。

2026-10-02 逐图审计后的界面修复候选

移动知识总览的新建入口进入既有 /pages/knowledge/edit?mode=create。来源变化页缺少资料编号时提示选择资料，不挂载空工作台；有效深链编号传入工作台并用于资料与变化检查读取；前置列表读取失败在深链页面也显示错误及重试入口。

本节记录客户端源码修复；本批浏览器明暗主题、实际点击、读屏、原生设备与真实 API/数据库验收仍为 not_run。不会据样式、模板或状态测试提升领域完成度；既有权限、隐私、幂等、版本及回读合同保持独立。

首批图像复核后的第二批补充

PC 来源变化检查缺少资料上下文时说明前置条件并保留真实资料列表；选中资料后仍进入既有变化检查面板，加载、空列表与读取错误分别保留。

2026-10-03 KNO-001 创建草稿与恢复边界

本批仅修复创建：双端保留六项原始来源草稿、首次 typed 输入和原幂等键，由创建专用 owner 约束 single-flight、当前会话、页面上下文和消费者。提交、严格回读和未知结果期间锁定输入及移动选择器；迟到成功仅在原草稿代次仍匹配时清理既有可重置字段，新草稿及 A→B→A 修改不被擦除。Mobile 编辑页显式传递真实页面生命周期；只在实际 onBackPress 与本页自身导航守卫拦截，不宣称拦截外部程序/所有导航。强制 hide/unmount 保留运行时未决请求并撤销旧消费者，非创建编辑行为不扩大。

未知结果可能已保存；不自动重试、不新建键、不以离开或放弃宣称回滚。显式重试仅在首次真实发送开始的 wall/monotonic 23 小时保守窗口内复用原请求；后端现有幂等保留期是 24 小时。首次 wall 非有限或抛错不发 POST，保留未发原稿与锁，不谎称已发未知；后续时钟缺失、倒退、漂移或过期保持写锁。只有 wall 有限时才允许无 monotonic 首发，之后不能补造安全重试依据。已有回执永久转为严格 GET-only，不因时间届满重发 POST。只有实际原始请求异常的 KNOWLEDGE_SOURCE_INVALID/422、非空 requestId 且此前从无未知发送，才作为唯一可靠首次拒绝释放；后续 403/409/422 不证明先前没有写入。

创建回执要求 KNO-001、revision 1、ACTIVE；继续执行现有 current/revision 检查，再比较完整 16 字段与冻结输入的实际服务端规范化投影，修订原因及 recordedAt 也要匹配。SECRET 无 allowSecret 时存在 URL 遮罩/修订读取限制：保留原输入和回执，明确无法严格确认，不降隐私、不放宽核验。旧消费者、伪造确认、headless/UI 相互抢占不能释放创建；defer、卸载与同运行时重挂载不重置 key/body/时钟。真正换会话清除旧私密状态，硬刷新不提供持久草稿保证。

本节为范围限定的客户端修复记录，实际测试数量、首次失败和环境阻断见配套创建恢复验证记录。fake transport、挂载组件和类型/构建检查不等于真实 HTTP、数据库、浏览器/H5交互或原生设备验收；外部抓取、生产部署亦未据此确认。KNO-002–008、通用控制器与既有默认值不变，Catalog 不晋级。

2026-10-12 Web 已有批注编辑

已有批注的编辑入口先打开独立正文与修改原因表单，用户明确保存后才调用现有专用 PATCH。所属资料、原批注版本、快照、锚点和隐私保持只读；修订号仅在技术模式中按共享中文格式显示，普通模式保留明确上下文，业务快照版本仍可见；来源原文与新增批注草稿不随编辑改变。空值、按 Unicode 码点超限与规范化后未变化的正文不发送重复修订，取消仅清理未发送的编辑草稿。

发送、网络结果不确定和回执核实期间锁定编辑；显式重试复用原命令与现有幂等键，有回执后只执行专用 GET。严格回读检查原绑定和本次正文后才更新列表，错误与冲突保留原稿。SECRET、LEGACY_ONLY 和遮罩正文在此入口只读，不把占位文字提交为批注。未知写入不能以放弃或离开页面声称回滚。损坏回执/信封、非 503 的服务端 5xx、未识别异常及初次网络未知后再被明确拒绝时均暂停重发，保留原稿，提供只读核对最新批注与复制草稿；核对仍遮蔽受限正文，不根据最新状态自动确认原请求或解锁。首次可信领域拒绝也保留可复制原稿及只读核对入口；新版本不自动覆盖原稿。只有实际错误实例、请求标识和精确领域拒绝码才可按未提交恢复编辑。

普通离开要求保存或取消；强制资料、路由、页面区段、会话或 KeepAlive 生命周期变化使旧编辑上下文失效，旧页面不再发起后续保存或核实调用，也不清除新输入；已经交给 API 的排队或进行中请求不能由此保证撤回。换会话后必须重新读取资料与批注才可打开新编辑。旧会话未决批注不再占用新页面的导航和等待状态，允许正常退出；不释放旧通用尝试或声称回滚，迟到 PATCH/GET 不能恢复旧锁或成功。未引入跨卸载恢复所有者、持久草稿或新的安全重试时窗，强制卸载、硬刷新和关闭后不保证恢复未决操作。当前服务端仅保留固定批注修改事件，本批不声称用户填写的自定义原因已写入历史。本次 Web 候选完成严格红测（发现 67 项，旧入口按预期失败 1 项，其余 66 项过滤），当前批注 67 项和相关 Knowledge 160 项全部通过；Web 类型检查、生产构建、同一构建网络策略、中文展示及必要静态门禁通过，文档双次生成结果稳定。宿主节点、路由和传输为替身；浏览器、真实 HTTP、数据库、外部服务及 Mobile 未运行。此前两次测试超时原因尚未确认，历史失败保留；守卫组合断言和修订号展示问题已修复并由当前回归验证，不据后续通过推断历史超时原因已消除。共享构建及进度/合同检查的既有通过结果不冒充本次新执行。Web 已有批注编辑这一限定变更通过上述定向验证；原有 5 项创建与客户端对照用例均由当前回归覆盖并通过，没有放宽断言或上限，不等于真实服务或整个模块完成。Catalog 保持 partial。

Mobile 已有批注编辑（源代码候选，2026-10-12）

已有批注的“编辑批注”先打开独立正文与修改原因表单，不立即写入。原资料、快照业务版本、锚点和隐私固定只读；技术修订号仅随技术模式显示。持续可见标签连接 Uni 输入框，保存使用原生表单提交，取消不改动已保存批注或新增草稿。正文与原因分别限制 10,000 和 500 个 Unicode 码点，未变化或遮罩正文不发送。

首次提交冻结原命令；未知结果保留原稿与写锁，有回执后只执行严格 GET。回读核对原身份、修订、摘要、正文、快照、锚点、隐私与创建时间。损坏回执、服务端异常或未知后的明确拒绝不能证明没有写入，暂停重发；只读核对最新批注不自动确认原请求、不重绑或解锁。受限正文继续遮蔽，可选取复制保留草稿。后端校验原因，但本候选不声称自定义原因已进入历史记录。

批注与详情父页各转发一组 Uni hide/show/unload/back 事件，复用已有创建页的工作台判定，不使用全局导航拦截。普通隐藏仅撤销旧异步消费者，返回后保留未发送草稿的编辑能力，未知请求仅显式沿用原键或原回执继续；上下文切换与卸载撤销旧编辑资格，换会话清除私密草稿、批注与正文，迟到结果不能恢复旧锁或成功。仅当前页面内存保留草稿，不保证强制卸载、关闭或刷新后的恢复；已交给 API 的请求可能仍提交，离开不等于回滚。

已编写实际 SFC、Mobile API/parser 与父页生命周期测试；宿主、会话、Uni 平台及 mobileRequest HTTP 传输使用显式替身；损坏回执测试不代表真实 HTTP 信封解析验证。已完成 80 项编辑挂载用例、129 项相关回归、原实现缺陷复现、共享包构建、生产 Mobile 类型及静态检查；文档保护用例原始结果为 48 项通过。本次状态更正冻结时，最终保护、两次生成及链接复验尚待执行，结果另行记录。H5/真机、真实 HTTP 信封、数据库、外部服务及部署验收未执行。Knowledge 八项仍为 partial，此候选不构成模块完成或部署验收。

2026-10-13 Mobile 来源元数据持续标签

现有来源信息编辑为标题、可选地址、可选发布时间和修改原因提供持续可见字段名，并沿用共享原生命名指令。预填、清空、再次输入和折叠后展开均保留原字段语义；不改变原输入容量、必填规则、日期转换、隐私、版本、PATCH、幂等或严格回读。既有创建与批注编辑不属于本次修改。

本批原输入 H0 2项通过，四个标签测试在基线因缺失独立可见标签失败，同字节候选完整12项通过；未改 Knowledge209项、命名与模板支持28项以及原类型/六扫描通过。测试使用完整 SFC、真实客户端与共享指令，传输为合成响应；不代替浏览器布局、读屏、原生设备、H5/App 完整构建、真实 HTTP、数据库及外部抓取，这些仍为 not_run。最终文档生成在本正文冻结时尚未执行；不据此提升 Knowledge 八项 partial 状态。

2026-10-13 知识时间保真

未改发布时间保留原秒、毫秒和偏移字符串；修改/新增时间复用共享严格设备本地合同，拒绝非法日期滚动和不存在的夏令时时刻。可选发布时间可明确清空；Web 元数据补实际时间输入，Mobile 使用持续标签及格式说明的通用文本。稍后阅读回显真实计划，等待中的新稿、ABA及跨账号确认不被旧回读重新预填。

限定定向证据：双端新时间测试各42项通过；实际 Mobile v3 相关209、标签12、支持28及原类型通过，后续以精确输入绑定复用；Web v5 相关227、原Nuxt类型及六扫描通过。旧测试夹具修复与首次失败均记录在配套证据，旧交互宿主警告保留；不把全部旧测试称作原事件/parser验收。最终文档生成在本正文冻结后另行执行；浏览器、原生设备、完整应用构建、真实HTTP/数据库/Provider与部署未验收，Knowledge八项继续partial。

2026-10-13 Mobile 恢复说明主题

detail 与 edit 入口在原错误、加载和工作台分支外无条件接入既有 MobileThemeProvider；原编号校验、模式、ref 与页面生命周期不变。共享 pending 恢复说明改用 warning 边框、warning-soft 背景和 text 正文，并以既有 surface-muted 作为背景退路；尺寸、间距、字体、业务模板与脚本不变。未知结果、原请求原键、回执 GET-only、创建原稿与时钟、批注保护、归档确认、来源时间、权限、隐私及会话边界保持。

共享工作台九个调用者中 index、archive、change-checks 已有 Provider，本批只新增 detail/edit；snapshots、annotations、reading、graph 的显式 app 偏好、高对比和自选色接线仍未修复。这四页的恢复说明继续使用全局 OS light/dark 的 warning、text 和 surface-muted，未新增全局色板，也不宣称全部 Knowledge 主题完成。其他 error/success 颜色及阅读器命名空间不在本批范围。

实际离线新测试 1,384 项与原测试 263 次共 1,647 次通过（1,642 个唯一文件/完整标题，原参数化重名保持）；两次收集及执行出现次数一致。首轮 15 个原宿主失败保留，经独立复核只补两份测试中实际 Provider 编译/登记，全部原断言和警告策略保持。旧源码对照 477 通过、1,170 失败，其中 1,123 个根/颜色断言与 47 个缺失 Provider 后续 TypeError 分开记录，不夸大为独立业务问题。生产类型、六扫描及 H5 构建通过，310 份产物记录哈希，保留现有构建提示；原类型配置不覆盖新测试。路由工作台探针和 Wot 合成宿主、真实恢复工作台各自证据边界明确，源码对比度算术不代替像素。最终文档在本正文冻结后独立检查；浏览器、读屏、窄屏、App/小程序/真机、真实 HTTP/数据库、外部抓取和部署未运行，Knowledge 八项继续 partial。

2026-10-13 Mobile 剩余路由主题候选

接续已发布恢复主题的明确遗留：annotations、graph、reading、snapshots 在原未就绪、编号错误和工作台分支之外接入既有 MobileThemeProvider。原 view、编号 trim/规范校验、focus、ref 与 annotations 生命周期保持；detail/edit、工作台、共享外观及业务合同不改。历史章节描述其各自发布时状态，本节仅追加当前候选范围。

同字节新测试的基线两次收集131身份一致，完整执行86个H0通过、45个明确缺Provider根的AssertionError，零待办；不以TypeError或导入失败冒充主题缺陷。候选新131、旧Knowledge1647、支持8合计1786执行实例全部通过，对应1781唯一文件/完整标题身份，原5个重复出现原样保留，新131唯一。候选两次完整收集与执行身份顺序一致，原生产类型、六扫描通过；当前原H5构建28.768秒、309产物逐SHA，Sass弃用警告保留。原十套Knowledge测试未修改，Uni/Wot及工作台边界宿主不代替真实业务或像素验收。

首次两个prepare因只读权限继承而失败，发生在Node前，属于环境失败而非业务RED；原件保留。获准的新独立inode staging仅加owner-write，完整源码字节与Git执行位绑定原基线，原controller不改。最终文档另在独立目录执行链接、双次生成幂等与再次链接，结果随同批外部证据记录，不以本节自证。浏览器因既有socket EPERM保持HOLD，不绕过；读屏、设备、真实HTTP/数据库、外部服务、CI、部署及发布未验收，Knowledge八项继续partial。

2026-10-23 本机双端审计与停止重试语义

真实201回执在响应阶段丢失后，独立客户端已读到保存事实，旧停止提示却断言没有生成事实。双端现明确“停止在本页重试”，说明服务端可能已保存，停止不会撤销已提交数据；API、创建和批注编辑恢复协议不变。两项业务RED与双端真实UI复测、Web271、API94及Mobile UTC1778次回归、双端类型构建分别有证据。Mobile默认时区6个旧硬编码UTC失败在原源码对照重现，不改原断言或追认为无条件绿色。

两条合成资料取得创建、元数据、毫秒时间保留、阅读、归档恢复、关系撤销恢复和真实下载证据。网页Provider实际未配置，快照、来源版本、批注和来源变化的主路径前置阻塞。JSON含本批4项当前元数据；CSV/Markdown仅2条资料目录而仍显示4行，此覆盖缺口待改。H5创建返回旧列表亦待改。

只读Hyper-V核对指定事实并回滚；不提升八项partial，不以hash匹配、模拟HTTP、编译或零快照推断完整验收。真实touch、外部抓取、快照批注主路径、全权限/并发、敏感归档、导入和完整恢复未验。中文阶段证据为docs/验证/2026-10-23-知识资料双端审计与停止重试语义修复证据.md。