CiteCiter

English · npm · 更新记录 · 问题反馈

AI 已经完成了任务，我还想弄明白它是怎么做的。

CiteCiter 是 DeepSeek Harness（DSH） 的插件，帮助你从 Agent 的真实工作中学习。选中对话、工具结果或文档中的一段内容，在保留来源的独立 Topic 里追问，用小黑板理解关键关系，再回到原来的工作。主对话不会被改动。

<p align="center"><img src="https://raw.githubusercontent.com/kirkchinese/CiteCiter/main/docs/media/citer-demo.gif" alt="在 DSH 中选中一句话，Citer 在右侧栏解释" /></p>

在 B 站观看演示（早期版本录制，界面与当前版本略有不同）。

安装

CiteCiter 需要 DSH 和一个可用的模型。插件声明了精确的宿主版本，请按 DSH 版本选择对应的 CiteCiter：

DSH 版本	CiteCiter 版本
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
0.1.7-rc.2	0.9.0-alpha.3
0.1.5-rc.1	0.8.2
0.1.2-rc.1	0.6.0

官方桌面版： 在插件页安装 npm 包 @kirkchinese/dsh-citeciter，或在 Git 地址一栏填写 https://github.com/kirkchinese/CiteCiter.git，然后按提示重启。

命令行与 Web：

dsh plugin --profile web add @kirkchinese/[email protected]

也可以从仓库安装某个发布标签，仓库内已包含构建好的插件，安装时无需构建：

dsh plugin --profile web add "git+https://github.com/kirkchinese/CiteCiter.git#v0.9.0-beta.6"

安装或升级后重启 DSH 并刷新页面。不要用 dsh plugin allow-version 强行加载与宿主版本不匹配的插件。同一个 DSH 主目录不要同时运行两个宿主进程。

从一个疑问开始

例如，Agent 修改了程序，你想知道"为什么这段异步保存逻辑会影响输入？"

1. 在主对话、工具结果或文档中选中相关内容，旁边会出现 Citer 工具条。
2. 点"解释"直接得到讲解；或者点"提问"，来源和选文会作为可移除的附件放进输入框，写下自己的问题后发送。
3. 围绕这段材料继续追问；需要时让模型在小黑板上画出流程，或整理成学习卡。
4. 回到原任务，用代码、工具结果或一次小实验检查自己的理解。

新建 Topic 或选择"提问"只会准备草稿；"解释""翻译"这类预设动作在你点选时发送，也可以在设置里改成先放进输入框。解释和板书仍可能出错；它们帮助你理解和检查，不代替事实证据。

功能

你想做什么	CiteCiter 提供什么
理解一段回答、代码或工具结果	带来源引用的独立 Topic，追问不会写入主对话
看懂关系与过程	支持 Markdown、公式、表格、SVG、图片和隔离 HTML 的小黑板；支持视觉的模型可以查看渲染后的板书并自行修正；板书还能编排动画，元素按关键帧、路径或公式运动，可以播放、暂停、拖动进度和按步骤跳转
留下可回看的理解	可导出、可修订的学习卡，文字与代码示例分开展示
围绕真实文件讨论	文件与图片附件；在右侧栏阅读导入的 Markdown / 文本文档和工作区文件，选中即可提问，引用带行号并能回到原文
从理解继续动手	复用 DSH 的模型、工具、审批、权限、排队和插话；新 Topic 默认只读
暂停后继续	草稿（文字、引用、附件）和未提交的问答自动保存，切换、刷新或重启后恢复，不会自动发送

使用说明

工具条与动作。 在主对话的助手回答、你自己的消息、工具结果或文档中选中文字后，旁边出现工具条：第一个动作（默认是"问 Citer"）之后是"引用"，再往后是其余前三个动作，剩下的动作和"在新 Topic 中提问"在"⋯"里。"引用"把选中的句子作为一个引用胶囊放进主对话的输入框，和 @文件 的样子一样，已有的文字和附件都保留；发送时主 Agent 收到这段原文和它出自谁（它的回复、你的消息或工具结果），就知道你接下来的话针对哪一句，适合和它讨论或反驳。DSH 0.2.1-rc.2 起，已发送的消息里也显示为引用胶囊。动作默认加入当前打开的 Topic，没有或已归档时新建。在 Citer 自己的回答里选中文字也会出现工具条，动作在这个 Topic 中继续，"引用"会把选段加到这个 Topic 的输入框。"问 Citer"打开输入框让你写问题；"解释""找错误""翻译"等预设动作直接发送，不会改动输入框里已有的草稿。动作的名称、提示词和顺序都可以在设置中修改。喜欢手势的话，可以在设置中开启轮盘：选中文字后按住右键（或设定的键）移向动作，松开即执行。

右侧栏。 Citer 是 DSH 右侧栏里的一个标签页，可以从侧栏的指引页、桌宠或工具条打开，和文件、终端、其他插件的标签并排、分屏、悬浮或全屏，关闭标签即收起。更喜欢以前那种独立面板的话，在设置 → Citer → 面板中打开"不使用 DSH 右侧栏"。界面语言跟随 DSH 的语言设置（中文或英文），默认动作的名称和提示词也随之切换，你改过的动作保持原样。Topic 在输入框下方显示自己的用量：token 数、缓存命中率和上下文占用。

文档。 在 Citer 的空状态点"打开文档"，或在 Topic 列表的"文档"页导入 .md / .txt 文件，文档会在右侧栏的标签页里打开：Markdown 正常排版（标题、列表、代码块、公式），文本和代码带行号，长文档边滚动边显示。选中文字就会出现同样的工具条，"问 Citer""解释""引用"都可以用。从文档提问的 Topic 在引用下方显示"文档名 · 第 N 行"，点"打开原文"回到那一段并短暂高亮。工作区里的文件用 DSH 自己的文件预览打开，在视图菜单中选"Citer 阅读"即可同样选文提问，提问时会把文件快照存入 Citer 的文档。文档列表在 Topic 列表的"文档"页，可以搜索和删除；删除只移除文档本身，相关 Topic 的对话保留。不使用 DSH 右侧栏时，文档在 Citer 面板的页签里打开。

桌宠。 Citer 收起时，她会扒在窗口边缘探头；鼠标靠近时站起来，点一下就打开 Citer。可以把她拖到左边或右边的任意高度，位置会被记住。收起期间有回答完成，或有问题在等你回答时，她旁边会出现一个小圆点。

…