Web 仪表板：本地浏览界面#

memoryd 启动一个本地 FastAPI 服务（绑 127.0.0.1），提供浏览-only 的 Web 界面。 不可编辑——编辑走 CLI 或直接改 markdown。

启动#

memoryd web                       # 随机端口；stderr 输出 token URL
memoryd web --port=8088
memoryd web --no-browser          # CI / SSH 场景

启动后 stderr 出一行：

memoryd web on http://127.0.0.1:<port>/?token=<256-bit-token>

把整个 URL（含 ?token=）复制到浏览器。token 每次重启变。

路径	用途
`/`	仪表板首页：最近 20 条记忆 + 统计 + 各页面跳转
`/memories?type=&scope=&page=`	列表
`/memories/{slug}`	详情；sensitive 一律 403
`/search?q=`	全文搜索结果页（HTMX 完整刷新版）
`/htmx/memory-list?...`	HTMX 局部刷新片段
`/audit?scope=&since=&event_type=`	审计日志表格
`/digest`	pending promotions 列表（read-only）
`/relations`	知识图谱（Cytoscape.js 全图）
`/relations/entity/{entity_id}`	单实体 N-hop 子图视图
`/trends?window=7d`	趋势页：top trigger + entity 上升 + recall hot
`/identity`	当前 identity.md + 最近版本号 + 月度报告列表
`/identity/version/{n}`	第 n 版历史快照
`/identity/diff?from=&to=`	两版 diff

路径	用途
`/api/graph/global`	全图 cytoscape elements JSON
`/api/graph/{entity_id}`	单实体 N-hop 子图 JSON
`/api/trends/triggers?window=7d`	trigger 频次
`/api/trends/entities?window=30d`	entity 上升榜
`/api/identity/report/{period}`	月度报告 markdown 原文（PlainTextResponse）

路径	用途
`/healthz`	公共探活，不需 token

截图待补

截图集中放在 docs/assets/screenshots/，本节后续补齐。

模板引擎：Jinja2。CSS 走原生（轻量），交互走 HTMX；知识图谱页用 Cytoscape.js（外链 CDN）。

任何 API 路由如果上游模块未就绪（KG 没建表 / Profile 没数据 / 缺包）返回友好降级而非 500。

例如 /relations 在没有 entities 时显示"还没有抽出的实体"，让 Web 端的"可观察性优先"。

# memoryd/web/server.py
def run(port: int | None = None, open_browser: bool = True) -> int:
    ...