novelws 3.0.0 → 4.0.0

package/templates/{scripts → resources/scripts}/bash/analyze-story.sh

@@ -29,7 +29,7 @@ check_story_files() {
     local missing_files=()
 
     # 检查基准文档
-    [ ! -f ".specify/memory/constitution.md" ] && missing_files+=("宪法文件")
+    [ ! -f "resources/memory/constitution.md" ] && missing_files+=("宪法文件")
     [ ! -f "$STORY_DIR/specification.md" ] && missing_files+=("规格文件")
     [ ! -f "$STORY_DIR/creative-plan.md" ] && missing_files+=("计划文件")
 

package/templates/resources/scripts/bash/check-analyze-stage.sh

@@ -0,0 +1,108 @@
+#!/usr/bin/env bash
+# 检测 analyze 命令应该执行的阶段
+# 返回 JSON 格式的阶段信息
+
+set -euo pipefail
+
+# 解析参数
+JSON_OUTPUT=false
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --json|-j)
+            JSON_OUTPUT=true
+            shift
+            ;;
+        *)
+            echo "未知参数: $1" >&2
+            exit 1
+            ;;
+    esac
+done
+
+# 加载公共函数
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/common.sh"
+
+# 获取项目根目录和故事目录
+if ! PROJECT_ROOT=$(get_project_root); then
+    echo "错误: 无法获取项目根目录" >&2
+    exit 1
+fi
+
+if ! STORY_DIR=$(get_current_story_dir); then
+    echo "错误: 未找到故事目录" >&2
+    exit 1
+fi
+
+# 默认返回值
+ANALYZE_TYPE="content"
+CHAPTER_COUNT=0
+HAS_SPEC=false
+HAS_PLAN=false
+HAS_TASKS=false
+REASON=""
+
+# 检查规格文件
+SPEC_PATH="${STORY_DIR}/specification.md"
+if [[ -f "$SPEC_PATH" ]]; then
+    HAS_SPEC=true
+fi
+
+# 检查计划文件
+PLAN_PATH="${STORY_DIR}/creative-plan.md"
+if [[ -f "$PLAN_PATH" ]]; then
+    HAS_PLAN=true
+fi
+
+# 检查任务文件
+TASKS_PATH="${STORY_DIR}/tasks.md"
+if [[ -f "$TASKS_PATH" ]]; then
+    HAS_TASKS=true
+fi
+
+# 统计章节数量
+CONTENT_DIR="${STORY_DIR}/content"
+if [[ ! -d "$CONTENT_DIR" ]]; then
+    CONTENT_DIR="${STORY_DIR}/chapters"
+fi
+
+if [[ -d "$CONTENT_DIR" ]]; then
+    # 统计 .md 文件数量（排除索引文件）
+    CHAPTER_COUNT=$(find "$CONTENT_DIR" -maxdepth 1 -type f -name "*.md" \
+        ! -name "README.md" ! -name "index.md" 2>/dev/null | wc -l)
+fi
+
+# 决策逻辑
+if [[ $CHAPTER_COUNT -eq 0 ]]; then
+    # 无章节内容 → 框架分析
+    ANALYZE_TYPE="framework"
+    REASON="无章节内容，建议进行框架一致性分析"
+elif [[ $CHAPTER_COUNT -lt 3 ]]; then
+    # 章节数量不足 → 框架分析（但提示可以开始写作）
+    ANALYZE_TYPE="framework"
+    REASON="章节数量较少（${CHAPTER_COUNT} 章），建议继续写作或进行框架验证"
+else
+    # 章节充足 → 内容分析
+    ANALYZE_TYPE="content"
+    REASON="已完成 ${CHAPTER_COUNT} 章，可进行内容质量分析"
+fi
+
+# 输出 JSON 或人类可读格式
+if [[ "$JSON_OUTPUT" == true ]]; then
+    # JSON 格式输出
+    cat <<EOF
+{"analyze_type":"${ANALYZE_TYPE}","chapter_count":${CHAPTER_COUNT},"has_spec":${HAS_SPEC},"has_plan":${HAS_PLAN},"has_tasks":${HAS_TASKS},"story_dir":"${STORY_DIR}","reason":"${REASON}"}
+EOF
+else
+    # 人类可读输出
+    echo "分析阶段检测结果"
+    echo "=================="
+    echo "故事目录: ${STORY_DIR}"
+    echo "章节数量: ${CHAPTER_COUNT}"
+    echo "规格文件: $(if [[ "$HAS_SPEC" == true ]]; then echo '✅'; else echo '❌'; fi)"
+    echo "计划文件: $(if [[ "$HAS_PLAN" == true ]]; then echo '✅'; else echo '❌'; fi)"
+    echo "任务文件: $(if [[ "$HAS_TASKS" == true ]]; then echo '✅'; else echo '❌'; fi)"
+    echo ""
+    echo "推荐模式: ${ANALYZE_TYPE}"
+    echo "原因: ${REASON}"
+fi

