dsh-theone 0.3.19 → 0.3.21

package/README.md

@@ -18,18 +18,10 @@ How many sessions are sitting in your DSH sidebar? Getting back to last week's w
 
 **TheOne takes care of that.** You just talk in one main chat:
 
-```text
-You: FP8 still crashes for Qwen on the 9070 XT
-     → Qwen / RX 9070 XT
-You: also fill in the ablation table in chapter 3 of the paper
-     → Video Attention Thesis
-You: and add the Qwen speed numbers from earlier
-     → Video Attention Thesis · reference: Qwen / RX 9070 XT
-You: wrong topic, that was the GPU one
-     → Qwen / RX 9070 XT        (the previous message is redone there, and remembered)
-```
-
-<sub>Illustration. By default, a one-line notice appears only when the topic changes.</sub>
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/YunongDai2005/dsh-theone/main/docs/images/theone-architecture-en-dark.svg">
+  <img alt="How TheOne works: main chat sends each message through the router to its topic session; answers stream back, and the topic directory keeps progress, constraints and links" src="https://raw.githubusercontent.com/YunongDai2005/dsh-theone/main/docs/images/theone-architecture-en-light.svg" width="100%">
+</picture>
 
 Each project gets its own background session that reasons, runs tools and compacts on its own. What you see is always one ordinary conversation.
 
@@ -46,6 +38,7 @@ Each project gets its own background session that reasons, runs tools and compac
 - **Feels native.** Thinking streams in its usual place from the first token, and tool cards, approvals, questions, todo lists, retries and mid-reply steering all work as usual.
 - **Related work connects; unrelated work stays out.** Related topics share progress automatically and TheOne learns which ones belong together from how you use them. A topic's constraints (say, "budget figures stay out of the paper") are attached verbatim every time, so compaction never drops them.
 - **Gets better with use.** Say "wrong topic" or click **Move to…** in the directory, and TheOne learns which terms tie that kind of message to the right topic (one small model call), so similar messages go there from then on. The directory shows how often routing was kept as is.
+- **Knows each topic early.** After a topic's first reply, and once more when it is clearer, a short card (what it is, other names you use for it, the people, places and files involved, what is still open) is written in the background, so routing recognises the topic in your own words from the start. Routing also sees when each topic was last active; topics left alone longer than you usually come back to one (learned from your own use, 7 days until there is enough) are set aside: still reachable, just considered last. Nothing to set up and nothing shown.
 - **Your old sessions become a topic directory.** After install it reads your existing sessions in the background, turns them into topics grouped into workspaces, and you pick up where you left off.
 - **Nothing extra to configure.** No separate API key: routing and the background sessions use the model you chose in DSH. When TheOne is the selected model, a button with a layers icon appears beside the model menu: it shows which model does the routing and the work, and switches it.
 
@@ -54,13 +47,67 @@ Each project gets its own background session that reasons, runs tools and compac
 ## Install in 30 seconds
 
 1. Configure an API in DSH and select a model that can chat.
-2. Open **Plugins → Add plugin**, paste `https://github.com/YunongDai2005/dsh-theone`, and install.
+2. Open **Plugins → Add plugin**, enter `dsh-theone` under *Package name or address*, and install.
 3. Click **TheOne · Main chat** in the sidebar and start talking.
 
-From the command line: `dsh plugin --profile web add github:YunongDai2005/dsh-theone --ignore-scripts`. Works with DSH `0.2.0-rc.2` and Node.js 24; the interface follows DSH's language (English / Simplified Chinese). Installing `dsh-theone` from npm also works, but DSH's package manager only accepts a version once it has been published for 24 hours, so the GitHub address gets new versions first. When an update is newer than that, the update button explains it and can exempt TheOne alone so it installs right away.
+That's it. Works with DSH `0.2.0-rc.2` and Node.js 24; the interface follows DSH's language (English / Simplified Chinese).
+
+<details>
+<summary><b>New to DSH? A step-by-step walkthrough (about 3 minutes)</b></summary>
+
+No coding needed:
+
+1. **Make sure DSH itself can chat.** Add your model provider's API key (DeepSeek's, for example) in DSH's settings, open an ordinary chat and say "hi". If it answers, you're set. TheOne uses that same model; there is no other key to enter.
+2. **Install TheOne.** Click **Plugins** in the sidebar, then **Add plugin**, and enter:
+
+   ```
+   dsh-theone
+   ```
+
+   Click install and wait for it to finish.
+3. **Start.** A new **TheOne · Main chat** appears in the sidebar. Open it and just talk about whatever is on your plate: today's work, the weekend trip, the paper you're writing. No new chats to create, nothing to name.
+4. **Updates.** When a new version is out, a download icon appears next to the TheOne entry. One click installs it, no restart.
+5. **Changed your mind?** Uninstall it on the Plugins page. Your DSH chats are all still there; TheOne organises them and never deletes them.
+
+**Small things you may run into**
+
+- **"Too new" and it won't install:** DSH only installs versions published at least 24 hours ago. That's a safety rule, not an error. Wait a day, or enter the GitHub address `https://github.com/YunongDai2005/dsh-theone` instead, which installs right away.
+- **No TheOne in the sidebar after installing:** restart DSH.
+- **Will it cost a lot?** Each message adds one short classification call (no deep thinking, at most 2,048 output tokens), and "ok" or "go on" skips even that. After installing, TheOne also organises your existing chats into a topic directory in the background; with many chats that first pass uses some of your quota. You can turn **History catalog** off in the settings.
+</details>
+
+<details>
+<summary><b>Command line and other sources</b></summary>
+
+- npm: `dsh plugin --profile web add dsh-theone --ignore-scripts` (use `desktop` instead of `web` for the desktop app)
+- GitHub (always the latest main): `dsh plugin --profile web add github:YunongDai2005/dsh-theone --ignore-scripts`
+
+A new version from npm installs once it has been published for 24 hours; when an update is newer than that, the update button explains it and can exempt TheOne alone so it installs right away.
+</details>
 
 > Unofficial community project, maintained independently. It is not affiliated with or endorsed by DeepSeek.
 
+## How well does it route?
+
+Claims are cheap, so we built a public benchmark, **InterleaveBench**: one person pushing 3–5 things forward in the same chat at once (a trip, a budget, a paper, a training plan…), half in Chinese and half in English, 50 conversations and 2,466 messages, each labelled in advance with the thing it belongs to. We replayed them message by message through TheOne's own routing code with DeepSeek V4.1 Flash (dev split, 40 conversations; messages even a careful human could not attribute are not scored):
+
+| Approach | Messages routed correctly |
+| --- | --- |
+| TheOne, topic list given up front | **91.6%** |
+| TheOne, starting from nothing and creating topics as it goes (your first day) | **86.6%** |
+| Keyword search (BM25), topic list given up front | 73.3% |
+| No routing, everything in one chat | 44.5% |
+| Keyword search, starting from nothing | 39.9% |
+| A new topic for every message | 9.8% |
+
+A few numbers worth knowing:
+
+- **A message landing in another thing's topic**, the mistake that hurts context most: about 3.7% when starting from nothing.
+- The main weakness today is **opening new topics too eagerly**: one thing ends up split over 2.1 topics on average. 0.3.21's topic cards go after exactly that.
+- The whole run cost about one US dollar. Data, code and scoring live in [`eval/`](./eval/README.md); reproduce it, or try another model.
+
+The conversations are model-written from a script and this version has no assistant replies, so it measures whether messages are routed right, not everything about how chatting feels.
+
 ## How it works
 
 **Choosing a topic.** Each message is matched to the current topic, an earlier one, or a new one. By default the model you selected makes one short classification (thinking off, at most 2,048 tokens), with candidates recalled through DSH full-text search.
