前言

用 CodeArts Agent 写了一段时间鸿蒙代码之后,我注意到一件事:它的 AI 面板里没有"新建对话"之外的任何按钮,但日志里却一直在加载东西。

具体说,是插件目录下那份 HarmonyBot 的通信日志,反复出现一堆 name + description 的结构,名字都长这样:harmonyos-ascf-privacy、hmos-api-change-assistant、harmonyos-ui-multi。

我当时的第一反应是:这些是什么?是提示词模板?是工具?还是某种插件内的子程序?

后来弄明白了,这些东西叫 skill,是码道这个 AI 助手的能力单元。它不是简单的提示词,每个 skill 都带着自己的领域知识、操作步骤,有的还会去调用外部命令。

这让我动了拆包的念头:既然官方说"依托码道鸿蒙专属模型",那"专属"这两个字,到底专属在哪?是模型权重不同,还是这些技能包在起作用?

这个问题不好直接回答,因为模型权重在云端,拆不到。但技能包在本地,能看到、能数、能读。所以我的做法是从能验证的一头开始——先把它到底装了什么摊开,再谈它是不是"专属"。

证据从哪来

我没有内部资料,所有结论都来自两个地方。

第一是插件包本身。 HuaweiDeveloperServicePlatform.harmonyosdevassistantforvscode,darwin-arm64 版本 76.5 MB。解开之后能看到 dist/extension.js(主逻辑)、plugin-layer/vscode/lsp/(语言服务相关)、resources/opencode/(AI 侧的配置和 skill 包),还有一个 resources/signer/remote-sign-1.0.0.jar。

第二是运行日志。 插件跑起来之后会往 ~/Library/Application Support/CodeArts Agent/logs/<时间戳>/window1/exthost/output_logging_*/5-HarmonyBot Traffic.log 里写东西,里面完整记录了加载了哪些 skill、每个的 name 和 description。

我是从这份日志里数出来的:38 个跟鸿蒙相关的 skill。

面板长什么样

先看一眼它实际的样子:
在这里插入图片描述

界面上有三个信息。

一是两种模式。 “氛围编程 Vibe-Coding"和"规范开发 Spec-Driven”。前者是边聊边改,后者是先把规格写清楚再生成。这个区分挺有意思——它默认承认了"随手改"和"按规格做"是两种不同的工作方式。

二是模型选择器。 右下角那个 DeepSeek-V4.1-Fl... 的下拉框,说明码道的模型是可以切的。至于"鸿蒙专属模型"是不是就是这里选的某个选项,我没有账号,没法验证。

三是底部那条红字:登录信息已经过期,请重新登录。

这条提示很关键。它意味着后面所有的技能,我都没法真正触发——因为 AI 面板不可用。所以这篇文章的写法只能是"拆包 + 手动复现",而不是"挨个跑一遍"。

38 个技能,先分组

我把名字拉全了,按用途能分成五组。先给全貌(后面几节逐个说):

分组技能(部分)大致数量
开发主线harmonyos-dev、harmonyos-design、harmonyos-prd-design3~4
一多/跨端harmonyos-multi-device、harmonyos-ui-multi、harmonyos-workflow-multi、harmonyos-flutter-multi、harmonyos-rn-multi、harmonyos-h5-multi、harmonyos-camera-multi7
元服务 ASCFharmonyos-ascf、harmonyos-atomic-ascf-convert、harmonyos-atomic-ascf-release、harmonyos-ascf-privacy、harmonyos-ascf-login、harmonyos-ascf-location、harmonyos-ascf-advertising、harmonyos-ascf-message-subscription10+
工程治理harmony-development-env-check、hmos-api-change-assistant、hmos-library-adapter-fast、hmos-library-quality-assessment、harmonyos-migration-playbook、hmos-fix、harmonyos-plugin7
工具与知识deveco-cli、harmony-emulator-debugging、harmonyos-docs-lookup、harmonyos-sdk-api-lookup、harmonyos-cloud-knowledge5+

一眼就能看出重点在哪:元服务的技能最多。ASCF 那一路有十几个,从转换、隐私、登录、定位、广告、消息订阅,一直到上架和备案。这是华为生态当前最想推的方向,技能包把资源压在了这里。

