@kirkchinese/dsh-citeciter

对 DSH 回复里的某一句追到底，不打断主 Agent，也不改变来源 Session。CiteCiter 为交互式 DSH 提供可核查、与来源精确绑定、只读的旁路调查。

划选、右键、就地调查；主 Agent 继续工作。

English · GitHub · 问题反馈

核心能力

• 精确绑定来源。 创建 Topic 前，CiteCiter 会把可见选区与已经提交的回答重新核对。
• 不用等待主任务。 一次模型回答提交后即可开始调查，外层 Agent 轮次可以继续运行。
• 调查可以持续。 私有 Topic 支持自然续问，刷新或重启后仍能重新打开。
• 有证据、无写权限。 CiteCiter 能检查来源中已提交的事件，也能搜索和阅读项目文件，但不能改变来源 Session 或工作区。
• 过程可检查。 问题、回答、来源读取和项目文件核查都留在调查面板中。
• 并排工作流。 面板和可用主对话能同时容纳时，主对话会自动让出空间；更紧的布局才回退为覆盖模式。

使用

1. 在一次已经提交的助手模型调用中选择文字；外层 Agent 轮次可以仍在运行。
2. 右键选区，输入第一个问题，然后点击 Citer!。
3. CiteCiter 在调查面板中创建一个新 Topic。
4. 在 Topic 中继续追问，或从 CiteCiter 的 Topic 栏恢复旧讨论。
5. 独立调整模型、思考强度、标题、归档状态和面板宽度，不改变来源 Session。

安装 v0.4.1

CiteCiter 0.4.1 需要 Node.js ^22.19.0 || >=24.0.0 与 DSH >=0.1.1-rc.1 <0.1.1-rc.3。

DSH Web 使用：

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

安装后重启 DSH Web 并刷新页面。正式 Desktop 适配已经暂缓；CiteCiter 0.4.1 不提供受支持的 Desktop 安装路径。

上下文模式

Observer 是默认模式。它创建独立 Topic，并按需读取已经提交的来源证据；来源轮次仍在运行时也可以使用。

Exact Fork 是面向已结束来源轮次的高级模式。exact-when-available 在存在稳定边界时使用 Exact Fork，否则回退到 Observer。

兼容性与验证

宿主	CiteCiter 版本	状态
DSH Web 0.1.1-rc.2	0.4.1	Linux 包、CI、升级与组装 keyless 浏览器检查通过；真实提供方验收未运行
DSH Desktop 2.0.2（内置 DSH 0.1.1-rc.2）	后续目标	适配与原生验收暂缓；不声明正式 Desktop 安装包兼容性
dataelement DSH Desktop 源码开发壳（内置 DSH 0.1.1-rc.1）	仅 0.4.0	历史上的有条件 Linux 源码壳证据
DSH Web 0.1.0-rc.7	0.3.2	旧版稳定线
DSH TUI	—	暂不支持

动图使用确定性测试场景展示交互，不作为真实提供方或正式 Desktop 安装包验收证据。

从旧版本升级

在 Web 安装或升级 v0.4.1：

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

正式 Desktop 适配已经暂缓，不属于 0.4.1 的受支持升级路径。

从 v0.3 升级不会迁移或重写现有 Topic、设置或来源 Session。仍在 DSH 0.1.0-rc.7 上运行的用户应继续使用 CiteCiter 0.3.2。

已知限制

• 选区中必须至少包含一个已经提交的助手模型回答；纯用户消息、纯工具行和仍在流式输出的片段不能作为引用锚点。
• 渲染器生成的 KaTeX 排版和脚注编号没有稳定原文坐标，不能直接引用。
• Exact Fork 不能从仍在运行的来源轮次开始。
• 来源文件访问依赖当前 DSH 文件系统服务，并始终保持只读。
• Read Frog 翻译选区是 DSH rc.1/rc.2 上的 best-effort 兼容路径，仅在其完整私有标记同时存在时启用；普通 DSH 选区不依赖 Read Frog。
• DSH 尚未提供公开的增量右侧 dock 布局扩展点。CiteCiter 因此在面板与主对话能够同时容纳时使用可逆的私有 AppFrame grid 适配器；它保留布局的 details 偏好，但在调查面板打开期间临时隐藏该列，并且每个受支持的 DSH 版本都必须重新验证。
• Topic 由 Host 持久保存。Desktop 重启到不同 loopback 端口时，浏览器 localStorage 会因 origin 改变而失去精确指针，CiteCiter 将回退到最近更新的 Topic；需要精确恢复“上次查看”时应配置固定 Desktop 端口。
• CiteCiter 0.4.1 不声明正式 Desktop 安装包兼容性；Windows 与 macOS 原生适配将另行继续。
• 当前没有 TUI 交互适配器。
• DSH 仍处于预发布阶段，后续 API 版本可能要求同步更新 CiteCiter。

交流与反馈

欢迎加入 DSH-Citeciter QQ 群（群号 1108040435），交流使用方式、功能想法和兼容性问题。

参与贡献

欢迎提交 Issue 和 Pull Request。提交代码前请阅读贡献文档。

许可证

MIT © CiteCiter contributors