PerryLink/dsh-industry-research

🏭 dsh-industry-research

• 1024 商店渠道：先 npm i -g dsh1024，再 dsh1024 plugin --profile web add dsh-industry-research（计入 deepseek1024.com 安装排行）。

DeepSeek Harness 的行业/公司研究领域包。

产业链建图、公开源跟踪、公司速览卡、可核查报告——每个数字都能回溯来源，每个缺口都如实声明。

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

---

仅供研究，不构成投资建议。 本包只做研究支持：不接交易、不预测价格、不使用付费/需登录数据源。

📖 生态实测知识库（实测数据，不是营销）：插件开发指南 · 选型实测数据 · 维护取舍判据。

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（40+ 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

English: part of a 40+ plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

What is dsh-industry-research?

DeepSeek Harness 的行业/公司研究领域包。

产业链建图、公开源跟踪、公司速览卡、可核查报告——每个数字都能回溯来源，每个缺口都如实声明。

同一次运行，动图版。

Compatibility

• DeepSeek Harness dsh-v0.2.1-alpha.1（npm 发布线，2026-09-24 已核验；peer 范围 >=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0）。 0.1.2-rc.1（2026-09-02 已适配）：会话信封保留 ignorable 字段但仅用于存量日志读取兼容——Session.append 仍无法盖章，门控行为不变。 2026-09-24 已核验：对照 0.1.7-rc.2 已发布 peer 实测（完整门禁链；真实 profile 安装冒烟由每周及每 PR 的 compat.yml 任务执行）。
• Node ^22.19.0 || >=24.0.0，仅 ESM（"type": "module"）。
• Peer 依赖：@deepseek-ai/cordis ^4.0.2、@deepseek-ai/schemastery ^3.18.2，以及 >=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0 的 @deepseek-ai/dsh-tools、@deepseek-ai/dsh-skill、@deepseek-ai/dsh-skill-filesystem（官方 dsh-base bundle 均已组合）。
• 可选能力在执行时查找（绝不注入）：ctx.web（公开源检索，dsh-base 已组合）与 ctx.researchReport（兄弟插件 dsh-research-report 的封存引擎）。

What you get

• industry_map——构建/更新产业链结构图（chain.json）：上/中/下游节点、边、指标槽位。带 value 的指标必须带 sourceRef；无值槽位即显式缺口。种子笔记/文件与可选 ctx.web 摘要登记为可引用来源（S1、S2……）。
• industry_track——经官方 ctx.web 缝隙跟踪行业政策/要闻：按主题检索、来源主机白/黑名单、since 过滤、预算内快照抓取（SHA-256 溯源哈希），追加去重写入 timeline.jsonl（保留上限可配）。web 能力不可达时响亮失败。
• company_scan——以工作区数据文件生成公司速览卡（card.json + card.md）：SHA-256 哈希、Markdown 大纲、数字候选行（每个数字可标注文件与行号），另可选 ctx.web 引用补充。v1 只读文本格式（不解析 PDF）。
• industry_report——汇总结构图、时间线与公司卡产出可核查报告。确定性正反方（bull/bear）合成将「有来源且带日期的数值」列为多方、「缺口与数据质量发现」列为空方，嵌入报告多视角小节，并派生 subagent job 写回 perspectives-note.md 入账本。挂载 ctx.researchReport 引擎时证据/章节/claims 提交其 assemble 封存并回传逐 claim 结论；缺席时内置降级路径写入版本化 reports/<YYYYMMDD-HHmmss>/report.md + manifest.json（含 SHA-256 来源回溯表），并如实标注 engine: 'builtin-fallback'。
• 两个方法论技能——industry-research-method（产业链拆分、供需框架、口径纪律、缺口声明纪律）与 company-research-method（公司研究框架、公开源清单、合规话术）。
• 类型化 Cordis 事件——每份产物落盘后发出 industry-research/map、industry-research/track、industry-research/report。

Quick start

