whoiswennie/WorldlineBox

世界线

基于 Cordis 的 Agent Harness，也是通往原创世界线的入口。

世界线（Worldline）是以 Cordis 为内核的模块化 Agent 运行时。Agent 循环、模型供应商、提示词、工具、会话、CLI、内部 Web 运行时与 Electron 桌面应用都由具备生命周期的插件组合，而非绑定到某一种模型服务。

世界线是基石应用；世界线幻想（Worldline Fantasy） 是建立在这一基石之上的独立游戏与创作项目，其原创世界以 “素”体系为共同基础。应用图标中的原创角色 幻是世界线的观测者与连接者；她让不同故事彼此可见，却不把它们压缩成唯一叙事。

每一个世界都有其故事，每一个故事都值得被观测。——幻

核心能力

- 完整的 Headless 与桌面 Agent Loop，以及可重放的会话事件日志。
- Cordis 依赖注入、作用域生命周期、Effect 与可释放注册表。
- 边界明确、可独立组合的 Host/Client 小型插件。
- 可插拔的模型、工具、提示词、存储、Profile、主题与语言包。
- 共享同一内部 Web 运行时的 CLI 与 Electron 桌面应用。
- 独立维护并经过加固的 Worldline Cordis 底座。
- 由工程门禁守护的中英双语架构与运维知识库。

世界线目前处于开发者预览阶段；稳定版发布前，接口仍可能调整。

0.2.2 内核更新

世界线 0.2.2 在世界线产品边界优先的前提下，选择性吸收 DeepSeek Harness 0.1.1-rc.2 与 0.1.2-alpha.1 中稳定且不冲突的行为：

- DeepSeek Files API 上传、确定性图片规范化与复用、过期恢复、有界降级，以及计入图片压力的 Token 估算。
- 启动与历史传输提速、HTTP gzip、采用单一 schema 18 的紧凑 SQLite 持久化，以及无损事件来源区间。
- WebFetch 网络安全、WebSocket 心跳、子进程与 PowerShell 稳定性、截断 JSONL 诊断和更严格的编辑工具语义。
- 精确回合用量、回合导航与过程折叠、自适应正文宽度和字号、按会话保存的问题草稿、文件提及、流式代码高亮及中西文自动间距。
- ACP v1 控制、经 profile 启动的 TypeScript SDK/ACP 运行时、子代理动态模型路由、Claude Code/Codex 模型选择、第三方语言注册和提供方设置扩展插槽。
- PTC 成为唯一现行的程序化工具呈现模式；最新版协议仍使用的 run_code 与持久化 tool/code-dispatch 词汇属于当前实现，并非旧兼容层。

插件清单上传、增量会话日志上传和反馈遥测继续默认关闭。世界线账号、设置、附件、Agent Vault 资源、WORLDLINE_HOME 与 ignorable 事件能力继续保持原有所有权边界。开发者预览升级不会并行维护旧 Harness 会话 SQLite schema 17；该可重建开发数据库应直接按 schema 18 重建。

快速开始

推荐使用 Node.js 24，最低支持 Node.js 22.19。pnpm 版本以 package.json 中的固定版本为准。

git clone https://github.com/whoiswennie/WorldlineBox.git
cd WorldlineBox
pnpm install
start-electron.bat

Electron 桌面应用是唯一的产品发布形态。在 Windows 上，start-electron.bat 会重建并启动桌面应用，账户级设置、凭据、插件、会话和工作区均保存在 %USERPROFILE%/.worldline 下。内部 Web Profile 仅作为 Electron 运行时的实现细节，不再打包或启动为独立浏览器产品。

Windows 发布物与启动器使用仓库提供的统一入口验收：

start-electron.bat --no-pause --smoke-test
build-exe.bat --no-pause

压缩的 Electron 安装包、展开后的应用与更新元数据统一写入 release/desktop/。构建器只有在打包运行时验收通过后才会报告成功。世界线不再发布独立浏览器 WebUI 归档。

常用命令：

pnpm worldline --profile headless --help
pnpm run test:runtime
pnpm run test:client
pnpm run test:cli
pnpm run test:desktop

用户状态存放在 %USERPROFILE%/.worldline，凭据不得提交到仓库。

架构概览

CLI / Web / Desktop entry points
│
profile composition
│
Cordis loader and scoped fibers
│
Host plugins ─ services ─ Client plugins
│
models · tools · prompts · sessions · UI

Profile 依次组合基础 Bundle、形态 Bundle、Profile 补丁、用户补丁和命令行补丁。插件通过 inject 声明依赖，由 Effect 与 Registry 管理资源释放；会话事件日志是模型上下文与 UI 投影可重放的事实源。

知识库

| 主题 | 文档 |
| --- | --- |
| 文档地图 | Harness 知识库 |
| 系统设计 | 架构说明 |
| Cordis 基础 | Cordis 入门 |
| 插件清单 | 能力边界 |
| 运行时组合 | Profile 与 Bundle |
| 进程边界 | Host/Client 边界 |
| 持久化 | 会话轮次生命周期 |
| 质量门禁 | 测试与质量 |
| 创作基础 | 世界线、素与幻 |

开发

修改代码前，请先阅读开发指南、AGENTS.md 以及对应包目录中的局部规范。lib、dist 与 release 都是生成内容，不属于源文件。

来源与许可证

世界线以 MIT 许可的 DeepSeek Harness rc.7 为初始底座，并已选择性吸收至 Harness 0.1.2-alpha.1 中兼容的架构、可靠性、性能与产品优化。项目仍独立维护，不建立上游合并工作流；世界线的品牌、产品行为与项目特有能力始终具有优先权。相关署名与第三方许可证仍完整保留。

源代码与技术文档采用 MIT License。世界线的应用身份、世界线幻想的游戏身份、幻的角色美术、图标及其他原创角色资产遵循 BRAND_ASSETS.md，不包含在 MIT 授权中。