Skip to content

feat(personal): the personal briefing moves to the browser — second report on the same page, Qt shell keeps only the inspiration tab, "Jot an idea…" opens it (M4b item 2) - #89

Merged
LiminCode merged 2 commits into
mainfrom
personal-report-page
Nov 20, 2026

Conversation

@LiminCode

Copy link
Copy Markdown
Owner

Summary

Roadmap M4b, item 2: the personal briefing is now read in the browser on the same report page as the work briefing (/report/personal_briefing): summary, usage chips (no cost — it is the user's own key), one card per section with filters and tick-off, and a one-paragraph "How this run went" (how it connects, tool rounds, files read, whether git pull succeeded). The island's person icon and the alert's "View" open the page; opening counts as read and an open page suppresses the new-briefing alert. The Qt window stays only as a shell for the inspiration tab plus "Open AI-Base in Obsidian", and the page gets a second button, "Jot an idea…", which opens that window through the panorama's action channel. Pages keep not knowing the feature: the provider just fills the same fields, plus a generic actions[] for side buttons.

What changed and why

  • pet/panorama/reports.py: personal_briefing(service_of, config) provider (fields identical to the work briefing's; busy_text names the model and effort; settings_focus="personal"); personal_details(briefing) (connection line, turns + files read as a list, pull_note in red); generate_briefing (generic regenerate, generate_work_briefing kept as an alias); open_inspiration(controller_of) → opened / unavailable; usage() drops a zero cost; generated_line(generated_at, key) so the personal page has its own "generated by your own Claude" line.
  • pet/personal_ui.py: PersonalController(open_report=, report_watched=) — "view" opens the browser (bubble briefing.bubble.page_failed if the server cannot start), open_inspiration() opens the Qt shell on its inspiration tab, the shell is WorkBriefingWindow(briefing_page=False) when the browser path exists, _refresh_window and the alert logic respect the page; without the callbacks the old two-tab window is unchanged (existing tests).
  • pet/app.py: _start_personal wires open_report / report_watched and publishes the report on started / finished; _panorama() registers personal_briefing, the regenerate dispatcher now covers both reports, and the open_inspiration action.
  • pet/panorama/page/report.html|js|css: #actions side-button area (.alt .btn), one click path for all buttons; an opened answer shows report_action_opened in the status line and re-enables the button; render.REPORT_KEYS gains the string.
  • pet/locale/zh.json, en.json: personal.button.inspiration(+_hint), personal.trace.rounds, personal.generated, panorama.ui.report_action_opened; the settings flow tooltip's steps 1 and 3 now describe the browser page.
  • Docs: docs/personal-assistant.md (module table, "窗口与岛" rewritten), docs/config-panorama.md (report page: two reports, actions[], the two actions), docs/roadmap.md (M4b item 2 ticked), CHANGELOG.md.
  • Tests: tests/test_personal_report_page.py (new, 6: provider fields / usage without cost / sections / details; busy, error, pull note, no service; action dispatch by report name incl. opened; controller browser path, page-failed bubble, no alert while watched, Qt shell with only the inspiration tab + the action opening it); test_panorama_report_page.py (+1: side buttons and the opened answer); test_panorama_entry.py (registrations: two reports, three actions).

Performance

Same code paths as the work briefing page (measured in #85 / #88: markdown.render 0.5 ms, split_sections 0.2 ms on a 12 k-char briefing). personal_details is a few string joins over at most a handful of file names. No new requests, threads, disk or network; the side button is one POST per click, answered on the GUI thread like "Regenerate". Steady state zero: the provider runs only when a page asks or when a briefing starts / finishes and a page has asked before.

Real-machine run

Served the real latest personal briefing (11-13, from the user's data directory) with a standalone read-only PanoramaServer from this branch and opened /report/personal_briefing#<token> in the built-in browser: title 个人助理, usage chips claude-sonnet-5 · medium · 65 秒 · 192k · 4.6k (no cost chip), six section tiles (待复习 1 · 决策与检查点 4 · 饮食·本周 3 · 复习 2 · 今天 2 · 建议 3), six cards, 15 enhanced items, one "How this run went" section listing 7 files, main button 重新生成 and side button 记灵感…; clicking the side button posted open_inspiration and the status line showed 已在肥鱼里打开 with the button re-enabled; no console errors. The first preview showed the work briefing's "generated by Claude Code in WSL" line, fixed in the second commit with a personal-specific string. Content is the user's private vault and is not attached. The pet is restarted from main after the merge; the island's person icon then opens the page.

Tests

Red first: tests/test_personal_report_page.py failed on AttributeError: personal_briefing / open_inspiration and TypeError: unexpected keyword 'open_report' before the product change; the entry test's registration sets were updated with the change. Affected families (personal, island personal, panorama, work briefing, i18n, architecture, settings personal, dynamic island): 699 passed, 1 skipped; ruff check pet tests and git diff --check clean. Full suite not run: no config migration, no threading change (two signal connections and one more action handler on the existing GUI-thread channel), no platform dispatch change.

Docs

  • CHANGELOG.md: one line (user-visible change)
  • Topic doc under docs/ updated (personal-assistant.md, config-panorama.md, roadmap M4b)
  • ADR: not needed (ADR 0018 already covers content pages moving to the browser; this is its second item)

🤖 Generated with Claude Code

LiminCode and others added 2 commits November 19, 2026 23:40
…剩灵感页,页上「记灵感…」开它(M4b 第二项)

- reports:personal_briefing provider(同一张页:概要 / 用量(没有花费)/ 分区 / 详情一段:怎么连的、工具几轮、读了哪些文件、
  pull 结果)、generate_briefing(工作 / 个人同用,老名字 generate_work_briefing 保留)、open_inspiration 动作(界面线程上开
  Qt 窗口的灵感页,回 opened);provider 多给 actions[](副按钮)
- PersonalController(open_report=, report_watched=):「查看」开浏览器、打开即读过、页面开着不冒提醒;Qt 窗口
  WorkBriefingWindow(briefing_page=False) 只有灵感页 + 在 Obsidian 打开;open_inspiration()
- app:_start_personal 接 open_report / report_watched,started / finished → publish_report;_panorama 登记 personal_briefing
  与 open_inspiration
- 页面:#actions 副按钮区,动作回 opened 在状态栏说一声;字表(记灵感…、工具几轮、已在肥鱼里打开);流程说明文案
- 路线图 M4b 第二项打勾;docs/personal-assistant「窗口与岛」改写;docs/config-panorama 报告页;CHANGELOG

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@LiminCode
LiminCode merged commit 2c4c784 into main Nov 20, 2026
0 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant