行业公司研究包PerryLink/dsh-industry-research

🏭 dsh-industry-research
- 1024 商店渠道：先执行一次 npm i -g dsh1024，然后执行 dsh1024 plugin --profile web add dsh-industry-research（计入 deepseek1024.com 安装排名）。
Gitee

面向 DeepSeek Harness 的行业与公司研究领域包。

产业链图谱、公开来源追踪、公司卡片与可审计报告——每个数字都可溯源，每处缺口都明确声明。

License
DSH plugin
dsh-doctor
Node
CI
Version
npm version
npm downloads

English · 简体中文 · Español · Português · हिन्दी

仅供研究，不构成投资建议。 本包仅提供研究支持：不涉及交易，不预测价格，不使用付费或需登录的来源。

兼容性

- DeepSeek Harness 0.1.6-alpha.2（已发布的 npm 版本线，2026-09-18 验证；peer 为 >=0.1.2-rc.1 =0.1.5-alpha.1 =0.1.6-0 =24.0.0，仅支持 ESM（"type": "module"）。
- Peer 依赖：@deepseek-ai/cordis ^4.0.2、@deepseek-ai/schemastery ^3.18.2，以及 @deepseek-ai/dsh-tools、@deepseek-ai/dsh-skill、@deepseek-ai/dsh-skill-filesystem，版本为 >=0.1.2-rc.1 =0.1.5-alpha.1 =0.1.6-0 /report.md + manifest.json，其中包含 SHA-256 来源可追溯表和如实标注的 engine: 'builtin-fallback'。
- 产物版本账本 — industry_map / company_scan / industry_report 在每次产物写入时追加到 versions.jsonl（根相对路径 + SHA-256 + 时间戳 + 变更类型）；读取时会验证哈希，并在不匹配时明确报错。
- 两项方法论技能 — industry-research-method（产业链拆解、供需框架、来源纪律、缺口声明纪律）和 company-research-method（公司框架、公开来源清单、合规措辞）。
- 类型化 Cordis 事件 — 每个已提交产物之后发出 industry-research/map、industry-research/track、industry-research/report。

快速开始

git 渠道

从临时 profile 开始（固定 commit；运行自包含的 prepare 构建）
dsh plugin --profile demo add "github:PerryLink/dsh-industry-research#"
首次添加时，该 profile 的 pnpm-workspace.yaml 会为 dsh-industry-research 增加一条 allowBuilds 条目。

npm 渠道

dsh plugin --profile demo add dsh-industry-research

两个渠道都会把 bundle 行（见 cordis.patch.yml）安装到 profile 的 dsh.profile.bundles 栈中，并在重启后生效。

然后，在会话中：

加载 industry-research-method 技能，然后研究白酒行业：
先 industry_map 建产业链图，再 industry_track 跟踪政策，最后 industry_report 出报告。

安装与卸载

dsh plugin --profile demo add dsh-industry-research       # 安装
dsh plugin --profile demo remove dsh-industry-research    # 卸载

验证该行已挂载：dsh --profile demo --dump-config | grep dsh-industry-research。

配置

所有可调项都是 Schemastery Config 字段；无效值会让 profile 加载大声失败。

| 键 | 默认值 | 描述 |
| --- | --- | --- |
| enabled | true | 总开关；false 时不挂载任何内容。 |
| industryRoot | industry-research | 产物根目录，相对于会话工作区（或绝对路径）。 |
| fetchTimeoutMs | 20000 | ctx.web 搜索/抓取调用的每请求超时（毫秒）。 |
| timelineMaxEntries | 500 | 每个行业 timeline.jsonl 保留的条目数（最旧的被丢弃）。 |
| sourceAllowlist | [] | 被跟踪来源的主机允许列表（空 = 所有主机）。 |
| sourceBlocklist | [] | 被跟踪来源的主机阻止列表（优先于允许列表）。 |
| offline | false | 离线模式：绝不触碰 ctx.web；仅使用本地工作区数据。 |
| skillsDir | _（未设置）_ | 显式技能根目录覆盖；默认为打包的 skills/。 |
| track.maxResultsPerTopic | 10 | 每个主题的 web_search maxResults。 |
| track.maxFetchesPerCall | 10 | 每次 industry_track 调用的快照抓取预算。 |
| scan.maxFileBytes | 1048576 | 公司数据文件的每文件读取上限。 |
| scan.maxFigureCandidates | 100 | 每次公司扫描的图表候选预算。 |
| scan.strictTicker | true | 公司卡片股票代码必须匹配内置格式（A 股 6 位数字，美股 1–5 个字母，港股 1–5 位数字）；false 免除格式检查。 |

工具与界面

industry_map({ industry, seed?, seedFiles?, web?, chain?, renderSvg?, depth? })
使用 chain 调用时：进行验证（悬空边、无来源值、非法层级、重复 id、status/statusAsOf、未知 taxonomyCode —— 大声失败并给出完整问题列表）并持久化 chain.json，然后列出显式缺口槽和瓶颈节点。不传 chain 调用时：返回当前地图、已注册来源，以及可选的 ctx.web 链结构摘要，以便模型进行迭代。使用 renderSvg: true 时，它还会写入确定性的 chain.svg。depth（quick/standard/comprehensive）会缩放 web 辅助。返回相对于上一个 research-state.json 的 delta 摘要。发出 industry-research/map。

industry_track({ industry, topics?, since?, depth?, evidenceCategory? })

通过 ctx.web 搜索每个主题，按允许/阻止列表和 since 过滤，在调用预算内获取页面快照（SHA-256），并合并到 timeline.jsonl（按规范化 URL 去重，有上限）。depth 缩放来源/获取预算；evidenceCategory 为每个追加条目打标签，并会针对六类枚举进行验证。快照失败的来源会保留为仅引用条目，并在 note 中说明原因。返回相对于上一个 research-state.json 的 delta 摘要。当 ctx.web 未挂载或 offline: true 时，大声失败并指出缺失的能力。发出 industry-research/track。

company_scan({ name | companies, dataFiles?, web?, status?, statusAsOf?, ticker?, metrics?, depth?, parallel? })

读取工作区数据文件（.md/.txt/.csv/.tsv/.json；v1 不解析 PDF），对它们进行哈希，提取 Markdown 大纲和图表候选行，可选地附加 ctx.web 引用，并持久化卡片。status 需要非未来的 statusAsOf；ticker 必须匹配内置格式，除非 scan.strictTicker: false；每个 metrics 值都必须带有 source + asOf。companies（批量）会隔离一个坏公司而不中止批次；当 ctx.jobs 已挂载时，parallel: true 会将每个公司展开为独立作业（否则回退到顺序执行，并在结果 mode 中报告）。被拒绝的文件会连同原因返回；卡片无法确立的一切都是显式缺口。

industry_report({ industry, sections?, companies?, draft? })
组装证据（E-chain、E-timeline、E-company-），对照 versions.jsonl 校验读取的产物（哈希不匹配则显式失败），并要么验证你的 draft（章节 + 论断；每条论断的 evidenceIds 必须引用已注册的证据），要么构建机械式自动草稿（有来源的指标和近期时间线条目成为论断，按 evidenceCategory 分组）。一个确定性的交付契约在生产之前运行，并在任何缺失区块、占位符或无来源/无日期的断言上显式失败。一个确定性的对抗式机器检查始终运行，并且当 ctx.jobs 已挂载时，会派生一个红队审查作业（red-review-note.md）（否则为 review: skipped(jobs unavailable)）。一个确定性的多空（正反方）综合会将多视角章节嵌入报告中，并在 ctx.jobs 已挂载时派生一个辩论作业（perspectives-note.md）。引擎路径：密封目录 + sealHash + 逐论断裁决。回退路径：带版本的 Markdown + 清单，论断诚实地标记为 unverified。输出 industry-research/report。

技能

- industry-research-method — 行业研究方法论：上游/中游/下游分解、供需框架、来源纪律（每个数字：值 + 单位 + 来源 + asOf），以及缺口声明纪律（声明，绝不捏造）。
- company-research-method — 公司研究方法论：业务结构 / 财务 / 风险卡片框架、公开来源优先级列表（公司披露 → 监管机构 → 权威媒体），以及合规措辞。

两者均通过标准 skill 工具按需加载（加载 industry-research-method 技能）。

数据布局

