Skip to content
Back to search

starscape

星野(星空+地景)一键堆栈:基于 Siril 的 MCP 服务器、skill 和命令行,自动分离天空与地景 / One-shot nightscape stacking on top of Siril (MCP server + CLI)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/giaogiaogiaoluan--starscape/badge.svg)](/listings/giaogiaogiaoluan--starscape)

HTML

<a href="/listings/giaogiaogiaoluan--starscape"><img src="/api/listings/giaogiaogiaoluan--starscape/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/giaogiaogiaoluan/starscape.git
cd starscape
pip install .
python install.py

`pip install .` 安装依赖(mcp、numpy、opencv-python、Pillow、tifffile、rawpy)和 `starscape` 命令。 `python install.py` 检查 Siril 是否找得到,把 skill 复制到 `~/.claude/skills` 和 `~/.codex/skills`, 并把 MCP 服务器注册到检测到的 Claude Code / Codex。只装其中一个用 `--client claude` 或 `--client codex`; 卸载用 `python install.py --uninstall`。

建议装在虚拟环境里(`python -m venv .venv && source .venv/bin/activate`),`install.py` 会把当前这个 Python 的完整路径写进 MCP 配置,所以之后不需要再激活环境。

Siril 不在默认位置时,设置环境变量 `SIRIL_BINARY` 指向 `siril-cli`。自检:

starscape selftest

其他 MCP 客户端

任何支持 stdio 的 MCP 客户端都可以用,配置如下(`command` 换成装了本包的 Python):

