Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@

## 2026-11

- 11-19 配置全景的待处理里,「联动开着但没有 hooks」那一条有了「修复」按钮:确认一次就把 hooks 装回去,图上那条断线随即变回来(WSL 那条在后台装,装完自己更新)。从页面或设置进程关掉联动通道时,肥鱼自己装的 hooks 也会一起卸掉,和右键菜单关闭一样
- 11-19 Claude Code 联动、会话小鱼、「最近的对话」的设置搬到了配置全景(四块磁贴各带「设置」)。「最近的对话」最多留几天 / 几条这两项以前只能手改 config.json,现在也能改了。右键「Agent 联动」里只剩开关:上限 / 保留天数 / 配色 / 字号 / 桂冠 / 行数那六个子菜单换成一条「会话小鱼设置…」
- 11-18 右键菜单更短了:「播放动画」「切换角色」「播放速率」「大小」收进了「肥鱼控制」子菜单最上面一组。自己改过菜单编排的不受影响
- 11-18 右键菜单去掉了「快捷启动」和「工具与帮助」(里面只剩一个打开上游仓库的「GitHub 项目页」),设置窗口「菜单」里的「快捷启动」一栏也一起删了。旧的菜单编排里有这几项的,下次加载自动清掉
Expand Down
6 changes: 6 additions & 0 deletions docs/adr/0006-writing-hooks-needs-consent.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,3 +23,9 @@
- 全新安装之后「联动开着但没有 hooks」是常态,直到用户同意一次。
- 运行中被卸掉的 hooks,要到下次启动肥鱼或重新开关联动才会提示。
- hook 事件表加了新事件,老用户会看到缺失提示,重新同意一次才装上。

## 补记(2026-11-19)

配置全景的待处理里有了「修复」按钮:同意框是页面上的 `confirm()`,文案和上面那个弹窗一样,点「取消」什么都不发;
点「确定」才 `POST /api/actions/repair_hooks`,主进程只做「装」那一半(`install_hooks_consented`)。这仍是「用户明确同意之后才写」
那一条路,只是同意框从桌面搬到了用户正看着的页面。打开通道的开关(菜单或页面)照旧只起监视器,不写 hooks。
37 changes: 35 additions & 2 deletions docs/config-panorama.md
Original file line number Diff line number Diff line change
Expand Up @@ -240,8 +240,41 @@ sequenceDiagram
开关留在菜单(通道、每个会话一只小鱼、记录最近的对话),上限 / 保留天数 / 配色 / 字号 / 桂冠 / 行数换成一条「会话小鱼设置…」
(`SpriteMenuFacade.open_session_fish_settings` → `open_config_panorama(focus="session_fish")`,会话小鱼自己的菜单同一条)。
页面改完的生效链:`_apply_external_config_change` → 各窗 `refresh_pet_settings` → `AgentLinkManager.apply_config` 启停监视器
(**从不写 hooks**,ADR 0006;装 hooks 的「修复」动作是下一步);`OverlayShell.refresh_settings` → `_sync_session_settings`:
关掉开关在场的会话小鱼离场、核对一次名册(保留天数)、换桂冠、岛上列表重取,「最近的对话」的保留天数 / 条数真变了才重扫一遍 transcript。
(**从不写 hooks**,ADR 0006;hooked 通道「在跑 → 停」时顺带卸掉肥鱼自己装的 hooks,和菜单关闭一样);
`OverlayShell.refresh_settings` → `_sync_session_settings`:关掉开关在场的会话小鱼离场、核对一次名册(保留天数)、换桂冠、
岛上列表重取,「最近的对话」的保留天数 / 条数真变了才重扫一遍 transcript。

### 动作:待处理里的「修复」

页面上第一个**不是改设置、而是请主进程做一件事**的入口(2026-11-19):联动开着、那一侧的 `settings.json` 里却没有肥鱼的 hooks 时,
待处理里那一条和 `settings.json` 磁贴的详情各出一个「修复」按钮。

```mermaid
sequenceDiagram
participant P as 页面(repair.js)
participant H as 本机服务
participant G as 主进程界面线程
participant F as ~/.claude/settings.json
P->>P: confirm():同意文案(同右键菜单那条路的 Qt 弹框);取消什么都不发
P->>H: POST /api/actions/repair_hooks {agent: claude | claude_wsl}
H->>G: on_gui(和改设置同一条路)
G->>F: AgentLinkManager.install_hooks_consented(agent)
Note over G: 本机当场写 → installed;WSL 后台起 wsl.exe → pending,装完发 install_finished
G-->>P: {state: installed | pending | failed}
G->>G: 装好的那一侧重探一次(PanoramaService.refresh(side)),发布,页面原地重画,那条线变回来
```

