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-20 个人简报也改在浏览器里看:岛上的人形图标、提醒的「查看」打开配置全景的 `/report/personal_briefing`(和工作简报同一张页:分区、筛选、勾掉;「这次是怎么生成的」写明怎么连的、读了哪些文件、pull 成没成)。页上多一个「记灵感…」按钮,在肥鱼里打开原来窗口的灵感页;那扇窗不再带「简报」页
- 11-20 简报页改版:宽幅两栏,左边每个来源一块磁贴(点了滚过去)和筛选片(★★★ / ★★ / ★ / bug / 有更新,可多选),右边每个来源一张卡(实色磁贴头、条数与 ★★★ / bug / 有更新 的计数、可折叠);每条前面有勾选框,处理完勾掉(只记在这个浏览器里,重新生成后清零),可以隐藏已勾掉的;窄屏单栏。顺手修了链接文字里带方括号(日历事件「[Daily] …」)渲染不成链接的问题
- 11-20 简报页多了「这次是怎么生成的」:链路(WSL 里的 Claude Code 版本、模型、权限模式)、每个相关 MCP 服务器的状态和这次用没用到(没登录的直接给登录命令)、每次工具调用、那个账号跑的 hooks、完整命令和提示词原文;失败的那次也留。设置里新增「额外放行的工具」:连接器换了名字时自己补一行,不用等改代码
- 11-19 工作简报改在浏览器里看:岛上的小文档按钮、早上提醒的「查看」、右键「查看最近一份」都打开配置全景服务的简报页(概要、用量、全文、「重新生成」,生成中页面自己更新)。右键菜单里的「生成时间」子菜单拿掉,换成「简报设置…」翻到配置全景;笔记 / Slack 关注仍在原来的窗口里
Expand Down
12 changes: 7 additions & 5 deletions docs/config-panorama.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@
| `pet/panorama/feed.py` | 发布台 `Feed`:存最近一次发布的数据和它的编号,让「等新数据」的请求等到有为止。**只用标准库** |
| `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/reports.py` | 报告页的数据:`work_briefing` / `personal_briefing(service_of, config)` 把各自服务的最近一份翻成页面要摆的字典;`split_sections`、`trace_sections` / `personal_details`、`generate_briefing`、`open_inspiration` |
| `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** |
Expand Down Expand Up @@ -307,14 +307,15 @@ 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 在**界面线程**上被调
- **登记**:应用构造 `PanoramaService` 时传 `reports={"work_briefing": …, "personal_briefing": …}`(`reports.py`)。provider 在**界面线程**上被调
(它读 Qt 对象),返回固定字段的字典:`title / theme / summary / generated / usage[] / html / busy / busy_text / empty_text /
error / action{name, report, label, hint} / available / details[] / settings_focus`。页面(`report.js`)只按字段摆,不认识功能。
error / action{name, report, label, hint} / actions[] / available / details[] / settings_focus`。页面(`report.js`)只按字段摆,不认识功能。
`actions[]` 是主按钮旁边的副按钮(同一种字典,走同一个动作通道;个人简报的「记灵感…」回 `opened`,页面在状态栏说一声)。
`details` 是「这次是怎么生成的」那几段 `{title, html}`(服务端渲染、全部转义,见[公司侧助理](work-assistant.md)的
「运行记录」),页面折叠着摆在全文下面、第一段默认展开;里面的 `__SETTINGS_URL__` 占位由页面换成
`/#<令牌>&settings=<settings_focus>`(同一个服务、同一个令牌)。
Expand All @@ -339,7 +340,8 @@ flowchart LR
其余一律转义:`<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`。
- **「重新生成」**:`POST /api/actions/generate_report {report}` → `generate_briefing`(按报告名分发)→ `started / busy / failed / unavailable`。
个人简报页的「记灵感…」:`POST /api/actions/open_inspiration {report}` → `open_inspiration` → 界面线程上开 Qt 窗口的灵感页 → `opened`。
回 `started` 页面不动按钮,等 `started` 信号带来的重画把它变灰、`finished` 再放开。
- **隐私**:内容不进全景图、不落快照、不进日志(服务只记请求行);只经带令牌的接口给 `127.0.0.1` 上的浏览器。
- 两张页共用 `client.js`(取令牌、`api` / `api.patch` / `api.post`);`items.js` 是报告页的纯函数;`report.js` 是会自己跑起来的入口,**不在 `MODULES` 里**
Expand Down
14 changes: 10 additions & 4 deletions docs/personal-assistant.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# 个人侧助理:个人助理窗口、GitHub 连接器、本地知识库、「关于我」

> 全部走肥鱼自己的 Claude(设置页里的个人 API key),不经 WSL、不碰公司账号。用户看到的是:灵动岛上的人形图标 →
> 「个人助理」窗口(个人简报 + 灵感记录 + 在 Obsidian 打开知识库);聊天里能只读查 GitHub、查个人知识库的本机副本;
> 个人简报在浏览器里读(配置全景的报告页)、「个人助理」窗口只剩灵感记录 + 在 Obsidian 打开知识库;聊天里能只读查 GitHub、查个人知识库的本机副本;
> 设置页「AI 与对话」里一段「关于我」。都默认关。公司侧见 [公司侧助理](work-assistant.md)。

