@teammy/server 0.0.10 → 0.1.1

package/README.md

@@ -2,8 +2,10 @@
 
 中心服务器上的 Teammy 服务，需要 Node.js 22.19 或更新版本。
 
+0.1.1 增加镜像部署初始化、带路径前缀的访问地址、项目 SSH 密钥、仓库及子模块冷启动，并更新 instant Agent 和工作台交互。升级时同时更新 API、Worker 与成员客户端。
+
 ```sh
-npm install -g @teammy/server@0.0.10
+npm install -g @teammy/server@0.1.1
 teammy-server --help
 teammy-server --version
 teammy-server --host 127.0.0.1 --port 4317
@@ -11,7 +13,9 @@ teammy-server --host 127.0.0.1 --port 4317
 
 默认监听 `127.0.0.1:4317`；内网部署时可指定 `--host 0.0.0.0` 或服务器的内网地址。收到 SIGINT 或 SIGTERM 时正常关闭。
 
-当前提供健康检查、协议能力发现、带认证的设备绑定和成员查询，以及工作区隔离的内容传输、幂等文件版本提交、历史清单和增量查询。支持规范化会话快照、历史版本读取、列表及中文/技术标识符正文搜索；服务地址同时提供 Web Wizard、ID 登录、文件只读浏览、成员管理与公共设置。提供自动维护的任务进展看板、目录浏览、只读会话检索和模型配置；任务整理需另起 Worker。0.0.10 移除手动分析与整理入口，看板自动刷新结果。
+当前提供健康检查、协议能力发现、带认证的设备绑定和成员查询，以及工作区隔离的内容传输、幂等文件版本提交、历史清单和增量查询。支持规范化会话快照、历史版本读取、列表及中文/技术标识符正文搜索；当前源码的服务地址提供首次管理员创建、ID 登录、网页新建项目、全站用户管理、文件只读浏览、项目成员与公共设置；初始化不再要求创建首个项目。提供自动维护的任务进展看板、目录浏览、对话库检索和模型配置；任务整理需另起 Worker。0.0.10 移除手动分析与整理入口，看板自动刷新结果。
+
+当前源码将原「会话」功能命名为「对话库」，用于查阅成员与 Agent 的工作对话、摘要和交接说明；「提百事」用于工作台问答与协作消息。`sessions` 路由和协议名称保持兼容。
 
 成员设备使用独立的 `@teammy/cli` 包。服务器启动入口已从原有的 `teammy server` 迁移到 `teammy-server`。
 
@@ -19,7 +23,7 @@ teammy-server --host 127.0.0.1 --port 4317
 
 管理员使用 `teammy-server member add --workspace ID --member ID` 签发成员令牌，令牌仅向标准输出显示一次；`member reset` 更换令牌并释放设备绑定，`member revoke` 撤销访问。管理和启动命令使用相同的 `--data-dir DIR`，默认 `~/.teammy/server`。
 
-首次启动后打开监听地址，在网页建立项目、管理员 ID 和预设成员，无需进入服务器签发令牌。页面及 API 使用同一端口。成员以 `teammy connect --url URL --project PROJECT_ID --member ID` 接入，连接后自动开始后台同步，通过 teammy status 查看本机状态。生产 Web 资源随此包交付，无需另外构建前端。
+首次启动后打开监听地址，只创建管理员 ID，随后在网页新建项目、维护全站用户并将用户加入项目，无需进入服务器签发令牌。页面及 API、多项目接入使用同一端口。成员以 `teammy connect --url URL --project PROJECT_ID --member ID` 接入，连接后自动开始后台同步，通过 teammy status 查看本机状态。生产 Web 资源随此包交付，无需另外构建前端。
 
 ## AI Worker
 
@@ -27,18 +31,20 @@ teammy-server --host 127.0.0.1 --port 4317
 teammy-server ai-worker --data-dir /absolute/path/teammy-data
 ```
 
