Repository navigation
v1.0.3: 紧急修复 — 全部 SKILL.md/yaml 乱码 + fiction.py P0 问题 + 编码保护
v1.0.3: 紧急修复 — 全部 SKILL.md/yaml 乱码 + fiction.py P0 问题 + 编码保护
⚠️ 紧急修复版本
v1.0.2 标榜修复 UTF-8 编码,但实际未修干净——所有 15 个 SKILL.md 和 15 个 agents/openai.yaml 仍是 GBK 污染乱码,导致 AI 加载后无法理解能力边界,skill 实际不可用。本版本彻底修复。
🔧 修复内容
1. 乱码修复(P0)
从最早干净的 commit 4ef33fa 恢复所有中文内容:
- ✅ 15 个 SKILL.md 恢复干净 UTF-8(fiction、fiction-write、fiction-analyze 等)
- ✅ 15 个 agents/openai.yaml 恢复干净 UTF-8
- ✅ scripts/reference_search.py 去除 UTF-8 BOM
- ✅ 全项目 105 个文本文件编码检测通过
2. fiction.py P0 脚本问题修复
问题 | 修复前 | 修复后 -- | -- | -- cmd_where 失败退出码 | 0(错误被掩盖) | 1(错误走 stderr) cmd_export 参数 | 缺 --format/--output | 支持 --format {txt,docx,fanqie} --output(含番茄平台格式化) cmd_doctor 参数 | 缺 --chapter/--deep | 支持 --chapter N --deep cmd_review list 类型 | 不处理 | 完整支持3. fiction-revise 路由同步
- fiction/SKILL.md 路由表:fiction-revise → fiction-write(内建修改模式)
- fiction-write/SKILL.md 新增"章节修改模式(内建)"章节
- Re-craft 模式:大改,自动传播影响范围
- Rewrite 模式:重写,全链路刷新
- Polish 模式:转交 fiction-polish
4. README 同步
- 完整写作流程图:revise → write(修改模式)
- 三种修改强度表增加"调用方式"列
- fiction-write 描述补充修改职责
- 快速上手增加"修改第5章"示例
5. 编码保护基础设施(新增)
防止乱码问题再次出现:
- ✨ 新增 .editorconfig — 强制 UTF-8 无 BOM、LF 换行
- ✨ 新增 scripts/check_encoding.py — 编码检测工具
- 检测 BOM、非 UTF-8 字节、典型乱码特征
- 退出码 0/1,可接入 CI 或 pre-commit hook
📊 变更统计
- 36 文件变更
- +1606 行 / -1210 行
- 新增 2 文件(.editorconfig, check_encoding.py)
⚠️ 升级建议
所有 v1.0.2 用户应立即升级到 v1.0.3。v1.0.2 因乱码问题实际不可用。
升级方法:
bash
git pull origin main
# 或
git checkout v1.0.3
🔍 验证方法
运行编码检测确认所有文件干净:
bash
python scripts/check_encoding.py .
# 期望输出: 检查完成: 105 OK, 0 BAD
运行 fiction.py 确认参数注册:
bash
python scripts/fiction.py export --help # 应显示 --format/--output
python scripts/fiction.py doctor --help # 应显示 --chapter/--deep
python scripts/fiction.py where --help # 应显示位置参数
📝 后续待办(非阻塞)
以下 P1/P2 问题留待后续版本:
- agents 编排描述(reviewer agent / context-agent / data-agent)与脚本实现对齐
- state.json schema 版本化
- 统一 CLAUDE_/CODEX_ 环境变量前缀
- 补 pytest 测试
- LICENSE / CHANGELOG
- Windows 兼容性测试
完整变更: v1.0.2...v1.0.3