# TaskOS

**Repository Path**: ausmith/taskos

## Basic Information

- **Project Name**: TaskOS
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-06
- **Last Updated**: 2026-11-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TaskOS

TaskOS 探索如何让人和 agents 持续协作完成复杂工程任务：既能实际执行调查、修改、构建、调试与验证，也能保留跨会话的目标、证据、依赖、Review 和后续承诺。

当前处于产品、MVP 与技术选型阶段。仓库包含设计资料、静态交互原型、运行桥接与本地插件探针，尚未实现正式产品。TaskOS 为暂用名称。

## 从这里开始

- [设计资料索引](docs/README.md)：按问题查找产品、MVP、架构与调研资料。
- [设计哲学](docs/product/design-philosophy.md)：产品目标、人的作用与工作连续性。
- [MVP 范围](docs/mvp/scope.md)：首版边界与后续能力。
- [技术方向](docs/architecture/technical-direction.md)：当前架构建议与验证方向。
- [插件平台与故障边界](docs/architecture/plugin-platform.md)：插件优先、多宿主适配和底层 harness 复用。
- [双工协调层](docs/architecture/collaboration-loop.md)：项目共享任务、动态计划及会话与执行的双向协作。
- [决策记录](docs/decisions/2026-11-06-mvp-architecture.md)：已确认要求、当前建议与未决问题。
- [原型反馈与使用边界](docs/product/prototype-feedback-2026-11-06.md)：后续界面设计与实现前必读。

文档中的建议和待验证事项不能当作已确认方案；当前静态原型是讨论样本，主视图、人机交互与功能仍需迭代。

## 运行静态原型

当前桌面提案是 [v1](prototype/taskos-v1/README.md)，以会话为入口，侧栏按项目组织会话，产物和动态在当前范围内展开；同一会话可切换看板和工作网，支持手动修改、拎出单聊与结果带回；包含主视区讨论与证据、双工状态和按需检索演示。使用纯 HTML / CSS / JavaScript，无前端构建依赖。在仓库根目录运行：

~~~powershell
node prototype/serve.mjs
~~~

打开 http://127.0.0.1:4174/prototype/taskos-v1/ 。状态保存在当前浏览器，设置里可重置。所有执行、日志和记忆记录为演示，不连接 agent、SSH 或真实调度。

[Codex 桥接探针](prototype/agent-bridge/README.md) 独立实现了可替换的 runtime 契约，默认 `gpt-6.1-terra` / `high`，支持显式覆盖且不自动切换模型。已覆盖协议适配和独立只读执行；不等同于宿主项目会话接入。

[Desktop 插件](prototype/taskos-plugin/README.md) 正在集成宿主原生会话、任务板与工作网。0.4.1 已安装，但用户反馈其隐藏执行会话、重复入口和过程展示不符合目标。宿主会话关联存储与开发服务已保存，界面接入尚未完成；见插件 README 的实际边界。

[历史 v0](prototype/taskos-v0/README.md) 保留供对照，不是 UI 定稿。

## 目录结构

```text
.
├── AGENTS.md                  # 文档路由与维护约定
├── docs/
│   ├── README.md              # 设计资料索引
│   ├── product/               # 产品目标、工作网络与交互讨论
│   ├── mvp/                   # 范围、特性、验证计划与验收场景
│   ├── architecture/          # 本地核心、执行引擎、机器与工作区
│   ├── decisions/             # 决策状态与未决问题
│   ├── research/              # 外部产品及研究参考
│   └── archive/               # 历史讨论，仅供背景参考
└── prototype/
    ├── serve.mjs             # 无第三方依赖的本地预览服务
    ├── taskos-v0/            # 历史原型与 Lucide 资源
    ├── taskos-v1/            # 会话优先的桌面提案与交互测试
    ├── agent-bridge/         # Codex 协议适配器、默认参数与探针
    └── taskos-plugin/        # MCP 服务、平台接入配置与隔离探针
```

## 维护约定

具体设计写回对应主题文档，`AGENTS.md` 只维护阅读路由。调整范围或架构时，同步相关 MVP 文档与决策记录。机器配置、密钥和私人连接信息应保留在本地。

原型图标的第三方许可见 [Lucide 图标许可](prototype/taskos-v0/assets/icons/LICENSE)。