深空天体摄影处理工具

You: config.json with M81 HaLRGB file paths + "push IFN hard, vivid galaxy colors"

Pipeline:
  1. Classifies M81 as galaxy_spiral (core_arms_ifn, broadband, high dynamic range)
  2. Recalls memory: "Seti target 0.12 for L, HDRMT inverted 6L/1i, Ha strength 0.25"
  3. Deterministic prep: align, combine, GC, BXT, SPCC, NXT, SXT, stretch (~12 min, cached)
  4. Creative agent generates 16 candidates across 4 branches:
     - Luminance detail: LHE + HDRMT from weak to overdone
     - IFN/faint structure: shadow-lifting curves from subtle to aggressive
     - Color: saturation curves + Ha injection from restrained to overdone
     - Stars: stretch + color saturation from bright to over-reduced
  5. Critic pass selects branch winners, identifies overdone boundaries
  6. Composes 4 final candidates (balanced, bold-IFN, bold-color, edge)
  7. Art director picks near-edge-but-credible winner
  8. Quality gates pass -> saves final XISF + JPG -> saves memory for next target

                        +---------------------+
                        |   Config JSON        |
                        |  (target, channels,  |
                        |   aesthetic prefs)    |
                        +---------+-----------+
                                  |
                        +---------v-----------+
                        |  Classifier          |
                        |  agents/classifier   |
                        |  target-taxonomy.json|
                        +---------+-----------+
                                  |
               +------------------+------------------+
               |                                     |
    +----------v-----------+           +-------------v-----------+
    | Phase 1: Deterministic|           | Phase 2+: Creative Agent |
    | Prep (no LLM)         |           | (Claude Max subprocess)  |
    | deterministic-prep.mjs|           | giga-run.mjs             |
    |                       |           |                          |
    | open, align, combine, |           | 53 MCP tools             |
    | GC, BN, BXT, SPCC,   |           | bracket-then-critic      |
    | NXT, SXT, stretch     |           | 4 branches x 4 candidates|
    +-----------+-----------+           | quality gates             |
                |                       +-------------+-------------+
                |                                     |
                +----> PixInsight (PJSR) <------------+
                       via file-based bridge IPC
                       (~/.pixinsight-mcp/bridge/)

DETERMINISTIC PREP (Phase 1, ~10-15 min first run, cached thereafter):
  disk space check (>= 20 GB required)
  --> cache key computation (script hash + input fingerprints)
  --> [cache hit: load XISF files, skip to Phase 2]
  --> close all open images
  --> open masters (with channel swap if configured)
  --> check dimensions, align to R reference via StarAlignment
  --> combine RGB channels
  --> gradient correction (GC or ABE, auto-selected)
  --> BXT correct_only (deconvolution)
  --> copy astrometric solution back (BXT strips WCS)
  --> SPCC color calibration
  --> background neutralization
  --> NXT linear denoise (0.20)
  --> BXT sharpen
  --> SXT star extraction (linear mode, stars=true only)
  --> Seti statistical stretch (target=0.12, headroom=0.05)
  --> NXT post-stretch denoise (0.25)
  --> [repeat GC, BXT, NXT, SXT, stretch for L and Ha if present]
  --> save to cache

CREATIVE AGENT (Phase 2+, ~30-60 min via Claude Max):
  Phase 0: recall_memory, inspect prep diagnostics
  Phase 2: Branch generation (4 branches x 4 candidates = 16 candidates)
    Branch A -- Luminance detail (LHE, HDRMT, masks)
    Branch B -- Faint structure / IFN (shadow-lifting curves, inverted masks)
    Branch C -- Color / Ha injection (saturation curves, narrowband blending)
    Branch D -- Stars (stretch, color saturation, screen blend params)
  Phase 3: Branch critic pass (score, compare, select winners)
  Phase 4: Optional narrow refinement (1 round max)
  Phase 5: Composition candidates (balanced, bold-IFN, bold-color, edge)
  Phase 6: Composition critic pass
  Phase 7: Art director decision (near-edge but credible)
  Phase 7.5: Final gradient correction
  Phase 8: Quality gates (star quality, ringing, core burning)
  Phase 9: Final polish + save_memory
  --> save final XISF + JPG
  --> run memory optimizer (auto-promote patterns)