开发主线:三个偏"方法论"的技能

harmonyos-dev 和 harmonyos-design 的描述都很短,就一句 “HarmonyOS Development”、“HarmonyOS Design”。看着像占位符,实际上这类主技能通常不长——它们负责"路由",真正的细节在子技能里。

有意思的是 harmonyos-prd-design,它的描述写得很具体:

专业的 HarmonyOS PRD 设计生成专家,基于鸿蒙设计规范,提供从用户研究到设计交付的全流程支持,生成可交互 Web 演示页面

这是个"产品经理向"的技能:从需求文档一直到可交互的演示页。放在一个编程助手里显得有点跨界,但对鸿蒙这种"应用 + 元服务 + 多端"的生态来说,先定规格再写代码确实更省事——这也对应了面板上那个 “Spec-Driven” 模式。

一多适配:这里有个明确的边界

这一组里最值得说的是 harmonyos-ui-multi,因为它的描述里有一句"不覆盖什么":

提供 HarmonyOS ArkUI 一多适配知识,用于分析或直接诊断、修复明确的局部布局问题,包括断点与响应式布局、导航挪移、留白或遮挡、安全区与软键盘、折展与悬停、横竖屏等。当前覆盖手机、折叠屏和平板,不覆盖 2in1/PC。

我特意把这句话标出来,因为它回答了我在另一篇文章里纠结的问题:deviceTypes 写了四个类型,实际适配该做到哪一步?

官方技能的答案很直接:先做手机、折叠屏、平板,2in1/PC 不在当前范围。 这不是能力不足,是优先级——把三个移动形态做扎实,比四个都做一半有用。

这条信息比任何文档都好用,因为它是"作者自己划的线"。文档往往告诉你"支持什么",很少告诉你"暂时不做什么"。

同组还有几个跨框架的:harmonyos-flutter-multi、harmonyos-rn-multi、harmonyos-h5-multi、harmonyos-camera-multi。从名字看,是把 Flutter、React Native、H5 这些存量技术栈往鸿蒙上适配。这也解释了为什么 hmos-library-adapter-fast(三方库适配)会是一个独立技能——生态迁移的需求很大。

元服务这一路,细到有点意外

10 多个 ASCF 技能里,我挑三个说。

harmonyos-atomic-ascf-convert 是最硬的一个,描述里写清了工具链:

使用 @atomicservice/ascf-toolkit(ASCF CLI)的 ascf generate、ascf convert 生成并转换工程,使用 DevEco CLI 的 devecocli build clean、devecocli build 构建,使用 devecocli run 构建安装运行;将微信、支付宝等原生小程序迁移为鸿蒙 ASCF 元服务工程。

你看,它不只说"能转换",还把用哪个 CLI、哪条命令都写死了。这就是 skill 和提示词的区别——提示词给方向,skill 给可执行步骤。

harmonyos-ascf-privacy 更有意思,它管的是隐私合规:

涵盖 AGC 云侧设备权限配置、工程权限声明、ASCF 源码入口接入隐私组件、调试/上架核验以及 devecocli build 编译验证。适用于隐私托管、隐私协议弹窗、has.getPrivacySetting、has.onPrivacyStateChanged、needAuthorization 等问题。

连 API 名字都列进去了。这种细节不可能是通用模型现编的——它是把华为的合规经验和具体接口绑在了一起。

第三个是路由机制。harmonyos-ascf-troubleshooting 的描述开头写着:

Sub-skill:ASCF 通用排障编排……仅由 harmonyos-ascf-knowledge 主技能按路由加载。

也就是说,这些技能之间有层级:一个主技能负责判断"用户这个问题属于哪一类",然后把控制权交给对应的子技能。用户不需要知道该调用哪个,助手自己路由。

这个设计挺聪明。38 个技能如果全平铺,模型面对一个模糊问题时很容易选错;有了主技能做路由,选择权就从"猜"变成了"判断"。

工程治理:最实用的几个

这一组里我最感兴趣的是 harmony-development-env-check:

检查 HarmonyOS 开发环境配置(Node.js、JDK、ohpm、hvigor、DevEco SDK)