//versions.jsonl              产物版本台账（SHA-256 + 时间戳 + 变更）
///research-state.json  研究状态记忆
///chain.json      industry_map
///chain.svg       industry_map (renderSvg: true)
///timeline.jsonl  industry_track
///sources.json    可引用来源注册表（S1、S2、……）
///notes/          种子笔记
///red-review-note.md  industry_report（红队审查，作业）
///perspectives-note.md  industry_report（多空辩论，作业）
///reports//   industry_report（report.md + manifest.json）
//companies//card.*    company_scan

权限与数据
dsh-industry-research 仅消费公开接缝：ctx.tools、ctx.skills，以及——可选查找的——ctx.web 和 ctx.researchReport。它自身不进行任何网络访问（所有检索均通过 ctx.web，使用部署的提供方选择和您配置的超时），不存储任何凭据，并且仅写入会话工作区内 industryRoot 下的内容。仅使用公开来源；付费或需登录的来源不在范围内——请将您自己的导出作为 dataFiles 传入。

安全边界

- 工作区隔离 —— 行业/公司名称是经过验证的路径段；数据文件会针对会话 cwd 进行隔离检查（两侧均已解析）。
- 构造式溯源 —— 来源携带 SHA-256 哈希；无来源的数字属于验证错误；损坏的时间线行会被跳过并显示计数，绝不静默处理。
- 诚实降级 —— 缺少 ctx.web / ctx.researchReport 会产生显式失败或诚实标注的降级产物，绝不静默捏造。
- 可逆注册 —— 一切都通过 ctx.effect() / ctx.on() / register() 进行。
- 仅限研究的合规性 —— 工具描述、卡片和报告均带有「仅供研究，不构成投资建议」；数据点带有 asOf 和来源。

已知限制

