1

Author: wicyn

.github/workflows/macos.yml

@@ -79,4 +79,51 @@ jobs:
       run: cmake --build build --parallel $(sysctl -n hw.ncpu)
     - name: Test
       working-directory: build
-      run: ctest --output-on-failure -LE perfile
+      run: ctest --output-on-failure -LE perfile
+
+  # ── 探针(诊断用，允许失败，不 gate CI) ─────────────────────────
+  # 测 macos-latest 自带 Apple Clang 的 libc++ 有没有 <stop_token> / jthread：
+  #   PLAIN OK            → 默认就有，可去掉上面三个 job 的 Homebrew，回归原生工具链
+  #   PLAIN FAIL + EXP OK → 有但被实验开关挡着，正式 job 加 -fexperimental-library 即可省掉 Homebrew
+  #   两者都 FAIL         → Apple libc++ 确实没带，维持现在的 Homebrew LLVM 方案
+  probe-apple-stop_token:
+    runs-on: macos-latest
+    continue-on-error: true
+    steps:
+    - name: Show Apple Clang
+      run: clang++ --version
+    - name: Probe <stop_token>
+      run: |
+        cat > probe.cpp <<'EOF'
+        #include <version>
+        #include <stop_token>
+        #include <thread>
+        int main() {
+        #if defined(__cpp_lib_jthread) && defined(__cpp_lib_stop_token)
+            std::stop_source src;
+            std::jthread jt([](std::stop_token t) { (void)t; });
+            src.request_stop();
+            return src.get_token().stop_requested() ? 0 : 1;
+        #else
+            return 2;  // 特性宏未定义
+        #endif
+        }
+        EOF
+
+        echo "== Attempt 1: plain =="
+        if clang++ -std=c++23 probe.cpp -o probe_plain; then
+          echo "PLAIN: compile OK"
+          ./probe_plain && echo "PLAIN: runtime OK (feature macros present)" \
+                        || echo "PLAIN: feature macros NOT defined (rc=$?)"
+        else
+          echo "PLAIN: compile FAIL"
+        fi
+
+        echo "== Attempt 2: -fexperimental-library =="
+        if clang++ -std=c++23 -fexperimental-library probe.cpp -o probe_exp; then
+          echo "EXPERIMENTAL: compile OK"
+          ./probe_exp && echo "EXPERIMENTAL: runtime OK" \
+                      || echo "EXPERIMENTAL: feature macros NOT defined (rc=$?)"
+        else
+          echo "EXPERIMENTAL: compile FAIL — Apple libc++ does not ship <stop_token>"
+        fi

taskflowlite/core/graph.hpp

@@ -1,4 +1,4 @@
-/// @file  graph.hpp
+/// @file  graph.hpp
 /// @brief 任务图容器 Graph —— Work 节点的物理存储与生命周期管理。
 /// @author wicyn
 /// @contact https://github.com/wicyn
@@ -83,11 +83,7 @@ class Graph {
 
     /// @brief D2 可视化导出。
     ///
-    /// 将图中所有节点及其边以 D2 格式输出。根据边类型应用不同样式:
-    ///   - Jump/MultiJump: 红色虚线
-    ///   - Branch/MultiBranch: 蓝色粗线
-    ///   - 普通边: 灰色
-    ///
+    /// 将图中所有节点及其边以 D2 格式输出。
     /// @param ostream 输出流。
     void dump(std::ostream& ostream) const;
 

taskflowlite/core/traits.hpp

@@ -23,9 +23,15 @@
 #include <concepts>
 #include <functional>
 #include <type_traits>
+#include <version>
 
 #include "forward.hpp"
 
+#if !defined(__cpp_lib_jthread) || __cpp_lib_jthread < 201911L
+#  error "TaskflowLite requires P0660 (std::jthread / std::stop_token / std::stop_source). Use a stdlib that provides it: libstdc++ 11+, libc++ 18+, or MSVC STL; on macOS use Homebrew LLVM if Apple Clang lacks it."
+#endif
+
+
 namespace tfl {
 
 // ── std::unwrap_ref_decay_t<T> 行为速查 ──────────────────────────────