dsh plugin --profile web add github:PerryLink/dsh-industry-research

git 渠道

# 在临时 profile 中（钉 commit；运行自包含 prepare 构建）
dsh plugin --profile demo add "github:PerryLink/dsh-industry-research#<sha>"
# 首次 add 时 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 出报告。

Install & uninstall

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。

Configuration

全部可调项均为 Schemastery Config 字段；非法值在加载期响亮失败。

Key	Default	Description
enabled	true	总开关；false 不挂载任何能力。
industryRoot	industry-research	产物根目录（相对会话工作区，或绝对路径）。
fetchTimeoutMs	20000	ctx.web 检索/抓取的单次请求超时（毫秒）。
timelineMaxEntries	500	每个行业 timeline.jsonl 的保留条数（最旧先弃）。
sourceAllowlist	[]	跟踪来源主机白名单（空 = 全部允许）。
sourceBlocklist	[]	跟踪来源主机黑名单（优先于白名单）。
offline	false	离线模式：不触网，只用本地工作区数据。
skillsDir	(未设置)	显式 skills 根目录覆盖；缺省用随包 skills/。
track.maxResultsPerTopic	10	每个主题的 web_search maxResults。
track.maxFetchesPerCall	10	每次 industry_track 调用的快照抓取预算。
scan.maxFileBytes	1048576	公司数据文件的单文件读取上限（字节）。
scan.maxFigureCandidates	100	每次公司扫描的数字候选行预算。
scan.strictTicker	true	公司卡 ticker 必须匹配内置格式（A 股 6 位数字、美股 1–5 字母、港股 1–5 数字）；false 豁免格式校验。

Tools & surfaces

industry_map({ industry, seed?, seedFiles?, web?, chain?, renderSvg?, depth? })

带 chain 调用：校验（悬空边、无来源数值、非法 tier、重复 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（批量）单公司失败不中断整批；parallel: true 且挂载 ctx.jobs 时按公司 fan-out 为独立 job（否则回退顺序路径并在结果 mode 注明）。未采纳文件带原因返回；卡片无法确立的内容一律写入显式缺口。

industry_report({ industry, sections?, companies?, draft? })

组装证据（E-chain、E-timeline、E-company-<slug>），读取时对照 versions.jsonl 校验哈希（不一致响亮失败），或校验你提供的 draft（章节 + claims；每条 claim 的 evidenceIds 必须引用已登记证据），或机械自动生成草稿（有来源的指标与近期时间线条目生成 claims，按 evidenceCategory 分组）。产出前跑确定性交付契约校验（缺区块/占位符/无来源或无日期断言即响亮失败）。确定性对抗机器检查始终执行；挂载 ctx.jobs 时派生红方审阅 job 写回 red-review-note.md（否则 review: skipped(jobs unavailable)）。确定性正反方（bull/bear）合成嵌入报告多视角小节，挂载 ctx.jobs 时派生辩论 job 写回 perspectives-note.md。引擎路径：封存目录 + sealHash + 逐 claim 结论。降级路径：版本化 Markdown + manifest，claims 如实标记 unverified。发出 industry-research/report 事件。

Skills

• industry-research-method——行业研究方法论：上/中/下游拆分、供需框架、口径纪律（每个数字：数值 + 单位 + 来源 + asOf）、缺口声明纪律（如实声明，绝不编造）。
• company-research-method——公司研究方法论：业务结构/财务要点/风险点卡片框架、公开源优先级清单（公司披露 → 监管 → 权威媒体）、合规话术。

两个技能经标准 skill 工具按需加载（加载 industry-research-method 技能）。

Data layout

