ae-tracking 0.1.0 → 0.2.0

package/skills/generate-tracking-code/references/server-sdk-insert.md

@@ -30,6 +30,35 @@
 2. 读 wiki 主文档（初始化、LoggerConsumer 配置）
 3. 读 wiki 进阶指南（用户属性、批量上报等）
 
+### Stage 0.5: SDK 集成确认（Stage 0 完成后必须执行）
+
+根据选择的 SDK，识别需要使用哪种依赖管理方式（Maven / pip / go get / npm / composer 等），向用户确认：
+
+**需要代码改动的集成方式（Maven / pip / go get / npm / composer 等）**：
+
+```
+检测到服务端使用 <语言> SDK，需要修改依赖配置。
+
+是否需要我直接修改配置文件添加 SDK 依赖？
+- yes → Edit 修改配置文件（如 pom.xml / requirements.txt / go.mod / package.json / composer.json 等），完成后进入 Stage 1
+- no → 参考以下文档完成 SDK 引入，完成后回答 yes 继续
+
+文档：<wiki 文档路径>
+```
+
+- 用户 `yes` → 执行 Edit 修改配置文件，完成后进入 Stage 1
+- 用户 `no` → 显示文档路径，暂停等待用户完成
+
+**无需代码改动的集成方式（如需手动下载 JAR / 放置文件等）**：
+
+```
+请参考以下文档完成 SDK 引入，完成后回答 yes 继续。
+
+文档：<wiki 文档路径>
+```
+
+等待用户确认完成后，进入 Stage 1。
+
 ---
 
 ## Stage 1: Explore

package/skills/generate-tracking-code/references/snippet-delivery.md

@@ -125,14 +125,14 @@ ta.track('<event_name>', {
 /**
  * AE 埋点代码片段 - <平台>
  * 
- * 使用说明：
+* 使用说明：
  * 1. 复制 SDK 初始化代码到入口文件
  * 2. 复制公共属性代码到 init 后
  * 3. 复制事件代码到对应触发位置
  * 
  * 配置：
- * - SERVER_URL: <用户提供的地址>
- * - appId: <用户提供的 ID>
+ * - SERVER_URL: <数据上报地址>
+ * - APPID: <APP_ID>
  */
 
 // ==================== SDK 初始化 ====================
@@ -224,10 +224,17 @@ AE Debug 模式需要先在 AE 系统添加设备 ID 才能查看数据：
      - xlsx 中 "采集端" 为 `客户端,服务端` 或 `client,server` → `platform: "both"`
    - 若事件无 platform 字段（早期 xlsx 无此列），则读取全部事件（向后兼容）
 3. 从 plan 读取用户属性列表（用户属性无 platform 字段，两端都生成）
-4. **读 `references/sdk-index.md` 找到对应 SDK 主文档路径，读主文档的「集成 SDK」章节了解集成方式**
-5. 生成代码片段（markdown + 文件）
-6. 服务端额外生成 `daemon.json`
-7. **服务端额外生成时，必须同步提供 LogBus2 官方文档链接** 
+4. **读 `references/sdk-index.md` 找到对应 SDK 主文档路径**
+5. **读 wiki 主文档，复制代码示例时必须直接拷贝文档中的代码块，不要手动改写**：
+   - **初始化代码**：直接复制 wiki 文档中的变量赋值写法（如 `te := thinkingdata.New(consumer)`），不要封装成函数、不要加显式返回类型
+   - **自动采集代码**：直接复制 wiki 文档中的示例（如 `TDAnalytics.TDAutoTrackEventType.XXX` 不能写成 `TDAutoTrackEventType.XXX`）
+   - **事件 track 代码**：属性名和事件名来自 plan，结构直接复用 wiki 示例
+   - **用户属性代码**：直接复制 wiki 文档中的示例（如 `te.UserSet()` 的调用方式）
+   - **公共属性代码**：直接复制 wiki 文档中的示例（如 `setSuperProperties` 的调用方式）
+   - **禁止**：封装函数、添加返回类型、改变代码结构（除非 plan 需要）
+6. 生成代码片段（markdown + 文件）
+7. 服务端额外生成 `daemon.json`
+8. **服务端额外生成时，必须同步提供 LogBus2 官方文档链接** 
 
 ---
 

package/skills/generate-tracking-plan/SKILL.md

@@ -767,7 +767,7 @@ ae-tracking plan upload --project <projectId> --xlsx .ae-tracking/draft.xlsx [--
 - **加 `--replace`**：先删除项目现有方案再上传（用户选择"替换"时，或严重冲突改用替换）
 - **不加 `--replace`**：AE merge-by-name 合并（无冲突或仅有提醒，用户确认追加）
 
-成功上传后，提示用户去 AE 后台确认，**提供完整 URL**。
+成功上传后，提示用户去 AE 后台确认，**提供完整 URL**（埋点方案页面 URL 格式为 `https://<host>/#/data/plan`）。
 
 ---
 
@@ -807,7 +807,7 @@ Fixed: 修复对象组子属性不一致, 修复显示名重复
 
 ### 4.5 成功后处理
 
-成功上传后，提示用户去 AE 后台确认，**提供完整 URL**
+成功上传后，提示用户去 AE 后台确认，**提供完整 URL**（埋点方案页面 URL 格式为 `https://<host>/#/data/plan`）
 
 ## 禁止
 

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk/ios.md

@@ -192,7 +192,7 @@ NSDictionary *superProperties = @{
 ::: el-tab-pane label=Swift
 
 ```
-var superProperties: [AnyHashable : Any] = [:]
+var superProperties: [String : Any] = [:]
 superProperties["channel"] = "ta"
 superProperties["age"] = 1
 superProperties["isSuccess"] = true
@@ -373,7 +373,7 @@ if (授权隐私政策) {
     
     TDAnalytics.login("TD")
     
-    var superProperties: [AnyHashable : Any] = [:]
+    var superProperties: [String : Any] = [:]
     superProperties["channel"] = "ta"
     superProperties["age"] = 1
     superProperties["isSuccess"] = true

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk/macos.md

@@ -181,7 +181,7 @@ NSDictionary *superProperties = @{
 ::: el-tab-pane label=Swift
 
 ```
-var superProperties: [AnyHashable : Any] = [:]
+var superProperties: [String : Any] = [:]
 superProperties["channel"] = "ta" //字符串
 superProperties["age"] = 1 //数字
 superProperties["isSuccess"] = true //布尔