package/templates/{scripts → resources/scripts}/bash/check-consistency.sh

@@ -23,10 +23,10 @@ fi
 
 # 文件路径
 PROGRESS="$STORY_DIR/progress.json"
-PLOT_TRACKER="$STORY_DIR/spec/tracking/plot-tracker.json"
-TIMELINE="$STORY_DIR/spec/tracking/timeline.json"
-RELATIONSHIPS="$STORY_DIR/spec/tracking/relationships.json"
-CHARACTER_STATE="$STORY_DIR/spec/tracking/character-state.json"
+PLOT_TRACKER="$STORY_DIR/tracking/plot-tracker.json"
+TIMELINE="$STORY_DIR/tracking/timeline.json"
+RELATIONSHIPS="$STORY_DIR/tracking/relationships.json"
+CHARACTER_STATE="$STORY_DIR/tracking/character-state.json"
 
 # ANSI颜色代码
 RED='\033[0;31m'
@@ -252,14 +252,14 @@ generate_report() {
     echo "检查时间: $(date '+%Y-%m-%d %H:%M:%S')"
 
     # 记录检查结果
-    if [ -f "$STORY_DIR/spec/tracking" ]; then
+    if [ -f "$STORY_DIR/tracking" ]; then
         echo "{
             \"timestamp\": \"$(date -Iseconds)\",
             \"total\": $TOTAL_CHECKS,
             \"passed\": $PASSED_CHECKS,
             \"warnings\": $WARNINGS,
             \"errors\": $ERRORS
-        }" > "$STORY_DIR/spec/tracking/.last-check.json"
+        }" > "$STORY_DIR/tracking/.last-check.json"
     fi
 }
 
