Skip to content

docs: refresh README + API.md + CLAUDE.md for final submission - #64

Merged
shanchuann merged 1 commit into
mainfrom
feat/final-docs-cleanup
Jun 7, 2026
Merged

shanchuann merged 1 commit into
mainfrom
feat/final-docs-cleanup

Conversation

@shanchuann

Copy link
Copy Markdown
Owner

功能描述

录像前文档收尾:让 README 顶部、API 端点列表、CLAUDE.md 项目范围都对齐当前 main 状态。

实现思路

  • README:

    • 测试数 227 → 318
    • 新增"亮点速览"section,让评委一眼看到差异点(AI + 规则兜底 / 网络稳定性栈 / 结构化日志 / 多格式导出 / 双轨编辑器)
    • Demo 视频分镜重写:首访 autorun → 场景级 AI 润色 → 手动 speaker 下拉 → 五格式导出 → Editor → Adapt 数据回流
    • 仓库结构树补齐新模块(`export/`、`llm/transport.py`、`llm/parse_utils.py`、`llm/logging.py`、`data/sample-novel.ts`、`screenplay-patch.ts`、`logs/`)
  • `docs/API.md`:

    • 新增 `POST /api/v1/refine/scene` 完整描述(请求字段 / 响应示例 / 6 个错误码)
    • 新增 `POST /api/v1/export` 完整描述(3 个格式 MIME + 后缀表)
  • CLAUDE.md:scope 句子调整——"frontend editor"和"export"原本是 out-of-scope,现在已经发货,更新为 in-scope。

  • .gitignore:吞掉根目录的 `novel*.txt` / `image*.png` 测试残留,评委 fresh clone 不会看到。

测试方式

  • `py -m pytest -q`:318 passed(没碰 Python)
  • `py -m ruff check`:clean
  • 前端 `tsc -b`:clean
  • 渲染检查:README 在 GitHub 视图、API.md 在 GitHub 视图都正常

依赖与复用声明

无新增第三方依赖。纯文档 + .gitignore 调整。

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com

Demo recording is up next, so:

- README test count refreshed from 227 → 318 to match current
  pytest output. Demo video script rewritten to walk through the
  features added since the original outline: first-visit autorun,
  scene-level AI polish, manual speaker dropdown, five-format
  export, Editor → Adapt back-sync.
- New "亮点速览" section in README so a grader scanning the top
  half of the page hits the differentiators (AI + rule fallback,
  network stability stack, structured logging, multi-format
  export, dual-track editor) without needing to read the test
  matrix.
- New API.md sections for the two endpoints shipped this sprint:
  POST /api/v1/refine/scene (scene-level mode refine) and
  POST /api/v1/export (Fountain/txt/md renderer). Both follow the
  same code+message+errors detail shape as the existing endpoints
  so frontend error handlers don't need a special case.
- README repo-structure tree updated to list the new modules
  (export/, llm/transport.py, llm/parse_utils.py, llm/logging.py,
  data/sample-novel.ts, screenplay-patch.ts) and logs/ runtime dir.
- CLAUDE.md scope sentence extended to acknowledge the editor and
  export features that were "out of scope" originally but landed in
  the v1 cut.
- .gitignore extended to swallow ad-hoc novel*.txt / image*.png
  test artifacts dropped at the repo root during smoke-testing so
  graders cloning fresh don't see them.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@shanchuann
shanchuann merged commit e1f1a84 into main Jun 7, 2026
2 checks passed
@shanchuann
shanchuann deleted the feat/final-docs-cleanup branch June 7, 2026 09:43
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