# 1. Build the MCP server
export PATH="/Users/aescaffre/.local/node-v22.13.1-darwin-arm64/bin:$PATH"
cd /Users/aescaffre/pixinsight-mcp && npm run build

# 2. Start PixInsight and load the watcher script:
#    Script > Run Script... > pjsr/pixinsight-mcp-watcher.js

# 3. Verify bridge connectivity
node scripts/ping-watcher.mjs

# 4. Create a config JSON (see Config Format below) and run the GIGA pipeline
node agents/llm/giga-run.mjs --config /path/to/config.json

# 5. Optional: add a processing intent to guide aesthetic decisions
node agents/llm/giga-run.mjs --config /path/to/config.json --intent "push IFN hard, vivid galaxy colors"

# 6. Dry run (classification + brief only, no processing)
node agents/llm/giga-run.mjs --config /path/to/config.json --dry-run

node scripts/run-pipeline.mjs --config /path/to/config.json
node scripts/run-pipeline.mjs --config /path/to/config.json --restart-from stretch

{
  "files": {
    "targetName": "M81",
    "R": "/absolute/path/to/masterLight_R.xisf",
    "G": "/absolute/path/to/masterLight_G.xisf",
    "B": "/absolute/path/to/masterLight_B.xisf",
    "L": "/absolute/path/to/masterLight_L.xisf",
    "Ha": "/absolute/path/to/masterLight_Ha.xisf",
    "outputDir": "/absolute/path/to/output/",
    "channelSwap": ""
  },
  "aestheticPreferences": {
    "noiseLevel": "very_clean",
    "glow": "moderate",
    "starPresence": "prominent"
  }
}

agents/
  llm/
    giga-run.mjs               -- Main entry point (GIGA pipeline runner)
    deterministic-prep.mjs      -- Phase 1: scripted linear processing with caching
    engine-max.mjs              -- Claude Max subprocess engine (claude -p)
    tools.mjs                   -- 53 MCP tool definitions and handlers
    vision.mjs                  -- Diagnostic view generation and image messaging
    mcp-agent-tools.mjs         -- MCP server for agent tool access
    prompts/
      giga-orchestrator.mjs     -- System prompt builder (generic, trait-driven)
  ops/
    bridge.mjs                  -- File-based IPC with PixInsight
    quality-gates.mjs           -- Star quality, ringing, core burning checks (PJSR)
    stats.mjs                   -- Image statistics and uniformity measurement
    stretch.mjs                 -- Seti statistical stretch (ported from PixInsight)
    gradient.mjs                -- Gradient correction (ABE, GC, per-channel)
    masks.mjs                   -- Luminance mask creation and management
    preview.mjs                 -- JPEG preview export
    image-mgmt.mjs              -- Clone, close, purge operations
    checkpoint.mjs              -- Checkpoint save/restore
    index.mjs                   -- Ops module aggregator
  memory/
    hierarchical-memory.mjs     -- 5-level memory store with auto-promotion optimizer
  classifier.mjs                -- Target classification and processing brief generation
  target-taxonomy.json          -- 12 categories with 7 trait dimensions each
  scoring.mjs                   -- 8-dimension scoring model with per-type weight profiles
  artifact-store.mjs            -- Per-run artifact management
  processing-profiles.json      -- Default processing parameters per target type
scripts/
  run-pipeline.mjs              -- Legacy deterministic pipeline (~2000 lines)
  ping-watcher.mjs              -- Bridge connectivity test
pjsr/
  pixinsight-mcp-watcher.js     -- PixInsight-side watcher (ECMAScript 5)
src/
  -- MCP server TypeScript source (for IDE/tool integration)
editor/
  server.mjs                    -- Web UI backend for config editing
  index.html                    -- Web UI frontend
  default-config.json           -- Default pipeline configuration
.claude/skills/
  pixinsight-pipeline/          -- Processing knowledge base for Claude Code sessions
    SKILL.md                    -- Pipeline overview and parameter tuning guide
    reference/                  -- PJSR processes, gotchas, tools, stretch formulas