CiteCiter
为 DeepSeek Harness Web 与 Desktop 打造的 AI 输出学习、检查与纠偏插件。
选中一段已提交的回答，在旁边创建独立 Topic，反复追问、切换模型，或让 AI 用公式、图形、表格和动画逐步讲解。主任务继续运行，学习记录保存在独立日志中。
0.6.0 安装与兼容
CiteCiter 0.6.0 的安装基线是 DSH 0.1.2-rc.1，Desktop 对应 DSH Desktop 2.0.5。Node.js 要求 ^22.19.0 || >=24.0.0；Windows 实测使用 Node 24.19.0。DSH alpha 与 Desktop master 不在此兼容承诺中。
| 环境 | 安装目标 | 状态 |
|---|---|---|
| DSH Web 0.1.2-rc.1 | web profile |
Windows 实际运行与 UI 验证 |
| DSH Desktop 2.0.5 | Desktop 当前 profile，默认 desktop |
适配目标，分模式验证见 release 文档 |
| DSH 0.1.1-rc.1 / rc.2 | 旧环境 | 保留 CiteCiter 0.5.0 |
| DSH alpha、TUI | — | 未支持 |
| Linux / macOS | 相同包 | 本轮未运行平台验证 |
安装或升级 Web 插件：
npm install -g @deepseek-ai/dsh@0.1.2-rc.1
dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.6.0
dsh plugin --profile web list --depth 0
dsh web
确认版本为 0.6.0 后重启相应宿主并刷新页面。也可从 GitHub Release 下载 .tgz，将安装命令中的包名替换为 tarball 的绝对路径。源码开发使用贡献指南中的本地工作区安装流程。
Desktop 中先确认当前 profile 名称和数据目录，使用相同的 DSH_HOME安装：
dsh plugin --profile desktop add @kirkchinese/dsh-citeciter@0.6.0
dsh plugin --profile desktop list --depth 0
若 Desktop 选择了自定义 profile，把 desktop 换成该名称；若使用自定义 home，先在当前 PowerShell 中设置 $env:DSH_HOME。重启 Desktop。全局 npm 更新只影响 CLI，Desktop 内置的 DSH 随桌面应用更新。
npm 12 若提示安装脚本被拦截，按此次依赖列表一次性放行并重装；不必改变全局永久策略：
npm install -g @deepseek-ai/dsh@0.1.2-rc.1 --allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty,@google/genai,protobufjs
这解决原生依赖安装问题；旧插件引用已移除的 effectiveSandboxMode 则需要升级插件，单独重装宿主不会修复。
开始使用
- 选中已提交的助手回答或思考内容，右键输入问题，选择“开始提问”或“开始讲解”。
- 在右侧学习栏继续追问、切换模型和思考强度，或管理 Topic 标题、归档和删除。
- 使用
+ 新 Topic创建自由问答或讲解。新的主会话需先发送消息，让 Topic 取得当前模型配置。 - 讲解内容位于主工作区“小黑板”标签；“引用到提问”会追加到现有草稿。
- 也可从工具结果、终端结果、差异片段及文本/Markdown Reader 创建 Topic。
上图演示引用流程，录制于旧版；0.6 的宿主布局和控件可能不同。
并排学习，不遮挡主对话
- 宽屏为学习栏分配独立列，保留主对话和原生详情栏。
- 保存的面板比例为 28%–55%。空间不足时限制实际宽度，为主对话保留至少 480 CSS 像素；扩大窗口后恢复偏好比例。
- 窄窗口或缩放后无法容纳两列时，学习栏移至下方，主对话仍在上方可见。
- 关闭学习栏后恢复宿主布局。无法识别的宿主仅显示兼容提示。
内容通过 DSH 公开 slots、会话投影和快照 hooks 接入。当前宿主没有公开的右侧 dock 尺寸接口，因此尺寸分配使用集中维护的宿主布局适配器，升级宿主后需重新验收。
Topic 与数据
Observer 在私有日志中讨论，按需读取来源事件和项目文件；Exact Fork 继承已结束来源轮次的上下文。文件工具保持只读，Topic 不向主 Session 追加事件。未提交的流式文字没有稳定引用坐标；Exact Fork 需等待来源轮次结束。
Presenter 的 blackboard_apply 原子提交支持公式、Markdown、表格、安全 SVG、隔离 HTML 动画和内嵌图片。Topic 可继续追问、切换模型、归档、恢复及带 Session ID 确认的永久删除。
Topic 索引在 $DSH_HOME/citeciter/workspaces/，日志在 $DSH_HOME/citeciter/sessions/；未设置变量时通常为用户目录下的 .dsh。升级前备份整个 home。0.6 使用新版会话 API；没有批量重写旧日志。DSH 版本 0 JSONL 的物理 seedLength 仍由宿主读取，遇到未知事件应保留原件并诊断，不能删字段绕过。
一个 home 只能由一个活动 CiteCiter 宿主使用。Web 与 Desktop 同时运行时使用不同 home；不要让两者并发写入同一私有存储。更新提醒只复制命令，不自动安装；Desktop 命令使用当前 profile。
开发
pnpm typecheck
pnpm test
pnpm build
pnpm test:snapshot
实际应用快照使用临时 profile 与无密钥模型，覆盖 Observer、Exact Fork、来源读取、板书和来源日志不变性。Host API ctx.citeciterRuntime 提供 create、ask、get、list、delete 及 Topic 变化事件。前端入口注册 API 和 preset 扩展仍未稳定。开发流程见 贡献指南，公开变更见 0.6.0 发布说明。
社区与许可证
DSH-Citeciter QQ 群：1108040435。
还没有评论，来写第一条。