新增迁移50与每5分钟/手动持久同步,API只读本地;同步失败保留、权限阻断、租约与质量失效原子激活。 保留全量稳定分页/固定列,已存质量批量读取,元数据不反复解压长答案;详情安全Markdown与原文。 已运行整仓 make verify、源与副本隔离PG -race、真实只读源及隔离浏览器。 实际同步2525条;固定窗口640条本地中位1.46秒,对照直接源33.10秒。 停worker、缺源凭据、重启API后仍可查询;未更新8088,未修改生产原问答。
36 KiB
Changelog
[Unreleased]
Added
-
问答记录新增“本周”快捷查询,默认展示北京时间本周数据;所选范围自动读取全部记录,校验完整数量后展示,不再需要分页或加载更多。固定展示完整字段,空列不再隐藏,中文原文直接展示、外语未翻译明确标记;保留源端有界传输、取消和失败保护。
-
问答记录新增年份与自然周选择,周次展示起止日期,支持跨年及每年实际周数;按北京时间周一至周日填入查询范围,默认本周且仅查询截至当前的数据。保留自定义时间与原查询按钮,浏览器时区不改变查询边界。
-
问答运营按已确认口径显示知识覆盖率、回答正确率及原始分子/分母、排除数量与构成。使用完整筛选范围和当前有效人工优先结论,精确规则命中的未覆盖可进入覆盖分母;部分覆盖不算完全覆盖,待确认/未评估/失效/不计入按对应指标排除,零分母显示“暂无可计算数据”。返回独立规则版本,AI 模型与绩效范围仍未接入。
-
问答详情支持治理侧人工复核及不可变审计:覆盖、正确性、产品分类、问题类型、根因与理由由管理员明确填写,操作人取登录身份;保存后独立读回复核历史。保留源端判断和自动规则,输入变化使旧人工结论失效,已观测的内容回退不自动恢复旧结论;并发修改冲突、重复请求不重复留档。
-
新增覆盖复检历史、已采集输入快照和完整筛选范围质量数量。批量统计只传指纹与规则命中元数据,原文在读取问答/复核时采集,未采集版本明确提示而非伪造空快照;源事务时点阻止延迟旧扫描回退新输入。基础数量与本期经确认新增的质量比例分开显示;不接 AI 模型、不定义绩效分母、不回写 DobotAI 原问答。
-
「使用统计 → 个人月明细」按北京时间自然月及截止时点展示当前应用可见名册的人员用量(包含本源零记录),支持部门含子部门、区域/待核对状态、姓名/完整部门路径和已有提问/零记录筛选。稳定身份关联去重、不可关联问答单列、过期组织版本阻断翻页;源端姓名可缺失并提示重新同步,不按姓名匹配身份。姓名筛选通过有界只读 POST 请求体传递、不进入 URL,原始员工标识不返回浏览器;名册不作为在职/考核分母,当月进度不作为绩效结论。
-
问答运营按稳定身份关联当前治理通讯录,缺失部门/区域补全并保留源快照及目录/区域版本;空列判断包含完整筛选结果,不混合配置已变化的分页。新增完整时间/关键词范围的使用统计,问答计次、名册内人员去重,跨区/未匹配/身份缺失分列,不输出绩效结论;不回写 DobotAI 原表。
-
「问答运营 → 区域使用」支持管理员从网页发起持久化通讯录同步,重复请求重放、进行中操作合并;按服务器固定范围注册后台执行器,未接线或未检测到心跳时不创建新任务。界面显示真实任务状态、不编造百分比;失败保留旧快照与区域规则,同步完成不覆盖未保存草稿。旧执行器丢失租约后不能激活结果,重启接管和已提交快照的续跑使用原任务。
-
新增治理侧通讯录实时桥接,复用既有周报读取能力,向源端读取真实缺失祖先以补齐部门树;不改旧周报脚本、配置或输出。私有 JSON 与受控子进程执行器拒绝不完整数据、模拟同步、公开文件和异常输出,超时清理临时人员文件。同步默认关闭,容器启用仍需批准的既有周报 SDK/配置及兼容 Python 运行时挂载。
-
区域归属表支持长部门路径换行,避免继承全局不换行规则后将生效区域与归属依据列挤出桌面面板。
-
「问答运营 → 区域使用」区域归属配置切片:按稳定部门 ID 搜索和勾选完整路径,预览去重归属人数,保存版本后重新读取;父部门包含子部门、子部门显式配置优先,多部门跨区域人员单独待核对。预览不写入,过期版本和不完整部门树被阻断。基础使用统计见本期新增,不代表绩效验收;翻译及 AI 评估模型接入按用户要求暂缓。
-
新增治理侧组织快照与区域修订迁移、受确认保护的后台导入命令;不修改 DobotAI 原表或钉钉组织结构。
-
「问答运营 → 问答记录」首个开发切片:在现有导航中查看 DobotAI 2.0 钉钉问答,支持半开时间范围、原问题关键词、稳定游标分页和完整详情;按整个筛选结果隐藏空列,反馈聚合不放大问答条数。外语翻译、AI 评估尚未接入,不标为第一阶段完成。
-
治理侧重新检查答案:包含
暂无已发布即未覆盖,引用和源端 covered 不能抵消;未命中仍待评估,源端规则单独保留作对照。独立只读源默认关闭、租户后端固定、管理员会话鉴权,源故障不回退治理主库;安全告警明确保留 TEMP/TLS 尚未整改状态。 -
「版本记录」页(一级入口):只读时间线追踪远端 main 可达的全部提交(含合并提交与已并入 main 的侧分支提交),按提交时间倒序显示标题/正文、
[正式版本] / [开发版本] / [历史提交]徽标、短 SHA、提交内变更记录与[查看提交]/[查看 tag];支持「全部 / 正式 / 开发 / 历史」筛选与游标翻页,窄屏单列。 -
新增只读接口
GET /api/v1/build-info(当前运行产物的构建身份)、GET /api/v1/version-history(快照游标分页,不返回伪造的 total)、POST /api/v1/version-history/sync(仅管理员手动同步,并发同步复用同一作业)。 -
新增迁移
000046_version_history(提交记录 + 同步状态):commit_sha是唯一身份,版本号不是唯一键 —— 两个提交算出同一个开发号时各占一行,用 SHA 区分。 -
「当前运行」只认运行产物注入的完整 SHA 精确匹配:匹配到就标该条;开发构建显式标注"开发构建";拿不到标识就显示"当前运行版本未知",不拿最新 main 或最新 tag 顶替;CI 成功不等于已部署。
Changed
-
「系统设置 → 数据源配置」收敛成两个入口:dws 导入(按当前钉钉账号列出可访问的知识库与钉盘空间)与 PP 导入。AList(已由钉盘文件替代)、静态登记的钉钉知识库、本地手工导入与 PP legacy 都不再出现在这一页;已接入的这类来源用归档下架(
POST /api/v1/source-connections/{id}/archive,管理员、幂等,带写意图头与幂等键):从列表、来源与目录、计划刷新与手动扫描里消失,目录快照、发布记录与审计数据一行不删。恢复用…/restore(保持停用、不自动带回调度),或让 dws 重新登记同一来源 —— 钉钉空间登记是确定性 ID +ON CONFLICT,原地复活同一行、不产生重复。卡片上新增「去掉来源」按钮(管理员,带确认弹窗)。 -
迁移
000047_source_connection_archive:新增archived_at/archived_by与只覆盖未归档行的部分索引;列表、目录、计划刷新、手动扫描四类查询一律排除归档行(漏一条就等于入口没去掉)。 -
「系统设置 → 数据源配置」默认只列 PP 资料与「可加入的来源」:AList 来源(已由钉盘文件替代)与静态登记的钉钉知识库来源(改为按当前钉钉账号发现)不再默认列出,收进「显示 AList/钉钉知识库来源(N)」折叠开关 —— 来源一个都没删,展开后照旧可改刷新周期与启停,「来源与目录」里的内容不变。手动导入来源(本地手工验收)不在这次范围内,照旧显示。
Fixed
-
修复通过带端口的 HTTP 地址访问问答运营时,正常同源操作被误报“拒绝跨站配置请求”:网页代理保留原始 Host 及端口,使缺少 Fetch Metadata 的浏览器也能正确执行 Origin 校验。保留后端跨站、异端口、伪造转发头与缺失操作意图的拒绝保护。
-
登记钉钉知识库失败(HTTP 409
space_registration_conflict)的真实原因与修复:source_connections.name有唯一约束,而早期路径登记的钉钉来源(base_url为空、id 与 dws 现在推导的确定性 id 不同)被归档后仍占着名字槽位 ⇒ 重新登记时 INSERT 撞唯一约束;处理器又把所有存储层错误都翻译成同一个 409,真实原因被吞掉(线上只能看到一个无细节的错误码)。现在:① 同名来源已归档时,把它改名腾位(…(已下架 · <短ID>),归档行不显示、数据与审计一行不动);② 同名来源仍在使用时返回space_name_conflict+ 可行动提示(先「去掉来源」);③ 同一登记键指向别的空间且该行仍在用时返回space_identity_conflict(已归档的行则允许就地改写 —— 这就是"去掉后再用 dws 重新获取");④ 其余内部故障改回 500space_registration_failed,不再伪装成冲突;前端优先显示后端hint,并为这两个新码补了中文说明。 -
前端入口与静态资源的缓存语义("新功能看起来没上线"与"页面偶尔裸奔/空白"的根因):
index.html此前没有缓存头,CDN/浏览器按启发式缓存它 ⇒ 页面会一直停在旧构建上(实测被腾讯云 EdgeOne 卡住:源站已是新包,公网入口仍发旧包)。现在index.html每次回源校验(no-cache, must-revalidate);- 带内容哈希的
/assets/长缓存(immutable),但未命中时先回退到"上一版构建的资源"目录、再 404(deploy/legacy-assets由部署脚本在每次重建前落盘并只读挂载):CDN/浏览器仍持有旧index.html时,它引用的旧 JS/CSS 依旧能取到 ⇒ 不会出现"JS 404 白屏"或"CSS 404 只有文字没样式"; - 明确 404 时不再回退成
index.html(否则浏览器把 HTML 当 JS 执行,报一堆语法错误)。
-
上线前护栏 + 事故复盘:
scripts/deploy-api-web.sh现在先校验.env的键值形状(值里再出现KEY=或键名不合法 ⇒ 拒绝上线),配置校验失败时也会给出"两行粘成一行"的线索。事故:.env最后一行没有结尾换行、又被追加新键 ⇒ 两行粘成一行 ⇒VERSION_HISTORY_GITEA_BASE_URL变成非法值 ⇒ api/worker 按设计拒绝启动、崩溃重启(平台整体不可用)。已修数据、加护栏、加回归用例。 -
「版本记录」页的链接改为抓取与链接分离:抓取仍走配置的(内网)地址,页面上的「查看提交 / 查看 tag」用
VERSION_HISTORY_LINK_ORIGIN(公网 origin)拼 —— 原先两者共用内网地址,内网外的浏览器点开是空白;另外 tag 记录原先不带链接(空href点下去没反应),现在补上链接、没有链接就不渲染该按钮。
Security
- 版本记录同步匿名只读远端仓库(不使用任何凭据),来源限配置里批准的 origin 与固定仓库:拒绝任意 URL、拒绝跨主机重定向,单个响应设大小上限与超时、5xx/429 才有退避重试。
- 提交正文与变更记录一律按纯文本渲染(不产生 HTML/脚本注入面);页面不含打 tag / 发布 / 部署入口;同步动作仅管理员可用,服务端再次判角色。
版本号的唯一来源就是本文件顶部那条已发布版本。 不放
VERSION文件、不把版本写进源码常量。正式版本用注释 tag
vX.Y.Z(由人批准后创建):CI 只核验「tag 的版本 == 它指到那个提交里的 版本记录」,不自动升版本、不打 tag、不发 Release。日常改动写进[Unreleased]; 不要求每个提交都改本文件 —— 有使用者可见的变化才记,其余走提交信息与档案。python3 scripts/version.py --identity # 构建身份:release_version / build_kind / commit_sha / display_version / built_at python3 scripts/check_changelog.py --tags # 结构 + tag 一致性(无正式 tag 不判红)小节只认四类(分类可省略,但不要空栏目):
### Added/### Changed/### Fixed/### Security。 破坏性变化写在### Changed里、以**破坏性**开头,并链接发布文档(见docs/RELEASE_RUNBOOK.md)。过程记录(审查轮次、命令输出、逐条修正明细)不入本文件:归档在
docs/archive/, 未合并事项在docs/BACKLOG.md。版本怎么走(两行就够): · 正式版本 = 下面那条
## [x.y.z] - 日期,是发版事实,由人批准后打注释 tagvX.Y.Z; · 开发版本自动递增 =<正式版本的主.次>.<自那个 tag 以来的提交数>(正式0.1.0之后第 12 个提交 =0.1.12),由scripts/version.py从 git 算出来;开发交付的独立说明写入本文件“开发快照”章节,并打snapshot/vX.Y.Z注释标签 ⇒ 每次开发交付均可追溯, 但"发布版本"仍然只能由人定(CI 不会自动升版本、不会打 tag)。
开发快照 snapshot/v0.1.28 - 2026-10-18
Added
- 问答运营新增持久本地副本,每 5 分钟后台同步并支持立即同步;列表、详情、检索、质量范围和使用统计改为读取本地数据库。
- AI 答案详情提供安全 Markdown 预览与原文查看,支持表格、代码块和链接;不执行原始 HTML,外部图片默认不请求。
Changed
- 增加治理侧问答副本表与同步状态;同步由普通 worker 执行,使用独立只读源连接,源失败保留最后成功副本,权限校验失败阻断读取。
- 副本激活与质量输入变化的复核失效同事务提交;同步持久去重、租约校验及重启恢复不改变源问答或现有生产写入。
Fixed
- 本地读取不再逐条重复写质量留档或解压完整范围长答案来统计字段,保留完整列、输入版本一致性和真实缺失值。
- 初次观察即已同步完成时自动重查列表,避免较早的首次未同步错误一直停留。
开发快照 snapshot/v0.1.27 - 2026-10-18
Fixed
- 并行分支存在同号开发提交时,历史变更说明与补记标签计划按完整 SHA 选择,不再被前一条同号记录遮蔽;不强改推导版本号或移动既有标签。
开发快照 snapshot/v0.1.26 - 2026-10-18
Fixed
- 版本记录收录已交付开发快照与当前运行提交,不再只同步 main;开发版本显示对应的独立变更说明。
- 修复同步重复返回旧已完成任务:进行中同步合并,完成后允许新一轮同步。
- 构建启动后自动请求版本同步;部署后独立读回当前完整 SHA、开发标签与变更说明,缺失时不宣称交付完成。
Added
- 增加开发快照计划、显式发布及远端读回工具;历史说明按原提交补记,正式 tag 与 Release 保持独立授权。
开发快照 snapshot/v0.1.25 - 2026-10-18
目标提交:90901a4458054aca721047c9a2896f2130d46b5c
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 问答记录新增“本周”快捷查询,默认展示北京时间本周数据;所选范围自动读取全部记录,校验完整数量后展示,不再需要分页或加载更多。固定展示完整字段,空列不再隐藏,中文原文直接展示、外语未翻译明确标记;保留源端有界传输、取消和失败保护。
开发快照 snapshot/v0.1.24 - 2026-10-18
目标提交:3566f208e0e15fdec2cc98c29f93c46f5f7c91ca
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 问答记录新增年份与自然周选择,周次展示起止日期,支持跨年及每年实际周数;按北京时间周一至周日填入查询范围,默认本周且仅查询截至当前的数据。保留自定义时间与原查询按钮,浏览器时区不改变查询边界。
开发快照 snapshot/v0.1.23 - 2026-10-18
目标提交:2ea2111420e501fec37e0ea0c4bcd3cd8c866403
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Fixed
- 修复通过带端口的 HTTP 地址访问问答运营时,正常同源操作被误报“拒绝跨站配置请求”:网页代理保留原始 Host 及端口,使缺少 Fetch Metadata 的浏览器也能正确执行 Origin 校验。保留后端跨站、异端口、伪造转发头与缺失操作意图的拒绝保护。
开发快照 snapshot/v0.1.22 - 2026-10-18
目标提交:828c2c5fa0d4e3e0eee3987085a4d782872f7e95
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 问答运营按已确认口径显示知识覆盖率、回答正确率及原始分子/分母、排除数量与构成。使用完整筛选范围和当前有效人工优先结论,精确规则命中的未覆盖可进入覆盖分母;部分覆盖不算完全覆盖,待确认/未评估/失效/不计入按对应指标排除,零分母显示“暂无可计算数据”。返回独立规则版本,AI 模型与绩效范围仍未接入。
- 新增覆盖复检历史、已采集输入快照和完整筛选范围质量数量。批量统计只传指纹与规则命中元数据,原文在读取问答/复核时采集,未采集版本明确提示而非伪造空快照;源事务时点阻止延迟旧扫描回退新输入。基础数量与本期经确认新增的质量比例分开显示;不接 AI 模型、不定义绩效分母、不回写 DobotAI 原问答。
开发快照 snapshot/v0.1.21 - 2026-10-17
目标提交:4b3aaff3219e78ae3dfd5d12ba36f82e323a21ba
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 问答详情支持治理侧人工复核及不可变审计:覆盖、正确性、产品分类、问题类型、根因与理由由管理员明确填写,操作人取登录身份;保存后独立读回复核历史。保留源端判断和自动规则,输入变化使旧人工结论失效,已观测的内容回退不自动恢复旧结论;并发修改冲突、重复请求不重复留档。
- 新增覆盖复检历史、已采集输入快照和完整筛选范围质量数量。批量统计只传指纹与规则命中元数据,原文在读取问答/复核时采集,未采集版本明确提示而非伪造空快照;源事务时点阻止延迟旧扫描回退新输入。仅提供数量,不接 AI 模型、不定义质量率或绩效分母、不回写 DobotAI 原问答。
开发快照 snapshot/v0.1.20 - 2026-10-17
目标提交:9556db1ef01add21064553f64be6a7e25f838e9e
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 「使用统计 → 个人月明细」按北京时间自然月及截止时点展示当前应用可见名册的人员用量(包含本源零记录),支持部门含子部门、区域/待核对状态、姓名/完整部门路径和已有提问/零记录筛选。稳定身份关联去重、不可关联问答单列、过期组织版本阻断翻页;源端姓名可缺失并提示重新同步,不按姓名匹配身份。姓名筛选通过有界只读 POST 请求体传递、不进入 URL,原始员工标识不返回浏览器;名册不作为在职/考核分母,当月进度不作为绩效结论。
开发快照 snapshot/v0.1.19 - 2026-10-17
目标提交:56b8cabed9213911b6beb4aeaac9baa22e872a00
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 问答运营按稳定身份关联当前治理通讯录,缺失部门/区域补全并保留源快照及目录/区域版本;空列判断包含完整筛选结果,不混合配置已变化的分页。新增完整时间/关键词范围的使用统计,问答计次、名册内人员去重,跨区/未匹配/身份缺失分列,不输出绩效结论;不回写 DobotAI 原表。
- 新增治理侧通讯录实时桥接,复用既有周报读取能力,向源端读取真实缺失祖先以补齐部门树;不改旧周报脚本、配置或输出。私有 JSON 与受控子进程执行器拒绝不完整数据、模拟同步、公开文件和异常输出,超时清理临时人员文件。同步默认关闭,容器启用仍需批准的既有周报 SDK/配置及兼容 Python 运行时挂载。
- 「问答运营 → 区域使用」区域归属配置切片:按稳定部门 ID 搜索和勾选完整路径,预览去重归属人数,保存版本后重新读取;父部门包含子部门、子部门显式配置优先,多部门跨区域人员单独待核对。预览不写入,过期版本和不完整部门树被阻断。基础使用统计见本期新增,不代表绩效验收;翻译及 AI 评估模型接入按用户要求暂缓。
- 「问答运营 → 问答记录」首个开发切片:在现有导航中查看 DobotAI 2.0 钉钉问答,支持半开时间范围、原问题关键词、稳定游标分页和完整详情;按整个筛选结果隐藏空列,反馈聚合不放大问答条数。外语翻译、AI 评估尚未接入,不标为第一阶段完成。
开发快照 snapshot/v0.1.18 - 2026-10-17
目标提交:cc4906b6a9f33683a5c0017d83b24d96d5c997b1
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 「问答运营 → 区域使用」支持管理员从网页发起持久化通讯录同步,重复请求重放、进行中操作合并;按服务器固定范围注册后台执行器,未接线或未检测到心跳时不创建新任务。界面显示真实任务状态、不编造百分比;失败保留旧快照与区域规则,同步完成不覆盖未保存草稿。旧执行器丢失租约后不能激活结果,重启接管和已提交快照的续跑使用原任务。
- 新增治理侧通讯录实时桥接,复用既有周报读取能力,向源端读取真实缺失祖先以补齐部门树;不改旧周报脚本、配置或输出。私有 JSON 与受控子进程执行器拒绝不完整数据、模拟同步、公开文件和异常输出,超时清理临时人员文件;问答组织关联尚未接入。同步默认关闭,容器启用仍需批准的既有周报 SDK/配置及兼容 Python 运行时挂载。
- 「问答运营 → 区域使用」区域归属配置切片:按稳定部门 ID 搜索和勾选完整路径,预览去重归属人数,保存版本后重新读取;父部门包含子部门、子部门显式配置优先,多部门跨区域人员单独待核对。预览不写入,过期版本和不完整部门树被阻断。当前不是使用/绩效统计验收,翻译及 AI 评估模型接入按用户要求暂缓。
开发快照 snapshot/v0.1.17 - 2026-10-17
目标提交:6adfdcdd4fe0e5c35018bf0e4857c203dd24e5d1
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 区域归属表支持长部门路径换行,避免继承全局不换行规则后将生效区域与归属依据列挤出桌面面板。
开发快照 snapshot/v0.1.16 - 2026-10-17
目标提交:5874134e049b0896a202b41d9d400d1be5386f89
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 新增治理侧通讯录实时桥接,复用既有周报读取能力,向源端读取真实缺失祖先以补齐部门树;不改旧周报脚本、配置或输出。私有 JSON 与受控子进程执行器拒绝不完整数据、模拟同步、公开文件和异常输出,超时清理临时人员文件;网页触发的后台同步队列及问答组织关联尚未接入。
开发快照 snapshot/v0.1.15 - 2026-10-17
目标提交:dab74b706b5b87da3ecb71a8e0f6b6caa5fba4ad
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 「问答运营 → 区域使用」区域归属配置切片:按稳定部门 ID 搜索和勾选完整路径,预览去重归属人数,保存版本后重新读取;父部门包含子部门、子部门显式配置优先,多部门跨区域人员单独待核对。预览不写入,过期版本和不完整部门树被阻断。当前不是实时通讯录同步或使用/绩效统计验收,翻译及 AI 评估模型接入按用户要求暂缓。
- 新增治理侧组织快照与区域修订迁移、受确认保护的后台导入命令;不修改 DobotAI 原表或钉钉组织结构。
开发快照 snapshot/v0.1.14 - 2026-10-17
目标提交:fd04bf7886aa4eba68b247dd7c1092894a5282da
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 「问答运营 → 问答记录」首个开发切片:在现有导航中查看 DobotAI 2.0 钉钉问答,支持半开时间范围、原问题关键词、稳定游标分页和完整详情;按整个筛选结果隐藏空列,反馈聚合不放大问答条数。外语翻译、AI 评估、人员区域映射尚未接入,不标为第一阶段完成。
- 治理侧重新检查答案:包含
暂无已发布即未覆盖,引用和源端 covered 不能抵消;未命中仍待评估,源端规则单独保留作对照。独立只读源默认关闭、租户后端固定、管理员会话鉴权,源故障不回退治理主库;安全告警明确保留 TEMP/TLS 尚未整改状态。 - 「版本记录」页(一级入口):只读时间线追踪远端 main 可达的全部提交(含合并提交与已并入 main 的侧分支提交),按提交时间倒序显示标题/正文、
[正式版本] / [开发版本] / [历史提交]徽标、短 SHA、提交内变更记录与[查看提交]/[查看 tag];支持「全部 / 正式 / 开发 / 历史」筛选与游标翻页,窄屏单列。
开发快照 snapshot/v0.1.13 - 2026-10-14
目标提交:c1d49adb622f3bf18e51bddb415795a894ed227e
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Changed
- 补三Agent交接闭环工作流(状态机、快照tag与验收模板)。
开发快照 snapshot/v0.1.12 - 2026-10-14
目标提交:9a8a3e77956149d116360bbb561efd67e20fb062
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Fixed
- 登记钉钉知识库失败(HTTP 409
space_registration_conflict)的真实原因与修复:source_connections.name有唯一约束,而早期路径登记的钉钉来源(base_url为空、id 与 dws 现在推导的确定性 id 不同)被归档后仍占着名字槽位 ⇒ 重新登记时 INSERT 撞唯一约束;处理器又把所有存储层错误都翻译成同一个 409,真实原因被吞掉(线上只能看到一个无细节的错误码)。现在:① 同名来源已归档时,把它改名腾位(…(已下架 · <短ID>),归档行不显示、数据与审计一行不动);② 同名来源仍在使用时返回space_name_conflict+ 可行动提示(先「去掉来源」);③ 同一登记键指向别的空间且该行仍在用时返回space_identity_conflict(已归档的行则允许就地改写 —— 这就是"去掉后再用 dws 重新获取");④ 其余内部故障改回 500space_registration_failed,不再伪装成冲突;前端优先显示后端hint,并为这两个新码补了中文说明。
开发快照 snapshot/v0.1.11 - 2026-10-14
目标提交:2c7265efc47a2cd6b324bf278fa5ddb0c4a9fe57
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Changed
- 「系统设置 → 数据源配置」收敛成两个入口:dws 导入(按当前钉钉账号列出可访问的知识库与钉盘空间)与 PP 导入。AList(已由钉盘文件替代)、静态登记的钉钉知识库、本地手工导入与 PP legacy 都不再出现在这一页;已接入的这类来源用归档下架(
POST /api/v1/source-connections/{id}/archive,管理员、幂等,带写意图头与幂等键):从列表、来源与目录、计划刷新与手动扫描里消失,目录快照、发布记录与审计数据一行不删。恢复用…/restore(保持停用、不自动带回调度),或让 dws 重新登记同一来源 —— 钉钉空间登记是确定性 ID +ON CONFLICT,原地复活同一行、不产生重复。卡片上新增「去掉来源」按钮(管理员,带确认弹窗)。 - 迁移
000047_source_connection_archive:新增archived_at/archived_by与只覆盖未归档行的部分索引;列表、目录、计划刷新、手动扫描四类查询一律排除归档行(漏一条就等于入口没去掉)。
开发快照 snapshot/v0.1.10 - 2026-10-14
目标提交:64b32c2da64881b3c9bf6de6b8f9af3f833128fd
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Changed
- 「系统设置 → 数据源配置」默认只列 PP 资料与「可加入的来源」:AList 来源(已由钉盘文件替代)与静态登记的钉钉知识库来源(改为按当前钉钉账号发现)不再默认列出,收进「显示 AList/钉钉知识库来源(N)」折叠开关 —— 来源一个都没删,展开后照旧可改刷新周期与启停,「来源与目录」里的内容不变。手动导入来源(本地手工验收)不在这次范围内,照旧显示。
开发快照 snapshot/v0.1.9 - 2026-10-14
目标提交:b7f7e4f12101569db5bb76af9d836043eefc342b
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Fixed
- 上线前护栏 + 事故复盘:
scripts/deploy-api-web.sh现在先校验.env的键值形状(值里再出现KEY=或键名不合法 ⇒ 拒绝上线),配置校验失败时也会给出"两行粘成一行"的线索。事故:.env最后一行没有结尾换行、又被追加新键 ⇒ 两行粘成一行 ⇒VERSION_HISTORY_GITEA_BASE_URL变成非法值 ⇒ api/worker 按设计拒绝启动、崩溃重启(平台整体不可用)。已修数据、加护栏、加回归用例。
开发快照 snapshot/v0.1.8 - 2026-10-14
目标提交:4cb51108454c3559e8a6305ad3316f74ed4e2daf
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Fixed
- 「版本记录」页的链接改为抓取与链接分离:抓取仍走配置的(内网)地址,页面上的「查看提交 / 查看 tag」用
VERSION_HISTORY_LINK_ORIGIN(公网 origin)拼 —— 原先两者共用内网地址,内网外的浏览器点开是空白;另外 tag 记录原先不带链接(空href点下去没反应),现在补上链接、没有链接就不渲染该按钮。
开发快照 snapshot/v0.1.7 - 2026-10-14
目标提交:90db243a68a5d16d643dd0273614b93666d65ca7
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Fixed
- 前端入口与静态资源的缓存语义("新功能看起来没上线"与"页面偶尔裸奔/空白"的根因):
开发快照 snapshot/v0.1.6 - 2026-10-14
目标提交:062a3b3cb60ede5ebcca64a0f14df53fffa1f359
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Fixed
- 前端入口的缓存策略:
index.html此前没有缓存头,CDN/浏览器会启发式缓存它,于是页面会一直停在旧构建上(实测被腾讯云 EdgeOne 卡住:源站已是新包,公网入口仍发旧包,看起来像"新菜单/新页面没上线")。现在index.html每次回源校验(no-cache, must-revalidate)、带内容哈希的/assets/长缓存(immutable),旧哈希资源明确 404 而不是回退成 HTML。
开发快照 snapshot/v0.1.5 - 2026-10-14
目标提交:4d43a9386a8a97969a1568956213f6f17b13edfb
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Changed
- tag 之前的提交不再被编号 + 部署脚本注入构建身份。
开发快照 snapshot/v0.1.4 - 2026-10-13
目标提交:0974d8dfa2aad5650eefbcee3edb365a8afd4868
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Added
- 「版本记录」页(一级菜单第 5 项):只读时间线追踪远端 main 可达的全部提交(含合并提交与已并入 main 的侧分支提交),按提交时间倒序显示标题/正文、
[正式版本] / [开发版本] / [历史提交]徽标、短 SHA、提交内变更记录与[查看提交]/[查看 tag];支持「全部 / 正式 / 开发 / 历史」筛选与游标翻页,窄屏单列。 - 新增只读接口
GET /api/v1/build-info(当前运行产物的构建身份)、GET /api/v1/version-history(快照游标分页,不返回伪造的 total)、POST /api/v1/version-history/sync(仅管理员手动同步,并发同步复用同一作业)。 - 新增迁移
000046_version_history(提交记录 + 同步状态):commit_sha是唯一身份,版本号不是唯一键 —— 两个提交算出同一个开发号时各占一行,用 SHA 区分。 - 「当前运行」只认运行产物注入的完整 SHA 精确匹配:匹配到就标该条;开发构建显式标注"开发构建";拿不到标识就显示"当前运行版本未知",不拿最新 main 或最新 tag 顶替;CI 成功不等于已部署。
Security
- 版本记录同步匿名只读远端仓库(不使用任何凭据),来源限配置里批准的 origin 与固定仓库:拒绝任意 URL、拒绝跨主机重定向,单个响应设大小上限与超时、5xx/429 才有退避重试。
- 提交正文与变更记录一律按纯文本渲染(不产生 HTML/脚本注入面);页面不含打 tag / 发布 / 部署入口;同步动作仅管理员可用,服务端再次判角色。
开发快照 snapshot/v0.1.3 - 2026-10-13
目标提交:ad9c5d20d467a077e88bbfe63b1a56355d263e51
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Changed
- Merge remote-tracking branch 'origin/main'。
开发快照 snapshot/v0.1.1 - 2026-10-13
目标提交:3a1d32da8fba90eb5081865b1f3ad424a46639ee
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Changed
- 重写平台定位与能力边界并归档原说明。
开发快照 snapshot/v0.1.1 - 2026-10-13
目标提交:950c1b429bc814d9fa7c2c1449f999a05537af21
历史开发快照补记,不改变原提交、原提交时间或正式发布状态。
Changed
- 抬档门禁(破坏性 ⇒ 0.x 抬次 / ≥1.0.0 抬主)+ 1.0.0 前置(稳定契约承诺)。
[0.1.0] - 2026-10-13
Added
- 唯一权威门禁
make verify:一条命令跑完必需检查并产出结构化报告,本地与 CI 跑同一条命令。 - 静态预览发布前先做同一份完整核对:报告有任何缺项就一个 publish 请求都不发。
Changed
- 依赖升级:
vite7.1.3 → 7.3.7、vitest3.2.4 → 5.0.3(npm audit全量 0 命中)。 - 前端存量格式债记入基线
web/.prettier-baseline.json(79 个文件,只能减,2026-12-31 到期)。
Fixed
- 新分支推送时提交范围恒为空(基准改为远端默认分支)。
- 空工作区下 CI 起不来(工作流首步改为最小 bootstrap)。
- 事件负载缺
total_commits时提交范围解析抛未收敛异常。
Security
- 依赖漏洞例外登记
security/dependency-exceptions.json:缺字段 / 过期 / 批准人是占位值 ⇒ 例外无效。
能力基线(未发布):2026-10-10 的上线能力
这一条不是正式发布版本:当时本仓既没有版本号、也没有变更记录,没有 tag、没有 Release。 它只是把已上线能力补记在此,供此后发版对照;版本号体系从下一个正式版本开始(首个正式版本号由人指定)。
- 来源与目录:列出可选的钉钉知识库 → 勾选 → 变成来源;快照与变更集。
- 发布管理:计划 → 建批 → 锁定 → 授权发布(落 WeKnora 生产)。
- 监控 + 需下架车道:测试库知识逐条下架。
- 钉钉侧:知识库发现 / 注册、取件走 dws;登录与系统设置。
- 运行形态:
knowledge-governance-p1-*—— api / web / worker / release-worker / dingtalk-login / postgres 共 6 个容器;web 发布在:8088。 - 验收口径:
docs/USER_FLOWS_ACCEPTANCE.md(C1~C9)与docs/OPERATIONS_RUNBOOK.md。
⚠️ 上面的端口与容器名前缀是本机运行栈的实测值;换环境要按那边的运行栈改,别无脑照抄。