@kirkchinese/dsh-citeciter 0.9.0-beta.4 → 0.9.0-beta.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. package/README.md +9 -9
  2. package/README.zh.md +9 -9
  3. package/lib/client.js +471 -210
  4. package/lib/index.js +19 -18
  5. package/lib/{typert-common-BtQUArWP.js → typert-common-NL5W_N9Z.js} +1 -1
  6. package/lib/typert.host.js +2 -2
  7. package/lib/typert.remote-client.js +1 -1
  8. package/lib/types/actions.d.ts +2 -8
  9. package/lib/types/client/components/CiterTab.d.ts +3 -2
  10. package/lib/types/client/components/QuoteReference.d.ts +11 -0
  11. package/lib/types/client/components/SelectionToolbar.d.ts +2 -3
  12. package/lib/types/client/locales/index.d.ts +9 -3
  13. package/lib/types/client/locales/settings.d.ts +9 -3
  14. package/lib/types/client/main-quote.d.ts +54 -11
  15. package/lib/types/client/types.d.ts +5 -1
  16. package/lib/types/client/user-text-quote.d.ts +6 -0
  17. package/lib/types/topic.d.ts +1 -0
  18. package/lib/{update-D-jnLTb5.js → update-Bti3dxU-.js} +4 -1
  19. package/package.json +2 -1
package/README.md CHANGED
@@ -1,14 +1,14 @@
1
1
  # CiteCiter
2
2
 
