From ecb6b71c34b56c139781386b68d0168e44c6c4f2 Mon Sep 17 00:00:00 2001
From: IGNGserver <176017966+IGNGserver@users.noreply.github.com>
Date: Thu, 12 Nov 2026 22:12:54 +0800
Subject: [PATCH] =?UTF-8?q?fix(website):=20=E6=A0=A1=E6=AD=A3=E5=B7=B2?=
=?UTF-8?q?=E8=BF=87=E6=9C=9F=E7=9A=84=E4=BA=A7=E5=93=81=E4=BA=8B=E5=AE=9E?=
=?UTF-8?q?=E4=B8=8E=E9=83=A8=E7=BD=B2=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
站点文案停在 10 月:文件夹改成显式三态、归档机制移除后,目录状态、归档和顺延的描述仍沿用旧模型;默认端口绑定也写成了可远程访问。
- 目录树与演示改为文件夹自身三态 + 后代进度统计
- 05.4 归档恢复换成整树删除的预览与确认
- 顺延只跳过已完成任务,右滑改为切换完成状态
- 部署说明补充 TASKDOCK_BIND_ADDRESS,默认地址改为 127.0.0.1
- 官网源码链接指向产品仓库 website/
- 同步修正 README、API/架构/同步/备份文档与 SITE 事实表
Assisted-by: DeepSeek Harness/deepseek-v4.1-flash
---
README.md | 4 +--
docs/API.md | 18 +++++-----
docs/ARCHITECTURE.md | 6 ++--
docs/BACKUP_RESTORE.md | 2 +-
docs/STATUS.md | 2 ++
docs/SYNC_PROTOCOL.md | 6 ++--
docs/V2_TREE_WORKFLOW_DEVELOPMENT.md | 2 ++
docs/openapi.json | 2 +-
website/docs/SITE.md | 23 ++++++-------
website/site/assets/css/site.css | 47 +++++++++++++-------------
website/site/assets/js/dimensions.js | 49 ++++------------------------
website/site/download.html | 41 +++++++++++++++++------
website/site/index.html | 27 ++++++++-------
13 files changed, 108 insertions(+), 121 deletions(-)
diff --git a/README.md b/README.md
index 543c251..0f620bb 100644
--- a/README.md
+++ b/README.md
@@ -66,12 +66,12 @@ export APP_VERSION=2.0.0-rc.66
docker compose pull
docker compose --profile operations run --rm migrate
docker compose up -d
-curl -fsS http://服务器地址:48731/health/ready
+curl -fsS http://127.0.0.1:48731/health/ready
# 4. 首次部署时初始化 Owner 账号
docker compose --profile operations run --rm bootstrap
```
-默认访问地址是 `http://服务器地址:48731`。初始化成功后建议从 `.env` 里删掉 `OWNER_PASSWORD`,并删除或轮换 `BOOTSTRAP_TOKEN`。需要 HTTPS 和反向代理时可加 `--profile gateway`,由 Caddy 签发证书并发布入口。
+默认只有服务器本机能访问 `http://127.0.0.1:48731`。要让其他设备打开,二选一:把 `.env` 里的 `TASKDOCK_BIND_ADDRESS` 改成 `0.0.0.0`(明文 HTTP,仅限可信网络),或在 `APP_ORIGIN` 填好域名后执行 `docker compose --profile gateway up -d`,由 Caddy 提供 HTTPS 入口。初始化成功后建议从 `.env` 里删掉 `OWNER_PASSWORD`,并删除或轮换 `BOOTSTRAP_TOKEN`。
**网页端**:中枢起来后,浏览器打开你配置的 `APP_ORIGIN` 即可,无需安装。
diff --git a/docs/API.md b/docs/API.md
index 3be6218..2aef188 100644
--- a/docs/API.md
+++ b/docs/API.md
@@ -4,29 +4,29 @@
## v2 资源
-v2 不再把 Project/Inbox/category/priority 作为产品模型。`GET /api/v2/tree/children` 返回 Folder 与 Task 的混合直接子项;Folder 的 `aggregate` 由后代 Task 派生,状态顺序为 `IN_PROGRESS → TODO → DONE`。`POST /api/v2/tree/items/move` 使用 `baseVersion`、状态快照和前后锚点保护循环、已归档目标以及并发排序冲突。
+v2 不再把 Project/Inbox/category/priority 作为产品模型。`GET /api/v2/tree/children` 返回 Folder 与 Task 的混合直接子项;Folder 的 `status` 是文件夹自身持有的显式三态(默认 `TODO`),`aggregate` 里的 `todoCount/inProgressCount/doneCount/totalCount` 由后代 Task 派生,排序状态顺序为 `IN_PROGRESS → TODO → DONE`。`POST /api/v2/tree/items/move` 使用 `baseVersion`、状态快照和前后锚点保护循环、目标父级以及并发排序冲突。
目录分页:`GET /api/v2/tree/children?parentFolderId=root&limit=100`,`limit` 为 1–200;下一页携带响应的 `nextCursor`,末页为 `null`。游标绑定账户、父目录及账户版本;中途发生写入返回 HTTP 410 `SYNC_CURSOR_EXPIRED`,调用方应保留已展示内容并提供从第一页重新加载,不自动无限重试。排序键为状态组、整数 rank、类型(文件夹优先)、ID。未指定 `limit` 的旧客户端继续得到全部直接子项。
`GET /api/v2/tasks/{id}?view=summary` 只返回 `{ task }`,用于状态切换后保持当前行的位置,不读取备注或关系;省略 `view` 继续返回原有详情。
-PostgreSQL 的目录、文件夹选择器及面包屑读取不调用全账户 `prepare()`,不读取备注、步骤或工作流关系;文件夹状态汇总仍需扫描该目录下的活动后代,不能将一级分页当成后代扫描恒定开销。面包屑与内容独立加载。分页不推进全局同步游标;客户端只缓存精确页面成员,未完整 bootstrap 时不能据此构造未读取页或宣称全目录完整。完整本地投影使用独立的 `local.` 游标,绝不发送给服务器。
+PostgreSQL 的目录、文件夹选择器及面包屑读取不调用全账户 `prepare()`,不读取备注、步骤或工作流关系;文件夹进度计数仍需扫描该目录下的活动后代,不能将一级分页当成后代扫描恒定开销。面包屑与内容独立加载。分页不推进全局同步游标;客户端只缓存精确页面成员,未完整 bootstrap 时不能据此构造未读取页或宣称全目录完整。完整本地投影使用独立的 `local.` 游标,绝不发送给服务器。
-目录归档使用 `POST /api/v2/folders/:id/archive-tree`,响应 `ArchiveOperation`;恢复使用原 operationId,保证逐项精确恢复。归档中心通过 `GET /api/v2/archive-operations` 按顶层归档操作分组返回(含 `rootFolderTitle`、后代 Folder/Task 计数、原本已归档而恢复时需保留的计数,以及可展开的嵌套 Folder 列表);`?includeRestored=true` 才包含已恢复操作,`GET /api/v2/archive-operations/:id` 额外返回该操作的归档 Task 明细与独立归档 Task。整树删除必须先 `POST /api/v2/folders/:id/delete-preview`,再把短时 `confirmationToken` 发送到 `DELETE /api/v2/folders/:id/tree`;预览 fingerprint 变化或令牌过期时拒绝,不物理删除关联 Note、TaskStep、Placement、Workflow Membership 或父级引用。整树删除必须在线执行;离线客户端 fail-closed 并返回 `OFFLINE_TREE_DELETE_FORBIDDEN` 与归档建议,不允许排队执行不可恢复的删除。
+整树删除必须先 `POST /api/v2/folders/:id/delete-preview`,再把短时 `confirmationToken` 发送到 `DELETE /api/v2/folders/:id/tree`。预览返回将删除的文件夹、任务、备注、步骤、日程和流程关联计数,以及 `subtreeFingerprint`;fingerprint 变化或令牌过期时拒绝,不物理删除关联 Note、TaskStep、Placement、Workflow Membership 或父级引用。整树删除必须在线执行;离线客户端 fail-closed 并返回 `OFFLINE_TREE_DELETE_FORBIDDEN`,不允许排队执行不可恢复的删除。
-批量顺延使用 `POST /api/v2/dates/:localDate/rollover`,只把该日期仍处于活动状态的 Placement 复制到次日,跳过已完成或已归档任务;响应 `{ createdIds, skippedTaskIds, targetDate }`。撤销使用 `POST /api/v2/rollovers/undo`,body 传 `{ placementIds }`。该操作无服务端状态,可跨进程与重启使用;离线时不排队,直接 fail-closed。
+批量顺延使用 `POST /api/v2/dates/:localDate/rollover`,只把该日期仍处于活动状态的 Placement 复制到次日,跳过已完成或已删除的任务;响应 `{ createdIds, skippedTaskIds, targetDate }`。撤销使用 `POST /api/v2/rollovers/undo`,body 传 `{ placementIds }`。该操作无服务端状态,可跨进程与重启使用;离线时不排队,直接 fail-closed。
-`GET /api/v2/tasks?archived=false&q=...` 支持按任务标题、引用 ID 或备注内容搜索。Task 详情通过 `GET /api/v2/tasks/:id` 聚合 Note、独立 TaskStep、Placement、Workflow Membership 和 Folder path;每个 Placement 同时返回可直接展示的 `timePoint` 日期/事件信息。日期与 Event/Placement 使用 `/time-points`、`/placements` v2 路由;Workflow、Stage、Membership 使用 `/workflows`、`/workflow-stages` 和 `/workflow-memberships`。同一 Task 可以加入多个 Workflow,但同一 Workflow 只能有一个活动 Membership。
+`GET /api/v2/tasks?q=...` 支持按任务标题、引用 ID 或备注内容搜索。Task 详情通过 `GET /api/v2/tasks/:id` 聚合 Note、独立 TaskStep、Placement、Workflow Membership 和 Folder path;每个 Placement 同时返回可直接展示的 `timePoint` 日期/事件信息。日期与 Event/Placement 使用 `/time-points`、`/placements` v2 路由;Workflow、Stage、Membership 使用 `/workflows`、`/workflow-stages` 和 `/workflow-memberships`。同一 Task 可以加入多个 Workflow,但同一 Workflow 只能有一个活动 Membership。
v2 设置通过 `/api/v2/settings` 保存 `ROOT/RECENT_FOLDER` 目标;`GET /api/v2/status` 返回 `schemaVersion: 2`、支持的 API/sync 版本和 `minClientVersion`。v2 写入继续要求 `Idempotency-Key`、`X-Client-Id` 和适用的 `baseVersion`。
## 认证
-首次部署由部署中枢执行 `docker compose --profile operations run --rm bootstrap`,服务端内部仍使用 `POST /bootstrap` 和 `BOOTSTRAP_TOKEN`,成功后永久关闭;Web、桌面和手机客户端不提供初始化令牌输入。`POST /auth/login` 返回短时 access token;Web refresh token 是 `HttpOnly`、`SameSite=Lax` Cookie:使用 HTTPS 时还会带有 `Secure` 属性,使用 HTTP 时为了让 HTTP 外网地址可用而不带 `Secure`,但密码和会话信息会明文传输,页面会显示安全警告。原生容器应通过平台安全存储持有 refresh token。每次 refresh 都轮换 token,并把 365 天滑动不活动窗口重新计时;旧链重放会撤销该设备会话链。Web Cookie 同样按该窗口重设,但浏览器对持久 Cookie 有约 400 天上限。`DELETE /devices/{id}` 可撤销指定设备的全部会话,`GET /devices` 会标记 `current` 表示当前设备。
+首次部署由部署中枢执行 `docker compose --profile operations run --rm bootstrap`,服务端内部仍使用 `POST /bootstrap` 和 `BOOTSTRAP_TOKEN`,成功后永久关闭;Web 和 Android 客户端不提供初始化令牌输入。`POST /auth/login` 返回短时 access token;Web refresh token 是 `HttpOnly`、`SameSite=Lax` Cookie:使用 HTTPS 时还会带有 `Secure` 属性,使用 HTTP 时为了让 HTTP 外网地址可用而不带 `Secure`,但密码和会话信息会明文传输,页面会显示安全警告。原生容器应通过平台安全存储持有 refresh token。每次 refresh 都轮换 token,并把 365 天滑动不活动窗口重新计时;旧链重放会撤销该设备会话链。Web Cookie 同样按该窗口重设,但浏览器对持久 Cookie 有约 400 天上限。`DELETE /devices/{id}` 可撤销指定设备的全部会话,`GET /devices` 会标记 `current` 表示当前设备。
## 写入约定
-所有写请求需要合法 UUID `Idempotency-Key` 和 `X-Client-Id`。更新/归档/恢复需要 body 中的 `baseVersion`。服务端重复接收相同 mutation 返回第一次结果,不重复创建 Task 或 Placement。冲突 HTTP 409,错误体固定为:
+所有写请求需要合法 UUID `Idempotency-Key` 和 `X-Client-Id`。更新/删除需要 body 中的 `baseVersion`。服务端重复接收相同 mutation 返回第一次结果,不重复创建 Task 或 Placement。冲突 HTTP 409,错误体固定为:
```json
{
@@ -45,8 +45,8 @@ v2 设置通过 `/api/v2/settings` 保存 `ROOT/RECENT_FOLDER` 目标;`GET /ap
- `/placements/:id/move` 在一个 mutation 中建立目标并软删除来源。
- `/tasks/:id/duplicate` 才创建新的 Task、Note 和引用 ID。
- `POST /time-points/date` 对同一 Owner/localDate 幂等返回同一 Date TimePoint。
-- Task status 全局生效,Event 的 `reachedAt/archivedAt` 独立。
-- 普通列表默认排除归档和 tombstone;`/search/tasks?includeArchived=true` 可搜索归档任务。
+- Task status 全局生效,Event 的 `reachedAt` 独立。
+- 普通列表默认排除 tombstone;任务搜索使用 `GET /api/v2/tasks?q=`,覆盖标题、引用 ID 和备注内容。
## 列表与分页
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 6624ad2..776ca69 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -13,7 +13,7 @@ Web/PWA 直接加载 React Web 产物,并通过浏览器的 Fetch、Cookie、I
- `packages/sync-client`:IndexedDB/Dexie v2 schema、v1 outbox 转换、push/pull、冲突记录、tombstone 和重同步。
- `apps/web`:React/PWA 目录树、混合排序、工作流、步骤、日期/Placement 和删除预览界面。
- `apps/mobile`:Capacitor 工程与 `apps/mobile/android` 原生 Compose/Room 客户端;原生客户端不依赖 React 页面来满足 v2 功能。
-- `apps/api/src/tree-store.ts`:Owner-scoped v2 目录树、归档操作、Workflow、TaskStep、时间点/Placement 以及内存迁移投影。
+- `apps/api/src/tree-store.ts`:Owner-scoped v2 目录树、Workflow、TaskStep、时间点/Placement 以及内存迁移投影。
- `apps/api/src/postgres-tree-store.ts`:PostgreSQL v2 projection 的单查询加载、增量 change-feed 追赶、批量持久化和 v2 change feed 适配。
- `apps/api/src/cache.ts`:可选 Redis 共享限流/冷启动缓存;缓存投影故障回退数据库,认证限流是否允许进程内回退由 `AUTH_RATE_LIMIT_REQUIRE_SHARED` 决定。
- 主题:Web 使用 `prefers-color-scheme`,Android 使用 `Configuration.uiMode` 同步系统栏并向 WebView 派发主题事件;主题是设备运行时状态,不进入账号同步设置。
@@ -28,8 +28,8 @@ Web/PWA 直接加载 React Web 产物,并通过浏览器的 Fetch、Cookie、I
4. v2 Task 只有一个 `parentFolderId`;旧 `projectId/category/priority` 仅在兼容存储/迁移边界保留,不进入 v2 DTO/UI。
5. 每次版本更新都检查 `baseVersion`;失败返回 `VERSION_CONFLICT` 和服务器快照。
6. mutation receipt、领域写入、版本递增和 change feed 在同一 Store mutation 中提交。
-7. Folder 归档为一次有 operationId 的逐实体写入;恢复只恢复该 operationId 写入的边界,不误恢复此前已归档的后代。删除预览的 fingerprint/token 过期或变化时 fail-closed,并为 Folder、Task、Note、Step、Placement、Membership 产生 tombstone。
-8. Folder aggregate/status 是由未归档、未删除后代 Task 迭代派生的只读结果,不进入持久化状态或 change feed。
+7. 整树删除先由 `POST /api/v2/folders/:id/delete-preview` 生成短时 token 和 subtree fingerprint,再通过 `DELETE /api/v2/folders/:id/tree` 执行;fingerprint 变化或 token 过期时 fail-closed,并为 Folder、Task、Note、Step、Placement、Membership 产生 tombstone。
+8. Folder 的 `status` 是文件夹自身持久化的显式三态;`aggregate` 的计数由未删除后代 Task 迭代派生,不进入持久化状态或 change feed。
9. 同一 Task 可进入多个 Workflow;同一 Workflow 内活动 Membership 唯一。TaskStep 的状态和 completedAt 独立于 Task.status。
## ADR
diff --git a/docs/BACKUP_RESTORE.md b/docs/BACKUP_RESTORE.md
index c435a09..19f3936 100644
--- a/docs/BACKUP_RESTORE.md
+++ b/docs/BACKUP_RESTORE.md
@@ -4,7 +4,7 @@
## 备份与校验
-TaskDock v2 数据升级前必须先完成 PostgreSQL custom dump;本轮新增 migration `0005_v2_structure.sql`、`0006_v2_backfill.sql`、`0007_v2_constraints.sql`。升级顺序是先备份,再让新代码读取旧/新结构,执行 backfill 和约束校验;禁止用 `TRUNCATE`、重建业务表或 destructive migration 替代。必须核对 Project→Folder、Task `reference_id`、Note、Placement、归档边界和用户设置计数后再继续。
+TaskDock v2 数据升级前必须先完成 PostgreSQL custom dump;本轮新增 migration `0005_v2_structure.sql`、`0006_v2_backfill.sql`、`0007_v2_constraints.sql`。升级顺序是先备份,再让新代码读取旧/新结构,执行 backfill 和约束校验;禁止用 `TRUNCATE`、重建业务表或 destructive migration 替代。必须核对 Project→Folder、Task `reference_id`、Note、Placement、删除边界(tombstone)和用户设置计数后再继续。
```bash
BACKUP_DIR="$PWD/backups"
diff --git a/docs/STATUS.md b/docs/STATUS.md
index 35262c2..02df150 100644
--- a/docs/STATUS.md
+++ b/docs/STATUS.md
@@ -2,6 +2,8 @@
更新时间:2026-10-13
+> 后续变更(2026-11-12):归档机制已在 `2.0.0-rc.26` 移除,本文中归档中心相关条目已失效;文件夹状态在 `2.0.0-rc.62` 改为文件夹自身持有的显式三态。冲突时以 `docs/ARCHITECTURE.md` 和代码为准。
+
总体发布状态:**FAIL(v2 完成定义未满足,但阻断项已全部关闭)**。本轮已关闭全部已知 P0/P1 源码缺陷,并补齐归档中心、v2 rollover、V2 restore 策略、离线删除 fail-closed、Folder-first 迁移分层、Android 同步恢复等此前遗留项。所有本地门禁、真实 PostgreSQL migration/integration/runtime 门禁与三浏览器 E2E 均为 PASS。
仍未运行、因而继续阻断正式发布的门禁只有环境类项:WebKit、Android 真机/仪器、Docker Compose 与长期双端离线矩阵。这些是环境缺失,不是已知实现缺陷。
diff --git a/docs/SYNC_PROTOCOL.md b/docs/SYNC_PROTOCOL.md
index 3306dfa..26bac27 100644
--- a/docs/SYNC_PROTOCOL.md
+++ b/docs/SYNC_PROTOCOL.md
@@ -1,6 +1,6 @@
# 同步协议
-协议版本:`2`。v1 仍只作为兼容读取/转换边界存在;客户端按 `hub origin + owner id` 建立 Dexie 数据库,v2 stores 为 folders、tasks、notes、taskSteps、timePoints、placements、workflows、workflowStages、workflowTaskMemberships、archiveOperations、settings、outbox、conflicts、deferredChanges、syncMeta。Android Room 对应版本 4 schema 与显式 `MIGRATION_3_4`。
+协议版本:`2`。v1 仍只作为兼容读取/转换边界存在;客户端按 `hub origin + owner id` 建立 Dexie 数据库,v2 stores 为 folders、tasks、notes、taskSteps、timePoints、placements、workflows、workflowStages、workflowTaskMemberships、settings、outbox、conflicts、deferredChanges、syncMeta。Android Room 对应版本 4 schema 与显式 `MIGRATION_3_4`。
v2 使用独立 cursor key/协议状态,不能复用 v1 cursor。服务端 `/api/v2/sync/push` 只接受 `protocolVersion: 2`,v1 push 不会创建 v2 receipt;`/api/v2/status` 明确公布 `schemaVersion`、`supportedApiVersions`、`supportedSyncProtocols` 和 `minClientVersion`。
@@ -20,10 +20,10 @@ cursor 是不透明十进制字符串。Pull 返回完整实体快照或 tombsto
## v2 快照与实体范围
-`GET /api/v2/sync/snapshot` 返回 Folder、Task、Note、TaskStep、TimePoint、Placement、Workflow、Stage、Membership、ArchiveOperation、Settings 的一次一致性快照和对应游标。客户端在一个 IndexedDB/Room 事务中替换 v2 实体,先保留 outbox/conflict/deferred change,再重放 pending after-image;删除 change 保留 tombstone,不物理清除以免破坏恢复和冲突审计。v1 snapshot 不得冒充 v2 snapshot。
+`GET /api/v2/sync/snapshot` 返回 Folder、Task、Note、TaskStep、TimePoint、Placement、Workflow、Stage、Membership、Settings 的一次一致性快照和对应游标。客户端在一个 IndexedDB/Room 事务中替换 v2 实体,先保留 outbox/conflict/deferred change,再重放 pending after-image;删除 change 保留 tombstone,不物理清除以免破坏恢复和冲突审计。v1 snapshot 不得冒充 v2 snapshot。
## 冲突
-版本不匹配时保留本地意图和服务端快照,不静默覆盖。Note UI 应提供采用本地、采用服务器、合并后保存;Task/Project/TimePoint 展示冲突字段。活动 Placement 重复视为幂等成功;被归档/删除实体上的更新需由用户选择恢复应用或丢弃。
+版本不匹配时保留本地意图和服务端快照,不静默覆盖。Note UI 应提供采用本地、采用服务器、合并后保存;Task/Project/TimePoint 展示冲突字段。活动 Placement 重复视为幂等成功;已删除实体上的更新需由用户选择恢复应用或丢弃。
WebSocket `/api/v2/ws` 必须先收到 access-token auth 消息;认证成功只发送 `{ "type": "ready", "protocolVersion": 2 }` 和 `{ "type": "sync.required", "cursor": "..." }`,不传业务正文。断线时由轮询、focus、online 和 Android 回前台兜底。
diff --git a/docs/V2_TREE_WORKFLOW_DEVELOPMENT.md b/docs/V2_TREE_WORKFLOW_DEVELOPMENT.md
index 0d75095..fe6f97b 100644
--- a/docs/V2_TREE_WORKFLOW_DEVELOPMENT.md
+++ b/docs/V2_TREE_WORKFLOW_DEVELOPMENT.md
@@ -7,6 +7,8 @@
> 编写基线:master 分支 af98f22;实施者开始前必须重新检查 HEAD、工作区状态和已有变更
> 文档用途:交给后续开发代理作为 v2 的单一产品与工程实施依据
> 发布边界:完成实现和本地验证后先交由用户审查;未经用户明确要求,不部署、不打标签、不创建 Release
+>
+> 变更提示(2026-11-12):归档机制从 `2.0.0-rc.26` 起移除,整树删除改为预览计数 + 短时确认 token;文件夹状态从 `2.0.0-rc.62` 起改为文件夹自身持有的显式三态(默认 `TODO`),不再由后代任务推导。本文其余部分仍作为当时的实施基线保留,冲突时以 `docs/ARCHITECTURE.md` 和代码为准。
## 1. 文档优先级与规范用语
diff --git a/docs/openapi.json b/docs/openapi.json
index 8c8cc12..67db86e 100644
--- a/docs/openapi.json
+++ b/docs/openapi.json
@@ -1007,7 +1007,7 @@
"get": {
"responses": {
"200": {
- "description": "TaskDock v2 GET /v2/tasks; optional archived and q filters (q searches title, reference ID and note content)"
+ "description": "TaskDock v2 GET /v2/tasks; optional q filter (q searches title, reference ID and note content)"
}
}
},
diff --git a/website/docs/SITE.md b/website/docs/SITE.md
index e533613..064f782 100644
--- a/website/docs/SITE.md
+++ b/website/docs/SITE.md
@@ -17,13 +17,13 @@ TaskDock 的产品官网:介绍产品、提供下载与部署入口和文档
桌面客户端已停止维护(产品 `CHANGELOG.md`,2.0.0-rc.37 起),站点不再介绍。
中枢以 Docker 镜像发布在 GitHub Container Registry(GHCR)。
-## 当前状态(2026-10-25)
+## 当前状态(2026-11-12)
- 首页、下载与部署页、404 页已实现;
- 已部署到 Cloudflare Pages 项目 `taskdock-website`,正式地址为 (默认别名
);
- `.github/workflows/website.yml` 在 `master` 和正式发版后自动构建并部署;线上版本来自最新发布
- (当前 2.0.0-rc.59);
+ (当前 2.0.0-rc.66);
- 旧的独立仓库 `IGNGserver/taskdock-website` 已归档,代码与历史以产品仓库为准。
## 已定案的决策
@@ -86,15 +86,16 @@ website/
站点上的产品事实与出处(改文案前先核对产品仓库当前版本):
-| 站点内容 | 产品仓库出处 |
-| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
-| 目录树、日期与时间点、流程、执行步骤四个维度;文件夹状态推导;一个任务多处安排 | `docs/V2_TREE_WORKFLOW_DEVELOPMENT.md`、`docs/ARCHITECTURE.md`(不变量) |
-| 顺延只复制未完成的安排、可撤销、离线拒绝;事件到达不改任务 | `docs/API.md`、`docs/ARCHITECTURE.md` |
-| 先读本地、待同步队列、按顺序推送、冲突保留双方、WebSocket 只发信号 | `docs/SYNC_PROTOCOL.md` |
-| Docker 部署步骤、`.env` 变量、端口 48731、Owner 初始化、升级与回滚 | `README.md`、`docs/DEPLOYMENT.md`、`compose.yaml` |
-| PWA 安装与离线打开需要 HTTPS | `docs/DEPLOYMENT.md` |
-| 命令面板(⌘K / Ctrl K)、移动端右滑完成与左滑菜单、三态状态圆圈 | `apps/web/src/App.tsx`、`CHANGELOG.md`(rc.24、rc.28) |
-| 版本规则(预发布默认、`latest` 只指向正式版) | `README.md`、`docs/RELEASING.md` |
+| 站点内容 | 产品仓库出处 |
+| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| 目录树、日期与时间点、流程、执行步骤四个维度;文件夹独立三态与后代进度统计;一个任务多处安排 | `packages/database/migrations/0013_folder_status.sql`、`packages/domain/src/index.ts`、`docs/ARCHITECTURE.md` |
+| 顺延只复制未完成的安排、可撤销、离线拒绝;事件到达不改任务 | `docs/API.md`、`docs/ARCHITECTURE.md` |
+| 整树删除先预览计数与确认 token,离线拒绝 | `apps/api/src/tree-store.ts`(`previewDelete`/`deleteTree`)、`apps/web/src/TreePage.tsx` |
+| 先读本地、待同步队列、按顺序推送、冲突保留双方、WebSocket 只发信号 | `docs/SYNC_PROTOCOL.md` |
+| Docker 部署步骤、`.env` 变量、端口 48731、默认只绑 127.0.0.1、Owner 初始化、升级与回滚 | `README.md`、`docs/DEPLOYMENT.md`、`compose.yaml` |
+| PWA 安装与离线打开需要 HTTPS | `docs/DEPLOYMENT.md` |
+| 命令面板(⌘K / Ctrl K)、移动端右滑切换完成状态与左滑菜单、三态状态圆圈 | `apps/web/src/App.tsx`、`CHANGELOG.md`(rc.24、rc.28) |
+| 版本规则(预发布默认、`latest` 只指向正式版) | `README.md`、`docs/RELEASING.md` |
## 维护
diff --git a/website/site/assets/css/site.css b/website/site/assets/css/site.css
index 0988825..e91f618 100644
--- a/website/site/assets/css/site.css
+++ b/website/site/assets/css/site.css
@@ -2604,48 +2604,45 @@ button.status[data-s='done'] {
}
}
-/* 细节演示:归档恢复 */
-.demo-archive {
+/* 细节演示:删除预览 */
+.demo-delete {
display: flex;
align-items: center;
- gap: 8px;
+ gap: 10px;
height: 100%;
padding: 0 14px;
font-size: 11.5px;
color: var(--text-2);
}
-.demo-archive .box {
+.demo-delete .files {
display: flex;
gap: 4px;
}
-.demo-archive .box i {
- width: 14px;
- height: 20px;
+.demo-delete .files i {
+ width: 13px;
+ height: 19px;
border-radius: 4px;
background: var(--ink-4);
border: 1px solid var(--line-strong);
- animation: archive-fold 4s var(--ease-out) infinite;
- animation-delay: calc(var(--i) * 0.08s);
}
-@keyframes archive-fold {
- 0%,
- 20% {
- transform: none;
- opacity: 1;
- }
- 40%,
- 60% {
- transform: translateY(10px) scale(0.6);
- opacity: 0.35;
- }
- 80%,
- 100% {
- transform: none;
- opacity: 1;
- }
+.demo-delete .sum {
+ flex: 1;
+ font-family: var(--font-mono);
+ font-size: 10px;
+ line-height: 1.4;
+ color: var(--text-3);
+}
+
+.demo-delete .go {
+ padding: 4px 8px;
+ border-radius: 6px;
+ border: 1px solid rgba(239, 154, 143, 0.32);
+ background: rgba(239, 154, 143, 0.12);
+ font-size: 10.5px;
+ color: var(--rose);
}
/* 细节演示:TASK-N */
diff --git a/website/site/assets/js/dimensions.js b/website/site/assets/js/dimensions.js
index 70c2931..01d0ac5 100644
--- a/website/site/assets/js/dimensions.js
+++ b/website/site/assets/js/dimensions.js
@@ -1,11 +1,11 @@
// “一个任务,四个维度”:同一个任务在目录、日程、流程、步骤四个视图里被引用。
// 切换视图时,任务卡作为共享元素在视图之间移动(View Transitions);
-// 任意一处切换状态,所有引用同时更新,文件夹状态随之重新推导。
+// 任意一处切换状态,所有引用同时更新;文件夹状态由文件夹自己维护,不跟着任务变。
const NEXT = { todo: 'doing', doing: 'done', done: 'todo' };
const LABEL = { todo: '待开始', doing: '进行中', done: '已完成' };
const DESC = {
- tree: '文件夹可以无限嵌套,同一级里文件夹和任务并存。文件夹没有手动状态,由全部后代任务实时推导。',
+ tree: '文件夹可以无限嵌套,同一级里文件夹和任务并存。文件夹也有自己的三态状态,默认待开始,在更多菜单里切换;后代任务只用来统计完成进度。',
time: '同一个任务可以同时出现在多个日期,也可以挂在「额度重置后」「上线前」这样的自定义事件上。',
flow: '把任务放进分阶段的流程看板。一个任务可以加入多个流程,在同一个流程里只出现一次。',
steps:
@@ -61,26 +61,19 @@ function days() {
return out;
}
-/** 文件夹状态:全部待开始=待开始,全部完成=已完成,其余为进行中。 */
-function derive(list) {
- if (list.every((s) => s === 'todo')) return 'todo';
- if (list.every((s) => s === 'done')) return 'done';
- return 'doing';
-}
-
function views() {
const d = days();
return {
tree: `
-
${svg('i-folder')}开发
-
${svg('i-folder')}TaskDock
-
${svg('i-folder')}发布 2.0
+
${svg('i-folder')}开发进行中
+
${svg('i-folder')}TaskDock进行中
+
${svg('i-folder')}发布 2.0进行中
${focusCard('style="--depth:3"')}
更新部署说明
-
${svg('i-folder')}Android
+
${svg('i-folder')}Android待开始
整理家里 NAS 的备份
-
文件夹状态由全部后代任务推导,试试把任务标记为已完成。
+
文件夹状态在更多菜单里单独切换,点任务只改任务。
`,
time: `
${focusCard()}
@@ -160,34 +153,6 @@ export function initDimensions(lens, tabsEl) {
});
const ref = stage.querySelector('[data-caption-ref]');
if (ref) ref.textContent = `${focus.ref} · ${LABEL[focus.s]}`;
-
- // 文件夹状态推导
- // 每个文件夹统计全部层级的后代任务,而不是子文件夹的状态
- const relTasks = [focus.s, 'done'];
- const andTasks = ['doing', 'todo'];
- const tdTasks = [...relTasks, ...andTasks];
- const devTasks = [...tdTasks, 'todo'];
- const aggs = {
- rel: derive(relTasks),
- and: derive(andTasks),
- td: derive(tdTasks),
- dev: derive(devTasks),
- };
- stage.querySelectorAll('[data-agg]').forEach((el) => {
- const s = aggs[el.dataset.agg];
- const changed = el.dataset.s && el.dataset.s !== s;
- el.dataset.s = s;
- el.innerHTML = `${LABEL[s]}`;
- el.style.color = s === 'done' ? 'var(--sage)' : s === 'doing' ? 'var(--amber)' : '';
- if (changed)
- el.animate(
- [
- { opacity: 0.2, transform: 'translateY(-4px)' },
- { opacity: 1, transform: 'none' },
- ],
- { duration: 420, easing: 'cubic-bezier(.22,1,.36,1)' },
- );
- });
}
function render(view) {
diff --git a/website/site/download.html b/website/site/download.html
index 076580c..f7e8c68 100644
--- a/website/site/download.html
+++ b/website/site/download.html
@@ -175,7 +175,7 @@ 浏览器 / PWA
APP_ORIGIN 地址就能使用,无需安装客户端。使用 HTTPS
时可以安装为 PWA 并离线打开。
- 默认 http://服务器地址:48731
+ 默认仅本机 http://127.0.0.1:48731
03 · 手机
@@ -207,7 +207,7 @@ Android
部署五步完成
用 Docker Compose
部署中枢。
- 以下步骤与产品仓库的 README 和部署说明一致。服务器只需要 Docker 与 Docker Compose。
+ 以下步骤按产品仓库的 README 和部署说明整理。服务器只需要 Docker 与 Docker Compose。
@@ -261,8 +261,19 @@ 填写 .env
TASKDOCK_PORT |
- 对外 HTTP 端口,默认
- 48731;被占用时可以换成其他五位端口。
+ 宿主机映射的 HTTP 端口,默认
+ 48731;默认只绑定
+ 127.0.0.1。被占用时可以换一个空闲端口。
+ |
+
+
+ TASKDOCK_BIND_ADDRESS |
+
+ 绑定的宿主机地址,默认
+ 127.0.0.1,只有服务器本机能访问。要让局域网内其他设备直连,设为
+ 0.0.0.0(明文
+ HTTP,仅限可信网络);公网请用 gateway。
|
@@ -325,8 +336,8 @@ 选择版本并启动
$ docker compose pull
$ docker compose --profile operations run --rm migrate
$ docker compose up -d
-# 检查就绪状态(使用 HTTPS 或自定义端口时按 APP_ORIGIN 修改)
-$ curl -fsS http://服务器地址:48731/health/ready
+# 检查就绪状态(默认只绑本机,换地址或端口时按 APP_ORIGIN 修改)
+$ curl -fsS http://127.0.0.1:48731/health/ready
初始化 Owner
打开并登录
- 浏览器访问 APP_ORIGIN 并登录;Android
+ 默认只有服务器本机能打开
+ http://127.0.0.1:48731。要让其他设备访问,二选一:在 .env 里把
+ TASKDOCK_BIND_ADDRESS 改成
+ 0.0.0.0(明文 HTTP,仅限可信网络),或执行
+ docker compose --profile gateway up -d,由 Caddy 用
+ APP_ORIGIN 的域名提供 HTTPS 入口。
+
+
+ 然后用浏览器访问 APP_ORIGIN 并登录;Android
客户端安装后填写同一个中枢地址。HTTP
地址可以使用,但页面会显示安全警告,密码与会话信息会明文传输。公网环境请使用
- HTTPS:需要反向代理时,可以启用 Compose 中的
- gateway(Caddy)profile,注意不要让两个服务占用同一个宿主机端口。
+ HTTPS;启用 gateway 时注意不要让两个服务占用同一个宿主机端口。
@@ -526,7 +545,9 @@ 获取
下载与部署
GitHub Releases
产品源码
- 官网源码
+
+ 官网源码
+
diff --git a/website/site/index.html b/website/site/index.html
index c379b8c..2ab0fa7 100644
--- a/website/site/index.html
+++ b/website/site/index.html
@@ -297,7 +297,7 @@ 一个任务,
只有一个事实。
01目录树
文件夹可以无限嵌套,同一级里文件夹和任务并存。文件夹没有手动状态,由全部后代任务实时推导。文件夹可以无限嵌套,同一级里文件夹和任务并存。文件夹也有自己的三态状态,默认待开始,在更多菜单里切换;后代任务只用来统计完成进度。
@@ -406,9 +406,7 @@ 安排不是复制
顺延可以撤销
-
- 把某一天仍未完成的安排批量顺延到次日,自动跳过已完成或已归档的任务,随时可以撤销。
-
+
把某一天还没做完的安排顺延到第二天,已完成的任务会跳过,顺延完还能撤销。
事件到达不改任务
@@ -586,7 +584,7 @@
数据放在你自己的
服务器上。
$ docker compose pull
$ docker compose --profile operations run --rm migrate
$ docker compose up -d
-# 默认访问 http://服务器地址:48731
+# 默认只在服务器本机可访问:http://127.0.0.1:48731
命令面板
05.3
右滑完成
- 在手机浏览器里,向右滑过阈值即可完成任务,向左滑展开操作菜单;随手记录有常驻的新建按钮。
+ 在手机浏览器里,向右滑过阈值切换完成状态,向左滑展开操作菜单;随手记录有常驻的新建按钮。
@@ -726,16 +724,15 @@
右滑完成
05.4
-
按操作恢复归档
+
删除前先预览
- 归档文件夹会逐项归档整棵子树;恢复时只恢复这一次操作归档的内容,不会误恢复更早归档的任务。
+ 删整棵目录之前,先把会一起消失的文件夹、任务、备注、步骤、日程和流程关联列出来。确认了才执行,断网时直接拒绝。
-
-
归档 → 恢复同一次操作
+
+
+ 文件夹 3
任务 12
备注 8
+ 永久删除
@@ -887,7 +884,9 @@
获取
下载与部署
GitHub Releases
产品源码
-
官网源码
+
+ 官网源码
+