zhoujie
d88b4e9a3b
- 新增 `get_secure()` 和 `set_secure()` 方法，优先从环境变量或系统 keyring 读取敏感配置，`config.json` 中仅存储占位符 - 将 `save()` 方法改为使用临时文件 + `os.replace()` 的原子写入，防止进程中断导致配置文件损坏 - 在 `add_llm_provider()` 和 `get_active_llm()` 中集成安全配置读写，自动迁移旧版明文 API Key ♻️ refactor(analytics): 实现分析数据原子写 - 将 `_save_analytics()` 和 `_save_weights()` 方法改为使用临时文件 + `os.replace()` 的原子写入 - 确保在写入过程中进程被终止时，原始数据文件保持完整 ♻️ refactor(main): 增强发布功能健壮性与代码模块化 - 在 `publish_to_xhs()` 中增加发布前输入校验【标题长度、图片数量、文件存在性】并在 `finally` 块中自动清理本次生成的临时图片文件 - 为全局笔记列表缓存 `_cached_proactive_entries` 和 `_cached_my_note_entries` 引入 `threading.RLock` 保护，新增 `_set_cache()` 和 `_get_cache()` 线程安全操作函数 - 将「内容创作」Tab 的 UI 构建代码拆分至 `ui/tab_create.py` 模块，主文件通过 `build_tab()` 函数调用并组装 - 将 Gradio 应用的 CSS 和主题配置提取为模块级变量，提升可维护性 📦 build(deps): 新增 keyring 依赖 - 在 `requirements.txt` 中添加 `keyring>=24.0.0` 以支持系统凭证管理 📝 docs(openspec): 新增生产就绪审计文档 - 在 `openspec/changes/archive/2026-02-24-production-readiness-audit/` 下新增设计文档、提案、任务清单及各功能规格说明 - 将核心功能规格同步至 `openspec/specs/` 目录
20 lines
1.2 KiB
Markdown
20 lines
1.2 KiB
Markdown
## ADDED Requirements
|
|
|
|
### Requirement: 笔记列表缓存读写受互斥锁保护
|
|
模块级全局变量 `_cached_proactive_entries` 和 `_cached_my_note_entries` 的所有读写操作 SHALL 在 `threading.RLock` 的保护下执行，以防止 Gradio 回调并发调用时产生数据竞态。
|
|
|
|
#### Scenario: 并发刷新时缓存更新不出现竞态
|
|
- **WHEN** 两个 Gradio 回调线程同时调用 `_fetch_and_cache()`
|
|
- **THEN** 最终缓存状态为其中一次完整写入的结果，不出现部分更新或列表长度异常
|
|
|
|
#### Scenario: 读取缓存时不被并发写入中断
|
|
- **WHEN** `_pick_from_cache()` 正在迭代缓存列表时，另一线程触发缓存更新
|
|
- **THEN** 迭代过程不抛出 `RuntimeError: list changed size during iteration`
|
|
|
|
### Requirement: 缓存操作封装为受保护的工具函数
|
|
模块 SHALL 提供 `_set_cache(name, entries)` 和 `_get_cache(name)` 两个内部函数，统一管理缓存读写，不在业务函数中直接赋值全局列表。
|
|
|
|
#### Scenario: 缓存写入通过统一接口
|
|
- **WHEN** 任意函数需要更新笔记缓存
|
|
- **THEN** 必须调用 `_set_cache(name, entries)` 而非直接赋值 `_cached_*` 变量
|