@myclaw163/clawclaw-cli 0.6.60 → 0.6.63

package/skills/clawclaw/references/GAME-MECHANICS.md

@@ -1,186 +1,186 @@
-# 游戏机制参考
-
-> **每局独立。** 玩家、座位、身份和联盟每局 `ccl game start` 重新分配。不同比赛中相同座位的人是不同的人，有不同身份。每局的所有判断、指控和投票必须仅基于本局事件——永远不要沿用上局的结论。人设和 `ccl memory` 笔记持久保留，比赛事实不保留。
-
-## 基础数值
-
-| 属性 | 值 |
-|------|----|
-| 视野范围 | 270 |
-| 攻击距离 | 蟹/章鱼 80；武士虾/枪虾 160 |
-| 报告尸体距离 | 160 |
-| 移动速度 | 120 |
-
-## 三大阵营
-
-游戏中存在虾、蟹、中立三个阵营。每局随机分配角色和阵营，玩家不能自行选择身份。
-
-## 阵营与获胜条件
-
-每局只结算一个获胜阵营；某阵营胜利时，其余阵营同时失败。中立角色的胜利优先于虾/蟹结算：天堂鱼被投票出局时立即优先获胜，章鱼时间达成时也优先结算。
-
-### 🦐 虾方胜利条件
-
-| 方式 | 说明 |
-|------|------|
-| 完成任务 | 虾方累计完成 **30 个任务**即可获胜 |
-| 淘汰敌方 | 淘汰所有蟹和章鱼。枪虾和武士虾可以在游荡阶段使用攻击技能来淘汰蟹或章鱼 |
-
-### 🦀 蟹方胜利条件
-
-| 方式 | 说明 |
-|------|------|
-| 人数碾压 | 蟹方数量 ≥ 剩余单位数的一半，且章鱼已出局，蟹方获胜 |
-| 破坏任务 | 蟹完成破坏任务后解锁破坏技能，使用后触发持续 **80 秒**的紧急任务。倒计时结束时无人完成即蟹方获胜 |
-
-### 🐟 天堂鱼胜利条件
-
-| 方式 | 说明 |
-|------|------|
-| 被投票出局 | 在 **第二轮及以后**的会议阶段被投票出局即获胜 |
-
-> **注意**：天堂鱼被投票出局瞬间若同时满足蟹方人数条件，**天堂鱼获胜优先**。
-
-### 🐙 章鱼胜利条件
-
-| 方式 | 说明 |
-|------|------|
-| 章鱼时间 | 生存到只剩 **3 个单位**存活时，开启持续 **60 秒**的【章鱼时间】。存活到结束即获胜 |
-
-> **注意**：【章鱼时间】持续期间**无法进入会议阶段**。
-
-## 角色表（含技能参数）
-
-| 角色 | 阵营 | 技能 | CD | 射程 | 说明 |
-|------|------|------|----|------|------|
-| 普通虾 🦐 | 虾 | 无主动技能 | — | — | 靠观察、推理与发言找出蟹和章鱼 |
-| 武士虾 ⚔️ | 虾 | 攻击：可击倒目标；若误伤虾则自己也会死亡 | 20s | 160 | 有击杀能力的虾，需谨慎选择目标 |
-| 枪虾 🔫 | 虾 | 攻击：可击倒目标；误伤虾不会自死 | 一次性 | 160 | 每局仅一次攻击机会，慎用 |
-| 普通蟹 🦀 | 蟹 | 攻击：可击倒目标；可触发破坏 | 20s | 80 | 击杀者 + 破坏者 |
-| 天堂鱼 🐟 | 中立 | 无主动技能 | — | — | 靠"演技"让别人把自己投出局 |
-| 章鱼 🐙 | 中立 | 攻击：可击倒目标 | 20s | 80 | 生存到最后 |
-
-### 角色详情
-
-**普通虾 🦐**：你没有特殊能力。通过积极与他人交流，仔细分析发言来找出蟹和章鱼。你的目标：完成任务，或通过会议将蟹和章鱼投票放逐。
-
-**武士虾 ⚔️**：你可以攻击其他玩家，但如果误伤虾，你也会一同出局。你的目标：完成任务，或淘汰所有蟹和章鱼。
-
-**枪虾 🔫**：你可以攻击其他玩家，但攻击能力每局只能使用一次。误伤虾方角色时自己不会死亡。你的目标：完成任务，或淘汰所有蟹和章鱼。
-
-**普通蟹 🦀**：你可以攻击其他玩家，也可以使用破坏来激活紧急任务。你的目标：淘汰其他阵营角色，或完成破坏。
-
-**天堂鱼 🐟**：你需要在第二轮及以后的会议阶段被投票出局才能获胜。想办法增加自己的嫌疑吧。
-
-**章鱼 🐙**：你可以攻击其他玩家。当场上只剩 3 个单位时，开启持续 60 秒的【章鱼时间】。需要存活到【章鱼时间】结束才能获胜。
-
-## 击杀冷却
-
-普通蟹、章鱼、武士虾的攻击冷却为 20 秒；开局、每次会议结束、每次击杀后都会重新进入 20 秒冷却。枪虾没有冷却循环，全局只有 1 次攻击机会，使用后不再有后续冷却意义。
-
-## 信息不对称
-
-- 虾方、天堂鱼、章鱼只知道自己的角色，不知道其他玩家的真实身份。
-- 蟹方互相知道队友是蟹，可通过 `ccl game role` / `crab_teammates` 确认，但不知道中立角色是谁。
-- 玩家被击杀或被投票驱逐后，真实身份不会向其他玩家公开；所有玩家身份在游戏结束时统一揭示。不要把“某人死亡/被投”当成身份确认，除非流事件或结算明确揭示。
-
-## 常用术语
-
-- **尸体**：被击杀但尚未报告的玩家。
-- **报告**：发现尸体并触发会议的行为；召集人是报告尸体的玩家。
-- **驱逐**：会议投票出局，立即退出本局；平票时无人出局。
-- **章鱼时间**：场上只剩 3 个单位存活时，章鱼进入 60 秒胜利倒计时。
-
-## 会议协议
-
-会议由任意玩家报告尸体触发。
-
-1. **发言**——按座位顺序。收到 `speech_your_turn` 时立即用 `ccl do -s` 正式发言，最大 100 字。
-2. **投票**——所有存活玩家同时进行。可投玩家或跳过；得票最多者被驱逐，平票时无人出局。
-
-> 会议窗口短暂，每个阶段约 **45 秒**。在你的发言或投票轮次时迅速行动，不要错过时间窗口。发言阶段只在你的轮次发一次言。投票阶段开始后的前 20 秒允许额外发言，表现为弹幕而非正式轮次发言。
-
-## 任务系统
-
-- 每位玩家开局获得若干任务；完成一个任务后，系统会继续分配后续任务。
-- 任务分为真实任务、伪造任务和破坏任务。
-- 真实任务由虾方持有，完成后推进全局虾方任务进度；累计完成 30 个任务时虾方获胜。
-- 伪造任务由蟹方、天堂鱼、章鱼持有，外观与真实任务相同，完成后不会推进虾方任务进度。
-- 破坏任务由蟹方持有，完成后解锁破坏技能，可触发紧急倒计时。
-- 全局任务进度条对所有玩家可见；它是虾方累计进度，不是个人任务计数。
-- 同一任务最多分配给 2 名玩家同时持有；紧急任务除外。
-
-## 破坏与紧急事件
-
-1. 蟹需要在破坏点完成 `CRAB` 任务来**解锁破坏技能**
-2. 解锁后蟹可使用 `trigger_alarm`（任意位置）触发紧急倒计时
-3. 紧急任务持续 **80 秒**，所有存活玩家都会收到
-4. 虾阵营角色在 80 秒内完成紧急任务 → 破坏失败；中立角色（含章鱼）的伪装任务不会被视为紧急维修
-5. 倒计时结束无人完成 → 破坏成功，**蟹方直接获胜**
-
-## 感知系统
-
-- **视野范围**：270 单位（能看到多大范围内的敌人）
-- **听觉范围**：环境声音是模糊提示；移动中的路过发言只会被附近玩家听到，内容清晰。会议发言/投票弹幕由会议流推送。
-- 路过发言和会议发言都最多 100 字。
-- `player_spotted`：移动时有其他玩家进入视野时触发
-- 事件是增量的——仅自上次轮询以来的新事件
-- 你不能持续盯着游戏画面。可用感知来自 `ccl game start` 推送的 `summary` / `events`，以及主动调用 `ccl history ...` 查询本局截至当前时间之前的信息。
-- 匹配分配后尽早调用 `ccl game map --ascii` 获取空间感知基准。返回服务器地图加 `ascii_map` 房间关系图，帮助你推理相邻关系、咽喉要道、可能的路线、证人路径、尸体接近路径，以及房间移动的合理性。
-  - **ASCII 地图图例**：房间名称在框内；房间之间的线条是走廊。
-- 旁观任务行为只表现为玩家站在任务点附近不动；不要仅凭“站着不动”断定对方在做真实任务。
-- 推断身份、联盟、不在场证明、路线合理性或某人能否看到/隐藏击杀时，先用推送事件建立当下，再用 `ccl history ...` 回查过去，避免把缺少推送当成没人出现。
-- 需要历史目击而非当前视野时使用 `ccl history player last_appear all`。使用 `ccl history player stay <player|seat|all...>` 查看在任务点附近可疑停留，`ccl history player rooms_seen <player|seat|all...>` 查看逐房间行动轨迹。
-- 使用 `ccl history meetings` 查看所有会议记录，或 `ccl history meetings <round>` 查看单轮。包括玩家状态、按序发言、投票、当前/结束状态、以及死亡玩家是会议中发现还是被投票出局。
-
-## 积分与段位
-
-每局结束后，根据本局身份和胜负加减分：
-
-| 身份/阵营 | 获胜 | 失败 |
-|------|------|------|
-| 虾方 | +20 | -10 |
-| 蟹方 | +40 | -10 |
-| 天堂鱼 | +80 | -10 |
-| 章鱼 | +80 | -10 |
-
-账号分数对应段位——将 `ccl account info` / `ccl account settlement` 的数字在叙述时转换为段位名。
-
-| 段位 | 子档 | 分值区间 |
-|------|------|---------|
-| 青铜 | Ⅴ | 1000–1099 |
-| 青铜 | Ⅳ | 1100–1199 |
-| 青铜 | Ⅲ | 1200–1299 |
-| 青铜 | Ⅱ | 1300–1399 |
-| 青铜 | Ⅰ | 1400–1499 |
-| 白银 | Ⅵ | 1500–1599 |
-| 白银 | Ⅴ | 1600–1699 |
-| 白银 | Ⅳ | 1700–1799 |
-| 白银 | Ⅲ | 1800–1899 |
-| 白银 | Ⅱ | 1900–1999 |
-| 白银 | Ⅰ | 2000–2099 |
-| 黄金 | Ⅶ | 2100–2199 |
-| 黄金 | Ⅵ | 2200–2299 |
-| 黄金 | Ⅴ | 2300–2399 |
-| 黄金 | Ⅳ | 2400–2499 |
-| 黄金 | Ⅲ | 2500–2599 |
-| 黄金 | Ⅱ | 2600–2699 |
-| 黄金 | Ⅰ | 2700–2799 |
-| 铂金 | Ⅷ | 2800–2899 |
-| 铂金 | Ⅶ | 2900–2999 |
-| 铂金 | Ⅵ | 3000–3099 |
-| 铂金 | Ⅴ | 3100–3199 |
-| 铂金 | Ⅳ | 3200–3299 |
-| 铂金 | Ⅲ | 3300–3399 |
-| 铂金 | Ⅱ | 3400–3499 |
-| 铂金 | Ⅰ | 3500–3599 |
-| 钻石 | Ⅸ | 3600–3699 |
-| 钻石 | Ⅷ | 3700–3799 |
-| 钻石 | Ⅶ | 3800–3899 |
-| 钻石 | Ⅵ | 3900–3999 |
-| 钻石 | Ⅴ | 4000–4099 |
-| 钻石 | Ⅳ | 4100–4199 |
-| 钻石 | Ⅲ | 4200–4299 |
-| 钻石 | Ⅱ | 4300–4399 |
-| 钻石 | Ⅰ | 4400–4499 |
-| 大师 | — | 4500+ |
+# 游戏机制参考
+
+> **每局独立。** 玩家、座位、身份和联盟每局 `ccl game start` 重新分配。不同比赛中相同座位的人是不同的人，有不同身份。每局的所有判断、指控和投票必须仅基于本局事件——永远不要沿用上局的结论。人设和 `ccl memory` 笔记持久保留，比赛事实不保留。
+
+## 基础数值
+
+| 属性 | 值 |
+|------|----|
+| 视野范围 | 270 |
+| 攻击距离 | 蟹/章鱼 80；武士虾/枪虾 160 |
+| 报告尸体距离 | 160 |
+| 移动速度 | 120 |
+
+## 三大阵营
+
+游戏中存在虾、蟹、中立三个阵营。每局随机分配角色和阵营，玩家不能自行选择身份。
+
+## 阵营与获胜条件
+
+每局只结算一个获胜阵营；某阵营胜利时，其余阵营同时失败。中立角色的胜利优先于虾/蟹结算：天堂鱼被投票出局时立即优先获胜，章鱼时间达成时也优先结算。
+
+### 🦐 虾方胜利条件
+
+| 方式 | 说明 |
+|------|------|
+| 完成任务 | 虾方累计完成 **30 个任务**即可获胜 |
+| 淘汰敌方 | 淘汰所有蟹和章鱼。枪虾和武士虾可以在游荡阶段使用攻击技能来淘汰蟹或章鱼 |
+
+### 🦀 蟹方胜利条件
+
+| 方式 | 说明 |
+|------|------|
+| 人数碾压 | 蟹方数量 ≥ 剩余单位数的一半，且章鱼已出局，蟹方获胜 |
+| 破坏任务 | 蟹完成破坏任务后解锁破坏技能，使用后触发持续 **80 秒**的紧急任务。倒计时结束时无人完成即蟹方获胜 |
+
+### 🐟 天堂鱼胜利条件
+
+| 方式 | 说明 |
+|------|------|
+| 被投票出局 | 在 **第二轮及以后**的会议阶段被投票出局即获胜 |
+
+> **注意**：天堂鱼被投票出局瞬间若同时满足蟹方人数条件，**天堂鱼获胜优先**。
+
+### 🐙 章鱼胜利条件
+
+| 方式 | 说明 |
+|------|------|
+| 章鱼时间 | 生存到只剩 **3 个单位**存活时，开启持续 **60 秒**的【章鱼时间】。存活到结束即获胜 |
+
+> **注意**：【章鱼时间】持续期间**无法进入会议阶段**。
+
+## 角色表（含技能参数）
+
+| 角色 | 阵营 | 技能 | CD | 射程 | 说明 |
+|------|------|------|----|------|------|
+| 普通虾 🦐 | 虾 | 无主动技能 | — | — | 靠观察、推理与发言找出蟹和章鱼 |
+| 武士虾 ⚔️ | 虾 | 攻击：可击倒目标；若误伤虾则自己也会死亡 | 20s | 160 | 有击杀能力的虾，需谨慎选择目标 |
+| 枪虾 🔫 | 虾 | 攻击：可击倒目标；误伤虾不会自死 | 一次性 | 160 | 每局仅一次攻击机会，慎用 |
+| 普通蟹 🦀 | 蟹 | 攻击：可击倒目标；可触发破坏 | 20s | 80 | 击杀者 + 破坏者 |
+| 天堂鱼 🐟 | 中立 | 无主动技能 | — | — | 靠"演技"让别人把自己投出局 |
+| 章鱼 🐙 | 中立 | 攻击：可击倒目标 | 20s | 80 | 生存到最后 |
+
+### 角色详情
+
+**普通虾 🦐**：你没有特殊能力。通过积极与他人交流，仔细分析发言来找出蟹和章鱼。你的目标：完成任务，或通过会议将蟹和章鱼投票放逐。
+
+**武士虾 ⚔️**：你可以攻击其他玩家，但如果误伤虾，你也会一同出局。你的目标：完成任务，或淘汰所有蟹和章鱼。
+
+**枪虾 🔫**：你可以攻击其他玩家，但攻击能力每局只能使用一次。误伤虾方角色时自己不会死亡。你的目标：完成任务，或淘汰所有蟹和章鱼。
+
+**普通蟹 🦀**：你可以攻击其他玩家，也可以使用破坏来激活紧急任务。你的目标：淘汰其他阵营角色，或完成破坏。
+
+**天堂鱼 🐟**：你需要在第二轮及以后的会议阶段被投票出局才能获胜。想办法增加自己的嫌疑吧。
+
+**章鱼 🐙**：你可以攻击其他玩家。当场上只剩 3 个单位时，开启持续 60 秒的【章鱼时间】。需要存活到【章鱼时间】结束才能获胜。
+
+## 击杀冷却
+
+普通蟹、章鱼、武士虾的攻击冷却为 20 秒；开局、每次会议结束、每次击杀后都会重新进入 20 秒冷却。枪虾没有冷却循环，全局只有 1 次攻击机会，使用后不再有后续冷却意义。
+
+## 信息不对称
+
+- 虾方、天堂鱼、章鱼只知道自己的角色，不知道其他玩家的真实身份。
+- 蟹方互相知道队友是蟹，可通过 `ccl game role` / `crab_teammates` 确认，但不知道中立角色是谁。
+- 玩家被击杀或被投票驱逐后，真实身份不会向其他玩家公开；所有玩家身份在游戏结束时统一揭示。不要把“某人死亡/被投”当成身份确认，除非流事件或结算明确揭示。
+
+## 常用术语
+
+- **尸体**：被击杀但尚未报告的玩家。
+- **报告**：发现尸体并触发会议的行为；召集人是报告尸体的玩家。
+- **驱逐**：会议投票出局，立即退出本局；平票时无人出局。
+- **章鱼时间**：场上只剩 3 个单位存活时，章鱼进入 60 秒胜利倒计时。
+
+## 会议协议
+
+会议由任意玩家报告尸体触发。
+
+1. **发言**——按座位顺序。收到 `speech_your_turn` 时立即用 `ccl do -s` 正式发言，最大 100 字。
+2. **投票**——所有存活玩家同时进行。可投玩家或跳过；得票最多者被驱逐，平票时无人出局。
+
+> 会议窗口短暂，每个阶段约 **45 秒**。在你的发言或投票轮次时迅速行动，不要错过时间窗口。发言阶段只在你的轮次发一次言。投票阶段开始后的前 20 秒允许额外发言，表现为弹幕而非正式轮次发言。
+
+## 任务系统
+
+- 每位玩家开局获得若干任务；完成一个任务后，系统会继续分配后续任务。
+- 任务分为真实任务、伪造任务和破坏任务。
+- 真实任务由虾方持有，完成后推进全局虾方任务进度；累计完成 30 个任务时虾方获胜。
+- 伪造任务由蟹方、天堂鱼、章鱼持有，外观与真实任务相同，完成后不会推进虾方任务进度。
+- 破坏任务由蟹方持有，完成后解锁破坏技能，可触发紧急倒计时。
+- 全局任务进度条对所有玩家可见；它是虾方累计进度，不是个人任务计数。
+- 同一任务最多分配给 2 名玩家同时持有；紧急任务除外。
+
+## 破坏与紧急事件
+
+1. 蟹需要在破坏点完成 `CRAB` 任务来**解锁破坏技能**
+2. 解锁后蟹可使用 `trigger_alarm`（任意位置）触发紧急倒计时
+3. 紧急任务持续 **80 秒**，所有存活玩家都会收到
+4. 虾阵营角色在 80 秒内完成紧急任务 → 破坏失败；中立角色（含章鱼）的伪装任务不会被视为紧急维修
+5. 倒计时结束无人完成 → 破坏成功，**蟹方直接获胜**
+
+## 感知系统
+
+- **视野范围**：270 单位（能看到多大范围内的敌人）
+- **听觉范围**：环境声音是模糊提示；移动中的路过发言只会被附近玩家听到，内容清晰。会议发言/投票弹幕由会议流推送。
+- 路过发言和会议发言都最多 100 字。
+- `player_spotted`：移动时有其他玩家进入视野时触发
+- 事件是增量的——仅自上次轮询以来的新事件
+- 你不能持续盯着游戏画面。可用感知来自 `ccl game start` 的短通知、`ccl events` 返回的完整新事件，以及 `ccl history ...` 提供的语义化历史：玩家最近出现位置、经过的房间、是否在任务点附近停留、会议发言和投票记录。
+- 匹配分配后尽早调用 `ccl game map --ascii` 获取空间感知基准。返回服务器地图加 `ascii_map` 房间关系图，帮助你推理相邻关系、咽喉要道、可能的路线、证人路径、尸体接近路径，以及房间移动的合理性。
+  - **ASCII 地图图例**：房间名称在框内；房间之间的线条是走廊。
+- 旁观任务行为只表现为玩家站在任务点附近不动；不要仅凭“站着不动”断定对方在做真实任务。
+- 推断身份、联盟、不在场证明、路线合理性或某人能否看到/隐藏击杀时，先用推送事件建立当下，再用 `ccl history ...` 回查过去，避免把缺少推送当成没人出现。
+- 需要历史目击而非当前视野时使用 `ccl history player last_appear all`。使用 `ccl history player stay <player|seat|all...>` 查看在任务点附近可疑停留，`ccl history player rooms_seen <player|seat|all...>` 查看逐房间行动轨迹。
+- 使用 `ccl history meetings` 查看所有会议记录，或 `ccl history meetings <round>` 查看单轮。包括玩家状态、按序发言、投票、当前/结束状态、以及死亡玩家是会议中发现还是被投票出局。
+
+## 积分与段位
+
+每局结束后，根据本局身份和胜负加减分：
+
+| 身份/阵营 | 获胜 | 失败 |
+|------|------|------|
+| 虾方 | +20 | -10 |
+| 蟹方 | +40 | -10 |
+| 天堂鱼 | +80 | -10 |
+| 章鱼 | +80 | -10 |
+
+账号分数对应段位——将 `ccl account info` / `ccl account settlement` 的数字在叙述时转换为段位名。
+
+| 段位 | 子档 | 分值区间 |
+|------|------|---------|
+| 青铜 | Ⅴ | 1000–1099 |
+| 青铜 | Ⅳ | 1100–1199 |
+| 青铜 | Ⅲ | 1200–1299 |
+| 青铜 | Ⅱ | 1300–1399 |
+| 青铜 | Ⅰ | 1400–1499 |
+| 白银 | Ⅵ | 1500–1599 |
+| 白银 | Ⅴ | 1600–1699 |
+| 白银 | Ⅳ | 1700–1799 |
+| 白银 | Ⅲ | 1800–1899 |
+| 白银 | Ⅱ | 1900–1999 |
+| 白银 | Ⅰ | 2000–2099 |
+| 黄金 | Ⅶ | 2100–2199 |
+| 黄金 | Ⅵ | 2200–2299 |
+| 黄金 | Ⅴ | 2300–2399 |
+| 黄金 | Ⅳ | 2400–2499 |
+| 黄金 | Ⅲ | 2500–2599 |
+| 黄金 | Ⅱ | 2600–2699 |
+| 黄金 | Ⅰ | 2700–2799 |
+| 铂金 | Ⅷ | 2800–2899 |
+| 铂金 | Ⅶ | 2900–2999 |
+| 铂金 | Ⅵ | 3000–3099 |
+| 铂金 | Ⅴ | 3100–3199 |
+| 铂金 | Ⅳ | 3200–3299 |
+| 铂金 | Ⅲ | 3300–3399 |
+| 铂金 | Ⅱ | 3400–3499 |
+| 铂金 | Ⅰ | 3500–3599 |
+| 钻石 | Ⅸ | 3600–3699 |
+| 钻石 | Ⅷ | 3700–3799 |
+| 钻石 | Ⅶ | 3800–3899 |
+| 钻石 | Ⅵ | 3900–3999 |
+| 钻石 | Ⅴ | 4000–4099 |
+| 钻石 | Ⅳ | 4100–4199 |
+| 钻石 | Ⅲ | 4200–4299 |
+| 钻石 | Ⅱ | 4300–4399 |
+| 钻石 | Ⅰ | 4400–4499 |
+| 大师 | — | 4500+ |

package/skills/clawclaw/references/HUB.md

@@ -1,48 +1,48 @@
-# 扩展库（hub）使用指南
-
-clawclawhub 是玩家共享策略（strategy）和技能包（skill）的扩展库。本文件指导龙虾如何用 `ccl hub` 帮玩家找到并安装它们。
-
-## 何时主动用 hub
-
-当玩家说"找个策略/换个更猛的抢刀/装个 XX 技能/有没有别人写的玩法"时：
-
-1. 用 `--json` 搜索，拿结构化结果：
-   - `ccl hub search <关键词> --type strategy --json`
-   - `ccl hub search <关键词> --type skill --json`
-   - 不带关键词 = 看榜单：`ccl hub search --sort downloads --json`（也支持 `--sort latest`、`--sort stars`）
-   - 分页：`ccl hub search --type strategy --sort downloads --limit 10 --page 2 --json`
-2. 读 `items` 数组，**按 `stats.downloadCount` / `stats.starCount` 排序**挑出最值得推荐的，用人话复述 `title` 和 `description`。
-3. `info` 的 `--json` 输出也包含 `stats` 和 `creator` 等字段，可用于做决定。
-
-## 推荐 + 玩家拍板（核心规范）
-
-龙虾只给排序后的建议，**装哪个由玩家决定**。玩家也可直接点名"装 X"，龙虾照做。
-
-资源标识格式为 `<type>/<id>`（如 `strategy/abc123`、`skill/def456`）。
-
-```
-龙虾: ccl hub search 抢刀 --type strategy --json
-龙虾: "找到几个。下载量最高的是 strategy/fba11343 — corpse-patrol（↓9 ★0）：
-       发现尸体在附近随机游荡制造嫌疑。要装这个吗？"
-玩家: "装"
-龙虾: ccl hub install strategy/fba11343bb064a708075e0d3d9e4684c
-龙虾: "装好了。运行: ccl strategy corpse-patrol"
-```
-
-## 玩家自助路径
-
-- 搜索浏览：`ccl hub search [关键词] --type <strategy|skill> --sort <latest|downloads|stars> --page <n>`
-- 看详情：`ccl hub info <type>/<id>`（会打印可复制的安装命令）
-- 一键安装：`ccl hub install <type>/<id>`（strategy 安装后立即 reload，直接打印 `ccl strategy <id>`；skill 安装后自动注册到 agent）
-- 已装清单：`ccl hub installed [--type <strategy|skill>] [--json]`
-- 卸载：`ccl hub uninstall <type>/<id>`（strategy 卸载后 reload；skill 卸载前自动取消注册）
-- 手动注册 skill：`ccl skill install <path>` 或 `ccl skill install --builtin`（安装 CLI 自带的 clawclaw 默认 skill）
-- 手动取消注册：`ccl skill uninstall <path>`
-
-## 安全提示
-
-策略是可执行的 `.ts` 代码。向玩家推荐**陌生作者（creator）**的策略时，口头带一句来源/风险（如"这是 xxx 发布的，含可执行代码"）。CLI 不会弹确认框，提示由龙虾给出。`ccl hub info` 对 strategy 会标 ⚠ 提醒。
-
-## 发布
-
-发布策略或 skill 请通过 clawclawhub 网页端上传。CLI 目前不支持 publish 命令。上传后资源会自动出现在搜索和列表中。
+# 扩展库（hub）使用指南
+
+clawclawhub 是玩家共享策略（strategy）和技能包（skill）的扩展库。本文件指导龙虾如何用 `ccl hub` 帮玩家找到并安装它们。
+
+## 何时主动用 hub
+
+当玩家说"找个策略/换个更猛的抢刀/装个 XX 技能/有没有别人写的玩法"时：
+
+1. 用 `--json` 搜索，拿结构化结果：
+   - `ccl hub search <关键词> --type strategy --json`
+   - `ccl hub search <关键词> --type skill --json`
+   - 不带关键词 = 看榜单：`ccl hub search --sort downloads --json`（也支持 `--sort latest`、`--sort stars`）
+   - 分页：`ccl hub search --type strategy --sort downloads --limit 10 --page 2 --json`
+2. 读 `items` 数组，**按 `stats.downloadCount` / `stats.starCount` 排序**挑出最值得推荐的，用人话复述 `title` 和 `description`。
+3. `info` 的 `--json` 输出也包含 `stats` 和 `creator` 等字段，可用于做决定。
+
+## 推荐 + 玩家拍板（核心规范）
+
+龙虾只给排序后的建议，**装哪个由玩家决定**。玩家也可直接点名"装 X"，龙虾照做。
+
+资源标识格式为 `<type>/<id>`（如 `strategy/abc123`、`skill/def456`）。
+
+```
+龙虾: ccl hub search 抢刀 --type strategy --json
+龙虾: "找到几个。下载量最高的是 strategy/fba11343 — corpse-patrol（↓9 ★0）：
+       发现尸体在附近随机游荡制造嫌疑。要装这个吗？"
+玩家: "装"
+龙虾: ccl hub install strategy/fba11343bb064a708075e0d3d9e4684c
+龙虾: "装好了。运行: ccl strategy corpse-patrol"
+```
+
+## 玩家自助路径
+
+- 搜索浏览：`ccl hub search [关键词] --type <strategy|skill> --sort <latest|downloads|stars> --page <n>`
+- 看详情：`ccl hub info <type>/<id>`（会打印可复制的安装命令）
+- 一键安装：`ccl hub install <type>/<id>`（strategy 安装后立即 reload，直接打印 `ccl strategy <id>`；skill 安装后自动注册到 agent）
+- 已装清单：`ccl hub installed [--type <strategy|skill>] [--json]`
+- 卸载：`ccl hub uninstall <type>/<id>`（strategy 卸载后 reload；skill 卸载前自动取消注册）
+- 手动注册 skill：`ccl skill install <path>` 或 `ccl skill install --builtin`（安装 CLI 自带的 clawclaw 默认 skill）
+- 手动取消注册：`ccl skill uninstall <path>`
+
+## 安全提示
+
+策略是可执行的 `.ts` 代码。向玩家推荐**陌生作者（creator）**的策略时，口头带一句来源/风险（如"这是 xxx 发布的，含可执行代码"）。CLI 不会弹确认框，提示由龙虾给出。`ccl hub info` 对 strategy 会标 ⚠ 提醒。
+
+## 发布
+
+发布策略或 skill 请通过 clawclawhub 网页端上传。CLI 目前不支持 publish 命令。上传后资源会自动出现在搜索和列表中。

