Skip to content

Commit 37d4e32

Browse files
committed
feat(dsh-go): 手机端原生记忆库面板
dsh-go 是 DSH 的 Android 客户端(Flutter 原生界面),看不到 Web 面板。新增 src/dsh-go/ 域随插件一起发布:面板在引擎进程内直接派发 src/api.js 已注册的 路由 handler,读写与 Web 面板同一批口径。 - package.json 增 dshGo 清单;src/index.js 在 webServer 块内 ctx.inject(["dshGo"]) 里动态导入面板,没有桥的宿主整块不加载;cfg.apiToken 交给面板,进程内写请求 带 x-dsh-mneme-token,不给自家路由开白名单。 - 视图用 v2 协议:顶层原生 tabs(记忆/实体/设置),设置页内两格 segmented 切「设置 | 状态」;文案取自 Web 面板 zh i18n。 - 编辑只提交改动过的字段,updated_at 对不上就中止;删除确认按面板 scope 核对, 避免多面板并发时删错行。 - 跟进 0.11.0 的两块新面板面:「Agent 眼中的你」自动事实(读 / 逐条增改归档 / 立即维护轮)与代码库地志(仓库 → 模块骨架 → 页正文 / 重建骨架)。功能开关补 profileFactsEnabled、chorographyEnabled 与 chorographyInject 档位下拉,并新增 「其它」分组把上游新加、面板暂无中文名的布尔旗标动态列出。 - 为面板补两处读面:/entities?q=(名字过滤下推 store)、/external-api?token=omit (只读配置,不生成也不落库 Bearer)。 - 测试:test/dsh-go-{panel,panel-actions,host}.test.js 与 api-routes-gaps 的 q / token=omit 两例。 - 列表页的翻页用原生两段 segmented(一行等宽、不折行),页码挂在 label 上; 记忆与实体页的空态不再用结构分支表达,改由文案随数据走。
1 parent 6a521d7 commit 37d4e32

32 files changed

Lines changed: 7739 additions & 12 deletions