@@ -89,6 +136,8 @@ Right-click the TheOne button in the sidebar and choose **Settings**. Changes ap
 | --- | --- |
 | Topic notices | How main chat shows topic changes: hidden, one line only when the topic changes (default), or on every message with the reason |
 | Linking scope | Learn automatically (default), same workspace only, or off |
+| Share confirmed facts (experimental) | Off by default. Topics share only facts the user confirmed (a figure, a decision, where a file is), with version and source; a topic that used one is told when it changes or is withdrawn. Applies after a DSH restart |
+| Record facts automatically (experimental) | Off by default. With shared facts on, one small model call after each turn records facts the topic session left out; only user-confirmed ones are shared |
 | Model | Follow DSH (default) or pin the background model from any model configured in DSH; a pinned model takes precedence over main chat's selector |
 | Routing | LLM decision (default) or rule-based |
 | History catalog | On/off and rescan interval |
@@ -136,6 +185,20 @@ Tests use the real DSH runtime (AgentLoop, Session, SQLite, JSONL persistence, c
 Service API: `ctx.theone.searchHistoryDetailed(contextId, query, limit)` searches a topic's reviewed history; `store.addSource(contextId, sessionId, { startSeq, endSeq })` attaches part of a session. Earlier acceptance records: [v0.1](./docs/plugin-v0.1.md) and [v0.2](./docs/plugin-v0.2.md).
 </details>
 
+
+<details>
+<summary>🥚</summary>
+
+<br>
+
+Congratulations, you found the easter egg.
+
+In the benchmark, TheOne once made a very human mistake. The user said "the café's autumn menu was due on September 25, let's push it to October 8", and TheOne filed it under the October holiday trip to Yunnan. Both were in October, after all.
+
+We're still training it; 0.3.21's topic cards came out of moments like this. If it ever files something of yours in the wrong place, just say "wrong topic" in the main chat. It will remember, and it won't take it personally.
+
+</details>
+
 ---
 
 <p align="center">If TheOne helps, a ⭐ helps others find it. Questions or ideas? <a href="https://github.com/YunongDai2005/dsh-theone/issues">Open an issue</a>.</p>

package/README.zh.md

@@ -18,18 +18,10 @@
 
 **TheOne 把这些都交给它。** 你只管在一个主聊天里说话：
 
-```text
-你：Qwen 在 9070 XT 上跑 FP8 还是报错
-    → Qwen / RX 9070 XT
-你：顺便把论文第三章的消融表补上
-    → 视频注意力论文
-你：把刚才 Qwen 的测速结果也放进去
-    → 视频注意力论文 · 参考：Qwen / RX 9070 XT
-你：分错了，是显卡那个的
-    → Qwen / RX 9070 XT        （上一条交给它重新处理，以后也记住了）
-```
-
-<sub>示意。默认只在切换话题时显示一行提示。</sub>
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/YunongDai2005/dsh-theone/main/docs/images/theone-architecture-zh-dark.svg">
+  <img alt="TheOne 的结构：主聊天把每条消息交给分配话题，送到对应的后台会话，结果实时回到主聊天；话题目录保存进展、约束和关联" src="https://raw.githubusercontent.com/YunongDai2005/dsh-theone/main/docs/images/theone-architecture-zh-light.svg" width="100%">
+</picture>
 
 每件事都有自己的后台会话，在里面推理、调用工具、压缩上下文；你看到的始终是一个普通的对话。
 
@@ -46,6 +38,7 @@
 - **和原生会话一模一样**：思考从第一个字起就在原位置，工具卡片、授权、提问、待办、重试、回答中途插话，全都照常。
 - **相关的事会互通，无关的事互不打扰**：相关话题自动共享进展，并从你的使用中学习哪些话题有关联；话题的约束（比如「预算数字不能写进论文」）每次都原样带上，压缩不会把它丢掉。
 - **越用越准**：说「分错了」或在目录里点「改到…」，TheOne 会学到哪些词把这类消息和正确话题联系起来（只需一次很小的模型调用），类似的消息以后直接分对；话题目录里能看到分配的准确率。
+- **新话题也认得出**：话题第一次回复后（以及事情更清楚时再一次），后台会写一张简短的卡片：这件事是什么、你会用哪些别的说法叫它、涉及的人名地名和文件、还有什么没定，所以换个说法也能分对。路由还知道每个话题多久前活跃过；超过你平时回头的间隔没动的话题（从你自己的使用中学出来，数据不够时按 7 天）会被视为搁置：仍然可以被分到，只是排在最后。无需设置，也不会打扰你。
 - **旧会话自动变成话题目录**：装上后它会在后台读取你已有的会话，整理成话题并按工作区分组，直接接着聊。
 - **零额外配置**：不用另填 API Key，路由和后台都用你在 DSH 里选好的模型。选中 TheOne 时，模型按钮旁边会出现一个带图层图标的按钮，显示并切换分配话题和干活用的模型。
 
@@ -54,13 +47,67 @@
 ## 30 秒装好
 
 1. 在 DSH 中配置好 API，选一个能正常聊天的模型。
-2. 打开 **插件 → 添加插件**，粘贴 `https://github.com/YunongDai2005/dsh-theone`，点击安装。
+2. 打开 **插件 → 添加插件**，在「包名或地址」里填 `dsh-theone`，点击安装。
 3. 点击左侧 **TheOne · 主聊天**，开始说话。
 
-命令行安装：`dsh plugin --profile web add github:YunongDai2005/dsh-theone --ignore-scripts`。兼容 DSH `0.2.0-rc.2` 与 Node.js 24；界面跟随 DSH 的语言（简体中文 / English）。也可以从 npm 安装 `dsh-theone`，但 DSH 的包管理器只接受发布满 24 小时的版本，所以用 GitHub 地址安装能最早拿到新版本。遇到这种情况，更新按钮会说明原因，并可以只为 TheOne 放行、立即安装。
+就这三步。兼容 DSH `0.2.0-rc.2` 与 Node.js 24；界面跟随 DSH 的语言（简体中文 / English）。
+
+<details>
+<summary><b>第一次用 DSH？手把手来一遍（约 3 分钟）</b></summary>
+
+不用懂代码，跟着做就行：
+
+1. **先让 DSH 自己能聊天。** 在 DSH 的设置里填好模型服务的 API Key（比如 DeepSeek 的），新建一个普通会话发一句「你好」。能收到回复，说明这一步好了。TheOne 用的就是这个模型，不用再填别的 Key。
+2. **装 TheOne。** 点左侧的 **插件**，再点 **添加插件**，在「包名或地址」一栏输入：
+
+   ```
+   dsh-theone
+   ```
+
+   点安装，等它跑完。
+3. **开始用。** 左侧会多出一个 **TheOne · 主聊天**。点进去，把你手头的事一件件说出来就行：今天的工作、周末的旅行、要写的论文……不用新建会话，也不用起名字。
+4. **以后更新。** 有新版本时，TheOne 入口右边会出现一个下载图标，点一下就装好，不用重启。
+5. **不想用了？** 在插件页卸载即可。你原来的 DSH 会话都还在，TheOne 只是帮你整理，从来不删它们。
+
+**可能遇到的小状况**
+
+- **提示版本「太新」、装不上：** DSH 默认只安装发布满 24 小时的版本，这是它的安全规则，不是出错。可以等一天再装，也可以改填 GitHub 地址 `https://github.com/YunongDai2005/dsh-theone`，马上就能装。
+- **装完左侧没看到 TheOne：** 重启一下 DSH。
+- **会不会很费钱：** 每条消息多一次很短的分类调用（关闭深度思考，输出不超过 2048 token），「好的」「继续」这类连调用都省了。装好后它会在后台把你已有的会话整理成话题目录，会话多的话，这一次会用掉一些额度；不需要的话可以在设置里关掉「历史整理」。
+</details>
+
+<details>
+<summary><b>命令行安装与其他方式</b></summary>
+
+- npm：`dsh plugin --profile web add dsh-theone --ignore-scripts`（桌面端把 `web` 换成 `desktop`）
+- GitHub（总是最新的 main）：`dsh plugin --profile web add github:YunongDai2005/dsh-theone --ignore-scripts`
+
+从 npm 安装的新版本要发布满 24 小时才装得上；遇到这种情况，更新按钮会说明原因，并可以只为 TheOne 放行、立即安装。
+</details>
 
 > 非官方社区项目，由社区成员独立维护，与 DeepSeek 不存在隶属或背书关系。
 
+## 它分得有多准
+
+口说无凭，我们做了一套公开评测 **InterleaveBench**：模拟一个人在同一个对话框里同时推进 3–5 件事（旅行、记账、论文、健身……），中英文各半，共 50 段对话、2466 条消息，每条消息属于哪件事都事先定好。再用 TheOne 自己的路由代码、DeepSeek V4.1 Flash 逐条重放（开发集 40 段；连人都分不清的消息不计分）：
+
+| 做法 | 分对的比例 |
+| --- | --- |
+| TheOne，事先给好话题列表 | **91.6%** |
+| TheOne，从零开始边聊边建话题（就是你第一次用的样子） | **86.6%** |
+| 关键词检索（BM25），事先给好话题列表 | 73.3% |
+| 什么都不分，全塞进一个会话 | 44.5% |
+| 关键词检索，从零开始 | 39.9% |
+| 每句话都开一个新话题 | 9.8% |
+
+几个值得一说的数字：
+
+- **把一件事的消息放进另一件事的话题**（最伤上下文的那种错）：从零开始时约占 3.7%。
+- 现在最主要的毛病是**太爱开新话题**：同一件事平均被拆成 2.1 个话题。0.3.21 的「话题卡片」就是冲着它去的。
+- 整套评测花了大约 1 美元。数据、代码和打分脚本都在 [`eval/`](./eval/README.md)，可以自己复现，换成别的模型也行。
+
+评测数据是模型按剧本生成的，而且这一版还没有助手回复，所以它衡量的是「能不能分对」，不代表真实聊天体验的全部。
+
 ## 它是怎么工作的
 
 **分配话题。** 每条消息先判断：接着当前话题、回到某个旧话题，还是开个新的。默认用你选的模型做一次简短分类（关闭深度思考，最多 2048 token），候选话题由 DSH 全文搜索召回。
@@ -89,6 +136,8 @@
 | --- | --- |
 | 话题提示 | 主聊天里怎样显示话题切换：隐藏、仅切换时显示一行（默认）、每条都显示并注明原因 |
 | 联动范围 | 自动学习（默认）、仅同一工作区、关闭 |
+| 共享已确认的要点（实验） | 默认关闭。话题之间只共享用户亲自确认过的要点（数字、决定、文件位置），带版本和出处；要点改了或撤回了，用到它的话题会收到提示。重启 DSH 后生效 |
+| 自动记录要点（实验） | 默认关闭。开启共享后，每轮结束多用一次小模型调用，补记后台会话没记下的要点；只有用户确认过的才会共享 |
 | 模型 | 跟随 DSH（默认），或从 DSH 已配置的模型中固定后台模型；固定的设置优先于主聊天里的选择 |
 | 路由方式 | LLM 判断（默认）或规则判断 |
 | 历史整理 | 开关与补扫间隔 |
@@ -136,6 +185,19 @@ npm test
 服务接口：`ctx.theone.searchHistoryDetailed(contextId, query, limit)` 检索话题的已审核历史；`store.addSource(contextId, sessionId, { startSeq, endSeq })` 关联会话的一部分。旧版本验收记录见 [v0.1](./docs/plugin-v0.1.zh.md) 和 [v0.2](./docs/plugin-v0.2.zh.md)。
 </details>
 
+<details>
+<summary>🥚</summary>
+
+<br>
+
+恭喜，你找到了彩蛋。
+
+在评测里，TheOne 犯过一个很有人味的错：用户说「咖啡店秋季新品本来定 9 月 25 上，现在想推到 10 月 8 号」，它把这句话放进了「国庆云南六日游」，因为都在十月。
+
+我们还在调教它，0.3.21 的话题卡片就是这么来的。如果你也被它分错了，在主聊天里说一句「分错了」就行，它会记住，不会生气。
+
+</details>
+
 ---
 
 <p align="center">觉得有用的话，点个 ⭐ 让更多人看到。遇到问题或有想法，欢迎 <a href="https://github.com/YunongDai2005/dsh-theone/issues">提 Issue</a>。</p>

package/dist/catalog-types.d.ts

@@ -5,9 +5,13 @@ export interface TopicGroup {
     summary: string;
     contextIds: string[];
 }
+/** Every conversation a topic draws on is gone from disk (`orphaned`) or archived in DSH (`archived`). */
+export type HiddenReason = 'orphaned' | 'archived';
+/** `hidden` says why routing and briefings skip this topic; the directory still lists it. */
 export interface CatalogContext extends ContextDescriptor {
     workingSessionId: string;
     sourceSessionIds: string[];
+    hidden?: HiddenReason;
 }
 export interface CatalogStatus {
     running: boolean;
@@ -18,6 +22,7 @@ export interface CatalogStatus {
     pending: number;
     lastCompletedAt?: number;
     searchUnavailable?: boolean;
+    hidden?: number;
 }
 export type LinkReasonName = 'manual' | 'workspace' | 'project' | 'entities' | 'learned' | 'request';
 export interface TopicLinkView {

package/dist/client-locales.d.ts

@@ -7,6 +7,10 @@ export declare const zh: {
     readonly retry: "重试";
     readonly 'settings.other': "其他";
     readonly 'settings.notices': "显示公告";
+    readonly 'settings.factLinks': "共享已确认的要点（实验）";
+    readonly 'settings.help.factLinks': "话题之间只共享用户亲自确认过的要点（数字、决定、文件位置），带版本和出处；要点改了或撤回了，用到它的话题会收到提示。默认关闭，重启 DSH 后生效。";
+    readonly 'settings.factExtraction': "自动记录要点（实验）";
+    readonly 'settings.help.factExtraction': "开启「共享已确认的要点」后，每轮结束多用一次小模型调用，补记后台会话没记下的要点；同样只有用户确认过的才会共享。默认关闭，重启 DSH 后生效。";
     readonly 'settings.help.notices': "显示 TheOne 作者发布的公告（新版本、重要提醒等）。只从 yulid.org 读取一个公告文件，不发送任何你的数据。";
     readonly 'notice.label': "公告";
     readonly 'notice.more': "查看详情";
@@ -39,6 +43,8 @@ export declare const zh: {
     readonly 'update.busy': "有回复正在进行，等它结束后再点更新。";
     readonly 'update.tooNew': "DSH 的安全策略只允许安装发布满 24 小时的版本，这一版还太新。过一阵再点一次即可。";
     readonly 'update.network': "连不上下载源，请检查网络后点击重试。";
+    readonly 'update.otherAge': "pnpm 拒绝安装：{names} 也是发布不满 24 小时的版本，不归 TheOne 放行。等它满 24 小时后再点一次。";
+    readonly 'update.ageStill': "已为 TheOne 放行，pnpm 仍然拒绝：{detail}。完整日志在 DSH 配置目录的 .plugin-manager/logs 里。";
     readonly 'update.failed': "更新失败";
     readonly 'update.hint': "当前 {current}，可更新到 {latest}。点击一键更新，不用重启 DSH。";
     readonly 'update.manualHint': "当前 {current}，最新 {latest}。这份插件不是从 GitHub 或 npm 安装的，请在「插件」页面重新安装。";
@@ -147,6 +153,8 @@ export declare const zh: {
     readonly 'topic.source': "查看原会话";
     readonly 'topic.state': "进展：";
     readonly 'topic.constraints': "约束：";
+    readonly 'topic.hiddenOrphaned': "来源会话已从磁盘上消失：本话题不再参与路由，删除即可从目录移除。";
+    readonly 'topic.hiddenArchived': "来源会话已归档：本话题不再参与路由，取消归档或删除它即可。";
     readonly 'manage.open': "管理";
     readonly 'manage.close': "收起";
     readonly 'manage.title': "标题";

package/dist/client-locales.js

@@ -7,6 +7,10 @@ export const zh = {
     'retry': '重试',
     'settings.other': "其他",
     'settings.notices': "显示公告",
+    'settings.factLinks': "共享已确认的要点（实验）",
+    'settings.help.factLinks': "话题之间只共享用户亲自确认过的要点（数字、决定、文件位置），带版本和出处；要点改了或撤回了，用到它的话题会收到提示。默认关闭，重启 DSH 后生效。",
+    'settings.factExtraction': "自动记录要点（实验）",
+    'settings.help.factExtraction': "开启「共享已确认的要点」后，每轮结束多用一次小模型调用，补记后台会话没记下的要点；同样只有用户确认过的才会共享。默认关闭，重启 DSH 后生效。",
     'settings.help.notices': "显示 TheOne 作者发布的公告（新版本、重要提醒等）。只从 yulid.org 读取一个公告文件，不发送任何你的数据。",
     'notice.label': "公告",
     'notice.more': "查看详情",
@@ -39,6 +43,8 @@ export const zh = {
     'update.busy': '有回复正在进行，等它结束后再点更新。',
     'update.tooNew': 'DSH 的安全策略只允许安装发布满 24 小时的版本，这一版还太新。过一阵再点一次即可。',
     'update.network': '连不上下载源，请检查网络后点击重试。',
+    'update.otherAge': 'pnpm 拒绝安装：{names} 也是发布不满 24 小时的版本，不归 TheOne 放行。等它满 24 小时后再点一次。',
+    'update.ageStill': '已为 TheOne 放行，pnpm 仍然拒绝：{detail}。完整日志在 DSH 配置目录的 .plugin-manager/logs 里。',
     'update.failed': '更新失败',
     'update.hint': '当前 {current}，可更新到 {latest}。点击一键更新，不用重启 DSH。',
     'update.manualHint': '当前 {current}，最新 {latest}。这份插件不是从 GitHub 或 npm 安装的，请在「插件」页面重新安装。',
@@ -147,6 +153,8 @@ export const zh = {
     'topic.source': '查看原会话',
     'topic.state': '进展：',
     'topic.constraints': '约束：',
+    'topic.hiddenOrphaned': '来源会话已从磁盘上消失：本话题不再参与路由，删除即可从目录移除。',
+    'topic.hiddenArchived': '来源会话已归档：本话题不再参与路由，取消归档或删除它即可。',
     'manage.open': '管理',
     'manage.close': '收起',
     'manage.title': '标题',
@@ -216,6 +224,10 @@ export const en = {
     'retry': 'Retry',
     'settings.other': "Other",
     'settings.notices': "Show notices",
+    'settings.factLinks': "Share confirmed facts (experimental)",
+    'settings.help.factLinks': "Topics share only facts the user confirmed (figures, decisions, file locations), with version and source; when one changes or is withdrawn, topics that used it are told. Off by default; takes effect after DSH restarts.",
+    'settings.factExtraction': "Record facts automatically (experimental)",
+    'settings.help.factExtraction': "With shared facts on, one small model call after each turn records facts the topic session left out; again only facts the user confirmed are shared. Off by default; takes effect after DSH restarts.",
     'settings.help.notices': "Show notices from TheOne's author (new versions, important reminders). TheOne only reads one notice file from yulid.org and sends none of your data.",
     'notice.label': "Notice",
     'notice.more': "Read more",
@@ -248,6 +260,8 @@ export const en = {
     'update.busy': 'A reply is in progress. Update once it finishes.',
     'update.tooNew': 'DSH only installs versions published at least 24 hours ago, as a safety policy, and this one is newer. Try again later.',
     'update.network': 'Could not reach the download source. Check the network and click to retry.',
+    'update.otherAge': 'pnpm refused: {names} is also less than 24 hours old, and only TheOne is exempted. Try again once it is a day old.',
+    'update.ageStill': 'TheOne is exempted, but pnpm still refused: {detail}. The full log is in .plugin-manager/logs in the DSH profile folder.',
     'update.failed': 'Update failed',
     'update.hint': 'You have {current}; {latest} is available. Click to update without restarting DSH.',
     'update.manualHint': 'You have {current}; {latest} is available. This copy was not installed from GitHub or npm, so reinstall it from the Plugins page.',
@@ -356,6 +370,8 @@ export const en = {
     'topic.source': 'View original chat',
     'topic.state': 'Progress:',
     'topic.constraints': 'Constraints:',
+    'topic.hiddenOrphaned': 'Its conversations are gone from disk: this topic no longer takes part in routing. Delete it to remove it from the directory.',
+    'topic.hiddenArchived': 'Its conversations are archived: this topic no longer takes part in routing. Unarchive or delete it.',
     'manage.open': 'Manage',
     'manage.close': 'Close',
     'manage.title': 'Title',

package/dist/client.js

@@ -39,7 +39,9 @@ var EDITABLE_SETTINGS_KEYS = [
   "linkScope",
   "routeNotice",
   "contextsPath",
-  "notices"
+  "notices",
+  "factLinks",
+  "factExtraction"
 ];
 
 // src/client-navigation.ts
@@ -91,6 +93,10 @@ var zh = {
   "retry": "\u91CD\u8BD5",
   "settings.other": "\u5176\u4ED6",
   "settings.notices": "\u663E\u793A\u516C\u544A",
+  "settings.factLinks": "\u5171\u4EAB\u5DF2\u786E\u8BA4\u7684\u8981\u70B9\uFF08\u5B9E\u9A8C\uFF09",
+  "settings.help.factLinks": "\u8BDD\u9898\u4E4B\u95F4\u53EA\u5171\u4EAB\u7528\u6237\u4EB2\u81EA\u786E\u8BA4\u8FC7\u7684\u8981\u70B9\uFF08\u6570\u5B57\u3001\u51B3\u5B9A\u3001\u6587\u4EF6\u4F4D\u7F6E\uFF09\uFF0C\u5E26\u7248\u672C\u548C\u51FA\u5904\uFF1B\u8981\u70B9\u6539\u4E86\u6216\u64A4\u56DE\u4E86\uFF0C\u7528\u5230\u5B83\u7684\u8BDD\u9898\u4F1A\u6536\u5230\u63D0\u793A\u3002\u9ED8\u8BA4\u5173\u95ED\uFF0C\u91CD\u542F DSH \u540E\u751F\u6548\u3002",
+  "settings.factExtraction": "\u81EA\u52A8\u8BB0\u5F55\u8981\u70B9\uFF08\u5B9E\u9A8C\uFF09",
+  "settings.help.factExtraction": "\u5F00\u542F\u300C\u5171\u4EAB\u5DF2\u786E\u8BA4\u7684\u8981\u70B9\u300D\u540E\uFF0C\u6BCF\u8F6E\u7ED3\u675F\u591A\u7528\u4E00\u6B21\u5C0F\u6A21\u578B\u8C03\u7528\uFF0C\u8865\u8BB0\u540E\u53F0\u4F1A\u8BDD\u6CA1\u8BB0\u4E0B\u7684\u8981\u70B9\uFF1B\u540C\u6837\u53EA\u6709\u7528\u6237\u786E\u8BA4\u8FC7\u7684\u624D\u4F1A\u5171\u4EAB\u3002\u9ED8\u8BA4\u5173\u95ED\uFF0C\u91CD\u542F DSH \u540E\u751F\u6548\u3002",
   "settings.help.notices": "\u663E\u793A TheOne \u4F5C\u8005\u53D1\u5E03\u7684\u516C\u544A\uFF08\u65B0\u7248\u672C\u3001\u91CD\u8981\u63D0\u9192\u7B49\uFF09\u3002\u53EA\u4ECE yulid.org \u8BFB\u53D6\u4E00\u4E2A\u516C\u544A\u6587\u4EF6\uFF0C\u4E0D\u53D1\u9001\u4EFB\u4F55\u4F60\u7684\u6570\u636E\u3002",
   "notice.label": "\u516C\u544A",
   "notice.more": "\u67E5\u770B\u8BE6\u60C5",
@@ -123,6 +129,8 @@ var zh = {
   "update.busy": "\u6709\u56DE\u590D\u6B63\u5728\u8FDB\u884C\uFF0C\u7B49\u5B83\u7ED3\u675F\u540E\u518D\u70B9\u66F4\u65B0\u3002",
   "update.tooNew": "DSH \u7684\u5B89\u5168\u7B56\u7565\u53EA\u5141\u8BB8\u5B89\u88C5\u53D1\u5E03\u6EE1 24 \u5C0F\u65F6\u7684\u7248\u672C\uFF0C\u8FD9\u4E00\u7248\u8FD8\u592A\u65B0\u3002\u8FC7\u4E00\u9635\u518D\u70B9\u4E00\u6B21\u5373\u53EF\u3002",
   "update.network": "\u8FDE\u4E0D\u4E0A\u4E0B\u8F7D\u6E90\uFF0C\u8BF7\u68C0\u67E5\u7F51\u7EDC\u540E\u70B9\u51FB\u91CD\u8BD5\u3002",
+  "update.otherAge": "pnpm \u62D2\u7EDD\u5B89\u88C5\uFF1A{names} \u4E5F\u662F\u53D1\u5E03\u4E0D\u6EE1 24 \u5C0F\u65F6\u7684\u7248\u672C\uFF0C\u4E0D\u5F52 TheOne \u653E\u884C\u3002\u7B49\u5B83\u6EE1 24 \u5C0F\u65F6\u540E\u518D\u70B9\u4E00\u6B21\u3002",
+  "update.ageStill": "\u5DF2\u4E3A TheOne \u653E\u884C\uFF0Cpnpm \u4ECD\u7136\u62D2\u7EDD\uFF1A{detail}\u3002\u5B8C\u6574\u65E5\u5FD7\u5728 DSH \u914D\u7F6E\u76EE\u5F55\u7684 .plugin-manager/logs \u91CC\u3002",
   "update.failed": "\u66F4\u65B0\u5931\u8D25",
   "update.hint": "\u5F53\u524D {current}\uFF0C\u53EF\u66F4\u65B0\u5230 {latest}\u3002\u70B9\u51FB\u4E00\u952E\u66F4\u65B0\uFF0C\u4E0D\u7528\u91CD\u542F DSH\u3002",
   "update.manualHint": "\u5F53\u524D {current}\uFF0C\u6700\u65B0 {latest}\u3002\u8FD9\u4EFD\u63D2\u4EF6\u4E0D\u662F\u4ECE GitHub \u6216 npm \u5B89\u88C5\u7684\uFF0C\u8BF7\u5728\u300C\u63D2\u4EF6\u300D\u9875\u9762\u91CD\u65B0\u5B89\u88C5\u3002",
@@ -231,6 +239,8 @@ var zh = {
   "topic.source": "\u67E5\u770B\u539F\u4F1A\u8BDD",
   "topic.state": "\u8FDB\u5C55\uFF1A",
   "topic.constraints": "\u7EA6\u675F\uFF1A",
+  "topic.hiddenOrphaned": "\u6765\u6E90\u4F1A\u8BDD\u5DF2\u4ECE\u78C1\u76D8\u4E0A\u6D88\u5931\uFF1A\u672C\u8BDD\u9898\u4E0D\u518D\u53C2\u4E0E\u8DEF\u7531\uFF0C\u5220\u9664\u5373\u53EF\u4ECE\u76EE\u5F55\u79FB\u9664\u3002",
+  "topic.hiddenArchived": "\u6765\u6E90\u4F1A\u8BDD\u5DF2\u5F52\u6863\uFF1A\u672C\u8BDD\u9898\u4E0D\u518D\u53C2\u4E0E\u8DEF\u7531\uFF0C\u53D6\u6D88\u5F52\u6863\u6216\u5220\u9664\u5B83\u5373\u53EF\u3002",
   "manage.open": "\u7BA1\u7406",
   "manage.close": "\u6536\u8D77",
   "manage.title": "\u6807\u9898",
@@ -300,6 +310,10 @@ var en = {
   "retry": "Retry",
   "settings.other": "Other",
   "settings.notices": "Show notices",
+  "settings.factLinks": "Share confirmed facts (experimental)",
+  "settings.help.factLinks": "Topics share only facts the user confirmed (figures, decisions, file locations), with version and source; when one changes or is withdrawn, topics that used it are told. Off by default; takes effect after DSH restarts.",
+  "settings.factExtraction": "Record facts automatically (experimental)",
+  "settings.help.factExtraction": "With shared facts on, one small model call after each turn records facts the topic session left out; again only facts the user confirmed are shared. Off by default; takes effect after DSH restarts.",
   "settings.help.notices": "Show notices from TheOne's author (new versions, important reminders). TheOne only reads one notice file from yulid.org and sends none of your data.",
   "notice.label": "Notice",
   "notice.more": "Read more",
@@ -332,6 +346,8 @@ var en = {
   "update.busy": "A reply is in progress. Update once it finishes.",
   "update.tooNew": "DSH only installs versions published at least 24 hours ago, as a safety policy, and this one is newer. Try again later.",
   "update.network": "Could not reach the download source. Check the network and click to retry.",
+  "update.otherAge": "pnpm refused: {names} is also less than 24 hours old, and only TheOne is exempted. Try again once it is a day old.",
+  "update.ageStill": "TheOne is exempted, but pnpm still refused: {detail}. The full log is in .plugin-manager/logs in the DSH profile folder.",
   "update.failed": "Update failed",
   "update.hint": "You have {current}; {latest} is available. Click to update without restarting DSH.",
   "update.manualHint": "You have {current}; {latest} is available. This copy was not installed from GitHub or npm, so reinstall it from the Plugins page.",
@@ -440,6 +456,8 @@ var en = {
   "topic.source": "View original chat",
   "topic.state": "Progress:",
   "topic.constraints": "Constraints:",
+  "topic.hiddenOrphaned": "Its conversations are gone from disk: this topic no longer takes part in routing. Delete it to remove it from the directory.",
+  "topic.hiddenArchived": "Its conversations are archived: this topic no longer takes part in routing. Unarchive or delete it.",
   "manage.open": "Manage",
   "manage.close": "Close",
   "manage.title": "Title",
@@ -598,7 +616,7 @@ function apply(ctx) {
         cache: "no-store",
         ...body ? { headers: { "content-type": "application/json" }, body: JSON.stringify(body) } : {}
       });
-      if (response.ok || response.status === 409) setUpdate(await response.json());
+      if (response.ok || response.status === 409 || response.status === 400) setUpdate(await response.json());
       if (update?.state === "reloading") void awaitReload(update.current);
     } catch {
     }
@@ -715,13 +733,13 @@ function apply(ctx) {
     const waiting = !!status?.waiting && !status.available && !status.state;
     if (!status || !status.available && !status.state && !waiting) return null;
     const label = waiting ? t2("update.waiting") : status.state === "installing" ? t2("update.installing") : status.state === "reloading" ? t2("update.reloading") : status.state === "restart" ? t2("update.restart") : status.state === "failed" ? t2("update.failed") : t2("update.available");
-    const hint = waiting ? t2("update.waitingHint", { latest: status.waiting.version }) : status.error === "GATEWAY_BUSY" ? t2("update.busy") : status.state === "reloading" ? t2("update.reloadingHint") : status.state === "restart" ? t2("update.restartHint") : status.state === "failed" ? status.error === "MINIMUM_RELEASE_AGE" ? t2("update.tooNew") : status.error === "NETWORK" ? t2("update.network") : t2("update.failedHint", { error: status.error ?? "" }) : status.installable ? t2("update.hint", { current: status.current, latest: status.latest ?? "" }) : t2("update.manualHint", { current: status.current, latest: status.latest ?? "" });
+    const hint = waiting ? t2("update.waitingHint", { latest: status.waiting.version }) : status.error === "GATEWAY_BUSY" ? t2("update.busy") : status.state === "reloading" ? t2("update.reloadingHint") : status.state === "restart" ? t2("update.restartHint") : status.state === "failed" ? status.error === "OTHER_RELEASE_AGE" ? t2("update.otherAge", { names: status.detail ?? "" }) : status.error === "MINIMUM_RELEASE_AGE" ? status.exempt ? t2("update.ageStill", { detail: status.detail ?? "" }) : t2("update.tooNew") : status.error === "NETWORK" ? t2("update.network") : t2("update.failedHint", { error: status.detail ?? status.error ?? "" }) : status.installable ? t2("update.hint", { current: status.current, latest: status.latest ?? "" }) : t2("update.manualHint", { current: status.current, latest: status.latest ?? "" });
     const title = `${label} \xB7 ${hint}`;
     const act = (event) => {
       event.preventDefault();
       event.stopPropagation();
       if (status.state === "installing" || status.state === "reloading" || status.state === "restart") return;
-      if (waiting || status.state === "failed" && status.error === "MINIMUM_RELEASE_AGE") {
+      if (!status.exempt && (waiting || status.state === "failed" && status.error === "MINIMUM_RELEASE_AGE")) {
         openReleaseAgeDialog(status);
         return;
       }
@@ -1271,7 +1289,7 @@ ${body}` }, (0, import_react.createElement)("strong", null, title), " ", body),
     const groups = [
       ["models", ["workerProvider", "workerModel", "routerMode"]],
       ["history", ["historyCatalog", "catalogIntervalMs"]],
-      ["linkage", ["linkScope", "routeNotice"]],
+      ["linkage", ["linkScope", "routeNotice", "factLinks", "factExtraction"]],
       ["limits", ["maxDescriptorChars", "maxResponseChars"]],
       ["storage", ["contextsPath", "databasePath", "gatewayKey"]],
       ["other", ["notices"]]
@@ -1331,7 +1349,7 @@ ${body}` }, (0, import_react.createElement)("strong", null, title), " ", body),
         { ...props, value, required: field === "workerModel" && !!draft.workerProvider, onChange: (event) => selectValue(event.target.value) },
         ...choices.map((choice) => (0, import_react.createElement)("option", { key: choice.value, value: choice.value }, choice.label))
       );
-      if (field === "historyCatalog" || field === "notices") return select(String(draft[field]), [{ value: "true", label: t2("settings.on") }, { value: "false", label: t2("settings.off") }], (v) => change(field, v === "true"));
+      if (field === "historyCatalog" || field === "notices" || field === "factLinks" || field === "factExtraction") return select(String(draft[field]), [{ value: "true", label: t2("settings.on") }, { value: "false", label: t2("settings.off") }], (v) => change(field, v === "true"));
       if (field === "linkScope" || field === "routeNotice") {
         const values = field === "linkScope" ? ["auto", "workspace", "off"] : ["switch", "hidden", "all"];
         return select(draft[field], values.map((value) => ({ value, label: t2(`settings.${field === "linkScope" ? "scope" : "notice"}.${value}`) })), (v) => change(field, v));
@@ -1883,6 +1901,7 @@ ${body}` }, (0, import_react.createElement)("strong", null, title), " ", body),
             { key: id, className: "theone-topic-card" },
             (0, import_react.createElement)("h3", null, topic.title),
             (0, import_react.createElement)("p", null, topic.summary),
+            topic.hidden ? (0, import_react.createElement)("p", { className: "theone-topic-warning" }, t2(topic.hidden === "archived" ? "topic.hiddenArchived" : "topic.hiddenOrphaned")) : null,
             topic.lastState ? (0, import_react.createElement)("p", { className: "theone-topic-state" }, (0, import_react.createElement)("span", null, t2("topic.state")), topic.lastState) : null,
             constraints ? (0, import_react.createElement)("p", { className: "theone-topic-state" }, (0, import_react.createElement)("span", null, t2("topic.constraints")), constraints) : null,
             linkRow(id),
@@ -2009,7 +2028,7 @@ button:has(.theone-nav[data-wide=true])>span:has(.theone-nav){flex:1;min-width:0
 var catalogCss = `
 button:has(.theone-catalog-entry)>span:not(:has(.theone-catalog-entry)){display:none}
 .theone-catalog{padding:32px;max-width:1180px;margin:auto;box-sizing:border-box;height:100%;overflow:auto;color:var(--dsw-alias-label-primary)}
-.theone-catalog-header{display:flex;justify-content:space-between;align-items:center;gap:16px}.theone-catalog h1{font-size:24px;margin:0 0 8px}.theone-catalog-header p,.theone-catalog-status,.theone-group-summary{opacity:.65;margin:0 0 18px;line-height:1.6}.theone-catalog button{border:1px solid #8883;border-radius:9px;padding:8px 13px;background:transparent;color:inherit;cursor:pointer;font:inherit;white-space:nowrap}.theone-catalog button:disabled{opacity:.5;cursor:default}.theone-catalog-groups{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,310px),1fr));gap:20px}.theone-topic-group{border:1px solid #8882;border-radius:16px;padding:20px;background:#88805}.theone-topic-group h2{font-size:18px;margin:0 0 8px}.theone-topic-group h2 span{font-size:13px;opacity:.5}.theone-topic-card{border-top:1px solid #8882;padding:16px 0}.theone-topic-card:last-child{padding-bottom:0}.theone-topic-card h3{font-size:15px;line-height:1.5;margin:0 0 7px}.theone-topic-card p{font-size:13px;line-height:1.7;opacity:.75;margin:0 0 12px;display:-webkit-box;-webkit-line-clamp:4;-webkit-box-orient:vertical;overflow:hidden}.theone-topic-actions{display:flex;gap:8px;flex-wrap:wrap}.theone-topic-actions button{font-size:12px}.theone-topic-actions .theone-source-link{border-color:transparent;opacity:.6}.theone-catalog-warning{background:#ff900011;padding:12px;border-radius:10px;font-size:13px}.theone-catalog-entry{display:flex;align-items:center;gap:10px;font-size:14px}.theone-catalog-empty{padding:40px 0;opacity:.65;line-height:1.8}.theone-catalog-tools{display:flex;gap:8px;flex-wrap:wrap;justify-content:flex-end}.theone-topic-links{display:flex;flex-wrap:wrap;align-items:center;gap:6px;margin:0 0 12px;font-size:12px}.theone-links-label,.theone-links-empty{opacity:.6}.theone-link-chip{display:inline-flex;align-items:center;gap:2px;border:1px solid #8883;border-radius:999px;padding:2px 4px 2px 9px}.theone-catalog .theone-link-chip button{border:0;padding:0 5px;opacity:.6;font-size:13px;line-height:1}.theone-topic-links select{font:inherit;font-size:12px;color:inherit;background:transparent;border:1px solid #8883;border-radius:8px;padding:2px 6px}.theone-link-private{display:inline-flex;align-items:center;gap:4px;opacity:.75;cursor:pointer}.theone-topic-card .theone-topic-state{font-size:12px;opacity:.8;-webkit-line-clamp:3}.theone-topic-state span{opacity:.6;margin-right:4px}.theone-manage{display:flex;flex-direction:column;gap:10px;margin-top:12px;padding:14px;border:1px solid #8883;border-radius:12px;font-size:12px}.theone-create{flex-direction:row;flex-wrap:wrap;align-items:center;margin:0 0 18px}.theone-create input{flex:1;min-width:180px}.theone-manage-field{display:flex;flex-direction:column;gap:5px}.theone-manage-field>span{opacity:.65}.theone-manage input,.theone-manage textarea,.theone-manage select,.theone-routes select{font:inherit;font-size:12px;color:inherit;background:transparent;border:1px solid #8883;border-radius:8px;padding:6px 8px;box-sizing:border-box;min-width:0}.theone-manage textarea{resize:vertical;width:100%}.theone-manage-row{display:flex;flex-wrap:wrap;gap:8px;align-items:center}.theone-manage-row select,.theone-manage-row input{flex:1;min-width:140px}.theone-manage-hint{opacity:.6;font-size:12px;line-height:1.6;margin:0}.theone-catalog .theone-danger{color:#c4402f;border-color:#c4402f55}.theone-routes{border:1px solid #8882;border-radius:16px;padding:14px 20px;margin:0 0 20px}.theone-routes summary{cursor:pointer;font-weight:500}.theone-routes summary span{opacity:.5;font-size:13px}.theone-routes ol{list-style:none;margin:12px 0 0;padding:0;display:flex;flex-direction:column;gap:10px}.theone-routes li{border-top:1px solid #8882;padding-top:10px;font-size:12px;display:flex;flex-direction:column;gap:5px}.theone-route-head{display:flex;gap:10px;min-width:0}.theone-route-head time{opacity:.55;flex:none}.theone-route-head q{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.theone-route-body{display:flex;flex-wrap:wrap;gap:8px;align-items:center}.theone-route-body small{opacity:.6}.theone-route-fixed{opacity:.75}.theone-route-stats{margin-left:10px;font-weight:400;opacity:.6;font-size:12px}@media(max-width:640px){.theone-catalog{padding:20px}.theone-catalog-header{align-items:flex-start}.theone-catalog-header h1{font-size:21px}}
+.theone-catalog-header{display:flex;justify-content:space-between;align-items:center;gap:16px}.theone-catalog h1{font-size:24px;margin:0 0 8px}.theone-catalog-header p,.theone-catalog-status,.theone-group-summary{opacity:.65;margin:0 0 18px;line-height:1.6}.theone-catalog button{border:1px solid #8883;border-radius:9px;padding:8px 13px;background:transparent;color:inherit;cursor:pointer;font:inherit;white-space:nowrap}.theone-catalog button:disabled{opacity:.5;cursor:default}.theone-catalog-groups{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,310px),1fr));gap:20px}.theone-topic-group{border:1px solid #8882;border-radius:16px;padding:20px;background:#88805}.theone-topic-group h2{font-size:18px;margin:0 0 8px}.theone-topic-group h2 span{font-size:13px;opacity:.5}.theone-topic-card{border-top:1px solid #8882;padding:16px 0}.theone-topic-card:last-child{padding-bottom:0}.theone-topic-card h3{font-size:15px;line-height:1.5;margin:0 0 7px}.theone-topic-card p{font-size:13px;line-height:1.7;opacity:.75;margin:0 0 12px;display:-webkit-box;-webkit-line-clamp:4;-webkit-box-orient:vertical;overflow:hidden}.theone-topic-actions{display:flex;gap:8px;flex-wrap:wrap}.theone-topic-actions button{font-size:12px}.theone-topic-actions .theone-source-link{border-color:transparent;opacity:.6}.theone-catalog-warning{background:#ff900011;padding:12px;border-radius:10px;font-size:13px}.theone-topic-warning{font-size:12px;line-height:1.6;margin:0 0 12px;color:#d9480f}.theone-catalog-entry{display:flex;align-items:center;gap:10px;font-size:14px}.theone-catalog-empty{padding:40px 0;opacity:.65;line-height:1.8}.theone-catalog-tools{display:flex;gap:8px;flex-wrap:wrap;justify-content:flex-end}.theone-topic-links{display:flex;flex-wrap:wrap;align-items:center;gap:6px;margin:0 0 12px;font-size:12px}.theone-links-label,.theone-links-empty{opacity:.6}.theone-link-chip{display:inline-flex;align-items:center;gap:2px;border:1px solid #8883;border-radius:999px;padding:2px 4px 2px 9px}.theone-catalog .theone-link-chip button{border:0;padding:0 5px;opacity:.6;font-size:13px;line-height:1}.theone-topic-links select{font:inherit;font-size:12px;color:inherit;background:transparent;border:1px solid #8883;border-radius:8px;padding:2px 6px}.theone-link-private{display:inline-flex;align-items:center;gap:4px;opacity:.75;cursor:pointer}.theone-topic-card .theone-topic-state{font-size:12px;opacity:.8;-webkit-line-clamp:3}.theone-topic-state span{opacity:.6;margin-right:4px}.theone-manage{display:flex;flex-direction:column;gap:10px;margin-top:12px;padding:14px;border:1px solid #8883;border-radius:12px;font-size:12px}.theone-create{flex-direction:row;flex-wrap:wrap;align-items:center;margin:0 0 18px}.theone-create input{flex:1;min-width:180px}.theone-manage-field{display:flex;flex-direction:column;gap:5px}.theone-manage-field>span{opacity:.65}.theone-manage input,.theone-manage textarea,.theone-manage select,.theone-routes select{font:inherit;font-size:12px;color:inherit;background:transparent;border:1px solid #8883;border-radius:8px;padding:6px 8px;box-sizing:border-box;min-width:0}.theone-manage textarea{resize:vertical;width:100%}.theone-manage-row{display:flex;flex-wrap:wrap;gap:8px;align-items:center}.theone-manage-row select,.theone-manage-row input{flex:1;min-width:140px}.theone-manage-hint{opacity:.6;font-size:12px;line-height:1.6;margin:0}.theone-catalog .theone-danger{color:#c4402f;border-color:#c4402f55}.theone-routes{border:1px solid #8882;border-radius:16px;padding:14px 20px;margin:0 0 20px}.theone-routes summary{cursor:pointer;font-weight:500}.theone-routes summary span{opacity:.5;font-size:13px}.theone-routes ol{list-style:none;margin:12px 0 0;padding:0;display:flex;flex-direction:column;gap:10px}.theone-routes li{border-top:1px solid #8882;padding-top:10px;font-size:12px;display:flex;flex-direction:column;gap:5px}.theone-route-head{display:flex;gap:10px;min-width:0}.theone-route-head time{opacity:.55;flex:none}.theone-route-head q{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.theone-route-body{display:flex;flex-wrap:wrap;gap:8px;align-items:center}.theone-route-body small{opacity:.6}.theone-route-fixed{opacity:.75}.theone-route-stats{margin-left:10px;font-weight:400;opacity:.6;font-size:12px}@media(max-width:640px){.theone-catalog{padding:20px}.theone-catalog-header{align-items:flex-start}.theone-catalog-header h1{font-size:21px}}
 `;
 var composerCss = `
 .theone-bg{display:inline-flex;align-items:center;gap:5px;height:32px;padding:0 10px;border:0;border-radius:10px;background:transparent;color:var(--dsw-alias-label-primary);font:inherit;font-size:14px;white-space:nowrap;cursor:pointer;max-width:220px}

package/dist/fact-flow.d.ts

@@ -0,0 +1,39 @@
+import type { ContextStore } from './store.ts';
+import { type LinkScope } from './linkage.ts';
+import { type EvidenceEvent, type FactCandidate, type FactView } from './facts.ts';
+/** Confirmed facts this message might use, best first, within budget. Ranking only. */
+export declare function factCandidates(store: ContextStore, scope: LinkScope, text: string, recent: string[], currentId?: string): FactCandidate[];
+export interface FactDelivery {
+    notices: string[];
+    facts: string[];
+    /** Record what was sent; call only once the briefing carrying these lines is actually sent. */
+    commit(): void;
+}
+/**
+ * What a topic is told about facts before its Worker answers: changes to facts it used before
+ * (also on a plain "go on") and the facts this request imports. Every fact is checked here, against
+ * the topic finally chosen and the settings now; nothing is recorded until `commit`.
+ */
+export declare function factDelivery(store: ContextStore, scope: LinkScope, contextId: string, imports: string[], inputId?: string): FactDelivery;
+/** The topic's own recorded facts, with ids and versions, for its Worker's descriptor. */
+export declare function ownFactsText(store: ContextStore, contextId: string): string;
+/** Optional extraction after a turn; every item it returns is checked like a Worker's own record. */
+export declare const EXTRACT_PROMPT = "\u4F60\u5728\u5E2E\u4E00\u4E2A\u8BDD\u9898\u8BB0\u5F55\u5DF2\u7ECF\u786E\u5B9A\u4E0B\u6765\u7684\u8981\u70B9\uFF1A\u6570\u5B57\u3001\u65E5\u671F\u3001\u51B3\u5B9A\u3001\u6587\u4EF6\u6216\u94FE\u63A5\u7684\u4F4D\u7F6E\u3002\u8F93\u5165\u662F\u672C\u8F6E\u7684\u7528\u6237\u6D88\u606F user\u3001\u52A9\u624B\u56DE\u7B54 assistant\uFF0C\u4EE5\u53CA\u672C\u8BDD\u9898\u5DF2\u8BB0\u5F55\u7684\u8981\u70B9 facts\uFF08\u542B factId \u548C\u7248\u672C\uFF09\u3002\n\u53EA\u8BB0\u5F55\u7528\u6237\u4EB2\u53E3\u8BF4\u51FA\u7684\u503C\uFF0C\u6216\u7528\u6237\u660E\u786E\u63A5\u53D7\u4E86\u52A9\u624B\u63D0\u8BAE\u7684\u503C\uFF08\u6B64\u65F6 acceptsQuote \u586B\u52A9\u624B\u63D0\u8BAE\u7684\u539F\u8BDD\uFF09\uFF1B\u52A9\u624B\u81EA\u5DF1\u7684\u5EFA\u8BAE\u3001\u63A8\u6D4B\u3001\u672A\u5B9A\u7684\u4E8B\u4E0D\u8981\u8BB0\u5F55\u3002\n\u6BCF\u6761\u90FD\u5FC5\u987B\u7ED9\u51FA evidenceQuote\uFF1A\u672C\u8F6E\u5BF9\u8BDD\u91CC\u80FD\u8BC1\u660E\u5B83\u7684\u539F\u8BDD\uFF0C\u9010\u5B57\u590D\u5236\u3002\u5DF2\u8BB0\u5F55\u8FC7\u7684\u540C\u4E00\u4EF6\u4E8B\u7528\u5B83\u7684 factId \u66F4\u65B0\uFF1B\u7528\u6237\u8BF4\u67D0\u4E2A\u503C\u4E0D\u518D\u6210\u7ACB\u6216\u8FD8\u6CA1\u5B9A\u65F6\uFF0C\u8F93\u51FA op \u4E3A \"retract\" \u5E76\u7ED9\u51FA\u7528\u6237\u539F\u8BDD\u3002\u6CA1\u6709\u5C31\u8F93\u51FA\u7A7A\u6570\u7EC4\u3002\n\u53EA\u8F93\u51FA JSON \u6570\u7EC4\uFF0C\u4F8B\u5982 [{\"op\":\"set\",\"factId\":null,\"label\":\"\u9884\u7B97\",\"kind\":\"fact\",\"value\":\"800\",\"evidenceQuote\":\"\u9884\u7B97\u5B9A\u4E3A 800 \u5143\"}]\u3002kind \u53EA\u80FD\u662F fact\u3001decision\u3001artifact\u3002";
+/** The extraction request for the turn that just ended: cleaned, and within its size budget. */
+export declare function extractionPayload(events: readonly EvidenceEvent[], base: readonly FactView[]): {
+    user: string;
+    assistant: string;
+    facts: object[];
+} | undefined;
+/**
+ * Store what an extraction returned, by the same rules as a Worker's record: evidence is checked in
+ * the session, and every write expects the version the topic had when the turn ended, so a late
+ * extraction cannot overwrite a newer value. Returns how many items were stored.
+ */
+export declare function applyExtraction(store: ContextStore, input: {
+    sessionId: string;
+    contextId: string;
+    events: readonly EvidenceEvent[];
+    base: readonly FactView[];
+    items: unknown;
+}): number;