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 工作简报改在浏览器里看:岛上的小文档按钮、早上提醒的「查看」、右键「查看最近一份」都打开配置全景服务的简报页(概要、用量、全文、「重新生成」,生成中页面自己更新)。右键菜单里的「生成时间」子菜单拿掉,换成「简报设置…」翻到配置全景;笔记 / Slack 关注仍在原来的窗口里
- 11-19 配置全景的待处理里,「联动开着但没有 hooks」那一条有了「修复」按钮:确认一次就把 hooks 装回去,图上那条断线随即变回来(WSL 那条在后台装,装完自己更新)。从页面或设置进程关掉联动通道时,肥鱼自己装的 hooks 也会一起卸掉,和右键菜单关闭一样
- 11-19 Claude Code 联动、会话小鱼、「最近的对话」的设置搬到了配置全景(四块磁贴各带「设置」)。「最近的对话」最多留几天 / 几条这两项以前只能手改 config.json,现在也能改了。右键「Agent 联动」里只剩开关:上限 / 保留天数 / 配色 / 字号 / 桂冠 / 行数那六个子菜单换成一条「会话小鱼设置…」
- 11-18 右键菜单更短了:「播放动画」「切换角色」「播放速率」「大小」收进了「肥鱼控制」子菜单最上面一组。自己改过菜单编排的不受影响
Expand Down
37 changes: 37 additions & 0 deletions docs/adr/0018-content-pages-move-to-the-browser.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# 0018:生成出来的内容也在浏览器里读,从工作简报开始;Qt 的简报窗口等别的页搬完再删

日期:2026-11-19

## 背景

[0014](0014-panorama-becomes-the-console.md) 把**设置**搬到了配置全景(网页)。但肥鱼还有一类界面是**读生成出来的
内容**:工作简报、个人简报、工作笔记、Slack 关注,都在一扇 Qt 窗口 `WorkBriefingWindow` 里(三页,三处复用)。
它用 Qt 的文本控件排 Markdown,再逐个文本片段上色;每多一种标记就多一段遍历代码,样式和网页那边各一套。
用户 2026-11-19 说:先把工作简报搬到浏览器。

## 决定

- **内容页也走配置全景那个本机回环服务**,作为它的第二类页面:`/report/<名字>`(外壳公开、无数据)+
`/api/report/<名字>`(要令牌,和图一样认 `?after=` 等更新)。内容**不进全景图、不落离线快照**:图是地图,这是读内容;
快照落盘,公司内容不该多一份副本。肥鱼没开时没有报告可看(原来的 Qt 窗口也要肥鱼开着)。
- **页面不认功能**:服务里按名字登记 provider(`reports={"work_briefing": …}`),provider 在界面线程上把那项功能的状态翻成
一份固定字段的字典(标题、概要、用量、全文 HTML、忙 / 错、按钮)。个人简报以后只是多登记一项。
- **Markdown 在 Python 里渲染**(`pet/panorama/markdown.py`,零依赖,只认简报会写出来的子集);★ 和 bug 记号变成类名,
样式在 `report.css`。逻辑留在 Python 可测;不引 markdown 库。
- **一次只搬一页。** 这一步只搬工作简报的阅读页:岛按钮、提醒的「查看」、菜单「查看最近一份」都开浏览器,Qt 里不再有
第二个看它的地方。笔记页、Slack 关注页是交互列表,各自一期;个人简报紧随其后。**`WorkBriefingWindow` 先留着**只当别的页
的壳(不带「简报」页),都搬完再删——现在删它等于同时重做三个功能。
- 页面跟「外观」里的主题偏好,不放自己的明暗切换:那个偏好只在一处改(0014)。
- 顺手按 0014 把菜单里「生成时间」子菜单拿掉(页面上已能改),换成一条「简报设置…」。

没有选「在全景图上加一块显示简报」:图是配置的地图,和读一篇文字是两件事,而且会把公司内容带进快照。
没有选「先删 Qt 窗口」:笔记 / Slack 页还靠它。
没有选「页面里用 JS 渲染 Markdown」:渲染规则要和原来 `_decorate` 的上色一致,在 Python 里有测试守着更稳。

## 后果