- **动作是独立的 POST,不藏在 PATCH 设置里**:打开通道的开关永远只是起监视器,装 hooks 永远是另一次明确的点击(ADR 0006 的决定不变,
只是同意框从桌面搬到了用户正看着的页面;ADR 末尾有补记)。服务端拿到请求就视为「用户点了是」,只调管理器的「装」那一半
(`install_hooks_consented`),不再弹 Qt 的问题框;菜单那条路仍是 `set_enabled` 先问再调同一个「装」。
- **登记**:`actions.py` 里一个处理器 `handler(body) -> dict`,应用构造 `PanoramaService` 时传 `actions={"repair_hooks": ...}`;
路由 `POST /api/actions/<名字>` 把它转到界面线程。处理器自己校验参数(只认两条 hooked 通道,400 `bad_agent`;没有管理器 503
`no_manager`),不认识的名字 404,处理器出错 500 `action_failed`。以后「重新测试连接」走同一个口。
- **装完重探**:`_republish` 只重读功能、不重探,而 hooks 在不在是探针读文件得来的。`PanoramaService.refresh(side)` 只重探一侧
(`win` 重跑 Windows 探针、接上上一次的 WSL 结果;`wsl` 只换那一半),在后台线程里,不开浏览器;一轮完整采集正在路上就不另起。
WSL 那条装完由 `install_finished` 信号触发重探(处理器对同一个管理器只接一次)。
- **页面**:`repair.js` 的 `actionButton` / `runAction`;结果写在按钮上(`installed` / `pending` / `failed` 可再点 / 连不上可再点)。
离线快照里按钮是灰的。待处理项在数据里多一个 `action: {name, agent, side}`(`Graph.quest(..., action=)`),别的待处理项没有。

```mermaid
flowchart LR
Expand Down
2 changes: 1 addition & 1 deletion docs/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ flowchart LR
- [x] 个人助理
- [x] 会话记忆蒸馏(个人侧与公司侧)
- [x] ~~文件解读、看屏幕~~ 2026-11-18 定:不搬,两个功能整个删掉([ADR 0016](adr/0016-drop-screen-watching-and-file-interpret.md))
- [ ] Claude Code 联动与 hooks 修复动作
- [x] Claude Code 联动与 hooks 修复动作
- [ ] 模型服务列表与密钥、连接测试

### M5 能编辑:记忆与知识
Expand Down
9 changes: 7 additions & 2 deletions docs/session-fish.md
Original file line number Diff line number Diff line change
Expand Up @@ -151,8 +151,13 @@ stateDiagram-v2

- 一个通道的监视器从「没在跑」变成「在跑」时查一次:延迟 5 s,后台线程只读(WSL 是一次 `wsl.exe`),结果经 `hooks_checked` 信号回 GUI 线程。
延迟是因为气泡只发给可见的窗,本机检查不到 1 ms 就有结论,那时鱼还没出场。已经在跑的通道、别的设置变化引起的 `apply_config` 不再查。
- 缺任何一个事件就冒一条气泡(也进灵动岛的消息记录),并在右键 → Agent 联动里那个通道下面多一条修复项。
修复项 = `repair_hooks` = `set_enabled(通道, True)`:弹的是同一个同意框,点「否」什么都不写、联动也不会被关。
- 缺任何一个事件就冒一条气泡(也进灵动岛的消息记录),并在右键 → Agent 联动里那个通道下面多一条修复项;配置全景的待处理里
那一条和 `settings.json` 磁贴也出「修复」按钮(2026-11-19,见[配置全景](config-panorama.md)的「动作」)。
菜单的修复项 = `repair_hooks` = `set_enabled(通道, True)`:弹的是同一个同意框,点「否」什么都不写、联动也不会被关。
页面的「修复」= 页面上先 `confirm()` 同一段文案,再 `POST /api/actions/repair_hooks` → `install_hooks_consented(通道)`:
只管「装」那一半,不再弹 Qt 的框。两条路写文件的代码是同一段。
- 通道从别处(配置全景、设置进程)被关掉:`apply_config` 停监视器时顺带卸掉肥鱼自己装的 hooks(只在「在跑 → 停」这一次转换上做,
别的实例还在用就留着),和菜单关闭的语义一致。
- 判断不了就不说:那一侧没有 `~/.claude`、WSL 没响应、`settings.json` 不是合法 JSON。
- 每个通道一个轮次计数,装好或通道停下时加一;迟到的检查结论对不上轮次就丢,避免装好之后又冒一条过期提示。
- 只看有没有肥鱼的条目,不核对条目指向的路径。旧 `PetWindow` 的菜单没有修复项(只修崩溃的约定),气泡有。
Expand Down
94 changes: 57 additions & 37 deletions pet/agent_link.py
Original file line number Diff line number Diff line change
Expand Up @@ -2923,6 +2923,10 @@ def apply_config(self) -> None:
elif not should_run and monitor._running:
monitor.stop()
self._forget_hooks_state(key)
if key in self._HOOKED_AGENTS:
# 通道从别处(配置全景、设置进程)被关掉:和菜单关闭一样卸掉肥鱼自己装的 hooks(同意文案里写着
# 「关闭联动时会自动移除」)。只在「在跑 → 停」这一次转换上做,启动时的 apply_config 不碰文件。
self._uninstall_hooks(key)
self._refresh_moved_hooks(agent_cfg)

# ---------------------------------------------------------- 联动开着、hooks 在不在
Expand All @@ -2939,6 +2943,52 @@ def repair_hooks(self, agent_key: str) -> bool:
return False
return self.set_enabled(agent_key, True)

def install_hooks_consented(self, agent_key: str) -> str:
"""用户**已经同意**(菜单那条路的 Qt 弹框,或配置全景页面上的确认框):把肥鱼的 hooks 装进这个通道的 settings.json。

ADR 0006:这是唯一写 hooks 的地方,调用方必须先拿到同意。本机当场写,返回 ``installed`` / ``failed``;
WSL 要起 wsl.exe,后台装,返回 ``pending``,装完经 ``install_finished`` 回来(``_on_install_finished`` 成功时
顺带把通道开上并清掉「缺 hooks」的标记)。不靠 hooks 的通道没有可装的:``failed``。"""
if agent_key == "claude":
if not ClaudeCodeMonitor.install_hooks(self.monitors["claude"].events_file):
log.warning("Claude Code hooks 写入 settings.json 失败")
return "failed"
log.info("Claude Code hooks 已写入 settings.json(用户已同意)")
self._note_hooks_installed("claude")
return "installed"
if agent_key == "claude_wsl":
# wsl.exe 每次调用上百毫秒、发行版冷启动要几秒:走后台线程,调用方先回去,
# 配置完成后自动开启并气泡告知(同 DSH 安装的编排)
self._install_token += 1
token = self._install_token
self._install_pending["claude_wsl"] = token
if hasattr(self.win, "show_bubble"):
self.win.show_bubble("正在配置 WSL 里的 Claude Code hooks…", duration_ms=4000)
threading.Thread(target=self._install_claude_wsl_worker, args=(token,), daemon=True,
name="claude-wsl-hooks-install").start()
return "pending"
return "failed"

def _uninstall_hooks(self, agent_key: str) -> None:
"""卸掉肥鱼自己装的 hooks(只删带标记的条目,用户自有配置不碰);别的多开实例还在用就留着(hooks 是全局状态)。
WSL 那条要调 wsl.exe:后台做,失败只记日志(hook 命令对缺失的脚本 / 目录是空操作,残留条目不会让 Claude Code 报错)。"""
if agent_key == "claude":
if self._other_instances_enabled("claude"):
log.info("其他实例仍在使用 Claude 联动,保留 hooks")
elif not ClaudeCodeMonitor.uninstall_hooks():
log.warning("Claude hooks 卸载未完全成功(配置已关闭,hooks 可能残留)")
if hasattr(self.win, "show_bubble"):
name = self.AGENT_NAMES.get(agent_key, agent_key)
self.win.show_bubble(self._dialogue("bridge.uninstall.failed", "Claude hooks 卸载未完全成功,可手动检查 ~/.claude/settings.json", name=name), duration_ms=6000)
elif agent_key == "claude_wsl":
self._install_pending.pop("claude_wsl", None)
self._install_token += 1
if self._other_instances_enabled("claude_wsl"):
log.info("其他实例仍在使用 WSL Claude 联动,保留 hooks")
else:
threading.Thread(target=ClaudeCodeMonitor.uninstall_wsl_hooks, daemon=True,
name="claude-wsl-hooks-uninstall").start()

def _schedule_hooks_check(self, agent_key: str) -> None:
"""通道刚起来:稍后在后台查一次它的 hooks 在不在。

Expand Down Expand Up @@ -3155,14 +3205,13 @@ def set_enabled(self, agent_key: str, enabled: bool) -> bool:
)
if res != QMessageBox.StandardButton.Yes:
return False
if not ClaudeCodeMonitor.install_hooks(self.monitors["claude"].events_file):
if self.install_hooks_consented("claude") != "installed":
QMessageBox.warning(
self.win if hasattr(self.win, "winId") else None,
"开启 Claude Code 联动",
"hooks 配置写入失败,联动未开启。\n可查看日志了解详情。",
)
return False
self._note_hooks_installed("claude")
elif agent_key == "claude_wsl":
res = QMessageBox.question(
self.win if hasattr(self.win, "winId") else None,
Expand All @@ -3174,18 +3223,7 @@ def set_enabled(self, agent_key: str, enabled: bool) -> bool:
)
if res != QMessageBox.StandardButton.Yes:
return False
# wsl.exe 每次调用上百毫秒、发行版冷启动要几秒:走后台线程,
# 菜单先回弹,配置完成后自动开启并气泡告知(同 DSH 安装的编排)
self._install_token += 1
token = self._install_token
self._install_pending["claude_wsl"] = token
if hasattr(self.win, "show_bubble"):
self.win.show_bubble("正在配置 WSL 里的 Claude Code hooks…", duration_ms=4000)
import threading
threading.Thread(
target=self._install_claude_wsl_worker, args=(token,), daemon=True,
name="claude-wsl-hooks-install",
).start()
self.install_hooks_consented("claude_wsl") # 后台装;菜单先回弹,装完自动开启并气泡告知
return False
elif agent_key == "dsh":
res = QMessageBox.question(
Expand Down Expand Up @@ -3216,29 +3254,11 @@ def set_enabled(self, agent_key: str, enabled: bool) -> bool:
if agent_key == "dsh":
self._install_pending.pop("dsh", None)
self._install_token += 1
# 关闭联动时移除我们注入的内容(只删自己的,用户自有配置不碰);
# 其他多开实例仍在使用则保留(hooks/插件是全局状态)
if agent_key == "claude":
if self._other_instances_enabled("claude"):
log.info("其他实例仍在使用 Claude 联动,保留 hooks")
elif not ClaudeCodeMonitor.uninstall_hooks():
log.warning("Claude hooks 卸载未完全成功(配置已关闭,hooks 可能残留)")
if hasattr(self.win, "show_bubble"):
name = self.AGENT_NAMES.get(agent_key, agent_key)
self.win.show_bubble(self._dialogue("bridge.uninstall.failed", "Claude hooks 卸载未完全成功,可手动检查 ~/.claude/settings.json", name=name), duration_ms=6000)
elif agent_key == "claude_wsl":
self._install_pending.pop("claude_wsl", None)
self._install_token += 1
if self._other_instances_enabled("claude_wsl"):
log.info("其他实例仍在使用 WSL Claude 联动,保留 hooks")
else:
# 卸载同样要调 wsl.exe:后台做,失败只记日志(hook 命令对缺失的
# 脚本/目录是空操作,残留条目不会让 Claude Code 报错)
import threading
threading.Thread(
target=ClaudeCodeMonitor.uninstall_wsl_hooks, daemon=True,
name="claude-wsl-hooks-uninstall",
).start()
# 关闭联动时移除我们注入的内容(只删自己的,用户自有配置不碰);其他多开实例仍在使用则保留。
# hooked 通道由下面 apply_config 停监视器时顺带卸(在跑 → 停);监视器本来就没在跑的,这里补一下。
if agent_key in self._HOOKED_AGENTS:
if not self.monitors[agent_key]._running:
self._uninstall_hooks(agent_key)
elif agent_key == "dsh":
if self._other_instances_enabled("dsh"):
log.info("其他实例仍在使用 DSH 联动,保留桥接插件")
Expand Down
11 changes: 8 additions & 3 deletions pet/app.py
Original file line number Diff line number Diff line change
Expand Up @@ -3464,11 +3464,16 @@ def open_config_panorama(self, focus: str = "") -> None:
``focus``:页面画完就直接翻到的那一组设置(设置窗口里「到配置全景里改」经指令通道传来)。"""
service = getattr(self, "_panorama_service", None)
if service is None or not shiboken6.isValid(service):
from .panorama import actions as panorama_actions
from .panorama.service import PanoramaService

# apply:页面改了设置之后跑的应用链,和设置进程存盘后主进程走的是同一条
service = self._panorama_service = PanoramaService(self.config, health=self._panorama_health,
apply=self._apply_external_config_change, parent=self.app)
# apply:页面改了设置之后跑的应用链,和设置进程存盘后主进程走的是同一条。
# actions:页面上的动作——「修复」给联动通道装 hooks(同意框在页面上,ADR 0006),装完只重探那一侧。
service = self._panorama_service = PanoramaService(
self.config, health=self._panorama_health, apply=self._apply_external_config_change, parent=self.app,
actions={"repair_hooks": panorama_actions.repair_hooks(
lambda: getattr(getattr(self, "_shared", None), "agent_link", None),
lambda side: self._panorama_service.refresh(side))})
service.open(focus=focus)

def _panorama_health(self) -> tuple[str, str]:
Expand Down
Loading
Loading