- Cordis 事件，而非会话日志事件 —— industry-research/* 事件是类型化的 Cordis 可观测性事件，绝不会追加到会话日志；持久记录是工作区产物本身，而模型可见的工具结果则搭载持久的 tool/result 会话事件。
- 不写入 ctx.attachment —— rc2 附件接缝仅接受图像（PNG/JPEG/WebP/GIF）；因此 Markdown 报告保持为带版本的工作区文件，并在工具结果中以绝对路径引用。
- v1 仅读取文本格式 —— 不解析 PDF；请用户先将 PDF 转换为文本/Markdown。
- 中文版技能 —— 打包的方法论技能以中文提供；英文版为未来工作。
- 前台工具 —— industry_track 受 track.maxFetchesPerCall 和 fetchTimeoutMs 限制，并在前台运行；后台任务模式为未来工作。
- 自动草稿是机械式的 —— 它汇总产物并将有来源的数据点转化为论断；叙述质量来自模型撰写的 draft。

开发

pnpm install
pnpm run typecheck && pnpm run typecheck:ci
pnpm test
pnpm run build
pnpm run verify:self-contained && pnpm run verify:artifacts
pnpm run verify:readme-sync
pnpm run verify:skills
pnpm run pack:check

主题

dsh、dsh-plugin、deepseek-harness、cordis、industry-research、company-research、research、report

贡献者

- 由 dsh-industry-research 开发会话（DeepSeek Harness）完成初始设计与实现。

欢迎外部贡献——请提交 issue 或 pull request。

PerryLink DSH 插件家族
本项目是由 PerryLink 维护的 40 个 DeepSeek Harness 插件之一。如果这个插件对你有帮助，其他的很可能也会：

| 插件 | 一句话简介 |
|---|---|
| dsh-auto-review | 审批链上的第二模型自动审查，默认失败即关闭 | |
| dsh-background-agents | 持久化的后台子代理，带 Web UI 侧边栏、消息传递和中断功能 | |
| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排放和延迟集于一个面板。 | |
| dsh-checkpoint-rewind | 等同于 Claude Code /rewind：快照、会话分叉、一次性恢复 | |
| dsh-claude-move | 将 Claude Code 会话、记忆、技能和 CLAUDE.md 迁移到 DSH | |
| dsh-click | DeepSeek Harness 的跨平台原生桌面控制——Windows 优先。 | |
| dsh-composer-history | Web 输入框的终端风格输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 数据集质量检查和引用交叉核对（此处消费的可选数值桥接） | |
| dsh-defend | DeepSeek Harness 的提示注入、越狱和密钥泄露防御。 | |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对抗性审查 | |
| dsh-draw | DeepSeek Harness 的统一静态图像生成路由。 | |
| dsh-fast | DeepSeek Harness 的只读性能诊断。 | |
| dsh-fund-research | 面向中国公募基金的确定性研究报告 | |
| dsh-github | DSH 的 GitHub PR/issue 集成，每次写入均需审批 | |
| dsh-library | DeepSeek Harness 的本地文档知识库。 | |
| dsh-local-ai | DeepSeek Harness 的本地模型（Ollama）集成。 | |
| dsh-lsp-actions | 通过语言服务器提供 LSP 诊断、格式化、补全、代码操作和重命名 | |
| dsh-mask | PII 脱敏中间件：在模型边界匿名化，在展示层还原 | |
| dsh-mcp-panel | 只读 MCP 运行时面板：/mcp 命令 + 设置选项卡，显示状态、工具和错误 | |
| dsh-memento | 审批门控的跨会话记忆：ctx.memory 接缝 + SQLite + memory 工具 | |
| dsh-observe | 面向 DeepSeek Harness 的 OpenTelemetry 与 Langfuse 可观测性导出器。 | |
| dsh-output-styles | 与 Claude Code outputStyles 等价的运行时样式切换 | |
| dsh-permission-rules | Claude Code 风格的声明式 allow/deny/ask 权限规则，带审计 | |
| dsh-personal-directive | 带顶栏开关的个人指令注入器（框架版） | |
| dsh-plugin-guide | 以按需智能体技能形式提供的插件开发知识库 | |
| dsh-plugin-doctor | 面向 DSH 插件的零依赖静态 + 沙箱冒烟检测器 | |
| dsh-reach | 多渠道审批/提问桥接：微信/Telegram/飞书，会话控制台 | |
| dsh-research-report | 可验证的研究报告引擎：内容寻址的证据账本与封存版本 | |
| dsh-score | 面向 DeepSeek Harness 插件的多维度质量评分。 | |
| dsh-session-pin | 在 Web 侧边栏中固定会话，并保持持久排序 | |
| dsh-session-sync | 面向 DeepSeek Harness 的跨设备会话同步——你的会话存储的专用 git 镜像。 | |
| dsh-skill-pack-security | 安全审计技能包：密钥扫描、依赖与供应链审查 | |
| dsh-talk | 面向 DeepSeek Harness 的语音优先会话循环：对它说话，听它回答。 | |
| dsh-test-drive | 面向 DeepSeek Harness 插件的隔离安装与冒烟测试试驾。 | |
| dsh-ticktick | TickTick/滴答清单任务桥接：会话头部面板 + 11 个工具 | |
| dsh-translate | 面向 DeepSeek Harness 的厂商参数转换与确定性 JSON 修复。 | |
| dsh-wechat | 微信 ↔ DSH 桥接（腾讯 iLink 机器人）：文本/图片/文件/语音，在聊天中审批 | |
| dsh-autotier | 自动强/廉价模型层级路由，带确定性风险防护与 /tier 命令 | |
| dsh-catalog | 面向 PerryLink 家族的 DSH Desktop Market 标准目录源 | |
| dsh-cert-mcp | 只读 MCP 服务器，公开认证注册表：等级、快照和五维证据 | |
| dsh-kit | 一键安装核心套件的入门包 | |
| dsh-plugin-certification | 社区认证注册表，带有可复现检查的等级和徽章 | |
| dsh-plugin-kit | 为 PerryLink DSH 插件共享的零运行时依赖工具包 | |
| dsh-plugin-portal | 零依赖静态门户，将整个插件系列渲染为单个页面 | |
| dsh-plugin-upgrade-015 | 合并的 0.1.3-alpha.1 → 0.1.5-rc.1 升级通道卡片，外加一个零依赖接缝扫描器 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务板和时线 | |

从 DSH Desktop Market 安装

所有 PerryLink 插件都可以在内置的 DSH Desktop Market 中浏览：Market → Sources → add source → paste https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → select it。安装仍需通过 Market 的 npm 身份验证和你的确认。

许可证

Apache-2.0 — 见 LICENSE。