Skip to content

v1.0.3: 紧急修复 — 全部 SKILL.md/yaml 乱码 + fiction.py P0 问题 + 编码保护

Choose a tag to compare

@qingyabailu-git qingyabailu-git released this 17 Jun 10:02
· 9 commits to main since this release

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