Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Match verification to the scope and risk of the change. Prefer an explicitly req

## Start each task

1. Read [current status](docs/STATUS.md), [roadmap](docs/ROADMAP.md) and [decision index](docs/DECISIONS.md). Follow their links to the specification for the affected behavior.
1. Read the root [execution plan](PLAN.md), [current status](docs/STATUS.md), [roadmap](docs/ROADMAP.md) and [decision index](docs/DECISIONS.md). Keep the plan filename uppercase. Follow their links to the specification for the affected behavior.
2. Inspect the branch, HEAD, staged/unstaged changes and relevant untracked files. Existing work is part of the working context, not permission to discard or publish it. Do not automatically stash, reset, clean, stage everything, commit or switch branches to obtain a clean baseline.
3. Select one bounded task with an ID, dependencies, affected paths, observable completion conditions and exact validation commands. A new conversation should be able to finish and verify it without relying on the previous chat. Split unrelated behaviors; keep necessary API, persistence, UI and test wiring together.
4. Check existing code and tests before adding an abstraction or dependency. Record a concrete blocker when a missing decision changes scope, compatibility, data safety or authorization; continue independent authorized work.
Expand Down
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ Delivered changes are recorded here. Version tags use `v` followed by a semantic

### Changed

- Make uppercase `PLAN.md` the visible execution-plan entry, retain historical ledgers, and map alpha data/permission gates to controlled and native-worker evidence.
- Apply the approved neutral workspace design and improve launch recovery, conversation/history navigation, frozen follow-up context, material selection and provider editing.
- Product, architecture, logging, architecture diagram and bilingual README now describe Platform-owned conversations, steps, human interactions and artifacts independently of runtime, model, tools and UI.
- OpenCode becomes an optional future adapter; ADR 0001 preserves the historical selection with a supersession notice.
Expand Down
32 changes: 31 additions & 1 deletion plan.md → PLAN.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,34 @@
# OpenLab 当前产品完善计划
# OpenLab 开发执行计划

更新时间:2026-10-25(Asia/Shanghai)。本文件是用户指定的计划入口,文件名固定为大写 `PLAN.md`。本次按 [ROADMAP](docs/ROADMAP.md) 的 ENG-00 至 ENG-06 顺序执行;当前事实和实际检查结果见 [STATUS](docs/STATUS.md),详细证据见 [verification](docs/verification.md)。下方保留前两轮历史台账,不把历史限制误当成本轮授权。

## 当前阶段:ENG-04 数据与权限验收

