# TeamDesk

## 版本规则

用户于 2026-09-17 明确约定，后续 TeamDesk 迭代持续遵循：

- 每次本地迭代按 SemVer 将 patch 加 1，例如 0.0.1 → 0.0.2。同一迭代内的编辑、测试和整改共用该版本，不按文件或测试次数反复升版。
- 每次经授权合并进远程 main，将 minor 加 1，并将 patch 归零，例如 0.0.2 → 0.1.0、0.1.4 → 0.2.0；合并前在待合并变更中完成版本同步与验证。
- major 升版仅由用户决定，代理不得自行提升。
- `.codex-plugin/plugin.json` 是插件版本唯一权威；应用 package.json、连接握手、界面版本和当前使用文档同步，历史版本验证记录保留原值。
- 本地交付要核对源码、实际安装版本与运行版本。此版本约定不代表授权 commit、push、合并或发布，也不改变其他插件的版本规则。

## 实现边界

- 发布、推送和合并需要用户授权。2026-09-24 用户已明确授权将一次安装流程和完整 MVP 发布到远程 main，供种子用户测试；首次发布为 0.1.0；公开下载验证发现路径问题后，修正版按第二次 main 合并升为 0.2.0。后续发布仍按当次授权执行。
- 员工在现有 Codex 原生任务中执行。不得另建独立员工运行环境。正式 GUI 已通过共享 App Server 按需接入；用户已明确授权该路线，允许本地接入器作为现有桌面同一个 App Server 的客户端，使用公开任务/队列协议。必须用实际桌面连接和进程证据确认同实例；只读到相同历史不算通过。codex-app-tools 仍由原生任务调用，不借用或伪造任务执行身份。
- 原生接入任务只执行用户 GUI 技术意图，不能成为业务统筹者或改变 FIFO/steer 语义。
- GUI 输入必须按需触发原生投递；禁止用定时唤醒模型检查收件箱作为正常接入机制。2026-09-17 用户否定该方案，既有 TeamDesk heartbeat 已暂停，不得自动恢复。即时接入未取得真实证据前，不得把自动投递标为完成。
- 只修改 teamdesk 及必要的仓库发现/文档；保留已有领域插件。
- metadata 不含原生对话/推理/工具正文；业务输入和决定是应用自身数据，分别保存。
- 32 位在职员工；任意部门/岗位/skill/业务阶段。owner 更新任务状态，其他报告与人类验收分开。
- hook 信任必须来自用户对具体定义的明确审查确认。2026-09-17 本机桌面实现已确认原生 Trust 使用 App Server 的 config/batchWrite 更新 hooks.state；可以研究并验证将同一确认放入 TeamDesk GUI，不再将“必须返回原生设置页”作为架构要求。此证据不授权代理自动信任 hook。TeamDesk 点击到原生信任读回及实际触发已在 0.0.1 联调验证，版本升级仍需核对当前定义和真实回执。配置/安装/信任/实际触发不可混为成功。
- 数据存放用户目录或测试临时目录，不写插件缓存和公开 assets。不得把本机路径、线程标识或私有运行证据提交到仓库。