Repository navigation
Releases: lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation
Release list
GeoForge Desktop 0.6.60 — Windows
GeoForge Desktop 0.6.60 for Windows x64
This release improves the path from an updated KI to a verified project run: setup and runtime paths follow the current KI identity, maintenance edits stay behind KDT, and approved execution continues after project preflight.
The 0.6.59 candidate was withheld after fresh hosted testing exposed four test-harness failures. This release preserves byte-sensitive fixtures during Git checkout, exercises both Windows and Unix line endings, and prevents verifier mocks leaking between tests. Application validation gates are unchanged, and 0.6.60 passed a fresh full validation run.
- Refresh setup and project readiness after installation, KI maintenance and updates, including required runtime data when a supported download route is available.
- Reuse compatible KDT-approved repairs and existing valid evidence. Failed attempts cannot count as evidence for the current plan.
- Check ready input paths, typed tool arguments and output contracts before approval. Separate completed execution from scientific validation.
- Prevent stale approval popups across chats; bundle the runtime-data identity source; fix Codex fresh/resumed command arguments.
- Preserve verified native executable aliases in signed run evidence and reject changed targets. Clean up tracked Windows child processes after wrapper exit, and allow virtual-environment wrappers to save their run record during Stop.
Download the installer for a normal installation, or extract the entire portable ZIP and keep _internal beside GeoForge Desktop.exe. The desktop includes Python; model software and AI providers still need their own setup. Verify downloads against SHA256SUMS-Windows.txt.
Validation at tagged source a72522eea97df1c3e5e95a79c3dc27f56efcaf78: the full desktop suite passed 5,319 tests and 366 subtests, with 55 skips; the shared-library suite passed 437 tests, with seven skips; and all 70 release-boundary tests passed. There were no failures or errors. Skips cover POSIX-only checks and unavailable optional KDT, CLI, server, binary or publication fixtures. The compiled application passed checks outside the source checkout and after installation; installation and uninstallation both exited successfully. Exact results and package hashes are attached in Windows-release-validation.json, the JUnit reports and SHA256SUMS-Windows.txt. These are application and packaging checks; the scientific workflow evidence below has a separate scope.
Validation workflow: Windows 0.6.60 release checks.
Earlier DeepSeek GUI acceptance (v51, rechecked under v52) completed the DSSAT UFGA8201 treatment 1 reference workflow with four verified execution records: native simulation, repaired output reader, observation reader and comparison. It produced 129 daily records and yield of 2,293 versus 2,929 kg/ha (−21.71%). This used an existing installed runtime and a separately KDT-approved local repair. It is prior workflow evidence, not a fresh end-to-end run of this final release. Changed helper code can require projects and repairs to be verified again. One comparison pair cannot establish NSE or predictive skill, and this was not a new-site or calibration test.
The bundled 127 scientific KIs and two observation data KIs retain the previous release snapshot. The last checked main-library update accepted 110 and rejected 17 packages before activation; those server-side repairs are separate work. Live Claude/Codex acceptance remains limited by authentication or installed CLI/model compatibility. macOS and Linux builds are not part of this release.
The six English/Chinese offline guides, including the illustrated three-page quickstart, retain their reviewed 0.6.55 document edition. Their filenames intentionally retain that edition number.
中文:Windows 0.6.60 改进 KI 更新后的安装与路径适配、KDT 维护、输入与输出校验、预检后继续运行和状态显示,并修复已验证的程序路径别名处理和 Windows 子进程管理。本次完整桌面测试有 5,319 项及 366 个子测试通过、55 项跳过;共享库测试有 437 项通过、7 项跳过;70 项发布边界测试全部通过。没有失败或错误,编译后的程序、安装和卸载检查均通过。跳过项目涉及 POSIX 平台或未提供的可选测试依赖。此前 v51/v52 的 DS GUI 测试已完成 DSSAT 参考算例运行、结果读取与观测对比;该测试使用独立验证的本地 KI 修复,不代表本次最终版本的新一轮端到端测试,也不代表所有模型已安装或完成科学验证。辅助工具变更后可能需要重新验证项目和修复。附件提供本次 Windows 检查记录、安装程序、便携包及校验和;中英文离线指南保留已审核的 0.6.55 版次。
GeoForge Desktop 0.6.58 for Windows
GeoForge Desktop 0.6.58 for Windows x64 adds project KI investigation and a verified repair workflow.
- Investigate KI: three independent reviewer conversations inspect the same frozen project context and provide attributed reports.
- Repair through KDT: create and build a separate draft, inspect changed files, verify it, and explicitly choose Apply repair and continue. The project preserves history, starts fresh agent memory, and requires a new plan review and software preflight.
- Shared enforcement: CLI and API providers use the same host acceptance and KI integrity checks. Reviewer agreement or an agent's success message cannot replace KDT acceptance. API connections and checked Claude/Codex CLI profiles support the optional review workflow.
- Clean Windows fixes: exact reader bytes survive checkout; invalid KI trees stay isolated; project Julia takes priority; uploads reject file links atomically.
- Windows fixes: portable tool-index paths are handled correctly; KI/helper update consistency, local observation readers, approval environment checks, PNG output checks, calibration displays and reconnect handling are improved.
- English and Chinese: the in-app Guide explains the new workflow. The six bundled PDF guides retain their reviewed 0.6.55 edition, including the illustrated three-page quickstarts.
Downloads
Use GeoForge-Desktop-Setup-v0.6.58-Windows-x64.exe for installation, or extract the entire GeoForge-Desktop-v0.6.58-Windows-x64.zip for portable use. Keep _internal beside the executable. Python is included for the desktop app; scientific model binaries, compilers and model environments are installed separately when needed.
Check downloads against SHA256SUMS-Windows.txt. Windows-release-validation.json records the exact source commit, compiled runtime checks and installer lifecycle checks; the checksum file records the download hashes.
Validation and scope
The tagged source passed 2,533 Desktop tests plus 366 subtests and 427 shared-library tests in the source validation run. desktop-regression.xml and shared-regression.xml contain the exact counts and skips. The compiled bundle and installed application are checked separately from the source checkout.
The downloadable installer and ZIP are built from the exact release tag by the
Windows build and validation workflow.
The packaging retry verifies the unchanged application commit, the successful source
validation job, and the exact report hashes before reusing those results. It then
reruns compiled-app and install/uninstall checks before uploading. A short build
directory avoids the installer compiler's Windows path-length limit. The release
validation JSON identifies the application commit, packaging workflow revision and
source validation run for the downloadable GitHub-runner build.
Live DeepSeek GUI testing completed all three CRHM reviews and authored a repair draft. KDT correctly refused missing literature metadata and a nonportable binary reference; the draft was not applied. This release does not claim a new native scientific run, observed-data calibration pass, or forcing coverage for all models. The bundle contains 127 scientific KIs and two observation data KIs; Library updates have separate revision evidence.
中文
Windows 0.6.58 新增项目 KI 三方独立排查与 KDT 修复流程:阅读报告 → 创建修复草稿 → Agent 编写修复 → KDT 验证 → 明确点击“应用修复并继续”。应用后保留历史,重新审核计划并检查实际 KI 版本。所有 CLI/API 提供方使用统一 KI 门禁;审查意见和结构验证不能替代模型运行或科学验证。
推荐下载安装程序;便携版必须完整解压并保留 _internal 目录。桌面应用内置 Python,科学模型及其环境仍可能需要单独安装。中英文图文快速上手、完整手册和校准指南已随包提供,PDF 保留 0.6.55 版次。
GeoForge Desktop 0.6.56 for Windows
GeoForge Desktop is an agent-driven graphical workspace for professional scientific models and tools. KI supplies the operating knowledge; KI Studio connects to KDT for creating new packages; optional GeoForge Database access helps find and acquire data. You review the project plan, then follow the agent's local execution and inspect the resulting files and plots.
Windows 0.6.56 bundles the illustrated English and Chinese quickstarts in the installer and portable app. Each is exactly three pages: connect DeepSeek, set up SHAW and its official inputs, then approve a real example run and inspect outputs. The offline Guide menu also contains the full manual and calibration guide. The reviewed documents keep their 0.6.55 edition number because the application workflow is unchanged.
Use GeoForge-Desktop-Setup-v0.6.56-Windows-x64.exe for installation, or extract the entire GeoForge-Desktop-v0.6.56-Windows-x64.zip. Python is included; scientific model programs, KDT, provider credentials and Database activation are configured separately. Verify downloads with SHA256SUMS-Windows.txt.
Fresh verification: 28 tests and 15 subtests passed under the Windows cp936 locale; the frozen and installed application passed all 12 offline guide routes, KI library, bridge, harness and calibration-readiness checks. Clean installation and removal passed. The portable ZIP passed its CRC check. An independent audit matched 76 compiled modules plus the entry point and 4,259 data files to source.
This is a documentation and packaging release. The 76 application/shared module implementations are unchanged from public 0.6.55. The earlier native CRHM, VIC, SHAW and calibration evidence remains dated historical evidence; no new paid AI-provider turn, native scientific run or authenticated Database transfer was performed for this release.
Verification and scope · Previous scientific acceptance.
Windows 0.6.56 安装包和便携版已内置中英文三页图文快速上手。按“连接 Agent → 设置 KI 和 SHAW → 审批运行并检查结果”完成官方算例;使用指南菜单支持离线 HTML 和 PDF。手册保留 0.6.55 版次。本次更新文档与打包,科学模型和运行实现未变。
| Guide | English | 简体中文 |
|---|---|---|
| Illustrated three-page quickstart | ||
| Full user manual | ||
| Calibration guide |
GeoForge Desktop 0.6.55 — Windows
Illustrated quickstart update - 2026-10-02: English PDF / 中文 PDF. Each is exactly three pages: connect DeepSeek, set up SHAW and attach the official Trial inputs, then approve, run and inspect results. Includes actual English/Chinese app screenshots and a temperature preview from the verified native SHAW run. These supplemental downloads contain the illustrated revision; the original installer, portable ZIP and their bundled guides retain the original edition. Checksums: SHA256SUMS-Quickstart-Illustrated.txt.
GeoForge Desktop 0.6.55 for Windows includes the CRHM, VIC and SHAW repairs verified with genuine native examples and DeepSeek-assisted installation and execution.
- The Usage menu opens the English or Chinese quick start, full manual and calibration guide offline, with a PDF option for each.
- Each quick start is exactly three pages: connect an agent, set up a KI/model, and run the official SHAW Trial through approval, execution, CSV export and plotting.
- Calibration approves the exact project adapter, contract and settings. Changing them requires a new review. Failed or rejected holdout checks cannot produce scientific completion.
- The packaged calibration engine includes SPOTPY's RAM result writer, fixing a failure that import-only readiness checks missed.
- Windows model fixes cover CRHM dates and original-input staging, VIC 5.1.0 input-stream portability, SHAW runtime dependencies, output parsing and repeat runs, plus plan and receipt validation.
Verification: 1,727 Desktop tests plus 337 subtests, and 371 shared-library tests passed under the real Windows cp936 locale. The final executable, all 12 offline guide routes, clean installer installation/removal, and genuine native SHAW calibration passed. All 64 native calls in the final calibration check exited successfully without console windows. One failed plotting attempt was retained, then corrected successfully during the DeepSeek Desktop acceptance run.
Exact results and limits: release verification, calibration evidence, and CRHM/VIC/SHAW evidence. Download Windows-release-validation.json for the exact tagged source and artifact identities.
The SHAW calibration benchmark recovers a known reference parameter using the publisher's output. It is a software/reference recovery test, not validation against field observations. The CRHM, VIC and SHAW installations required documented assistance. Authenticated GeoForge Database downloads and all-model scientific acceptance are outside this release's test scope.
Use the Setup executable for installation, or extract the entire portable ZIP. Python is bundled; scientific model programs and AI-provider access are configured separately. Downloaded assets can be checked against SHA256SUMS-Windows.txt. This release leaves the previous Windows 0.6.54 assets available and does not replace macOS or Linux releases.
GeoForge Desktop 0.6.54 for Windows
GeoForge Desktop 0.6.54 for Windows (x64), build windows-mac-sync-20260930. Python and the scientific toolchain helpers are included; AI providers and scientific models are configured or installed separately.
User manual
New for 0.6.54, with screenshots from this Windows build: installation, connecting an AI, the GeoForge Database, installing a model, a complete FSM2 example from request to Completed, project files, the other tools, and troubleshooting.
What's new
- Latest mac features on Windows: one-question-at-a-time planning with answers kept and credited to you, the study period asked separately (a KI example's dates are no longer proposed as your project's period), uploads bound at approval, downloads that continue in the background, GeoForge Database used only when it is activated, named project folders.
- Stop works on Windows: a KI tool, a setup command or an agent CLI now ends together with the models, compilers and commands it started. Tray Exit GeoForge stops running work first.
- Chinese Windows fixes: run records, planner cards and agent launchers now work with Chinese text and Chinese user names.
- Projects can finish: GeoForge's own files and your declared input files no longer block Completed.
- FSM2: two-point output is labelled correctly; the KI now computes peak SWE / melt-out and draws the depth/SWE figure; its official example runs inside a project.
- Safer updates: an automatic KI library update can no longer remove the Windows installation guides.
- A chat started with an API provider keeps it after the app restarts.
Verified on Windows
- End to end in this compiled app with the DeepSeek API: FSM2's official Alptal example was planned, installed (compiled from source), run on the real
FSM2.exe, and finished Completed with signed run records. - 1,451 desktop and 327 shared tests pass under the Chinese (cp936) system locale.
- Silent install into a folder with a space, runtime checks on the installed copy, all 4,789 installed files identical to the portable bundle, silent uninstall (installer and uninstaller exit 0) — see
Windows-release-validation.json.
Known issues
Please read docs/issues/WINDOWS-KNOWN-ISSUES-2026-09-30.md. In short:
- Important: when the planner recommends a data source that is not in the GeoForge catalogue (for example NASA POWER), the approval card can hide it and approval can record that source while a different dataset is downloaded and used. Check the data list on the approval card before approving.
- Stop / Exit do not reach jobs an agent started through Git Bash wrappers such as
nohuportimeout; end them in Task Manager if needed. - The installation agent may run a model's example during setup (costs time; cannot count as a project result).
- Calibration opens a console window for each model evaluation; do not close them.
- Not yet exercised end to end on Windows: Codex / Claude / Kimi CLI agents, GeoForge Database downloads, calibration, and models other than FSM2.
- Found after release (sections 7 and 8 of the known-issues file; the manual's chapter 9 explains the workarounds):
- Do not reload or close the GeoForge browser tab while the AI is working: that ends the current turn. Send a message to continue. Fixed in source for the next build.
- When the model is installed right after you approve a plan, the run's final verdict is not shown and Project status only says "Ready to continue". Send any message to see it. Fixed in source for the next build.
- A project can stay short of Completed when the plan has a step "written by the agent" (no tool) or when setup leaves files in the project; the approval card's "Not ready to execute yet" is only a warning. Choose Modify the plan in those cases.
Files
| File | SHA-256 |
|---|---|
GeoForge-Desktop-Setup-v0.6.54-Windows-x64.exe (installer) |
7c31536f1b1b42777440047ed083ac543f49655a0b74ee35ec3824e38fc8c415 |
GeoForge-Desktop-v0.6.54-Windows-x64.zip (portable) |
8d2c30daea73f77aea5ab3c3859ef330b8495738d65ef9c6bfdc7636dc64897f |
GeoForge-Desktop-Manual-EN-v0.6.54.pdf (manual) |
0ca0a2ee3b27fbc72ac0fe75838836cccc7c1848caa76e9e20c57fbbeae44914 |
GeoForge-Desktop-Manual-ZH-CN-v0.6.54.pdf (手册) |
43e0ec7a2ecf0d6a545d3fa4f95c85ca417f9ad13df3e61071b59ee2fe454f66 |
Assets were built from b443c16; the tagged commit adds documentation only. The manuals were added on 2026-10-01 from 96409ba (docs/manual/0.6.54). This release does not replace the macOS assets of v0.6.54.
Windows 版 0.6.54:同步 Mac 最新功能;Windows 上“停止”可结束整个进程树;修复中文系统下的回执、规划卡片和启动器问题;项目现在可以正常“完成”;修复 FSM2 多点输出列错位。已知问题见上方链接。新增中英文用户手册(见上方 User manual)。
GeoForge Desktop v0.6.54 — macOS Apple Silicon
GeoForge Desktop — 127 Earth-system models with their KISS Knowledge
Infrastructures, driven by the GeoForge agent.
What is new in v0.6.52
v0.6.52 is the tested Apple-Silicon macOS release. The release gate fails closed
unless the macOS arm64 Desktop archive builds and passes its frozen-runtime smoke
test. It also makes optional geospatial capability probing deterministic on clean
machines where GeoPandas is not installed.
- The KI harness now has a real plan → user approval → execute → verify gate.
Downloads and model tools remain unavailable until the recorded data inventory
and plan are approved; approved runs produce validation receipts. - Harness and Flow are frozen as importable code. Startup and CI verify all nine
Flow modules, including the modules that decide tool trust and build data. - The internal
GEOFORGE_INTAKEcontrol record is consumed but no longer appears
in chat. - Localhost write endpoints require a random SameSite token and matching local
origin. API keys and proxy settings are saved atomically with user-only access. - Shared NetCDF helpers correctly handle descending axes, 0–360 longitude and
antimeridian windows, reproject basin vectors, and reject empty or all-missing
selections instead of returning plausible bad data. - KI Observatory, evidence-graded Agent activity, provider-specific proxy routes,
selectable existing installations and portable CRHM/Alpine3D/WRF-Hydro setup
are included in the same release. - The macOS Desktop and CLI packages use one version source. See
release-manifest.jsonfor the machine-readable update contract and
DESKTOP_CHANGELOG.mdfor bilingual details.
Local validation: 311 Desktop/Flow tests, 98 KI-tool tests, 83 climate/unit tests
and 46 diagnostic checks passed. The frozen macOS application is additionally
smoke-tested by the release workflow.
Install
macOS (Apple Silicon — M1 through M4)
unzip GeoForge-Desktop-macos-arm64.app.zip
xattr -dr com.apple.quarantine "GeoForge Desktop.app"
open "GeoForge Desktop.app"
The xattr line is required: the build is not signed by Apple, and without it
macOS refuses to open the app.
Everything is inside the download — all 127 KI packages, the engine, the UI.
No Python installation and no first-run network access.
Talking to models
Uses an agent CLI you already have (claude / codex / gemini / kimi / qwen) or
an API key via ⚙ Settings (Anthropic / DeepSeek / OpenAI / OpenRouter). Switch
between the two with the CLI / API button in the menu bar; provider and model
are per session.
Also here
kiss-macos-arm64.tar.gz — the engine as a terminal command (list, info, init,
verify, papers, doctor). kiss-ki-packages.tar.gz is the KI content on
its own, for running from source; the desktop downloads already contain it.
Not in this release
Intel Macs (x86_64), Windows and Linux are not published by the mac-version
release workflow. Their platform branches and workflows own those deliverables.
GeoForge Desktop 0.6.53 — Windows x64
GeoForge Desktop 0.6.53 — Windows x64
推荐下载 GeoForge-Desktop-Setup-v0.6.53-Windows-x64.exe,直接运行安装。
安装器自带 Python 3.11 和必需的运行时 DLL,无需自行安装 Python。
便携版请完整解压 ZIP,不要将 EXE 从 _internal 文件夹旁单独移走。
本次更新:
- 全部 127 个 KI 都有 Windows 安装经验;23 个 KI 携带独立 Windows 配方。
Agent 按当前系统读取,不覆盖 macOS 配方。 - 修复便携工具链与依赖查找、安装路径、超时进程及输出管道回收。
- FSM2 官方 Alptal 示例和 MARRMoT 真实 Octave 运行已通过;安装压测快照为
91 installed / 35 needs-user / 1 failed(RAPID)。安装成功不等于科学校准完成。 - 保留稳定浏览器前端、托盘退出、Kimi 全电脑访问确认;KI 更新仍从
main获取。
Windows 打包验证包括:应用及共享库回归测试、冻结程序从独立目录启动、127 个 KI
及平台经验/配方检查、9 个 HTTP 路由、harness/Flow/校准依赖加载、静默安装与卸载。
本轮发布验证不包含重新运行全部 DeepSeek 安装任务,也未覆盖每一种其他电脑配置。
详细证据见随包发布的 Windows-release-validation.json。
现有项目、API 设置和模型安装目录不需要迁移。本包不包含 AI 账号、密钥或全部科学模型二进制。
当前安装器未代码签名;Windows 可能显示未知发布者提示,请先核对下载来源与
SHA256SUMS-Windows.txt 校验和。
This Windows-only release ships a self-contained Python 3.11 installer and portable archive.
It does not replace the macOS/Linux release assets. Read release-manifest.json and
DESKTOP_CHANGELOG.md for the application baseline, Windows KI overlay, and update details.
GeoForge Desktop v0.6.52 — macOS Apple Silicon
GeoForge Desktop — 127 Earth-system models with their KISS Knowledge
Infrastructures, driven by the GeoForge agent.
What is new in v0.6.52
v0.6.52 is the tested Apple-Silicon macOS release. The release gate fails closed
unless the macOS arm64 Desktop archive builds and passes its frozen-runtime smoke
test. It also makes optional geospatial capability probing deterministic on clean
machines where GeoPandas is not installed.
- The KI harness now has a real plan → user approval → execute → verify gate.
Downloads and model tools remain unavailable until the recorded data inventory
and plan are approved; approved runs produce validation receipts. - Harness and Flow are frozen as importable code. Startup and CI verify all nine
Flow modules, including the modules that decide tool trust and build data. - The internal
GEOFORGE_INTAKEcontrol record is consumed but no longer appears
in chat. - Localhost write endpoints require a random SameSite token and matching local
origin. API keys and proxy settings are saved atomically with user-only access. - Shared NetCDF helpers correctly handle descending axes, 0–360 longitude and
antimeridian windows, reproject basin vectors, and reject empty or all-missing
selections instead of returning plausible bad data. - KI Observatory, evidence-graded Agent activity, provider-specific proxy routes,
selectable existing installations and portable CRHM/Alpine3D/WRF-Hydro setup
are included in the same release. - The macOS Desktop and CLI packages use one version source. See
release-manifest.jsonfor the machine-readable update contract and
DESKTOP_CHANGELOG.mdfor bilingual details.
Local validation: 311 Desktop/Flow tests, 98 KI-tool tests, 83 climate/unit tests
and 46 diagnostic checks passed. The frozen macOS application is additionally
smoke-tested by the release workflow.
Install
macOS (Apple Silicon — M1 through M4)
unzip GeoForge-Desktop-macos-arm64.app.zip
xattr -dr com.apple.quarantine "GeoForge Desktop.app"
open "GeoForge Desktop.app"
The xattr line is required: the build is not signed by Apple, and without it
macOS refuses to open the app.
Everything is inside the download — all 127 KI packages, the engine, the UI.
No Python installation and no first-run network access.
Talking to models
Uses an agent CLI you already have (claude / codex / gemini / kimi / qwen) or
an API key via ⚙ Settings (Anthropic / DeepSeek / OpenAI / OpenRouter). Switch
between the two with the CLI / API button in the menu bar; provider and model
are per session.
Also here
kiss-macos-arm64.tar.gz — the engine as a terminal command (list, info, init,
verify, papers, doctor). kiss-ki-packages.tar.gz is the KI content on
its own, for running from source; the desktop downloads already contain it.
Not in this release
Intel Macs (x86_64), Windows and Linux are not published by the mac-version
release workflow. Their platform branches and workflows own those deliverables.
GeoForge Desktop v0.6.50 — superseded (incomplete)
This release is incomplete: its CI checks stopped before Desktop binaries were built. Do not use it. Download the corrected, fully tested cross-platform v0.6.52 release instead: https://github.com/lzwei196/KISS---Knowledge-Infrastructure-for-Scientific-Simulation/releases/tag/v0.6.52
GeoForge Desktop v0.6.47 for Windows
Windows release with an explicit in-app Kimi Code access choice.
- Windows AI Settings can keep Kimi disabled safely or enable it with full-computer access.
- Full access requires an explicit risk confirmation.
- Includes all 127 KI packages and the complete Python 3.11 runtime.
Installer SHA-256: C40423D0BB2BEDFCC8818C3001C9CC218AD714EEE3EA59419FDAB60561A7A8F8
Portable ZIP SHA-256: 7BFBFD1EA260931E7E6E7571A2094C87C3DD6DCB508956A38599E7A17934C7DE