novelws 1.2.0

package/templates/scripts/bash/clarify-story.sh

@@ -0,0 +1,117 @@
+#!/bin/bash
+
+# 澄清故事大纲的支撑脚本
+# 用于 /clarify 命令，扫描并返回当前故事路径
+
+set -e
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# Parse arguments
+JSON_MODE=false
+PATHS_ONLY=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --json)
+            JSON_MODE=true
+            shift
+            ;;
+        --paths-only)
+            PATHS_ONLY=true
+            shift
+            ;;
+        *)
+            shift
+            ;;
+    esac
+done
+
+# Get project root
+PROJECT_ROOT=$(get_project_root)
+cd "$PROJECT_ROOT"
+
+# Find the current story directory
+STORIES_DIR="stories"
+if [ ! -d "$STORIES_DIR" ]; then
+    if [ "$JSON_MODE" = true ]; then
+        echo '{"error": "No stories directory found"}'
+    else
+        echo "错误：未找到 stories 目录，请先运行 /story 创建故事大纲"
+    fi
+    exit 1
+fi
+
+# Get the latest story (assuming single story for now, can be enhanced)
+STORY_DIR=$(find "$STORIES_DIR" -maxdepth 1 -type d ! -name "stories" | sort -r | head -n 1)
+
+if [ -z "$STORY_DIR" ]; then
+    if [ "$JSON_MODE" = true ]; then
+        echo '{"error": "No story found"}'
+    else
+        echo "错误：未找到故事，请先运行 /story 创建故事大纲"
+    fi
+    exit 1
+fi
+
+# Extract story name from directory
+STORY_NAME=$(basename "$STORY_DIR")
+
+# Find story file (新格式 specification.md)
+STORY_FILE="$STORY_DIR/specification.md"
+if [ ! -f "$STORY_FILE" ]; then
+    if [ "$JSON_MODE" = true ]; then
+        echo '{"error": "Story file not found (specification.md required)"}'
+    else
+        echo "错误：未找到故事文件 specification.md"
+    fi
+    exit 1
+fi
+
+# Check if clarification already exists
+CLARIFICATION_EXISTS=false
+if grep -q "## 澄清记录" "$STORY_FILE" 2>/dev/null; then
+    CLARIFICATION_EXISTS=true
+fi
+
+# Count existing clarification sessions
+CLARIFICATION_COUNT=0
+if [ "$CLARIFICATION_EXISTS" = true ]; then
+    CLARIFICATION_COUNT=$(grep -c "### 澄清会话" "$STORY_FILE" 2>/dev/null || echo "0")
+fi
+
+# Output in JSON format if requested
+if [ "$JSON_MODE" = true ]; then
+    if [ "$PATHS_ONLY" = true ]; then
+        # Minimal output for command template
+        cat <<EOF
+{
+    "STORY_PATH": "$STORY_FILE",
+    "STORY_NAME": "$STORY_NAME",
+    "STORY_DIR": "$STORY_DIR"
+}
+EOF
+    else
+        # Full output for analysis
+        cat <<EOF
+{
+    "STORY_PATH": "$STORY_FILE",
+    "STORY_NAME": "$STORY_NAME",
+    "STORY_DIR": "$STORY_DIR",
+    "CLARIFICATION_EXISTS": $CLARIFICATION_EXISTS,
+    "CLARIFICATION_COUNT": $CLARIFICATION_COUNT,
+    "PROJECT_ROOT": "$PROJECT_ROOT"
+}
+EOF
+    fi
+else
+    echo "找到故事：$STORY_NAME"
+    echo "文件路径：$STORY_FILE"
+    if [ "$CLARIFICATION_EXISTS" = true ]; then
+        echo "已有澄清会话：$CLARIFICATION_COUNT 次"
+    else
+        echo "尚未进行过澄清"
+    fi
+fi

package/templates/scripts/bash/common.sh

@@ -0,0 +1,151 @@
+#!/usr/bin/env bash
+# 通用函数库
+
+# 获取项目根目录
+get_project_root() {
+    if [ -f ".specify/config.json" ]; then
+        pwd
+    else
+        # 向上查找包含 .specify 的目录
+        current=$(pwd)
+        while [ "$current" != "/" ]; do
+            if [ -f "$current/.specify/config.json" ]; then
+                echo "$current"
+                return 0
+            fi
+            current=$(dirname "$current")
+        done
+        echo "错误: 未找到小说项目根目录" >&2
+        exit 1
+    fi
+}
+
+# 获取当前故事目录
+get_current_story() {
+    PROJECT_ROOT=$(get_project_root)
+    STORIES_DIR="$PROJECT_ROOT/stories"
+
+    # 找到最新的故事目录
+    if [ -d "$STORIES_DIR" ]; then
+        latest=$(ls -t "$STORIES_DIR" 2>/dev/null | head -1)
+        if [ -n "$latest" ]; then
+            echo "$STORIES_DIR/$latest"
+        fi
+    fi
+}
+
+# 获取活跃故事名称（只返回名称，不返回路径）
+get_active_story() {
+    story_dir=$(get_current_story)
+    if [ -n "$story_dir" ]; then
+        basename "$story_dir"
+    else
+        # 如果没有故事，返回默认名称
+        echo "story-$(date +%Y%m%d)"
+    fi
+}
+
+# 创建带编号的目录
+create_numbered_dir() {
+    base_dir="$1"
+    prefix="$2"
+
+    mkdir -p "$base_dir"
+
+    # 找到最高编号
+    highest=0
+    for dir in "$base_dir"/*; do
+        [ -d "$dir" ] || continue
+        dirname=$(basename "$dir")
+        number=$(echo "$dirname" | grep -o '^[0-9]\+' || echo "0")
+        number=$((10#$number))
+        if [ "$number" -gt "$highest" ]; then
+            highest=$number
+        fi
+    done
+
+    # 返回下一个编号
+    next=$((highest + 1))
+    printf "%03d" "$next"
+}
+
+# 输出 JSON（用于与 AI 助手通信）
+output_json() {
+    echo "$1"
+}
+
+# 确保文件存在
+ensure_file() {
+    file="$1"
+    template="$2"
+
+    if [ ! -f "$file" ]; then
+        if [ -f "$template" ]; then
+            cp "$template" "$file"
+        else
+            touch "$file"
+        fi
+    fi
+}
+
+# 准确的中文字数统计
+# 排除Markdown标记、空格、换行符，只统计实际内容
+count_chinese_words() {
+    local file="$1"
+
+    if [ ! -f "$file" ]; then
+        echo "0"
+        return
+    fi
+
+    # 移除Markdown标记和格式符号，然后统计字符
+    # 1. 移除代码块
+    # 2. 移除标题标记 (#)
+    # 3. 移除强调标记 (* 和 _)
+    # 4. 移除链接标记 ([ ] ( ))
+    # 5. 移除引用标记 (>)
+    # 6. 移除列表标记 (- *)
+    # 7. 移除空格、换行、制表符
+    # 8. 统计剩余字符数
+    local word_count=$(cat "$file" | \
+        sed '/^```/,/^```/d' | \
+        sed 's/^#\+[[:space:]]*//' | \
+        sed 's/\*\*//g' | \
+        sed 's/__//g' | \
+        sed 's/\*//g' | \
+        sed 's/_//g' | \
+        sed 's/\[//g' | \
+        sed 's/\]//g' | \
+        sed 's/(http[^)]*)//g' | \
+        sed 's/^>[[:space:]]*//' | \
+        sed 's/^[[:space:]]*[-*][[:space:]]*//' | \
+        sed 's/^[[:space:]]*[0-9]\+\.[[:space:]]*//' | \
+        tr -d '[:space:]' | \
+        tr -d '[:punct:]' | \
+        grep -o . | \
+        wc -l | \
+        tr -d ' ')
+
+    echo "$word_count"
+}
+
+# 显示友好的字数信息
+# 参数: 文件路径, 最小字数(可选), 最大字数(可选)
+show_word_count_info() {
+    local file="$1"
+    local min_words="${2:-0}"
+    local max_words="${3:-999999}"
+    local actual_words=$(count_chinese_words "$file")
+
+    echo "字数：$actual_words"
+
+    if [ "$min_words" -gt 0 ]; then
+        if [ "$actual_words" -lt "$min_words" ]; then
+            echo "⚠️ 未达到最低字数要求（最小：${min_words}）"
+        elif [ "$actual_words" -gt "$max_words" ]; then
+            echo "⚠️ 超过最大字数限制（最大：${max_words}）"
+        else
+            echo "✅ 符合字数要求（${min_words}-${max_words}）"
+        fi
+    fi
+}

package/templates/scripts/bash/constitution.sh

@@ -0,0 +1,114 @@
+#!/bin/bash
+
+# 小说创作宪法管理脚本
+# 用于 /constitution 命令
+
+set -e
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# 获取命令参数
+COMMAND="${1:-check}"
+
+# Get project root
+PROJECT_ROOT=$(get_project_root)
+cd "$PROJECT_ROOT"
+
+# 定义文件路径
+CONSTITUTION_FILE=".specify/memory/constitution.md"
+
+case "$COMMAND" in
+    check)
+        # 检查宪法文件是否存在
+        if [ -f "$CONSTITUTION_FILE" ]; then
+            echo "✅ 宪法文件已存在：$CONSTITUTION_FILE"
+            # 提取版本信息
+            VERSION=$(grep -E "^- 版本：" "$CONSTITUTION_FILE" 2>/dev/null | cut -d'：' -f2 | tr -d ' ' || echo "未知")
+            UPDATED=$(grep -E "^- 最后修订：" "$CONSTITUTION_FILE" 2>/dev/null | cut -d'：' -f2 | tr -d ' ' || echo "未知")
+            echo "  版本：$VERSION"
+            echo "  最后修订：$UPDATED"
+            exit 0
+        else
+            echo "❌ 尚未创建宪法文件"
+            echo "  建议：运行 /constitution 创建创作宪法"
+            exit 1
+        fi
+        ;;
+
+    init)
+        # 初始化宪法文件
+        mkdir -p "$(dirname "$CONSTITUTION_FILE")"
+
+        if [ -f "$CONSTITUTION_FILE" ]; then
+            echo "宪法文件已存在，准备更新"
+        else
+            echo "准备创建新的宪法文件"
+        fi
+        ;;
+
+    validate)
+        # 验证宪法文件格式
+        if [ ! -f "$CONSTITUTION_FILE" ]; then
+            echo "错误：宪法文件不存在"
+            exit 1
+        fi
+
+        echo "验证宪法文件..."
+
+        # 检查必要章节
+        REQUIRED_SECTIONS=("核心价值观" "质量标准" "创作风格" "内容规范" "读者契约")
+        MISSING_SECTIONS=()
+
+        for section in "${REQUIRED_SECTIONS[@]}"; do
+            if ! grep -q "## .* $section" "$CONSTITUTION_FILE"; then
+                MISSING_SECTIONS+=("$section")
+            fi
+        done
+
+        if [ ${#MISSING_SECTIONS[@]} -gt 0 ]; then
+            echo "⚠️ 缺少以下章节："
+            for section in "${MISSING_SECTIONS[@]}"; do
+                echo "  - $section"
+            done
+        else
+            echo "✅ 所有必要章节都存在"
+        fi
+
+        # 检查版本信息
+        if grep -q "^- 版本：" "$CONSTITUTION_FILE"; then
+            echo "✅ 版本信息完整"
+        else
+            echo "⚠️ 缺少版本信息"
+        fi
+        ;;
+
+    export)
+        # 导出宪法摘要
+        if [ ! -f "$CONSTITUTION_FILE" ]; then
+            echo "错误：宪法文件不存在"
+            exit 1
+        fi
+
+        echo "# 创作宪法摘要"
+        echo ""
+
+        # 提取核心原则
+        echo "## 核心原则"
+        grep -A 1 "^### 原则" "$CONSTITUTION_FILE" | grep "^**声明**" | cut -d'：' -f2- || echo "（未找到原则声明）"
+
+        echo ""
+        echo "## 质量底线"
+        grep -A 1 "^### 标准" "$CONSTITUTION_FILE" | grep "^**要求**" | cut -d'：' -f2- || echo "（未找到质量标准）"
+
+        echo ""
+        echo "详细内容请查看：$CONSTITUTION_FILE"
+        ;;
+
+    *)
+        echo "未知命令：$COMMAND"
+        echo "支持的命令：check, init, validate, export"
+        exit 1
+        ;;
+esac