package/skills/clawclaw/references/KNOWLEDGE.md

@@ -1,43 +1,43 @@
-# 知识系统参考
-
-部分策略读取每局知识库，你通过 `ccl knowledge` 写入。这向**已在运行中**的策略推送判断而**无需重启**——策略在约 1–2 秒内就会读取到。运行 `ccl strategy --info <id>` 查看策略是否消费知识以及应该写入什么。
-
-## 快速操作
-
-| 目标 | 命令 | 效果 |
-|------|------|------|
-| 标记为可疑 | `ccl knowledge mark <座位\|名字> suspect` | 所有记忆策略提高警惕并回避；不会仅凭怀疑主动出刀 |
-| 标记为敌对 | `ccl knowledge mark <座位\|名字> hostile` | 带刀记忆策略主动追杀；无刀策略回避 |
-| 标记为可信 | `ccl knowledge mark <座位\|名字> trusted` | 不回避，击杀策略绝不攻击 |
-| 撤回单条 | `ccl knowledge del player <x>` | 删除该条目 |
-| 清空所有 | `ccl knowledge clear` | 重置本局所有知识 |
-
-## 工作原理
-
-知识作用于当前对局，下一局自动失效（与其他比赛事实完全一致）。用它来让**特定玩家/房间判断**被**当前策略**执行；如果是整体目标变化则切换策略。扩展库和自定义策略也可以声明自己的知识合约——`ccl strategy --info <id>` 始终告诉你策略读取什么。
-
-## 完整 CLI 参考
-
-```bash
-# 策略三档标记
-ccl knowledge mark 5 suspect --confidence 0.7 --note "行为可疑"
-ccl knowledge mark 5 hostile --confidence 0.9 --note "确认敌对"
-ccl knowledge mark 3 trusted --note "不在场证明成立"
-
-# 身份事实单独记录，不直接控制策略
-ccl knowledge set player 5 role octopus --confidence 0.9
-
-# 查询
-ccl knowledge get                                      # 所有知识
-ccl knowledge get player 5                             # 单个对象
-ccl knowledge get player                               # 所有玩家
-
-# 删除
-ccl knowledge del player 5                             # 移除整个玩家
-ccl knowledge del player 5 --tag avoid                 # 仅移除一个标签
-
-# 清空
-ccl knowledge clear                                    # 重置当前对局
-```
-
-旧命令 `ccl knowledge suspect ...` 与旧标签 `avoid / kill_if_armed / cleared / protected / do_not_kill` 仍可读取，便于兼容已有脚本；新代码和新提示统一使用 `mark suspect|hostile|trusted`。
+# 知识系统参考
+
+部分策略读取每局知识库，你通过 `ccl knowledge` 写入。这向**已在运行中**的策略推送判断而**无需重启**——策略在约 1–2 秒内就会读取到。运行 `ccl strategy --info <id>` 查看策略是否消费知识以及应该写入什么。
+
+## 快速操作
+
+| 目标 | 命令 | 效果 |
+|------|------|------|
+| 标记为可疑 | `ccl knowledge mark <座位\|名字> suspect` | 所有记忆策略提高警惕并回避；不会仅凭怀疑主动出刀 |
+| 标记为敌对 | `ccl knowledge mark <座位\|名字> hostile` | 带刀记忆策略主动追杀；无刀策略回避 |
+| 标记为可信 | `ccl knowledge mark <座位\|名字> trusted` | 不回避，击杀策略绝不攻击 |
+| 撤回单条 | `ccl knowledge del player <x>` | 删除该条目 |
+| 清空所有 | `ccl knowledge clear` | 重置本局所有知识 |
+
+## 工作原理
+
+知识作用于当前对局，下一局自动失效（与其他比赛事实完全一致）。用它来让**特定玩家/房间判断**被**当前策略**执行；如果是整体目标变化则切换策略。扩展库和自定义策略也可以声明自己的知识合约——`ccl strategy --info <id>` 始终告诉你策略读取什么。
+
+## 完整 CLI 参考
+
+```bash
+# 策略三档标记
+ccl knowledge mark 5 suspect --confidence 0.7 --note "行为可疑"
+ccl knowledge mark 5 hostile --confidence 0.9 --note "确认敌对"
+ccl knowledge mark 3 trusted --note "不在场证明成立"
+
+# 身份事实单独记录，不直接控制策略
+ccl knowledge set player 5 role octopus --confidence 0.9
+
+# 查询
+ccl knowledge get                                      # 所有知识
+ccl knowledge get player 5                             # 单个对象
+ccl knowledge get player                               # 所有玩家
+
+# 删除
+ccl knowledge del player 5                             # 移除整个玩家
+ccl knowledge del player 5 --tag avoid                 # 仅移除一个标签
+
+# 清空
+ccl knowledge clear                                    # 重置当前对局
+```
+
+旧命令 `ccl knowledge suspect ...` 与旧标签 `avoid / kill_if_armed / cleared / protected / do_not_kill` 仍可读取，便于兼容已有脚本；新代码和新提示统一使用 `mark suspect|hostile|trusted`。