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

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 (35) hide show
  1. package/README.md +10 -8
  2. package/README.zh.md +10 -8
  3. package/lib/client.js +1187 -755
  4. package/lib/index.js +73 -2
  5. package/lib/{typert-common-NL5W_N9Z.js → typert-common-BfDE0QUD.js} +1 -1
  6. package/lib/typert.host.js +2 -2
  7. package/lib/typert.remote-client.js +1 -1
  8. package/lib/types/citation-mapping.d.ts +13 -0
  9. package/lib/types/client/action-controller.d.ts +7 -0
  10. package/lib/types/client/action-executor.d.ts +2 -2
  11. package/lib/types/client/components/CitePanel.d.ts +6 -3
  12. package/lib/types/client/components/DocumentTab.d.ts +20 -0
  13. package/lib/types/client/components/DocumentView.d.ts +40 -0
  14. package/lib/types/client/components/LibraryDocument.d.ts +16 -0
  15. package/lib/types/client/components/NativeLearningDocument.d.ts +5 -2
  16. package/lib/types/client/components/TopicNavigation.d.ts +15 -2
  17. package/lib/types/client/document-address.d.ts +10 -0
  18. package/lib/types/client/document-layout.d.ts +37 -0
  19. package/lib/types/client/document-library.d.ts +38 -0
  20. package/lib/types/client/locales/index.d.ts +20 -22
  21. package/lib/types/client/locales/settings.d.ts +20 -22
  22. package/lib/types/client/native-document.d.ts +2 -2
  23. package/lib/types/client/request-guard.d.ts +5 -0
  24. package/lib/types/client/types.d.ts +12 -0
  25. package/lib/types/client/view-actions.d.ts +11 -4
  26. package/lib/types/document-pages.d.ts +2 -0
  27. package/lib/types/documents.d.ts +13 -0
  28. package/lib/types/topic.d.ts +13 -0
  29. package/lib/types/typert-common.d.ts +8 -0
  30. package/lib/types/typert.host.d.ts +17 -0
  31. package/lib/{update-Bti3dxU-.js → update-DTzkFNQy.js} +12 -1
  32. package/package.json +1 -1
  33. package/lib/types/client/components/DocumentReader.d.ts +0 -12
  34. package/lib/types/client/reader-controller.d.ts +0 -39
  35. package/lib/types/client/reader-selection.d.ts +0 -12
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.5/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.6/CHANGELOG.md) · [Issues](https://github.com/kirkchinese/CiteCiter/issues)
4
4
 
5
- ![CiteCiter](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.5/assets/hero/citeciter-hero.png)
5
+ ![CiteCiter](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.6/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.5/assets/docs/video-cover.png)](https://www.bilibili.com/video/BV1tqeA65EJ8/)
11
+ [![CiteCiter demo](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.6/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.5` |
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.6` |
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.5
31
+ dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.9.0-beta.6
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.5"
37
+ dsh plugin --profile web add "git+https://github.com/kirkchinese/CiteCiter.git#v0.9.0-beta.6"
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.
@@ -57,7 +57,7 @@ Creating a Topic or choosing 提问 only prepares a draft; preset actions such a
57
57
  | Understand an answer, code or tool result | A separate Topic with a source citation; follow-ups never touch the main conversation |
58
58
  | See relationships and processes | A blackboard with Markdown, formulas, tables, SVG, images and sandboxed HTML; vision models can inspect the rendered board and fix it; board elements can be animated with keyframes, paths or formulas, and you can play, pause, scrub and step through the animation |
59
59
  | Keep what you learned | Learning cards you can export and revise, with prose and code examples shown separately |
60
- | Discuss real files | File and image attachments, a `.txt` / `.md` document reader, and a "CiteCiter 学习" entry in native file previews |
60
+ | Discuss real files | File and image attachments; read imported Markdown / text documents and workspace files in the right sidebar, select to ask, with citations that carry line numbers and lead back to the source |
61
61
  | Act on what you understood | DSH models, tools, approvals, permissions, queueing and steering; new Topics are read-only by default |
62
62
  | Pick up where you left off | Drafts (text, references, attachments) and unsubmitted question answers are saved and restored after switching, refreshing or restarting, never sent automatically |
63
63
 
@@ -67,6 +67,8 @@ Creating a Topic or choosing 提问 only prepares a draft; preset actions such a
67
67
 
68
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
+ **Documents.** Choose "Open document" in Citer's empty state, or import a `.md` / `.txt` file from the Documents page of the Topic list; the document opens as a tab in the right sidebar. Markdown is typeset (headings, lists, code blocks, math), text and code show line numbers, and long documents render as you scroll. Selecting text shows the same toolbar, so Ask Citer, Explain and Quote all work. A Topic asked from a document shows "document · line N" under its quote; "Open source" returns to that passage and briefly highlights it. Workspace files open in DSH's own file preview; choose "Citer Reading" in its view menu to select and ask the same way, and asking saves a snapshot of the file to Citer's documents. The Documents page of the Topic list searches and deletes documents; deleting removes only the document, and the Topics about it keep their conversations. Without DSH's right sidebar, documents open as a tab inside Citer's panel.
71
+
70
72
  **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
73
 
72
74
  **Composer.** The composer offers attachments, permission mode, model and reasoning effort, and Send. Enter sends, Shift + Enter adds a line, and Enter never sends during IME composition. While a reply is generating, Enter follows DSH's queue/steer preference and Ctrl + Enter uses the other one. Add files from the attachment menu, paste images, or drop files onto the Citer panel.
@@ -122,6 +124,6 @@ CiteCiter turns real AI work into material you can cite, question and check. Sta
122
124
 
123
125
  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
126
 
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.
127
+ See [CONTRIBUTING.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.6/CONTRIBUTING.md) for development and [docs/product.zh.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.6/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
128
 
127
129
  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.5/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.6/CHANGELOG.md) · [问题反馈](https://github.com/kirkchinese/CiteCiter/issues)
4
4
 
5
- ![CiteCiter](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.5/assets/hero/citeciter-hero.png)
5
+ ![CiteCiter](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.6/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.5/assets/docs/video-cover.png)](https://www.bilibili.com/video/BV1tqeA65EJ8/)
11
+ [![CiteCiter 演示](https://raw.githubusercontent.com/kirkchinese/CiteCiter/v0.9.0-beta.6/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.5` |
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.6` |
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.5
31
+ dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.9.0-beta.6
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.5"
37
+ dsh plugin --profile web add "git+https://github.com/kirkchinese/CiteCiter.git#v0.9.0-beta.6"
38
38
  ```
39
39
 
40
40
  安装或升级后重启 DSH 并刷新页面。不要用 `dsh plugin allow-version` 强行加载与宿主版本不匹配的插件。同一个 DSH 主目录不要同时运行两个宿主进程。
@@ -57,7 +57,7 @@ dsh plugin --profile web add "git+https://github.com/kirkchinese/CiteCiter.git#v
57
57
  | 理解一段回答、代码或工具结果 | 带来源引用的独立 Topic，追问不会写入主对话 |
58
58
  | 看懂关系与过程 | 支持 Markdown、公式、表格、SVG、图片和隔离 HTML 的小黑板；支持视觉的模型可以查看渲染后的板书并自行修正；板书还能编排动画，元素按关键帧、路径或公式运动，可以播放、暂停、拖动进度和按步骤跳转 |
59
59
  | 留下可回看的理解 | 可导出、可修订的学习卡，文字与代码示例分开展示 |
60
- | 围绕真实文件讨论 | 文件与图片附件、`.txt` / `.md` 文档阅读器、原生文件预览中的"CiteCiter 学习"入口 |
60
+ | 围绕真实文件讨论 | 文件与图片附件；在右侧栏阅读导入的 Markdown / 文本文档和工作区文件，选中即可提问，引用带行号并能回到原文 |
61
61
  | 从理解继续动手 | 复用 DSH 的模型、工具、审批、权限、排队和插话；新 Topic 默认只读 |
62
62
  | 暂停后继续 | 草稿（文字、引用、附件）和未提交的问答自动保存，切换、刷新或重启后恢复，不会自动发送 |
63
63
 
@@ -67,6 +67,8 @@ dsh plugin --profile web add "git+https://github.com/kirkchinese/CiteCiter.git#v
67
67
 
68
68
  **右侧栏。** Citer 是 DSH 右侧栏里的一个标签页，可以从侧栏的指引页、桌宠或工具条打开，和文件、终端、其他插件的标签并排、分屏、悬浮或全屏，关闭标签即收起。更喜欢以前那种独立面板的话，在设置 → Citer → 面板中打开"不使用 DSH 右侧栏"。界面语言跟随 DSH 的语言设置（中文或英文），默认动作的名称和提示词也随之切换，你改过的动作保持原样。Topic 在输入框下方显示自己的用量：token 数、缓存命中率和上下文占用。
69
69
 
70
+ **文档。** 在 Citer 的空状态点"打开文档"，或在 Topic 列表的"文档"页导入 `.md` / `.txt` 文件，文档会在右侧栏的标签页里打开：Markdown 正常排版（标题、列表、代码块、公式），文本和代码带行号，长文档边滚动边显示。选中文字就会出现同样的工具条，"问 Citer""解释""引用"都可以用。从文档提问的 Topic 在引用下方显示"文档名 · 第 N 行"，点"打开原文"回到那一段并短暂高亮。工作区里的文件用 DSH 自己的文件预览打开，在视图菜单中选"Citer 阅读"即可同样选文提问，提问时会把文件快照存入 Citer 的文档。文档列表在 Topic 列表的"文档"页，可以搜索和删除；删除只移除文档本身，相关 Topic 的对话保留。不使用 DSH 右侧栏时，文档在 Citer 面板的页签里打开。
71
+
70
72
  **桌宠。** Citer 收起时，她会扒在窗口边缘探头；鼠标靠近时站起来，点一下就打开 Citer。可以把她拖到左边或右边的任意高度，位置会被记住。收起期间有回答完成，或有问题在等你回答时，她旁边会出现一个小圆点。
71
73
 
72
74
  **输入。** 输入框依次提供附件、权限模式、模型与思考强度、发送。Enter 发送，Shift + Enter 换行，输入法组词时 Enter 不会发送。生成过程中 Enter 跟随 DSH 的排队／插话设置，Ctrl + Enter 临时使用另一种方式。可以从附件菜单选择文件、粘贴图片，或把文件拖到 Citer 面板上。
@@ -122,6 +124,6 @@ CiteCiter 尝试把真实的 AI 工作过程变成可引用、可追问、可检
122
124
 
123
125
  欢迎带着"Agent 已经完成了，但我还讲不清"的任务来[反馈](https://github.com/kirkchinese/CiteCiter/issues)。请写明 DSH 和插件版本，以及卡在安装、引用追问还是理解回答。贴材料前请移除密钥和私人内容。
124
126
 
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 之间迁移会话和资产。
127
+ 开发说明见 [CONTRIBUTING.zh.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.6/CONTRIBUTING.zh.md)，产品规则见 [docs/product.zh.md](https://github.com/kirkchinese/CiteCiter/blob/v0.9.0-beta.6/docs/product.zh.md)。同作者的 [Claude2DSH](https://github.com/kirkchinese/claude2dsh) 用于在 Claude Code 与 DSH 之间迁移会话和资产。
126
128
 
127
129
  MIT License.