KKZ 插件指令汇总
更新时间：2026-08-31

符号说明：
<内容>  表示必须填写
[内容]  表示可以省略

======================================================================
一、生图插件
======================================================================

1. AI 自然语言生图

直接告诉机器人想画什么，不需要固定格式。

示例：
帮我画一张可可子在雨后的车站撑透明伞的插画，竖图，中等质量。

可描述人物与动作、场景与构图、画面风格、横竖比例、质量要求、
已配置人物名称或别名，以及引用历史消息中的图片。


2. 提交生图任务

/生图 <画面描述>
/绘图 <画面描述>
/draw <画面描述>

示例：
/生图 一只戴宇航头盔的橘猫，儿童绘本风格

说明：
- /绘图 和 /draw 是 /生图 的别名。
- 指令后面的全部文字都视为生图提示词。
- 使用管理员设置的默认尺寸和默认质量，不需要额外填写尺寸参数。
- 任务提交后在后台生成，完成后机器人会主动发送图片。
- 命中已配置人物名称或别名时，会自动携带人物参考图。


3. 查看人物参考清单

/生图人物
/生图角色

返回人物名称、人物别名和当前可用参考图数量。


4. 查看任务、队列和配额

/生图状态
/生图配额

返回内容包括：
- 全局、当前用户和当前群聊的任务数量
- 任务编号与任务来源
- 生图尺寸、当前阶段和已用时间
- 用户调用配额与用户成功生图配额
- 群聊成功生图配额
- 全局并发情况


5. 引用历史图片生图

先回复或引用一条包含图片的历史消息，然后发送自然语言要求或 /生图 指令。

示例：
参考这张图片的人物外观，画成在海边看日落的场景。

/生图 参考引用图片中的人物外观，画成冬日雪景插画

规则：
- 默认最多使用 2 张引用图片。
- 引用图片和固定人物参考图共同计算数量上限。
- 支持 PNG、JPEG 和 WebP。
- 引用图片只用于当前任务，不会保存进人物图库。
- 只读取被引用历史消息里的图片，不自动读取当前消息直接附加的图片。
- 图片失效、过大或格式不支持时，机器人会明确提示。


6. 生图后台阶段

等待调度
检查权限与配额
读取引用图片
安全审核
生成图片
发送图片
生成评价

生图过程中可随时使用 /生图状态 查看进度。


生图指令速查：

/生图 <描述>       提交生图任务
/绘图 <描述>       /生图 的中文别名
/draw <描述>       /生图 的英文别名
/生图人物           查看人物参考清单
/生图角色           /生图人物 的别名
/生图状态           查看任务进度、队列和配额
/生图配额           /生图状态 的别名


======================================================================
二、六爻起卦插件
======================================================================

1. 通过 AI 起卦和断卦

消息必须以“可可子”开头，插件会据此识别并唤醒可可子。
后面的内容没有固定句式，只要 AI 能识别出起卦需求即可。
目前建议在消息中直接提到“起卦”。

推荐格式：
可可子，帮我起卦看下……

示例：
可可子，帮我起卦看下今年能不能换工作。
可可子，帮我起卦看看这段感情能否继续。
可可子，起卦看下最近财运。
可可子，帮我起卦，我没有指定方向，你根据问题判断。
可可子，我手摇的结果是 7 8 9 6 7 8，帮我起卦断一下。
可可子，用乾为天静卦看看这个项目。


2. 查看帮助

/六爻
/六爻 help
/六爻 帮助
/六爻 说明


3. 即时天机起卦

/六爻 <问卦内容>
/六爻 <方向> <问卦内容>
/六爻 即时 [方向] [问题]

示例：
/六爻 今年适合换工作吗
/六爻 事业 今年适合换工作吗
/六爻 即时 感情 这段关系能否继续


4. /起卦 六爻 等价入口

/六爻 ...
/起卦 六爻 ...

以上两种入口功能完全相同。

示例：
/起卦 六爻 今年适合换工作吗
/起卦 六爻 即时 财富 最近财运如何
/起卦 六爻 手动 7 8 9 6 7 8 感情 这段关系能否继续
/起卦 六爻 手动 天风姤 事业 是否应该接受新工作


