Imported from zhu1090093659/dsh-trading (
AGENTS.md). Install upstream withnpx skills add zhu1090093659/dsh-trading. Copyright stays with the author.
dsh-trading Agent 指南
DSH 交易插件 monorepo，按市场组织 bundle（crypto/us/cn/hk）。本文件只保留项目契约；通用执行、并发与授权纪律遵循用户级指令。
安全与当前授权
- bundle patch insert-only；知识进 skill 随包分发；base 拥有全部市场无关行；不内置密钥、不再分发数据。下单默认 dry-run，liveTrading 必须显式开启，base 统一审批闸门不得绕过。
- 修 CI、管线、配置或文档不授权发布。版本发布 bump、提交/推送、tag、npm 与 GitHub Release 按当前请求确认范围；历史授权、token 和启用的 workflow 不构成当前许可。发布入口：dsh-trading-release。
- DSH 宿主安装与 SDK cohort 以当前实际安装及项目声明核验，不硬编码旧版本；宿主本体对本项目任务只读，不修改旧 deepseek-harness checkout。
Home 与运行验证
- trading profile 和全部业务数据使用独立 home
~/.dsh-trading；包内经@dshtrading/dsh-home解析。显式DSH_HOME可覆盖，但须核实目标是 trading 实例，不能因继承了 Web 会话环境而误用~/.dsh。CLI 用~/.local/bin/dsh-tradingwrapper；桌面壳内置 trading 缺省 home。见 home 契约。 - UI 验证用
dsh-trading --profile trading-web；无头用trading-dev，全市场用trading-all。不得挂回 Web 宿主默认webprofile。客户端更新后重建并按 profile 刷新契约 刷新 file: 副本；CLI/桌面切换注意 cohort 链接方向，CLI 刷新入口scripts/refresh-trading-web-profile.sh。禁止实例运行中执行 plugin install，不擅自重启服务。 - UI 证据走宿主 tokenized HTTP URL + headless Chrome
--timeout截图，不做全屏桌面截图；按需加载ui-screenshot-verify，见 项目验证说明。宿主升级按需加载dsh-sdk-upgrade，检查 profile shadow-copy/cohort；不要把裸dsh plugin install当刷新完成。
开发、分支与门禁
- 每个非平凡变更同一变更中记录 Agent Note。Prompt 分层、模型能力选择、CI 归因与反震荡规则由该文档维护，不在入口复述。
- main 是集成/默认分支，无 dev。较大功能（公共 API、交易安全语义、跨多包新功能/重构）从最新 main 开
feat/<issue号>-<短名>，PR 关联 Issue 并至少一个审查批准；docs/notes、CI/脚本微调和单点修复等小改可直接 main，不强制 PR。此契约不代替当前提交/推送授权。见 交付流分级。提交用 Conventional Commits，只暂存核对过的精确文件。 - 构建/测试基线是
pnpm build与pnpm test；连接器另需真实网络原始响应证据（spikes/impl-*/）。按改动运行相关验证，完整门禁放在提交/推送及发布边界，不为纯指令编辑生成分发副本。
按需阅读
- 架构、五条铁律、数据源 ToS：README.md。
- 改包结构：市场复制手册；新增连接器：接入手册，先用
scripts/new-connector.mjs生成。 - 改连接器激活/交易所选择：设置路由；查 spike 裁决：REVIEW-LOG。
- B站/微信内容提炼：项目 content-insight，只交付请求产物；知识库写入需明确授权与当前工具，禁止直写活 store。
交易会话守则
正式分析标的、行业或宏观主题前，先用当前可用 knowledge_search 检索本地知识库；主题宽泛时先 knowledge_graph 看主体分布，再按 cluster 搜索、knowledge_get 读全文。工具不可用应如实说明，不能伪称已查库；无命中说明「知识库无相关沉淀」。卡片须标 id、核查 updatedAt 与素材发布时间，仅作观点线索，不替代原始披露和权威数据；过时宏观/政策观点降权，转述不等于背书，对外明示不构成投资建议。
新结论可建议用户按 knowledge-curation 查重后入库，不自动写库。交易日志遵守 trading-notes-setup 的双轨 append-only、先闸门后记账契约；外部工作区的便携守则由该 skill 写入 .trading-journal/AGENTS.md。