<工作区>/<industryRoot>/versions.jsonl        工件版本清单（SHA-256 + 时间戳 + 变更类型）
<工作区>/<industryRoot>/<行业>/research-state.json  研究状态记忆
<工作区>/<industryRoot>/<行业>/chain.json      industry_map
<工作区>/<industryRoot>/<行业>/chain.svg       industry_map（renderSvg: true）
<工作区>/<industryRoot>/<行业>/timeline.jsonl  industry_track
<工作区>/<industryRoot>/<行业>/sources.json    可引用来源登记（S1、S2……）
<工作区>/<industryRoot>/<行业>/notes/          种子笔记
<工作区>/<industryRoot>/<行业>/red-review-note.md  industry_report（红方审阅，需 jobs）
<工作区>/<industryRoot>/<行业>/perspectives-note.md  industry_report（正反方辩论，需 jobs）
<工作区>/<industryRoot>/<行业>/reports/<ts>/   industry_report（report.md + manifest.json）
<工作区>/<industryRoot>/companies/<公司>/card.*  company_scan

Permissions & data

dsh-industry-research 只消费公开缝隙：ctx.tools、ctx.skills，以及可选查找的 ctx.web 与 ctx.researchReport。本插件自身不发起任何网络访问（一切检索经 ctx.web，provider 选择与超时由部署方与你的配置决定），不存凭据，只在会话工作区的 industryRoot 下写文件。只使用公开源；付费/需登录数据源不在范围内——请自行导出后作为 dataFiles 传入。

Security boundaries

• 工作区隔离——行业/公司名校验为单一路径段；数据文件对照会话 cwd 做包含性检查（双侧 resolve）。
• 构造即溯源——来源带 SHA-256 哈希；无来源数字即校验错误；损坏时间线行跳过且计数如实上报，绝不静默。
• 诚实降级——缺少 ctx.web / ctx.researchReport 时响亮失败或产出如实标注的降级产物，绝不静默编造。
• 可逆注册——一切贡献经 ctx.effect() / ctx.on() / register()。
• 纯研究合规——工具描述、卡片与报告均带「仅供研究，不构成投资建议」；数据点带 asOf 与来源。

Known limitations

