主人要求:去掉入口,统一成 dws 导入与 PP 导入;其他来源连数据一起下架,之后用 dws 重新获取。
界面(web):
- 「数据源配置」只剩两块:**dws 导入(钉钉)**(按当前钉钉账号列出可访问的知识库与钉盘空间)
与 **PP 导入**(PP 资料下载中心)。上一步加的「显示 AList/钉钉知识库来源」折叠开关删除。
- 来源卡片新增管理员可见的「去掉来源」(带确认弹窗,说明是归档下架、数据保留可恢复)。
- 侧栏文案改成"只留两个入口";发现面板标题改为「dws 导入(钉钉)」。
后端(归档语义,可逆):
- 迁移 000047:source_connections 增 archived_at / archived_by + 只覆盖未归档行的部分索引。
- store:ArchiveSourceConnection / RestoreSourceConnection(幂等;归档同时停用并清空
next_refresh_at,避免被手工改回后立刻带着旧调度跑)。列表、目录、计划刷新(claimDue)、
手动扫描(triggerBlock/inspect)四类查询一律排除归档行。
- 注册路径(dws 重新获取):RegisterDingtalkSpace 的 ON CONFLICT 清掉归档标记 ——
重新登记同一个空间**原地复活同一行**,不产生重复,历史快照仍属于同一行。
- HTTP:POST /api/v1/source-connections/{id}/archive|restore(管理员专属,写意图头
source-archive / source-restore + Idempotency-Key;404 区分"不存在"与"已是目标状态");
openapi 同步两条契约。
验证:
- 集成测试(真 postgres):归档从列表消失但 source_items 一行不少、重复归档不漂移归档时间与人、
未知 ID 报 ErrSourceConnectionNotFound、归档来源不能再被扫描、恢复后回到列表但保持停用;
dws 重新登记同一空间复活同一行。
- httpapi:写意图/幂等键门禁、200/403/404/500、错误体不回显内部细节、classifyRole 管理员专属。
- 迁移护栏:000047 结构 + 四类 SQL 必须含 archived_at is null(漏一条就是入口没去掉)。
- make verify 15/15。
8.7 KiB
Changelog
[Unreleased]
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 成功不等于已部署。
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
- 前端入口与静态资源的缓存语义("新功能看起来没上线"与"页面偶尔裸奔/空白"的根因):
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 算出来,不写进本文件 ⇒ 每个提交都有自己的版本号, 但"发布版本"仍然只能由人定(CI 不会自动升版本、不会打 tag)。
[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。
⚠️ 上面的端口与容器名前缀是本机运行栈的实测值;换环境要按那边的运行栈改,别无脑照抄。