3
- [简体中文](README.zh.md) · [npm](https://www.npmjs.com/package/@kirkchinese/dsh-citeciter) · [Changelog](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.4/CHANGELOG.md) · [Issues](https://github.com/kirkchinese/CiteCiter/issues)
3
+ [简体中文](README.zh.md) · [npm](https://www.npmjs.com/package/@kirkchinese/dsh-citeciter) · [Changelog](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.5/CHANGELOG.md) · [Issues](https://github.com/kirkchinese/CiteCiter/issues)
4
4
 
5
- ![CiteCiter](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.4/assets/hero/citeciter-hero.png)
5
+ ![CiteCiter](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.5/assets/hero/citeciter-hero.png)
6
6
 
7
7
  **The AI finished the task. I still want to understand how it did it.**
8
8
 
9
9
  CiteCiter is a [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) plugin that helps you learn from your agent's real work. Select part of a conversation, a tool result or a document, ask about it in a separate Topic that keeps its source, use a blackboard to see how the pieces relate, then return to your work. The main conversation is never modified.
10
10
 
11
- [![CiteCiter demo](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.4/assets/docs/video-cover.png)](https://www.bilibili.com/video/BV1tqeA65EJ8/)
11
+ [![CiteCiter demo](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.5/assets/docs/video-cover.png)](https://www.bilibili.com/video/BV1tqeA65EJ8/)
12
12
 
13
13
  [Watch the demo on Bilibili](https://www.bilibili.com/video/BV1tqeA65EJ8/) (recorded with an earlier version; the interface has changed slightly).
14
14
 
@@ -18,7 +18,7 @@ CiteCiter needs DSH and a working model. The plugin declares exact host versions
18
18
 
19
19
  | DSH version | CiteCiter version |
20
20
  | --- | --- |
21
- | `0.2.0-rc.2` (including the official Desktop), `0.2.1-alpha.1` through `0.2.1-alpha.5`, `0.2.1-rc.1`, `0.2.1-rc.2`, `0.2.1-rc.3` | `0.9.0-beta.4` |
21
+ | `0.2.0-rc.2` (including the official Desktop), `0.2.1-alpha.1` through `0.2.1-alpha.5`, `0.2.1-rc.1`, `0.2.1-rc.2`, `0.2.1-rc.3` | `0.9.0-beta.5` |
22
22
  | `0.1.7-rc.2` | `0.9.0-alpha.3` |
23
23
  | `0.1.5-rc.1` | `0.8.2` |
24
24
  | `0.1.2-rc.1` | `0.6.0` |
@@ -28,13 +28,13 @@ CiteCiter needs DSH and a working model. The plugin declares exact host versions
28
28
  **CLI and Web:**
29
29
 
30
30
  ```sh
31
- dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.9.0-beta.4
31
+ dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.9.0-beta.5
32
32
  ```
33
33
 
34
34
  You can also install a release tag straight from the repository, which contains the built plugin, so nothing is built at install time:
35
35
 
36
36
  ```sh
37
- dsh plugin --profile web add "git+https://github.com/kirkchinese/CiteCiter.git#v0.9.0-beta.4"
37
+ dsh plugin --profile web add "git+https://github.com/kirkchinese/CiteCiter.git#v0.9.0-beta.5"
38
38
  ```
39
39
 
40
40
  Restart DSH and refresh the page after installing or upgrading. Do not use `dsh plugin allow-version` to force a plugin that does not match your host version. Do not run two host processes on the same DSH home.
@@ -63,9 +63,9 @@ Creating a Topic or choosing 提问 only prepares a draft; preset actions such a
63
63
 
64
64
  ## Using CiteCiter
65
65
 
66
- **Toolbar and actions.** After you select text in an assistant answer, your own message, a tool result or a document, a toolbar appears next to it: Quote comes first, then the first four actions, and the rest plus "Ask in a new Topic" are under "⋯". Quote adds the selected sentences as a blockquote to the main conversation's composer, so the main agent knows exactly which sentence your next message is about, which helps when you discuss or dispute an answer; when that composer already holds reference chips, Citer copies the quote to the clipboard for you to paste. Actions go to the open Topic by default, or create one when there is none or it is archived. Selecting text in Citer's own answers shows the toolbar too; the action continues that Topic, and Quote adds the passage to that Topic's composer. 提问 opens the composer for your own question; preset actions such as 解释, 找错误 and 翻译 send directly without touching an existing draft. Action names, prompts and order are configurable in Settings. If you prefer gestures, turn on the wheel in Settings: hold the right mouse button (or the chosen key) after selecting text, move to an action and release.
66
+ **Toolbar and actions.** After you select text in an assistant answer, your own message, a tool result or a document, a toolbar appears next to it: the first action (Ask Citer by default), then Quote, then the next three actions; the rest plus "Ask in a new Topic" are under "⋯". Quote puts the selected sentences into the main conversation's composer as a quote chip that looks like an `@file` chip, keeping the text and attachments already there. When you send, the main agent receives the exact passage and who said it (its reply, your message or a tool result), so it knows which sentence your next words are about, which helps when you discuss or dispute an answer. From DSH `0.2.1-rc.2`, sent messages show the quote as a chip too. Actions go to the open Topic by default, or create one when there is none or it is archived. Selecting text in Citer's own answers shows the toolbar too; the action continues that Topic, and Quote adds the passage to that Topic's composer. Ask Citer opens the composer for your own question; preset actions such as Explain, Find errors and Translate send directly without touching an existing draft. Action names, prompts and order are configurable in Settings. If you prefer gestures, turn on the wheel in Settings: hold the right mouse button (or the chosen key) after selecting text, move to an action and release.
67
67
 
68
- **Right sidebar.** Citer is a tab in DSH's right sidebar. Open it from the sidebar's guide page, the desktop pet or the toolbar; it sits beside files, terminals and other plugins' tabs, and can be split, floated or made fullscreen like them; closing the tab closes Citer. The interface follows DSH's language setting (Chinese or English), and so do the names and prompts of the default actions; actions you changed stay as you wrote them. Each Topic shows its own usage under the composer: tokens, cache hit rate and context occupancy.
68
+ **Right sidebar.** Citer is a tab in DSH's right sidebar. Open it from the sidebar's guide page, the desktop pet or the toolbar; it sits beside files, terminals and other plugins' tabs, and can be split, floated or made fullscreen like them; closing the tab closes Citer. If you prefer the standalone panel of earlier versions, turn on "Don't use DSH's right sidebar" under Settings → Citer → Panel. The interface follows DSH's language setting (Chinese or English), and so do the names and prompts of the default actions; actions you changed stay as you wrote them. Each Topic shows its own usage under the composer: tokens, cache hit rate and context occupancy.
69
69
 
70
70
  **Desktop pet.** While Citer is closed, its mascot peeks over the window edge; she stands up when the pointer comes near, and a click opens Citer. Drag her to either side at any height and the place is remembered. A small dot appears next to her when an answer finishes or a question waits for you while Citer is closed.
71
71
 
@@ -122,6 +122,6 @@ CiteCiter turns real AI work into material you can cite, question and check. Sta
122
122
 
123
123
  Bring a task where "the agent finished, but I still can't explain it" to the [issue tracker](https://github.com/kirkchinese/CiteCiter/issues). Include your DSH and plugin versions and whether you got stuck installing, citing and asking, or understanding the answer. Remove keys and private content before pasting material.
124
124
 
125
- See [CONTRIBUTING.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.4/CONTRIBUTING.md) for development and [docs/product.zh.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.4/docs/product.zh.md) (Chinese) for the product rules. [Claude2DSH](https://github.com/kirkchinese/claude2dsh), by the same author, migrates sessions and assets between Claude Code and DSH.
125
+ See [CONTRIBUTING.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.5/CONTRIBUTING.md) for development and [docs/product.zh.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.5/docs/product.zh.md) (Chinese) for the product rules. [Claude2DSH](https://github.com/kirkchinese/claude2dsh), by the same author, migrates sessions and assets between Claude Code and DSH.
126
126
 
127
127
  MIT License.
package/README.zh.md CHANGED
@@ -1,14 +1,14 @@
1
1
  # CiteCiter
2
2
 
3
- [English](README.md) · [npm](https://www.npmjs.com/package/@kirkchinese/dsh-citeciter) · [更新记录](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.4/CHANGELOG.md) · [问题反馈](https://github.com/kirkchinese/CiteCiter/issues)
3
+ [English](README.md) · [npm](https://www.npmjs.com/package/@kirkchinese/dsh-citeciter) · [更新记录](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.5/CHANGELOG.md) · [问题反馈](https://github.com/kirkchinese/CiteCiter/issues)
4
4
 
5
- ![CiteCiter](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.4/assets/hero/citeciter-hero.png)
5
+ ![CiteCiter](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.5/assets/hero/citeciter-hero.png)
6
6
 
7
7
  **AI 已经完成了任务，我还想弄明白它是怎么做的。**
8
8
 
9
9
  CiteCiter 是 [DeepSeek Harness（DSH）](https://github.com/deepseek-ai/deepseek-harness) 的插件，帮助你从 Agent 的真实工作中学习。选中对话、工具结果或文档中的一段内容，在保留来源的独立 Topic 里追问，用小黑板理解关键关系，再回到原来的工作。主对话不会被改动。
10
10
 
11
- [![CiteCiter 演示](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.4/assets/docs/video-cover.png)](https://www.bilibili.com/video/BV1tqeA65EJ8/)
11
+ [![CiteCiter 演示](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.5/assets/docs/video-cover.png)](https://www.bilibili.com/video/BV1tqeA65EJ8/)
12
12
 
13
13
  [在 B 站观看演示](https://www.bilibili.com/video/BV1tqeA65EJ8/)（早期版本录制，界面与当前版本略有不同）。
14
14
 
@@ -18,7 +18,7 @@ CiteCiter 需要 DSH 和一个可用的模型。插件声明了精确的宿主
18
18
 
19
19
  | DSH 版本 | CiteCiter 版本 |
20
20
  | --- | --- |
21
- | `0.2.0-rc.2`（含官方桌面版）、`0.2.1-alpha.1` 至 `0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3` | `0.9.0-beta.4` |
21
+ | `0.2.0-rc.2`（含官方桌面版）、`0.2.1-alpha.1` 至 `0.2.1-alpha.5`、`0.2.1-rc.1`、`0.2.1-rc.2`、`0.2.1-rc.3` | `0.9.0-beta.5` |
22
22
  | `0.1.7-rc.2` | `0.9.0-alpha.3` |
23
23
  | `0.1.5-rc.1` | `0.8.2` |
24
24
  | `0.1.2-rc.1` | `0.6.0` |
@@ -28,13 +28,13 @@ CiteCiter 需要 DSH 和一个可用的模型。插件声明了精确的宿主
28
28
  **命令行与 Web：**
29
29
 
30
30
  ```sh
31
- dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.9.0-beta.4
31
+ dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.9.0-beta.5
32
32
  ```
33
33
 
34
34
  也可以从仓库安装某个发布标签，仓库内已包含构建好的插件，安装时无需构建：
35
35
 
36
36
  ```sh
37
- dsh plugin --profile web add "git+https://github.com/kirkchinese/CiteCiter.git#v0.9.0-beta.4"
37
+ dsh plugin --profile web add "git+https://github.com/kirkchinese/CiteCiter.git#v0.9.0-beta.5"
38
38
  ```
39
39
 
40
40
  安装或升级后重启 DSH 并刷新页面。不要用 `dsh plugin allow-version` 强行加载与宿主版本不匹配的插件。同一个 DSH 主目录不要同时运行两个宿主进程。
@@ -63,9 +63,9 @@ dsh plugin --profile web add "git+https://github.com/kirkchinese/CiteCiter.git#v
63
63
 
64
64
  ## 使用说明
65
65
 
66
- **工具条与动作。** 在主对话的助手回答、你自己的消息、工具结果或文档中选中文字后，旁边出现工具条：最前面是"引用"，然后是前四个动作，其余动作和"在新 Topic 中提问"在"⋯"里。"引用"把选中的句子以引用块加到主对话的输入框里，下次发给主 Agent 时它就知道你在说哪一句，适合和它讨论或反驳；输入框里已有附件引用时，Citer 会把引用复制到剪贴板请你粘贴。动作默认加入当前打开的 Topic，没有或已归档时新建。在 Citer 自己的回答里选中文字也会出现工具条，动作在这个 Topic 中继续，"引用"会把选段加到这个 Topic 的输入框。"提问"打开输入框让你写问题；"解释""找错误""翻译"等预设动作直接发送，不会改动输入框里已有的草稿。动作的名称、提示词和顺序都可以在设置中修改。喜欢手势的话，可以在设置中开启轮盘：选中文字后按住右键（或设定的键）移向动作，松开即执行。
66
+ **工具条与动作。** 在主对话的助手回答、你自己的消息、工具结果或文档中选中文字后，旁边出现工具条：第一个动作（默认是"问 Citer"）之后是"引用"，再往后是其余前三个动作，剩下的动作和"在新 Topic 中提问"在"⋯"里。"引用"把选中的句子作为一个引用胶囊放进主对话的输入框，和 `@文件` 的样子一样，已有的文字和附件都保留；发送时主 Agent 收到这段原文和它出自谁（它的回复、你的消息或工具结果），就知道你接下来的话针对哪一句，适合和它讨论或反驳。DSH `0.2.1-rc.2` 起，已发送的消息里也显示为引用胶囊。动作默认加入当前打开的 Topic，没有或已归档时新建。在 Citer 自己的回答里选中文字也会出现工具条，动作在这个 Topic 中继续，"引用"会把选段加到这个 Topic 的输入框。"问 Citer"打开输入框让你写问题；"解释""找错误""翻译"等预设动作直接发送，不会改动输入框里已有的草稿。动作的名称、提示词和顺序都可以在设置中修改。喜欢手势的话，可以在设置中开启轮盘：选中文字后按住右键（或设定的键）移向动作，松开即执行。
67
67
 
68
- **右侧栏。** Citer 是 DSH 右侧栏里的一个标签页，可以从侧栏的指引页、桌宠或工具条打开，和文件、终端、其他插件的标签并排、分屏、悬浮或全屏，关闭标签即收起。界面语言跟随 DSH 的语言设置（中文或英文），默认动作的名称和提示词也随之切换，你改过的动作保持原样。Topic 在输入框下方显示自己的用量：token 数、缓存命中率和上下文占用。
68
+ **右侧栏。** Citer 是 DSH 右侧栏里的一个标签页，可以从侧栏的指引页、桌宠或工具条打开，和文件、终端、其他插件的标签并排、分屏、悬浮或全屏，关闭标签即收起。更喜欢以前那种独立面板的话，在设置 → Citer → 面板中打开"不使用 DSH 右侧栏"。界面语言跟随 DSH 的语言设置（中文或英文），默认动作的名称和提示词也随之切换，你改过的动作保持原样。Topic 在输入框下方显示自己的用量：token 数、缓存命中率和上下文占用。
69
69
 
70
70
  **桌宠。** Citer 收起时，她会扒在窗口边缘探头；鼠标靠近时站起来，点一下就打开 Citer。可以把她拖到左边或右边的任意高度，位置会被记住。收起期间有回答完成，或有问题在等你回答时，她旁边会出现一个小圆点。
71
71
 
@@ -122,6 +122,6 @@ CiteCiter 尝试把真实的 AI 工作过程变成可引用、可追问、可检
122
122
 
123
123
  欢迎带着"Agent 已经完成了，但我还讲不清"的任务来[反馈](https://github.com/kirkchinese/CiteCiter/issues)。请写明 DSH 和插件版本，以及卡在安装、引用追问还是理解回答。贴材料前请移除密钥和私人内容。
124
124
 
125
- 开发说明见 [CONTRIBUTING.zh.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.4/CONTRIBUTING.zh.md)，产品规则见 [docs/product.zh.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.4/docs/product.zh.md)。同作者的 [Claude2DSH](https://github.com/kirkchinese/claude2dsh) 用于在 Claude Code 与 DSH 之间迁移会话和资产。
125
+ 开发说明见 [CONTRIBUTING.zh.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.5/CONTRIBUTING.zh.md)，产品规则见 [docs/product.zh.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.5/docs/product.zh.md)。同作者的 [Claude2DSH](https://github.com/kirkchinese/claude2dsh) 用于在 Claude Code 与 DSH 之间迁移会话和资产。
126
126
 
127
127
  MIT License.