{"id":43001955,"url":"https://github.com/wordflowlab/novel-writer","last_synced_at":"2026-01-31T04:08:47.369Z","repository":{"id":315696762,"uuid":"1060499374","full_name":"wordflowlab/novel-writer","owner":"wordflowlab","description":"参考Spec-kit 实现小说撰写工具","archived":false,"fork":false,"pushed_at":"2025-10-26T00:36:24.000Z","size":1250,"stargazers_count":406,"open_issues_count":5,"forks_count":90,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-12-03T00:57:27.412Z","etag":null,"topics":["engineering","novels","sdd","spec","spec-driven"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wordflowlab.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-20T03:12:06.000Z","updated_at":"2025-12-02T11:50:53.000Z","dependencies_parsed_at":"2025-09-20T06:23:27.891Z","dependency_job_id":"d3c94cfd-89bd-47e3-9395-4a10daded357","html_url":"https://github.com/wordflowlab/novel-writer","commit_stats":null,"previous_names":["wordflowlab/novel-writer"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/wordflowlab/novel-writer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wordflowlab%2Fnovel-writer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wordflowlab%2Fnovel-writer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wordflowlab%2Fnovel-writer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wordflowlab%2Fnovel-writer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wordflowlab","download_url":"https://codeload.github.com/wordflowlab/novel-writer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wordflowlab%2Fnovel-writer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28928908,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T04:05:25.756Z","status":"ssl_error","status_checked_at":"2026-01-31T04:02:35.005Z","response_time":128,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["engineering","novels","sdd","spec","spec-driven"],"created_at":"2026-01-31T04:08:46.749Z","updated_at":"2026-01-31T04:08:47.364Z","avatar_url":"https://github.com/wordflowlab.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Novel Writer - AI 驱动的中文小说创作工具\n\n[![npm version](https://badge.fury.io/js/novel-writer-cn.svg)](https://www.npmjs.com/package/novel-writer-cn)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n\u003e 🚀 基于规格驱动开发（SDD）的 AI 智能小说创作助手\n\u003e\n\u003e 在 Claude、Cursor、Gemini 等 AI 助手中直接使用斜杠命令，系统化创作高质量小说\n\n## ✨ 核心特性\n\n- 📚 **斜杠命令** - 在 Claude、Gemini、Codex、Cursor、Windsurf、Roo Code 等 AI 助手中直接使用\n- 🎯 **七步方法论** - 基于规格驱动开发（SDD）的系统化创作流程\n- 🤖 **智能辅助** - AI 理解上下文，提供针对性创作建议\n- 📝 **中文优化** - 专为中文小说创作设计，支持字数统计、多线索管理\n- 🔄 **跨平台** - 支持 13 个 AI 工具，Windows/Mac/Linux 全平台\n- 🔌 **插件系统** - 可扩展功能，如真实人声、翻译、风格模仿等\n- ✅ **质量保障** - 情节追踪、时间线管理、角色一致性验证\n\n\u003e 📖 **详细特性说明**：查看 [CHANGELOG.md](CHANGELOG.md) 了解各版本的完整更新\n\n## 🚀 快速开始\n\n### 1. 安装\n\n```bash\nnpm install -g novel-writer-cn\n```\n\n### 2. 初始化项目\n\n```bash\n# 基本用法\nnovel init my-novel\n\n# 推荐：预装真实人声插件\nnovel init my-novel --plugins authentic-voice\n\n# 指定 AI 平台\nnovel init my-novel --ai claude    # Claude Code\nnovel init my-novel --ai gemini    # Gemini CLI\nnovel init my-novel --ai codex     # Codex CLI\nnovel init my-novel --ai cursor    # Cursor\n```\n\n### 3. 开始创作\n\n在 AI 助手中使用斜杠命令：\n\n```\n/novel.constitution    # Claude Code 格式\n/novel:constitution    # Gemini CLI 格式\n/novel-constitution    # Codex CLI 格式\n/constitution          # 其他平台格式\n```\n\n**七步方法论流程**：\n1. `/constitution` → 2. `/specify` → 3. `/clarify` →\n4. `/plan` → 5. `/tasks` → 6. `/write` → 7. `/analyze`\n\n\u003e 📚 **详细安装说明**：[docs/installation.md](docs/installation.md)\n\u003e 📖 **完整工作流程**：[docs/workflow.md](docs/workflow.md)\n\u003e 🎯 **AI 平台命令对照**：[docs/ai-platform-commands.md](docs/ai-platform-commands.md) ⭐ **必读**\n\n## 📦 升级现有项目\n\n```bash\n# 升级到最新版本\nnpm install -g novel-writer-cn@latest\ncd my-novel\nnovel upgrade\n\n# 或指定 AI 平台\nnovel upgrade --ai claude\n```\n\n\u003e 📚 **完整升级指南**：[docs/upgrade-guide.md](docs/upgrade-guide.md) - 包含版本兼容性、迁移说明、回滚方法\n\n## 📚 斜杠命令\n\n### 命名空间说明\n\n| AI 平台 | 命令格式 | 示例 |\n|---------|----------|------|\n| **Claude Code** | `/novel.命令名` | `/novel.write` |\n| **Gemini CLI** | `/novel:命令名` | `/novel:write` |\n| **Codex CLI** | `/novel-命令名` | `/novel-write` |\n| **其他平台** | `/命令名` | `/write` |\n\n\u003e 💡 下表使用通用格式，实际使用时请根据您的 AI 平台添加相应前缀\n\u003e 📖 **详细命令对照**：[docs/ai-platform-commands.md](docs/ai-platform-commands.md)\n\n### 七步方法论\n\n| 命令 | 描述 | 何时使用 |\n|------|------|----------|\n| `/constitution` | 创作宪法 | 项目开始，定义核心创作原则 |\n| `/specify` | 故事规格 | 像 PRD 一样定义故事需求 |\n| `/clarify` | 澄清决策 | 通过 5 个问题明确模糊点 |\n| `/plan` | 创作计划 | 制定章节结构和技术方案 |\n| `/tasks` | 任务分解 | 生成可执行的任务清单 |\n| `/write` | 章节写作 | 基于任务清单进行创作 |\n| `/analyze` | 综合验证 | 智能双模式：框架分析/内容分析 |\n\n### 追踪与验证\n\n| 命令 | 描述 | 何时使用 |\n|------|------|----------|\n| `/track-init` | 初始化追踪 | 首次使用（只需一次） |\n| `/checklist` | 质量检查清单 ⭐ | 规格验证（写作前）+ 内容扫描（写作后） |\n| `/track` | 综合追踪 | 每完成一章后 |\n| `/plot-check` | 情节检查 | 每 5-10 章定期检查 |\n| `/timeline` | 时间线管理 | 重要事件后 |\n| `/relations` | 关系追踪 | 角色关系变化时 |\n| `/world-check` | 世界观检查 | 新设定出现后 |\n\n\u003e 📖 **详细命令说明**：[docs/commands.md](docs/commands.md) - 包含每个命令的详细用法、参数和最佳实践\n\n\u003cdetails\u003e\n\u003csummary\u003e📁 项目结构（点击展开）\u003c/summary\u003e\n\n```\nmy-novel/\n├── .specify/          # Spec Kit 配置\n│   ├── memory/        # 创作记忆（constitution.md等）\n│   └── scripts/       # 支持脚本\n├── .claude/           # Claude 命令（或 .cursor/.gemini 等）\n│   └── commands/      # 斜杠命令文件\n├── spec/              # 小说规格数据\n│   ├── tracking/      # 追踪数据（plot-tracker.json等）\n│   └── knowledge/     # 知识库（world-setting.md等）\n├── stories/           # 故事内容\n│   └── 001-故事名/\n│       ├── specification.md    # 故事规格\n│       ├── creative-plan.md    # 创作计划\n│       ├── tasks.md            # 任务清单\n│       └── content/            # 章节内容\n└── scripts/           # 支持脚本\n    ├── bash/          # Unix/Linux/Mac\n    └── powershell/    # Windows\n```\n\n\u003c/details\u003e\n\n## 🤖 支持的 AI 助手\n\n| AI 工具 | 说明 | 状态 |\n|---------|------|------|\n| **Claude Code** | Anthropic 的 AI 助手 | ✅ 推荐 |\n| **Cursor** | AI 代码编辑器 | ✅ 完整支持 |\n| **Gemini CLI** | Google 的 AI 助手 | ✅ TOML 格式 |\n| **Windsurf** | Codeium 的 AI 编辑器 | ✅ 完整支持 |\n| **Roo Code** | AI 编程助手 | ✅ 完整支持 |\n| **GitHub Copilot** | GitHub 的 AI 编程助手 | ✅ 完整支持 |\n| **Qwen Code** | 阿里通义千问代码助手 | ✅ TOML 格式 |\n| **OpenCode** | 开源 AI 编程工具 | ✅ 完整支持 |\n| **Codex CLI** | AI 编程助手 | ✅ 完整支持 |\n| **Kilo Code** | AI 编程工具 | ✅ 完整支持 |\n| **Auggie CLI** | AI 开发助手 | ✅ 完整支持 |\n| **CodeBuddy** | AI 编程伙伴 | ✅ 完整支持 |\n| **Amazon Q Developer** | AWS 的 AI 开发助手 | ✅ 完整支持 |\n\n\u003e 💡 使用 `novel init --all` 可以同时为所有 AI 工具生成配置\n\n## 🛠️ CLI 命令\n\n\u003cdetails\u003e\n\u003csummary\u003e详细选项（点击展开）\u003c/summary\u003e\n\n### `novel init [name]`\n\n```bash\nnovel init my-novel [选项]\n```\n\n**常用选项**：\n- `--here` - 在当前目录初始化\n- `--ai \u003ctype\u003e` - 选择 AI 平台（claude/gemini/cursor等）\n- `--with-experts` - 包含专家模式\n- `--plugins \u003cnames\u003e` - 预装插件（逗号分隔）\n- `--all` - 生成所有 AI 平台配置\n\n### `novel plugins`\n\n```bash\nnovel plugins list                # 列出已安装插件\nnovel plugins add \u003cname\u003e          # 安装插件\nnovel plugins remove \u003cname\u003e       # 移除插件\n```\n\n### `novel upgrade`\n\n```bash\nnovel upgrade [--ai \u003ctype\u003e]       # 升级项目到最新版本\n```\n\n### `novel check`\n\n```bash\nnovel check                       # 检查项目配置和状态\n```\n\n\u003c/details\u003e\n\n## 📖 文档索引\n\n### 核心文档\n- **[命令详解](docs/commands.md)** - 所有斜杠命令的详细用法、参数和最佳实践\n- **[工作流程](docs/workflow.md)** - 完整的创作流程说明\n- **[写作方法](docs/writing-methods.md)** - 6种经典写作方法详解\n- **[最佳实践](docs/best-practices.md)** - 实战经验和高级技巧\n\n### 进阶文档\n- **[实战指南](docs/writing/practical-guide.md)** - 基于真实案例的 SDD 应用\n- **[升级指南](docs/upgrade-guide.md)** - 版本升级说明和迁移指南\n- **[安装指南](docs/installation.md)** - 详细安装步骤\n- **[字数统计](docs/word-count-guide.md)** - 中文字数统计最佳实践\n\n### 插件与扩展\n- **真实人声插件** - `novel plugins add authentic-voice`\n  - 编辑 `.specify/memory/personal-voice.md` 配置个人语料\n  - 使用 `/authentic-voice` 创作，`/authenticity-audit` 自查\n- **翻译插件** - `novel plugins add translate`\n- **风格模仿插件** - 路遥、王钰等作家风格\n\n\u003e 💡 使用 `novel plugins list` 查看所有可用插件\n\n## 📈 版本历史\n\n查看完整的更新日志：**[CHANGELOG.md](CHANGELOG.md)**\n\n**最新版本亮点**：\n- v0.15.0 - 多平台命令格式优化\n- v0.14.2 - 中文字数统计修复\n- v0.12.2 - Claude Code 增强层\n- v0.12.0 - 多线索管理系统\n- v0.10.0 - 七步方法论体系\n\n## 🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n项目地址：[https://github.com/wordflowlab/novel-writer](https://github.com/wordflowlab/novel-writer)\n\n## 📄 许可证\n\nMIT License\n\n## 🌐 项目矩阵\n\nWordFlowLab 围绕 AI 辅助小说创作展开多维度探索，采用不同方法论和技术栈的开源项目组合：\n\n### 方法论探索系列\n\n| 项目 | 方法论 | 技术特点 | 适用场景 |\n|------|--------|----------|----------|\n| **[Novel-Writer](https://github.com/wordflowlab/novel-writer)** ⭐ | Spec-Kit | 寄生斜杠命令，七步方法论 | 适合多平台用户，跨 13 个 AI 工具 |\n| **[Article-Writer](https://github.com/wordflowlab/article-writer)** 🆕 | Spec-Kit | 九步写作流程，工作区管理 | 公众号/自媒体文章创作，降低 AI 味 |\n| **[Novel-Writer-OpenSpec](https://github.com/wordflowlab/novel-writer-openspec)** | OpenSpec | 寄生斜杠命令，规格分离管理（specs/ + changes/） | 适合需要 OpenSpec 规格化管理 |\n| **[Novel-Writer-Skills](https://github.com/wordflowlab/novel-writer-skills)** | Spec-Kit + Agent Skills | 寄生斜杠命令，支持 Claude Code Agent Skills | 专为 Claude Code 优化 |\n\n### 工具实现系列\n\n| 项目 | 类型 | 技术基础 | 说明 |\n|------|------|----------|------|\n| **[WriteFlow](https://github.com/wordflowlab/writeflow)** | CLI 工具 | 模仿 Claude Code 架构 | 独立 CLI，为技术型作家设计 |\n| **[NovelWeave](https://github.com/wordflowlab/novelweave)** | VSCode 扩展 | Fork: Cline → Roo Code → Kilo Code → NovelWeave | 可视化小说编辑器，星尘织梦 |\n\n### 技术演进路径\n\n```\nSpec-Kit 方法论分支:\n  Novel-Writer (主线) ──┬─→ Novel-Writer-Skills (Claude Code 专版)\n                       └─→ WriteFlow (CLI 独立版)\n\nOpenSpec 方法论分支:\n  Novel-Writer-OpenSpec (探索版)\n\nVSCode 扩展分支:\n  Cline → Roo Code → Kilo Code → NovelWeave (小说定制版)\n```\n\n### 选择建议\n\n根据您的经验背景选择合适的工具：\n\n| 用户类型 | 推荐项目 | 理由 |\n|---------|---------|------|\n| 🌟 **新手入门** | [NovelWeave](https://github.com/wordflowlab/novelweave) | 可视化编辑器，VSCode 扩展，最易上手 |\n| 💻 **有编程基础\u003cbr\u003e无小说经验** | [Novel-Writer](https://github.com/wordflowlab/novel-writer) \u003cbr\u003e [Novel-Writer-Skills](https://github.com/wordflowlab/novel-writer-skills) | 七步方法论引导创作流程\u003cbr\u003eSkills 版适合 Claude Code 用户 |\n| 📚 **有编程基础\u003cbr\u003e有小说经验** | [Novel-Writer-OpenSpec](https://github.com/wordflowlab/novel-writer-openspec) | OpenSpec 规格化管理\u003cbr\u003e适合系统化创作和团队协作 |\n| 🚀 **技术探索者\u003cbr\u003e可贡献 PR** | [WriteFlow](https://github.com/wordflowlab/writeflow) | CLI 工具开发探索\u003cbr\u003e欢迎贡献代码和想法 |\n\n**快速决策**：\n- **完全新手** → NovelWeave（可视化最友好）\n- **用 Claude Code** → Novel-Writer-Skills（深度集成 Agent Skills）\n- **跨多个 AI 工具** → Novel-Writer（支持 13 个平台）\n- **追求规格化** → Novel-Writer-OpenSpec（OpenSpec 方法论）\n- **喜欢命令行** → WriteFlow（纯 CLI 体验）\n\n\u003e 💡 **多矩阵、多方法论组合开源**：探索 AI 写作的不同可能性，欢迎根据需求选择合适的工具！\n\n## 🙏 致谢\n\n本项目基于 [Spec Kit](https://github.com/sublayerapp/spec-kit) 架构设计，特此感谢！\n\n---\n\n**Novel Writer** - 让 AI 成为你的创作伙伴！ ✨📚\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwordflowlab%2Fnovel-writer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwordflowlab%2Fnovel-writer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwordflowlab%2Fnovel-writer/lists"}