五项检查。都是老手觉得"这还用查"、新手每次都要卡一遍的东西。我前面写构建脚本时,就是因为 NODE_HOME 没设被卡了半小时——如果当时有个东西能一键告诉我"你系统里的 node 和 DevEco 自带的不是同一个",那半小时就省了。

hmos-api-change-assistant 也很实在:

扫描 HarmonyOS 工程在两个 SDK 版本之间的 API 变更,输出受影响的接口签名、代码位置和官方指导文档链接

鸿蒙的 SDK 版本迭代快,API 变动频繁。这个技能解决的是"升级 SDK 之后哪些代码要改"——这是每个项目都会遇到的活。

还有 hmos-library-quality-assessment,描述里写着从架构和代码质量两个维度审查 HAR/HSP 库,输出分级发现清单。这相当于给三方库做体检,避免引入一个看起来能用、实际一堆坑的依赖。

一条 description 的解剖

拆到后面我发现,这些 description 的写法是有套路的。拿 harmonyos-ascf-troubleshooting 举例:

Sub-skill:ASCF 通用排障编排。用于构建失败、运行白屏、DevEco 调试失败、Toolkit/Plugin/CLI 报错等场景。仅由 harmonyos-ascf-knowledge 主技能按路由加载。

三段结构很清楚。

第一段是身份:“Sub-skill”,先声明自己不是顶层入口。这一句很关键,它告诉模型"别直接调我"。

第二段是触发场景:“构建失败、运行白屏、DevEco 调试失败、Toolkit/Plugin/CLI 报错”。写得特别具体,全是现象,不是功能。模型要判断"该不该用我",靠的就是这种现象列表。

第三段是调用约束:“仅由 X 主技能按路由加载”。这是一条硬约束,防止模型越级调用。

再看 hmos-library-adapter-fast 的写法:

三方库适配/修复统一入口——自动识别适配或修复意图,分发到对应子包完成鸿蒙适配或问题修复。仅处理三方库鸿蒙适配/修复相关问题。

同样是三段,但第三段换成了"负面清单":只处理这一类,别的不接。这种"我不干什么"的声明,在多技能环境里比"我能干什么"更重要——因为模型最容易犯的错不是不会做,是拿错工具做。

为什么是文件而不是提示词

这些技能不是塞在系统提示里的,是磁盘上的文件。

从描述里那句"通过 Read 加载"能看出来:技能包是一堆独立文件,需要的时候才读进上下文。

这个设计有实际好处。38 个技能的完整内容如果全塞进系统提示,几万字起步,每次对话都要付这个 token 成本,而且模型在长上下文里更容易"看漏"。

按需加载就不一样了:平时只加载 name 和 description(几百 token),判断需要哪个之后再读全文。这跟我平时查文档的习惯一样——先看目录,再看具体章节。

代价是"判断"这一步变得很重要。目录看不准,就会读错文件,然后答非所问。这也是为什么要分主技能和子技能:主技能其实就是一份更细的目录。

38 个里,我最想要哪一个

说出来可能有点无聊:harmonyos-docs-lookup 和 harmonyos-sdk-api-lookup。

前者是本地文档查询,后者是 SDK API 查询。这俩听着没有 harmonyos-ascf 那么"高级",但它们是日常使用频率最高的。

写鸿蒙代码最耗时间的不是写,是查。一个字段该放哪一层、一个 API 的参数顺序、一个权限要声明在哪——这些答案都在文档里,但文档分散在好几个站点,搜索还经常搜到过时的版本。

如果在编辑器里能直接问"windowStage.loadContent 的第二个参数是什么",而不必切浏览器,一天能省下不少零碎时间。

当然,前提是这份本地文档是新的。鸿蒙的 API 变动快,文档旧了比没有更糟——你会照着错误的答案写,还写得很自信。这一点我没法验证(没登录),只能提醒自己:如果哪天真用上了,先问它一个我已经知道答案的问题,对一下版本。

我手动跑了一遍"环境检查"

既然 AI 面板用不了,我就照着 harmony-development-env-check 的五项,自己查了一遍:

$ /Applications/DevEco-Studio.app/Contents/tools/node/bin/node -v
v24.14.1

$ /usr/libexec/java_home -V
The operation couldn't be completed. Unable to locate a Java Runtime.