- 本机服务多两个网址、一类页面;`PanoramaService` 多了报告登记表、`open_report`、`publish_report`。
- 简报内容第一次经 HTTP 给浏览器(仍只在 `127.0.0.1`、要令牌、只记请求行);隐私边界不变。
- 工作简报的阅读界面从此有两套样式令牌来源:Qt 壳(`_EXTRA_TOKENS`)和 `report.css` 顶部那组,改一处要两处一起改,
直到 Qt 壳删掉。
- 剩下的顺序记在[路线图](../roadmap.md)「内容页搬到浏览器」。
1 change: 1 addition & 0 deletions docs/adr/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,3 +65,4 @@ PR 满足下面**任意一条**才新增一份 ADR:
| [0015](0015-private-repos-are-home.md) | 私有仓库是数据的家,本机磁盘只是缓存;每种落盘数据都要登记从哪恢复 |
| [0016](0016-drop-screen-watching-and-file-interpret.md) | 看屏幕和拖文件解读整个删掉,不按 0012 只摘入口 |
| [0017](0017-drop-quick-launch-and-tools-help.md) | 右键菜单的「快捷启动」和「工具与帮助」整个删掉 |
| [0018](0018-content-pages-move-to-the-browser.md) | 生成出来的内容也在浏览器里读,从工作简报开始;Qt 的简报窗口等别的页搬完再删 |
33 changes: 31 additions & 2 deletions docs/config-panorama.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,12 +22,15 @@
| `pet/panorama/places.py` | 存储画在图上哪里:`PLACES`(一个地方 = 几个根 + 分区 + 列 + 谁往这里写)、`OWN_TILE`、`ALSO_ON` |
| `pet/panorama/model.py` | 图模型 `Graph`:账号带 `ZONES`、层 `TIERS`、分区、列、节点、连线、待处理;状态取值校验。没有坐标 |
| `pet/panorama/sources.py` | 来源:若干 `@source` 纯函数,把事实翻译成节点 / 连线 / 待处理;`build(facts)` |
| `pet/panorama/page/` | 页面代码,两种交付方式共用:`shell.html`(外壳)、`app.css`,和一组原生模块——`util.js`(转义、图标、颜色)、`layout.js`(版面)、`roads.js`(走线)、`draw.js`(画)、`viewer.js`(文件查看面板)、`memory.js`(记忆一览面板)、`form.js`(设置表单)、`settings.js`(设置面板:开、关、跨重画存活)、`interact.js`(追踪、详情、搜索、筛选)、`app.js`(`start(G)` 把四步串起来)、`boot.js`(入口:数据从哪来、等新数据、连接断了) |
| `pet/panorama/page/` | 页面代码,两种交付方式共用:`shell.html`(外壳)、`app.css`,和一组原生模块——`util.js`(转义、图标、颜色)、`layout.js`(版面)、`roads.js`(走线)、`draw.js`(画)、`viewer.js`(文件查看面板)、`memory.js`(记忆一览面板)、`form.js`(设置表单)、`settings.js`(设置面板:开、关、跨重画存活)、`repair.js`(待处理里的「修复」)、`interact.js`(追踪、详情、搜索、筛选)、`app.js`(`start(G)` 把四步串起来)、`client.js`(取令牌、带令牌的 fetch,两张页共用)、`boot.js`(入口:数据从哪来、等新数据、连接断了);报告页自己的 `report.html` / `report.css` / `report.js` |
| `pet/panorama/render.py` | 把图变成页面要的那份数据(`page_data` / `payload`);`shell()` / `asset()` 给本机服务;`render()` / `write()` 出离线快照 |
| `pet/panorama/service.py` | `PanoramaService`:应用里的后台两段采集与发布;持有本机服务 |
| `pet/panorama/server.py` | 本机回环服务 `PanoramaServer` + 路由表 `Router`:生命周期、守门检查、分发。**只用标准库、不碰 Qt** |
| `pet/panorama/feed.py` | 发布台 `Feed`:存最近一次发布的数据和它的编号,让「等新数据」的请求等到有为止。**只用标准库** |
| `pet/panorama/routes.py` | `build_router`:登记有哪些网址(外壳、静态文件、`/api/ping`、`/api/graph` 及它的「等更新的」用法、`/api/files`、`/api/file`、`/api/settings/<组>`、`/api/audit`) |
| `pet/panorama/routes.py` | `build_router`:登记有哪些网址(外壳、静态文件、`/api/ping`、`/api/graph` 及它的「等更新的」用法、`/api/files`、`/api/file`、`/api/settings/<组>`、`/api/audit`、`/api/actions/<动作>`、`/report/<名字>` + `/api/report/<名字>`) |
| `pet/panorama/actions.py` | 页面动作的处理器:`repair_hooks`(装 hooks)、`generate_report`(报告页的「重新生成」) |
| `pet/panorama/reports.py` | 报告页的数据:`work_briefing(service_of, config)` 把简报服务的最近一份翻成页面要摆的字典;`generate_work_briefing` |
| `pet/panorama/markdown.py` | 简报那一小块 Markdown → HTML(零依赖,只认简报会写出来的子集;★ / bug 记号变成类名) |
| `pet/panorama/settings_api.py` | 读、改一组设置的那段逻辑(`read` / `write`):先重读、对版本、校验、落盘、记审计。不碰 Qt,拿活的 `Config` 干活 |
| `pet/panorama/files.py` | 文件查看的那道门:`VIEWABLE` 名单、`Reader.listing` / `Reader.read`。**只用标准库、不碰 Qt** |
| `pet/panorama/__main__.py` | 命令行入口 `[--no-wsl] [--no-mcp] [--no-open]` |
Expand Down Expand Up @@ -304,6 +307,32 @@ flowchart LR
- **升级时开着的旧设置窗口**:它跑的是旧代码,里面还有搬走的那一组,一保存就把页面改的值盖回去。主进程启动 2.5 秒后发现设置窗口
已经开着,就弹一条通知请用户关掉重开(`AppShell._warn_settings_window_from_before`,跟着「系统通知」总开关)。不替用户关:里面可能有没存的改动。

