ZEUS Terminal 0.7.1

Website · User manual · 使用手册 · All changes since v0.7.0

New features

	Feature	Read more
	🤖 In the official MCP Registry: ZEUS is listed as io.github.jackson-cmd/zeus-options-terminal, so AI clients that install MCP servers from the registry can find it and start it themselves, from PyPI with uvx zeus-options-terminal --no-browser --port 8765 or from the Docker image, and reach MCP at http://localhost:8765/mcp. zeus-options-terminal is now a third name for the zeus command. (#64)	Connect an agent →

Project

• Each release is listed in the MCP Registry once its Docker image is pushed. The Docker workflow verifies the publisher tool's signature and logs in with GitHub's OIDC token, so no secret is stored; the registry checks that the PyPI package and the image belong to this repository. (#64)
• CITATION.cff for GitHub's "Cite this repository" and for Zenodo, which archives each release; glama.json for the Glama MCP directory. (#64)
• The website has llms.txt, the plain-text map that AI search tools read, and tells IndexNow (Bing and others) about its pages after each deploy. (#65)
• The privacy hook installs from a git worktree, keeps a pre-commit hook you already had, and lets a checkout without the check commit; CONTRIBUTING.md moved into .github/. (#62, #63)

---

新功能

	功能	详细说明
	🤖 进了官方 MCP Registry：ZEUS 在官方 MCP Registry 里的名字是 io.github.jackson-cmd/zeus-options-terminal。从这个目录安装 MCP 服务器的 AI 客户端能找到它，并自己把它启动起来：从 PyPI 用 uvx zeus-options-terminal --no-browser --port 8765，或者用 Docker 镜像，MCP 地址是 http://localhost:8765/mcp。zeus-options-terminal 现在也是 zeus 命令的另一个名字。(#64)	连接智能体 →

项目

• 每次发版，Docker 镜像推送完以后，这个版本会登记到 MCP Registry。Docker 工作流先验过发布工具的签名，再用 GitHub 的 OIDC 令牌登录，不存任何密钥；Registry 会核对 PyPI 包和镜像都属于这个仓库。(#64)
• 加了 CITATION.cff，给 GitHub 的「引用此仓库」和 Zenodo 用，Zenodo 会给每个版本存档；加了 glama.json，给 Glama 的 MCP 目录用。(#64)
• 网站加了 llms.txt，这是 AI 搜索工具读的纯文本地图；每次部署后会把页面告诉 IndexNow（Bing 等搜索引擎）。(#65)
• 隐私检查钩子在 git worktree 里也能装，会保留你原来的 pre-commit 钩子，没有检查脚本的旧分支也能照常提交；CONTRIBUTING.md 挪进了 .github/。(#62、#63)

ZEUS Terminal 0.7.0

Website · User manual · 使用手册 · All changes since v0.6.0

New features

	Feature	Read more
	📦 pip and pipx: pipx install zeus-options-terminal, then zeus, installs and starts ZEUS without cloning the code. zeus --port 8790, --no-browser and --version work as you would expect, and zeus-terminal is the same command. Settings and data stay in ~/.zeus-terminal, so pipx upgrade keeps them. (#61)	Install with pipx →

Project

• pyproject.toml builds the wheel from the zeus/ folder as it is, with the version from APP_VERSION and the dependencies of requirements.txt; a test keeps them equal. Every pull request builds the wheel, installs it in a clean environment and starts zeus from it (tools/package_smoke.sh). (#61)
• Each release is uploaded to PyPI by the Release workflow through trusted publishing, so no token is stored, and only after the same check has passed. (#61)

---

新功能

	功能	详细说明
	📦 pip 和 pipx：pipx install zeus-options-terminal 之后运行 zeus，不用 clone 代码就能装好并启动 ZEUS。zeus --port 8790、--no-browser、--version 都能用，zeus-terminal 是同一个命令。设置和数据都在 ~/.zeus-terminal，pipx upgrade 升级时都保留。(#61)	用 pipx 安装 →

项目

• pyproject.toml 把 zeus/ 文件夹原样打成安装包，版本号取自 APP_VERSION，依赖和 requirements.txt 一致，有测试保证两边相同。每个 PR 都会构建安装包，在干净环境里装好，再从里面启动 zeus（tools/package_smoke.sh）。(#61)
• 每次发版，Release 工作流都会通过可信发布把这个版本上传到 PyPI，不存任何 token，而且要先通过同样的检查。(#61)

ZEUS Terminal 0.6.0

Website · User manual · 使用手册 · All changes since v0.5.2

New features

	Feature	Read more
	🐳 Run with Docker: docker run -d --name zeus --restart unless-stopped -p 127.0.0.1:8765:8765 -v zeus-data:/data ghcr.io/jackson-cmd/zeus-options-terminal:latest starts ZEUS without Python, on Intel, AMD and ARM. Your settings, trades and caches live in the zeus-data volume and survive updates; ZEUS runs as an ordinary user that cannot change its code; the port stays on 127.0.0.1. The image runs on New York time; -e TZ= sets your own. (#59)	Manual §1.7
	AI agents and Docker: agents on your computer start ZEUS's MCP bridge inside the container with docker exec, and ⚙ Settings → AI agents shows those commands when ZEUS runs in Docker. Over HTTP, MCP in the container answers your computer only when you start it with -e ZEUS_MCP_FROM_HOST=1. (#59)	Manual §18.2

Fixed

• A model server on this computer at 127.0.0.1, or at host.docker.internal from the container, is now used without an API key, as localhost already was. (#59)
• When the code folder is read-only and a runtime link under zeus/ cannot be changed, ZEUS now names the folder at start instead of stopping with an error. (#59)

Project

• Each release builds the image for amd64 and arm64, starts it and checks the page, the status API, the localhost checks, the sample portfolio, MCP and a restart (tools/docker_smoke.sh), then pushes it to GitHub Packages as 0.6.0, 0.6 and latest with a signed build provenance. Pull requests that change the image get the same check without pushing. (#59)
• The Dockerfile sits in zeus/ with its ignore file, so the top of the repository stays at 20 entries. (#59)

---

新功能

	功能	详见
	🐳 用 Docker 运行：docker run -d --name zeus --restart unless-stopped -p 127.0.0.1:8765:8765 -v zeus-data:/data ghcr.io/jackson-cmd/zeus-options-terminal:latest 一条命令启动 ZEUS，不用装 Python，Intel、AMD、ARM 都能跑。设置、交易和缓存存在 zeus-data 卷里，更新也不会丢；ZEUS 以普通用户身份运行，改不了自己的代码；端口只留在 127.0.0.1 上。镜像默认是纽约时间，用 -e TZ= 换成你自己的时区。(#59)	手册 §1.7
	AI 智能体和 Docker：本机的智能体用 docker exec 在容器里启动 ZEUS 的 MCP 桥接脚本；ZEUS 跑在 Docker 里时，⚙ 设置 → AI 智能体 列出的就是这些命令。容器里的 MCP HTTP 接口只有在启动时加了 -e ZEUS_MCP_FROM_HOST=1 才回应本机。(#59)	手册 §18.2

修复

• 本机上地址是 127.0.0.1 的模型服务，以及从容器里看是 host.docker.internal 的模型服务，现在不填 API key 也能用，和 localhost 一样。(#59)
• 代码文件夹只读、zeus/ 下的运行数据链接改不了时，ZEUS 现在会在启动时说明是哪个文件夹，不再直接报错退出。(#59)

项目

• 每次发版都会构建 amd64 和 arm64 两种镜像，启动后检查页面、状态接口、本机检查、示例组合、MCP 和重启（tools/docker_smoke.sh），全部通过才推送到 GitHub Packages，标签是 0.6.0、0.6 和 latest，并附上签名的构建来源证明。改到镜像的 PR 也会做同样的检查，只是不推送。(#59)
• Dockerfile 和它的忽略文件放在 zeus/ 里，仓库最上层仍然是 20 项。(#59)

ZEUS Terminal 0.5.2

Website · User manual · 使用手册 · All changes since v0.5.1

Security

• A page on another website could make your browser call /api/stock_selector?today=… on the local ZEUS server, and ZEUS wrote the screener result to the path given in today. Such a page could create or overwrite .json files outside ZEUS's folders and start a screener run. today must now be a date; anything else gets an error, and nothing is read or written. (#56)
• Every cache file named after a date, a ticker or a scope now checks that value itself: AI summaries, pivot summaries, news translations, must-read marks, AI picks, the news and Finviz archives, and the market-event archives. Dates are rebuilt from the day they name and path characters are replaced, so no value from a request can lead outside its folder, on Windows either. (#56)
• News links lose their tracking parameters only when the host really is wsj.com or marketwatch.com, not whenever the text appears somewhere in the link. (#56)
• The optional Benzinga helper in zeus/premarket takes the fixed releases of ws, tar-fs, basic-ftp, ip-address, js-yaml and brace-expansion and drops csv-parse, which it never used. npm run scrape now runs fetch.mjs, the script that exists. If you use the helper, run npm install in zeus/premarket again. (#56)

---

安全

• 别的网站上的页面可以让你的浏览器调用本机 ZEUS 的 /api/stock_selector?today=…，而 ZEUS 会把选股结果写到 today 给出的路径上。这样的页面能在 ZEUS 的文件夹以外新建或覆盖 .json 文件，还会触发一次选股。现在 today 必须是日期，否则直接报错，什么都不读也不写。(#56)
• 所有按日期、代码或名称命名的缓存文件，现在都自己检查传进来的值：AI 总结、转折点总结、新闻翻译、必读标记、AI 选股、新闻和 Finviz 存档、市场事件存档。日期按它说的那一天重新拼出来，路径符号一律替换，请求里的任何值都出不了它的文件夹，Windows 上也一样。(#56)
• 新闻链接只有在网址的主机确实是 wsj.com 或 marketwatch.com 时才去掉跟踪参数，不再是链接里随便哪里出现这几个字就去掉。(#56)
• 可选的 Benzinga 辅助脚本 zeus/premarket 改用 ws、tar-fs、basic-ftp、ip-address、js-yaml、brace-expansion 的已修复版本，并去掉了从没用到的 csv-parse；npm run scrape 现在运行实际存在的 fetch.mjs。如果你在用它，请在 zeus/premarket 里重新运行一次 npm install。(#56)

ZEUS Terminal 0.5.1

The first tagged release of ZEUS Terminal · 宙斯期权终端: a self-hosted options trading terminal that puts positions and Greeks, risk, paper trading, a stock picker, news and a trade journal in one place, on your own computer. Website · User manual · Full changelog

Highlights of 0.5

• Alpaca and Public. Connect an Alpaca account (free, paper trading included) or a Public account for live positions, fills, working orders, and quotes with Greeks. ZEUS only reads; it never places an order.
• Positions and quotes are separate choices. For example, keep uploading your trades and take quotes from Alpaca. Anything a broker lacks, such as index levels, comes from the free sources (Cboe options, Yahoo stocks), and so does everything while a broker is rate-limited.
• Try it without any account. On a fresh install, Load the sample builds six positions and one closed trade, priced with that day's real option quotes. One click removes them again.
• Settings → Broker & data. A comparison table, then one block per broker with its own Test connection.
• Tidy repository. All code now lives in zeus/, and the README opens with a banner, a 14-second tour and the quick start.

Upgrading

git pull
./start.sh          # Windows: start.bat

Your settings and data in ~/.zeus-terminal are not touched. On the first start after the update, ZEUS makes its runtime links under zeus/ and removes the old ones at the top of the folder; folders and other links are never touched. If you connected Claude Desktop through the stdio bridge, copy the snippet from Settings → AI agents again: the bridge is now zeus/zeus_mcp_stdio.py.

Fixed in 0.5.0 and 0.5.1

• Esc closes the topmost pop-up everywhere, including the checkup with the cursor in its ticker box, AI review, AI picks, news AI and earnings.
• The 🌐 translation panel closes on Esc, on a click outside and on a tab switch, instead of staying over the page.
• A first visit no longer jumps to the Picker before the welcome card is seen.
• The trade journal explains how it fills up when it has no data yet.
• Remove the sample works; the sample prices from Yahoo when Cboe is busy.
• Times of uploaded trades follow New York time all year.

---

0.5 的主要更新

• 接入 Alpaca 和 Public。 连上 Alpaca（免费，自带模拟盘）或 Public 账户，就有实时持仓、成交、在途订单和带希腊值的报价。ZEUS 只读，从不下单。
• 持仓和行情分开选。 比如照样上传自己的交易，行情改用 Alpaca。券商没有的数据（比如指数点位），以及券商被限流的时候，都走免费源（Cboe 期权、Yahoo 股票）。
• 什么账户都没有也能先试。 新装后点 载入示例组合，按当天的真实期权报价生成 6 个持仓和 1 笔已平仓交易，一键清除。
• 设置 → 券商与行情。 先是一张对比表，再每家券商一栏，各有 测试连接。
• 仓库整理。 所有代码都在 zeus/ 里；README 打开就是横幅、14 秒演示动图和快速开始。

升级

git pull
./start.sh          # Windows：start.bat

~/.zeus-terminal 里的设置和数据不受影响。更新后第一次启动，ZEUS 会在 zeus/ 下建好运行数据的链接，并删掉最上层留下的旧链接；文件夹和别的链接一概不碰。如果你通过 stdio 桥接连了 Claude Desktop，请到 设置 → AI 智能体 重新复制一次配置：桥接脚本现在是 zeus/zeus_mcp_stdio.py。

0.5.0 和 0.5.1 修好的问题

• 在任何地方按 Esc 都会关掉最上面那层弹窗，包括光标停在代码框里的体检、AI 点评、AI 选股、新闻 AI 和财报弹窗。
• 🌐 翻译源面板按 Esc、点外面、切标签都会关掉，不再一直盖在页面上。
• 第一次打开时，不会在你看到欢迎卡片之前就跳到选股页。
• 交易日记没数据时，会说明日记怎么生成。
• 清除示例 能用了；Cboe 忙的时候，示例改用 Yahoo 定价。
• 上传交易的时间全年按纽约时间算。