Admin Projects
项目源码、版本与静态元数据管理。
列出项目
先按登录账号权限筛选，再执行搜索与分页。groupId 为空字符串时查询个人项目；省略时查询所有可访问项目。公开项目对登录账号提供隐式访客权限。 / Authorization precedes pagination. Public projects grant signed-in users implicit guest access.
使用指定 UUID 原子创建 server 项目
登录账号可创建个人项目，创建者成为所有者。groupId 指定归属组时需要该组开发者权限，创建者只保留原有继承角色。已有项目的开发者上传不会修改管理信息或归属。 / Signed-in users may create personal projects as owners. Group projects require developer access and do not promote the creator.
访问当前项目或关联项目存储
`context.storage.server.kv` 与 `context.storage.server.persistentValue` 共用此 HTTP 入口，
读取系统 token 用量
读取系统 token 用量
读取全局审计日志
读取全局审计日志
从文件初始化项目
从文件初始化项目
查询最新服务器准备任务
查询最新服务器准备任务
查询服务器准备任务
查询服务器准备任务
上传项目压缩包
上传项目压缩包
读取项目源文件
仅有源码下载授权的账号只能读取已发布版本；读取 draft 还需要项目管理权限，避免暴露未发布的配置字段和默认值。
上传项目卡片图片
上传客户端完成 1:1 裁剪后生成的 WebP。调用方必须具备项目管理权限。
更新项目卡片元数据
保存完整的纯视觉 `projectCard`，仅接受图标、图片 URL、图标颜色和背景颜色。
下载可本地化的已发布源码快照
下载已发布不可变源码快照，独立校验源码下载权限，无平台限制。成功发送 GET 响应后为实际返回的精确版本累加一次下载量；HEAD、失败和中断响应不计数。
创建项目组部署计划
为一个 Kanban 根项目及选中的 Workflow 数据源预留精确版本。项目组只包含源码包，
查询项目组部署进度
查询项目组部署进度
上传项目组源码包
上传 `project-group` v1 tar.gz。Server 校验清单、普通文件成员、展开大小、每个项目类型
发布项目组
先发布 included 关联项目，最后发布并激活 Kanban 根版本。发布中断后可以幂等续跑；
查询精确版本的项目依赖状态
查询精确版本的项目依赖状态
下载精确项目组源码
根项目和有权限的 included 依赖按 dependency lock 中的精确版本返回。无权限依赖会被列入
列出项目的通用关联项目
返回当前声明、目标项目名称、对方 alias、对方授予当前项目的规则和双方确认状态。待确认关系不授予 KV 权限。
创建或更新通用项目关系
当前项目必须可管理。若调用方也能管理目标项目，`targetAlias` 必填，Server 在一个事务中更新双方；
删除通用项目关系
能管理目标项目时事务式删除双方声明；否则只删除当前项目一侧。关系权限随当前声明立即失效。
读取公开项目卡片图片
读取按内容哈希保存的不可变 WebP；用于项目列表和 Desktop 展示。
读取 Kanban 工作区
读取固定 target 的静态产物目录、HTML 入口、清单、当前用户隔离的命名配置和短期预览 capability。
调用 Kanban 项目数据 Bridge
当前项目可读用户可以执行读取操作，写入需要项目数据写权限。服务端先校验 target 对应 Kanban
订阅 Server Web Kanban 关联项目 revision
以 Server-Sent Events 返回当前直接关联项目的完整 revision 快照和后续变化。Server 按
读取 capability 保护的 Kanban 静态资源
使用工作区接口签发的短期 capability 读取固定版本资源。`assetPath` 可以表示
Read an immutable published configuration template
Read an immutable published configuration template
Upload a personal configuration attachment after checking field permissions
Set target to the installed published version to check its field permissions. Omitting target uses the author's draft or the recipient's latest published template.
Read an allowed personal or immutable version attachment
Read an allowed personal or immutable version attachment
Read account-scoped configurations for any project type
Requires project read or source-download access and an account identity. Values are isolated by project and account. Download access only exposes the version template and permitted personal values. Official drafts require an actual maintainer, owner or system administrator. For v2 projects, non-managers use the latest published template for default or draft targets even with source-draft read access. Unpublished role-controlled configurations return a publication-required error. The Server never executes project code.
Manage or export account-scoped project configurations
个人配置可由任何访客使用，写入遵循已发布模板字段限制及 revision 校验；官方配置管理 publication.* 需要维护者或所有者。 / Guests may manage their own configurations subject to published field rules and revision checks. Official publication.* actions require maintainer or owner access. For v2 personal configurations, default or draft targets resolve to the latest published template for non-managers; role-controlled projects must be published first.
保存 server draft 文件
保存 server draft 文件
克隆项目
仅有源码下载授权的账号只能克隆已发布版本；克隆 draft 还需要原项目的管理权限。新副本的所有权不授予原项目的配置发布权限。
同步项目默认名称和展示声明
把本地 `package.json` 根 `name` 与 `steamHarness.projectInfo` 同步到已绑定项目。
更新项目显示信息
更新项目显示信息
删除项目
删除项目
发布项目版本
以 draft 的 package 版本发布不可变源码快照并更新 latest。重复版本返回 409，不安装、构建或加载项目代码。
查看邀请详情
需要登录才能查看邀请；资源可为项目或组，project 字段显示对应资源的 ID 和名称。 / Sign-in required; resourceType identifies project or group.
接受项目邀请
接受时重新校验邀请者当前权限、接收者活跃状态及邀请有效性；不会降低已有直接或继承角色。 / Acceptance rechecks current roles, active account status and invitation validity; higher roles are preserved.
更新项目可见性
更新项目可见性
列出项目 版本
列出项目 版本
汇总项目 KV 与知识库数据
要求登录、项目读取权限及允许访问服务器数据的存储声明。汇总完整项目数据，不返回条目值、文档正文或预览。
列出项目 KV
列出项目 KV
读取单条项目 KV
读取单条项目 KV
删除单条项目 KV
删除一条已存在的 KV 条目，按 `scope` + `key`（conversation scope 还需要 `conversationId`）
列出项目知识库文档
列出项目知识库文档
新建项目知识库文档
新建项目知识库文档
查找项目知识库文档
查找项目知识库文档
读取项目知识库文档的指定行范围
读取项目知识库文档的指定行范围
读取项目知识库文档
读取项目知识库文档
编辑项目知识库文档
编辑项目知识库文档
删除项目知识库文档
删除项目知识库文档
读取项目 token 用量
读取项目 token 用量
读取分享版本的静态元数据
需要登录和独立源码下载权限，包含项目级源码授权。只读取精确已发布版本，不加载项目代码、不计下载量。Web 分享地址为 /share/projects/{projectId}/{version}，不携带凭据或授予权限。
下载不可变源码归档
成功发送 GET 响应后为实际返回的精确版本累加一次下载量；latest 归入解析后的版本。HEAD、失败和中断响应不计数。
列出项目访问申请 / List project access requests
列出项目访问申请 / List project access requests
审批项目访问申请
维护者、所有者或系统管理员可审批；系统管理员密钥使用相同的全局管理权限。 / Maintainers, owners and system administrators may review requests, including system administrators using an admin key.
解析短期源码申请链接
解析短期源码申请链接
申请项目访客权限 / Request project guest access
申请项目访客权限 / Request project guest access