### 报告页:在浏览器里读生成出来的内容(现在只有工作简报)

本机服务的第二类页面(2026-11-19,[ADR 0018](adr/0018-content-pages-move-to-the-browser.md)):`/report/<名字>` 是公开的外壳
(无数据),`/api/report/<名字>` 要令牌,和 `/api/graph` 一样认 `?after=<编号>` 等更新的。

- **登记**:应用构造 `PanoramaService` 时传 `reports={"work_briefing": provider}`(`reports.py`)。provider 在**界面线程**上被调
(它读 Qt 对象),返回固定字段的字典:`title / theme / summary / generated / usage[] / html / busy / busy_text / empty_text /
error / action{name, report, label, hint} / available`。页面(`report.js`)只按字段摆,不认识功能。
- **数据怎么到页面**:每份报告自己一个 `Feed`。第一次 `GET /api/report/<名字>` 时还没发布过,请求线程经 `on_gui` 让界面线程做一份
(`publish_report(force=True)`);之后页面带编号等更新。简报服务 `started` / `finished` 时应用调 `publish_report(name)`——
**没人打开过页面就什么都不做**(provider 不白跑)。`report_watched(name)` = 有请求挂在那份报告上 = 用户正开着看,
控制器据此不再为新一份冒提醒。
- **打开**:`open_report(name)` 起本机服务(不采集全景那一轮)、`publish_report(force=True)`、开 `base_url/report/<名字>#令牌`。
报告没有离线快照:服务起不来就返回 False,调用方冒气泡。
- **Markdown → HTML 在 Python 里**(`markdown.py`):标题、列表(可嵌套)、段落、粗体、行内代码 → `<code class="chip">`、
`[文字](http(s)://…)` 和裸地址 → 新标签页的链接(别的协议只是几个字);列表项开头的 ★ → `<span class="star s1|s2|s3">`,
bug 记号开头的项 → `<li class="bug">`(它的子列表随它上底色)。这几条就是原来 Qt 窗口 `_decorate` 的上色规则。
其余一律转义:`<script>` 只是几个字。
- **样式**:`report.css` 用 `tokens.css` 的 `--m-*`(跟「外观」里的主题:provider 给 `theme`,页面设 `data-theme`),顶部那组
链接色 / 小标签 / bug 底色 / 星色和 Qt 壳的 `_EXTRA_TOKENS` 一字不差。没有圆角。页面上不放明暗切换(偏好只在一处改)。
- **「重新生成」**:`POST /api/actions/generate_report {report}` → `generate_work_briefing` → `started / busy / failed / unavailable`。
回 `started` 页面不动按钮,等 `started` 信号带来的重画把它变灰、`finished` 再放开。
- **隐私**:内容不进全景图、不落快照、不进日志(服务只记请求行);只经带令牌的接口给 `127.0.0.1` 上的浏览器。
- 两张页共用 `client.js`(取令牌、`api` / `api.patch` / `api.post`);`report.js` 是会自己跑起来的入口,**不在 `MODULES` 里**
(不能拼进全景的离线快照)。

### 文件查看(只读)

图上能打开看的东西带一个「查看」按钮:`CLAUDE.md`、项目记忆、`settings.json`、大肥鱼这几块磁贴上,和存储磁贴清单里
Expand Down
8 changes: 8 additions & 0 deletions docs/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,14 @@ flowchart LR
- [x] Claude Code 联动与 hooks 修复动作
- [ ] 模型服务列表与密钥、连接测试

### M4b 内容页搬到浏览器([ADR 0018](adr/0018-content-pages-move-to-the-browser.md))