-与 HTTP 服务使用同一数据目录。浏览器“全站设置 → 模型接入”维护私有配置，工作区文件发布后由 Worker 自动维护任务看板。执行并发为 1。0.0.9 的任务整理与目录分析需要 Linux Worker、Bubblewrap 和 ripgrep：整个 Pi 在独立沙箱内运行，原生文件工具和 Bash 只能看到本轮只读资料及临时目录，模型请求由父 Worker 代发。Docker 镜像包含系统工具，容器使用 compose.yaml 中的 Worker 隔离配置；非 Linux 宿主请在 Linux 容器或开发机运行 Worker。API、Web 与客户端仍可在 macOS 上运行。
+与 HTTP 服务使用同一数据目录。浏览器“全站设置 → 模型接入”维护私有配置，工作区文件发布后由 Worker 自动维护任务看板，会话上传后自动生成标题／摘要。独立作业可以并发，不设置 Hub 或进程级 AI 数量上限；原子领取与租约防止同一作业重复执行。0.0.9 的任务整理与目录分析需要 Linux Worker、Bubblewrap 和 ripgrep：整个 Pi 在独立沙箱内运行，原生文件工具和 Bash 只能看到本轮只读资料及临时目录，模型请求由父 Worker 代发。Docker 镜像包含系统工具，容器使用 compose.yaml 中的 Worker 隔离配置；非 Linux 宿主请在 Linux 容器或开发机运行 Worker。API、Web、会话 SDK 整理与客户端仍可在 macOS 上运行。
 
 当前源码支持工作区任务冷启动与自动增量维护：配置全站或项目默认模型后，成员首次非空发布及后续增删改稳定约 60 秒自动整理。仅重跑发生变化的成员，通过 query_tasks 查询已有任务，结合文件变化提交 upsert/archive，未提及卡片保持原样。目录清空时不调用模型，也不自动删除旧卡片。看板显示计划、进行中、待验收和已完成；needsConfirmation 标记需要确认的完整任务，支持查看来源、修订表达及确认，不改原文。看板自动刷新任务列表，不提供手动分析、整理或刷新按钮。设计见 [文件任务整理](../../docs/task-board-analysis.md)。
 
-提示词、工具说明与工作流预算随包保存在 `dist/runtime/`。可将完整目录复制到服务器专用位置，通过 `TEAMMY_AI_RUNTIME_DIR=/absolute/path/runtime` 指定；容器可只读挂载。API 和 Worker 使用同一目录配置。新建作业加载并固定资源，已有作业及重试不受编辑影响。模型密钥仍由网页接入点设置维护，不写入运行资源。详见资源目录 README。
+文件任务与对话整理的提示词、工具说明及工作流配置随包保存在 `dist/runtime/`。可将完整目录复制到服务器专用位置，通过 `TEAMMY_AI_RUNTIME_DIR=/absolute/path/runtime` 指定；容器可只读挂载。API 和 Worker 使用同一目录配置。任务作业创建时、对话整理首次执行时固定资源；重试沿用已冻结内容。项目 Agent 的角色提示和事件输入仍在源码中维护，不由该变量覆盖。模型密钥仍由网页接入点设置维护，不写入运行资源。详见资源目录 README。
 
 本版任务提示词为 v10：关注后续验收与遗留事项，简洁表达进展，并区分明确工作与讨论中的可能性。任务失败可自动重试三次；资料变化会取消过期任务，待新版本稳定后重新整理。提示词更新不自动重跑未发生变化的历史项目，下次有效文件更新时使用新提示词。
 
 安装包随附全部服务端运行依赖，包含 Pi 1.4.0 及修复后的 undici 8.12.2，普通 npm 安装即可使用，无需配置 overrides。服务端包包含 Web 静态资源；客户端不安装 Pi 或 Web 依赖。Bubblewrap、ripgrep 等系统工具由 Linux Worker 环境提供。
 
-备份必须包含 SQLite、blobs 和 `ai-secret.key`。API 与 Worker 停止后备份整个目录。
+API 与 Worker 停止后备份整个数据目录，包含 SQLite/WAL、blobs、`ai-secret.key`、`project-agent-secret.key`、项目 Agent 持久 Pi 会话及日志。
 
 0.0.8 增加公共资料独立同步与网页浏览：根 README 和模板可见，Teammy 配置隐藏；项目设置可选择维护成员和公共路径。任务分析将公共资料冻结为参考快照，更新后自动重新整理成员任务。
 
-本版支持多项目。全站用户、共享模型接入点与同步策略由站点管理员维护；项目成员平等管理本项目设置，并可选择项目默认模型接入点。0.0.5 及更早的单项目数据库不自动迁移，请使用新的 `--data-dir`，保留旧目录；HTTP 服务与 Worker 必须指向同一目录。本版将已有多项目数据升级到 schema 17，保留原资料及任务；升级时同步停止并更新 API 与 Worker，旧版本不读取新版数据库。仍采用预设 ID 登录，不防止身份冒用。
+本版支持多项目。全站用户、共享模型接入点与同步策略由站点管理员维护；项目成员平等管理本项目设置，并可选择项目默认模型接入点。0.0.5 及更早的单项目数据库不自动迁移，请使用新的 `--data-dir`，保留旧目录；HTTP 服务与 Worker 必须指向同一目录。已有多项目数据库按版本增量迁移并保留资料；升级时同步停止并更新 API 与 Worker，旧版本不读取新版数据库。仍采用预设 ID 登录，不防止身份冒用。
+
+当前完整目录发布协议要求客户端支持 `atomic-file-publications`，旧逐批提交接口返回 426。客户端需配套更新并运行 `teammy repair`，接管旧后台及更新 Hook；旧资料保持可读，历史目录经新客户端完整发布确认后才进入任务整理。升级说明见 [部署文档](../../docs/deployment.md#从旧版本升级)。