## 模块
Expand All @@ -11,7 +11,8 @@
| `pet/personal_vault.py` | 零 Qt、不导入 `pet.chat`。配置键 `personal`、Windows 的 git(`run_git` / `token_env` / `sync_path`)、`append_inspiration`、`obsidian_vault_uri` |
| `pet/personal_briefing.py` | 提示词、`GuardedKnowledgeBase`(拒绝名单)/ `RecordingToolset`(记读过的文件)、`generate`、状态文件 `personal-briefing.json` |
| `pet/personal_service.py` | `PersonalService`:每分钟 `check()`,线程里先 `pull` 再 `generate`;灵感落盘后后台推送(一把 git 锁) |
| `pet/personal_ui.py` / `pet/settings_personal.py` | `PersonalController`(自己建一扇 `WorkBriefingWindow`、岛状态、提醒)、`InspirationPanel`、`meta_line`;设置节 |
| `pet/personal_ui.py` / `pet/settings_personal.py` | `PersonalController`(「查看」开浏览器里的简报页;Qt 壳 `WorkBriefingWindow(briefing_page=False)` 只给灵感页;岛状态、提醒)、`InspirationPanel`、`meta_line`;设置节 |
| `pet/panorama/reports.py` | `personal_briefing` provider、`personal_details`(怎么连的、读了哪些文件、pull 结果)、`open_inspiration` 动作。见[配置全景](config-panorama.md)「报告页」 |
| `pet/chat/connectors.py` | 这次对话挂不挂 GitHub MCP 服务器的唯一判断点:`mcp_servers_for` |
| `pet/chat/knowledge_base.py` | `sync`(下载 zip → 原子替换)、`KnowledgeBase`(路径沙箱内的 list / read / search)、`KnowledgeToolset`、`toolset_for` |
| `pet/chat/knowledge_sync.py` | `KnowledgeBaseSync`:主进程里的每日同步定时器 |
Expand Down Expand Up @@ -142,8 +143,13 @@ sequenceDiagram

### 窗口与岛

- `PersonalController` 自己建一扇 `WorkBriefingWindow`(两页:简报 / 灵感;`show_briefing(meta=, busy_text=)` 覆盖元信息行,
`add_action_button` 加「在 Obsidian 打开」),样式与主题规则同公司侧那扇窗。
- **简报在浏览器里读**(2026-11-20,[ADR 0018](adr/0018-content-pages-move-to-the-browser.md),路线图 M4b 第二项):岛上的人形、
提醒的「查看」都走 `open_report("personal_briefing")`(同工作简报那张报告页:概要、用量、分区卡片、筛选、勾掉;
「这次是怎么生成的」只有一段——怎么连的、工具几轮、读了哪些文件、pull 没成功的原因);打开即读过;页面开着时不为新一份冒提醒。
个人简报没有花费这一项(自己的 key),用量条上不摆。页面上的「记灵感…」是一个动作(`open_inspiration` → 界面线程上
`controller.open_inspiration()` → 回 `opened`),在肥鱼里开那扇 Qt 窗口的灵感页。
- `PersonalController` 的 Qt 窗口是 `WorkBriefingWindow(briefing_page=False)`:只有「灵感」页和「在 Obsidian 打开」;
不给 `open_report` 时还是原来的两页窗口(`show_briefing(meta=, busy_text=)` 覆盖元信息行),样式与主题规则同公司侧那扇窗。
- [灵动岛](island.md)上的人形图标排在工作简报按钮右边,`hidden / idle / unread` 三态;没开自动生成也从没生成过时不显示。
个人助理不受「有没有 WSL」门控;没装聊天模块时不接。

Expand Down
2 changes: 1 addition & 1 deletion docs/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ flowchart LR
### M4b 内容页搬到浏览器([ADR 0018](adr/0018-content-pages-move-to-the-browser.md))

- [x] 工作简报的阅读页(`/report/work_briefing`:岛按钮、提醒「查看」、菜单都开浏览器;Qt 壳不再带「简报」页)
- [ ] 个人简报(同一张报告页,多登记一项)
- [x] 个人简报(`/report/personal_briefing`:岛上的人形、提醒都开浏览器;Qt 壳只剩灵感页,页上「记灵感…」开它)
- [ ] 工作笔记页(列表 + 详情 + 新增 / 完成 / 重新总结)
- [ ] Slack 关注页
- [ ] 下线 `WorkBriefingWindow`
Expand Down
20 changes: 16 additions & 4 deletions pet/app.py
Original file line number Diff line number Diff line change
Expand Up @@ -3196,7 +3196,12 @@ def _start_personal(self) -> None:
from .personal_ui import PersonalController