@@ -308,7 +308,7 @@ output_checklist() {
 # 数据同步一致性检查 Checklist
 
 **检查时间**: $(date '+%Y-%m-%d %H:%M:%S')
-**检查对象**: spec/tracking/ 目录所有JSON文件
+**检查对象**: tracking/ 目录所有JSON文件
 **检查范围**: 文件完整性、章节同步、时间线连续性、角色状态、伏笔管理
 
 ---

package/templates/{scripts → resources/scripts}/bash/check-facts.sh

@@ -38,7 +38,7 @@ while [[ $# -gt 0 ]]; do
 done
 
 # 检查 story-facts.json 是否存在
-FACTS_FILE="$PROJECT_ROOT/spec/tracking/story-facts.json"
+FACTS_FILE="$PROJECT_ROOT/tracking/story-facts.json"
 if [[ ! -f "$FACTS_FILE" ]]; then
     if [[ "$OUTPUT_JSON" == true ]]; then
         echo '{"error": "story-facts.json not found", "chapters": [], "unreferenced_facts": [], "unknown_ids": []}'

package/templates/{scripts → resources/scripts}/bash/check-plot.sh

@@ -22,7 +22,7 @@ if [ -z "$STORY_DIR" ]; then
 fi
 
 # 文件路径
-PLOT_TRACKER="$STORY_DIR/spec/tracking/plot-tracker.json"
+PLOT_TRACKER="$STORY_DIR/tracking/plot-tracker.json"
 OUTLINE="$STORY_DIR/creative-plan.md"
 PROGRESS="$STORY_DIR/progress.json"
 
@@ -32,7 +32,7 @@ check_required_files() {
 
     if [ ! -f "$PLOT_TRACKER" ]; then
         echo "⚠️  未找到情节追踪文件，正在创建..." >&2
-        mkdir -p "$STORY_DIR/spec/tracking"
+        mkdir -p "$STORY_DIR/tracking"
         # 复制模板
         if [ -f "$SCRIPT_DIR/../../templates/tracking/plot-tracker.json" ]; then
             cp "$SCRIPT_DIR/../../templates/tracking/plot-tracker.json" "$PLOT_TRACKER"

package/templates/{scripts → resources/scripts}/bash/check-timeline.sh

@@ -24,7 +24,7 @@ if [ -z "$STORY_DIR" ]; then
 fi
 
 # 文件路径
-TIMELINE="$STORY_DIR/spec/tracking/timeline.json"
+TIMELINE="$STORY_DIR/tracking/timeline.json"
 PROGRESS="$STORY_DIR/progress.json"
 
 # 命令参数（已在上面处理 checklist 模式）
@@ -34,7 +34,7 @@ PARAM2="${2:-}"
 init_timeline() {
     if [ ! -f "$TIMELINE" ]; then
         echo "⚠️  未找到时间线文件，正在创建..." >&2
-        mkdir -p "$STORY_DIR/spec/tracking"
+        mkdir -p "$STORY_DIR/tracking"
 
         if [ -f "$SCRIPT_DIR/../../templates/tracking/timeline.json" ]; then
             cp "$SCRIPT_DIR/../../templates/tracking/timeline.json" "$TIMELINE"
@@ -241,7 +241,7 @@ output_checklist() {
 # 时间线检查 Checklist
 
 **检查时间**: $(date '+%Y-%m-%d %H:%M:%S')
-**检查对象**: spec/tracking/timeline.json
+**检查对象**: tracking/timeline.json
 **记录事件数**: $event_count
 
 ---

package/templates/{scripts → resources/scripts}/bash/check-world.sh

@@ -22,10 +22,10 @@ if [ "$1" = "--checklist" ]; then
 fi
 
 # 文件路径
-WORLD_SETTING="$STORY_DIR/spec/knowledge/world-setting.md"
-LOCATIONS="$STORY_DIR/spec/knowledge/locations.md"
-CULTURE="$STORY_DIR/spec/knowledge/culture.md"
-RULES="$STORY_DIR/spec/knowledge/rules.md"
+WORLD_SETTING="$STORY_DIR/resources/knowledge/world-setting.md"
+LOCATIONS="$STORY_DIR/resources/knowledge/locations.md"
+CULTURE="$STORY_DIR/resources/knowledge/culture.md"
+RULES="$STORY_DIR/resources/knowledge/rules.md"
 CONTENT_DIR="$STORY_DIR/content"
 
 # ANSI颜色代码
@@ -268,7 +268,7 @@ output_checklist() {
 # 世界观一致性检查 Checklist
 
 **检查时间**: $(date '+%Y-%m-%d %H:%M:%S')
-**检查对象**: spec/knowledge/ 目录及已写章节内容
+**检查对象**: resources/knowledge/ 目录及已写章节内容
 **检查范围**: 世界观设定、地理逻辑、文化风俗、特殊规则
 
 ---

package/templates/{scripts → resources/scripts}/bash/check-writing-state.sh

@@ -99,7 +99,7 @@ mark_resource_loaded() {
 # 防御性设计：缓存目录不存在时直接返回
 
 cleanup_old_cache() {
-    local cache_dir="$PROJECT_ROOT/.specify/.cache"
+    local cache_dir="$PROJECT_ROOT/.claude/.cache"
 
     # 缓存目录不存在，无需清理
     if [ ! -d "$cache_dir" ]; then
@@ -234,17 +234,17 @@ if [ "$PRELOAD_FILES_PENDING" = true ]; then
     # 构建待预加载的文件列表
     PRELOAD_FILE_LIST=(
         # 知识库文件
-        "$PROJECT_ROOT/.specify/templates/knowledge-base/craft/dialogue.md"
-        "$PROJECT_ROOT/.specify/templates/knowledge-base/craft/scene-structure.md"
-        "$PROJECT_ROOT/.specify/templates/knowledge-base/craft/character-arc.md"
-        "$PROJECT_ROOT/.specify/templates/knowledge-base/craft/pacing.md"
-        "$PROJECT_ROOT/.specify/templates/knowledge-base/craft/show-not-tell.md"
+        "$PROJECT_ROOT/resources/craft/dialogue.md"
+        "$PROJECT_ROOT/resources/craft/scene-structure.md"
+        "$PROJECT_ROOT/resources/craft/character-arc.md"
+        "$PROJECT_ROOT/resources/craft/pacing.md"
+        "$PROJECT_ROOT/resources/craft/show-not-tell.md"
         # Skill 文件
-        "$PROJECT_ROOT/.specify/templates/skills/writing-techniques/dialogue-techniques/SKILL.md"
-        "$PROJECT_ROOT/.specify/templates/skills/writing-techniques/scene-structure/SKILL.md"
-        "$PROJECT_ROOT/.specify/templates/skills/writing-techniques/character-arc/SKILL.md"
-        "$PROJECT_ROOT/.specify/templates/skills/writing-techniques/pacing-control/SKILL.md"
-        "$PROJECT_ROOT/.specify/templates/skills/quality-assurance/consistency-checker/SKILL.md"
+        "$PROJECT_ROOT/.claude/skills/writing-techniques/dialogue-techniques/SKILL.md"
+        "$PROJECT_ROOT/.claude/skills/writing-techniques/scene-structure/SKILL.md"
+        "$PROJECT_ROOT/.claude/skills/writing-techniques/character-arc/SKILL.md"
+        "$PROJECT_ROOT/.claude/skills/writing-techniques/pacing-control/SKILL.md"
+        "$PROJECT_ROOT/.claude/skills/quality-assurance/consistency-checker/SKILL.md"
         # 规格文件
         "$STORY_DIR/specification.md"
     )
@@ -261,7 +261,7 @@ cleanup_old_cache
 check_methodology_docs() {
     local missing=()
 
-    [ ! -f ".specify/memory/constitution.md" ] && missing+=("宪法")
+    [ ! -f "resources/memory/constitution.md" ] && missing+=("宪法")
     [ ! -f "$STORY_DIR/specification.md" ] && missing+=("规格")
     [ ! -f "$STORY_DIR/creative-plan.md" ] && missing+=("计划")
     [ ! -f "$STORY_DIR/tasks.md" ] && missing+=("任务")
@@ -321,7 +321,7 @@ check_pending_tasks() {
 # 检查已完成内容
 check_completed_content() {
     local content_dir="$STORY_DIR/content"
-    local validation_rules="$STORY_DIR/spec/tracking/validation-rules.json"
+    local validation_rules="$STORY_DIR/tracking/validation-rules.json"
     local min_words=2000
     local max_words=4000
 
@@ -376,7 +376,7 @@ output_checklist() {
     local max_words=4000
 
     # 检查文档
-    [ -f ".specify/memory/constitution.md" ] && has_constitution=true
+    [ -f "resources/memory/constitution.md" ] && has_constitution=true
     [ -f "$STORY_DIR/specification.md" ] && has_specification=true
     [ -f "$STORY_DIR/creative-plan.md" ] && has_plan=true
     [ -f "$STORY_DIR/tasks.md" ] && has_tasks=true
@@ -389,7 +389,7 @@ output_checklist() {
     fi
 
     # 读取验证规则
-    local validation_rules="$STORY_DIR/spec/tracking/validation-rules.json"
+    local validation_rules="$STORY_DIR/tracking/validation-rules.json"
     if [ -f "$validation_rules" ] && command -v jq >/dev/null 2>&1; then
         min_words=$(jq -r '.rules.chapterMinWords // 2000' "$validation_rules")
         max_words=$(jq -r '.rules.chapterMaxWords // 4000' "$validation_rules")
@@ -553,11 +553,11 @@ check_knowledge_base_available() {
 
     # 检查所有 craft knowledge-base
     local craft_files=(
-        ".specify/templates/knowledge-base/craft/dialogue.md"
-        ".specify/templates/knowledge-base/craft/scene-structure.md"
-        ".specify/templates/knowledge-base/craft/character-arc.md"
-        ".specify/templates/knowledge-base/craft/pacing.md"
-        ".specify/templates/knowledge-base/craft/show-not-tell.md"
+        "resources/craft/dialogue.md"
+        "resources/craft/scene-structure.md"
+        "resources/craft/character-arc.md"
+        "resources/craft/pacing.md"
+        "resources/craft/show-not-tell.md"
     )
 
     for file in "${craft_files[@]}"; do
@@ -590,10 +590,10 @@ check_skills_available() {
 
     # 检查 writing-techniques skills
     local skill_dirs=(
-        ".specify/templates/skills/writing-techniques/dialogue-techniques"
-        ".specify/templates/skills/writing-techniques/scene-structure"
-        ".specify/templates/skills/writing-techniques/character-arc"
-        ".specify/templates/skills/writing-techniques/pacing-control"
+        ".claude/skills/writing-techniques/dialogue-techniques"
+        ".claude/skills/writing-techniques/scene-structure"
+        ".claude/skills/writing-techniques/character-arc"
+        ".claude/skills/writing-techniques/pacing-control"
     )
 
     for dir in "${skill_dirs[@]}"; do
@@ -667,7 +667,7 @@ generate_load_report() {
     # 检查文件是否存在，生成警告（使用缓存 + Phase 2 去重）
     local warnings=()
     for kb in "${knowledge_base_files[@]}"; do
-        local kb_path=".specify/templates/knowledge-base/$kb"
+        local kb_path="resources/$kb"
 
         # Phase 2: 资源去重检查
         if is_resource_loaded "$kb_path"; then
@@ -685,7 +685,7 @@ generate_load_report() {
     done
 
     for skill in "${skills_files[@]}"; do
-        local skill_path=".specify/templates/skills/$skill/SKILL.md"
+        local skill_path=".claude/skills/$skill/SKILL.md"
 
         # Phase 2: 资源去重检查
         if is_resource_loaded "$skill_path"; then

package/templates/{scripts → resources/scripts}/bash/common.sh

@@ -3,13 +3,13 @@
 
 # 获取项目根目录
 get_project_root() {
-    if [ -f ".specify/config.json" ]; then
+    if [ -f "resources/config/config.json" ]; then
         pwd
     else
-        # 向上查找包含 .specify 的目录
+        # 向上查找包含 resources 的目录
         current=$(pwd)
         while [ "$current" != "/" ]; do
-            if [ -f "$current/.specify/config.json" ]; then
+            if [ -f "$current/resources/config/config.json" ]; then
                 echo "$current"
                 return 0
             fi

package/templates/{scripts → resources/scripts}/bash/constitution.sh

@@ -17,7 +17,7 @@ PROJECT_ROOT=$(get_project_root)
 cd "$PROJECT_ROOT"
 
 # 定义文件路径
-CONSTITUTION_FILE=".specify/memory/constitution.md"
+CONSTITUTION_FILE="resources/memory/constitution.md"
 
 case "$COMMAND" in
     check)

package/templates/{scripts → resources/scripts}/bash/init-tracking.sh

@@ -25,7 +25,7 @@ if [ "$story_exists" = false ] || [ "$outline_exists" = false ]; then
 fi
 
 # 创建追踪目录
-mkdir -p spec/tracking
+mkdir -p tracking
 
 # 获取故事名称
 story_dir=$(dirname "$story_file")
@@ -34,9 +34,9 @@ story_name=$(basename "$story_dir")
 echo "📖 为《${story_name}》初始化追踪系统..."
 
 # 初始化 plot-tracker.json
-if [ ! -f "spec/tracking/plot-tracker.json" ]; then
+if [ ! -f "tracking/plot-tracker.json" ]; then
     echo "📝 创建 plot-tracker.json..."
-    cat > spec/tracking/plot-tracker.json <<EOF
+    cat > tracking/plot-tracker.json <<EOF
 {
   "novel": "${story_name}",
   "lastUpdated": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
@@ -82,9 +82,9 @@ EOF
 fi
 
 # 初始化 timeline.json
-if [ ! -f "spec/tracking/timeline.json" ]; then
+if [ ! -f "tracking/timeline.json" ]; then
     echo "⏰ 创建 timeline.json..."
-    cat > spec/tracking/timeline.json <<EOF
+    cat > tracking/timeline.json <<EOF
 {
   "novel": "${story_name}",
   "lastUpdated": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
@@ -110,9 +110,9 @@ EOF
 fi
 
 # 初始化 relationships.json
-if [ ! -f "spec/tracking/relationships.json" ]; then
+if [ ! -f "tracking/relationships.json" ]; then
     echo "👥 创建 relationships.json..."
-    cat > spec/tracking/relationships.json <<EOF
+    cat > tracking/relationships.json <<EOF
 {
   "novel": "${story_name}",
   "lastUpdated": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
@@ -135,9 +135,9 @@ EOF
 fi
 
 # 初始化 character-state.json
-if [ ! -f "spec/tracking/character-state.json" ]; then
+if [ ! -f "tracking/character-state.json" ]; then
     echo "📍 创建 character-state.json..."
-    cat > spec/tracking/character-state.json <<EOF
+    cat > tracking/character-state.json <<EOF
 {
   "novel": "${story_name}",
   "lastUpdated": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
@@ -170,10 +170,10 @@ echo ""
 echo "✅ 追踪系统初始化完成！"
 echo ""
 echo "📊 已创建以下追踪文件："
-echo "   • spec/tracking/plot-tracker.json - 情节追踪"
-echo "   • spec/tracking/timeline.json - 时间线管理"
-echo "   • spec/tracking/relationships.json - 关系网络"
-echo "   • spec/tracking/character-state.json - 角色状态"
+echo "   • tracking/plot-tracker.json - 情节追踪"
+echo "   • tracking/timeline.json - 时间线管理"
+echo "   • tracking/relationships.json - 关系网络"
+echo "   • tracking/character-state.json - 角色状态"
 echo ""
 echo "💡 下一步："
 echo "   1. 使用 /write 开始创作（会自动更新追踪数据）"

package/templates/{scripts → resources/scripts}/bash/manage-relations.sh

@@ -10,19 +10,19 @@ PROJECT_ROOT=$(get_project_root)
 STORY_DIR=$(get_current_story)
 
 REL_FILE=""
-if [ -n "$STORY_DIR" ] && [ -f "$STORY_DIR/spec/tracking/relationships.json" ]; then
-  REL_FILE="$STORY_DIR/spec/tracking/relationships.json"
-elif [ -f "$PROJECT_ROOT/spec/tracking/relationships.json" ]; then
-  REL_FILE="$PROJECT_ROOT/spec/tracking/relationships.json"
+if [ -n "$STORY_DIR" ] && [ -f "$STORY_DIR/tracking/relationships.json" ]; then
+  REL_FILE="$STORY_DIR/tracking/relationships.json"
+elif [ -f "$PROJECT_ROOT/tracking/relationships.json" ]; then
+  REL_FILE="$PROJECT_ROOT/tracking/relationships.json"
 else
   # 尝试用模板初始化
-  mkdir -p "$PROJECT_ROOT/spec/tracking"
-  if [ -f "$PROJECT_ROOT/.specify/templates/tracking/relationships.json" ]; then
-    cp "$PROJECT_ROOT/.specify/templates/tracking/relationships.json" "$PROJECT_ROOT/spec/tracking/relationships.json"
-    REL_FILE="$PROJECT_ROOT/spec/tracking/relationships.json"
+  mkdir -p "$PROJECT_ROOT/tracking"
+  if [ -f "$PROJECT_ROOT/tracking/relationships.json" ]; then
+    cp "$PROJECT_ROOT/tracking/relationships.json" "$PROJECT_ROOT/tracking/relationships.json"
+    REL_FILE="$PROJECT_ROOT/tracking/relationships.json"
   elif [ -f "$SCRIPT_DIR/../../templates/tracking/relationships.json" ]; then
-    cp "$SCRIPT_DIR/../../templates/tracking/relationships.json" "$PROJECT_ROOT/spec/tracking/relationships.json"
-    REL_FILE="$PROJECT_ROOT/spec/tracking/relationships.json"
+    cp "$SCRIPT_DIR/../../templates/tracking/relationships.json" "$PROJECT_ROOT/tracking/relationships.json"
+    REL_FILE="$PROJECT_ROOT/tracking/relationships.json"
   else
     echo "❌ 未找到 relationships.json，且无法从模板创建" >&2
     exit 1