@tyr1105/dsh-buddy 0.1.0 → 0.1.1

dsh-buddy/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tyr1105
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{package → dsh-buddy}/README.md

@@ -21,7 +21,8 @@
 
 ## 怎么用
 
-- **新建队友**：点右上角「新建队友」，6 步：名字与角色 → 性格与说话风格 → 志向 → 自主等级与节奏 → 起步要盯的东西（可跳过）→ 确认上岗。上岗后它会先「试跑」：在线程里向你做自我介绍，并给自己搭好要盯的东西和待办。
+- **新建队友**：点「新建队友」，先看到按部门分组的 15 个模板（产品研发、推广、值守、外脑、对外）。点选一位或几位，再点「添加」，不用填任何内容，名字和设定之后都能改。想细调就点「自己从头配置」，走 6 步：名字与角色 → 性格与说话风格 → 志向 → 自主等级与节奏 → 起步要盯的东西（可跳过）→ 确认上岗。默认一个队友都没有，不选就不会创建。上岗后它会先「试跑」：在线程里向你做自我介绍，这一次要用你的模型额度。
+- **模板的上场方式**：「常驻」自己盯着，有变化就动；「等活」有活才动；「点名才来」只在你 @ 它时说话。后两种靠安静节奏和性格设定实现，不是硬限制：上岗时试跑一次，之后大约每周自查一次。
 - **四种角色**：总管（统筹全队、分派与跟进，最多 1 个）、调研（盯信息源、做研究、写结论）、执行（把事情做完，按规矩交付）、盯守（盯运行记录与期望，异常就报）。
 - **和它说话**：左边选一个队友，在下方输入框打字，回车发送，它会尽快醒来回复你。「团队」线程里的话默认交给总管；用 @名字 可以点名。
 - **处理它的请求**：提问、审批、提议会以卡片形式出现在它的线程里和「收件箱」里，点按钮即可。
@@ -37,7 +38,9 @@
 - **自主等级**：L0 只观察 / L1 建议（新队友试岗 7 天一律按 L1）/ L2 执行 / L3 授权执行（只能你手动设）。
 - **四类动作**：A 内部可撤销（直接做）、B 改自己的关注与议程（按等级）、C 别人看得见或碰真实数据（要你批准）、D 不可逆或高风险（L1 起都要你批准，L0 直接拒绝，例如删除家目录外的文件、强推代码、付款下单）。批准只对那一个具体动作有效一次。
 - **它碰不到的**：DSH 的沙箱只允许它写自己的家目录 `~/AgentHub/bots/<它的编号>/`；工具参数或命令里写明的名单内凭据路径（`~/.dsh`、`~/.ssh`、`.env` 等）会被拦下；提问后干等、派子代理、设定时提醒等会挂住或绕过管控的工具已被禁用。
-- **已知缺口**：动作闸只看得到工具参数和命令里写明的内容。名单外的文件、递归搜索、家目录脚本内部的读取和联网还拦不住；HTTP GET 算只读、直接放行，内容可以放进网址带出去。队友还能把自己家目录里的脚本交给中心运行：这一步不用批准，也不受 DSH 沙箱限制，能改动这台电脑上的其他文件，线程里看不到。所以暂时不要让队友读陌生网页这类不可信的内容。
+- **资料授权矩阵管什么、不管什么**：顶栏「资料」页登记队友共用的目录、文件和链接；普通资料全队在岗可读，受限资料只对你显式授权的部门、席位或队友开放（只读 / 读写两级）。这套授权只管「经过中心」的读取——中心资料工具和唤醒包里的摘要；队友在 DSH 会话里直接读文件不受它限制，不是系统级读隔离。真正的硬隔离（按队友隔离文件系统读取）需要 DSH 宿主提供新能力，在那之前不要把不放心的路径放进共享目录。
+- **项目目录只是登记**：顶栏「项目」页里每个项目的「目录」目前只存路径字符串，中心不会创建这个文件夹，也不检查它是否存在、是否在共享目录内，更不是按项目隔离的文件系统；不要把它当成访问控制或沙箱边界。
+- **已知缺口**：动作闸只看得到工具参数和命令里写明的内容。名单外的文件、递归搜索、家目录脚本内部的读取和联网还拦不住；HTTP GET 算只读、直接放行，内容可以放进网址带出去。队友交给中心运行的家目录脚本已经收紧：每一单都要你批准、批准绑定脚本内容、执行目录只能在家目录或共享目录内，并且命令在 macOS 沙箱里运行——只能写它自己的家目录、共享目录和系统临时目录，工作数据目录即使有授权也一律拒绝写入。命令、退出码、输出摘要和可写目录会作为一条系统消息写回线程。沙箱不可用或启动失败时，宿主命令一律拒绝执行，不会退回普通执行；这时设置页会显示「沙箱不可用，宿主命令不运行」。中心往队友家目录写东西时不跟随符号链接；家目录本身不能是符号链接，被换成链接时工具调用会被拒绝并记一次越界。DSH 每条命令都会重新解析工作目录，插件只能在工具调用前检查，抢时间差的情况要等 DSH 修复。剩下的主要缺口是 DSH 会话本身的文件读隔离：队友的工作会话仍能读到会话允许读的内容。所以暂时不要让队友读陌生网页这类不可信的内容。
 - **额度**：每 5 小时窗口全队起步最多 8 个回合，第一次遇到额度报错后，按当时用量的 90% 校准；每个队友每天有回合和 token 上限；额度紧张时自动放慢，用尽时全体歇着、窗口恢复后先放一个「探针」试水。注意：中心看不到你自己用了多少，所以不能保证给你留出固定比例。
 - **一键停用（不卸载）**：在 `~/AgentHub/.hub/` 里新建一个名为 `DISABLED` 的空文件，重启 DSH 后引擎停用、只留界面；删掉这个文件再重启即恢复。
 
@@ -52,8 +55,6 @@
 
 ## 给开发者
 
-- 代码结构、实现规格、任务卡与验收记录：`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/`。