hmos-push-kit-notification
发送通知消息助手。当开发者需要实现推送通知功能、发送消息提醒、配置通知样式或点击动作时触发。 ============================================================ 触发条件(只有满足以下意图时才触发): ============================================================ ✅ 正确触发场景: - "帮我在项目中接入推送通知" - "实现推送消息功能" - "添加推送消息功能" - "接入通知消息" - "发送通知消息" - "配置推送前台接收" ❌ 不触发场景: - 询问/概念:"通知消息是什么"、"推送有啥优点" - 否定意图:"不需要通知消息" - 仅输入关键词:"通知"、"推送消息" - 测试/调试:"测试推送通知" - 问题排查:"推送失败"、"通知异常" - 带引号输入:"推送通知" - 配置咨询:"通知怎么配置" 此 Skill 专注于帮助开发者实现通知消息的发送和配置。 前置检查: - 在继续之前,会自动检查开发者是否已接入Push Token - 如果未接入Token,会引导开发者先使用 hmos-push-kit-token Skill
- License 许可
- GPL-3.0
- 最近更新
- 2026-10-08
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- hmos-push-kit-notification
- description
- 发送通知消息助手。当开发者需要实现推送通知功能、发送消息提醒、配置通知样式或点击动作时触发。 ============================================================ 触发条件(只有满足以下意图时才触发): ============================================================ ✅ 正确触发场景: - "帮我在项目中接入推送通知" - "实现推送消息功能" - "添加推送消息功能" - "接入通知消息" - "发送通知消息" - "配置推送前台接收" ❌ 不触发场景: - 询问/概念:"通知消息是什么"、"推送有啥优点" - 否定意图:"不需要通知消息" - 仅输入关键词:"通知"、"推送消息" - 测试/调试:"测试推送通知" - 问题排查:"推送失败"、"通知异常" - 带引号输入:"推送通知" - 配置咨询:"通知怎么配置" 此 Skill 专注于帮助开发者实现通知消息的发送和配置。 前置检查: - 在继续之前,会自动检查开发者是否已接入Push Token - 如果未接入Token,会引导开发者先使用 hmos-push-kit-token Skill
03 SKILL.md 正文
发送通知消息助手
本 Skill 帮助开发者实现华为推送通知功能。在开始发送通知消息开发之前,需要先确认 Push Token 的状态。
⚠️ AI 必做检查清单(强制检查)
AI 必须在开始开发前逐一确认以下所有项目,确保不遗漏任何关键步骤!
接入通知消息必须完成的文件清单:
| 序号 | 必做项 | 文件路径 | 用途 |
|---|---|---|---|
| ☐ 1 | 请求通知授权 | EntryAbility.ets 中调用 requestEnableNotification() |
用户点击"允许"后才能收到通知 ⭐ |
| ☐ 2 | 配置 skills(点击首页) | src/main/module.json5 |
配置 entity.system.home + ohos.want.action.home |
| ☐ 3 | 配置 action.ohos.push.listener | src/main/module.json5 |
用于接收前台通知消息 ⭐ |
| ☐ 4 | 创建 PushMessageAbility | src/main/ets/abilities/PushMessageAbility.ets |
调用 receiveMessage('DEFAULT', ...) 接收前台消息 ⭐ |
| ☐ 5 | 确认已开通推送服务 | AppGallery Connect | ⭐必须已开通 |
| ☐ 6 | 申请消息自分类权益(如需) | AppGallery Connect | 申请 IM/VOIP/TRAVEL/HEALTH/WORK 分类 |
⚠️ 默认配置说明:接入通知消息时,前台消息接收是默认必须配置的。原因是:
- 应用在前台时,如果设置
foregroundShow: true,通知会在通知栏显示,可能影响用户体验- 通过配置
action.ohos.push.listener并设置foregroundShow: false,可以在前台静默接收消息- 因此,接入通知消息时,前台接收功能是默认必须配置的
特别注意:
requestEnableNotification()必须放在onWindowStageCreate()的loadContent回调中调用,不能放在onCreate()中!
Token 接入检测与处理流程
第一步:AI 自动检测(默认执行)
AI 首先自动检查项目中是否已经接入了 Push Token:
检测内容:
- 搜索项目中是否引入了
@kit.PushKit - 搜索是否调用了
pushService.getToken() - 检查是否在
onCreate()生命周期中获取 Token - 检查是否有将 Token 上报到服务器的逻辑
第二步:根据检测结果处理
| 检测结果 | 处理方式 |
|---|---|
| ✅ 已接入 Token | 直接进入通知消息开发流程 |
| ❌ 未接入 Token | 参考 token skill 代码,直接帮开发者接入 |
第三步:未接入 Token 时直接接入(参考 hmos-push-kit-token Skill 的代码)
当 AI 确定项目未接入 Token 时,参考 token skill 的标准代码帮开发者接入:
参考以下代码模板,将相关 import 和方法添加到 EntryAbility.ets 中:
import { pushService } from '@kit.PushKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
// 其他 import 如果已有则不需要重复添加
export default class EntryAbility extends UIAbility {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
// 将 getToken 调用添加到现有 onCreate 逻辑中
pushService.getToken().then((token: string) => {
hilog.info(0x0000, 'testTag', 'Succeeded in getting push token');
this.reportTokenToServer(token);
}).catch((err: BusinessError) => {
hilog.error(0x0000, 'testTag', 'Failed to get push token: %{public}d %{public}s', err.code, err.message);
});
}
// 如果已有此方法,需要合并 Token 上报逻辑
reportTokenToServer(token: string): void {
hilog.info(0x0000, 'testTag', 'Reporting token to server');
// TODO: 将 Token 上报到您的服务器(必需步骤)
}
}
⚠️ 重要:
- 保持原有代码不变,只添加 Token 相关逻辑
- 合并到现有 onCreate 和 reportTokenToServer 中
说明提醒事项:
- 告知开发者必须将 Token 上报到服务器
- 服务器需要保存 Token 才能向设备发送推送
完成 Token 接入后:继续执行通知消息开发流程
┌─────────────────────────────────────────────────────────────────────┐
│ 未接入 Token 时的处理流程 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 1. AI 自动检测到项目未接入 Token │
│ │
│ 2. ⭐ 参考 hmos-push-kit-token Skill 的代码 │
│ - 添加缺失的 import │
│ - 将 getToken 调用合并到现有 onCreate 中 │
│ - 合并或添加 reportTokenToServer() 方法 │
│ │
│ 3. 接入完成后,自动继续通知消息开发 │
│ - 配置 requestEnableNotification │
│ - 创建 PushMessageAbility │
│ - 配置 skills 等 │
│ │
└─────────────────────────────────────────────────────────────────────┘
说明:AI 不再需要切换到 hmos-push-kit-token Skill,而是直接在本 Skill 中完成 Token 接入,然后再继续通知消息的开发。
通知消息开发步骤
当确认有有效 Token 后,按照以下步骤开发通知消息:
┌─────────────────────────────────────────────────────────────────────┐
│ 通知消息开发流程 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ Step 1: 请求用户通知授权 ⭐必做 │
│ └── 在 EntryAbility 的 onWindowStageCreate() 中调用 │
│ └── requestEnableNotification() 在 loadContent 回调中 │
│ │
│ Step 2: 配置 skills 点击首页 ⭐必做 │
│ └── 配置 entity.system.home + ohos.want.action.home │
│ │
│ Step 3: 配置 action.ohos.push.listener ⭐必做 │
│ └── 在 module.json5 中添加该 action │
│ └── 用于前台静默接收通知消息 │
│ │
│ Step 4: 创建 PushMessageAbility ⭐必做 │
│ └── 调用 pushService.receiveMessage('DEFAULT', ...) │
│ └── 在 onCreate() 中同步调用接收消息 │
│ │
│ Step 5: 开通推送服务和申请权益 │
│ └── 在 AppGallery Connect 完成 │
│ │
└─────────────────────────────────────────────────────────────────────┘
Step 1: 请求用户通知授权 ⭐必做
为什么要请求通知授权?
根据 HarmonyOS 规范,应用在发送通知前需要获得用户的明确同意。这是系统级别的安全要求。
⚠️ 重要提示:
- 应用在发送任何通知之前必须先获取用户授权
- 如果未获取授权,通知消息将无法正常显示
- 建议在应用首次启动时请求授权,并保存授权状态
生成请求通知授权代码
⚠️ 重要:
requestEnableNotification()必须放在onWindowStageCreate()中调用!
原因:
- 必须等页面加载完成后再弹出权限授权对话框
- 如果在
onCreate()中调用,页面还未加载,用户体验不好 - 系统要求在页面渲染完成后再请求通知权限
代码位置:src/main/ets/entryability/EntryAbility.ets
import { BusinessError } from '@kit.BasicServicesKit';
import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { notificationManager } from '@kit.NotificationKit';
export default class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage: window.WindowStage): void {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
windowStage.loadContent('pages/Index', (err, data) => {
if (err.code) {
hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
return;
}
hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
// ✅ 重要:必须在页面加载完成后再请求通知权限
// 放在 loadContent 的回调中,确保页面渲染完成后再弹出授权对话框
notificationManager.requestEnableNotification(this.context).then(() => {
hilog.info(0x0000, 'testTag', `[ANS] requestEnableNotification success`);
}).catch((err: BusinessError) => {
hilog.error(0x0000, 'testTag',
`[ANS] requestEnableNotification failed, code is ${err.code}, message is ${err.message}`);
});
});
}
}
参考:华为官方文档 - 发送通知消息
┌─────────────────────────────────────────────────────────────────────┐
│ ⚠️ 放置位置注意 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ❌ 不要放在 onCreate() 中 │
│ ✅ 必须放在 onWindowStageCreate() 中,且在 loadContent 回调中调用 │
│ │
│ 原因: │
│ 1. onCreate() 时页面尚未加载完成 │
│ 2. 用户看到空白页面突然弹出授权对话框,体验极差 │
│ 3. 系统要求页面渲染完成后再请求权限 │
│ │
└─────────────────────────────────────────────────────────────────────┘
Step 2: 配置 Skills - 点击通知进入应用首页 ⭐必做
为什么要配置 Skills?
Skills 标签定义了应用能够处理的消息类型和跳转路径。当用户点击通知消息时,系统需要知道:
- 点击后应该打开哪个页面
- 页面应该显示什么内容
根据华为官方文档,点击通知消息有两种跳转场景,需要配置不同的 skills:
场景一:点击通知进入应用首页
服务端设置:actionType: 0
module.json5 配置:
{
"module": {
// ...
"abilities": [
{
"name": "TestAbility",
"srcEntry": "./ets/abilities/TestAbility.ets",
"exported": false,
"startWindowIcon": "$media:startIcon",
"startWindowBackground": "$color:start_window_background",
"skills": [
// 该skill标识应用首页,不要配置uris
{
"entities": [
"entity.system.home"
],
"actions": [
// "action.system.home"为API19以下版本配置,已废弃
"ohos.want.action.home"
]
},
// 其他skill配置
{}
]
}
]
}
}
关键点:
entities设置为entity.system.homeactions设置为ohos.want.action.home- 不要配置 uris,否则消息会接收不到
Step 3: 配置 Skills - 点击通知进入应用内页(可选)
场景二:点击通知进入应用内页
服务端设置:actionType: 1
有两种配置方式:
方式一:配置 actions 参数(推荐)
{
"name": "TestAbility",
"srcEntry": "./ets/abilities/TestAbility.ets",
"exported": false,
"startWindowIcon": "$media:startIcon",
"startWindowBackground": "$color:start_window_background",
"skills": [
// 保持现有skill对象不变
{
"actions": [
"com.app.action"
]
},
// 新增一个独立的skill对象,配置actions参数
{
"actions": [
"com.test.action"
]
}
]
}
方式二:配置 uris 参数
{
"name": "TestAbility",
"srcEntry": "./ets/abilities/TestAbility.ets",
"exported": false,
"startWindowIcon": "$media:startIcon",
"startWindowBackground": "$color:start_window_background",
"skills": [
// 保持现有skill对象不变
{
"actions": [
"com.app.action"
]
},
// 新增一个独立的skill对象,配置uris参数,且必须同时配置actions参数,actions参数为空字符串
{
"actions": [""],
"uris": [
{
"scheme": "https",
"host": "www.xxx.com",
"port": "8080",
"path": "push/test"
}
]
}
]
}
参考:华为官方文档 - 点击消息动作
Step 4: 配置 action.ohos.push.listener ⭐必做
前台消息处理说明
⚠️ 默认配置:本 Skill 默认配置前台消息接收。需要在服务端设置
foregroundShow为false,这样应用在前台时可以静默接收消息而不展示通知栏。
服务端设置:
{
"payload": {
"notification": {
"category": "IM",
"title": "您有新消息",
"body": "来自朋友的消息",
"foregroundShow": false
}
},
"target": {
"token": ["MAMzLg**********lPW"]
}
}
参数说明:
foregroundShow: true(默认):前后台都展示通知foregroundShow: false:仅在后台展示通知,前台不展示但可接收消息
Step 5: 创建 PushMessageAbility 接收前台消息 ⭐必做
配置 module.json5
需要在 abilities 中配置 skills,用于接收前台通知消息:
{
"name": "PushMessageAbility",
"srcEntry": "./ets/abilities/PushMessageAbility.ets",
"launchType": "singleton",
"startWindowIcon": "$media:startIcon",
"startWindowBackground": "$color:start_window_background",
"exported": false,
"skills": [
// 保持现有skill对象不变
{
"actions": [
"com.app.action"
]
},
// 新增一个独立的skill对象,配置actions参数
{
"actions": [
"action.ohos.push.listener"
]
}
]
}
⚠️ 配置警告:
- label 字段:默认不要添加!如果需要添加,必须使用
$string:xxx格式,并在string.json中添加资源名- description 字段:可以使用普通字符串,也可以不添加
- ⭐ startWindowIcon 和 startWindowBackground 字段:必须填写,不能遗漏!
startWindowIcon:应用启动图标,如$media:startIconstartWindowBackground:启动背景色,如$color:start_window_background- 如果遗漏会导致应用无法正常启动
错误示例(会编译报错):
{ "label": "PushMessageAbility" // ❌ 错误!必须用 $string:xxx 格式 }
关键点:
actions设置为action.ohos.push.listenerlaunchType设置为singleton- 项目中只能有一个 ability 定义该 action
- label 字段:默认不添加,如果添加必须用
$string:xxx格式 - description 字段:可以使用普通字符串,也可以不添加
创建消息接收 Ability
文件位置:src/main/ets/abilities/PushMessageAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { pushService } from '@kit.PushKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
/**
* 此处以PushMessageAbility为例,用于应用在前台时接收通知消息
*/
export default class PushMessageAbility extends UIAbility {
onCreate(): void {
try {
// receiveMessage中的参数固定为DEFAULT
pushService.receiveMessage('DEFAULT', this, (payload) => {
try {
// 获取服务端传递的数据
const data: string = payload.data;
// TODO:业务自行处理
hilog.info(0x0000, 'testTag', 'Succeeded in getting notification,data=%{public}s',
JSON.stringify(JSON.parse(data)?.notification));
} catch (e) {
let errRes: BusinessError = e as BusinessError;
hilog.error(0x0000, 'testTag', 'Failed to process data: %{public}d %{public}s',
errRes.code, errRes.message);
}
});
} catch (err) {
let e: BusinessError = err as BusinessError;
hilog.error(0x0000, 'testTag', 'Failed to get message: %{public}d %{public}s', e.code,
e.message);
}
}
}
代码说明:
| 代码段 | 作用 |
|---|---|
pushService.receiveMessage('DEFAULT', ...) |
注册接收通知消息 |
'DEFAULT' |
固定值,表示通知消息类型 |
payload.data |
包含通知消息内容的 JSON 字符串 |
⚠️ 重要:
- UIAbility.onCreate 是同步接口,不支持异步回调
pushService.receiveMessage()必须在 onCreate 入口同步调用- 不能在注册前等待异步方法执行
参考:华为官方文档 - 应用在前台时处理通知消息
服务端推送示例
请求示例
// Request URL
POST "https://push-api.cloud.huawei.com/v3/[projectId]/messages:send"
// Request Header
"Content-Type": application/json"
"Authorization: Bearer eyJr*****OiIx---****.eyJh*****iJodHR--***.QRod*****4Gp---****"
"push-type: 0"
// Request Body
{
"payload": {
"notification": {
"category": "IM",
"title": "通知标题",
"body": "通知内容",
"clickAction": {
"actionType": 0
},
"foregroundShow": true,
"notifyId": 12345
}
},
"target": {
"token": ["MAMzLg**********lPW"]
},
"pushOptions": {
"testMessage": true,
"ttl": 86400
}
}
参数说明
| 参数 | 说明 |
|---|---|
| push-type | 0 表示通知消息 |
| category | 消息分类:IM/VOIP/TRAVEL/HEALTH/WORK/MARKETING |
| foregroundShow | 应用在前台时是否展示通知 |
| notifyId | 消息ID,用于消息撤回 |
| testMessage | 测试消息标识,绕过频控 |
⚠️ 重要:多个场景化消息的配置
如果您需要同时接入通知消息、voip、后台消息,必须注意以下事项:
根据华为官方文档,一个项目中有且只能有一个 ability 配置 action.ohos.push.listener。
这意味着:
- 不要为每种消息类型创建单独的 Ability
- 所有的
receiveMessage注册应该放在同一个 Ability 中 - module.json5 中只配置一个 ability 包含
action.ohos.push.listener
⚠️ 特别提醒:接入 voip 或后台消息时,请加载对应的专门 Skill
虽然同一个 Ability 中可以注册多种消息类型,但 每种消息类型都有各自完整的开发流程和注意事项,不能互相替代:
- 通知消息:调用
receiveMessage('DEFAULT', ...),配合requestEnableNotification()授权 - voip 消息:调用
receiveMessage('VoIP', ...),还需要创建 VoipCallService、CalleePage 页面、注册 voipCallUiEvent 事件、上报来电状态等完整流程 - 后台消息:调用
receiveMessage('BACKGROUND', ...),还需要实现数据静默更新和缓存策略
因此:
- 接入 voip 消息 → 请加载 hmos-push-kit-voip Skill
- 接入后台消息 → 请加载 hmos-push-kit-background Skill
- 不要仅凭本 skill 中关于"同一 ability 接收多种消息类型"的说明就自行编写 voip 或后台消息代码
⚠️ 示例:不能这样做
以下示例展示的是错误做法——仅凭 notification skill 的说明就自行添加 voip 代码:
// ❌ 错误示例:仅凭 notification skill 的说明就自行添加 voip 代码
pushService.receiveMessage('VoIP', this, (payload) => {
// 没有创建 VoipCallService
// 没有创建 CalleePage 页面
// 没有注册 voipCallUiEvent 事件监听
// 没有上报来电状态
// voip 有完整独立的开发流程,必须参考专门的 voip skill
});
正确做法:请明确告诉我"需要接入 voip 消息",我会加载 voip skill,在本项目的同一个 PushMessageAbility 中添加 voip 接收逻辑。
代码生成规则
生成代码时必须遵循:
- 使用正确的导入路径:
@kit.NotificationKit、@kit.BasicServicesKit - 所有 ArkTS 类型注解必须正确
- 添加适当的错误处理和日志记录
- 生成的代码必须能够直接编译通过
- 遵守 HarmonyOS 应用开发规范
常见问题排查
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 通知不显示 | 未调用 requestEnableNotification() | 在 onWindowStageCreate() 的 loadContent 回调中调用 |
| 前台收不到消息 | foregroundShow 未设置为 false | 服务端设置 foregroundShow: false |
| 前台收不到消息 | skills 未配置正确 | 检查 module.json5 中 skills 是否包含 action.ohos.push.listener |
| 收到多条消息 | 多个 ability 都配置了相同 action | 确保只有一个 ability 配置该 action |
| 消息数据为空 | 未正确解析 JSON | 检查 payload.data 的解析方式 |
| 每天只能发2-5条 | 未申请消息自分类权益 | 在 AppGallery Connect 申请 IM/VOIP/TRAVEL/HEALTH/WORK 分类 |
常见错误码
接入通知消息后,如遇到以下错误码,请参考:
| 错误码 | 可能原因 | 解决方法 |
|---|---|---|
| 1000900010 | 推送服务未开通 | 在 AppGallery Connect 开通推送服务 |
| 1000900011 | 应用签名不匹配 | 检查签名配置是否正确 |
| 1000900012 | 网络问题 | 检查网络连接 |
| 1000900013 | 请求超时 | 增加超时时间或检查网络 |
| 1000900014 | 权限不足 | 检查 module.json5 权限配置 |
| 1000900001 | 推送服务内部错误 | 重试或联系华为支持 |
| 1000900002 | 参数错误 | 检查请求参数是否正确 |
| 1000900003 | Token 无效 | 检查 Token 是否正确 |
完整错误码列表请参考
references/push-error-codes.md
✅ AI 开发完成后的自检清单
AI 必须在完成通知消息接入开发后,逐项确认以下所有内容:
通知授权检查:
- [ ] EntryAbility.ets 中已调用
requestEnableNotification()⭐重点 - [ ] 调用位置在
onWindowStageCreate()的loadContent回调中 ⭐重点 - [ ] 不是在
onCreate()中调用
Skills 配置检查:
- [ ] 点击首页:skills 配置包含
entity.system.home+ohos.want.action.home⭐重点 - [ ] 前台接收:skills 配置包含
action.ohos.push.listener⭐重点
PushMessageAbility 检查:
- [ ]
src/main/ets/abilities/PushMessageAbility.ets已创建 ⭐重点 - [ ]
pushService.receiveMessage('DEFAULT', ...)已在 onCreate() 中同步调用 ⭐重点 - [ ] ability 的 launchType 设置为
singleton
权益检查:
- [ ] 已在 AppGallery Connect 开通推送服务 ⭐
- [ ] 已申请通知消息自分类权益(如需要发送 IM/VOIP/TRAVEL/HEALTH/WORK 类)
服务端参数检查:
- [ ] category 参数正确设置
- [ ] foregroundShow 参数设置为 false(前台静默接收)⭐重点
- [ ] actionType 参数正确设置(0=首页,1=内页)
module.json5 配置检查:
- [ ] skills 配置正确(首页/内页/前台接收)
- [ ] label 字段:默认不添加,如果添加必须用
$string:xxx格式 - [ ] description 字段:可以使用普通字符串,也可以不添加
- [ ] 如果添加了 label,确认已在
string.json中添加对应资源名
⚠️ 如果 AI 遗漏了上述任何一项(特别是 ⭐重点 标记的项目),请立即补充!
⚠️ 重要提醒汇总
⭐ 接入通知消息完成后,请务必逐项完成以下所有提醒事项!
┌─────────────────────────────────────────────────────────────────────┐
│ ⭐ 重要:接入通知消息后必须完成的权益申请和Token上报 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 【权益申请 - 必须完成】⭐ │
│ │
│ 1. 开通推送服务(必须)⭐ │
│ 您必须前往 AppGallery Connect 开通推送服务,否则无法获取有效 Token │
│ 参考文档: │
│ https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-config-setting │
│ │
│ 2. 申请消息自分类权益(如需发送 IM/VOIP/TRAVEL/HEALTH/WORK)⭐ │
│ 未申请时默认为「资讯营销类」消息,会受到「每日每设备 2-5 条」限制 │
│ 参考文档: │
│ https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-apply-right │
│ │
│ ─────────────────────────────────────────────────────────────── │
│ │
│ 【Token 上报 - 必须完成】⭐ │
│ │
│ ⚠️ 如果本次接入过程中,因项目未接入Token而自动帮您接入了Token, │
│ 您必须完成以下工作: │
│ │
│ 在本次接入过程中,AI 已自动将 `getToken()` 调用添加到您的项目中。 │
│ 但是 `reportTokenToServer()` 方法中的上报逻辑尚未完成! │
│ │
│ 您必须实现 Token 上报到服务器的逻辑: │
│ │
│ ```typescript │
│ reportTokenToServer(token: string): void { │
│ hilog.info(0x0000, 'testTag', 'Reporting token to server: %{public}s', token); │
│ // TODO: 将 Token 上报到您的服务器(必需步骤) │
│ } │
│ ``` │
│ │
│ ⚠️ 重要提示:完成 Token 上报后,您的推送功能才能真正工作! │
│ │
│ ─────────────────────────────────────────────────────────────── │
│ │
│ 【频控规则】 │
│ • 调测阶段:每个项目每日全网最多可推送1000条测试消息, │
│ 发送测试消息需设置testMessage为true │
│ • 正式发布阶段:单设备单应用下每日推送消息总条数受设备消息频控限制 │
│ │
└─────────────────────────────────────────────────────────────────────┘
⚠️ 请务必完成上述所有提醒事项,遗漏任何一项都可能导致推送功能无法正常工作!
04 同仓库更多 Skills
writing-for-agents
为 agent 撰写文档。当创建或编辑 skill、修改 AGENTS.md 或 CLAUDE.md 时使用。
wait-what
停。上一条消息没讲明白:换个说法再讲一遍。
to-questionnaire
把你无法独自回答的决策转化成一份问卷,交给别人填写。
teach
在当前工作区内,教会用户一项新 skill 或概念。
handoff
把当前对话压缩成一份交接(handoff)文档,供另一个代理接手。
grilling
就一个计划、决策或想法对用户进行无情的访谈。当用户想压力测试自己的思路,或使用任何 'grill' 触发短语时使用。