dsh-goal-mode
为 DeepSeek Harness Web 界面提供可视化 goal 模式的插件。
把原本只能靠对话命令（/goal）和模型工具（create_goal / get_goal / update_goal）操作的目标系统，变成看得见、点得动的界面。
English | 中文
两种形态
本仓库同时提供两种形态，推荐使用 A（正式插件，稳定、可注册安装）：
| 形态 | 说明 | 适合 |
|---|---|---|
| A. 正式插件包（推荐） | 独立 npm 包结构（dsh.plugin.json + cordis.patch.yml + 构建产物），dsh plugin add 安装，页面刷新/重启不丢 | 日常使用、分享给他人 |
| B. 动态插件源码（保留） | 会话内 cordis_define + cordis_run 加载（host.js / client.js） | 快速试玩、调试 |
功能（形态 A）
- 完整生命周期目标栏（composer 上方，
conversation.input.dock，替换内置 goal 条）：
- 无目标时：◎ 按钮展开「设定目标」创建表单 - 有目标时：状态标签 + 目标文本 + 轮次进度条与 n/上限 + 已达上限徽标 - 图标按钮：⏸ 暂停 / ▶ 恢复 / ✎ 编辑（多行）/ ✓ 完成 / 🗑 清除 / 收起 - 已完成：完成横幅 + 「开始新目标」
- 多行编辑/创建：目标内容用多行文本框（自动换行、可拖高、
Ctrl+Enter提交），可同框设置轮次上限 - Composer 工具行入口（
conversation.input.left）：◎目标按钮 + 阶段色点（绿=进行中 / 黄=暂停 / 红=阻塞），点击展开/收起目标栏；目标栏可折叠为内容自适应胶囊 - General 设置开关（
settings.general.item）：「在输入框工具行显示目标入口」，经ui-goal-mode设置命名空间持久化 - 独立「目标」设置页（
settings.section）：展示当前会话的目标状态、轮次和紧凑目标预览，长目标可按需展开，并附使用说明 - 零空闲干扰：未设置目标时，composer 上方不渲染任何内容（除非创建表单显式打开）
原理
| 部分 | 实现 |
|---|---|
| 数据展示 | useProjection('goal') 实时投影（含实时 roundsStarted），零轮询 |
| 操作通道 | ctx.remote.goals（web 装配的 api-remotes 挂载的 Remote 命名空间），带 CAS revision 乐观并发 |
| 偏好持久化 | host 半注册 ui-goal-mode 设置命名空间，client 策略镜像 Host 段落 |
| UI 落点 | conversation.input.dock（goal 单元，priority -10 覆盖内置条）、conversation.input.left、settings.general.item、settings.section |
| 图标 | 内联 SVG 线条图标（Feather 风格，currentColor 随主题） |
数据本身存储在会话日志（goal/change 事件），持久化由引擎保证，插件只负责展示与操作。
安装
- 形态 A（正式插件）：见 [INSTALL.md](./INSTALL.md)。
- 形态 B（动态插件）：见
host.js/client.js顶部注释，会话内cordis_define+cordis_run加载。
仓库结构
dsh-goal-mode/
├── src/ # 形态 A 插件源码
│ ├── index.ts # host 半：注册 ui-goal-mode 设置命名空间
│ ├── invariant.ts # 包不变式伴生
│ ├── settings-contract.ts # 浏览器安全的设置常量/类型（host 与 client 共享）
│ └── client/
│ ├── index.ts # 插件主体：注册 dock 条 / composer 入口 / 设置行
│ ├── GoalBar.tsx # 目标栏 / 创建 / 编辑 / 胶囊 / composer 按钮
│ ├── ComposerEntryRow.tsx # 设置开关行
│ ├── GoalSettingsSection.tsx # 独立目标设置页
│ ├── settings-policy.ts # 偏好策略（Host 设置镜像）
│ ├── store.ts # 查看状态（页面内）
│ ├── slots.ts / locales.ts / styles.ts
├── build.mjs # esbuild 单文件构建（host ESM + client CJS bundle）
├── dsh.plugin.json # 插件清单
├── cordis.patch.yml # web profile patch 挂载
├── package.json / tsconfig.json / pnpm-workspace.yaml
├── host.js # 形态 B 动态插件 host 半（保留）
├── client.js # 形态 B 动态插件 client 半（保留）
├── INSTALL.md # 安装指南
└── README.md要求
- DeepSeek Harness（Web GUI，
webprofile） - 目标系统内置（
goals服务 +goal投影）
License
MIT