$ /Applications/DevEco-Studio.app/Contents/tools/ohpm/bin/ohpm -v
26.0.0.630

$ /Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw -v
6.26.4

四项结果,第三项是"没找到"。

系统里确实没有 JDK。但构建能跑通——因为 DevEco 自带了:

$ /Applications/DevEco-Studio.app/Contents/jbr/Contents/Home/bin/java -version
openjdk version "25.0.2"
OpenJDK Runtime Environment JBR-25.0.2+10-329.117-nomod

这是这次自检最值钱的发现:“系统没有 JDK"不等于"不能用”。 如果你只看 java -version 失败就跑去装 JDK,很可能装了个版本不匹配的,反而把构建搞坏。正确的做法是认 DevEco 自带的那份。

这也说明这类技能的价值不在"查得多深",而在"知道该查什么、查到什么算正常"。五项里有一项的预期是"可以没有",这种判断只有踩过坑的人才会写进去。

技能再全,也绕不过两件事

拆到这里,很容易产生一种错觉:有了这 38 个技能,鸿蒙开发是不是就顺了?

不是。因为技能是"知识与编排",不是"权限"。有两件事它管不了。

第一件是账号。 面板底部那条"登录信息已经过期",让所有技能都停在原地。技能是给登录之后的助手用的,没登录,它就是一份躺在磁盘上的 JSON。

第二件是设备。 我翻了一遍技能描述,harmony-emulator-debugging 确实写了"查询、创建、后台启动和关闭模拟器,检测签名,编译 HAP 并安装启动",deveco-cli 也写了 devecocli run。看起来能跑,但真跑起来还是老的三个条件:有账号、有 profile、有设备。

这就是我在另一条路上撞到的三道关:

在这里插入图片描述

而真正装上去之后,能跑是因为模拟器放行了未签名包:

在这里插入图片描述

这两张图放在这里,是想说明一件事:技能能诊断、能编排,但签名的私钥不在技能里。

harmony-emulator-debugging 描述里那句"检测签名",我理解是"发现你没签名",而不是"替你签"。前者是查,后者需要你的身份。这个边界划得很清楚,只是描述里不会明说。

所以"专属"到底专属在哪

拆完这一圈,我对"码道鸿蒙专属模型"这句话有了自己的理解。

如果只把它理解成"换了个模型权重",那这些技能包就没法解释了——38 个技能、几百条描述、写死的 CLI 命令和 API 名,这些不是模型训出来的,是人写出来的。

我的判断是:"专属"主要体现在三件事上。

一是知识。 比如 harmonyos-ui-multi 明确"不覆盖 2in1/PC",这种边界感来自实践,不是来自语料。

二是编排。 主技能路由到子技能,子技能调 devecocli、调 ascf convert。这套流程串起来,才能把"帮我做个元服务"这种模糊需求变成可执行的步骤。

三是约束。 像 harmonyos-ascf-privacy 那样,把合规要求和具体 API 绑在一起,本质是在防止模型自由发挥——生成一个"看起来对但不合规"的实现。

这三件事,通用模型都能做一部分,但做不全,也做不稳。差距不在"能不能回答",在"回答里有多少是能直接落地的"。

我最后怎么用它

说实话,这一周我基本没用上 AI 面板。原因很俗:没账号。

但我也没有白拆。三个收获:

第一,知道了它的边界在"2in1/PC 之外"。 这直接影响了我的跨端计划——先做手机和平板,别贪 2in1。

第二,把 env-check 的五项变成了自己的检查清单。 现在每次换机器,我先跑这五项,而不是直接构建撞墙。

第三,理解了 devecocli 在生态里的位置。 它不是一个可有可无的 CLI,是技能编排的落点之一——atomic-ascf-convert 和 deveco-cli 都明确指向它。

这三点都是静态拆包拆出来的,没花一分钱账号费。

技能不是越多越好

拆的时候我脑子里冒出一个问题:38 个,是不是有点多?

从产品角度能理解——鸿蒙生态的坑太多太散,每个场景都值得写一份。但从使用角度看,技能数量上去之后,有两个副作用。

