From d9a4dbd9aa1d7e59a82ce98de080cdb1e9e57f26 Mon Sep 17 00:00:00 2001 From: Su Zhaoxu <118355852+Explero@users.noreply.github.com> Date: Thu, 23 Jul 2026 10:40:40 +0800 Subject: [PATCH] chore(release): prepare 0.7.1-beta.1 --- README.md | 4 ++-- docs/hermes_role_profile_migration.md | 2 +- docs/manual/01-overview.md | 4 ++-- docs/manual/02-installation.md | 12 ++++++------ docs/manual/03-first-research-task.md | 2 +- docs/manual/04-how-it-works.md | 2 +- docs/manual/05-project-setup.md | 2 +- docs/manual/06-tasks-and-planning.md | 2 +- docs/manual/07-spec-and-context.md | 2 +- docs/manual/08-hermes-records.md | 2 +- docs/manual/09-experiments.md | 2 +- docs/manual/10-runs-and-replay.md | 2 +- docs/manual/11-metrics-and-comparison.md | 2 +- docs/manual/12-reports-and-claims.md | 2 +- docs/manual/13-workers-and-gates.md | 2 +- docs/manual/14-workflows-and-platforms.md | 4 ++-- docs/manual/15-channel-and-memory.md | 2 +- docs/manual/16-update-recovery-and-uninstall.md | 2 +- docs/manual/17-lean-research-closure.md | 2 +- docs/manual/README.md | 2 +- docs/manual/appendix-a-cli-reference.md | 4 ++-- docs/manual/appendix-b-directory-reference.md | 2 +- docs/manual/appendix-c-configuration-reference.md | 2 +- docs/manual/appendix-d-record-schema.md | 2 +- docs/manual/appendix-e-troubleshooting.md | 2 +- docs/manual/appendix-f-feature-status.md | 4 ++-- docs/manual/sources.md | 2 +- packages/cli/README.md | 4 ++-- packages/cli/package.json | 2 +- .../cli/src/templates/trellis/hermes/config.yaml | 2 +- packages/core/README.md | 4 ++-- packages/core/package.json | 2 +- 32 files changed, 44 insertions(+), 44 deletions(-) diff --git a/README.md b/README.md index 51104a3..1e53fef 100644 --- a/README.md +++ b/README.md @@ -97,7 +97,7 @@ node packages/cli/scripts/release-preflight.js verify-packed-cli 新包发布后，可固定安装本次测试版： ```bash -npm install -g research-trellis@0.7.1-beta.0 +npm install -g research-trellis@0.7.1-beta.1 research-trellis --version ``` @@ -107,7 +107,7 @@ research-trellis --version ```bash npm uninstall -g trellis-hermes -npm install -g research-trellis@0.7.1-beta.0 +npm install -g research-trellis@0.7.1-beta.1 research-trellis --version ``` diff --git a/docs/hermes_role_profile_migration.md b/docs/hermes_role_profile_migration.md index 7d35b42..dc3fa7e 100644 --- a/docs/hermes_role_profile_migration.md +++ b/docs/hermes_role_profile_migration.md @@ -26,7 +26,7 @@ ## 派发上下文 -`v0.7.1-beta.0`（当前测试版）开始，主代理先生成 validated dispatch（已验证派发），其中只保留： +从 `v0.7.1-beta.0`（首个测试版）开始，主代理先生成 validated dispatch（已验证派发），其中只保留： 1. `job_id`（工作编号）和 `hermes_revision`（Hermes 修订号）； 2. 当前角色与模式； diff --git a/docs/manual/01-overview.md b/docs/manual/01-overview.md index 95cef6d..2d075b3 100644 --- a/docs/manual/01-overview.md +++ b/docs/manual/01-overview.md @@ -11,7 +11,7 @@ ## 前置条件 - 能管理目标项目中的文件和提交。 -- 接受当前版本为 `0.7.1-beta.0`（测试版）。 +- 接受当前版本为 `0.7.1-beta.1`（测试版）。 - 不把它当作安全隔离工具或自动科研结论系统。 ## 操作步骤 @@ -45,7 +45,7 @@ ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n "AGPL|Hermes|未实现" README.md docs/manual/appendix-f-feature-status.md`（静态核对）。 - 结果：项目定位、上游归属、实验性与未实现边界已对齐。 diff --git a/docs/manual/02-installation.md b/docs/manual/02-installation.md index 4be1cbd..07210f7 100644 --- a/docs/manual/02-installation.md +++ b/docs/manual/02-installation.md @@ -28,7 +28,7 @@ git --version 新包发布后，推荐固定安装本手册对应的测试版： ```bash -npm install --global research-trellis@0.7.1-beta.0 +npm install --global research-trellis@0.7.1-beta.1 research-trellis --version research-trellis --help ``` @@ -36,14 +36,14 @@ research-trellis --help 如不希望全局安装，可临时执行： ```bash -npm exec --yes --package research-trellis@0.7.1-beta.0 -- research-trellis --version +npm exec --yes --package research-trellis@0.7.1-beta.1 -- research-trellis --version ``` 已经安装旧包时，先卸载旧名称，再安装新包： ```bash npm uninstall --global trellis-hermes -npm install --global research-trellis@0.7.1-beta.0 +npm install --global research-trellis@0.7.1-beta.1 research-trellis --version ``` @@ -62,7 +62,7 @@ node packages/cli/bin/trellis.js --version ## 预期结果 -版本命令输出 `0.7.1-beta.0`，帮助中能看到 `init`（初始化）、`update`（更新）、`workflow`（工作流）、`channel`（协作频道）和 `mem`（会话记忆）等命令。 +版本命令输出 `0.7.1-beta.1`，帮助中能看到 `init`（初始化）、`update`（更新）、`workflow`（工作流）、`channel`（协作频道）和 `mem`（会话记忆）等命令。 ## 失败恢复 @@ -74,10 +74,10 @@ node packages/cli/bin/trellis.js --version ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`node -p "require('./packages/cli/package.json').version"`（包版本核对）。 -- 结果：源码包版本为 `0.7.1-beta.0`（测试版），运行时要求与包配置一致。 +- 结果：源码包版本为 `0.7.1-beta.1`（测试版），运行时要求与包配置一致。 - 未验证项：本轮未重新进行全局安装，也未实时查询 `npm`（Node 包平台）标签。 ## 来源 diff --git a/docs/manual/03-first-research-task.md b/docs/manual/03-first-research-task.md index 96d4d69..a12948e 100644 --- a/docs/manual/03-first-research-task.md +++ b/docs/manual/03-first-research-task.md @@ -95,7 +95,7 @@ python3 ./.trellis/scripts/closure.py close --task "$TASK" ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n "experiment.py|task.py start|--codex" packages/cli/src packages/cli/test`（实现与测试核对）。 - 结果：初始化、任务创建、实验校验和启动步骤与当前入口一致。 diff --git a/docs/manual/04-how-it-works.md b/docs/manual/04-how-it-works.md index 5112f83..b427ed7 100644 --- a/docs/manual/04-how-it-works.md +++ b/docs/manual/04-how-it-works.md @@ -62,7 +62,7 @@ ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n "state_machine|approval-gate|task.py" packages/cli/src/templates`（协议与实现核对）。 - 结果：任务生命周期有实现支持；科研状态文件已准确标为协议模板。 diff --git a/docs/manual/05-project-setup.md b/docs/manual/05-project-setup.md index e60b741..8ec97d2 100644 --- a/docs/manual/05-project-setup.md +++ b/docs/manual/05-project-setup.md @@ -88,7 +88,7 @@ python3 ./.trellis/scripts/task.py list ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n "options.yes|registry|selectedTemplate" packages/cli/src/commands/init.ts packages/cli/test/commands/init.integration.test.ts`（分支核对）。 - 结果：默认、交互、指定模板、自定义源和 `-y`（自动确认）的失败行为已分开记录。 diff --git a/docs/manual/06-tasks-and-planning.md b/docs/manual/06-tasks-and-planning.md index c26a9ff..b35f914 100644 --- a/docs/manual/06-tasks-and-planning.md +++ b/docs/manual/06-tasks-and-planning.md @@ -104,7 +104,7 @@ python3 ./.trellis/scripts/closure.py grill --task "$TASK" --complete \ ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n "plan_change|decision_state|supersedes" packages/cli/src/templates/trellis/scripts/hermes packages/cli/test/templates/hermes-runtime.test.ts`（变更协议核对）。 - 结果：提出、审阅、接受或拒绝、替代和校验流程已补全，并明示了结构校验边界。 diff --git a/docs/manual/07-spec-and-context.md b/docs/manual/07-spec-and-context.md index 275badd..be8aede 100644 --- a/docs/manual/07-spec-and-context.md +++ b/docs/manual/07-spec-and-context.md @@ -62,7 +62,7 @@ python3 ./.trellis/scripts/task.py validate "$TASK" ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n "implement.jsonl|check.jsonl|context" packages/cli/src/templates/trellis/scripts packages/cli/test`（上下文实现核对）。 - 结果：上下文清单、重复检查和平台读取路径与当前模板一致。 diff --git a/docs/manual/08-hermes-records.md b/docs/manual/08-hermes-records.md index b2e08b2..835c282 100644 --- a/docs/manual/08-hermes-records.md +++ b/docs/manual/08-hermes-records.md @@ -72,7 +72,7 @@ python3 ./.trellis/scripts/hermes/validate.py --task "$TASK" --kind evidence ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n "validate_artifact_file|artifact_ref_errors|has_symlink_component" packages/cli/src/templates/trellis/scripts/hermes/runtime.py`（路径与引用边界核对）。 - 结果：示例已改为先创建产物和摘要，再写产物与证据账本；路径检查范围已明示。 diff --git a/docs/manual/09-experiments.md b/docs/manual/09-experiments.md index 75b356e..239b7dd 100644 --- a/docs/manual/09-experiments.md +++ b/docs/manual/09-experiments.md @@ -78,7 +78,7 @@ python3 ./.trellis/scripts/hermes/experiment.py validate --task "$TASK" ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n -m 1 "allowed_commands" packages/cli/src/templates/trellis/scripts/hermes packages/cli/test/templates/hermes-runtime.test.ts`（实现与测试核对）。 - 结果：命令允许列表和本地运行记录均可定位。 diff --git a/docs/manual/10-runs-and-replay.md b/docs/manual/10-runs-and-replay.md index fb60377..47c0a38 100644 --- a/docs/manual/10-runs-and-replay.md +++ b/docs/manual/10-runs-and-replay.md @@ -65,7 +65,7 @@ python3 ./.trellis/scripts/hermes/runner.py replay --task "$TASK" --run-id "$RUN ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n -m 1 "run_manifest|replay" packages/cli/src/templates/trellis/scripts/hermes packages/cli/test/templates/hermes-runtime.test.ts`（运行清单与复查核对）。 - 结果：运行清单、输出摘要和复查失败分支均有实现与测试依据。 diff --git a/docs/manual/11-metrics-and-comparison.md b/docs/manual/11-metrics-and-comparison.md index 9a8927a..ba241cb 100644 --- a/docs/manual/11-metrics-and-comparison.md +++ b/docs/manual/11-metrics-and-comparison.md @@ -77,7 +77,7 @@ python3 ./.trellis/scripts/hermes/report.py quality-gate --task "$TASK" ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n -m 1 "quality-gate|evidence_refs|claim_refs" packages/cli/src/templates/trellis/scripts/hermes packages/cli/test/templates/hermes-runtime.test.ts`（门禁和引用核对）。 - 结果：质量门禁已有账本编号存在性检查以及有效、缺失引用测试。 diff --git a/docs/manual/12-reports-and-claims.md b/docs/manual/12-reports-and-claims.md index 61aeeef..f8a9529 100644 --- a/docs/manual/12-reports-and-claims.md +++ b/docs/manual/12-reports-and-claims.md @@ -69,7 +69,7 @@ python3 ./.trellis/scripts/hermes/report.py approval-gate --task "$TASK" --claim ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n -m 1 "claim-review|approval-gate" packages/cli/src/templates/trellis/scripts/hermes packages/cli/test/templates/hermes-runtime.test.ts`（主张与审批边界核对）。 - 结果：主张审查和审批门禁入口可定位，报告与人工批准保持分离。 diff --git a/docs/manual/13-workers-and-gates.md b/docs/manual/13-workers-and-gates.md index 02fb0fb..5834bdd 100644 --- a/docs/manual/13-workers-and-gates.md +++ b/docs/manual/13-workers-and-gates.md @@ -179,7 +179,7 @@ python3 ./.trellis/scripts/hermes/evidence.py summary --task "$TASK" ## 验证记录 - 日期：2026-07-16。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n -m 1 "PreToolUse|Stop" packages/cli/src/templates/{claude,codex,shared-hooks} packages/cli/test`（钩子与门禁核对）。 - 结果：五个正式角色、模式校验、旧角色迁移、两平台模板、最小上下文、证据工具和模式感知门禁均有自动化覆盖。 diff --git a/docs/manual/14-workflows-and-platforms.md b/docs/manual/14-workflows-and-platforms.md index 16d3da6..e75ff6f 100644 --- a/docs/manual/14-workflows-and-platforms.md +++ b/docs/manual/14-workflows-and-platforms.md @@ -71,7 +71,7 @@ trust_level = "trusted" `codex.dispatch_mode: inline`（Codex 主会话路由）是显式兼容模式，只改变普通 Trellis 提示路由，不会绕过已启用的 Hermes 写入和结束门禁，也不会提供操作系统隔离。 -`v0.7.1-beta.0`（当前测试版）的 closure 任务仍可在各平台读取 `Task Capsule`（紧凑任务上下文），但可执行的 `Agent Context Firewall`（代理上下文防火墙）只正式支持 `Claude Code`（Claude 代码工具）和 `Codex`（代码代理平台）。其他平台保留原有 Trellis 上下文和代理行为，不宣称具备派发替换、结构化返回或状态确认门禁。 +`v0.7.1-beta.1`（当前测试版）的 closure 任务仍可在各平台读取 `Task Capsule`（紧凑任务上下文），但可执行的 `Agent Context Firewall`（代理上下文防火墙）只正式支持 `Claude Code`（Claude 代码工具）和 `Codex`（代码代理平台）。其他平台保留原有 Trellis 上下文和代理行为，不宣称具备派发替换、结构化返回或状态确认门禁。 五个正式 `Hermes`（科研工作流）角色模板目前只为 `Claude Code`（Claude 代码工具）和 `Codex`（代码代理平台）提供。`Claude Code`（Claude 代码工具）可使用已批准的 `PreToolUse / SubagentStop / PostToolUse`（工具前、子代理结束、工具后）钩子完成派发替换和结果净化；`Codex`（代码代理平台）使用相同的紧凑派发与结果契约，并通过项目钩子限制主代理写入、直接执行和提前结束。Codex 的子代理输入仍依赖协议，不宣称完全硬隔离。 @@ -124,7 +124,7 @@ trust_level = "trusted" ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n -m 1 "dispatch_mode|agentCapable|hasHooks" packages/cli/src packages/cli/test`（平台能力核对）。 - 结果：常规平台能力表保留；代理上下文防火墙的正式范围收窄为 Claude Code 和 Codex，并使用相同的最小上下文语义。 diff --git a/docs/manual/15-channel-and-memory.md b/docs/manual/15-channel-and-memory.md index 5840d3b..ee450f2 100644 --- a/docs/manual/15-channel-and-memory.md +++ b/docs/manual/15-channel-and-memory.md @@ -66,7 +66,7 @@ research-trellis mem search "固定指标" --platform codex --cwd "$PWD" --limit ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n -m 1 "OpenCode|channel|mem" packages/cli/src/commands packages/core/src packages/cli/test packages/core/test`（频道与会话读取核对）。 - 结果：频道、会话读取和 `OpenCode`（开放代码工具）未实现分支均有当前代码与测试依据。 diff --git a/docs/manual/16-update-recovery-and-uninstall.md b/docs/manual/16-update-recovery-and-uninstall.md index fd23c10..bdce79a 100644 --- a/docs/manual/16-update-recovery-and-uninstall.md +++ b/docs/manual/16-update-recovery-and-uninstall.md @@ -69,7 +69,7 @@ research-trellis uninstall --yes ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 更名前基准提交：`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。 - 命令：`rg -n -m 1 "dry-run|create-new|allow-downgrade" packages/cli/src/commands packages/cli/test/commands`（更新与恢复核对）。 - 结果：预览、冲突副本、降级拒绝和卸载预览分支均可定位。 diff --git a/docs/manual/17-lean-research-closure.md b/docs/manual/17-lean-research-closure.md index fc5efc0..0176b42 100644 --- a/docs/manual/17-lean-research-closure.md +++ b/docs/manual/17-lean-research-closure.md @@ -186,7 +186,7 @@ python3 ./.trellis/scripts/closure.py amend --task "$TASK" \ ## 验证记录 - 日期：2026-07-15。 -- 版本：`0.7.1-beta.0`（测试版）。 +- 版本：`0.7.1-beta.1`（测试版）。 - 命令：closure CLI 集成测试、共享 hook 测试、核心 task schema 测试和场景 smoke test（冒烟测试）。 - 结果：适度拆解、修订号、派发过期、结果净化、模式心跳、有限 repair、关闭和归档兼容均有自动化覆盖。 - 未验证项：自动候选工作包的科研语义仍需任务负责人审阅；人工审批身份真实性由外部流程保证。 diff --git a/docs/manual/README.md b/docs/manual/README.md index f58667e..50083ea 100644 --- a/docs/manual/README.md +++ b/docs/manual/README.md @@ -1,6 +1,6 @@ # Research Trellis 中文手册 -这套手册面向第一次把 `Research Trellis`（科研改造版）放进真实科研项目的人。当前仓库版本为 `0.7.1-beta.0`（测试版）；它基于 `mindfold-ai/Trellis`（上游项目）修改，不是上游官方版本，也不代表上游立场。 +这套手册面向第一次把 `Research Trellis`（科研改造版）放进真实科研项目的人。当前仓库版本为 `0.7.1-beta.1`（测试版）；它基于 `mindfold-ai/Trellis`（上游项目）修改，不是上游官方版本，也不代表上游立场。 ## 最短上手路径 diff --git a/docs/manual/appendix-a-cli-reference.md b/docs/manual/appendix-a-cli-reference.md index 85abe23..098d804 100644 --- a/docs/manual/appendix-a-cli-reference.md +++ b/docs/manual/appendix-a-cli-reference.md @@ -6,7 +6,7 @@ ## 适用范围 -适用于 `0.7.1-beta.0`（测试版）。 +适用于 `0.7.1-beta.1`（测试版）。 ## 前置条件 @@ -115,7 +115,7 @@ python3 ./.trellis/scripts/hermes/dispatch.py status --task "$TASK" --job-id