NarrativeOS

NarrativeOS 是本机运行的故事、剧本、素材和视频制作服务。通过 Codex 或 WorkBuddy 共创，网页负责阅读、配置、候选选择与媒体预览。视频连接用户自己的 ComfyUI 服务器，使用用户导入或明确选择团队发布的原始 API 工作流。

当前支持 macOS 和 Node.js 24；尚未发布 Windows/Linux 支持。

安装最新版

先安装 Node.js 24，然后执行：

npx --yes @codexiaoke/narrativeos@latest setup

交互式安装会打开网页，在首次设置页为本机 admin 账号设置密码。软件安装到用户的持久目录，后台服务不依赖 npx 缓存或终端保持打开。

npx --yes @codexiaoke/narrativeos@latest open
npx --yes @codexiaoke/narrativeos@latest status
npx --yes @codexiaoke/narrativeos@latest doctor

导入 Codex 自定义插件

安装 Codex 后执行：

npx --yes @codexiaoke/narrativeos@latest connect --client codex --install

命令生成本机插件，包含 MCP 连接、26 项按需技能和实际契约参数资料；备份并合并个人 marketplace，只更新 NarrativeOS 条目，保留其他插件。随后调用 Codex 官方 CLI 安装，并核对返回版本及安装目录。插件源与 Codex 缓存分别保存，不直接编辑缓存。可在 Codex 插件页确认启用，在新对话中使用；应用未刷新插件列表时按宿主提示刷新或重新打开。

CLI 不在 PATH 时，会尝试已安装桌面应用的 CLI，也可以指定：

npx --yes @codexiaoke/narrativeos@latest connect --client codex --install --codex-cli /absolute/path/to/codex

仅导出供手动导入，不修改客户端：

npx --yes @codexiaoke/narrativeos@latest connect --client codex --output /absolute/path/to/new-plugin-directory

手动导入方式见导出目录内的接入说明。插件包含本机 Node 和稳定 launcher 的路径，应在安装服务的同一台电脑使用，不包含服务凭证。生成插件目录不等于已安装；只有 --install 完成并核对成功才返回 installed: true。

WorkBuddy 使用 connect --client workbuddy 生成 connector；当前没有 WorkBuddy 自动安装选项。

更新到最新版

在原安装电脑上依次执行，第一条成功后再执行第二条：

npx --yes @codexiaoke/narrativeos@latest upgrade
npx --yes @codexiaoke/narrativeos@latest connect --client codex --install

第一条更新本地服务，第二条更新 Codex 插件及技能。更新先下载、检查、备份数据库，再激活新版本；保留配置、凭证、作品和媒体。完成后刷新网页，在 Codex 中新开对话。

使用 doctor 查看本机服务版本与运行状态。使用自定义实例目录时，上述命令都追加相同的 --root "/path/to/NarrativeOSService"。更新中断时使用 upgrade --recover 恢复。

导出目录包含该电脑的 Node 与 launcher 绝对路径，应由每个用户在自己的电脑上生成。

默认目录为 ~/Library/Application Support/NarrativeOSService，程序、数据、日志和配置各自保存。--root 可指定隔离实例；隔离实例不会注册用户登录启动项。可用 backup / restore 和 project-export / project-import 备份、恢复或迁移。

默认实例安装用户级 LaunchAgent，在登录后启动；start / stop 管理后台服务。停止本机服务不代表已取消远程任务。首次安装需要联网下载 npm 依赖及固定版本的 FFmpeg 渲染工具，失败时不激活不完整的新版本。

资源版本 0.47.0，契约版本 0.19.0。内容和创作质量由用户与外部客户端 LLM 判断；软件保存正式结果、版本、关联和生成任务。没有内置创作模型或 Jev 判断服务。

本地发行包

从已取得的 tgz 文件安装或验收：

npx --yes --package /absolute/path/release.tgz narrativeos setup --package /absolute/path/release.tgz

发行包保留 UNLICENSED 版权设置。npm 可下载不代表授予开源许可。