- [x] 工作简报的阅读页(`/report/work_briefing`:岛按钮、提醒「查看」、菜单都开浏览器;Qt 壳不再带「简报」页)
- [ ] 个人简报(同一张报告页,多登记一项)
- [ ] 工作笔记页(列表 + 详情 + 新增 / 完成 / 重新总结)
- [ ] Slack 关注页
- [ ] 下线 `WorkBriefingWindow`

### M5 能编辑:记忆与知识

- [ ] 文件编辑器:记忆文件、全局规矩文件的非受管部分
Expand Down
15 changes: 12 additions & 3 deletions docs/work-assistant.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@
|---|---|
| `pet/work_briefing.py` | 零 Qt。配置 `normalize`、`is_due`、放行 / 拒绝名单、`claude_command`、`pr_command` / `format_pull_requests`、提示词模板与 `render_template`、`parse_output`、`linkify`、状态文件 |
| `pet/work_briefing_service.py` | `WorkBriefingService`:每分钟 `check()`,到点在 daemon 线程里 `generate`,信号排队回 GUI 线程落盘 |
| `pet/work_briefing_ui.py` | `WorkBriefingController`(提醒气泡、岛按钮状态、`tab_providers`)、`WorkBriefingWindow`(Metro 窗口壳,三处复用) |
| `pet/work_briefing_ui.py` | `WorkBriefingController`(提醒气泡、岛按钮状态、`tab_providers`;「查看」开浏览器里的简报页)、`WorkBriefingWindow`(Metro 窗口壳:笔记 / Slack 关注 / 个人助理还在用;工作简报的那一页 2026-11-19 起不再加进去) |
| `pet/panorama/reports.py` / `markdown.py` | 浏览器里的简报页:把 `WorkBriefingService` 的最近一份翻成页面数据,Markdown → HTML。见[配置全景](config-panorama.md)「报告页」 |
| `pet/slack_watch.py` / `slack_watch_service.py` / `slack_watch_ui.py` | Slack 关注:`session_active`、`is_due`、`since_for`、JSON 约定、去重 `fresh_items`、总提醒与存档 |
| `pet/work_notes.py` | 零 Qt。`Note`、Markdown 往返 `render` / `parse`、`summarize` / `apply_summary`、提醒、经 WSL 的 git(`sync_command`)、Obsidian 地址 |
| `pet/work_notes_service.py` | `WorkNotesService(folder=, label=, pull_on_start=)`:落盘、后台总结、进程级 git 锁、每分钟 `check_reminders` |
Expand Down Expand Up @@ -151,8 +152,16 @@ flowchart LR

### 窗口

- `WorkBriefingWindow` 是三处共用的壳:工作简报(「简报 / 笔记 / Slack 关注」三页,后两页经 `tab_providers` 在建窗口时
挂上)、右键菜单的 Slack 关注独立窗口(最近一次结果)、个人助理。
- **工作简报的阅读页在浏览器里**(2026-11-19,[ADR 0018](adr/0018-content-pages-move-to-the-browser.md)):岛按钮、提醒的
「查看」、右键「查看最近一份」都调 `AppShell._open_report("work_briefing")` → 配置全景服务的 `/report/work_briefing`。
打开即算读过(岛按钮回到普通样子);页面开着看时新一份不再冒提醒(`report_watched`:有请求挂在那份报告的发布台上)。
生成开始 / 结束时 `publish_report`,页面原地重画;没人打开过页面时什么都不做。页面上的「重新生成」= `POST /api/actions/generate_report`
→ `WorkBriefingService.generate_now()`。本机服务起不来时冒一句气泡(没有离线退路:原来的窗口也要肥鱼开着)。
内容只经带令牌的接口给本机浏览器,不进全景图、不落快照;服务日志只有请求行。
- `WorkBriefingWindow` 现在是别的页的壳:笔记 / Slack 关注(经 `tab_providers` 挂上,`open_window(tab=…)` 开它,建窗口时
`briefing_page=False`,没有「简报」页)、右键菜单的 Slack 关注独立窗口(最近一次结果)、个人助理(还带自己的简报页)。
都搬到浏览器之后这扇窗删掉(顺序见路线图 M4b)。
- 菜单「工作简报」只剩「查看最近一份 / 现在生成 / 工作日自动生成 / 简报设置…」;生成时间等选值在配置全景上改。
- **Metro 令牌复用**:颜色直接取 `settings_theme_qss.METRO_TOKENS`,只多链接色、小标签色等几组(`briefing_tokens`);样式表
里不许有非零圆角(有测试守着);pivot 页头哪怕只有一页也显示。
- **一张样式表管整扇窗**:挂上来的页不带自己的样式表,靠 objectName 被窗口的样式表选中,换主题只要窗口 `setStyleSheet`
Expand Down
Loading
Loading