Skip to content

feat: 增加多分类说明书管理 - #27

Merged
mcoder2014 merged 1 commit into
masterfrom
feat/cq/manuals
Sep 19, 2026
Merged

mcoder2014 merged 1 commit into
masterfrom
feat/cq/manuals

Conversation

@mcoder2014

@mcoder2014 mcoder2014 commented Sep 19, 2026 •

Copy link
Copy Markdown
Owner

为家庭设备集中保存电子说明书:每份说明书可包含多个 PDF、图片、文本和 URL,可归入多个分类,并按分类和名称字面包含查询。列表显示封面缩略图,手机页面支持多次选择图片追加到同一上传队列,失败项可按原请求标识重试。

可见范围包含仅自己、登录用户和所有人。新建资料先存为仅所有者可见的草稿,全部上传成功后发布;原件、缩略图、HEAD 和 Range 都经过后端权限校验。元数据修改使用 revision 检测冲突,文件与资料追加支持幂等,长请求在写事务内再次校验精确会话和应用授权。

复用现有账号、导航和应用凭证体系;新增独立的三张说明书表和私有文件目录,默认关闭模块。home-server-web-share skill 新增说明书批量管理 CLI,旧网页托管命令保持兼容,已有应用不会自动获得新 scopes。

验证结果及边界见 docs/specs/manual-management/verification.md,系统设计和实施计划位于同目录。数据库迁移为增量;回滚服务时保留新表和文件,避免删除已上传资料。部署使用同一提交构建的前后端,并校验完整 release 的文件哈希。

隔离验证:Go 全仓编译通过,完整主测试 34 包、325 个顶层用例通过,20 个既有可选用例跳过,0 失败;前端 Node 92/92、说明书浏览器 8/8、账号浏览器回归 6/6、Python 客户端与新旧 skill 33/33 通过。独立审查发现的会话撤销、RR 旧快照配额竞态、文件失败回查、EXIF、PDF 尺寸和分类截断问题均已修复,并加入对应回归。

手机浏览器布局与上传队列已用 Chrome 验证,iOS/Android 系统相册选择器仍需实机验收;HEIC/HEIF 需先转换为 JPEG/PNG。

发布状态:GitHub CI 全部通过(运行记录);pi 和本机稳定 Skill 已更新到 7be0871c0cb099d7a3a7b89e8b38abd0133c5abe。安装前完成数据库与配置备份、三表增量迁移、实际 Nginx 校验;安装后校验 current release 全部 40 个文件。两个 HTTP 和两个内网 HTTPS 入口合计 36 项只读检查通过,原账号、网页托管与 WebDAV 匿名响应与升级前一致。保留真实公网域名 SNI/Host、通过网关地址执行的 18 项检查通过;实际 WAN 入站 TCP 仍不可达,与已有部署记录中的公网连通边界一致,未将其计为公网验收通过。

PR 保持打开,等待合并;工作树保留。隔离测试容器已清理,旧 release、配置/数据库备份与 Skill runtime 保留。

@mcoder2014
mcoder2014 merged commit 1db4129 into master Sep 19, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant