novelws 1.2.0

package/templates/scripts/bash/manage-relations.sh

@@ -0,0 +1,174 @@
+#!/usr/bin/env bash
+# 角色关系管理（Bash）
+
+set -e
+
+SCRIPT_DIR=$(dirname "$0")
+source "$SCRIPT_DIR/common.sh"
+
+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"
+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"
+  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"
+  else
+    echo "❌ 未找到 relationships.json，且无法从模板创建" >&2
+    exit 1
+  fi
+fi
+
+CMD=${1:-show}
+shift || true
+
+print_header() {
+  echo "👥 角色关系管理"
+  echo "━━━━━━━━━━━━━━━━━━━━"
+}
+
+cmd_show() {
+  print_header
+  if ! jq empty "$REL_FILE" >/dev/null 2>&1; then
+    echo "❌ relationships.json 格式无效" >&2; exit 1
+  fi
+
+  echo "文件：$REL_FILE"
+  echo ""
+  # 输出主角或首个角色关系摘要
+  local main_char=$(jq -r '.characters | keys[0] // ""' "$REL_FILE")
+  if [ -z "$main_char" ] || [ "$main_char" = "null" ]; then
+    echo "无角色记录"
+    exit 0
+  fi
+  echo "主角：$main_char"
+  # 支持两种结构：嵌套 relationships 或直接分类键
+  jq -r --arg name "$main_char" '
+    .characters[$name] as $c | 
+    ($c.relationships // $c) as $r |
+    [
+      {k:"romantic", v:($r.romantic // [])},
+      {k:"allies", v:($r.allies // [])},
+      {k:"mentors", v:($r.mentors // [])},
+      {k:"enemies", v:($r.enemies // [])},
+      {k:"family", v:($r.family // [])},
+      {k:"neutral", v:($r.neutral // [])}
+    ] | .[] | select((.v|length)>0) |
+    "├─ " + (if .k=="romantic" then "💕 爱慕" elseif .k=="allies" then "🤝 盟友" elseif .k=="mentors" then "📚 导师" elseif .k=="enemies" then "⚔️ 敌对" elseif .k=="family" then "👪 家人" else "・ 关系" end) + "：" + (.v | join("、"))
+  ' "$REL_FILE"
+
+  # 最近变化
+  echo ""
+  if jq -e '.history' "$REL_FILE" >/dev/null 2>&1; then
+    local recent=$(jq -r '.history[-1] // empty' "$REL_FILE")
+    if [ -n "$recent" ]; then
+      echo "最近变化："
+      jq -r '.history[-1].changes[]? | "- " + (.characters|join("↔")) + "：" + (.relation // .type // "变化")' "$REL_FILE"
+    fi
+  elif jq -e '.relationshipChanges' "$REL_FILE" >/dev/null 2>&1; then
+    echo "最近变化："
+    jq -r '.relationshipChanges[-5:][]? | "- " + (.type // "变化") + ": " + (.characters|join("↔"))' "$REL_FILE" 2>/dev/null || true
+  fi
+}
+
+cmd_update() {
+  local a="$1"; local rel="$2"; local b="$3"; shift 3 || true
+  local chapter=""; local note=""
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      --chapter) chapter="$2"; shift 2;;
+      --note) note="$2"; shift 2;;
+      *) shift;;
+    esac
+  done
+  if [ -z "$a" ] || [ -z "$rel" ] || [ -z "$b" ]; then
+    echo "用法: manage-relations.sh update <人物A> <allies|enemies|romantic|neutral|family|mentors> <人物B> [--chapter N] [--note 说明]" >&2
+    exit 1
+  fi
+
+  # 确保角色节点存在
+  for name in "$a" "$b"; do
+    if ! jq --arg n "$name" '(.characters[$n] // null) != null' "$REL_FILE" | grep -q true; then
+      tmp=$(mktemp)
+      jq --arg n "$name" '.characters[$n] = (.characters[$n] // {name:$n, relationships:{allies:[],enemies:[],romantic:[],family:[],mentors:[],neutral:[]}})' "$REL_FILE" > "$tmp"
+      mv "$tmp" "$REL_FILE"
+    fi
+  done
+
+  # 写入关系
+  tmp=$(mktemp)
+  jq --arg a "$a" --arg b "$b" --arg rel "$rel" '
+    .characters[$a].relationships[$rel] = ((.characters[$a].relationships[$rel] // []) + [$b] | unique) |
+    .lastUpdated = now | todate
+  ' "$REL_FILE" > "$tmp"
+  mv "$tmp" "$REL_FILE"
+
+  # 记录历史（history 优先，否则 relationshipChanges）
+  local now=$(date -Iseconds)
+  if jq -e '.history' "$REL_FILE" >/dev/null 2>&1; then
+    tmp=$(mktemp)
+    jq --arg ch "${chapter:-null}" --arg a "$a" --arg b "$b" --arg rel "$rel" --arg note "$note" --arg t "$now" '
+      .history += [{
+        chapter: ( ($ch|tonumber) // null ),
+        date: $t,
+        changes: [{ type: "update", characters: [$a,$b], relation: $rel, note: ($note // "") }]
+      }]
+    ' "$REL_FILE" > "$tmp" && mv "$tmp" "$REL_FILE"
+  else
+    tmp=$(mktemp)
+    jq --arg a "$a" --arg b "$b" --arg rel "$rel" '.relationshipChanges += [{type:"update", characters:[$a,$b], relation:$rel}]' "$REL_FILE" > "$tmp" && mv "$tmp" "$REL_FILE"
+  fi
+
+  echo "✅ 已更新关系：$a [$rel] $b"
+}
+
+cmd_history() {
+  print_header
+  if jq -e '.history' "$REL_FILE" >/dev/null 2>&1; then
+    jq -r '.history[] | "第" + ((.chapter // 0|tostring)) + "章：" + (.changes | map((.characters|join("↔"))+"→"+(.relation // .type)) | join("；"))' "$REL_FILE"
+  elif jq -e '.relationshipChanges' "$REL_FILE" >/dev/null 2>&1; then
+    jq -r '.relationshipChanges[] | (.date // "") + " " + (.type // "") + ": " + (.characters|join("↔")) + "→" + (.relation // "")' "$REL_FILE"
+  else
+    echo "暂无历史记录"
+  fi
+}
+
+cmd_check() {
+  print_header
+  local issues=0
+  # 检查所有引用角色是否存在于 characters
+  missing=$(jq -r '
+    .characters as $c |
+    [
+      .characters | to_entries[] | .value.relationships // empty |
+      to_entries[] | .value[]
+    ] | flatten | unique | map(select(has(.) | not))
+  ' "$REL_FILE" 2>/dev/null || true)
+  if [ -n "$missing" ]; then
+    echo "⚠️  发现未建档角色引用，建议补充："
+    echo "$missing"
+    issues=1
+  fi
+  if [ "$issues" -eq 0 ]; then
+    echo "✅ 关系数据检查通过"
+  fi
+}
+
+case "$CMD" in
+  show) cmd_show ;;
+  update) cmd_update "$@" ;;
+  history) cmd_history ;;
+  check) cmd_check ;;
+  *) echo "用法: $0 [show|update|history|check]" >&2; exit 1;;
+esac
+

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

@@ -0,0 +1,100 @@
+#!/bin/bash
+
+# 创作计划脚本
+# 用于 /plan 命令
+
+set -e
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# Parse arguments
+STORY_NAME=""
+if [ $# -gt 0 ]; then
+    STORY_NAME="$1"
+fi
+
+# Get project root
+PROJECT_ROOT=$(get_project_root)
+cd "$PROJECT_ROOT"
+
+# 确定故事名称
+if [ -z "$STORY_NAME" ]; then
+    STORY_NAME=$(get_active_story)
+fi
+
+STORY_DIR="stories/$STORY_NAME"
+SPEC_FILE="$STORY_DIR/specification.md"
+CLARIFY_FILE="$STORY_DIR/clarification.md"
+PLAN_FILE="$STORY_DIR/creative-plan.md"
+
+echo "创作计划制定"
+echo "============"
+echo "故事：$STORY_NAME"
+echo ""
+
+# 检查前置文档
+missing=()
+
+if [ ! -f ".specify/memory/constitution.md" ]; then
+    missing+=("宪法文件")
+fi
+
+if [ ! -f "$SPEC_FILE" ]; then
+    missing+=("规格文件")
+fi
+
+if [ ${#missing[@]} -gt 0 ]; then
+    echo "⚠️ 缺少以下前置文档："
+    for doc in "${missing[@]}"; do
+        echo "  - $doc"
+    done
+    echo ""
+    echo "请先完成："
+    if [ ! -f ".specify/memory/constitution.md" ]; then
+        echo "  1. /constitution - 创建创作宪法"
+    fi
+    if [ ! -f "$SPEC_FILE" ]; then
+        echo "  2. /specify - 定义故事规格"
+    fi
+    exit 1
+fi
+
+# 检查是否有未澄清的点
+if [ -f "$SPEC_FILE" ]; then
+    unclear_count=$(grep -o '\[需要澄清\]' "$SPEC_FILE" | wc -l | tr -d ' ')
+
+    if [ "$unclear_count" -gt 0 ]; then
+        echo "⚠️ 规格中有 $unclear_count 处需要澄清"
+        echo "建议先运行 /clarify 澄清关键决策"
+        echo ""
+    fi
+fi
+
+# 检查澄清记录
+if [ -f "$CLARIFY_FILE" ]; then
+    echo "✅ 已完成澄清，将基于澄清决策制定计划"
+else
+    echo "📝 未找到澄清记录，将基于原始规格制定计划"
+fi
+
+# 检查计划文件
+if [ -f "$PLAN_FILE" ]; then
+    echo ""
+    echo "📋 计划文件已存在，将更新现有计划"
+
+    # 显示当前版本
+    if grep -q "版本：" "$PLAN_FILE"; then
+        version=$(grep "版本：" "$PLAN_FILE" | head -1 | sed 's/.*版本：//')
+        echo "  当前版本：$version"
+    fi
+else
+    echo ""
+    echo "📝 将创建新的创作计划"
+fi
+
+echo ""
+echo "计划文件路径：$PLAN_FILE"
+echo ""
+echo "准备就绪，可以制定创作计划"

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

@@ -0,0 +1,93 @@
+#!/bin/bash
+
+# 故事规格定义脚本
+# 用于 /specify 命令
+
+set -e
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# Parse arguments
+JSON_MODE=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --json)
+            JSON_MODE=true
+            shift
+            ;;
+        *)
+            STORY_NAME="$1"
+            shift
+            ;;
+    esac
+done
+
+# Get project root
+PROJECT_ROOT=$(get_project_root)
+cd "$PROJECT_ROOT"
+
+# 确定故事名称和路径
+if [ -z "$STORY_NAME" ]; then
+    # 查找最新的故事
+    STORIES_DIR="stories"
+    if [ -d "$STORIES_DIR" ] && [ "$(ls -A $STORIES_DIR 2>/dev/null)" ]; then
+        STORY_DIR=$(find "$STORIES_DIR" -maxdepth 1 -type d ! -name "stories" | sort -r | head -n 1)
+        if [ -n "$STORY_DIR" ]; then
+            STORY_NAME=$(basename "$STORY_DIR")
+        fi
+    fi
+
+    # 如果还是没有，生成默认名称
+    if [ -z "$STORY_NAME" ]; then
+        STORY_NAME="story-$(date +%Y%m%d)"
+    fi
+fi
+
+# 设置路径
+STORY_DIR="stories/$STORY_NAME"
+SPEC_FILE="$STORY_DIR/specification.md"
+
+# 创建目录
+mkdir -p "$STORY_DIR"
+
+# 检查文件状态
+SPEC_EXISTS=false
+STATUS="new"
+
+if [ -f "$SPEC_FILE" ]; then
+    SPEC_EXISTS=true
+    STATUS="exists"
+fi
+
+# 输出 JSON 格式
+if [ "$JSON_MODE" = true ]; then
+    cat <<EOF
+{
+    "STORY_NAME": "$STORY_NAME",
+    "STORY_DIR": "$STORY_DIR",
+    "SPEC_PATH": "$SPEC_FILE",
+    "STATUS": "$STATUS",
+    "PROJECT_ROOT": "$PROJECT_ROOT"
+}
+EOF
+else
+    echo "故事规格初始化"
+    echo "================"
+    echo "故事名称：$STORY_NAME"
+    echo "规格路径：$SPEC_FILE"
+
+    if [ "$SPEC_EXISTS" = true ]; then
+        echo "状态：规格文件已存在，准备更新"
+    else
+        echo "状态：准备创建新规格"
+    fi
+
+    # 检查宪法
+    if [ -f ".specify/memory/constitution.md" ]; then
+        echo ""
+        echo "✅ 检测到创作宪法，规格将遵循宪法原则"
+    fi
+fi

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

@@ -0,0 +1,96 @@
+#!/bin/bash
+
+# 任务分解脚本
+# 用于 /tasks 命令
+
+set -e
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# Parse arguments
+STORY_NAME=""
+if [ $# -gt 0 ]; then
+    STORY_NAME="$1"
+fi
+
+# Get project root
+PROJECT_ROOT=$(get_project_root)
+cd "$PROJECT_ROOT"
+
+# 确定故事名称
+if [ -z "$STORY_NAME" ]; then
+    STORY_NAME=$(get_active_story)
+fi
+
+STORY_DIR="stories/$STORY_NAME"
+SPEC_FILE="$STORY_DIR/specification.md"
+PLAN_FILE="$STORY_DIR/creative-plan.md"
+TASKS_FILE="$STORY_DIR/tasks.md"
+
+echo "任务分解"
+echo "========"
+echo "故事：$STORY_NAME"
+echo ""
+
+# 检查前置文档
+missing=()
+
+if [ ! -f ".specify/memory/constitution.md" ]; then
+    missing+=("宪法文件")
+fi
+
+if [ ! -f "$SPEC_FILE" ]; then
+    missing+=("规格文件")
+fi
+
+if [ ! -f "$PLAN_FILE" ]; then
+    missing+=("计划文件")
+fi
+
+if [ ${#missing[@]} -gt 0 ]; then
+    echo "⚠️ 缺少以下前置文档："
+    for doc in "${missing[@]}"; do
+        echo "  - $doc"
+    done
+    echo ""
+    echo "请先完成："
+    if [ ! -f ".specify/memory/constitution.md" ]; then
+        echo "  1. /constitution - 创建创作宪法"
+    fi
+    if [ ! -f "$SPEC_FILE" ]; then
+        echo "  2. /specify - 定义故事规格"
+    fi
+    if [ ! -f "$PLAN_FILE" ]; then
+        echo "  3. /plan - 制定创作计划"
+    fi
+    exit 1
+fi
+
+# 检查任务文件
+if [ -f "$TASKS_FILE" ]; then
+    echo ""
+    echo "📋 任务文件已存在，将更新现有任务"
+
+    # 显示任务统计
+    total_tasks=$(grep -c "^- \[" "$TASKS_FILE" 2>/dev/null || echo "0")
+    completed_tasks=$(grep -c "^- \[x\]" "$TASKS_FILE" 2>/dev/null || echo "0")
+    echo "  总任务数：$total_tasks"
+    echo "  已完成：$completed_tasks"
+else
+    echo ""
+    echo "📝 将创建新的任务清单"
+fi
+
+echo ""
+echo "任务文件路径：$TASKS_FILE"
+echo ""
+echo "准备就绪，可以分解任务"
+echo ""
+echo "任务分解将包括："
+echo "  - 章节写作任务（基于计划）"
+echo "  - 角色档案完善"
+echo "  - 世界观文档补充"
+echo "  - 质量检查节点"
+echo "  - 验证和修订任务"

package/templates/scripts/bash/test-word-count.sh

@@ -0,0 +1,182 @@
+#!/bin/bash
+
+# 测试中文字数统计功能
+# 用于验证 count_chinese_words 函数的准确性
+
+set -e
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# 颜色输出
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo "========================================"
+echo "中文字数统计功能测试"
+echo "========================================"
+echo ""
+
+# 创建临时测试文件
+TEST_DIR=$(mktemp -d)
+trap "rm -rf $TEST_DIR" EXIT
+
+# 测试用例1: 纯中文文本
+echo "## 测试1: 纯中文文本"
+cat > "$TEST_DIR/test1.md" << 'EOF'
+今天天气很好，我去公园散步。
+看到很多人在锻炼身体。
+EOF
+expected1=16
+actual1=$(count_chinese_words "$TEST_DIR/test1.md")
+echo "  预期字数: $expected1"
+echo "  实际字数: $actual1"
+if [ "$actual1" -eq "$expected1" ]; then
+    echo -e "  ${GREEN}✅ 测试通过${NC}"
+else
+    echo -e "  ${RED}❌ 测试失败${NC}"
+fi
+echo ""
+
+# 测试用例2: 包含Markdown标记
+echo "## 测试2: 包含Markdown标记的文本"
+cat > "$TEST_DIR/test2.md" << 'EOF'
+# 第一章
+
+这是**重要**的内容。
+
+- 列表项1
+- 列表项2
+
+> 这是引用
+EOF
+# 实际内容: 第一章这是重要的内容列表项1列表项2这是引用
+expected2=21
+actual2=$(count_chinese_words "$TEST_DIR/test2.md")
+echo "  预期字数: $expected2"
+echo "  实际字数: $actual2"
+if [ "$actual2" -eq "$expected2" ]; then
+    echo -e "  ${GREEN}✅ 测试通过${NC}"
+else
+    echo -e "  ${YELLOW}⚠️ 字数差异: $((actual2 - expected2))${NC}"
+fi
+echo ""
+
+# 测试用例3: 中英混合
+echo "## 测试3: 中英文混合文本"
+cat > "$TEST_DIR/test3.md" << 'EOF'
+这是一个测试test文件。
+包含123数字和English单词。
+EOF
+# 实际内容（移除空格和标点后）: 这是一个测试test文件包含123数字和English单词
+expected3=27
+actual3=$(count_chinese_words "$TEST_DIR/test3.md")
+echo "  预期字数: 约$expected3"
+echo "  实际字数: $actual3"
+if [ "$actual3" -ge 20 ] && [ "$actual3" -le 35 ]; then
+    echo -e "  ${GREEN}✅ 测试通过（在合理范围内）${NC}"
+else
+    echo -e "  ${YELLOW}⚠️ 字数差异较大${NC}"
+fi
+echo ""
+
+# 测试用例4: 包含代码块
+echo "## 测试4: 包含代码块的文本"
+cat > "$TEST_DIR/test4.md" << 'EOF'
+这是正常文本。
+
+```javascript
+console.log("这是代码不应该被计数");
+```
+
+这是结尾文本。
+EOF
+expected4=12
+actual4=$(count_chinese_words "$TEST_DIR/test4.md")
+echo "  预期字数: $expected4"
+echo "  实际字数: $actual4"
+if [ "$actual4" -eq "$expected4" ]; then
+    echo -e "  ${GREEN}✅ 测试通过${NC}"
+else
+    echo -e "  ${YELLOW}⚠️ 字数差异: $((actual4 - expected4))${NC}"
+fi
+echo ""
+
+# 对比测试: wc -w vs 新方法
+echo "## 对比测试: wc -w vs count_chinese_words"
+cat > "$TEST_DIR/compare.md" << 'EOF'
+这是一个包含大约五十个字的测试文本。
+我们需要验证字数统计的准确性。
+使用wc命令统计中文字数是不准确的。
+应该使用专门的中文字数统计方法。
+这样才能得到正确的结果。
+EOF
+wc_result=$(wc -w < "$TEST_DIR/compare.md" | tr -d ' ')
+new_result=$(count_chinese_words "$TEST_DIR/compare.md")
+echo "  wc -w 结果: $wc_result （不准确）"
+echo "  新方法结果: $new_result （准确）"
+echo -e "  ${YELLOW}注意：wc -w 对中文统计极不准确！${NC}"
+echo ""
+
+# 性能测试
+echo "## 性能测试: 大文件处理"
+cat > "$TEST_DIR/large.md" << 'EOF'
+# 第一章：开始
+
+今天是个好天气，阳光明媚，万里无云。
+小明决定去公园散步，顺便思考一下人生。
+他一边走一边想，不知不觉来到了湖边。
+湖水清澈见底，几只野鸭在水面游弋。
+远处传来孩子们的欢笑声，让人心情愉悦。
+
+## 第二节
+
+突然，他看到一位老人坐在长椅上。
+老人面带微笑，似乎在等待什么。
+小明走上前去，礼貌地打了个招呼。
+老人抬起头，慈祥的目光看向小明。
+两人开始了一段有趣的对话。
+
+**重要的转折点**：
+- 老人讲述了一个神奇的故事
+- 小明意识到生活的意义
+- 他决定改变自己的人生轨迹
+
+最后，夕阳西下，小明告别了老人。
+他的内心充满了力量和希望。
+这次偶遇，改变了他的一生。
+EOF
+
+start_time=$(date +%s%N)
+large_count=$(count_chinese_words "$TEST_DIR/large.md")
+end_time=$(date +%s%N)
+elapsed=$((($end_time - $start_time) / 1000000)) # 转换为毫秒
+
+echo "  文件字数: $large_count"
+echo "  处理时间: ${elapsed}ms"
+if [ "$elapsed" -lt 1000 ]; then
+    echo -e "  ${GREEN}✅ 性能良好${NC}"
+else
+    echo -e "  ${YELLOW}⚠️ 处理时间较长${NC}"
+fi
+echo ""
+
+# 总结
+echo "========================================"
+echo "测试完成！"
+echo "========================================"
+echo ""
+echo -e "${GREEN}核心功能：${NC}"
+echo "  ✓ 准确统计中文字符"
+echo "  ✓ 排除Markdown标记"
+echo "  ✓ 排除代码块"
+echo "  ✓ 处理混合文本"
+echo ""
+echo -e "${YELLOW}使用建议：${NC}"
+echo "  • 不要使用 'wc -w' 统计中文字数"
+echo "  • 使用 'count_chinese_words' 函数获得准确结果"
+echo "  • 在写作完成后验证字数是否达标"
+echo ""