- 前置:ENG-03 已通过本地构建、57 项 Node 测试和 13 项浏览器;[PR #11](https://github.com/IsaacHuo/OpenLab/pull/11) 的 Windows/Linux/browser、actionlint、Gitleaks、required-checks 全通过,已合并至 main `c9a96f3`。
- 范围:将 alpha 数据和权限门槛逐项映射到现有实现及测试,不改变已确认的架构。
- 完成条件:新轮确认、权限拒绝、只读重放、取消/重启、凭据隔离、人工修订、档案 v1/v2 和跨项目引用各有通过证据;预览限制明确记录。
- 精确验证:`node --test app/tests/platform.test.ts app/tests/runtime.test.ts app/tests/service.test.ts app/tests/store.test.ts app/tests/documents.test.ts app/tests/context.test.ts app/tests/workflow.test.ts`;本轮已运行 30 项,全部通过。
- 交付:更新验收表、STATUS 和本文件,通过本地文档检查及精确 PR CI 后合并。

## 阶段清单

| 阶段 | 状态 | 验收出口与交付 |
| --- | --- | --- |
| ENG-00 协作入口 | 已完成 | AGENTS、路线图、状态与决策可独立读取 |
| ENG-01 收敛既有实现 | 已完成 | 项目源码、设计与许可纳入 PR #11,本地工具和研究数据排除 |
| ENG-02 文档口径 | 已完成 | 能力、限制、版本及历史证据对齐,文档检查通过 |
| ENG-03 构建与浏览器 | 已完成 | CI 独立准备 TeX;跨文档对比回归先失败后通过;本地 13 项和远程门槛通过,PR #11 已合并 |
| ENG-04 数据与权限 | 进行中 | 30 项边界测试通过,验收表与预览限制需提交并通过 PR 门槛 |
| ENG-05 alpha 候选 | 待 ENG-04 | 统一版本 `0.1.0-alpha.1`、启动说明、许可和发布说明;完整检查、构建、浏览器、actionlint、Gitleaks 及精确候选 CI |
| ENG-06 源码预发布 | 待 ENG-05 | 精确 main 的 push CI、release dry-run 通过后,按既有工作流创建不可变 tag 和 GitHub prerelease,核对版本/提交/说明一致 |

## 执行约束和完成边界

2026-10-25 用户已授权连续推进上述阶段,逐阶段提交、建立或更新 PR,并在 required-checks 通过及讨论解决后合并,无需逐阶段确认。发布仍须满足 ENG-05/06 门槛;不绕过 CI,不调用付费模型,不读取或发布用户研究数据,不使用子 Agent。

本轮完成对象是 ENG-00 至 ENG-06 的源码预览路线,不将第二检索源、研究全文提取、任意代码执行、动态外部插件、多 Agent、安装包和团队部署等远期候选视为已经实现。候选须另行具备明确需求及验收。

## 历史:产品完善与插件工作台(2026-10-24)

状态:两轮实施完成,2026-10-24。基于当前工作区增量实现,保留已有未提交改动;完成后保留本文件。

Expand Down
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ The planned workspace combines project navigation, conversation with execution s

| Document | Purpose |
| --- | --- |
| [Development execution plan](PLAN.md) | Current phase, ordered tasks, acceptance exits and retained implementation history |
| [Original vision, Chinese](docs/vision.zh-CN.md) | Founding product vision, preserved as supplied |
| [Product specification](docs/product.md) | Users, first milestone, behavior, and acceptance criteria |
| [Architecture and contracts](docs/architecture.md) | Components, research objects, and runtime interface |
Expand Down
1 change: 1 addition & 0 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,7 @@ OpenLab 是开放科研平台,不是某个 Agent 框架的封装。平台持

## 文档导航

- [开发执行计划](PLAN.md):当前阶段、顺序任务、验收出口及既有执行台账。
- [原始产品愿景](docs/vision.zh-CN.md):保留用户提供的完整规划。
- [产品规格](docs/product.md):用户、首版流程和验收条件。
- [架构与接口](docs/architecture.md)、[技术决策](docs/decisions/0001-foundation.md)。
Expand Down
4 changes: 3 additions & 1 deletion docs/DECISIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@

### D-DOC-01 默认能力也通过静态插件提供

确认时间:2026-10-24,记录于 [plan.md 第二轮](../plan.md)、[设计修订](../doc/design/workspace.md)和 [plugins](plugins.md)。
确认时间:2026-10-24,记录于 [PLAN.md 第二轮](../PLAN.md)、[设计修订](../doc/design/workspace.md)和 [plugins](plugins.md)。

编辑器、预览、比较、编译等默认能力使用同一注册/宿主接口,可停用或替换;平台保管草稿和不可变人工修订,Agent 历史不被编辑覆盖。理由是允许逐项替换能力,同时保留研究记录与原文件。当前仅静态受信模块;没有批准外部包安装器、任意执行或不受信代码沙箱。

Expand All @@ -54,6 +54,8 @@ AGENTS 管规则、ROADMAP 管目标/依赖/验收、STATUS 管实际工作、DE

## 后续决策如何记录

2026-10-25 计划入口修订:用户明确指定根文件名为大写 `PLAN.md`。将原小写文件按 Git 大小写更名并保留历史台账,顶部展示当前阶段与路线图清单。PLAN 提供直接可见的执行入口,ROADMAP 保管详细任务合同和依赖,STATUS 记录实际结果;不另建新的进度服务。

2026-10-25 后续执行授权:用户要求按现有路线图连续完成后续阶段,各阶段按既有规则提交、建立或更新 PR,并在精确修订的 required-checks 通过、讨论解决后合并,不再逐阶段请求确认。该授权允许继续 ENG-03 至 ENG-06 的验收、候选准备和通过发布门槛后的源码预发布;不绕过依赖、CI、许可或数据安全门槛,不包含真实付费模型调用或路线图以外的远期候选功能。

- 一般局部实现沿用现有代码,不为每个函数建立 ADR。跨模块职责、公共 API、档案兼容、权限/隔离、运行时、重要依赖和分发方式变化,需要记清日期、状态、理由、兼容影响、证据及取代关系;需要长篇论证时新增下一编号 ADR 并在本页链接。
Expand Down
5 changes: 3 additions & 2 deletions docs/ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,8 @@
| [product](product.md)、[architecture](architecture.md)、[workspace](workspace.md)、[harness](harness.md)、[logging](logging.md) | 产品行为与架构目标;原有历史描述继续保留 |
| [已确认 UI](../doc/design/README.md) | 视觉、交互、令牌与用户确认的后续修订 |
| [development](development.md)、[plugins](plugins.md)、[OpenAPI](openapi.json) | 当前实现、操作方法、插件与接口契约 |
| [implementation-plan](implementation-plan.md)、[plan.md](../plan.md) | 已有迭代计划与两轮已完成执行台账;保留历史,不另抄一份任务状态 |
| [PLAN.md](../PLAN.md) | 用户指定的根计划入口:当前阶段、阶段清单和验收出口;保留前两轮历史台账 |
| [implementation-plan](implementation-plan.md) | 第一应用迭代的历史实施与验证索引;当前任务合同在本路线图,实际结果在 STATUS |
| [acceptance](acceptance.md)、[verification](verification.md) | 验收场景、测试条件、实际证据及局限 |
| [CONTRIBUTING](../CONTRIBUTING.md)、[maintaining](maintaining.md) | 贡献、CI、GitHub 管理与发布流程 |

Expand Down Expand Up @@ -62,7 +63,7 @@
### ENG-01 盘点并收敛现有改动范围(建议首先执行)

- 依赖:ENG-00。
- 范围:检查 Git 中已有改动、`plan.md`、设计规格、依赖及新文件;交付结论写入 STATUS。2026-10-25 用户授权将已有项目改动提交并推送,沿用现有 PR/CI 规则,不增加业务功能。
- 范围:检查 Git 中已有改动、`PLAN.md`、设计规格、依赖及新文件;交付结论写入 STATUS。2026-10-25 用户授权将已有项目改动提交并推送,沿用现有 PR/CI 规则,不增加业务功能。
- 交付:按已完成行为划分待提交批次,列清依赖和遗漏文件;区分产品源码/测试/许可、已确认设计、本地 `.agents/` 与 `.codex/` 配置、`output/` 未选稿、忽略的数据和缓存。检查 tracked、staged、unstaged、untracked,不使用全量暂存。
- 完成条件:每类改动都有保留/纳入交付/待确认的处置,源码所引用的新文件不会漏交;按新增授权提交、推送项目文件并提供 PR;保留用户所有既有内容和本地工具。需要用户决定的文件列为后续集成阻塞,不妨碍完成盘点。
- 验证:`git status --short --branch`、`git diff --stat`、`git diff --cached --stat`、`git ls-files --others --exclude-standard`、`git diff --check`;逐类核对路径和 import/资源引用,STATUS 记录基线 SHA。单纯盘点无需重跑未变化的完整测试。
Expand Down
Loading
Loading