 StarAsh042
|
fecb5145ba
|
chore(repo): tests/ 与 docs/ 转为本地独享，不进远端仓库与发布包
维护者策略（2026-10-25）：测试套件与项目文档（数据 SOP / 决策记录 /
迭代计划）仅保留在本地工作树——取消 git 跟踪并写入 .gitignore，
.comfyignore 同步排除 docs/（tests/ 原已排除），Registry 发布包
不再包含内部文档，扫描面进一步收敛。
配套调整：
- ci.yml：test job 检出无 tests/ 时跳过而非失败（分支保护引用的
ci 聚合 job 不受影响；测试若重新纳入跟踪则自动恢复执行）
- README：数据 SOP 链接、测试规模口径、参与开发段改写，清除指向
未跟踪文件的死链并说明测试本地独享
- BENCHMARKS：迭代计划引用改本地口径，文首注明测试文件位置
|
2026-10-25 23:48:13 +08:00 |
|
|
StarAsh042
|
61db2818b0
|
docs(t-17-t-18): 仓库清理与数据更新 SOP
- T-17: 删除本地备份分支 backup/pre-rebuild-20261022-233943（重建前平行历史，
内容已被 5.0.0 完整包含，删除前经 git diff 树对比核验零损失，从未推送 origin）；
import_legacy_csv 补生命周期标注（4.x→5.0.0 一次性迁移工具，无生产调用方）
- T-18: 新增 docs/DATA-UPDATE-SOP.md（取数/LFS 纪律/加工参数/校验清单/回滚/提交约定），
README 数据预处理段挂链接
- 不动 pyproject 版本号，合并不触发 Registry 发布
|
2026-10-25 22:12:20 +08:00 |
|
|
StarAsh042
|
5fb57f9e3a
|
feat(character): T-16 作品筛选执行期一致性（报错分级+copyrights 缓存+边界说明）
- CharacterIndex 新增 copyrights 惰性缓存属性（与下拉同一排序）
- 作品筛选为空的报错分级：自定义 CSV 场景指明「不在自定义 CSV 的作品列表中」并给出该 CSV 总量与热门示例；默认场景指明「不在默认 CSV 的作品列表中」
- copyright_pick / custom_csv_path tooltip 与 README 补齐联动方向
- locales zh/en 同步；新增 4 个测试（含报错消息断言）
- 背景：ComfyUI INPUT_TYPES 无参调用拿不到实例参数，下拉联动架构上不可行；
执行期筛选本就作用于 custom_csv_path，本版补齐错误指引与边界说明
- 不动 pyproject 版本号（等 5.1.3 定级后发 5.1.4）
|
2026-10-25 21:46:36 +08:00 |
|
|
StarAsh042
|
fb58ff25f8
|
docs(od-01-od-02): 落实两项决策的提示强化（tooltip/README/locales 同步）
- OD-01/OD-02 均按方案 A 关闭（维持内存窗口 / 维持启动即清空）
- 两节点 tested_db_path tooltip 补默认库启动即清空提示
- 角色节点 character_count tooltip 补窗口语义（内存/重启清零/多实例独立）
- README 重复回避段补多实例独立表述
- locales/zh 与代码 tooltip 逐字对齐（28 条，修复存量漂移），locales/en 同步
|
2026-10-25 19:00:18 +08:00 |
|
|
StarAsh042
|
81515026ab
|
Sprint 2: 工程增强（决策登记/性能基线/测试口径/mypy/发布面收敛）
* feat(cache): 节点缓存键纳入 CSV 文件签名
ComfyUI 默认只按输入参数判断缓存是否命中。两个节点读的都是外部 CSV，
参数不变而文件被替换时缓存会一直返回旧结果，用户换了数据却看不到变化。
把 CSV 的「路径 + 修改时间 + 大小」作为 IS_CHANGED 的返回值纳入缓存键：
文件一变就重算；文件与参数都不变时指纹稳定，缓存行为与 5.0.0 一致。
路径被防护拒绝时返回稳定哨兵而不抛异常，避免打断 ComfyUI 的缓存判断。
* perf(character): 派生索引随记录缓存，单次执行 62.6ms -> 26.7ms
角色节点每次执行都在 3.4 万条记录上重建 record_map / names / 作品筛选下标，
CSV 没变时完全是重复劳动。把三者收进 CharacterIndex，与记录共用同一套
文件签名缓存（路径 + 列 + mtime + size），CSV 一变就重建。
顺带修掉作品下拉菜单的失效问题：菜单改为按默认 CSV 的文件签名缓存，
换 CSV 后自动重建，不再需要重启 ComfyUI。
实测（本机 7 次中位数）：generate_characters 62.62ms -> 26.69ms（-57%）。
4 个 seed 下 prompt / characters_json / tested_count 逐字节一致。
剩余约 24ms 在 select_artists 的排除过滤里；改动它会改变 RNG 消耗顺序、
破坏同 seed 的可复现性，故本次不动。
* docs(db): 修正 generation_lock 的持锁范围说明
原文写「调用方应在进入本上下文之前完成抽样、权重计算、提示词拼装等纯 CPU 工作」，
但 RollingArtist 的重试循环必须待在事务里（命中已测组合要重新抽样），
实际持锁时长等于一次完整生成。文档与实现互相矛盾，读代码的人会误判并发行为。
改为如实描述：持锁时长由调用方决定，两种调用方式各自的代价是什么，
以及为什么不能简单把抽样挪到锁外（冲突只会推迟到写入时才被 INSERT OR IGNORE 吞掉）。
同时修正 __init__ 里「不覆盖事务内的业务计算」这句同样有歧义的注释。
纯注释改动，无代码行为变化。
* docs: 5.1.0 变更记录与 README 缓存/性能说明（T-04）
* docs: 归档 v5.1.0 迭代计划至 docs/iteration
* chore(release): 5.1.0
* docs: 回填 v5.1.0 执行记录至迭代计划
* docs: Sprint 2 文档三件套（决策登记/性能基线/测试口径）
* ci/chore: mypy job 非阻断 + .comfyignore 收敛发布面
|
2026-10-25 17:27:20 +08:00 |
|
|
StarAsh042
|
dcb98bc58b
|
chore(release): 5.1.0
* feat(cache): 节点缓存键纳入 CSV 文件签名
ComfyUI 默认只按输入参数判断缓存是否命中。两个节点读的都是外部 CSV，
参数不变而文件被替换时缓存会一直返回旧结果，用户换了数据却看不到变化。
把 CSV 的「路径 + 修改时间 + 大小」作为 IS_CHANGED 的返回值纳入缓存键：
文件一变就重算；文件与参数都不变时指纹稳定，缓存行为与 5.0.0 一致。
路径被防护拒绝时返回稳定哨兵而不抛异常，避免打断 ComfyUI 的缓存判断。
* perf(character): 派生索引随记录缓存，单次执行 62.6ms -> 26.7ms
角色节点每次执行都在 3.4 万条记录上重建 record_map / names / 作品筛选下标，
CSV 没变时完全是重复劳动。把三者收进 CharacterIndex，与记录共用同一套
文件签名缓存（路径 + 列 + mtime + size），CSV 一变就重建。
顺带修掉作品下拉菜单的失效问题：菜单改为按默认 CSV 的文件签名缓存，
换 CSV 后自动重建，不再需要重启 ComfyUI。
实测（本机 7 次中位数）：generate_characters 62.62ms -> 26.69ms（-57%）。
4 个 seed 下 prompt / characters_json / tested_count 逐字节一致。
剩余约 24ms 在 select_artists 的排除过滤里；改动它会改变 RNG 消耗顺序、
破坏同 seed 的可复现性，故本次不动。
* docs(db): 修正 generation_lock 的持锁范围说明
原文写「调用方应在进入本上下文之前完成抽样、权重计算、提示词拼装等纯 CPU 工作」，
但 RollingArtist 的重试循环必须待在事务里（命中已测组合要重新抽样），
实际持锁时长等于一次完整生成。文档与实现互相矛盾，读代码的人会误判并发行为。
改为如实描述：持锁时长由调用方决定，两种调用方式各自的代价是什么，
以及为什么不能简单把抽样挪到锁外（冲突只会推迟到写入时才被 INSERT OR IGNORE 吞掉）。
同时修正 __init__ 里「不覆盖事务内的业务计算」这句同样有歧义的注释。
纯注释改动，无代码行为变化。
* docs: 5.1.0 变更记录与 README 缓存/性能说明（T-04）
* docs: 归档 v5.1.0 迭代计划至 docs/iteration
* chore(release): 5.1.0
|
2026-10-25 15:57:40 +08:00 |
|
|
StarAsh042
|
7cb6a0fd63
|
docs: 补充参与开发与 PR 流程说明
|
2026-10-23 00:17:15 +08:00 |
|
|
StarAsh042
|
83076a936b
|
chore(release): 5.0.0
工程化基线版本：CI、测试入库与打包配置齐备，README 与 CHANGELOG 同步到 5.0.0。
|
2026-10-22 01:12:00 +08:00 |
|
|
StarAsh042
|
b651ff5629
|
chore(release): 4.0.0
数据加工工具链与 LFS 存储上线，README 与 CHANGELOG 同步到 4.0.0。
|
2026-10-19 15:12:00 +08:00 |
|
|
StarAsh042
|
b057c5c7b9
|
chore(release): 3.0.0
界面本地化与帮助文档上线，README 与 CHANGELOG 同步到 3.0.0。
|
2026-10-18 15:12:00 +08:00 |
|
|
StarAsh042
|
7d1674f7c4
|
chore(release): 2.0.0
角色节点上线，README 与 CHANGELOG 同步到 2.0.0。
|
2026-10-17 15:12:00 +08:00 |
|
|
StarAsh042
|
5ae41591c2
|
docs: 编写 README
写清功能、安装方式、数据格式与输出，避免使用者去读源码猜参数。
|
2026-10-15 15:12:00 +08:00 |
|