package/templates/scripts/bash/generate-tasks.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+# 生成写作任务
+
+set -e
+
+# 加载通用函数
+SCRIPT_DIR=$(dirname "$0")
+source "$SCRIPT_DIR/common.sh"
+
+# 获取当前故事目录
+STORY_DIR=$(get_current_story)
+
+if [ -z "$STORY_DIR" ]; then
+    echo "错误: 未找到故事项目" >&2
+    exit 1
+fi
+
+# 检查前置条件
+if [ ! -f "$STORY_DIR/specification.md" ]; then
+    echo "错误: 未找到故事规格，请先使用 /specify 命令" >&2
+    exit 1
+fi
+
+if [ ! -f "$STORY_DIR/outline.md" ]; then
+    echo "错误: 未找到章节规划，请先使用 /outline 命令" >&2
+    exit 1
+fi
+
+# 获取当前日期
+CURRENT_DATE=$(date '+%Y-%m-%d')
+CURRENT_DATETIME=$(date '+%Y-%m-%d %H:%M:%S')
+
+# 创建任务文件，预先填充基础信息
+TASKS_FILE="$STORY_DIR/tasks.md"
+cat > "$TASKS_FILE" << EOF
+# 写作任务清单
+
+## 任务概览
+- **创建日期**：${CURRENT_DATE}
+- **最后更新**：${CURRENT_DATE}
+- **任务状态**：待生成
+
+---
+EOF
+
+# 创建进度追踪文件
+PROGRESS_FILE="$STORY_DIR/progress.json"
+if [ ! -f "$PROGRESS_FILE" ]; then
+    cat > "$PROGRESS_FILE" << EOF
+{
+  "created_at": "${CURRENT_DATETIME}",
+  "updated_at": "${CURRENT_DATETIME}",
+  "total_chapters": 0,
+  "completed": 0,
+  "in_progress": 0,
+  "word_count": 0
+}
+EOF
+fi
+
+# 输出结果
+echo "TASKS_FILE: $TASKS_FILE"
+echo "PROGRESS_FILE: $PROGRESS_FILE"
+echo "CURRENT_DATE: $CURRENT_DATE"
+echo "STATUS: ready"

package/templates/scripts/bash/init-tracking.sh

