@tyr1105/dsh-buddy 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,59 @@
-# Temporary Holding Version
+# 队友：DSH 版 Grok Bot
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在 DeepSeek Harness（DSH）里养几个常驻的 AI 队友。每个队友有名字、有分工、有自己的长期志向；它们会自己盯着你指给它们的东西，**有理由才动脑**，想完自己决定下次什么时候再看；需要你拍板时，才在对话线程里找你。你从不需要给它们设闹钟。
+
+## 它和「定时任务」有什么不一样
+
+| | 定时任务（闹钟式） | 队友（主动式） |
+|---|---|---|
+| 什么时候干活 | 你定的时间一到就跑 | 它盯的东西有了变化、它答应你的事到期、某个目标停滞太久，才醒来想一次 |
+| 没事的时候 | 照样调用一次模型，回你一句「没事」 | 不调用模型，不花额度 |
+| 下次什么时候 | 固定 | 它自己约（只能约下一次，并写明理由），中心按上下限夹住 |
+| 找你 | 到点就汇报 | 日常的事攒进每天 08:30 的日报；只有提问、审批、出问题才单独提醒你，免打扰时段（23:00–08:00）不推送 |
+
+## 安装（一次性）
+
+1. 完全退出 DeepSeek Harness（菜单栏 → 退出）。
+2. 在终端运行 `bash ~/.agent-hub/install.sh`（它会先构建插件，再用桌面版自带的命令把插件装进 desktop 档位）。
+3. 重新打开 DeepSeek Harness，左侧栏会出现「队友」。
+
+卸载同理：退出 DSH → 运行 `bash ~/.agent-hub/uninstall.sh` → 重新打开。你的队友数据保留在 `~/AgentHub`，不会被删。
+
+## 怎么用
+
+- **新建队友**：点右上角「新建队友」，6 步：名字与角色 → 性格与说话风格 → 志向 → 自主等级与节奏 → 起步要盯的东西（可跳过）→ 确认上岗。上岗后它会先「试跑」：在线程里向你做自我介绍，并给自己搭好要盯的东西和待办。
+- **四种角色**：总管（统筹全队、分派与跟进，最多 1 个）、调研（盯信息源、做研究、写结论）、执行（把事情做完，按规矩交付）、盯守（盯运行记录与期望，异常就报）。
+- **和它说话**：左边选一个队友，在下方输入框打字，回车发送，它会尽快醒来回复你。「团队」线程里的话默认交给总管；用 @名字 可以点名。
+- **处理它的请求**：提问、审批、提议会以卡片形式出现在它的线程里和「收件箱」里，点按钮即可。
+- **教它一招**：你在 DSH 里亲手做过一件事，可以在它的线程头部点「教它一招」，选那个会话，它会读一遍过程，写成自己的「套路」，以后照做；你可以在右栏修改套路。
+- **看它为什么醒、为什么没醒**：右栏最下方「为什么醒 / 为什么没醒」逐条列出每次判断的理由与分数。
+- **看它到底干了什么**：线程头部「打开工作会话」跳到它在 DSH 里的工作会话，能看到每一步工具调用。
+- **让它盯「该按时发生的事」**：对它说「盯一下 ~/Library/Logs/xxx/paper-morning.out.log，工作日每天 08:20 前应该有新内容」。它会建一个带期望的关注项（试岗期是「提议」，你在卡片上点接受才生效）。期望可以只在工作日或指定星期检查，周末不误报；没按时出现，它会被叫醒并告诉你，第二天日报里也会写【未出现】。
+- **打断它**：它正在处理时，线程头部有「打断」（点两次确认）。打断不算它的错，它下次醒来会接着处理。
+- **审批**：它要做别人看得见或不可逆的事（发网络请求、写家目录外的文件、跑有风险的命令）时，会发一张审批卡，用大白话写清楚要做什么、目标是什么；你批准后由中心代为执行一次，结果写回线程。
+
+## 安全边界（它能做什么、不能做什么）
+
+- **自主等级**：L0 只观察 / L1 建议（新队友试岗 7 天一律按 L1）/ L2 执行 / L3 授权执行（只能你手动设）。
+- **四类动作**：A 内部可撤销（直接做）、B 改自己的关注与议程（按等级）、C 别人看得见或碰真实数据（要你批准）、D 不可逆或高风险（L1 起都要你批准，L0 直接拒绝，例如删除家目录外的文件、强推代码、付款下单）。批准只对那一个具体动作有效一次。
+- **它碰不到的**：DSH 的沙箱只允许它写自己的家目录 `~/AgentHub/bots/<它的编号>/`；工具参数或命令里写明的名单内凭据路径（`~/.dsh`、`~/.ssh`、`.env` 等）会被拦下；提问后干等、派子代理、设定时提醒等会挂住或绕过管控的工具已被禁用。
+- **已知缺口**：动作闸只看得到工具参数和命令里写明的内容。名单外的文件、递归搜索、家目录脚本内部的读取和联网还拦不住；HTTP GET 算只读、直接放行，内容可以放进网址带出去。队友还能把自己家目录里的脚本交给中心运行：这一步不用批准，也不受 DSH 沙箱限制，能改动这台电脑上的其他文件，线程里看不到。所以暂时不要让队友读陌生网页这类不可信的内容。
+- **额度**：每 5 小时窗口全队起步最多 8 个回合，第一次遇到额度报错后，按当时用量的 90% 校准；每个队友每天有回合和 token 上限；额度紧张时自动放慢，用尽时全体歇着、窗口恢复后先放一个「探针」试水。注意：中心看不到你自己用了多少，所以不能保证给你留出固定比例。
+- **一键停用（不卸载）**：在 `~/AgentHub/.hub/` 里新建一个名为 `DISABLED` 的空文件，重启 DSH 后引擎停用、只留界面；删掉这个文件再重启即恢复。
+
+## 已知限制（v1）
+
+- DSH 开着、电脑醒着，队友才在岗；DSH 停了再开，它们会「补课」并告诉你停了多久。
+- 队友自己建的关注项 30 天后自动失效，不会提醒你，到时要再让它加一次。
+- 中心代为运行的命令只等 30 秒，超时会被停掉并报失败，不适合长任务。
+- 关注的日志每次更新也算一条小变化，攒够两条队友会工作一次，这也花额度。
+- 还不能代你登录任意网站操作（浏览器自动化）、没有手机端、没有接飞书或邮件。这些在后续版本里。
+- DSH 是预发布版，接口可能随升级变化；插件只声明支持 0.2.x，DSH 大版本升级后插件会自动停用，需要更新插件。
+
+## 给开发者
+
+- 代码结构、实现规格、任务卡与验收记录：`docs/build-spec.md`、`docs/tasks/`、`docs/progress/`、`docs/reviews/`。
+- `packages/core`：主动性引擎（纯 TypeScript，可在仿真里推进 7 天验证主动性）；`packages/plugin`：DSH 插件（宿主适配 + 界面）。
+- 隔离沙箱：`bash scripts/sandbox.sh install|run|e2e|real`（不碰你正在用的 DSH）。
+- 界面走查：`bash scripts/dev/ui-sandbox.sh`（浏览器里点的沙箱 + 走查专用假模型，用法见 `scripts/README.md`）。
+- 设计资料（PRD、Grok Bot 功能清单、DSH 插件开发手册、可行性与证据）：`docs/design/`。

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# 组合包补丁：把 dsh-buddy 插件插入 Loader 树（写法照官方 dsh-net-tuning 样板）。
+# 文件必须是顶层 YAML 数组；id 全局唯一且不与官方 required id 冲突。
+- insert:
+    - id: agent-hub
+      name: "@tyr1105/dsh-buddy"