{
  "mcpServers": {
    "starscape": { "command": "/path/to/python", "args": ["-m", "starscape.server"] }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 113 lines
  1. # Starscape
  2. 把固定三脚架连拍的星野照片(星空 + 地景)一键堆栈成低噪点成片。给 AI 助手用的 **MCP 服务器 + skill**
  3. (Claude Code、Codex 等),也可以当命令行工具单独用。
  4. 普通的星空叠加会按星点对齐所有照片,结果地景糊成一片,地平线附近出现拖影。Starscape **自动分离天空和地景**:
  5. - 天空:先把每一帧的地景遮掉,再对齐星点叠加 —— 地平线附近也是干净的星点。
  6. - 地景:不对齐直接叠加 —— 清晰、噪点低。
  7. - 蒙版自动生成(依据"星轨只出现在天空"),不用手画;不准时可以调参数或手工修正。
  8. - 没有暗场/平场/偏置也能出片:自动扣相机黑电平,并从亮场本身找热像素。
  9. - 调观感(亮度、饱和度、去光害强度…)几秒钟重新渲染一次,不用重新叠加。
  10. 标定、星点配准和叠加由你电脑上的 [Siril](https://siril.org) 完成,Starscape 负责 Siril 做不了的部分并把整条流程串起来。
  11. ![合成测试序列的成片](examples/selftest_final.jpg)
  12. ## 需要什么
  13. - **Siril 1.4 或更新**,装在本机。
  14. - **Python 3.10 或更新**。
  15. - macOS 或 Linux。Windows 有兼容代码但**没有测试过**。
  16. ## 安装
  17. ```bash
  18. git clone https://github.com/giaogiaogiaoluan/starscape.git
  19. cd starscape
  20. pip install .
  21. python install.py
  22. ```
  23. `pip install .` 安装依赖(mcp、numpy、opencv-python、Pillow、tifffile、rawpy)和 `starscape` 命令。
  24. `python install.py` 检查 Siril 是否找得到,把 skill 复制到 `~/.claude/skills` 和 `~/.codex/skills`,
  25. 并把 MCP 服务器注册到检测到的 Claude Code / Codex。只装其中一个用 `--client claude` 或 `--client codex`;
  26. 卸载用 `python install.py --uninstall`。
  27. 建议装在虚拟环境里(`python -m venv .venv && source .venv/bin/activate`),`install.py` 会把当前这个
  28. Python 的完整路径写进 MCP 配置,所以之后不需要再激活环境。
  29. Siril 不在默认位置时,设置环境变量 `SIRIL_BINARY` 指向 `siril-cli`。自检:
  30. ```bash
  31. starscape selftest
  32. ```
  33. ### 其他 MCP 客户端
  34. 任何支持 stdio 的 MCP 客户端都可以用,配置如下(`command` 换成装了本包的 Python):
  35. ```json
  36. {
  37. "mcpServers": {
  38. "starscape": { "command": "/path/to/python", "args": ["-m", "starscape.server"] }
  39. }
  40. }
  41. ```
  42. ## 使用
  43. **在 AI 助手里**,新开一个会话直接说:
  44. > 把 /路径/到/照片文件夹 里的星野照片堆栈成成片
  45. **命令行**:
  46. ```bash
  47. starscape scan "照片文件夹" # 只读盘点:有几组连拍、有没有标定场、要多少磁盘
  48. starscape run "照片文件夹" # 一步到成片
  49. starscape finish "项目目录" --set saturation=1.5 --set background=0.13 # 只重做后期
  50. starscape cleanup "项目目录" # 删中间文件,保留成果
  51. ```
  52. 成果在 `~/Documents/Starscape/<项目>/out/`(用环境变量 `STARSCAPE_HOME` 改位置):`final.jpg`、16 位的
  53. `final.tif`,以及可以在 Siril / PixInsight / Photoshop 里继续处理的线性母版 `composite_linear.fit`。
  54. 原始照片只被读取,不会被修改。
  55. ### 照片怎么放
  56. - 亮场(星空照片)直接放在文件夹里或 `lights/` 子文件夹。支持相机 RAW(CR2/CR3/NEF/ARW/DNG…)、FITS、TIFF。
  57. - 标定场可选,放进名为 `darks/`、`flats/`、`biases/`(或 `暗场/`、`平场/`、`偏置/`)的子文件夹才会被使用。
  58. 参数含义、"看到什么问题 → 怎么调"对照表和拍摄建议见 [starscape/GUIDE.md](starscape/GUIDE.md)。
  59. ## 已知限制
  60. - 只支持**固定三脚架**的地景分离。赤道仪跟踪拍摄会按纯星空处理。
  61. - 单帧本身的星点拖线叠加修不了,曝光时间请按 NPF 法则。
  62. - 超广角加长序列,四角星点可能变软(配准不含镜头畸变模型)。
  63. - 紧贴地景的一圈天空、桁架和树枝的缝隙里没有锐利星点。
  64. - 与天空一样亮的白色物体(白色建筑、雪)最难自动分离,可能需要手工圈选。
  65. - 中间文件很大:2000 万像素每帧约 0.5 GB,100 张约 50 GB,出片后可清理。
  66. 目前验证过的素材:合成序列(`starscape selftest`)、Canon R6 的 21 张 RAW 星野、ZWO ASI071MC 的深空 FITS
  67. (含偏置/暗场/平场)。**尚未验证**:一百张以上的真实长序列、相机 RAW 配平场、富士 X-Trans、Windows。
  68. 欢迎带着素材信息提 issue。
  69. ## MCP 工具一览
  70. | 工具 | 作用 |
  71. |---|---|
  72. | `starscape_info` / `starscape_scan` | 检查环境 / 只读盘点文件夹 |
  73. | `starscape_start` / `starscape_status` / `starscape_resume` / `starscape_cancel` | 后台运行管线并查看进度 |
  74. | `starscape_preview` | 返回蒙版、成片、天空/地景叠加、单帧的预览图 |
  75. | `starscape_finish` | 调参数重新出片 |
  76. | `starscape_mask` | 修正天空/地景蒙版并重新叠加 |
  77. | `starscape_frames` / `starscape_restack` | 逐帧质量表 / 剔帧后重新叠加 |
  78. | `starscape_siril` | 在项目里直接运行 Siril 命令 |
  79. | `starscape_projects` / `starscape_cleanup` | 列出项目 / 清理中间文件 |
  80. ## 许可
  81. MIT。Siril 是独立的 GPLv3 软件,本项目只通过命令行调用它,不包含也不分发它的代码。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.