@@ -0,0 +1,183 @@
+#!/bin/bash
+
+echo "🚀 初始化追踪系统..."
+
+# 检查前置条件
+story_exists=false
+outline_exists=false
+
+# 查找 specification 文件
+if ls stories/*/specification.md 1> /dev/null 2>&1; then
+    story_exists=true
+    story_file=$(ls stories/*/specification.md | head -1)
+fi
+
+# 查找 outline 文件
+if ls stories/*/outline.md 1> /dev/null 2>&1; then
+    outline_exists=true
+    outline_file=$(ls stories/*/outline.md | head -1)
+fi
+
+if [ "$story_exists" = false ] || [ "$outline_exists" = false ]; then
+    echo "❌ 请先完成 /specify 和 /plan 命令"
+    echo "   缺少: ${story_exists:+}${story_exists:-specification.md} ${outline_exists:+}${outline_exists:-outline.md}"
+    exit 1
+fi
+
+# 创建追踪目录
+mkdir -p spec/tracking
+
+# 获取故事名称
+story_dir=$(dirname "$story_file")
+story_name=$(basename "$story_dir")
+
+echo "📖 为《${story_name}》初始化追踪系统..."
+
+# 初始化 plot-tracker.json
+if [ ! -f "spec/tracking/plot-tracker.json" ]; then
+    echo "📝 创建 plot-tracker.json..."
+    cat > spec/tracking/plot-tracker.json <<EOF
+{
+  "novel": "${story_name}",
+  "lastUpdated": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
+  "currentState": {
+    "chapter": 0,
+    "volume": 1,
+    "mainPlotStage": "准备阶段",
+    "location": "待定",
+    "timepoint": "故事开始前"
+  },
+  "plotlines": {
+    "main": {
+      "name": "主线剧情",
+      "description": "待从大纲提取",
+      "status": "待开始",
+      "currentNode": "起点",
+      "completedNodes": [],
+      "upcomingNodes": [],
+      "plannedClimax": {
+        "chapter": null,
+        "description": "待规划"
+      }
+    },
+    "subplots": []
+  },
+  "foreshadowing": [],
+  "conflicts": {
+    "active": [],
+    "resolved": [],
+    "upcoming": []
+  },
+  "checkpoints": {
+    "volumeEnd": [],
+    "majorEvents": []
+  },
+  "notes": {
+    "plotHoles": [],
+    "inconsistencies": [],
+    "reminders": ["请根据实际故事内容更新追踪数据"]
+  }
+}
+EOF
+fi
+
+# 初始化 timeline.json
+if [ ! -f "spec/tracking/timeline.json" ]; then
+    echo "⏰ 创建 timeline.json..."
+    cat > spec/tracking/timeline.json <<EOF
+{
+  "novel": "${story_name}",
+  "lastUpdated": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
+  "storyTimeUnit": "天",
+  "realWorldReference": null,
+  "timeline": [
+    {
+      "chapter": 0,
+      "storyTime": "第0天",
+      "description": "故事开始前",
+      "events": ["待添加"],
+      "location": "待定"
+    }
+  ],
+  "parallelEvents": [],
+  "timeSpan": {
+    "start": "第0天",
+    "current": "第0天",
+    "elapsed": "0天"
+  }
+}
+EOF
+fi
+
+# 初始化 relationships.json
+if [ ! -f "spec/tracking/relationships.json" ]; then
+    echo "👥 创建 relationships.json..."
+    cat > spec/tracking/relationships.json <<EOF
+{
+  "novel": "${story_name}",
+  "lastUpdated": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
+  "characters": {
+    "主角": {
+      "name": "待设定",
+      "relationships": {
+        "allies": [],
+        "enemies": [],
+        "romantic": [],
+        "neutral": []
+      }
+    }
+  },
+  "factions": {},
+  "relationshipChanges": [],
+  "currentTensions": []
+}
+EOF
+fi
+
+# 初始化 character-state.json
+if [ ! -f "spec/tracking/character-state.json" ]; then
+    echo "📍 创建 character-state.json..."
+    cat > spec/tracking/character-state.json <<EOF
+{
+  "novel": "${story_name}",
+  "lastUpdated": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
+  "characters": {
+    "主角": {
+      "name": "待设定",
+      "status": "健康",
+      "location": "待定",
+      "possessions": [],
+      "skills": [],
+      "lastSeen": {
+        "chapter": 0,
+        "description": "尚未出场"
+      },
+      "development": {
+        "physical": 0,
+        "mental": 0,
+        "emotional": 0,
+        "power": 0
+      }
+    }
+  },
+  "groupPositions": {},
+  "importantItems": {}
+}
+EOF
+fi
+
+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 ""
+echo "💡 下一步："
+echo "   1. 使用 /write 开始创作（会自动更新追踪数据）"
+echo "   2. 定期使用 /track 查看综合报告"
+echo "   3. 使用 /plot-check 等命令进行一致性检查"
+echo ""
+echo "📝 提示：追踪文件已预填充基础结构，会在写作过程中自动更新"