dsh-rokid-aiui

DeepSeek Harness 的 Rokid AIUI 开发套件：一个标准 host 插件，打包了插件本体 + 「AIUI 开发模式」Agent 预设 + 完整的 aiui-dev skill（AIUI/Ink API 参考），dsh plugin add 一条命令装完，重启即用。

• 左下角悬浮「AIUI 开发模式」按钮 → 可拖动预览窗（真实 Ink 浏览器运行时，视口 480×352）
• 右侧项目面板 → 文件树，点击文件查看源码（支持图片内联预览）
• 改项目里的 .ink / WXML / WXSS / JS → 预览保存即自动刷新（aix preview --dev 文件监听 + WebSocket 热更新），无需手动导出快照

目录结构

dsh-rokid-aiui/
├── package.json          # 插件 bundle（dsh.bundle.patch）
├── cordis.patch.yml      # 挂载插件行
├── src/  lib/            # 插件源码 / 构建产物
├── preset/               # 「AIUI 开发模式」Agent 预设（随包分发，启动时自动安装）
│   ├── preset.yml
│   ├── agent.cordis.yml
│   └── skills/aiui-dev/  # AIUI/Ink API 参考 skill（已随包打包，见 THIRD-PARTY-NOTICES.md）
└── THIRD-PARTY-NOTICES.md

前置条件

• 已安装 DeepSeek Harness 的 dsh CLI
• Node ≥ 20

一键安装

只需一条命令（<name> 换成你的 profile 名，例如 web），三种来源任选其一：

# 从 GitHub（推荐，锁定 commit 更安全）
dsh plugin --profile <name> add github:twinkle10010/dsh-rokid-aiui

# 从 npm
dsh plugin --profile <name> add dsh-rokid-aiui

# 从 tarball
pnpm pack
dsh plugin --profile <name> add ./dsh-rokid-aiui-0.2.0.tgz

安装后重启 dsh。插件启动时会把包内自带的 preset/（含 aiui-dev skill）自动同步到 ~/.dsh/.agent-presets/aiui-dev/（即 Harness 的「用户预设根」，无需任何手动复制或下载），之后新建会话即可在预设列表看到 「AIUI 开发模式」。

预设根目录说明：agent-presets 服务总会扫描 $DSH_HOME/.agent-presets（includeUserRoot），插件只是把打包的预设放进去；升级插件后会自动刷新预设文件（以 .dsh-bundle-version 标记判断版本），不会删除你额外添加的文件。

验证安装：

# 1) profile 层包含本插件
dsh --profile <name> --dump-config | grep dsh-rokid-aiui

# 2) 预设已就位（重启 dsh 后）
ls ~/.dsh/.agent-presets/aiui-dev/agent.cordis.yml
ls ~/.dsh/.agent-presets/aiui-dev/skills/aiui-dev/SKILL.md

使用流程

1. 重启 dsh（装完插件后第一次必须重启）。
2. 新建会话 → 选择「AIUI 开发模式」预设。
3. 进入后，左下角出现「AIUI 开发模式」按钮、右侧出现项目面板；若尚未选过项目，会自动弹出「选择 AIUI 项目」对话框。
4. 选项目：从候选列表选，或用「浏览文件夹…」选任意含 app.json 的目录。
5. 选完后：右侧加载文件树；点左下角按钮打开预览窗，实时渲染该项目。
6. 开发：改项目里的 .ink / WXML / WXSS / JS，保存后预览自动热更新，无需手动刷新。
7. 切换项目：点右侧面板「选择项目」重选（或让 agent 重写标记文件后刷新页面），预览服务自动重启指向新项目。

项目标记：默认存于 <workspaceRoot>/.aiui/current-project.json，记录「当前项目」；换项目就是换这个文件的内容。

配置（可选）

在你的 profile 的 cordis.patch.yml 里按 id 覆盖：

- id: aiui-dev-console
  config:
    # 扫描 AIUI 项目（含 app.json 的目录）的根目录；默认 $AIUI_WORKSPACE，再退到启动 dsh 时的目录
    workspaceRoot: 'E:/path/to/your/aiui/projects'
    # 存储「当前项目」的标记文件；默认 <workspaceRoot>/.aiui/current-project.json
    projectFile: 'E:/path/to/current-project.json'
    # 触发控制台显示的预设名称 / id
    presetLabel: 'AIUI 开发模式'
    presetId: 'aiui-dev'

开发 / 重新构建

源码在 src/（TypeScript），构建产物 lib/ 已提交（git 安装免构建授权）。改源码后重新构建：

npm i -D esbuild   # 只需一次
npm run build      # 等价于 node build.mjs

第三方资源

preset/skills/aiui-dev/ 下的 AIUI/Ink API 参考文档按 Apache-2.0 从上游 jsar-project/AIUI 原样打包，出处与刷新方法见 THIRD-PARTY-NOTICES.md。

License

MIT