‎AGENTS.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,7 @@ dsh-mneme 是 DSH 宿主的记忆插件(蒸馏 / 注入 / 检索 / 巩固 / sc
6161
| 配置 | `src/config.js`(schema + lightMode)、`src/settings.js`(feature flags 白名单) | 一切行为开关的家 |
6262
| API 面 | `src/api.js`(宿主内 /api/dsh-mneme/*)、`src/api-standalone.js`(Bearer 数据面)、`bin/dsh-mneme-mcp.mjs`(MCP stdio)、`src/serve.js` + `bin/dsh-mneme-serve.mjs`(独立服务 daemon,无 LLM 数据面) | 对外四张脸 |
6363
| 面板 | `lib/client.js` | 面板侧产物,无 src 对应物 |
64+
| 手机面板 | `src/dsh-go/**` + `package.json` 的 `dshGo` | dsh-go 原生面板:进程内派发同一批路由,只有宿主提供 `dshGo` 服务时才加载([docs/DSH-GO.md](dsh-mneme/docs/DSH-GO.md)) |
6465
| 运行时 | `src/runtime/*` | 模型下载(断点续传)/ 校验 / adopt |
6566
| 命令 | `src/commands.js` | 斜杠命令注册与派发 |
6667
| 双语 | `src/lang.js` | 文案与语言解析 |

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,14 @@
22

33
## [Unreleased]
44

5+
- **dsh-go 原生记忆库面板:手机 App 里也能看、能改这份记忆库**:`dsh-go`(DSH 的 Android 客户端,[仓库](https://github.com/ccch1mneyyy/dsh-Go))是 Flutter 原生界面,看不到 Web 面板。新增 `src/dsh-go/` 域随插件一起发布——不另开包,也不另起端口:面板在引擎进程内直接派发 `src/api.js` 已注册的路由 handler,读写与 Web 面板同一批口径(「两张皮只许剩鉴权与路径不同」)。
6+
7+
- **按宿主能力挂载**:`package.json` 增 `dshGo` 清单(一个面板 `mneme`,placement `session.tab` / `features`);`src/index.js` 在 webServer 块内 `ctx.inject(["dshGo"], …)` 里动态导入 `src/dsh-go/panel.js`,没有桥的宿主(桌面 / headless)整块不加载。`cfg.apiToken` 一并交给面板:进程内写请求带 `x-dsh-mneme-token`,不给自家路由开白名单。
8+
- **视图**:v2 视图协议,顶层是 App 原生 `tabs`(记忆 / 实体 / 设置);设置页内两格 `segmented` 切「设置 | 状态」——电脑端是四个页签,但 App 页签条每格有 80dp 下限,四格会折行。文案取自 Web 面板的 zh i18n,不自造解释性文字。记忆 / 实体页的树不随数据变(宿主的 `view()` 早于 `data()`,按数据分支的地方首屏会定形、之后只填绑定),空状态提示改成绑定文案;翻页用一行 `chips`(原生按钮组每列至少 136dp×字号,两个按钮在窄屏会折成上下两行),页码兼作 chips 的标签。
9+
- **写回不覆盖别人的写入**:编辑页记住打开时的快照,只提交改动过的字段;`updated_at` 对不上就中止并重新载入。删除确认不携带参数(`confirm` 节点只有 id 与按钮文案),所以按面板 scope 记下「这个面板打开了哪条记忆」,确认时核对。
10+
- **为面板补了两处读面**:`/entities` 支持 `?q=`(名字过滤下推到 store,`%` / `_` 转义);`/external-api` 支持 `?token=omit`(只读配置,不生成也不落库 Bearer——默认 GET 会顺手铸造一个)。
11+
- **验证**:`test/dsh-go-panel.test.js`(19 屏视图预算 + 页签 / 开关 / 文案锁)、`test/dsh-go-panel-actions.test.js`(点按之后发给宿主的请求、scope 核对、只发差集、视图切换)、`test/dsh-go-host.test.js`(请求体 flush、异步响应、令牌、401、超时);`test/api-routes-gaps.test.js` 补 `q` 与 `token=omit` 两例。
12+
513
- **修复 #588:`codingGate` 词表补齐 34 项工程协作词——「合并 / PR / CI / 发版」类任务此前被判成非编码,`pitfall` / `constraint` / `rejected_solution` 三类教训记忆整类不注入**。`codingKeywords` 56 → 90 项,改的是默认值,词表本身仍可配置覆盖。
614

715
- **病灶是判据只看词表不看内容**:`codingGate` 按 `m.type` 判,而「这条任务算不算编码」唯一依据是 `codingKeywords` 子串命中。原表 56 项里没有「合并 / 分支 / 提交 / 冲突 / 验收 / 审查 / 评审 / 审评 / 发版 / 仓库 / 回滚 / 推送 / 拉取 / 变基 / 上线 / 打包 / 迁移 / 字段 / 鉴权 / 超时 / 并发 / 闪退 / 白屏 / 端口 / 进程 / 守护 / 定时任务 / 索引 / 缓存 / 死锁 / 内存泄漏 / 日志 / 版本号 / 环境变量」——用户日常说的「合并吧」「看看 CI 和审评」「今天就能发版」全被判成非编码,于是这三类记忆一次都不注入。生产日志实测(`recall_runs`,剔除系统提示污染后 1,070 query / 61,446 次调用):缺口占非编码调用的 17.1~21.7%,补词后翻转 114 query / 8,352 次,编码任务占比 23.4% → 37.0%。

‎dsh-mneme/docs/DSH-GO.md‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
# dsh-go 原生面板
2+
3+
> 客户端仓库:[ccch1mneyyy/dsh-Go](https://github.com/ccch1mneyyy/dsh-Go)
4+
5+
> dsh-mneme 一直是「Web 面板 + 11 个记忆工具 + 自动注入」。手机 App **[dsh-go](https://github.com/ccch1mneyyy/dsh-Go)**(DSH 的 Android 客户端:Flutter 原生壳,手机本机跑引擎,也能遥控电脑)是 Flutter 原生界面,看不到 Web 面板——这个域就是给它的原生面板:与电脑端同一套功能划分(记忆 / 实体 / 设置 / 状态)、同一批后端路由。
6+
>
7+
> 记忆库是**按宿主独立存放**的:面板读写的是它所在那台宿主的 `memory.db`,与另一台设备上的库不互通。目前没有在线同步,只能通过分享包 `mneme.share/v1` 手动迁移,且不是实时同步。
8+
9+
## 职责边界
10+
11+
- **只做展示与转发**:取数、写回都走 `src/api.js` 已注册的 HTTP 路由 handler(进程内派发),不新增路由、不直连 SQLite、不写第二套口径。
12+
- **不碰记忆本体**:面板不参与蒸馏、注入、巩固、冲突判定;它只是这些能力的一个操作面(和 Web 面板同级)。
13+
- **可选能力**:桌面 / headless 宿主没有 [dsh-go](https://github.com/ccch1mneyyy/dsh-Go) 桥,这个域整块不加载(`ctx.inject(["dshGo"], …)` 的回调不会被调度)。
14+
- **不重复 Web 面板**:`lib/client.js`(浏览器 bundle)照旧是 Web 面板的唯一实现;两边共享的是**后端**,不是视图代码。
15+
16+
## 对外接口
17+
18+
### 1. 包清单
19+
20+
`package.json` 的 `dshGo` 字段([dsh-go](https://github.com/ccch1mneyyy/dsh-Go) 桥扫描已启用插件的 package.json,见 `dsh-go-bridge/lib/native/manifest.js`):
21+
22+
```json
23+
"dshGo": { "v": 1, "title": {...}, "icon": "book", "contributes": { "panels": [{ "id": "mneme", ... }] } }
24+
```
25+
26+
面板的 `pkg` 由桥按「注册调用所在 fiber 所属的 loader entry」反查,所以**不需要独立包**:在 mneme 自己的插件上下文里调 `ctx.dshGo.panel("mneme", …)`,归谁一目了然。
27+
28+
### 2. 挂载点
29+
30+
`src/index.js` 在 webServer 块内、`createApi` 之后:
31+
32+
```js
33+
ctx.inject(["dshGo"], (dshCtx) => {
34+
import("./dsh-go/panel.js")
35+
.then((panel) => panel.mountDshGoPanel(dshCtx, { apiToken: cfg.apiToken }))
36+
.catch((error) => ctx.logger?.warn?.(`[dsh-mneme] dsh-go 面板未加载:${error?.message ?? error}`));
37+
});
38+
```
39+
40+
两处细节都是刻意的:
41+
42+
- **动态 import**:静态导入会在插件加载时就把面板模块跑一遍,「没有 dsh-go 就不加载这个域」这句承诺就不成立了。
43+
- **把 `cfg.apiToken` 交给面板**:`createApi` 给 token / token-write 路由包了鉴权,进程内调用不带令牌会被自家路由拦成 401。令牌以 `x-dsh-mneme-token` 头随请求走(`src/dsh-go/host.js`),不给进程内调用开白名单。
44+
45+
### 3. 视图协议(v2)
46+
47+
`buildView(state)` 返回 `{v:2, type:"stack", accent:"app", children:[…]}`,顶层是 App 原生 `tabs`:记忆 / 实体 / 设置。设置页顶部两格 `segmented`(设置 | 状态)——电脑端是四个页签,但 App 的页签条每格有 80dp 下限,四格在手机上会折行,所以放三格。
48+
49+
### 4. 0.11.0 补上的两块面板面
50+
51+
mneme 0.11.0 把「Agent 眼中的你」自动事实(`profile_facts` 三表)和 chorography 地志搬上了 Web 面板。手机面板跟着补,仍走同一批路由:
52+
53+
| 面板位置 | 路由 | 说明 |
54+
|---|---|---|
55+
| 设置 › 个性化 › Agent 眼中的你 | `GET /profile-facts?agent=` | 一次拿到 `cards` / `facts`(含归档)/ `journal` / `runs`;flag 关着也照读,历史上攒下的事实要能看见 |
56+
| 同上(增 / 改 / 归档) | `POST /profile-facts/apply` | body `{agent, ops}`,op 形状与自动轮共用:`add` 必须带 `content`,`update`/`archive` 必须带 `id` |
57+
| 同上(立即更新) | `POST /profile-facts/run` | 一次 LLM 维护轮,慢且串行,面板按 pending 处理(60s);`409` = 功能关着,`503` = 没配模型,`502` = 模型答得不成形 |
58+
| 设置 › 记忆引擎 › 代码库地志 | `GET /choro/repos`、`/choro/modules?repo=`、`/choro/page?repo=&slug=` | 仓库 → 模块骨架 → 页正文;都受 `chorographyEnabled` 闸门(关着回 `409 disabled`) |
59+
| 同上(重建骨架) | `POST /choro/run` `{repo}` | 只跑 T0 apply(秒级);T1 富化仍需命令行 `--t1`,所以重建会把已富化的语义段退回骨架 |
60+
61+
功能开关这块也换了一半口径:
62+
63+
- 枚举型旗标(`chorographyInject` 的 `light/full/off`)用下拉,`PUT /features` 收字符串值——同一个动作 id 既服务开关也服务下拉。
64+
- 新增「其它」分组:把 `/features` 的 `effective` 里**我们还没给中文名**的布尔项动态列成数据行(`list` + `items` 绑定),点一行翻转一项。上游每加一个开关,手机面板不会再静默漏掉它;数值/字符串键(模型名、预算)不放这里,它们要输入框。
65+
66+
## 内部文件
67+
68+
| 文件 | 一句话 |
69+
|---|---|
70+
| `src/dsh-go/panel.js` | 状态机、取数、动作(`mountDshGoPanel`)。动作跑完自己把新数据推给所有打开的 feed |
71+
| `src/dsh-go/host.js` | 进程内派发:`ctx.get("webServer").match(path)` 拿到 mneme 自己的 handler,伪造 req/res 调用 |
72+
| `src/dsh-go/text.js` | 类型标签、开关分组、时间与 scope 格式化 |
73+
| `src/dsh-go/views/root.js` | `buildView`:顶层页签组合 |
74+
| `src/dsh-go/views/{common,memory,entity,settings,status}.js` | 各分区视图;`common.js` 是小组件构造器 |
75+
76+
文案取自 Web 面板的 zh i18n(`lib/client.js` 里的 `memory.*` 键),面板不再自造解释性文案。
77+
78+
## 已知坑
79+
80+
- **feed 是推送式的**:`data()` 每个面板实例只跑一次,`refresh` 效果只让 App 重画视图、不会重跑 `data()`。所以每个动作结尾都要 `broadcast()`(向所有 emit 推新 payload),否则点了按钮界面还是旧数据。推送节流 4/s。
81+
- **不能走 HTTP**:[dsh-go](https://github.com/ccch1mneyyy/dsh-Go) 桥的路由守卫(`installFallbackGuard`)对没有合法签名的请求直接 401(`x-dsh-go-guard: reject`),浏览器 cookie 是宿主签的、进程内也拿不到。进程内 `webServer.match()` 绕开这一层,且复用同一批 handler。
82+
- **`/external-api` 的 GET 有副作用**:不带参数时会顺手生成 Bearer token 并落库。面板读配置用 `?token=omit`(只回 `enabled/port/host`,不铸造也不落库),不读令牌。
83+
- **进程内调用也要带令牌**:宿主配了 `apiToken` 时,`/update`、`/delete`、`/features` 这些 token 路由对进程内请求同样校验;令牌走 `x-dsh-mneme-token` 头。
84+
- **两种响应节奏都要等**:多数路由在返回的 promise 里 `res.end`,少数(`/version-check`)立即 `return` 再在回调里写响应。`host.js` 同时等 handler 的返回值和响应结束,只 race 的话后者会被当成空结果。
85+
- **`/search` 不认识 `type`**:它是全库语义检索,面板在拿到结果后再按所选类型收一遍。
86+
- **`/entities` 的 `q`**:名字过滤必须下推到 store(`LIKE`,`%`/`_` 转义)。面板若自己取 limit 条再本地过滤,排在 limit 之外的实体永远搜不到。
87+
- **删除只能按状态认人**:`confirm` 节点没有参数位(只有 id 与两个按钮文案),所以「删哪一条」只能靠状态;状态是所有面板共用的,因此面板按 `scope` 记下自己打开的那条,确认时与本打开的条目核对,不一致就拒绝。
88+
- **`/update` 不接受 `type`**:编辑已有记忆时类型只读展示,新建才给选择器。
89+
- **保存只发差集**:`/update` 没有版本号校验,整份提交会把别处(工具、Web 面板)刚写进去的新值盖掉。面板在编辑页记住打开时的快照,只提交改动过的字段,`updated_at` 对不上就中止并让用户再看一眼。
90+
- **`/create` 不接受 scope**:归属 Agent / 工作区两个输入只在编辑已有记忆时出现。
91+
- **节点预算**:面板 120 节点 / 8 层 / 32 KiB,`data` 32 KiB。列表行只下发 `summary`(`content` 截 120 字),全文留在详情取,否则条目一多就超预算。
92+
- **地志与事实都有闸门**:`/choro/*` 在 `chorographyEnabled` 关闭时回 `409 {error:"disabled"}`,`/profile-facts/run` 在 `profileFactsEnabled` 关闭时同样 `409`;两个读口(`/profile-facts`、`/choro/repos` 之外的模块/页)不受开关影响,面板要能展示历史数据。
93+
- **事实的 op 形状是硬约定**:`add` 缺 `content` 会把 `"undefined"` 写进事实正文并从此每帧注入;面板在本地就拦「正文不能空」,不把脏 op 递过去。
94+
- **重建骨架只到 T0**:`POST /choro/run` 是同步秒级回执,不带 T1 富化;面板文案要说明「语义段退回骨架」,否则用户会以为富化丢了。
95+
- **`refresh` 会重建视图树,页签选择会丢**:顶层 `tabs` 的选中项是 App 的本地状态(视图协议没有绑定口),App 收到 `refresh` 重新拉一遍视图,树一重建就回到第一个页签。所以「只改一个绑定值」的动作(开关、档位下拉、外部访问开关、事实增改、地志翻页)不要申请重画,只推数据;只有真的改变了「哪些节点存在」的动作(进子页、换分区、换分组、翻页、搜索)才要 refresh。
96+
- **`nestFlags` 不能把值压成布尔**:枚举型旗标(`chorographyInject` = light/full/off)以前被写成 `value === true`,下拉永远只拿到 true/false。视图绑定要原样透传。
97+
- **不要用 `metric.caption` 放单位**:`caption` 固定渲染在数值下方一行;v2 的 metric 整串数值同一字号,所以单位拼进 value(`57 条`),App 侧只有自带模型卡才会拆小字单位。

‎dsh-mneme/lib/api.js‎

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1689,7 +1689,11 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
16891689
try {
16901690
const url = new URL(req.url, "http://localhost");
16911691
const limit = Math.min(1000, Math.max(1, Number(url.searchParams.get("limit") ?? 500) || 500));
1692-
const entities = service.listEntities?.({ limit }) ?? [];
1692+
// q = 名字过滤。必须下推到 store:面板此前取回 limit 条再本地过滤,
1693+
// 排在 limit 之后的实体永远搜不到(评审 #9)。老宿主没有这个形参时
1694+
// 多传一个键不会报错,只是过滤失效——与 limit 的处理一致。
1695+
const q = url.searchParams.get("q") ?? "";
1696+
const entities = service.listEntities?.({ limit, q }) ?? [];
16931697
// total 是**全库**实体数,不是本次切片长度:目录带 limit,面板拿它当
16941698
// 「一共抽出多少实体」,填切片长度会让 1.6 万实体永远显示成 500。
16951699
// 老宿主(service 上没有 countEntities)回落到切片长度,不抛。计数本身失败也
@@ -2287,11 +2291,17 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
22872291
// materialize and persist one here. 只有通过上面那道门才会走到这里,
22882292
// 否则「未鉴权的 GET 顺手写库」就是一条不需要凭证的写路径。
22892293
const kv = settings.getExternalApi() ?? {};
2290-
if (!kv.token) {
2294+
// ?token=omit:只读配置、不生成也不落库 Bearer。
2295+
// 手机端面板(src/dsh-go)只需要 enabled/port/host 来渲染表单,而默认的
2296+
// GET 会顺手 materialize 一个 token 写进 user_settings —— 一次纯读请求
2297+
// 变成写路径,既污染审计也违反「面板不显示明文令牌」的承诺。带上这个
2298+
// 参数时 token 字段一律留空;不传的老客户端行为完全不变。
2299+
const omitToken = new URL(req.url, "http://localhost").searchParams.get("token") === "omit";
2300+
if (!omitToken && !kv.token) {
22912301
kv.token = randomBytes(24).toString("base64url");
22922302
settings.setExternalApi({ token: kv.token });
22932303
}
2294-
sendJson(res, 200, { config: fullExternalConfig(kv) });
2304+
sendJson(res, 200, { config: fullExternalConfig(omitToken ? { ...kv, token: "" } : kv) });
22952305
} catch {
22962306
sendJson(res, 500, { error: "internal" });
22972307
}

0 commit comments

Comments
 (0)