service = PersonalService(self.config, parent=self.app)
self._personal = PersonalController(self._overlay_shell, service)
# 个人简报在浏览器里读(配置全景的报告页);开始 / 结束生成时让开着的页面重画
self._personal = PersonalController(
self._overlay_shell, service, open_report=lambda: self._open_report("personal_briefing"),
report_watched=lambda: self._report_watched("personal_briefing"))
service.started.connect(lambda *_: self._publish_report("personal_briefing"))
service.finished.connect(lambda *_: self._publish_report("personal_briefing"))
self._overlay_shell.personal = self._personal
self._personal.state_changed.connect(self._push_island_personal_state)
service.start()
Expand Down Expand Up @@ -3478,18 +3483,25 @@ def _panorama(self):
from .panorama.service import PanoramaService

briefing_service = lambda: getattr(getattr(self, "_work_briefing", None), "service", None) # noqa: E731
personal = lambda: getattr(self, "_personal", None) # noqa: E731
personal_service = lambda: getattr(personal(), "service", None) # noqa: E731
# apply:页面改了设置之后跑的应用链,和设置进程存盘后主进程走的是同一条。
# actions:页面上的动作——「修复」给联动通道装 hooks(同意框在页面上,ADR 0006),装完只重探那一侧;
# 「重新生成」让简报服务现在生成一份。
# reports:浏览器里读的报告页,现在只有工作简报(没接简报服务 = 没有 WSL 时页面只显示一句说明)。
# reports:浏览器里读的报告页——工作简报(没接简报服务 = 没有 WSL 时页面只显示一句说明)和个人简报
# (没装聊天模块时同样只显示一句);个人简报页的「记灵感…」在肥鱼里开 Qt 窗口的灵感页。
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)),
panorama_reports.GENERATE_ACTION: panorama_actions.generate_report(
{panorama_reports.WORK_BRIEFING: panorama_reports.generate_work_briefing(briefing_service)})},
reports={panorama_reports.WORK_BRIEFING: panorama_reports.work_briefing(briefing_service, self.config)})
{panorama_reports.WORK_BRIEFING: panorama_reports.generate_briefing(briefing_service),
panorama_reports.PERSONAL_BRIEFING: panorama_reports.generate_briefing(personal_service)}),
panorama_reports.OPEN_INSPIRATION_ACTION: panorama_actions.generate_report(
{panorama_reports.PERSONAL_BRIEFING: panorama_reports.open_inspiration(personal)})},
reports={panorama_reports.WORK_BRIEFING: panorama_reports.work_briefing(briefing_service, self.config),
panorama_reports.PERSONAL_BRIEFING: panorama_reports.personal_briefing(personal_service, self.config)})
return service

def _open_report(self, name: str) -> bool:
Expand Down
5 changes: 5 additions & 0 deletions pet/locale/en.json
Original file line number Diff line number Diff line change
Expand Up @@ -1192,13 +1192,17 @@
"personal.button.regenerate": "Regenerate",
"personal.button.regenerate_hint": "Ask your own Claude to re-read AI-Base and write a fresh one, a minute or two",
"personal.button.obsidian": "Open AI-Base in Obsidian",
"personal.button.inspiration": "Jot an idea…",
"personal.button.inspiration_hint": "Opens the inspiration tab in the fish: one line, Ctrl+Enter writes it into AI-Base and pushes to GitHub",
"personal.button.save": "Save",
"personal.empty": "No personal briefing yet. Click “Regenerate” to make one now: your own Claude reads the local AI-Base clone, a minute or two.",
"personal.busy": "Letting {model} (effort {effort}) read AI-Base, usually a minute or two…",
"personal.meta": "Generated {when} · {model} · effort {effort} · {tokens_in} in / {tokens_out} out tokens · {seconds} s · {rounds} tool rounds · read {n} files",
"personal.meta.how": "The fish calls Anthropic directly with your own API key; read-only over the local clone, no connectors",
"personal.meta.files": "Read: {files}",
"personal.meta.pull_failed": "git pull failed ({error}); used the local copy as is",
"personal.generated": "Generated {when} · written by your own Claude from the local AI-Base clone",
"personal.trace.rounds": "{rounds} tool rounds · read {n} files",
"personal.status.failed": "Last run failed: {error}",
"personal.alert.subtitle": "Today's personal briefing",
"personal.alert.view": "View",
Expand Down Expand Up @@ -2461,6 +2465,7 @@
"panorama.ui.report_action_started": "Started, about a minute…",
"panorama.ui.report_action_busy": "Already generating, wait for it.",
"panorama.ui.report_action_failed": "Couldn't start it, see the fish's log.",
"panorama.ui.report_action_opened": "Opened in the fish.",
"panorama.ui.report_sections": "Sections",
"panorama.ui.report_filters": "Filter",
"panorama.ui.report_filter_all": "All",
Expand Down
Loading
Loading