
工作支持与交付 · 功能说明
同一件工作要反复使用几份会变化的资料时,先由我明确选定2至5份文件及目标,并保存它们本轮的版本。以后补充判断或修改交付物,都能回到这一组来源。
当前情况:已有把选定的2至5份资料建成持续交付包的功能;保存它们的本地数据库从 9 月 29 日起固定在同一个默认位置,不再跟着当时所在的文件夹走。当前输入主要是本地文字和表格文本,不自动读取未选文件。
源码事实核对截至 2026-11-04 09:12(北京时间);历史测试保留各自日期;页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


工作支持与交付 · 功能说明
同一件工作要反复使用几份会变化的资料时,先由我明确选定2至5份文件及目标,并保存它们本轮的版本。以后补充判断或修改交付物,都能回到这一组来源。
当前情况:已有把选定的2至5份资料建成持续交付包的功能;保存它们的本地数据库从 9 月 29 日起固定在同一个默认位置,不再跟着当时所在的文件夹走。当前输入主要是本地文字和表格文本,不自动读取未选文件。
源码事实核对截至 2026-11-04 09:12(北京时间);历史测试保留各自日期;页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

数字截至 2026 年 11 月 6 日

用途与实际影响
每次重新建一套或顺手读同目录其他文件,会让事实和旧成品的版本分叉,也可能把无关资料带入结果。
我可以说:“只用这份立项说明、评审纪要和执行计划建交付包,同目录其他文件不要读。”项目会固定这三份来源,并先交回覆盖范围和冲突。
得到这件工作明确选定的资料版本和可继续的交付包;这一步还不是读完材料、确认事实或生成正式文件。

用途与实际影响
每次重新建一套或顺手读同目录其他文件,会让事实和旧成品的版本分叉,也可能把无关资料带入结果。
我可以说:“只用这份立项说明、评审纪要和执行计划建交付包,同目录其他文件不要读。”项目会固定这三份来源,并先交回覆盖范围和冲突。
得到这件工作明确选定的资料版本和可继续的交付包;这一步还不是读完材料、确认事实或生成正式文件。

目标和选定的2至5份文件都清楚且可读时,保存这一件工作的来源版本和初始判断,再告知下一步。保存来源不等于已经生成文件。
文件数量、内容或标识不合要求时,在加入新事实前指出具体问题;同一工作已有交付包就从原包继续。
无法读文件或保存状态时保留原件。若超时发生在保存之后,先查看原包实际是否已建立,再继续后续步骤,避免重复新建。

目标和选定的2至5份文件都清楚且可读时,保存这一件工作的来源版本和初始判断,再告知下一步。保存来源不等于已经生成文件。
文件数量、内容或标识不合要求时,在加入新事实前指出具体问题;同一工作已有交付包就从原包继续。
无法读文件或保存状态时保留原件。若超时发生在保存之后,先查看原包实际是否已建立,再继续后续步骤,避免重复新建。
数字截至 2026 年 11 月 6 日

说清这件工作要交付什么,并点名持续使用的几份资料。
- 稳定的事项目标
- 本人选定的 2 至 5 份来源
- 本轮真正需要的格式


说清这件工作要交付什么,并点名持续使用的几份资料。
- 稳定的事项目标
- 本人选定的 2 至 5 份来源
- 本轮真正需要的格式

数字截至 2026 年 11 月 6 日


- work-delivery.batch.v1 在写库前校验 package、sources、facts 和 build;预校验不通过时连数据库都不创建。


- work-delivery.batch.v1 在写库前校验 package、sources、facts 和 build;预校验不通过时连数据库都不创建。
数字截至 2026 年 11 月 6 日

- run_batch 的 store._transaction 一起提交新包、来源、事实和审阅,事务里出错整体回滚;提交之后才检查第一次 15.0 秒时间门,超时不会回滚已经提交的事务。
- Package 保存标题、目标、locale、timezone、currency 和 fact revision;默认值为 zh-CN、Asia/Shanghai 与 CNY。
- SourceSnapshot 保存 source key、名称、provider label、版本、字节数、SHA-256 和 supersedes。
- 文本支持 UTF-8(带不带 BOM 都可以)、GB18030 和带 BOM 的 UTF-16;不带 BOM 的 UTF-16 不保证能认。CSV 后续由证据层计算行列。
- 标准 OOXML 输出使用 YYYY-MM-DD 与中国企业常用角色/章节语义,兼顾 WPS 与 Microsoft Office。

- run_batch 的 store._transaction 一起提交新包、来源、事实和审阅,事务里出错整体回滚;提交之后才检查第一次 15.0 秒时间门,超时不会回滚已经提交的事务。
- Package 保存标题、目标、locale、timezone、currency 和 fact revision;默认值为 zh-CN、Asia/Shanghai 与 CNY。
- SourceSnapshot 保存 source key、名称、provider label、版本、字节数、SHA-256 和 supersedes。
- 文本支持 UTF-8(带不带 BOM 都可以)、GB18030 和带 BOM 的 UTF-16;不带 BOM 的 UTF-16 不保证能认。CSV 后续由证据层计算行列。
- 标准 OOXML 输出使用 YYYY-MM-DD 与中国企业常用角色/章节语义,兼顾 WPS 与 Microsoft Office。
数字截至 2026 年 11 月 6 日