• Cordis 事件而非会话日志事件——industry-research/* 事件是类型化 Cordis 可观测性事件，绝不追加进会话日志；持久记录是工作区产物本身；可观测性走类型化 Cordis 事件；模型可见的工具结果走持久 tool/result 会话事件。
• 不写 ctx.attachment——rc2 附件缝隙只接受图片（PNG/JPEG/WebP/GIF）；Markdown 报告因此保持为版本化工作区文件，工具结果中以绝对路径引用。
• v1 只读文本格式——不解析 PDF；请用户先把 PDF 转成文本/Markdown。
• 中文版技能——随包方法论技能为中文版；英文版为后续工作。
• 前台工具——industry_track 由 track.maxFetchesPerCall 与 fetchTimeoutMs 界定为前台任务；后台任务模式为后续工作。
• 自动草稿是机械组装——它汇总产物并把有来源的数据点生成 claims；叙述质量来自模型撰写的 draft。

Development

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

Topics

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

Contributors

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

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

适用的 DSH 版本： 已在 dsh-v0.2.1-alpha.1（本构建所针对的宿主版本）上验证；要求 >=0.1.7-alpha.1 <0.2.0。

PerryLink DSH Plugin Family

本项目是 PerryLink 维护的 DeepSeek Harness 插件家族成员：34 个活跃维护，名册共 42 个，其中 5 个已冻结、3 个已退役——每一个都在下表保留自己的行，原因见「状态」列。如果它能帮到你，其他的也会：

Plugin	一句话	状态
dsh-auto-review	Second-model auto-review on the approval chain, fail-closed by default
dsh-autotier	Automatic strong/cheap model-tier routing with deterministic risk guards and a /tier command
dsh-background-agents	Durable background child agents with a Web UI sidebar, messaging and interrupt	🚫 已退役 — 见上方说明
dsh-budget	Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel.	🧊 已冻结 — 见仓库 README
dsh-catalog	DSH Desktop Market standard catalog source for the PerryLink family
dsh-cert-mcp	Read-only MCP server exposing the certification registry: grades, snapshots and five-dimension evidence
dsh-checkpoint-rewind	Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore
dsh-claude-move	Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH	🧊 已冻结 — 见仓库 README
dsh-click	Cross-platform native desktop control for DeepSeek Harness — Windows first.
dsh-composer-history	Terminal-style input history for the web composer: arrows, Ctrl+R search
dsh-data-quality	Dataset quality checks and citation cross-checks (the optional numeric bridge consumed here)
dsh-defend	Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness.	🧊 已冻结 — 见仓库 README
dsh-doublecheck	Engineering-discipline guard: requirements grill, test gates, adversary review
dsh-draw	Unified static-image generation routing for DeepSeek Harness.	🧊 已冻结 — 见仓库 README
dsh-fast	Read-only performance diagnostics for DeepSeek Harness.
dsh-fund-research	Deterministic research reports for Chinese public mutual funds
dsh-github	GitHub PR/issues integration for DSH, every write gated by approval
dsh-industry-research	Industry research orchestration that seals its deliverables through this plugin's ctx.researchReport.assemble
dsh-laya	Laya typed decisions (noul/choice/score) as a first-class Cordis service and model-visible tools
dsh-library	Local document knowledge base for DeepSeek Harness.
dsh-local-ai	Local-model (Ollama) integration for DeepSeek Harness.
dsh-lsp-actions	LSP diagnostics, formatting, completion, code actions and rename over language servers
dsh-mask	PII masking middleware: anonymize at the model boundary, restore at the display layer
dsh-mcp-panel	Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors
dsh-memento	Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool
dsh-observe	OpenTelemetry and Langfuse observability exporter for DeepSeek Harness.
dsh-output-styles	Claude Code outputStyles-equivalent runtime style switching
dsh-permission-rules	Claude Code-style declarative allow/deny/ask permission rules with audit
dsh-plugin-certification	Community certification registry with repro-checkable grades and badges
dsh-plugin-doctor	Zero-dependency static + sandbox smoke detector for DSH plugins
dsh-plugin-guide	Plugin-development knowledge base as an on-demand agent skill
dsh-plugin-kit	Shared zero-runtime-dependency toolkit for the PerryLink DSH plugins
dsh-plugin-upgrade	One-package, one-corridor-index plugin upgrade skill: routes a repository to the matching closed corridor card
dsh-plugin-upgrade-015	Merged 0.1.3-alpha.1 → 0.1.5-rc.1 upgrade corridor card plus a zero-dependency seam scanner	🚫 已退役 —— 走廊由 dsh-plugin-upgrade 承担
dsh-reach	Multi-channel approval/question bridge: WeChat/Telegram/Feishu, session console	🧊 已冻结 — 见仓库 README
dsh-research-report	Verifiable research-report engine: content-addressed evidence ledger and sealed versions
dsh-score	Multi-dimensional quality scoring for DeepSeek Harness plugins.
dsh-session-pin	Pin sessions in the Web sidebar with durable ordering	🚫 已退役 — 见上方说明
dsh-session-sync	Cross-device session sync for DeepSeek Harness — a dedicated git mirror of your session store.
dsh-skill-pack-security	Security-audit skill pack: secret scan, dependency and supply-chain review
dsh-talk	Voice-first session loop for DeepSeek Harness: talk to it, hear it answer.
dsh-team-rooms	Cross-session team rooms: shared message bus, task board and timeline	🚫 已退役 — 见上方说明
dsh-test-drive	Isolated install-and-smoke test drives for DeepSeek Harness plugins.
dsh-ticktick	TickTick/Dida365 task bridge: session-header panel + 11 tools
dsh-translate	Vendor parameter translation and deterministic JSON repair for DeepSeek Harness.

License

Apache-2.0 — 见 LICENSE。

从 DSH Desktop 市场安装

所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览：市场 → 来源 → 添加来源 → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中。安装仍需通过市场的 npm 身份校验与你的确认。