Repository navigation
Releases
Continuity 3.9.2
Continuity 把项目的当前需求、停止点、下一步和验收证据保存在工作区里。首次使用准备好 Python 3.9 或更新版本,下载本页的 agent-workspace-3.9.2.zip,解压到空目录,用代理打开并说「读 AGENTS.md,开始」。
这版解决了什么
- 任务归档后,改坏产品测试会使关联需求回到待复验。同一个验收后来失败,也会使旧的通过失效。通过原命令重新验收后,工作区恢复已验证状态,并保留旧记录。
- 宿主迟到的聊天导出会保留已经观察到的最后一条纠正。Codex 桌面选择题的可见问题和答案可以进入记录。新生成的 Markdown 和机器可读副本共用可见消息,助手回复缺少送达回执时会标为未知。
- 中英文首页提供了开箱入口,并标明各宿主的实测范围。逐项审查覆盖所有者的 70 条需求,列出了六个真实跨工具场景还需补充的证据。阅读需求质量审查
验证
Windows 11 全量 486 项通过,零跳过。GitHub 的 Windows、macOS 和 Linux 七个任务通过。一次真实 Codex Desktop 已结束会话中,19 条用户消息和 45 条助手消息的顺序、可见文字和来源标识全部吻合,重复导入也保持稳定。查看三平台检查
直接解压与从 3.9.1 发行包升级均已实测。安装包共 84 个文件、264,799 字节,SHA-256 为 13ddc5dbcd579c521916d1ef9d561739c4e66e12a90d628c5815d240edbd041a。
正式发布后,Windows、macOS 和 Ubuntu 分别从本页下载同一个 ZIP,核对提交里的校验值,解压到含中文和空格的目录,用各自的启动器通过 CSV 产品测试,封存后读回下一步和 1/1 的需求验收结果。主分支七项源码检查也全部通过。公开安装包三平台验收 · 主分支检查
v3.9.0
Concurrency, messages and privacy. The state line is unchanged; upgrade a 3.x project with ws upgrade from this package. Python 3.9 is now the minimum, so the python3 that comes with macOS works.
- Workspace lock: an operating-system lock on
.agents/cache/ws.flock(msvcrt on Windows, fcntl elsewhere) that ends with the process holding it, so a killed command blocks nothing. Thews.lockof 3.8 still counts while its process runs, andWS_LOCK=legacykeeps it for this version; 3.10.0 drops both. - One permission table decides which session may run each write command, and PROTOCOL prints it. A parallel session changes only tasks in its claim, dropping a task the card names takes it off the card, verify ignores files another session's claim covers, and every owned write command accepts
--session. - Messages: the prompt hook saves each user message as it arrives on every host whose payload holds it, so a turn reconciles it before its checkpoint. A message keeps the ID it got then, written in its transcript heading; the same sentence in two sessions is reconciled in each, and the marks of 3.8 stay valid. A message saved after a checkpoint goes to the next session instead of overturning READY. "yes", "no", "是", "对", "可以" and "行" are reconciled. Transcripts missing from INDEX.md are named, and
ws reconcile allneeds--confirm <count>. - Redaction: private keys go as one block; invisible characters no longer hide a second credential; JSON keys such as
"password"and"secret_key"say their string is the secret;密码admin123, passwords in a sentence,sshpass -pandmysql -pare found; versions, paths and explanations such as "Password: minimum 8 characters" are left alone.ws checkscans the transcripts indocs/chats/. - Credentials (owner decision D2):
"plain"keeps credentials as written only in the files WORKSPACE"credential_files"names; everything else, transcripts included, is redacted. Ask mode refuses no write. - Chat import (owner decision D1):
ws startcopies chats from host stores only when WORKSPACE"chat_import"is"on", and never chats from beforeinit.initasks once, and in a git project also whether git should ignoredocs/chats/.WS_IMPORT=0or1decides for every project. ws hooks enable <host> --absolutewrites absolute paths for hosts that start hooks in another folder; the default stays relative.- CI runs the self-tests on Windows, macOS and Linux with Python 3.9 and the newest Python.
- Upgrade drills from the released 3.8.0, 3.7.0 and 3.6.7 packages: READY right after the upgrade, old message marks kept, a second run changes nothing,
--rollbackrestores every byte.
460 tests passing (full run on Python 3.11.2), and the fast tier on Python 3.9, 3.11, Windows, macOS and Linux. Package SHA-256 b0a7513a3c597a4651f11ab3d278c6499bed53ea833ec8ba362f39eff669da76.
v3.8.0
Semantics and transparency. No change to the state format; upgrade a 3.x project with ws upgrade from this package.
- A task's Scope names paths,
new:<path>for a file the task creates,resource:<name>andtree:. Prose that names no path is refused; parallel claims read only the Scope. - Regressions after sealing: when a file of a verified task changes later, READY waits until
ws verify --staleruns its acceptance again."stale_evidence": "warn"only warns, and so does the first session after an upgrade. Evidence of compacted tasks is sealed too. - Checkpoint and brief say what the work rests on: the saved state, which tasks have test evidence and which only a check, and whether the host was tried end to end. They list shortcuts, such as a test changed between a task's first run and its accepted one, or a verify with
--because. - The brief lists every prohibition and preference within a budget;
ws brief --retiredlists the rest. ws addandws setprint a line for the agent to relay; the prompt hook says what the previous turn recorded;ws reconcile --reviewshows each user message beside its record.- AGENTS.md restores six rules and rewrites two, in no more bytes than before. Mode markers
讨论:/discuss:,只读:/read-only:and确认:/confirm:set the mode of a turn, withws ideafor ideas without an ID. - Coverage files are not watched, and output whose summary is not read points to a JSON or JUnit report.
- Upgrade drills from the released 3.7.0, 3.6.7 and 3.6.6 packages: READY right after the upgrade, a second run changes nothing,
--rollbackrestores every byte.
421 tests passing (full run). Package SHA-256 d103c849021b38c7ea3770b0f59c6e539a1768e02c481e84d5735bcef32ff30e.
v3.7.0
Delivery: how a project receives a new version. No change to the state format.
ws upgrade --target <project>, run from the new template folder, compares each template file as installed, as in the project and as in the new version. Untouched files are replaced; edited guides and adapters are kept, with the new version set aside for a hand merge; project rules in AGENTS.md are carried over; tool code the project changed stops the upgrade; the tool's hook entries are rewritten. Files are staged and journaled, an error puts every file back,--rollbackundoes an upgrade,--scanlists the workspaces under a folder. The upgrade ends with a rebaseline, so a READY workspace stays READY.ws doctorreports hooks, interpreter, session identity, lock and tool files, each problem with the command that fixes it.- Evidence records its summary rules: older evidence is read with the rules it records, and rules 2 no longer misreads an "OK" printed by the program under test or a "FAILED to connect" log line.
ws hooks disable;install --merge --dry-run --diffwith backups; installed manifests match the files copied.- Upgrade drills from 3.6.6 (its package, its checkout and the released zip) and from 3.6.7: READY right after the upgrade,
docs/untouched apart from HANDOFF and MAINTENANCE_LOG, a second run changes nothing,--rollbackrestores every byte.
Upgrade a 3.x project: unzip this package, then run python .agents/tools/ws.py upgrade --target <project> --dry-run from it, and the same without --dry-run.
388 tests passing (full run). Package SHA-256 68b28fe6a6376c643e2da3c0c0f6032a4a65b1e6b5666061a1e564702346a3ce.
v3.6.7
Fixes from a three-round review of 3.6.6, with no new command or file format. Each fix has a regression test, listed in .agents/guides/FIXES.md of the template.
- The lock no longer reclaims by generation: a live holder keeps it, only the holder releases it, and Windows sharing violations are retried.
- Retiring what another session's task builds on is refused; a released session resumes once under its own revision; writes stay checked past a bad state line.
- Cursor conversations are named by
CURSOR_CONVERSATION_ID, so Cursor subagents cannot write. - Parallel-session guards, evidence fixes (invalid expect patterns, backticked
check:, test evidence for a check), hooks recognized in any path form and written with an interpreter that exists, a readable message on Python older than 3.10. - Releases are gated on clean source, lint, the fast tier and a full self-test run of the same code.
349 tests passing (full run). Package SHA-256 0393e13adf464ca980dd1832d46970420c7eefd739e71260af696332ec899151.
v3.6.6
Lock fencing token, open-source README, MIT license. 276 tests passing.