5. 手动输入六个爻值

/六爻 手动 <六个爻值> [方向] [问题]

六个数字按照“初爻到上爻”，即从下往上的顺序填写。

6 = 老阴，会变爻
7 = 少阳，不变爻
8 = 少阴，不变爻
9 = 老阳，会变爻

示例：
/六爻 手动 7 8 9 6 7 8 事业 这个项目能否成功


6. 手动输入三枚铜币结果

/六爻 手动 <六组三枚铜币结果> [方向] [问题]

六组结果同样按照“初爻到上爻”的顺序填写。

正、字、阳、H = 3
反、花、阴、T = 2

示例：
/六爻 手动 正反反 正正反 正正正 反反反 正反反 正正反 感情 能否复合


7. 手动指定卦名

/六爻 手动 <卦名> [方向] [问题]

支持的卦名形式：
乾
乾为天
天风姤
第1卦
䷀

示例：
/六爻 手动 乾 事业 项目能否推进
/六爻 手动 乾为天 财富 这笔投资结果如何
/六爻 手动 天风姤 感情 这段关系如何发展
/六爻 手动 第1卦 综合 近期运势如何

直接指定卦名时，按照无动爻静卦处理。


8. 支持的问卦方向

综合
事业
感情
财富
学业
健康
家庭
出行

方向可以省略。通过 AI 起卦时，如果没有指定方向，可可子会根据问题自动判断。

示例：
/六爻 事业 今年能否升职
/六爻 感情 对方是否愿意复合
/六爻 财富 这笔回款能否到账
/六爻 学业 这次考试能否通过
/六爻 健康 近期身体恢复情况如何
/六爻 家庭 家宅近期是否安稳
/六爻 出行 这次远行是否顺利


9. 当前群六爻功能开关

/六爻 开
/六爻 关
/六爻 状态

等价指令：
/起卦 六爻 开
/起卦 六爻 关
/起卦 六爻 状态

兼容旧版写法：
/六爻 开关 开
/六爻 开关 关
/六爻 开关 状态

开关只允许以下身份操作：
- QQ 群主
- QQ 群管理员
- 可可子 管理员

普通群成员不能修改开关。


10. 六爻兼容指令别名

即时起卦：
/六爻 天机 [方向] [问题]
/六爻 instant [方向] [问题]

手动起卦：
/六爻 铜币 <手动结果>
/六爻 manual <手动结果>

开启功能：
/六爻 开启
/六爻 启用
/六爻 on

关闭功能：
/六爻 关闭
/六爻 停用
/六爻 off

查询状态：
/六爻 status

根指令英文别名：
/liunyao ...
/divination liunyao ...

网站和日常使用建议优先采用中文标准指令。


11. 六爻使用限制

- 插件目前仅支持 QQ 群聊。
- 必须先由 QQ 群主、群管理员或 可可子管理员开启当前群的六爻功能。
- 普通指令生图成功后只发送排盘图，不再重复发送排盘文字。
- 生图失败时才返回完整文字排盘。
- 卦例默认按群隔离，不会直接向其他群返回起卦人信息。


======================================================================
三、内部工具（普通用户不需要手动输入）
======================================================================

生图工具：

generate_image
由聊天 AI 自动调用，不是用户指令。


六爻工具：

cast_liuyao
即时或手动起卦、发送排盘图并建立卦例。

lookup_zhouyi_text
查询指定卦的卦辞或爻辞原文。

search_liuyao_cases
检索问题、方向或卦象相近的历史卦例。

record_liuyao_feedback
把用户后续反馈追加到对应卦例。

工具签名：

cast_liuyao(
  mode,
  intent,
  question,
  manual_lines,
  agent_name
)

lookup_zhouyi_text(
  hexagram,
  line
)

search_liuyao_cases(
  query,
  intent,
  hexagram,
  limit
)

record_liuyao_feedback(
  feedback,
  case_id,
  outcome
)

反馈结果分类：
应验
部分应验
未应验
进行中
未分类