第一个是选错。 我这次遇到的场景是"白屏",理论上 harmonyos-ascf-troubleshooting(排障编排)和 harmonyos-ui-multi(布局诊断)都能沾边。如果模型判断成"局部布局问题",它就会走 UI 那条线,而真正的原因是路由表没登记——布局技能再好也查不出来。

所以技能的路由判断,比技能本身的数量更重要。这也是为什么描述里要写"触发场景"和"负面清单":它们在帮模型缩小范围。

第二个是版本漂移。 技能里写死了命令,比如 devecocli build clean。如果哪天 CLI 改了命令名,技能不更新就会误导人。这类问题在文档里也存在,但文档错了人会怀疑一下,技能错了模型会照做——前者有刹车,后者没有。

这两个副作用不是要否定技能包,而是提醒:用之前先确认它的时效。 看到一条"应该这么写"的建议,先想想它是今年写的还是去年写的。

还有一个观察:这 38 个技能里,有相当一部分是给"元服务"准备的。这跟我在公告里看到的"元服务落地"是同一个方向。也就是说,技能包不仅反映了技术能力,也反映了官方希望开发者往哪走。

一点遗憾

最大的遗憾是没能真正跑一次技能。

我特别想试的是 harmonyos-ascf-troubleshooting——它的描述写着"用于构建失败、运行白屏、DevEco 调试失败、Toolkit/Plugin/CLI 报错等场景"。而我这次恰好遇到了一次白屏,并且是花时间自己定位出来的(路由表没登记)。如果当时能让它接手,它会不会更快?

这个问题我答不了。但我可以说:白屏那次的经验,反而让我对这类排障技能有了判断力——它要做的事,说白了就是把"看日志 → 找返回码 → 对配置"这套流程固化下来。这个流程我现在也会了,只是慢一点。

技能的价值大概就在这里:把老手脑子里的流程,变成新手也能走的路。至于走得多快,还得看模型本身。

你自己怎么拆

如果你也想核对,两步就够。

第一步,找日志。 用 CodeArts Agent 打开任意 .ets 文件(只要触发 arkts 语言,插件就会激活),然后看:

~/Library/Application Support/CodeArts Agent/logs/<最新时间戳>/window1/exthost/
  output_logging_*/5-HarmonyBot Traffic.log

这个文件里能看到完整的技能清单,包括 name 和 description。

第二步,看包。 插件目录在:

~/.codearts-doer-for-coding/extensions/huaweideveloperserviceplatform.harmonyosdevassistantforvscode-0.2.4/

resources/opencode/ 下面有 skill 相关的配置,plugin-layer/ 是语言服务那部分。想看主逻辑就解 dist/extension.js,不过那是打包过的,可读性一般——我大部分信息都是从日志里拿的,比读代码省事。

提醒一句:日志里除了鸿蒙技能,还混着一堆 lark-* 的技能(飞书那套)。那是 OpenCode 侧带的通用技能,跟鸿蒙无关,别数进去。我第一次数出 60 多个,就是因为没排除它们。

最后

拆包这件事有点像拆机器。拆之前觉得它是个黑箱,拆之后发现里面是齿轮、皮带、几个螺丝——不神秘,但精妙。

38 个技能不算少,也不算多。真正让我意外的是它们的"写法":不写"你可以做什么",写"遇到什么情况调什么命令"。这种写法对使用者友好,因为它把选择权收走了。

至于"鸿蒙专属模型"和"通用模型"的差距,我没有账号,不能给结论。但从技能包的密度看,至少在这个产品里,专属能力的重心不在模型,在工具链的封装。

这话可能不是官方想听的答案,但它是我拆完之后真正相信的。

如果哪天拿到账号,我想做的第一件事不是让它写代码,而是问它三个问题:鸿蒙的 main_pages.json 里 src 写错了会怎样、deviceTypes 加了 2in1 之后布局要注意什么、signingConfigs 为空时构建会发生什么。

这三个问题的答案我都知道了。问它们,是为了校准——看它答得跟我踩出来的经验对不对得上。对得上,我就敢用它写生产代码;对不上,至少我知道该在哪儿不信它。

这大概就是拆包之后最好的收获:不是多了一个工具,是多了一把尺子。 工具会更新换代,尺子能一直用来量下一次看到的东西。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