windows-release
Build, verify, and publish the Windows desktop build (NSIS installer + latest.yml) to the openfolks-releases repo. Use when cutting a release, shipping a new version to Windows users, or when a Windows user reports they are stuck on an old version. Windows only — does not cover the macOS dmg/notarization flow.
- License 许可
- MIT
- 最近更新
- 2026-10-25
- Stars
- ★ 2
- Forks
- 1
01 前言 Front Matter
- name
- windows-release
- description
- Build, verify, and publish the Windows desktop build (NSIS installer + latest.yml) to the openfolks-releases repo. Use when cutting a release, shipping a new version to Windows users, or when a Windows user reports they are stuck on an old version. Windows only — does not cover the macOS dmg/notarization flow.
03 SKILL.md 正文
Windows release
Ships OpenFolks-<version>-setup.exe and its update feed to
manasdutta04/openfolks.
Scope: Windows only. The macOS build is a separate flow (dmg + notarytool + staple) that must run on a Mac. This skill never touches mac artifacts — but see Every release ships both before you finish.
Preconditions
- Run on Windows. NSIS packaging from macOS needs Wine; don't.
- Node 24+ (
package.jsonengines). Node 23 builds fine but pnpm warns on every step and CI runs 24 — don't debug a runtime oddity on the wrong major. - pnpm via
corepack pnpm. Ifcorepack enablefails with EPERM (no admin), drop apnpm.cmdshim containing@echo off/corepack pnpm %*somewhere on PATH —package:winchainspnpm build && …and needs barepnpmto resolve.
1. Version
Bump version in package.json. It must match the tag on the GitHub release you
upload to, and it becomes the version electron-updater compares against.
2. Build
pnpm install
pnpm typecheck
pnpm package:win
package:win deliberately omits build:speech — the dictation helper is a signed
macOS Swift binary and has no Windows counterpart.
Output in release/:
| File | Purpose |
|---|---|
OpenFolks-<version>-setup.exe |
the installer |
latest.yml |
the update feed — see step 4 |
OpenFolks-<version>-setup.exe.blockmap |
differential updates |
OpenFolks-<version>-x64.zip |
portable, not used by the updater |
3. Verify before uploading
Three things silently produce a broken app if wrong. Check all three:
Test-Path release\win-unpacked\resources\server\index.js # harness server
Test-Path release\win-unpacked\resources\ui\index.html # built UI
Get-Content release\win-unpacked\resources\app-update.yml # feed config
- Missing
server/index.js→utilityProcess.forkfails → the 🐭 "Couldn't start the bot server" page. - Missing
ui/index.html→ server has nothing to serve → black window. app-update.ymlmust point atmanasdutta04/openfolksand, while the build is unsigned, must not containpublisherName— electron-updater would reject every update as untrusted.
Then smoke-test the installer itself. Run it, and confirm:
- It installs per-user with no UAC prompt and launches.
- The chat window renders (not the error page). Server logs land in
%APPDATA%\OpenFolks\logs\server.log. - The model picker lists at least one provider — this exercises the
.cmd-shim resolution inserver/procs.ts, which only ever runs for real on Windows. - No update popup appears on launch. Background check failures are silent by design; a popup here means that regressed.
4. Publish
Upload to the same tag as the macOS release for that version, so one release carries both platforms.
Copy-Item release/OpenFolks-<version>-setup.exe release/OpenFolks-setup.exe
gh release upload v<version> --repo manasdutta04/openfolks `
release/OpenFolks-<version>-setup.exe `
release/OpenFolks-setup.exe `
release/OpenFolks-<version>-setup.exe.blockmap `
release/latest.yml
Both names are required, for different consumers:
OpenFolks-<version>-setup.exeis whatlatest.ymlreferences by name and sha512. The auto-updater downloads exactly this.OpenFolks-setup.exeis a byte-identical copy that gives the README's/releases/latest/download/OpenFolks-setup.exebutton a stable URL. This mirrorsOpenFolks.dmgsitting besideOpenFolks-<version>.dmg.
latest.yml is not optional
Without it every installed Windows app 404s on check and stays on its version
forever. It is generated by package:win even under --publish never.
Never hand-edit it or carry one forward from a previous build. It pins the installer's sha512; a mismatch makes the updater download and then reject the update, which looks like "updates silently do nothing".
Every release ships both
A version that exists on macOS but not on this release is a Windows user stuck on
old code with no signal that anything is wrong — the updater reports "up to date"
because latest.yml still describes the older build.
So: whenever a new version goes out, this flow runs too. If Windows can't ship for some reason, don't publish the mac-only release under a new version tag either — or accept that Windows is knowingly frozen and say so in the release notes.
Because the two builds must run on two machines, the tag is the join point: cut the release, attach mac artifacts from the Mac, attach Windows artifacts from here.
Known: the build is unsigned
No certificate is configured, so SmartScreen shows "unknown publisher" and users
click More info → Run anyway. The README documents this. Auto-update still
works because it's unsigned (no publisherName to verify against).
If signing is added later, it goes under win.signtoolOptions or
win.azureSignOptions in electron-builder.yml — electron-builder 26 nests these;
there is no top-level win.certificateFile. Once signed, keep the certificate
subject stable forever, or list both old and new in publisherName; changing it
strands every already-installed user.
04 同仓库更多 Skills
linkedin-search
Use this skill whenever the user wants to search for jobs in any location or market, find job listings, or look up a specific job posting — in any country, city, or remotely. Invoke for open positions, vacancies, and hiring across any sector or role (software, data, design, marketing, finance, legal, operations, etc.). The location is always supplied explicitly by the user. Trigger phrases: find a job, job search, search for jobs, job openings, vacancies, hiring, positions open, remote jobs, "are there any X jobs in <place>", look up this job posting.
freehire-search
Use this skill to search live software / tech / data / engineering job listings across many countries and markets (and remote) via the freehire.me aggregator's public API, or to look up a specific posting. It aggregates roles from ~50 ATS platforms into one schema, so a single skill covers many markets — but its faceted filtering (skills, category, seniority) is tuned tech-first, so scope triggers to technical roles. Trigger phrases: find a tech job, software job search, developer jobs, engineering vacancies, data/ML jobs, DevOps roles, remote developer jobs, "are there any <tech role> jobs in <place>", look up this freehire job posting.
create-verification-skill
Create one reviewed skill that teaches a bot how to launch, drive, and verify a specific app or project. Use only when the user explicitly asks for a verification skill.
linkedin-search
Use this skill whenever the user wants to search for jobs in any location or market, find job listings, or look up a specific job posting — in any country, city, or remotely. Invoke for open positions, vacancies, and hiring across any sector or role (software, data, design, marketing, finance, legal, operations, etc.). The location is always supplied explicitly by the user. Trigger phrases: find a job, job search, search for jobs, job openings, vacancies, hiring, positions open, remote jobs, "are there any X jobs in <place>", look up this job posting.
freehire-search
Use this skill to search live software / tech / data / engineering job listings across many countries and markets (and remote) via the freehire.me aggregator's public API, or to look up a specific posting. It aggregates roles from ~50 ATS platforms into one schema, so a single skill covers many markets — but its faceted filtering (skills, category, seniority) is tuned tech-first, so scope triggers to technical roles. Trigger phrases: find a tech job, software job search, developer jobs, engineering vacancies, data/ML jobs, DevOps roles, remote developer jobs, "are there any <tech role> jobs in <place>", look up this freehire job posting.
semi-auto-apply
暂无简介