TLNing260310/dsh-researcher

README 摘要

dsh-researcher 项目研究 Project Research — a read-only project-intelligence agent preset for DeepSeek Harness. Understand the project before deciding what to do with it. 先理解项目现状，再决定要不要动手。 只读项目研究模式 ：把项目当文物读，产出证据分级（C0–C4）、逐条可复核的诊断报告；结论可以是 "暂不建议行动" 。零修改保证不靠提示词祈祷，而靠四层机制（无写工具 + 沙箱只读 + 审批永不升级 + 写代码不进入注意力面）。 定位 Mode 核心问题 最终产物 Research（本模式） 现在到底是什么情况？要不要动？ understanding / diagnosis Plan 准备怎么改？ implementation plan Code 怎么做？ implementation Research 是 Plan 的上游：诊断 →【你的决策】→ Plan（新会话）→【你的批准】→ Code。研究会话 永远 不会获得写能力——交接是跨会话、经过你的。 快速安装 Windows (PowerShell): macOS / Linux (bash): 脚本把 researcher/ 目录复制到 ${DSH HOME:- /.dsh}/.agent-presets/researcher 。也可以手动复制。 使用 1. 新建会话，预设选择 项目研究 Project Research 。 2. 权限选择 read-only（只读） ，审批策略选择 never （当前 UI 中 read-only + never 显示为 custom 组合，是最严格的组合；命名的 read-only 预设保留 ask ，由你逐次把关升级请求）。 3. 工作目录指向你的项目仓库，发送： 仓库说明 + 当前状态 + 你的困惑 。 4. 验收： write / edit 显示为 "DISABLED in research mode" 的永拒桩；会话前后 git status --porcelain 一致。 它输出什么 十四节《项目体检报告》：执行摘要与置信度 → 研究范围与方法 → 项目目的理解（声称 vs 代码重建 vs 历史）→ 架构地图 → 技术实现水平 → 证据台账（claim 卡片：Claim / Status / Evidence / Missing evidence / Confidence） → 宣传与实现差距 → 竞品矩阵 + GitHub 可复用项目候选清单 → 优势 → 风险与现实环境问题 → 未验证假设 → 最大价值改进点 → 建议（可为 NONE + 辩证权衡的候选优化方案） → 交接包（粘贴到 Pla…

分类