- 单个 SQLite 是唯一状态库,没有 watcher、后台同步或第二数据库。命令行和 batch 入口的默认库固定在本机个人资料目录下的 WorkDelivery\
work-delivery.sqlite3,不随当前文件夹或 request.json 所在目录移动;要换位置,只能用绝对路径的 WORK_DELIVERY_DATABASE 环境变量或显式 --database,之后的命令必须指向同一个库。内部存储类自带的旧相对默认值(.work-delivery\ work-delivery.sqlite3)不是给人用的入口位置。


- 单个 SQLite 是唯一状态库,没有 watcher、后台同步或第二数据库。命令行和 batch 入口的默认库固定在本机个人资料目录下的 WorkDelivery\
work-delivery.sqlite3,不随当前文件夹或 request.json 所在目录移动;要换位置,只能用绝对路径的 WORK_DELIVERY_DATABASE 环境变量或显式 --database,之后的命令必须指向同一个库。内部存储类自带的旧相对默认值(.work-delivery\ work-delivery.sqlite3)不是给人用的入口位置。

数字截至 2026 年 11 月 6 日


| 名词 | 意思 |
|---|---|
| Package ID(交付包标识) | 一个持续工作事项的稳定非空身份;不是每次运行重新生成的临时编号。 |
| SourceSnapshot(来源快照) | 一份已选资料在某次导入时的不可变版本;新版本通过 supersedes 关系接续。 |
| Provider label(来源标签) | 说明文件怎样进入;当前只是惰性追溯标签,不是账号连接器。 |
| China defaults(中国工作默认值) | 简体中文、Asia/Shanghai、YYYY-MM-DD、人民币 CNY、中国企业角色和完整 PRD 章节结构;它们影响事实解释与成品,而不是装饰性格式。 |

交付包不是一个文件夹:它只在持续来源关系成立时出现,并只保存本人本次明确选择的 2–5 份资料。



交付包不是一个文件夹:它只在持续来源关系成立时出现,并只保存本人本次明确选择的 2–5 份资料。
数字截至 2026 年 11 月 6 日

- 只读本人明确选择的资料
- 不扫描目录或账号
- 不做任意Office输入解析
- 不建立多人协作或云租户
- 一次性文件不建包
- Package ID 已存在: 任何新事实写入前拒绝,使用原 package 的更新入口。
- 来源少于 2 或多于 5: schema(数据结构) 预校验失败,在建库之前就拒绝,不留下数据库或半成品。

- 只读本人明确选择的资料
- 不扫描目录或账号
- 不做任意Office输入解析
- 不建立多人协作或云租户
- 一次性文件不建包
- Package ID 已存在: 任何新事实写入前拒绝,使用原 package 的更新入口。
- 来源少于 2 或多于 5: schema(数据结构) 预校验失败,在建库之前就拒绝,不留下数据库或半成品。
数字截至 2026 年 11 月 6 日

- 来源在读取中变化: 导入失败;重新选择当前文件,不把两个版本拼成一个快照。
- 新包事务提交后的时间检查失败: 返回时间失败,但该稳定 ID、来源和事实可能已经保存;同一 ID 不能再走一次新建(batch),先核对原包,再从 update-source 等更新入口接续。这和预校验失败不同,不能说成“任何失败都不留状态”。

- 来源在读取中变化: 导入失败;重新选择当前文件,不把两个版本拼成一个快照。
- 新包事务提交后的时间检查失败: 返回时间失败,但该稳定 ID、来源和事实可能已经保存;同一 ID 不能再走一次新建(batch),先核对原包,再从 update-source 等更新入口接续。这和预校验失败不同,不能说成“任何失败都不留状态”。

PRIVATE product contract · user path进入条件、2–5份来源和绕过边界
PRIVATE source · batch.pybatch schema(数据结构)、预校验、稳定ID、事务内新建与固定默认库位置
PRIVATE source · store.pyPackage与SourceSnapshot持久化、文本编码识别
- 重复 ID 在新增事实前拒绝。
- 未选文件不被枚举或读取。
- 中文文件名与 GB18030、带 BOM 的 UTF-16 来源可追溯(测试定义于 2026-10-11 读源码确认,本轮未重跑)。
- schema(数据结构)/example 与 live parser 一致。
- 任意 Office、邮件和在线来源仍为当前 gap。
本模块形成稳定 package 和来源版本;证据、事实和正式质量由下一模块拥有。

PRIVATE product contract · user path进入条件、2–5份来源和绕过边界
PRIVATE source · batch.pybatch schema(数据结构)、预校验、稳定ID、事务内新建与固定默认库位置
PRIVATE source · store.pyPackage与SourceSnapshot持久化、文本编码识别
- 重复 ID 在新增事实前拒绝。
- 未选文件不被枚举或读取。
- 中文文件名与 GB18030、带 BOM 的 UTF-16 来源可追溯(测试定义于 2026-10-11 读源码确认,本轮未重跑)。
- schema(数据结构)/example 与 live parser 一致。
- 任意 Office、邮件和在线来源仍为当前 gap。
本模块形成稳定 package 和来源版本;证据、事实和正式质量由下一模块拥有。
数字截至 2026 年 11 月 6 日
复制 AI 续作说明
项目:先判断是否值得建包,再冻结本人明确选择的来源;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。







