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。
